doc/html/AdminReference/auarf154.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
   2 <HTML><HEAD>
   3 <TITLE>Administration Reference</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
   8 <META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
   9 <META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
  10 </HEAD><BODY>
  11 <!-- (C) IBM Corporation 2000. All Rights Reserved    -->
  12 <BODY bgcolor="ffffff">
  13 <!-- End Header Records  ============================================ -->
  14 <A NAME="Top_Of_Page"></A>
  15 <H1>Administration Reference</H1>
  16 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf153.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="auarf155.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
  17 <P>
  18 <H2><A NAME="HDRFS_NEWCELL" HREF="auarf002.htm#ToC_168">fs newcell</A></H2>
  19 <A NAME="IDX4905"></A>
  20 <A NAME="IDX4906"></A>
  21 <A NAME="IDX4907"></A>
  22 <A NAME="IDX4908"></A>
  23 <A NAME="IDX4909"></A>
  24 <A NAME="IDX4910"></A>
  25 <A NAME="IDX4911"></A>
  26 <A NAME="IDX4912"></A>
  27 <P><STRONG>Purpose</STRONG>
  28 <P>Changes the kernel-resident list of a cell's database server machines
  29 <P><STRONG>Synopsis</STRONG>
  30 <PRE><B>fs newcell -name</B> &lt;<VAR>cell&nbsp;name</VAR>> <B>-servers</B> &lt;<VAR>primary&nbsp;servers</VAR>><SUP>+</SUP>
  31            [<B>-linkedcell</B> &lt;<VAR>linked&nbsp;cell&nbsp;name</VAR>>]  [<B>-help</B>]
  32
  33 <B>fs n -n</B> &lt;<VAR>cell&nbsp;name</VAR>>  <B>-s</B> &lt;<VAR>primary&nbsp;servers</VAR>><SUP>+</SUP>  [<B>-l</B> &lt;<VAR>linked&nbsp;cell&nbsp;name</VAR>>]  [<B>-h</B>]
  34 </PRE>
  35 <P><STRONG>Description</STRONG>
  36 <P>The <B>fs newcell</B> command removes the Cache Manager's
  37 kernel-resident list of database server machines for the cell specified by the
  38 <B>-name</B> argument and replaces it with the database server machines
  39 named by the <B>-servers</B> argument.
  40 <P>Each time the machine reboots, the Cache Manager constructs the kernel list
  41 of cells and database server machines by reading the local
  42 <B>/usr/vice/etc/CellServDB</B> file. This command does not change
  43 the <B>CellServDB</B> file, so any changes made with it persist only until
  44 the next reboot, unless the issuer also edits the file. The output of
  45 the <B>fs listcells</B> command reflects changes made with this command,
  46 because that command consults the kernel-resident list rather than the
  47 <B>CellServDB</B> file.
  48 <P>This command can introduce a completely new cell into the kernel-resident
  49 list, but cannot make a cell inaccessible (it is not possible to remove a
  50 cell's entry from the kernel-resident list by providing no values for the
  51 <B>-server</B> argument). To make a cell inaccessible, remove its
  52 entry from the <B>CellServDB</B> file and reboot the machine.
  53 <P>If the <B>-name</B> argument names a DCE cell, then the
  54 <B>-servers</B> argument names DFS Fileset Location (FL) Server
  55 machines. The <B>-linkedcell</B> argument specifies the name of the
  56 AFS cell to link to a DCE cell for the purpose of DFS fileset location.
  57 Refer to the <I>IBM AFS/DFS Migration Toolkit Administration Guide and
  58 Reference</I> for more information on linking AFS clients to DCE cells using
  59 this command or by editing the <B>/usr/vice/etc/CellServDB</B>
  60 file.
  61 <P><STRONG>Cautions</STRONG>
  62 <P>Some commands, such as the <B>klog</B> command, work correctly only
  63 when the information is accurate for a cell in both the <B>CellServDB</B>
  64 file and the kernel-resident list.
  65 <P><STRONG>Options</STRONG>
  66 <DL>
  67 <P><DT><B>-name
  68 </B><DD>Specifies the fully-qualified cell name of the AFS or DCE cell.
  69 <P><DT><B>-servers
  70 </B><DD>Specifies the fully-qualified hostnames of all AFS database server
  71 machines or DFS Fileset Location (FL) Server machines for the cell named by
  72 the <B>-name</B> argument. If FL Server machines are specified, the
  73 local machine must be running the AFS/DFS Migration Toolkit Protocol
  74 Translator.
  75 <P><DT><B>-linkedcell
  76 </B><DD>Specifies the name of the AFS cell to link to a DCE cell for the purpose
  77 of DFS fileset location.
  78 <P><DT><B>-help
  79 </B><DD>Prints the online help for this command. All other valid options
  80 are ignored.
  81 </DL>
  82 <P><STRONG>Examples</STRONG>
  83 <P>The following example changes the machine's kernel-resident list of
  84 database server machines for the ABC Corporation cell to include the machines
  85 <B>db1.abc.com</B> and
  86 <B>db2.abc.com</B>:
  87 <PRE>   % <B>fs newcell -name abc.com -servers db1.abc.com db2.abc.com</B>
  88
  89 </PRE>
  90 <P>The following example links the DCE cell
  91 <B>dce.abc.com</B> to the AFS cell
  92 <B>abc.com</B>. The AFS client contacts the Fileset Location
  93 (FL) servers <B>db1.dce.abc.com</B> and
  94 <B>db2.dce.abc.com</B> for fileset location
  95 information as it interprets a DFS pathname.
  96 <PRE>   % <B>fs newcell -name dce.abc.com -servers db1.dce.abc.com db2.dce.abc.com</B>   \
  97                 <B>-linkedcell abc.com</B>
  98
  99 </PRE>
 100 <P><STRONG>Privilege Required</STRONG>
 101 <P>The issuer must be logged in as the local superuser <B>root</B>.
 102 <P><STRONG>Related Information</STRONG>
 103 <P><A HREF="auarf019.htm#HDRCLI_CSDB">CellServDB (client version)</A>
 104 <P><A HREF="auarf149.htm#HDRFS_LISTCELLS">fs listcells</A>
 105 <P><I>IBM AFS/DFS Migration Toolkit Administration Guide and Reference</I>
 106 <P><I>IBM AFS/DFS Migration Toolkit Administration Installation and
 107 Configuration Guide</I>
 108 <P>
 109 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf153.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="auarf155.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
 110 <!-- Begin Footer Records  ========================================== -->
 111 <P><HR><B>
 112 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 113 </B>
 114 <!-- End Footer Records  ============================================ -->
 115 <A NAME="Bot_Of_Page"></A>
 116 </BODY></HTML>