Applying a LANSA license to Version 14 Service Pack 1 (V14 SP1)

Date:5 August 2016
Product/Release:LANSA V14 SP1 or above
Abstract:Applying a license to LANSA V14 at Service Pack 1 or above
Submitted By:LANSA Technical Support

The information on this page relates to applying a LANSA license at V14 Service Pack 1 level or above.

In Service Pack 1 for V14, changes have been made to LANSA licensing on Windows. These changes affect licenses of type Server License Code(s). 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. Before continuing, make sure that the title states Server License V14 SP1
    Server Licences - V14 SP1
    The user interface for V14 SP1 has changed. New in V14 SP1 is a license file location, which can be local or shared. There are 3 license screens ...Applied, Add Licenses and Advanced Settings.
  4. Applied
    The Applied tab sheet will indicate whether the active license file location is Local or Shared. If this is a new V14 installation, no licenses will be listed yet.
    V14 SP1 Server Licenses has 3 screens: Applied, Add Licenses and Advanced Settings
    • File Location - Active This attempts to load the license file for the current LANSA environment. If a license file exists locally, this will be loaded. If there is no license file locally, the shared location will be searched for a license file (refer to Advanced Settings for the Shared location details).
    • File Location - Local This attempts to load the local license file. The Local location defaults to <root>:\x_win95\x_lansa\ where <root> is the current LANSA system. 
    • File Location - Shared This option indicates if a license file exists in the location specified as the shared location. A shared license file can be accessed by more than 1 LANSA system on the same CPU.
    • File Location - Other Selecting Other allows you to navigate to a location where a license file exists for any CPU and loads the licenses for review.
    • Delete Selected This allows you to deleted 1 or more selected licenses from a license file, for example, expired licenses or duplicates. Care should be taken when selecting and deleting licenses.
  5. Add Licenses
    This screen allows you to navigate to a location and select an XML file containing licenses to be applied.
    Loading Server Licences Codes from file
    • Save to File Location Active When you apply licenses with Active selected, they will be added to the license file that is Active.  
    • Save to File Location Local When you apply licenses with Local selected, they will be added to the license file for the current LANSA environment..
    • Save to File Location Shared When you apply licenses with Shared selected, they will be added to the license file in the location specified for Shared in Advanced Settings.
    • Save to File Location Temp When you apply licenses with Temp selected, a license file will be created in the %TEMP% location. If a license file for this CPU already exists in %TEMP%, they will be added to the license file. Save to Location Temp is useful if you are generating license files for other CPUs.
  6. Advanced Settings
    Allows you to review and set default locations for license files. The current Shared location is displayed at the top of the screen.
    Advanced Settings
  7. Set the location for shared LANSA license location.  You can set the location of where you want the Shared license file to be located. This might be an existing LANSA location or the default LANSA Common location: C:\Program Files (x86)\Common Files\LANSA. You can type in a location or use the button to navigate to a location.
  8. Default If you wish to set the Shared license file location to the defaut, you can select the Default button, which sets the shared LANSA license location to C:\Program Files (x86)\Common Files\LANSA. If you now go back to the Applied tabsheet and select Shared, the new location set in Advanced Settings will be shown.
  9. Copy This option allows you to copy the LANSA license file from the set Shared license file location to the Local license file location. This is useful if you install a new Visual LANSA configuration and you only want to add licenses to this configuration. A Copy message box will be issued asking if you wish to proceed.
    Copy license file to shared location
  10. Move This option allows you to move a license file to the shared location. This option is useful if you applied a license locally but want all Visual LANSA configurations on this CPU to access the licenses. A dialog will be issued asking if you wish to proceed.
    Move license file to shared location
    If no license file exists in the location you are moving from (or if you have already moved the license file from this location), the move will fail and a message will be issued.
    Attempt to move file failed
  11. 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.