Applying a LANSA license to V13

Date:13 December 2012
Product/Release:LANSA V13
Abstract:Applying a license to LANSA V13
Submitted By:LANSA Technical Support
Updated:7 October 2015

This information relates to applying a V13 LANSA license. To apply a V14 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).

Change for V13 - LANSA Integrator licenses (e.g JME) are applied as server license codes, not softkey licenses.

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 V13 server license codes will be provided in a file named
x_lic_<model>_Serial number>_<request number>.xml
See image below for an example.

Example of license codes listed in the 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 V13 installation, no licenses will be listed yet.
    Server License Utility
  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 V13 licensing

  • New licenses are required for V13. The license details are provided in an xml document in the same way as the Visual LANSA Server License codes
  • A new V13 install or an upgrade to V13 will create a License folder in the LANSA_<pgmlib> tree on the IBM i IFS. For example, /LANSA_dcxpgmlib/license
  • The xml document 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 V13 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 V13 install, you will see a standard list of 7 day licenses which are provided with the new install.
    View current licenses
  4. Select F6 to request a new license file. In the Request New License File 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-V13 Visual LANSA and you wish the same the same License Server to also service V13 Visual LANSA, there are extra steps to perform if your License Server is going to service both V13 licenses and pre V13 licenses. Perform the following steps

  1. Request your V13 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-V13 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 V13 lservrc file from step 2. Note: Add the contents to the existing contents, do not override the current contents.
  5. This version of lservrc now contains the V13 and the pre-V13 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_v12 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-V13 and V13 Visual LANSA using the same License Server.