You are responsible for maintaining and protecting your registry database. This section provides
C
guidelines fdor reghistry maintenancde anbd protection·dsdee T d
ab d
le l
4-4 fo~ a su~masry OfCthh e comSmfands /' used to up ate t e user account ata ase and to a an e ete regIstry sItes. ee apter or more
information about the procedure used to protect the registry each time you add a new node to the network. Procedures 4-3 and 4-4 provide instructions for adding and deleting registry sites.
Procedures 4-S and 4-6 instruct you how to copy and move registries.
To add and delete registry sites, use the crrgy command with the -a or -d option. Crrgy adds or deletes site names to the master registry file, depending upon which option you use. Crrgy also has the capability of adding sites to the rgy _master file without accessing any of the sites ( -exist option).
This option can be useful when you are preparing to create a site on a node that is not yet available.
The -d site option never accesses the deleted sites (in case they are unavailable when the command is issued). Instead, crrgy -d site deletes the site name from the rgy_master file. Refer to the DOMAIN System Command Reference for the crrgy options.
If you execute the invol utility on a site node, or change the node's name, or replace the node's disk, follow the procedures in Chapter 2 for maintaining root directories. Use the procedures
described for ctnode or ns_helper, depending on how you have chosen to maintain root directories at your site. A registry is an upper-level directory and, as such, is subject to the rules of the network naming structure. Maintain site node entry directories as you would any other entry directory.
PROCEDURE 4-3: Adding a Registry Site
1. Add a registry site by executing the following command at the master site; type
$ crrgy -a IInew_node/registry/rgy_site[n]<RETURN>
This command creates a new registry site at new_node and updates the file
/registry/rgy_master. It does not update /registry/registry anywhere in the network.
2. After you have added the new registry site, update all node /registry/registry copies of the master file rgy_master, by typing
$ cpt Iregistry/rgy_master lIalpha/registry/reglstry<RETURN>
$ cpt Iregistry/rgy_master IIbeta/reglstry/reglstry<RETURN>
END OF PROCEDURE 4-3
o
o
o o
o
PROCEDURE 4-4: Deleting a Registry Site
1. Delete a registry site by executing the following command at the master site; type
$ crrgy -d Ilnode/registry/rgy _site [n] <RETURN>
This command deletes only the pathname IInode/registry/rgy_site[n] from the file /registry/rgy_master. It does not delete the directory IInode/registry/rgy_site [n].
2. After you have deleted a registry pathname from rgy_master, delete the directory rgy_site by typing
$ dlt Ilnode/registry/rgy_site[n]<RETURN>
3. Update all node /registry/registry copies of the master file rgy_master by entering
$ cpf Ireglstry/rgy_master lIalpha/reglstry/registry<RETURN>
$ cpf Iregistry/rgy _master Ilbeta/registry/registry<RETURN>
END OF PROCEDURE 4-4
PROCEDURE 4-5: Copying Replacement Master Registry
This procedure does not create any new sites. This example assumes you are using the same sites and moving only the file /registry/rgy_master.
1. Create a replacement master registry file on the node you're working at. Type the following on a single shell command line:
$ crrgy -ex -s IInode/reglstry/rgy_slte1 IInode/reglstry/rgy_site2<RETURN>
2. Update all node /registry/registry copies of the master file rgy_master by entering
$ cpf Ireglstry/rgy_master lIalpha/reglstry/reglstry<RETURN>
$ cpf Ireglstry/rgy _master Ilbeta/registry/registry<RETURN>
END OF PROCEDURE 4-5
PROCEDURE 4-6: Moving Master Registry
The following commands issued from Ilnewmstr will move a registry from Iloldmstr to Ilnewmstr and ( \
add two additional sites. . ',-_/
1. Create a new rgy _master file without creating data files by entering the following command on a single shell command line:
$ crrgy -r IInmstr exists -9 IInewmstr/registry/newsite1 IInode2/registry/newsite2 Ilnode3/registry/newsite3<RETURN>
2. Move existing data files to the first new site by typing the following command on a single shell command line:
$ cpt IIoldmstr/registry/oidsite1 Ilnewmstr/registry/newsite1 <RETURN>
3. From the IInewmstr node, replicate rgy_master on IInewmstr by typing
$ cpt Iregistry/rgy_master Iregistry/registry<RETURN>
4. From the IInewmstr node, move the data files to other new sites by typing
$ salrgy<RETURN>
5. Distribute the new copy of rgy_master to every node in the ring by typing
$ cpt Iinewmstr/registry/rgy_master II?* Iregistry/registry<RETURN>
NOTES:
The registry files at the old sites remain untouched.
There may be difficulties doing this procedure if nodes are unavailable. Nodes will need to be updated when they are back on the ring.
Additional difficulties may be encountered due to ACLs either on Ilnewmstr or on other nodes. The registry system cannot violate ACL protections and it is the system administrator's responsibility to ensure that ACLs are correct for correct operation of the system.
END OF PROCEDURE 4-6
Creating and Maintaining User Accounts 4-18