SharePlex 11.0 - SharePlex Installation and Setup for Oracle on RDS

SharePlex License Utilities

SharePlex License Utilities

Description

Use the SharePlex license utilities to view, add, and remove license keys to hosts in the SharePlex replication environment. Each installation of SharePlex requires a valid license key.

There are three types of SharePlex license keys for each supported platforms:

• Trial license keys

• Perpetual License keys (Permanent)
• Term license keys

Following is the list of supported platforms for which licenses are available:

• Oracle

• File

• JMS

• Kafka

• SQL Server

• Postgres

• MySQL

• Snowflake

• Event Hubs

• All Platforms

SharePlex licensing information can be found in the Quest Software Product Guide. Please contact your account manager if you have questions.

If you do not have a valid license key, you may obtain one from Quest Technical Support or your Quest sales representative for the required platform from the above list of supported platforms. Use the appropriate procedure in this documentation to obtain the necessary information to support your license request.

License utilities on Unix and Linux

On Unix and Linux systems, separate utilities are used to:

• Add a license key
• View a license key

• Remove a license key

Add a license key

Use the splex_add_key utility to add a license key to a machine during the installation of SharePlex or afterward to convert from one type of license to another.

You can use the splex_add_key utility as follows:

• You can use splex_add_key on the primary node of a cluster to install licenses for all secondary nodes in the cluster, because they all share one variable-data directory.
• You cannot use splex_add_key to add licenses for non-clustered machines from one machine. It must be run on each non-clustered replication system so that the license information is stored in the variable-data directory on each system.

To run splex_add_key:

1. Log on to the system as the SharePlex Administrator.
2. Run sp_ctrl on the machine where you want to install a license key.

3. If SharePlex is running, shut it down.

   sp_ctrl> shutdown

4. Run splex_add_key from the install sub-directory of the SharePlex product directory.

   $ /proddir/install/splex_add_key

5. Choose a platform to add/update license key:

   SharePlex License Utility

   1) Oracle

   2) File
   

   3) JMS

   4) Kafka

   5) SQL Server

   6) Postgres

   7) MySQL

   8) Snowflake

   9) Event Hubs

   10) All Platforms

   q) Quit License Utility

   Enter option:

6. Enter the appropriate number from the above list to choose the platform.

7. Enter the key manually as received from Quest. Press Enter when finished entering the key.

8. Enter q to exit the utility.
9. Start SharePlex when you are ready for replication to resume.

View a license key

Use the splex_get_key utility to view the SharePlex license key related details. Run this utility from the install sub-directory of the SharePlex product directory.

$ /proddir/install/splex_get_key

The information is similar to the following example:

$ /splex/proddir/install/splex_get_key 

Platform           = All

Product Name       = SharePlex

Product Version    = 11

License Number     = 123-456-789

License Key Type   = Trial

License Expiry     = Midnight of Jan 01, 2050

License Key        = lxxjLny9CqMCqdPZKZGRXIjnz7vpbTPQANliJi7PXJ7+Q8=

Remove a license key

Use the splex_remove_key utility to remove already installed SharePlex license key for a particular platform. If no license key is installed on the machine, it will display the "No license installed" message.

To run splex_remove_key:

1. Log on to the system as the SharePlex Administrator.

2. Run splex_remove_key from the install sub-directory of the SharePlex product directory to remove a license key. Remove key will display a list of previously added licence keys.

   $ /proddir/install/splex_remove_key

3. Choose the appropriate platform to remove a license key:

   SharePlex License Utility

   1) Oracle

   2) Postgres

   q) Quit License Utility

   Enter option: 1

A successful removal of the license terminates with a message similar to the following:

The SharePlex for Oracle license has been successfully removed.