fs_newcell - Changes the Cache Manager list of a cell's location servers
fs newcell -name <cell name> -servers <primary servers>+ [-linkedcell <linked cell name>] [-help]
The fs newcell command replaces the Cache Manager's list of location servers for the cell specified by the -name argument and with the location servers named by the -servers argument.
Each time the Cache Manager restarts, it constructs a list of cells and location servers by reading the local configuration /etc/yfs/yfs-client.conf file. This command does not change the contents of /etc/yfs/yfs-client.conf, so any changes made with it persist only until the next restart. The output of the fs listcells command reflects changes made with this command, because that command consults the Cache Manager list rather than the /etc/yfs/yfs-client.conf file.
This command can introduce a completely new cell into the Cache Manager list, but cannot make a cell inaccessible (it is not possible to remove a cell's entry from the Cache Manager list by providing no values for the -server argument). An empty list of location servers instructs the Cache Manager to perform DNS SRV or DNS AFSDB queries to obtain the list of location servers for the cell.
The -linkedcell argument specifies the name of a cell to link to the cell being added for the purpose of retrying volume location lookups. When two cells are linked, if the location lookup in the primary cell fails, the lookup is retried in the linked cell.
Specifies the fully-qualified name of the cell.
Specifies the fully-qualified hostnames of all location servers for the cell named by the -name argument.
Specifies the name of the cell to link to the cell being added for the purpose of retrying volume location lookups. When two cells are linked, a volume lookup fails is retried in the linked cell.
Prints the online help for this command. All other valid options are ignored.
The fs newcell command on Windows differs from the UNIX version in a few ways.
fs newcell with no arguments discards the existing cell information. The Windows Cache Manager will reload a cell's information the next time it needs the location server list for a cell.
Secondly, in addition to accepting the UNIX options, fs newcell on Windows accepts the following options:
Adds the new cell to the Cache Manager, and obtains the location server information from DNS.
Adds the new cell to the Cache Manager, and saves the cell configuration data in the registry for use the next time the Cache Manager restarts.
Specifies a port number at which the cell's location servers are listening. The default is port 7003.
Specifies a port number at which the cell's file servers are listening. The default is port 7000.
The following example changes the machine's kernel-resident list of database server machines for the your-cell-name.com cell to include the machines db1.your-cell-name.com and db2.your-cell-name.com:
% fs newcell -name your-cell-name.com -servers db1.your-cell-name.com db2.your-cell-name.com
The following example links a new cell new.your-cell-name.com to an older cell old.your-cell-name.com. The Cache Manager contacts the location servers db1.new.your-cell-name.com and db2.new.your-cell-name.com for volume location information. If the requested volume cannot be found in new.your-cell-name.com the Cache Manager will query the old.your-cell-name.com cell's location servers db1.old.your-cell-name.com and db2.old.your-cell-name.com
% fs newcell -name old.your-cell-name.com \
-servers db1.old.your-cell-name.com db2.old.your-cell-name.com \
% fs newcell -name new.your-cell-name.com \
-servers db1.new.your-cell-name.com db2.new.your-cell-name.com \
-linkedcell old.your-cell-name.com
The issuer must be logged in as the local superuser root.
fs_listcells(1), yfs-client.conf(5),
IBM Corporation 2000. http://www.ibm.com/ All Rights Reserved.
This documentation is covered by the IBM Public License Version 1.0. It was converted from HTML to POD by software written by Chas Williams and Russ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.
"AFS" is a registered mark of International Business Machines Corporation, used under license. (USPTO Registration 1598389)
"OpenAFS" is a registered mark of International Business Machines Corporation. (USPTO Registration 4577045)
The "AuriStor" name, log 'S' brand mark, and icon are registered marks of AuriStor, Inc. (USPTO Registrations 4849419, 4849421, and 4928460) (EUIPO Registration 015539653).
"Your File System" is a registered mark of AuriStor, Inc. (USPTO Registrations 4801402 and 4849418).
"YFS" and "AuriStor File System" are trademarks of AuriStor, Inc.