Installing a License on the ESM

Products

• STARTER PACK-7
• CA API Gateway
• CA API Gateway Enterprise Service Manager (Layer 7)

Issue/Introduction

Loading a license for the API Enterprise Service Manager (ESM) may prove impossible under certain conditions. Examples of when this may not work as expected:

• When the Firefox browser is used to load the license
• When the Chrome browser is used to load the license
• A mix of certain versions and settings in Internet Explorer (IE) will not allow the license to be loaded

If you are experiencing difficulties loading a license file in ESM, please follow the workaround noted below using the command-line utility

Environment

Release:
Component: APIESM

Resolution

Follow the instructions below to load a license key in the ESM using the command-line utility.

1. Unzip the attached file em-install-license.zip and copy its contents to the gateway running the ESM. They can be copied to any directory but the ssgconfig home directory is recommended.
2. Copy the ESM license to the gateway running the ESM. It can be copied to any directory but the ssgconfig home directory is recommended.
3. Add run permission to the install license script:

   chmod +x installlicense.sh

4. Stop the ESM:

   service ssem stop

5. Run the install license script providing the path to the license file as the argument:

   ./installlicense.sh licenseFile.xml

6. Start the ESM:

   service ssem start

Additional Information

• The following warning is shown if there is no license currently installed, and it can be safely ignored:

  WARNING 02000: No row was found for FETCH, UPDATE or DELETE; or the result of a query is an empty table.

• The following warnings are shown if the ESM is running:

  ERROR XJ040: Failed to start database '/opt/SecureSpan/EnterpriseManager/var/db/emsdb' with class loader [email protected], see the next exception for details.

  ERROR XSDB6: Another instance of Derby may have already booted the database /opt/SecureSpan/EnterpriseManager/var/db/emsdb.

  If you see the above two warnings, then stop the ESM and try the script again.