To install rug, rcd, and rcd-modules, follow the instructions in Installing and Configuring Client Systems. To upgrade rug, rcd, and rcd-modules, run the following command:
rug in rug rcd rcd-modules.
This section will cover client configuration in greater detail, and explain the configuration files for rcd.
If you prefer to use a configuration file rather than a series of commands to configure your client machines, you will need to create an /etc/ximian/rcd.conf file and a /var/lib/rcd/services.xml file. The first file is only a few lines long, and will look something like a Windows INI file. It has one or more sections, denoted with square brackets: [Section]. Each section contains one or more tokens, set to equal a particular value: token=value.
The services.xml file is not designed for hand-editing. If you prefer, you can create the file by configuring a single client, and then copy it to additional machines. You can use the commands rug service-list, rug service-add, and rug service-delete to display, add to, and delete from the list of servers your client will access.
The rcd.conf format is similar to the other configuration files you will encounter in the rest of the product. In particular, the configuration file for rcmirror is similar, although larger and more complex.
You can change the settings reflected in the rcd.conf file using the rug set and rug get commands. However, if you prefer to do things the old-fashioned way, you can edit the file yourself:
To check your current settings, run the command rug get, or check the rcd.conf man page for a list of all the settings you can set.
A very simple file could look like this:
[Network]
require-verified-certificates=false
[Cache] enabled=true
A more complex file might look like this:
[Network]
require-verified-certificates=false
[Cache]
enabled=true
[System]
cache-cleanup=true
cache-size-in-mb=500 debug-level=1
repackage=false
syslog-level=1
[Server]
remote-enabled=false
rcd versions 1.5 and later support multiple servers, and store server information in the file /var/lib/rcd/services.xml. Earlier versions supported only one server and stored the information in rcd.conf. To get a list of currently available servers, enter the command rug services-list.
If services.xml does not exist, rcd reads the server from the host line of rcd.conf and create services.xml.
Once services.xml has been created, changes to rcd.conf do not affect the server accessed by the daemon.