repserver

The Replication Server executable program.

Syntax

repserver [-C config_file] [-i id_server] [-S rs_name] 
 [-I interfaces_file] [-E errorlog_file] [-M] [-v] [-K keytab_file]

Parameters

Examples

Usage

  • Use the repserver command to start the Replication Server executable program. Normally, you start Replication Server by executing the run file created by rs_init.

  • On UNIX systems, this executable program is called repserver. On PC systems, the program is called repsrvr.

  • The repserver executable program is located in the bin subdirectory of the Sybase release directory. Refer to the Replication Server installation and configuration guides for your platform for more information.

  • The repserver command should be executed by the “sybase” user so that the Replication Server can access its disk partitions.

  • The interfaces file must contain definitions of the other Replication Servers and data servers that the current Replication Server communicates with. Interfaces files at replicate sites must have entries for the primary Replication Server and the primary data server.

  • If a password is stored in encrypted form, you cannot edit it directly by editing the Replication Server configuration file. To change an encrypted password in this file, use the rs_init program. Refer to the Replication Server installation and configuration guides for your platform for more information.

  • The RSSD_primary_user and the RSSD_maint_user are automatically assigned to the rs_systabgroup group by rs_init at Replication Server configuration time. This enables these users to modify the system tables. You can add other user login names to this group with the Adaptive Server system procedure sp_changegroup. See the Adaptive Server Enterprise System Administration Guide for more information.

  • If any of the network-based security parameters for the RSSD are present, the use_security_services parameter is set “on” and network-based security is initiated automatically.

Replication Server Configuration File Parameters

Configuration parameter

Description

CONFIG_charset

The character set used to write the Replication Server configuration file. Use this parameter only if this character set differs from the Replication Server’s character set. It can be any character set that is compatible with the Replication Server’s character set.

erssd_backup_dir

ERSSD backup directory.

erssd_dbfile

ERSSD database file.

erssd_errorlog

ERSSD error log.

erssd_logmirror

ERSSD transaction log mirror file.

erssd_ping_cmd

Allows user to specify a different command to ping ERSSD. For debug purposes only.

erssd_port

ERSSD port number for network listener. The port number is obtained from the interface file.

erssd_release_dir

Allows user to specify a different release directory. For debug purposes only. The default is $SYBASE/$SYBASE_REP/ASA11.

erssd_ra_release_dir

Allows a user to specify a different release directory for ERSSD Replication Agent. For debug purposes only.

erssd_ra_start_cmd

Allows user to specify a different command to start ERSSD Replication Agent. For debug purposes only.

erssd_start_cmd

Allows user to specify a different command to start ERSSD. For debug purposes only.

erssd_translog

ERSSD transaction log file.

ID_pw

The password for the ID Server user (ID_user).

ID_pw_enc

The encrypted password for the ID Server user (ID_user).

ID_server

The name of the Replication Server that is the designated ID Server for the replication system.

ID_user

The login name on the ID Server for other Replication Servers to use.

RS_charset

The character set for the Replication Server to use. You can specify any Sybase-supported character set.

In setting up a replication system, it is highly recommended, though not required, that all servers at a given Replication Server site use the same character set. It is also recommended that all of the Replication Servers in your replication system use compatible character sets.

Refer to the Replication Server Design Guide for details.

RS_language

The language used by the Replication Server to print its messages to the error log file and to its clients. You can specify any language to which the Replication Server has been localized that is compatible with the character set chosen.

RS_send_enc_pw

Ensures that all Replication Server client connections are made with encrypted passwords except for the first connection to the RSSD. Values are on and off.

Default: off

RS_sortorder

The sort order that Replication Server uses. The sort order controls what rows of a table belong in a subscription that has a where clause involving character data. It also controls how identifiers you enter are recognized.

You can specify any Sybase-supported sort order that is compatible with the character set chosen. All sort orders in your replication system should be the same.

RS_unicode_sort_order

The Unicode sort order Replication uses. You can specify any Sybase-supported Unicode sort order.

Default: binary

RSSD_database

The name of the RSSD.

RSSD_embedded

Indicates whether RSSD is embedded or not.

RSSD_ha_failover

Specifies whether HA failover is allowed or not.

Default: No.

RSSD_maint_pw

The password for the RSSD maintenance user.

RSSD_maint_pw_enc

The encrypted password for the RSSD maintenance user.

RSSD_maint_user

The login name for the RSSD maintenance user. This login name is automatically assigned to the rs_systabgroup group, whose users can modify the system tables.

You can add other user login names to this group with the Adaptive Server system procedure sp_changegroup. See the Adaptive Server Enterprise System Administration Guide for more information.

RSSD_msg_confidentiality

Specifies whether Replication Server sends and receives encrypted data. If set to “required”, outgoing and incoming data must be encrypted. If set to “not_required”, outgoing data is not encrypted and incoming data may be encrypted or not encrypted. This option is not implemented.

Default: not_required

RSSD_msg_integrity

Specifies whether data are checked for tampering. Valid entries are “required” and “not_required”. This option is not implemented.

Default: not_required

RSSD_msg_origin_check

Specifies whether the origin of data should be checked. Valid entries are “required” and “not_required”. This option is not implemented.

Default: not_required

RSSD_msg_replay_detection

Specifies whether data should be checked to make sure they have not been read or intercepted. Valid entries are “required” and “not_required”. This option is not implemented.

Default: not_required

RSSD_msg_sequence_check

Specifies whether data should be checked to make sure the sequence hasn’t changed. Valid entries are “required” and “not_required”. This option is not implemented.

Default: not_required

RSSD_mutual_auth

Specifies whether the RSSD must provide proof of identity before Replication Server establishes a connection. Valid entries are “required” and “not_required”. This option is not implemented.

Default: not_required

RSSD_primary_user

The login name for the RSSD primary user. rs_init automatically assigns this user to the rs_systabgroup group during installation.

You can add other user login names to this group using the Adaptive Server system procedure sp_changegroup. See the Adaptive Server Enterprise System Administration Guide for more information.

RSSD_primary_pw

The password for the RSSD primary user.

RSSD_primary_pw_enc

The encrypted password for the RSSD primary user.

RSSD_sec_mechanism

The security mechanism Replication Server uses for initial contact with the RSSD at startup. Thereafter, network security information for contact with the RSSD is read from the rs_config file. This option is not implemented.

RSSD_server

The name of the Adaptive Server with the RSSD.

RS_ssl_identity

SSL identity file.

RS_ssl_pw

Password for the SSL private key

RS_ssl_pw_enc

The encrypted password for the SSL private key.

RSSD_unified_login

Specifies whether Replication Server seeks to connect to the RSSD with a credential at startup. Thereafter, network security information for contact with the RSSD is read from the rs_config file. Valid entries are “required” and “not_required”. This option is not implemented.

Default: not_required

trace

Turns on a Replication Server trace. You can use multiple instances of this parameter to set the different traces available. Spaces are not allowed. For example:
trace=DSI,DSI_BUF_DUMP
trace=DIST,DIST_TRACE_COMMANDS

trace_file

Indicates the name of the Replication Server log file.