Configuring a new Replication Server

This section explains how to configure a new Replication Server using rs_init. To use these instructions, you need the completed “Replication Server Installation Worksheet”. If you have not completed the worksheet, read Chapter 1, “Preparing to Install and Configure Replication Server” and complete it before you continue.

From the rs_init menu, select Configure a Server Product. The screen you see lists the Sybase products that are installed in the release directory.
Select Replication Server.
Select Install a New Replication Server.

You see a list of tasks you must complete to install a new Replication Server.

The Install a New Replication Server option lets you configure a new replication server, not install additional software.

Select each task and complete its screens until the status of each task is “Complete.”

Entering Replication Server information

In the New Replication Server screen, select Replication Server Information. You see the Replication Server Name screen.
Enter the name you recorded in the “Replication Server information” section of your worksheet, and press Return. Press Ctrl+A to accept the name.
Select each item on the Replication Server Information screen and enter the value you recorded on your worksheet. If you use a default value, record it on your worksheet.

In some configurations, if you set Replication Server’s language before you set its character set, you receive an error message. To avoid this, set the character set before you set the language.
Press Ctrl+A to accept the information and return to the New Replication Server dialog box.

Editing the interfaces file

The interfaces file contains network address information for each Adaptive Server, Replication Server, and LTM in your replication system.

To reach the interfaces file screen, select Replication Server Interfaces Information from the Replication Server Information screen.

Select dsedit to edit the interfaces file.

See the Open Client/Server Configuration Guide for more information on dsedit.

Sybase recommends that if you are using Replication Server 12.6 with network-based security, you use the directory services of your network security mechanism to register Replication Servers, Adaptive Servers, and gateway software. See the documentation that comes with your network security mechanism for details.

Entering ID Server information

The ID Server is a Replication Server that registers all Replication Servers and databases in a replication system. It assigns and maintains ID numbers for these components and maintains version information for the entire replication system.

When you:

Configure the ID Server, you determine the login name and password (ID Server User/Password) that all Replication Servers use to log in to the ID Server.

Install a Replication Server that is not the ID Server, copy the ID Server Name, ID Server User, and ID Server Password from the worksheet you completed for the ID Server.

To complete the ID Server Information dialog box:

From the New Replication Server screen, select ID Server Information.
If the Replication Server you are installing is not the ID Server, you see the ID Server Name screen. Select ID Server Name and type the name of the ID Server for the replication system from the worksheet you completed for the ID Server. Then press Ctrl+A to accept your changes.

If the Replication Server you are configuring is the ID Server, the ID Server Information dialog box appears.

The Starting Replication Server ID and Starting Database ID appear only when you configure the ID Server.
Complete the ID Server Information screen with the information from the “ID Server” section of your worksheet.

If you do not make entries for the Starting Replication Server ID and starting database ID, the default ranges are used, as shown in Table 1-1.
Press Ctrl+A to accept your changes and return to the New Replication Server dialog box.

RSSD information

Before you can enter your Replication Server System Database information, you must determine if you want an RSSD, or an embedded RSSD.

The Embedded RSSD option is not available on the Compaq Tru64 UNIX and SGI platforms.

In the Replication Server System Database Choice screen, the first line asks, “Do you want Replication Server System Database embedded?” Select:

No – if you do not want an Embedded RSSD. This is the default value, and assumes you are creating a regular Replication Server System Database with Adaptive Server Enterprise. The second line on the screen appears as:
```
2. Replication Server Database on ASE    INCOMPLETE
```
Select line 2 to go to the Replication Server System Database screen, and follow the steps in “Entering Replication Server System Database information” to complete the information about your RSSD.
Yes – if you want an Embedded RSSD using Adaptive Server Anywhere. The text on the second line changes to:
```
2. Embedded Replication Server System Database   INCOMPLETE
```
Select line 2 to go to the ERSSD Name screen, and follow the steps in “Entering Embedded Replication Server System Database information,” next.

Entering Embedded Replication Server System Database information

