About configuration parameters

Replication Server reads configuration parameters from the rs_config system table in the RSSD or ERSSD.

All configuration parameters have default values, which are inserted in the table when you use the rs_init utility to create the RSSD or ERSSD. The default values are sufficient for most replication systems. Normally, you change default values only for unusual environments or special situations. For example, you may need to adjust parameters for performance tuning if your system has a large number of replication definitions or subscriptions. You can change default values using the configure replication server command. See “Configuration parameters that affect performance” on page 139 in the Replication Server Administration Guide Volume 2 for information on these parameters.

Parameters governing the names and version numbers of the Replication Server and its components can also be set with rs_init. Table 4-2 describes these basic parameters.

WARNING! Do not change the values for the parameters listed in Table 4-2. The values are set when you run rs_init and should only be modified by the rs_init program when you upgrade or downgrade Replication Server.

Table 4-2: Basic configuration parameters

Configuration parameter

Description

current_rssd_version

The Replication Server version supported by this RSSD. The Replication Server checks this value at startup.

id_server

The name of the ID Server for this Replication Server.

minimum_rssd_version

The minimum version of the Replication Server that can use this RSSD. When the current_rssd_version is greater than the version of the Replication Server, this value is checked when the Replication Server is started.

oserver

The name of the current Replication Server.

prev_min_rssd_version

Following an rs_init installation upgrade, this value contains the previous value of minimum_rssd_version.

prev_rssd_version

Following an rs_init installation upgrade, this value contains the previous value of current_rssd_version.

rssd_error_class

Error class for the RSSD. Default: rs_sqlserver_error_class

send_enc_pw

Ensures that Replication Server makes client connections to the RSSD with an encrypted password. Values are “on” and “off” (the default).

See “Sending encrypted passwords for Replication Server client connections”.

rs_init also sets the password encryption configuration parameter. For information about it, refer to “Enabling and disabling password encryption in sysattributes”.

Many configuration parameters also have values for specific objects. You set these values after installation when your system requires the fine-tuning that these parameters allow. For example, default route parameters affect all routes that originate at the current Replication Server. If necessary, you change the default settings for these parameters with configure replication server. You also can set parameter values for individual routes by using the alter route command.

Setting some configuration parameters requires a technical understanding of the replication system. See Chapter 2, “Replication Server Technical Overview” in this book and Chapter 4, “Performance Tuning” in the Replication Server Administration Guide Volume 2 for information on how the replication system works.

It is important to back up the RSSD periodically, and whenever you do anything to change its state. ERSSD is already configured for daily automated backup. See “Managing the RSSD” for more information, or “Managing Embedded Replication Server System Database”.