StarQuest Technical Documents

How to Configure a Failover StarLicense Server

Last Update: 4 October 2008
Product: StarLicense
Version: 1.x
Article ID: SQV00SL001

Abstract

If you have more than one StarLicense server in the network, you can configure backup servers for failover so that requests to the Primary server for license connections can be fulfilled even if the Primary server fails or the service is stopped. Note that the failover StarLicense server does not require a license key.

Solution

Follow the steps in one of the below sections, depending on which computer operating system the server is running.

StarLicense for Windows

StarLicense for UNIX

StarLicense for Windows Instructions

Install StarLicense on a server that you want to act as the failover (backup) server. To add a Primary server that you want this failover server to monitor,

  1. Click the Add button of the Failover tab in the configuration for the backup server.
  2. In the Add Primary Server dialog, enter the Host Name or IP address of the Primary server and click OK.

On the StarSQL client, configure the License Configuration with the failover server location.

  1. On the License Servers tab, click the Add button to add a license server. Enter the Host Name or IP address of the failover server, select SECONDARY as the role, and click Add.
  2. After the StarSQL License Configuration verifies connectivity from the client to the failover server (this is performed automatically), review the configuration to ensure that both PRIMARY and SECONDARY servers are configured.

StarLicense for UNIX Instructions

Install StarLicense on a server that you wish to act as the failover (backup) server. To add a Primary server that you want this failover server to monitor,

  1. Log on as root user.
  2. Open the /etc/starlicense.rc file in a text editor and add or modify the following section of the file, replacing <IP address> with the IP address of the PRIMARY StarLicense server:

    [PrimaryServer0]
    Hostname=<IP address>

  3. Stop and restart the StarLicense service from the StarLicense Configuration Menu.

On the StarSQL client, configure StarLicense with the failover server location.

  1. Log on as root user.
  2. Open the /etc/starlicense.rc file in a text editor and add two entries, one for the Primary StarLicense server and one for the Failover StarLicense Server, as shown below:

    [ClientServer0]
    ProdID=CA
    IP=<IP of PRIMARY StarLicense server>
    Port=4999
    Primary=1

    [ClientServer1]
    ProdID=CA
    IP=<IP of SECONDARY StarLicense failover server>
    Port=4999
    Primary=0

  3. Save the file.
  4. Stop and restart the StarLicense service from the StarLicense Configuration Menu.

DISCLAIMER

The information in technical documents comes without any warranty or applicability for a specific purpose. The author(s) or distributor(s) will not accept responsibility for any damage incurred directly or indirectly through use of the information contained in these documents. The instructions may need to be modified to be appropriate for the hardware and software that has been installed and configured within a particular organization.  The information in technical documents should be considered only as an example and may include information from various sources, including IBM, Microsoft, and other organizations.