Updating your expiring XRay license

Licenses are configured with an expiration date; XRay will no longer start after your license expires. See the steps below on how to retrieve and install a new license. 

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. The name of your new license file will be XRay_xyz.lic, where xyz represents the organization name. Create a backup of this file for safe keeping. 
2. Confirm that ZooKeeper and Solr are running.
3. Start the Solr cluster.
4. Load the license by running 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.
   

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

   (Please note that the user name of Administrator is used in versions 1.3 and later.)
   The following is an example:

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

Step 3:  Confirm that your license was properly installed

Confirm that your license was properly installed by viewing the license's parameters. Perform the following:

1. Within XRay, run the following jKQL query:
   

   jKQL> get license

2. Your license's parameters will display if the license file was successfully installed. The results should be similar to the below screenshot. Use the scroll bars to view all fields.