Defining Cell Name and Membership for Server Processes

Now assign your cell's name. The chapter in the OpenAFS Administration Guide about cell configuration and administration issues discusses the important considerations, explains why changing the name is difficult, and outlines the restrictions on name format. Two of the most important restrictions are that the name cannot include uppercase letters or more than 64 characters.

Use the bos setcellname command to assign the cell name. It creates two files:

Note

In the following and every instruction in this guide, for the machine name argument substitute the fully-qualified hostname (such as fs1.example.com) of the machine you are installing. For the cell name argument substitute your cell's complete name (such as example.com).

  1. If necessary, add the directory containing the bos command to your path.

       # export PATH=$PATH:/usr/afs/bin
          

  2. Issue the bos setcellname command to set the cell name.

       # bos setcellname <machine name> <cell name> -noauth
    

    Because you are not authenticated and authorization checking is disabled, the bos command interpreter possibly produces error messages about being unable to obtain tickets and running unauthenticated. You can safely ignore the messages.

  3. Issue the bos listhosts command to verify that the machine you are installing is now registered as the cell's first database server machine.

       # bos listhosts <machine name> -noauth
       Cell name is cell_name
           Host 1 is machine_name