You are here: Installation > Obtaining and Installing the License

Obtaining and Installing the License

SteelEye LifeKeeper v4.4.0 or later requires a unique license for each server for the Core and each optional recovery kit. The license is a run-time license, which means that you can install LifeKeeper without it, but the license must be installed before you can successfully start and run LifeKeeper.

Note: If using newer hardware with RHEL 6.1, please see the RHEL 6.1 Known Issue in the LifeKeeper for Linux Troubleshooting Section

The Installation Support script installs the Licensing Utilities package which obtains and displays the Host ID of your server. (The Host ID displayed via the Installation Support script will always be a MAC address Host ID. If you wish to use an IP Address Host ID, see the Obtaining an Internet HOST ID topic.) The Host ID, along with the Entitlement ID (Authorization Code) which was provided with your SteelEye LifeKeeper software, is used to obtain the permanent license required to run SteelEye LifeKeeper. The process is illustrated below.

LicenseFlowChart.jpg

Note: Each software package requires a license for each server.

Perform the following steps to obtain and install your license(s) for each server in the LifeKeeper cluster:

  1. Get your Host ID. Make note of the Host ID displayed by the licensing utility in the Installation Support setup script. The Host ID may also be obtained by running /opt/LifeKeeper/bin/lmhostid on the system(s) that you are obtaining licenses for.

  2. Write the Host IDs in a notebook or save them in a file. If saved in a file, copy that file to a system with internet access. Otherwise, take your notebook with you to the system with internet access.

  3. Ensure you have your LifeKeeper Entitlement ID (Authorization Code). You should have received an email with your software containing the Entitlement ID needed to obtain the license.

  4. Obtain your licenses from the SIOS Technology Corp. Licensing Operations Portal.

  1. Using the system that has internet access, navigate to http://us.sios.com/support, select License Key and log in to the SIOS Technology Corp. Licensing Operations Portal.

  2. Select Manage Entitlements.

Note: If changing password, use the Profile button in the upper right corner of the display.

  1. Find your Entitlement ID and select each Activation ID associated with that Entitlement ID by checking the box to the left of the line item.

  2. Select the Activate tab.

  3. Define the required fields and select Next.

  4. Click on Select Existing Host to choose an already defined host or create a new host by selecting Add New Host.

  5. Enter the Host ID and click Okay.

  6. Check the box to the left of the Host ID and select Generate. The Fulfillment ID will display on the License Summary screen.

  7. Check the box to the left of the Fulfillment ID and select the Email License tab.

  8. Enter a valid email address to send the license to and select Send.

  9. Select Complete.

  10. Retrieve the email(s).

  11. Copy the file(s) to the appropriate system(s).

  1. Install your license(s). On each system, copy the license file(s) to /var/LifeKeeper/license, or on each system, run /opt/LifeKeeper/bin/lkkeyins and specify the filename (including full path) of the file.

Primary Network Interface Change May Require a License Rehost

The Host ID used by the licensing utility is obtained from the LifeKeeper server’s primary network interface card (NIC). LifeKeeper will check for a valid license each time it starts. If your LifeKeeper server should require a NIC replacement in the future that would cause the Host ID to change, then the next time LifeKeeper is stopped, a License Rehost must be performed before starting LifeKeeper again. Log in to the SIOS Technology Corp. Licensing Operations Portal and select Support Actions/Rehost from the Manage Licenses screen to perform this rehost. (Note: A rehost can be performed one time per six-month period without contacting support.)

Internet/IP Licensing

For information regarding Internet/IP Licensing, please see the Known Issue in the LifeKeeper for Linux Troubleshooting section and Obtaining an Internet HOST ID.

Subscription Licensing

A subscription license is a time-limited license with renewal capability.  Similar to an evaluation license, it will expire after a set amount of time unless renewed. This renewal process can be set up to renew automatically by following the procedure below. (Note:  The subscription renewal service requires an internet connection to access the SIOS Technology Corp. Licensing Operations server on TCP/IP port 443.)

  1. Run the following command:
    /opt/LifeKeeper/bin/runSubscriptionService start

  2. If prompted, enter User ID and Password (from SIOS Technology Corp. Customer Registration)

If the previous steps run successfully, the subscription renewal service will now run, in the background, periodically checking renewal status. If licenses are found that will be expiring in a certain number of days (90, 60, 30, 20, 10, 5, 4, 3, 2, 1), a warning notification will be sent to syslog (/var/log/messages), and an attempt will be made to renew the license. If a new license activation is available (a new activation has been purchased for this system's Entitlement), it will be automatically fulfilled and the new licenses will be installed on the system replacing the old licenses. As long as licenses for this system are renewed (activations purchased), the service will ensure that the licenses are upgraded on the system without user intervention.

Subscription Licensing Troubleshooting

If errors are encountered, please try the following before contacting support:

  • Review the error messages in the LifeKeeper Log and syslog (/var/log/messages). The following can be run to get messages if necessary:

/opt/LifeKeeper/bin/lmsubscribe --immediate

  • Verify credentials by logging in to the SIOS Technology Corp. Licensing Operations Portal. Navigate to http://us.sios.com/support, select License Key and enter User ID and Password.

  • Enter credentials using the following command:

/opt/LifeKeeper/bin/lmsubscribe –-login

If this works, then run the following to start the service:

/opt/LifeKeeper/bin/runSubscriptionService start

  • If Password ever changes on the Licensing Operations Portal, run the following command to update the automatic license renewal service:

/opt/LifeKeeper/bin/lmsubscribe --login

  • If ownership of the license certificate has changed, please contact SIOS Technology Corp. support personnel to have the certificate moved to the new owner. Once ownership has been moved, the automatic license renewal service will need to be updated with these new credentials by running the following command using the new User ID and Password:

/opt/LifeKeeper/bin/lmsubscribe --login

© 2012 SIOS Technology Corp., the industry's leading provider of business continuity solutions, data replication for continuous data protection.