In the ERSSD Name screen, enter the name of your Adaptive Server Anywhere server, and press Ctrl+A to accept the name. The Embedded Replication Server System Database screen appears.
You see the following options in the Embedded Replication Server System Database screen, each filled with a default value:
- ERSSD Database Directory
- ERSSD Transaction Log Directory
- ERSSD Backup Directory
- ERSSD Error Log Directory
- ERSSD Interface Information
Select each item to change the default value to the value you recorded on your worksheet from “Replication Server Installation Worksheet”. See Chapter 4, “Managing a Replication System” in the Replication Server Administration Guide for more information on value requirements for embedded RSSDs.
Press Ctrl+A to accept the values and return to the Replication Server System Database Choice screen.
Press Ctrl+A to return to the New Replication Server screen.

Entering Replication Server System Database information

In the New Replication Server screen, select Replication Server System Database.
Select each item on the screen and enter the value recorded on your worksheet. If you use a default value, copy it from the dialog box to your worksheet.

For “RSSD will be replicated,” select Yes if you will have more than one Replication Server in your environment. Otherwise, select No.
Press Ctrl+A to accept the values. You see the New Replication Server dialog box.

Entering RSSD device information

If you selected Yes for Create RSSD in the Replication Server System Database screen, you see a new option, RSSD Device Information, on the New Replication Server screen.

WARNING! If you selected No for Create RSSD in the Replication Server System Database screen, you must already have created the RSSD. Skip this section and go to “Entering disk partition information”.

From the New Replication Server dialog box, select RSSD Device Information.
Complete the screen using information from your worksheet. If you use a default value, copy it from the screen to your worksheet.
Press Ctrl+A to accept your entries and return to the New Replication Server screen.

Entering disk partition information

The Replication Server disk partition must exist before you can complete the Disk Partition Information screen. If you did not define the partition when you completed the worksheet, follow the instructions in “Creating a disk partition” before you continue.

From the New Replication Server screen, select Disk Partition.
Complete the screen using the information you recorded on your worksheet.

You can add more partitions after Replication Server is installed. See the Replication Server Design Guide for help in determining how much space you need.
Press Ctrl+A to accept the values and return to the New Replication Server screen.

Entering remote site connections information

rs_init completes the Remote Site Connections screen with default values based on the Replication Server name you entered.

To view or change any of these values:

From the New Replication Server screen, select Remote Site Connections.
Complete the screen using the information on your worksheet. If you use a default value, copy it to the “Remote site connections” section of the worksheet.
Press Ctrl+A to accept your changes and return to the New Replication Server screen.

Entering RSSD RepAgent information

If an RSSD RepAgent is required, complete these steps:

In the New Replication Server screen, select Replication Server System Database. Enter the Adaptive Server database server name, and the database name for the RSSD.
Select the RSSD to be replicated.
Press Ctrl+A to accept your changes.
Select Database Replication Agent. Enter the RSSD Replication Server user name, and the Replication Server password from your worksheet.

Where necessary, rs_init uses the settings established for the Replication Server when configuring an RSSD RepAgent or LTM.
Press Ctrl+A to accept this information.

Completing the Replication Server configuration

When the status of each task in the New Replication Server screen is “Complete,” follow these steps to complete the configuration.

Press Ctrl+A to accept the information and exit the New Replication Server screen.
At the prompt that asks if you want to execute Replication Server tasks now:
- Enter “y” to have rs_init configure the new Replication Server.
- Enter “n” to return to the New Replication Server screen, where you can modify values in any of the screens.
Status messages display while rs_init sets up the Replication Server. If errors occur, use the error messages that display to correct the information in the configuration screens or to modify your environment.

When the configuration is complete, rs_init displays the message “Configuration completed successfully.”
Press Return to return to the Configure Replication System screen.

If you are configuring other Replication Servers on the same computer, go back to “Configuring a new Replication Server” and repeat the procedure for each additional Replication Server.
Press Ctrl+X twice to return to the RS_INIT menu.

You can find out more about the progress of the installation by looking at the rs_init log files, which are stored in the init/logs subdirectory of the $SYBASE_REP directory.