In the rsmgen menu, edit each numbered option as follows:
$SYBASE Directory The path name of the SYBASE directory for the RSM Server. By default, rsmgen uses the value of the $SYBASE_RSM environment variable. If this is not set, RSM uses the current working directory. When you change a value, rsmgen verifies that:
The RSM executable rsmsrvr exists in $SYBASE/$SYBASE_RSM/bin.
The sample configuration files exist in $SYBASE/$SYBASE_RSM/sample/rsm.
Configuration files for an RSM Server are usually in the $SYBASE_RSM directory tree. Therefore, if you use rsmgen to change the default values for the $SYBASE_RSM directory, rsmgen changes directory names for menu items 2 through 5. However, if you change the directories or file names in menu items 2 through 5, they are not automatically updated if you 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.
RUN File Name The name of the RUN file you want to create. By default, rsmgen uses $SYBASE/$SYBASE_RSM/install/RUN_rsm_server_name. When you change this value, rsmgen verifies that it can create the RUN file. If a RUN file with the same name exists, you are prompted either to enter a new file name or to overwrite the existing file. If rsmgen cannot create the RUN file, you see an error message.
Interfaces File Path Name The path name of the interfaces file. By default, rsmgen uses $SYBASE/interfaces. When you change this value, rsmgen determines whether the interfaces file exists and whether it contains an entry for the RSM Server for which you are creating the RUN file. If it does not, rsmgen displays a warning message that you must add an entry for the RSM Server in the interfaces file. For more information about entries in interfaces files, see the Replication Server Administration Guide and the Replication Server Installation Guide for your platform.
RSM Server Error Log Path Name The path name of the error log for the RSM Server for which you are creating the RUN file. By default, rsmgen uses $SYBASE/$SYBASE_RSM/install.
Configuration File Directory Path Name The path name of the directory that contains RSM Server configuration files. By default, rsmgen uses $SYBASE/$SYBASE_RSM/admin/config. If you change this value, rsmgen verifies that the directory exists.
rsmgen does not create the configuration
directory. If it does not exist already, you must create it.
Configuration File Name The name of the configuration file for this RSM Server. When you change the default name of rsm_server_name.cfg, rsmgen verifies that it can create this file in the configuration directory.
Configuration Language The language in which the RSM Server prints messages to its log. The messages are returned in the same language. The default is English.
Configuration Character Set The character set used by the RSM Server. The default value is iso_1.
Configuration Sort Order The sort order used by the RSM Server. The default is binary.
Users.rsm File The name of the file that contains all the user IDs for this RSM Server. 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, rsmgen assumes this file resides in the specified configuration directory.
Servers.rsm 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, rsmgen assumes this file resides in the specified configuration directory.
Logfiles.rsm File The name of the file that contains the information about the log file for all servers in the RSM domain. 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, rsmgen assumes this file resides in the specified configuration directory.
Events.rsm File The name of the events.rsm file, that contains information about the server events defined for the RSM server. 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, rsmgen assumes this file resides in the specified configuration directory.
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.
Generate RUN File and Exit Generates the RUN file and the RSM Server configuration files, then exits the program.
Exit Without Generating RUN File Exits without generating a RUN file.
Changing a value
Enter the option number.
You can change the value of options 1 through 15. rsmgen displays the current value for each option and prompts you to enter a new value.
Enter a new value. Press Return.
Repeat steps 1 and 2 to enter new values for each option you want to change.
To generate a RUN file and default configuration files, exit rsmgen, enter “16” and press Return.
To exit rsmgen without creating a RUN file, enter “17” and press Return.
See “RSM Server RUN file” for more information about the RSM Server RUN file.
When rsmgen creates the RUN file, it verifies the existence and accuracy of the directory and file names you entered. If a file does not exist, rsmgen creates it. If rsmgen cannot verify some of the information, you see an error message and you return to the rsmgen menu. Select an option from the menu and enter new information.
When you change a value, rsmgen verifies that the following files exist:
RSM.cfg
users.rsm
The default users.rsm file defines
a single user named “sa” with a NULL password.
After you start the new RSM Server and Replication Server plug-in
to Sybase Central, use the USERS folder to
define a password for the “sa” user.
servers.rsm – the default servers.rsm file is empty. Use the Sybase Central Add Server wizard to add entries. See the Replication Server plug-in help for more information.
logfiles.rsm – the default logfiles.rsm does not contain any managed servers.
events.rsm – the default file does not include any events.
