Applying a LANSA license to V11 or V12

Date:11 January 2010
Product/Release:LANSA V11 and V12
Abstract:Applying a license to LANSA V11 or V12
Submitted By:LANSA Technical Support
Last Review:October 2012

This information is for applying a V11 or V12 LANSA license. To apply a V13 LANSA license, click here.

The LANSA license you have received is either a Server License Code(s) or a Software Key License File. Your LANSA License email notification states what type you have received.  Select the appropriate type below:


Server License Code

This involves adding the license code you have received from LANSA Licensing to an existing license file in your LANSA environment. This type of LANSA licensing generally applies to server licensing, for example, LXX (superserver), DEV (iSeries Development), CXX (LANSA Client), WEB (Web execution).

Note: The license you have received is only valid for the CPU that you have requested it for.

Select the Operating System to apply this license to:


Software Key License File (including License server)

This is also known as softkey licensing. Applying this license involves placing the Software Key License file in a designated location so that LANSA can read it. The file must follow the correct naming convention.

Note: The license you have received is only valid for the CPU that you have requested it for.

Select the type of Software Key License file:


Server License Code - Windows

Visual LANSA stores license details in a flat file called x_lickey.dat, located in the x_lansa directory. When LANSA is installed, this file is automatically created, ready for you to install license codes. The following is an example of the contents of this file (the "*" denotes a comment line):

*
* The contents of this file define the licenses on this machine.
*
* Each line consists of the 3 character "Type of License" description,
* followed immediately by the "License Code Assigned", 31 characters in 
* total.
*
* For example:
* YYY0123456789ABCDEFGHIJKLMNOPQR
*
* Use the special process *LICENSES (x_run proc=*LICENSES ...) to verify 
* that licenses have been added correctly
*

To install your new license details, perform the following steps:

  1. In the LANSA folder, select Settings and Administration and select the Server Licenses menu option. This opens the file x_lickey.dat.
    The Server Licence option can be accessed from the LANSA folder.
  2. For each license, add a line containing the three character license type, followed immediately by the license code (no spaces). 
  3. To verify the newly added license, in the LANSA folder, select Settings and Administration and select the LANSA License Status menu option.
    The LANSA Licence Status option can be accessed from the LANSA folder.
  4. Enter a valid partition identifier, click OK and review the license details.
  5. Generating an invalid license error? See troubleshooting

Note: If the licenses are to be applied to a Windows server running the LANSA Listener, you must stop the listener before adding LANSA license codes and restart it again for the new license codes to be recognized.


Server License Codes - IBM i

Steps to apply a license:

  1. Sign on to the IBM i using one of the following profiles:
    QSECOFR user profile or partition security officer profile for SYS partition.
  2. From an i5/OS command entry (CALL QCMD), execute the LANSA license facility using the command:
    <pgmlib>/LANSA LICENSE
  3. Select the Insert a Permanent License Code option from the Work With Licenses menu. The following screen is displayed.
    Insert Permanent License Code screen
  4. Use this screen to insert each new permanent or temporary license code supplied by your product vendor. The license code can only be inserted on the IBM i for which it was issued.
  5. New License Type. Enter the Type of License issued to you.
  6. New License Code. Enter the License Code assigned to your IBM i.
    As this is quite a long code, care must be taken to enter it correctly. To assist you, below the code are the numbers and letters of the code, printed in words.
    For example, code "103OVX58" would be printed in words as:
    ONE ZERO THREE OSCAR VICTOR XRAY FIVE EIGHT.
  7. Press Enter to update.
  8. AFTER UPDATING LICENSE DETAILS, SIGN OFF AND ON AGAIN.
  9. Generating an invalid license error? See troubleshooting

Server License Codes - UNIX/Linux

Visual LANSA stores license details in a flat file called x_lickey.dat, located in the x_lansa directory. When LANSA is installed, this file is automatically created, ready for you to install license codes. The following is an example of the contents of this file (the "*" denotes a comment line):

*
* The contents of this file define the licenses on this machine.
*
* Each line consists of the 3 character "Type of License" description,
* followed immediately by the "License Code Assigned", 31 characters in
* total.
*
* For example:
* YYY0123456789ABCDEFGHIJKLMNOPQR
*
* Use the special process *LICENSES (x_run proc=*LICENSES ...) to verify
* that licenses have been added correctly
*

To install your license details, edit the file x_lickey.dat. For each license, add a line containing the three character license type, followed immediately by the license code (no spaces). See Reviewing License Status for instructions on how to verify that you have entered license details correctly.

Note: If the licenses are to be applied to a Windows server running the LANSA Listener, you must stop the listener before editing the x_lickey.dat file and restart it again for the new license codes to be recognized.

Generating an invalid license error? See troubleshooting


Software Key License File - Visual LANSA Development and Web development (Windows only)

  1. The Software Key License File you have received from LANSA Licensing is named lansakey_<CPU>_<Serial Number>_<Date>.txt
  2. Copy the supplied file to a temporary location on your hard drive.
  3. Rename the file to lansakey.txt
  4. Copy lansakey.txt to the same directory as the LANSA.EXE executable. For example, the default file location is:
    C:\Program Files\LANSA\LANSA\lansakey.txt

    Note: A lansakey.txt will be installed as part of a Visual LANSA V11.0 installation, you should elect to replace the default lansakey.txt with the version you have received from LANSA Licensing.
     
  5. Start Windows Explorer and confirm that the lansakey.txt file is present.
  6. Generating an invalid license error? See troubleshooting

Software Key License File - License Server for Visual LANSA Development (Windows only)

Note: These steps must be performed on the CPU that is nominated as the License server.

  1. The Software Key License File you have received from LANSA Licensing is named lservrc_<CPU>_<Serial Number>_<Date>.txt
  2. Copy the supplied file to a temporary location on your hard drive.
  3. Rename the file to lservrc (no extension)
  4. Copy lservrc to the directory where you installed the License Server service. The default file location is:
    C:\Program Files\lansa\SentinelLM\lservrc
  5. You will need to stop and restart the license server service for the license to be picked up.
  6. Generating an invalid license error? See troubleshooting

Software Key License File - LANSA Integrator (Windows and IBM i)

  1. The Software Key License File you have received from LANSA Licensing is named lansakey_<CPU>_<Serial Number>_<Date>.txt;
  2. Copy the supplied file to a temporary location on your hard drive.
  3. Open the file and copy all the contents (using Ctrl + A and Ctrl + C)
  4. Open LANSA Integrator Studio from the icon in the LANSA Integrator folder.;
  5. Go to the Server Instance and select the server that the license code is to be applied to.
  6. Right click and select License Import
  7. Paste in the new LANSA Integrator codes
  8. Select Import. Your Software Key License File will be updated with the new codes.
  9. Right click on the server and select License Check to validate the new codes
    Note: You can only perform a license check in LANSA Integrator Studio if you have access to the server. If you haven't already setup a server, review the setup instructions in the LANSA Integrator guide.
  10. Generating an invalid license error? See troubleshooting

Software Key License File - UNIX/Linux

  1. Copy the supplied lansakey.txt to the JSM instance system subdirectory. The default file location is:
    $LANSAXROOT/integrator/instance/system/lansakey.txt
    where the LANSAXROOT environment variable points to the LANSA install directory.
  2. Generating an invalid license error? See troubleshooting