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.

Open the RS_Init dialog box, and select Configure a Server Product, then choose Continue. You see the Configure Server Products dialog box.
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 only lets you configure a new Replication Server; it does not allow you to install additional software.

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

Entering Replication Server information

In the New Replication Server window, select Replication Server Information. You see the Replication Server Name window.

Enter the name you recorded in the “Replication Server Information” section of the worksheet, then click Continue. You see the Replication Server Information window.

Select each item on the Replication Server Information window and enter the value you recorded on your worksheet. If you use a default value, record it on your worksheet.

For more information on the character sets and sort orders, read Chapter 6, “Customizing Localization for Adaptive Server,” in the Adaptive Server Enterprise Configuration Guide.

To change a default value, select it and click Continue. You see a dialog box for that option.

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.

If the Replication Server Interfaces Information item is “Incomplete,” select it and click Continue. You see an interfaces file editor dialog box. Follow the instructions provided in “Editing the interfaces file”, to add a listener service for Replication Server.
Click Continue to save 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 and Replication Server in your replication system.

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

Select Start | Programs | Sybase | Connectivity | Open Client Directory Service Editor. Using dsedit, edit the interfaces file.

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

Sybase recommends that if you are using Replication Server 15.2 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 window, select ID Server Information.

If the Replication Server you are installing is not the ID Server, you see the ID Server Name dialog box. Enter the name of the ID Server for the replication system, then click Continue. You see the ID Server Information dialog box.

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 window 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-2.
Click Continue to save your changes and return to the New Replication Server dialog box.

RSSD information

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

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 ERSSD. 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 the Replication Server System Database on ASE option, 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 ERSSD using SQL Anywhere. The text on the second line changes to:
```
2. Embedded Replication Server System
Database    INCOMPLETE
```
Select the Embedded Replication Server System Database option, to go to the ERSSD Name screen, and follow the steps in “Entering ERSSD information.”

Entering ERSSD information

In the ERSSD Name screen, enter the name of your SQL Anywhere server, and click Continue to accept the name. The Embedded Replication Server System Database screen appears.

You see the following options, 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 the Replication Server installation worksheet. See Chapter 4, “Managing a Replication System” in the Replication Server Administration Guide Volume 1, for more information on value requirements for ERSSDs.
Choose Continue to accept the values and return to the Replication Server System Database Choice screen. You see the New Replication Server dialog box.
Choose Continue to return to the New Replication Server dialog box.

Entering Replication Server System Database information

In the New Replication Server window, select Replication Server System Database, then click Continue.
Complete the dialog box with the information from 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.
Choose Continue 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 window, you see a new option, RSSD Device Information, on the New Replication Server window.

WARNING! If you selected No for Create RSSD in the Replication Server System Database window, 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, then choose Continue.
Complete the window using information from your worksheet. If you use a default value, copy it from the window to your worksheet.
Click Continue to save your entries and return to the New Replication Server window.

Entering RSSD RepAgent information

If you selected Yes for “RSSD will be replicated” in the Replication Server System database window, a new Database Replication Agent option will appear in the New Replication Server window:

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.
Click Continue to save this information.

Entering disk partition information

In Windows, operating system files are used as disk partitions for stable queues. If such a file does not already exist, rs_init creates it.

From the New Replication Server window, select Disk Partition.

Click Continue.
Complete the window 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.
Click Continue to accept the values and return to the New Replication Server window.

Entering remote site connections information

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

To view or change any of these values:

From the New Replication Server window, select Remote Site Connections.

Click Continue.
Complete the window using the information on your worksheet. If you use a default value, copy it to the “Remote site connections” section of the worksheet.
Click Continue to save your changes and return to the New Replication Server window.

Completing the Replication Server configuration

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

At the prompt that asks if you want to execute Replication Server tasks now:

Select Yes to have rs_init configure the new Replication Server.
Select No to return to the New Replication Server window, where you can modify values in any of the windows.

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 windows or to modify your environment.

When the configuration is complete, rs_init displays the message “Configuration completed successfully.”

Click Continue.

Click OK to return to the Configure Replication System window.

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.
Click OK to quit rs_init.

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.