Skip to content

Configuring Failover Server

Offline Environments

You can add a standalone HP Anyware License Server to act as a backup in case the main HP Anyware License Server fails. The main server periodically updates the backup server to keep it in sync. The two servers are registered as a pair called a failover pair.

In a failover situation, when the main server is down or is unreachable, the backup one can validate sessions. However, the backup server does not synchronize data with the main server. Hence, information about usage will be unreliable as long as the failover lasts.

Note: About Failover

Failover requires manual changes in PCoIP Connection Managers and Anyware Agents. Switching from the main HP Anyware License Server to the backup one requires configuration manually in your PCoIP Connection Managers and Anyware agents. See Failover behavior for more information.

Installation Notes

  • The backup server must have the same version as the main server.

  • Both license servers should be configured identically with some allowable differences. For example, you can specify different PORT values for these servers.

  • The host IDs of both the main and backup servers must be the same type (for example, you can use two VM UUIDs or two Ethernet MAC addresses, but not one of each).

  • The two servers should be in different physical locations if possible or at least on independent hypervisors so that an incident or a failure will not take down both servers.

  • The host IDs of both the main and backup servers must be the same type (for example, you can use two VM UUIDs or two Ethernet MAC addresses, but not one of each).

  • The clocks of both the servers must be accurate, synchronized, and in the same time zone. If they are not, unpredictable behavior can occur.

  • You must configure the main server with the failover information before the backup server is registered with HP. If the backup server is registered with HP(FNO) before the configuration completes, create a ticket with HP Support for assistance.

Installing and Configuring a Failover Pair

Failover pairs can be configured with an Internet connection, with a temporary Internet connection, or without it (true darksites). The main and backup servers must always have connectivity with each other.

  • In offline environments, if you can make a temporary connection to the Internet, follow the Connected Environment steps. The temporary connection must be opened for both main and backup license servers

  • If you cannot, follow the Darksite Environment steps instead.

1. Set the host ID of the backup server on the main server

The main server needs to know the ID of the backup server to create a failover pair. Get the ID from the backup server and add it in the configuration file on the main server.

  1. Start the backup HP Anyware License Server.

  2. Execute the below command and note the host ID in a response:

    pcoip-get-license-server-id

  3. Stop the backup server:

    1. Navigate to Services and select the HP Anyware License Server" service.

    2. Stop the service.

  4. Switch to the main server and start it:

    1. Navigate to Services and select the HP Anyware License Server" service.

    2. Start the service.

  5. On the main server, use a text editor to edit C:\Program Files\HP\HP Anyware License Server\server\local-configuration.yaml.

  6. Set the backup-hostid you recorded in step 2.

  7. Save and exit the editor.

  8. Shut down the main server:

    1. Navigate to Services and select the HP Anyware License Server" service.

    2. Stop the service.

  9. Shut down the backup server.

2. Register HP Anyware License Servers

  1. Start the main HP Anyware License Server.

    1. Navigate to Services and select the HP Anyware License Server" service.

    2. Start the service.

  2. Execute the following command:

    pcoip-list-licenses

  3. Start the backup server after you see a valid response from pcoip-list-licenses.

3. Enable failover support on the backup server

Configure a few settings on the backup server to act as a backup and sync with the main server.

On the backup server, use flexnetlsadmin.bat to set the following HP Anyware License Server policy settings. The flexnetlsadmin.bat utility is available at: C:\Program Files\HP\HP Anyware License Server\enterprise

!!! note "Note: Prompt for Password" You will be prompted for a password when using these commands. When prompted, provide the administrative password, as set by pcoip-set-password.

  • fne.syncTo.mainUri: Set this in the URI of the main server using this format: https://<licenseServerHostName>:<port>/fne/bin/capability.

Example:

.flexnetlsadmin.bat -server http://localhost:7070/api/1.0/instances/~ -authorize admin -passwordConsoleInput -config -set fne.syncTo.mainUri=http://<MainLicenseServerHostName>:7070/fne/bin/capability
  • fne.syncTo.enabled: Set this value to true.

Example:

.flexnetlsadmin.bat -server http://localhost:7070/api/1.0/instances/~ -authorize admin -passwordConsoleInput -config -set fne.syncTo.enabled=true

4. Configure response reference information on the main server

Capability responses returned to client devices include the URIs for the main and backup servers. Configure one or both of these policy settings to include the corresponding URIs in the response reference information:

  • Include the main server URI in client responses: Set the licensing.main.uri value using flexnetlsadmin.bat.

Example:

.flexnetlsadmin.bat -server http://localhost:7070/api/1.0/instances/~ -authorize admin -passwordConsoleInput -config -set licensing.main.uri=http://<MainLicenseServerHostName>:7070/fne/bin/capability
  • Include the backup server URI in client responses: Set the licensing.backup.uri value using flexnetlsadmin.bat.

Example:

.flexnetlsadmin.bat -server http://localhost:7070/api/1.0/instances/~ -authorize admin -passwordConsoleInput -config -set licensing.backup.uri=http://<BackupLicenseServerHostName>:7070/fne/bin/capability

5. Activate licenses on the main server

Partially Internet-Connected Environments

If licenses are not activated on the main server at start, activate them now by executing pcoip-activate-online-license command. The active licenses automatically sync to the backup server. For more information, see activate online license.

After this activation, close the Internet connection for both the main and the backup servers.

!!! warning: "Caution: Disconnect Internet" The main and backup servers still must have connectivity with each other even after the Internet is disconnected.

Darksite Environments

If licenses are not activated on the main server at start,activate them now by executing response.bin on both main and backup servers to keep them synchronized.

If you make changes on the main server that need to be synchronized with the backup, restart the service on the backup:

  1. Navigate to Services and select the HP Anyware License Server" service.

  2. Stop the service.

  3. Start the service.

6. Verify failover configuration

After both servers receive their license rights, verify the failover scenario role of each server. The failover role for each server is included in the capability responses delivered to it.

Use the flexnetlsadmin.bat tool from each server to verify its failover role. As usual, replace the URI and port information here with yours.

  • From the main HP Anyware License Server:
.flexnetlsadmin.bat -server <http://localhost:7071/api/1.0/instances/>~ -authorize admin -passwordConsoleInput -status

You should see a backup server specified in the response.

  • From the backup HP Anyware License Server:
.flexnetlsadmin.bat -server <http://localhost:7071/api/1.0/instances/>~ -authorize admin -passwordConsoleInput -status

This response should not contain a backup server item.