Initializes the Replication Server process
Synopsis
repserver [-mainprocs number_of_background_daemons]
[-tokenprocs number_of_token_daemons] [-help]
Options
-mainprocs number_of_background_daemons
Specifies the number of background daemons to run on the machine. These daemons are responsible for the bulk of the effort
required to maintain read-only replicas on the local machine, as well as for receiving and servicing RPC requests from DFS clients. If this option is omitted, four background daemons perform these
services.
-tokenprocs number_of_token_daemons
Specifies the number of background daemons dedicated to servicing token revocation RPC requests from File Exporters. If this option
is omitted, four background daemons service token revocation requests.
-help
Prints the online help for this command. All other valid options specified with this option are ignored.
The help and apropos commands available with all command suites are also available with the repserver command. See the bos help and bos apropos reference pages for examples using these commands.
Description
The Replication Server, or repserver process, in conjunction with the Cache Manager, tracks the currency of replicas and updates the versions of data being
used at each replication site. The repserver process is used in Release and Scheduled Replication, and must run on any machine that stores read-only replicas of read-write filesets. For
simplified administration, run the repserver process on all File Server machines. The repserver process is usually started and controlled by the BOS Server; if it is not, execute
the repserver process as a background process. The binary file for the repserver process resides in dcelocal/bin/repserver.
The -mainprocs and -tokenprocs options can be used to alter the default number of background daemons running on the server machine, as follows:
-mainprocs
Specifies the number of background daemons that run on the machine to maintain read-only replicas housed on the local machine and to service RPC requests from DFS
clients. The default number of background daemons is four. Use the -mainprocs option to increase the number of background daemons if the machine houses a large number of replicas.
-tokenprocs
Specifies the number of background daemons dedicated to handling token revocation RPC requests from the File Exporters on File Server machines. The default number
of background daemons dedicated to this task is four. If the -mainprocs option is used to increase the number of background daemons dedicated to maintaining replicas and servicing RPC
requests from DFS clients, use the -tokenprocs option to increase the number of background daemons dedicated to servicing token revocation requests from File Exporters.
When it is started, the repserver creates the dcelocal/var/dfs/adm/RepLog event log file if the file does not already exist. It then appends messages to the file. If the file exists when the repserver is started, the process moves it to the RepLog.old file in the same directory (overwriting the current RepLog.old file if it exists) before creating a new version to which to append messages.
Use the fts statrepserver command to check the status of the Replication Server on any server machine. Use the fts lsreplicas command to check the status of fileset replicas.
Privilege Required
The issuer must be logged in as root on the local machine.
Output
If problems are encountered during initialization, the repserver sends error messages to standard error output (stderr). The repserver keeps
an event log in dcelocal/var/dfs/adm/RepLog.
Related Information
Commands: fts lsreplicas(8dfs)
Files: RepLog(4dfs)