Redundant Configuration DB Servers

This section describes how to set up redundant Configuration DB Servers-that is, DB Servers that are dedicated to provide access to the Configuration Database and that are not clients of Configuration Server.

To set up redundant DB Servers that provide access to databases other than the Configuration Database (such as the Log Database) and that are not clients of Configuration Server (such as Log DB Server), refer to Redundant Client DB Servers.

Important

In this section only, the term DB Server denotes a Configuration DB Server, not a Client DB Server.

Redundancy

Redundant DB Servers support only the warm standby redundancy type.

Deploying Redundant Configuration DB Servers

Important

* Once installed, the two Configuration DB Servers must be started from the same account.

Installation Recommendations

If you are installing the primary and backup DB Servers on the same host computer, Genesys recommends that you:

• Install them in different directories.
• Specify a different port number for each server.

Prerequisites

• Configuration Layer components are installed and running as described in Deploying Configuration Layer.
• You are logged into Genesys Administrator.

Important

Once installed, the two Configuration DB Servers must be started from the same account.

Installation and Configuration

1. Install the backup DB Server.
2. Configure the backup DB Server.
3. Configure an Application object for the backup DB Server.
   [+] Detailed Instructions

   Start of procedure

   1. Go to Provisioning > Environment > Applications, and click New.
   2. In the General section of the Configuration tab:
      1. Enter a descriptive name (not cfg_dbserver) in the Name text box.
      2. Select the appropriate template, as follows:
         1. Click the search icon in the Application Template field to open a Browse dialog box that lists the available application templates. If a DB Server template file is not listed, close the dialog box and import the DBServer_<current-version>.apd file from the Management Framework product CD.
         2. In the Browse dialog box, select the DB Server template file.
         3. Click OK.
   3. In the Server Info section:
      1. Select the Host object on which this DB Server runs.
      2. Specify the Listening Port that DB Server clients must use to connect to this DB Server.
      3. In the Working Directory, Command Line, and Command Line Arguments text boxes, do one of the following:
         • Enter the appropriate information in each of the text boxes. For information about command-line parameters, see "Starting a Backup Configuration DB Server".
         • Type a period (.) in the Working Directory and Command Line text boxes, and leave the Command Line Arguments text box blank. The information will be filled in automatically when you install the backup DB Server, but only if the Installation Package can connect to the primary Configuration Server.
      4. Enter appropriate values for the other mandatory fields (those indicated by red asterisks).
      5. Select Auto-Restart.
   4. Click Save and Close to save the configuration.

   End of procedure

4. Configure an Application object for the primary DB Server if one does not already exist.
5. Modify the Application object for primary DB Server to work with backup DB Server.
   [+] Detailed Instructions

   Prerequisites

   • The primary and backup Configuration DB Server Application objects exist.

   Start of procedure

   1. Go to Provisioning > Environment > Applications, and double-click the primary DB Server Application object cfg_dbserver to open its properties.
   2. In the Server Info section of the Configuration tab:
      1. Select the Application object corresponding to the DB Server that you want to use as the backup server.
      2. Select Warm Standby as the redundancy type.
   3. Click Save and Close to save the configuration.

   End of procedure

6. Modify the configuration files for the primary DB Server and the backup DB Server.
   [+] Details

   The configuration file for the backup DB Server must be the same as that for the primary DB Server, with the following exceptions:

   • The host value can be different if the backup DB Server is installed on a different host computer other than the primary server.
   • The port value must be unique.

   The configuration file for the backup DB Server may or may not have been created during installation, depending on the option you chose. In either case, refer to "Configuring DB Server" on page 91 for instructions on configuring a DB Server configuration file.

   In addition, add LCA port information to both configuration files to allow both servers to be controlled by the Management Layer, and for switchover to occur when necessary. To enable this, in each configuration file, create the lca section (if it does not already exist), and configure the lcaport option in this section. Sample configuration files are shown side-by-side below. The arrows show the areas affected.

   

   Sample Configuration Files for Primary and Backup DB Servers.
7. Modify the backup DB Server start file so the application can be started correctly.
   
   [+] Detailed Instructions

   Start of procedure

   1. In a text editor, open the start file run.sh.
   2. Change the argument for the -app parameter to the correct name of the backup DB Server application.
   3. Add the following at the end of the command line:
      -cfg -c <backup_db_server_config_file_name>
   4. Save and close the file.

   End of procedure

   Start of procedure

   1. In a text editor, open the start file startserver.bat.
   2. Change the argument for the -app parameter to the correct name of the backup DB Server application.
   3. Add the following at the end of the command line:
      -cfg -c <backup_db_server_config_file_name>
   4. Save and close the file.

   End of procedure

Starting a Backup Configuration DB Server

When starting a backup DB Server, use the following command-line parameters:

-c	The name of the configuration file that contains configuration information for the backup DB Server.
-app	The name of the backup DB Server application.

For a description of other command-line parameters specific to DB Server, refer to DB Server.

Prerequisites

• The run.sh file of the backup DB Server has been modified accordingly. Refer to Modifying a backup Configuration DB Server start file, above.

Start of procedure

• To start from Genesys Administrator, refer to Starting and Stopping with the Management Layer.
• To start manually, go to the directory in which the backup DB Server is installed, and do one of the following:
  • To use only the required command-line parameters, enter the following command line:
    sh run.sh
  • To specify the command line yourself, or to use additional command-line parameters, enter the following command line:
    multiserver -host <Configuration Server host> -port <Configuration Server port> -app <backup DB Server Application> -cfg -c <backup DB Server configuration file>

End of procedure

Prerequisites

• The startserver.bat file of the backup DB Server has been modified accordingly. Refer to Modifying a backup Configuration DB Server start file, above.

Start of procedure

• To start as a Windows Service, refer to Starting and Stopping with Windows Service Manager.
• To start from Genesys Administrator, refer to Starting and Stopping with the Management Layer.
• To start manually, do one of the following:
  • Use the Start > Programs menu.
  • To use only the required command-line parameters, go to the directory in which the backup DB Server is installed, and double-click on the startServer.bat file.
  • To specify the command line yourself, or to use additional command-line parameters, open the MS-DOS window, go to the directory in which the backup DB Server is installed, and type the following command line:
    multiserver.exe -host <Configuration Server host> -port <Configuration Server port> -app <backup DB Server Application> -cfg -c <backup DB Server configuration file>

End of procedure