SEARCH
NEW RPMS
DIRECTORIES
ABOUT
FAQ
VARIOUS
BLOG
DONATE


YUM REPOSITORY

 
 

FS_NEWCELL

Section: AFS Command Reference (1)
Updated: OpenAFS
Index 

NAME

fs newcell - Changes the kernel-resident list of a cell's database servers 

SYNOPSIS

fs newcell << -name <cell name >>> -servers <primary servers>+
    << [-linkedcell <linked cell name] >>> [-help]

fs n << -n <cell name >>> << -s <primary servers+ >>>
    << [-l <linked cell name] >>> [-h] 

DESCRIPTION

The fs newcell command removes the Cache Manager's kernel-resident listof database server machines for the cell specified by the -nameargument and replaces it with the database server machines named by the-servers argument.

Each time the machine reboots, the Cache Manager constructs the kernellist of cells and database server machines by reading the local/usr/vice/etc/CellServDB file. This command does not change theCellServDB file, so any changes made with it persist only until thenext reboot, unless the issuer also edits the file. The output of the fslistcells command reflects changes made with this command, because thatcommand consults the kernel-resident list rather than the CellServDBfile.

This command can introduce a completely new cell into the kernel-residentlist, but cannot make a cell inaccessible (it is not possible to remove acell's entry from the kernel-resident list by providing no values for the-server argument). To make a cell inaccessible, remove its entry fromthe CellServDB file and reboot the machine.

If the -name argument names a DCE cell, then the -servers argumentnames DFS Fileset Location (FL) Server machines. The -linkedcellargument specifies the name of the AFS cell to link to a DCE cell for thepurpose of DFS fileset location. Refer to the IBM AFS/DFS MigrationToolkit Administration Guide and Reference for more information onlinking AFS clients to DCE cells using this command or by editing the/usr/vice/etc/CellServDB file. 

CAUTIONS

Some commands, such as the klog command, work correctly only when theinformation is accurate for a cell in both the CellServDB file and thekernel-resident list. 

OPTIONS


-name <cell name>
Specifies the fully-qualified cell name of the AFS or DCE cell.
-servers <primary servers>+
Specifies the fully-qualified hostnames of all AFS database servermachines or DFS Fileset Location (FL) Server machines for the cell namedby the -name argument. If FL Server machines are specified, the localmachine must be running the AFS/DFS Migration Toolkit Protocol Translator.
-linkedcell <linked cell name>
Specifies the name of the AFS cell to link to a DCE cell for the purposeof DFS fileset location.
-help
Prints the online help for this command. All other valid options areignored.
 

EXAMPLES

The following example changes the machine's kernel-resident list ofdatabase server machines for the ABC Corporation cell to include themachines db1.abc.com and db2.abc.com:

   % fs newcell -name abc.com -servers db1.abc.com db2.abc.com
The following example links the DCE cell dce.abc.com to the AFS cellabc.com. The AFS client contacts the Fileset Location (FL) serversdb1.dce.abc.com and db2.dce.abc.com for fileset location informationas it interprets a DFS pathname.

   % fs newcell -name dce.abc.com \       -servers db1.dce.abc.com db2.dce.abc.com \       -linkedcell abc.com
 

PRIVILEGE REQUIRED

The issuer must be logged in as the local superuser root. 

SEE ALSO

the CellServDB(5) manpage,the fs_listcells(1) manpage

IBM AFS/DFS Migration Toolkit Administration Guide and Reference

IBM AFS/DFS Migration Toolkit Administration Installation andConfiguration Guide 

COPYRIGHT

IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.

This documentation is covered by the IBM Public License Version 1.0. It wasconverted from HTML to POD by software written by Chas Williams and RussAllbery, based on work by Alf Wachsmann and Elizabeth Cassell.


 

Index

NAME
SYNOPSIS
DESCRIPTION
CAUTIONS
OPTIONS
EXAMPLES
PRIVILEGE REQUIRED
SEE ALSO
COPYRIGHT

This document was created byman2html,using the manual pages.