Installing meshIQ platform licenses when upgrading to version 11

 The meshIQ Platform version 11 uses a single license model to cover all aspects of the meshIQ Platform. License keys for previous versions are not compatible with the meshIQ Platform.  

In previous versions, there were multiple licenses.  

• AutoPilot M6.lic - used by the Domain Server
• AutoPilotWMQ_MQM.lic - used by the Workgroup Server (WGS) 
• XRay_org.lic - used to define XRay usage metrics.

In version 11, these have been replaced by a single license that starts with "meshIQ":  

meshiq_org_Domain_WGS.lic 

Step 1: Obtain your license

Refer to the article, My license is expiring, how do I get a new one?, for information on how to get a new license.

You can open your license file to view the parameters, but do not update it as this will invalidate the license.

Step 2: Install your license

1. Stop all services.
2. Copy the licenses to the respective folders. The expected locations for licenses are as follows:
   • For the domain server:  Copy the license into [AUTOPILOT_HOME]/naming/ directory. This location is the default location for the domain server.
   • For each workgroup server: Copy the license into the WGS folder, for example, localhost. 
   • For meshIQ Data Services: Copy the license into the jkool-cmd.sh utility folder.
3. Start the Domain server to verify that its license is installed properly. Verify that you can log in to Enterprise Manager.
4. Start the WGS. Because the license name has changed, and the license location property is still pointing to the old license information, the workgroup server will not start. Update the License File property on the General tab to reflect the new meshIQ Platform license information.  Save the properties and restart the WGS.  
5. If you have an existing XRay environment, the following steps are required to upgrade to meshIQ data services and Track:
   1. Start ZooKeeper (if used) and Solr.
   2. Run the following commands. The first command changes the directory and the second command loads the license. Be sure to change <path_to_lic-file> (include path and file name), <solr-url> and <pwd> accordingly. The user name is Administrator.

      >cd $APIN_HOME/misc/jkool-dbapi/current 
      >bin/jkool-cmd.sh -loadlic -f:<path_to_lic-file> –C:<solr-url> -U:Administrator -P:<pwd>

      Example:

      >cd $APIN_HOME/misc/jkool-dbapi/current
      >bin/jkool-cmd.sh -loadlic -f:$APIN_HOME/misc/license/meshiq_org_Prod_MQM.lic -C:http://localhost:8983 -U:Administrator -P:admin 

6. Restart all remaining services.

See Verifying that your meshIQ Platform license is installed correctly to learn how to verify the new license.

See About the meshIQ Platform license for detailed information about the license and how it is used.