Applying a LANSA license to V14

Date:16 November 2015
Product/Release:LANSA V14
Abstract:Applying a license to LANSA V14
Submitted By:LANSA Technical Support

This information relates to applying a V14 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 (or creating a new license file if it doesn't exist). This type of LANSA licensing generally applies to server licenses, for example, LXX (superserver), DEV (iSeries Development), CLT (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 V14 server license codes will be provided in a file named
x_lic_<model>_Serial number>_<request number>.xml
See image below for an example.

Exame of email containing a license code file

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

  1. Copy the x_lic_*.xml file to a local location on your PC. While you can copy the license file to any local location, the recommended location is the Visual LANSA \X_LANSA folder as this is the default location that the license facility will look in. For example, <root>\X_WIN95\X_LANSA
  2. From the LANSA folder, Open the Settings and Administration folder and select the Licensing - Server Licenses shortcut. 
    Select Server Licenses from the Settings and Administration folder
  3. This will open the Server Licenses utility. If this is a new V14 installation, no licenses will be listed yet.
    Server Licenses Utiltiy
  4. Click the New tabsheet and using the prompter, navigate to the location where you copied the x_lic_*.xml file to. Select the file and click the Open button. Click the Load Licenses button to list the licenses. Load the license file
  5. Once the licenses have been loaded, you can click the Apply All (or Apply Selected) button and the license details will be added to the Existing tabsheet.View licenses that have already been applied
  6. If you need to add further licenses, you can follow the same steps with the new x_lic_*.xml file. In summary
    • Copy the latest  x_lic_*.xml file to the <root>\X_WIN95\X_LANSA folder
      To apply additional licenses, repeat the steps
    • From the LANSA folder, open the Licensing - Server Licenses utility.
    • Navigate to the location of the x_lic_*.xml file and select Open
    • Click the Load Licenses button to list the licenses and click the Apply All (or Apply Selected) button. The new license details are added to the Existing list of licenses. (In the image below, LCE - LANSA Open has been added).
      The new license details are added to the existing licenses
  7. 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

A few points to consider regarding LANSA for iSeries V14 licensing

  • New licenses are required for V14. The license details are provided in an xml document in the same way as the Visual LANSA Server License codes
  • A new V14 install or an upgrade to V14 will create a License folder in the LANSA_<pgmlib> tree on the IBM i IFS. For example, /LANSA_dcxpgmlib/license
  • The x_lic_*.xml file you receive from LANSA licensing should be copied to this IFS location. You IBM i administrator can provide the steps to move a file to the IBM i IFS. The most common methods are to use the QNTC file system, AS/400 NetServer or iSeries Navigator.
  • The following steps assume that the V14 license file is already located in the IBM i IFS location /LANSA_<pgmlib>/license

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. All current licenses will be listed with their status. Note: If this is a new V14 install, you will see a standard list of 7 day temporary licenses which are provided with the new install.
    View current licenses
  4. Select F6 to launch the Request New License File screen. On this screen, you need to enter the full IFS path to the license file, including the license file name, as per the screen below.
    Hint: To avoid mistakes in the path, use WRKLNK to navigate to the location and press option 5 to view the XML file. Then you can copy the full path from the Browse field at the top of the screen and paste it into the New License File Path.
    Enter the path to the license file
  5. After pressing Enter, the New License screen will be re-displayed. Existing and new licenses will be indicated.
    The new license will now be added to the list of existing licenses
  6. Press F6=Apply to apply the licenses. Your license file will be updated with the new license codes details.
  7. Generating an invalid license error? See troubleshooting

Server License Codes - UNIX/Linux

Instructions to come.

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. 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 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 in the same LANSA folder as the LANSA.EXE.
    Confirm LANSAKEY.TXT is in the same folder as LANSA.EXE
  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 (from Windows -> Services) for the license to be picked up. The License Server service is called Sentinel RMS License Manager
  6. Generating an invalid license error? See troubleshooting

If you currently have a License Server servicing pre-V14 Visual LANSA and you wish the same the same License Server to also service V14 Visual LANSA, there are extra steps to perform if your License Server is going to service both V14 licenses and pre V14 licenses. Perform the following steps

  1. Request your V14 License Server license(s) by providing the CPU details of your License Server CPU.
  2. When you receive your lservrc_<CPU>_<Serial Number>_<Date>.txt file, copy it to a temporary location on the License Server PC and rename to lservrc (no extension).
  3. Go to the location where your current pre-V14 lservrc file is located. The default file location is:
    C:\Program Files\lansa\SentinelLM\lservrc
  4. Right click on the lservrc file and open with Notepad. Copy the contents and paste them into the V14 lservrc file from step 2. Note: Append the contents to the existing contents, do not override the current contents.
  5. This version of lservrc now contains the V14 and the pre-V14 license information. Save this file and copy this file back to the default location in step 3. You can replace the existing lservrc (you may decide to rename the existing lservrc file to lservrc_pre for backup purposes.
  6. You will need to stop and restart the license server service (from Windows -> Services) for the license to be picked up. The License Server service is called Sentinel RMS License Manager
  7. At this point you can open pre-V14 and V14 Visual LANSA using the same License Server.