IBM Support

Apex patch installation results in license errors

Troubleshooting


Problem

After installing the latest architecture series patch for IBM Rational Apex Native, attempts to run the test_install script, install patches for Ada or C++ views, or start Apex result in license errors. IBM no longer owns this product but is providing its technical support documents "AS-IS" for Atego customer benefit until 1 May 2013. For information about technical assistance, visit http://www.atego.com/support/

Symptom

After installing the latest <arch> series patch for Apex Native (where <arch> is either sun4_solaris2, i386_solaris2, or i386_linux2), attempts to run the test_install script result in errors similar to:


... ./test_install: /rational/base/cots/flexlm.11.8/sun4_solaris2/lmstat: not found

 ... ./test_install: /rational/base/cots/flexlm.11.8/sun4_solaris2/lmstat: not found 

 !!! Cannot test Rational Summit CM--Apex base product not licensed. 

 !!! Cannot test Rational Apex/Ada95--Apex base product not licensed.


and so on.


Attempts to install <arch>_ada or <arch>_cpp series patches result in errors similar to:

Starting Rational Apex Duo 4.4.6 [build date: 06/29/10]

Apex_Message_Server: cannot acquire message server license


The required license, summit_base, could not be obtained.

16:37:25 *** Unable to start Message Server

Error: Rational Apex Duo 'post_install' command failed.



Attempts to start Apex results in errors similar to:


Starting Rational Apex Duo 4.4.6 [build date: 06/29/10]

Apex_Message_Server: cannot acquire message server license

The required license, summit_base, could not be obtained.

 

15:19:38 *** Unable to start Message Server

Cause

Apex licensing has been updated so that customers may now optionally buy and use token licensing with Apex. Apex is now linked with, version 11.8 of the FLEXnet licensing libraries. Because of this change, a version 11.8 (or later) FLEXnet license server and vendor daemon is now required.

Note: Existing customers with valid license keys are not required to use the new token licenses, and your existing Apex licenses will still work. You may notice fewer license features being acquired during processing.

Resolving The Problem

Use one of the following methods to resolve the problem.

  • If you already have FLEXnet 11.8 or Rational License Key Server version 8.2 installed on your system:
    1. Update the DAEMON or VENDOR line in your Apex license.dat file to point to the ibmratl daemon in the appropriate directory. For example:

      VENDOR ibmratl /some_path/RLKS.8.1.2.SolarisSPARC/extras/flexlm.sol

    2. Restart the license server using lmgrd version 11.8 (which is in the same directory as the ibmratl daemon mentioned in the previous step).
    3. Install Apex patches.

  • If you do not have FLEXnet 11.8 or Rational License Key Server version 8.2 installed, and your license server host is the same architecture as the machine where you run Apex:

    There is an <arch>_cots patch for each architecture in the latest patch set that provides FLEXnet 11.8. Install Apex patches as follows:
    1. Install docs series patch (actually, you can install this patch at any time).
    2. Install share series patch.
    3. Install cpp_all series patch if Apex C++ is installed.
    4. Install <arch> series patch.
    5. Install <arch>_cots series patch.
    6. Update the DAEMON or VENDOR line in your Apex license.dat file to point to the ibmratl daemon in the appropriate directory. For example:

      VENDOR ibmratl /rational/base/cots/flexlm.11.8/sun4_solaris2

    7. Restart the license server using lmgrd version 11.8, which step 5 installed as <rational-dir>/base/cots/flexlm.11.8/<arch>/lmgrd
    8. Install <arch>_cpp series patch if Apex C++ is installed.
    9. Install <arch>_ada series patch.
    10. Install Apex Embedded, TestMate and AXI patches, as needed.

  • If you do not have FLEXnet 11.8 or Rational License Key Server version 8.2 installed, and your license server host is not the same architecture as the machine where you run Apex:
    1. Download and install the appropriate variant of Rational License Key Server version 8.2 on your system.
    2. Update the DAEMON or VENDOR line in your Apex license.dat file to point to the ibmratl daemon in the appropriate directory. For example:

      VENDOR ibmratl /some_path/RLKS.8.1.2.SolarisSPARC/extras/flexlm.sol

    3. Restart the license server using lmgrd version 11.8 (which is in the same directory as the ibmratl daemon mentioned in the previous step).
    4. Install Apex patches.
Note: Whichever method you use, the test_install script will probably fail until both the <arch>_cpp series patch and the <arch>_ada series patch are installed.

Note: If any patches failed to run the post_install script because of license errors before you upgraded your license server, run the post_install script manually for those patches, as follows:
  1. Log in as the userid that installed Apex.
  2. Go to the install directory for your Apex installation, for example:

    % cd /rational/releases/apex.4.4.6/install

  3. For each patch that failed to run post_install, do:

    % ./post/install -patch <patch-id>

  4. Follow the prompts to complete the execution of post_install.

[{"Product":{"code":"SSMMQY","label":"Rational Ada Developer"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Licensing","Platform":[{"code":"PF027","label":"Solaris"},{"code":"PF016","label":"Linux"}],"Version":"4.4.6;4.4.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSMMQY","label":"Rational Ada Developer"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Licensing","Platform":[{"code":"","label":"Solaris Linux"}],"Version":"4.4.6 4.4.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
16 June 2018

UID

swg21593428

Page Feedback