The fields on the RSM Server Setup dialog box are:
RSM Server Name A new or existing RSM Server. Enter a new name or select a server name from the drop-down list of servers that already exist in your replication system.
Sybase Directory The path used for the SYBASE directory. By default, this is the value of the SYBASE environment variable. If SYBASE has not been set, rsmsetup sets this field to the name of the rsmsetup parent directory.
When you change a value, rsmsetup verifies that:
The RSM executable rsmsrvr exists in %SYBASE%\%SYBASE_RSM%\bin.
The required configuration files exist in %SYBASE%\%SYBASE_RSM%\sample\rsm.
Configuration files for an RSM Server are usually in the %SYBASE_RSM% directory structure. Therefore, if you use rsmsetup to change the default values for the %SYBASE_RSM% directory, rsmsetup changes the path name of the interfaces file and the configuration directory. However, once you manually change the path and name of the interfaces file or the configuration directory, they are not automatically updated if you then change the %SYBASE_RSM% directory.
Component Directory The path used for the RSM Server directory. By default, this value is set to the value of the %SYBASE_RSM% environment variable. This value is a relative directory path that points to a subdirectory in the Sybase directory where RSM Server is installed.
Interfaces File The path and name of the interfaces file. Enter %SYBASE%\ini\sql.ini, which is the typical location for the interfaces file, or enter another location. Leave this field blank if you are using LDAP services. When you enter this value, rsmsetup determines whether the sql.ini file exists and whether it contains an entry for the RSM Server you are creating or updating.
If the interfaces file does not contain an entry for the RSM Server, rsmsetup displays a warning message that you must add an entry for the RSM Server in the sql.ini file. For more information about entries in sql.ini files, see the Replication Server Administration Guide and the installation guide for your platform.
Batch File The path and name of a batch (BAT) or RUN file used to start the RSM Server. Use it only to start the RSM Server at the console rather than as an NT service. See “Starting an RSM Server” for more information about starting an NT service.
This batch file is created by rsmsetup in the format run_servername.bat. By default, the path and name of the batch file is %SYBASE%\%SYBASE_RSM%\%install\RUN_rsm_servername.bat.
When you change this value, rsmsetup verifies that it can create the batch file. If a batch file with the same name exists, you are prompted either to enter a new file name or to overwrite the existing file. If rsmsetup cannot create the batch file, you see an error message.
RSM Server Error Log The name of the error log for the RSM Server you specified. Enter a new name, or accept the default name of server_name.log that appears when you create a new RSM Server name.
Configuration Directory The path of the RSM Server configuration directory that contains configuration files for RSM Server. If you are configuring a new RSM Server, you can enter a new path or accept the default path of %SYBASE%\%SYBASE_RSM%\admin\config. This directory must already exist.
Parameters File The path and name of the parameters file for the specified RSM Server. The parameters file sets the values of configuration parameters that control how the RSM Server behaves. If you do not enter a complete path, rsmsetup assumes this file resides in the specified configuration directory. If you enter a new server name (that is, the file does not exist), the software creates the file using the information you entered in the RSM Server Language, RSM Server Char Set, and RSM Server Sort Order fields. If you enter the name of an existing server, the software modifies the parameter file according to the changes you made in the RSM Server Language, RSM Server Character Set, and RSM Server Sort Order fields.
RSM Server Language The language in which the RSM Server prints messages to its log. Messages are returned in the same language. The default is English. You can also specify French, German, or Japanese.
RSM Server Character Set The character set used by the RSM Server. The default value is iso_1.
RSM Server Sort Order The sort order used by the RSM Server. The default is binary.
Users File The name of the users file. If you are configuring a new RSM Server, you can enter a new path or accept the default name of server_name.users.rsm. If you do not enter a complete path, rsmsetup assumes this file resides in the specified configuration directory.
Servers File The name of the RSM Server domain file. If you are configuring a new RSM Server, you can enter a new path or accept the default name of server_name.servers.rsm. If you do not enter a complete path, rsmsetup assumes this file resides in the specified configuration directory.
Logfiles File The name of the error log file for the RSM Server you specified. If you are configuring a new RSM Server, you can enter a new path or accept the default name of <server_name>.logfiles.rsm. If you do not enter a complete path, rsmsetup assumes this file resides in the specified configuration directory.
Events File The name of the events file for the RSM Server you specified. If you are configuring a new RSM Server, you can enter a new path or accept the default name of server_name.events.rsm. If you do not enter a complete path, rsmsetup assumes this file resides in the specified configuration directory.
NT User Name A valid NT login. When the RSM Server is started as an NT Service, the RSM Server uses this user name to access network files.
Confirm NT Password A prompt to type the NT password again for confirmation.
DCE Keytab File The absolute directory path and file name of the DCE security server’s keytab file. Leave this field blank if you are not using DCE external security services.
