RGYD(8) Domain/OS BSD RGYD(8)
NAME
rgyd - network registry server
SYNOPSIS
/etc/rgyd [ -create | -recreate | -restore_master ]
DESCRIPTION
rgyd is the network registry daemon. It manages all access to the
network registry database. You must be the super-user to invoke rgyd.
The daemon can be replicated, so that several copies of the database
exist on a network or an internet, each managed by a rgyd process. Only
one registry daemon, the master, can accept operations that change the
database (such as adding an account). If the daemon is replicated, the
other replicas are slaves, which accept only lookup operations (such as
validating a login attempt).
A Local Location Broker daemon (llbd) must be running on the local node
when rgyd is started. Typically, both daemons are started at boot time
from /etc/rc. The server will place itself in the background when it is
ready to service requests.
OPTIONS
-create Create a replica of the network registry. This option
creates a copy of the registry database and starts a slave
server process. You use -create only the first time you
start a slave server process on a node. When you restart the
daemon, you do not need any options at all. To create the
master replica, use either cvtrgy (if you are converting an
SR9 registry to SR10 format) or rgy_create (if you are
creating a new SR10 registry).
-recreate Recreate a slave replica. You should use this option only if
a slave's copy of the database has been irreparably
corrupted. It destroys the existing database and creates a
new one.
-restore_master
Restart a master server and reinitialize all slave replicas.
You should use this option only to recover from a
catastrophic failure of the master node, (for example, if the
database has been corrupted and then restored from a backup
tape).
EXAMPLES
All of the commands shown in these examples must be run by root.
1. Start the master replica of the registry after you have created the
master database via rgy_create or cvtrgy:
$ /etc/server -p /etc/rgyd
2. Start a slave replica of the registry.
$ /etc/server -p /etc/rgyd -create
3. Restart an existing replica (master or slave) of the registry.
$ /etc/server -p /etc/rgyd
4. Restart an existing replica of the registry on the remote host //yak.
$ crp -on //yak -cps //yak/etc/rgyd