1. Verigy V93000 Service Training
Module 9:
FlexLM Licensing
Module 9: FlexLM Licensing
Objective:
Given:
Study Guide
Quiz
Answer questions about FlexLM licensing. 90% correct answers are required to get credit for this module.

2. Licensing Feature for HW Capabilities
HW capabilities are no longer stored in EEPROMs
FLEXlm licenses are used to enable and define scalable HW features (speed, memory, waveforms, edges)
FLEXlm licenses are stored and administrated on a license server (Solaris, HP-UX and Linux are supported)
licenses are locked to the customer chosen license server (cannot be moved/copied to another server with different host ID)
model file now defines the HW capabilities for the tester and need to be configured very thoroughly, otherwise problems arise
repair boards are no longer necessary (boards/modules are generic, model file and available licenses define capabilities)
licenses can float between testers (license can be used first by tester1 then by tester2, but not at the same time)
09 - FlexLM Licensing

3. What is a FlexLM License Server?
A computer with (at least) two* FLEXlm executables…
...to manage license sharing over a client/server network 
FLEXlm License File
FLEXlm License Server
50M to 100MHz
speed upgrade
0 to 12MHz
speed license
50M to 100MHz
speed upgrade
12 to 25MHz
speed license
50M to 100MHz
speed upgrade
0 to 8MV
memory license
50M to 100MHz
speed upgrade
8 to 16MV
memory license
Supported Computer Operating Systems:
Linux Redhat Enterprise 3 or newer
HP-UX or newer
Solaris 7 or newer
3 Programs (executables):
socbu (868Kb) *
lmgrd (536Kb) *
lmutil (567Kb)
Programs (all 3) available at
* Red bullets indicate required files. *
Floating license means they must be served by a FlexLM server. This server is a necessary part of the Pin Scale environment. Can be almost any machine as long as it runs one of the three OS’s listed. Three programs required. All are provided on the web site.
09 - FlexLM Licensing

4. FlexLM License Local Server
Tester A 
Simple to administer – no LAN or 2nd computer needed
Easy to move tester with licenses (anywhere)
09 - FlexLM Licensing

5. FlexLM License Remote Server
Simple to administer
Extra computer needed
Moving cards between testers is not problematic
Cannot move licenses with a tester
without moving/connecting server
Single point of failure – impact all connected testers
FLEXlm License Server
LAN (or WAN)
check out
check in
Tester A
Tester B
Tester C
Tester D
09 - FlexLM Licensing

6. A collection of FLEXlm license strings
What is a FlexLM License?
A collection of FLEXlm license strings
License server hostname (should include domain – preferred: IP-address)
# Comment line – License File for 24 PIN SCALE 800 Cards with base capability
SERVER mucagl ae94f3
VENDOR socbu
INCREMENT Digital_E7945_0_50Mbps socbu jan VENDOR_STRING=
INCREMENT Digital_E7945_50_100Mbps socbu jan VENDOR_STRING=
INCREMENT Digital_E7945_100_200Mbps socbu jan VENDOR_STRING=
INCREMENT Digital_E7945_WF_0_8 socbu jan VENDOR_STRING=
INCREMENT Digital_E7945_WF_8_16 socbu jan VENDOR_STRING=
INCREMENT Digital_E7945_WF_16_32 socbu jan VENDOR_STRING=
INCREMENT Digital_E7945_DIFF socbu jan VENDOR_STRING=
INCREMENT Digital_Shared_Mem_0_8MB socbu jan VENDOR_STRING=
INCREMENT Digital_E7945_200_400Mbps socbu jan VENDOR_STRING=
INCREMENT DC_E9711_CH_4_8 socbu jan VENDOR_STRING=
Host ID (unique in the world) *
Actual lines have been truncated for slide clarity. * * * * * * * * * *
NOTE: A license file is always locked to one license server. It cannot be used on any other server with another host ID!
Normally located in the directory: /opt/flexlm/license
Right-to-Use License Quantity (pins)
More than 6000 licenses are in this file!
File size approx 3 kbytes
09 - FlexLM Licensing

7. A character string adhering to FLEXlm syntax
What is a FlexLM License?
A character string adhering to FLEXlm syntax
Vendor Daemon
License
Version
Expiration
Date
PINSCALE800 Card Feature
Continuation
Character
FLEXlm
Keyword
License Count (pins)
INCREMENT Digital_E7945_Base_0_50Mbps socbu January \ VENDOR_STRING=" ou-5413" SIGN=" F65A 39CF 20D1 349B"
Digital Signature (encryption key)
Customer’s Order Number
ASCII text – Easy to , simple to backup, OS independent
Human readable – comment lines for customer use
Small in size – a few Kbytes
Include a signature that prevents users to edit the licenses
HW licenses are floating licenses, i.e. the licenses can be used by any tester on the testfloor (but not at the same time).
Nothing encrypted, just ASCII. Can use scripts to process. Verigy use of FLEXlm is very standard.
Utilities that work on any other FLEXlm license servers will work here as well. Customer utilities, IT Departments, 3rd party tools. Could manage locally (per tester) or could have world wide servers and management.
09 - FlexLM Licensing

8. FlexLM License Server Process
SmarTest is started in online mode and reads model file, which tells what HW licenses are needed.
FLEXlm client, part of SmarTest, resolves the requested capability into flexlm licenses, e.g. a 800Mbps speed license for Pin Scale 3600 will resolve into: Digital_E8010_Std_0_50Mbps Digital_E8010_Std_50_100Mbps Digital_E8010_Std_100_200Mbps Digital_E8010_Std_200_400Mbps Digital_E8010_Std_400_660Mbps Digital_E8010_Std_660_800Mbps Then it looks into the /opt/flexlm/license directory and reads the *.lic (license) files. Every license file holds the hostname of the license server where it is managed.
FLEXlm client, using the license proxy, contacts the license server to check if the licenses are available, if yes it checks-out the licenses and enables the HW features. If not it will not check out the licenses where some were missing. Like in the above example, if not enough 660_800Mbps licenses are available all channels that were asking for the 800Mbps license will have no license checked out. There the model file needs to be fixed or wait until enough licenses are available on the license server.
When SmarTest quits it will check-in the checked-out licenses and the licenses are again available for other testers.
The model file is the master. The HW capabilities listed in the model file are matched with the existing HW and if everything is ok the software tries to check-out licenses from the license server (which holds all licenses for the testfloor/tester). If that was successful the user can work with the defined HW environment. If not the HW of the tester will not match the wanted configuration as defined in the model file.
09 - FlexLM Licensing

9. FlexLM Model File Entry
For details see Pin Scale Digital / Memory Test Card User’s Guide (E /E ). At system installation the model file needs to be configured correctly to run SW! Example: GLOBAL testhead = TH_8CC # TH_8CC | TH_4CC | TH_2CC dut_interface = SOC # SOC
IOCHANNEL :HW = PS3600, speed = 800 Mbps, smem = 2M, vmem = 54M, tim = w256-d8-r8, diff, ppTIA where:
HW = PP400 (E7945E); PS800 (E7945A); PS3600 (E8010A); HSM3600/-2200 (E8610A/-20A);
speed: settings in Mbps (starting on Jan. 1st 2006) [older settings were also in MHz, but mixing with Mbps and MHz is not allowed]
smem: 2M (compatibility mode with Ce/P), > 2M Pin Scale unified memory mode
vmem: up to 54M (comp. mode with Ce/P), =0 when in Pin Scale unified memory mode
tim: e.g. w32-d8-r6, 32 waveforms, 8 drv edges and 6 rcv edges defined. Must be same for all channels.
smem can also be set to >2M which switches the software to the so called unified memory mode. This mode is only available with the new double density system. When smem is >2M the vmem is set to 0M and does not need to be set. Smem can be set to a maximum of 56M (physical memory installed per channel). The reason is that with the double density system every channel has 56M of RDRAM so there is no longer a dedicated sequencer memory and vector memory. So the following line is an example for double density: : HW = PS3600, speed = 450MHz, smem=56M, tim = w256-d8-r8 HW table, what speed is allowed for what hardware: HW =PP400 HW = PS800 HW = PS MHz Available Available Available 25MHz Available Available Available 50MHz Available Available Available 83MHz Available 100MHz Available Available Available 166MHz Available Available Available 200MHz Available Available Available 250MHz Available 300MHz - Available Available 400MHz - Available MHz Available 1700Mbps Mbps Available 2500Mbps Mbps Available 3200Mdps Available The waveform section only allows some pre defined values: Tim waveforms DRV edges RCV edges w8-d2-r w16-d4-r w32-d8-r w256-d8-r The w32-d8-r6 is the compatibility mode or single density mode.
The w256-d8-r8 is the double density mode that enables all possible resources available.
09 - FlexLM Licensing

10. Report Window Message
The section below lists the installed HW and their maximum capabilities. This section is always shown first and gives an overview about the system config:
MAXIMUM POSSIBLE CONFIGURATION BASED ON THE DETECTED HW:
| | | Vectors | Wave- | Edges | Channel | HW | Speed | SMEM | VMEM | forms | DRV | RCV | misc
| PS3600 | Mbps | 2M | 54M | | 8 | 8 | diff, ppTIA
The next section below lists the requested HW as defined in the model file:
REQUESTED CONFIGURATION:
| | | Vectors | Wave- | Edges | Channel | HW | Speed | SMEM | VMEM | forms | DRV | RCV | misc |PS3600 | Mbps | 2M | 14M | | 8 | 8 | diff |PS3600 | Mbps | 2M | 7M | | 8 | 8 | diff
If no error message follows, all licenses have been successfully checked out. The system is ready to use with the requested HW capability.
09 - FlexLM Licensing

11. Report Window Errors Two error scenarios are possible:
Requested configuration does not match the installed HW
Not enough licenses are available for the requested configuration
In the REQUESTED CONFIGURATION section the lines marked with a * show a mismatch between installed and requested HW. When an error happens, the last configuration table always shows which HW configuration is really available:
REQUESTED CONFIGURATION:
| | | Vectors | Wave- | Edges | Channel | HW | Speed | SMEM | VMEM | forms | DRV | RCV | misc |PS3600| Mbps | 2M | 54M | | 8 | 8 | diff * |PS3600| Mbps | 2M | 54M | | 8 | 8 | diff
ERROR: : No HW found: PS HW requested ERROR: Requested capability is not compatible with installed HW
| | | Vectors | Wave- | Edges | Channel | HW | Speed | SMEM | VMEM | forms | DRV | RCV | misc |PS3600| Mbps | 2M | 54M | | 8 | 8 | diff
09 - FlexLM Licensing

12. Report Window Errors
When no or not enough licenses can
be checked out you will see this:
REQUESTED CONFIGURATION:
| | | Vectors | Wave- | Edges | Channel | HW | Speed | SMEM | VMEM | forms | DRV | RCV | misc |PS3600| Mbps | 2M | 54M | | 8 | 8 |
ERROR: Error checking out Digital Channel licenses
License type | Required | Acquired | Missing Digital_E8010_Mem_0_8MB | | | Digital_E8010_Mem_8_16MB | | | Digital_E8010_Mem_16_32MB | | | Digital_E8010_Mem_32_64MB | | | Digital_E8010_Base_0_12MHz | | | Digital_E8010_Base_12_25MHz | | | Digital_E8010_Base_25_50MHz | | | Digital_E8010_Base_50_100MHz | | | Digital_E8010_Base_100_166MHz | | | Digital_E8010_Base_166_200MHz | | | Digital_E8010_Base_200_300MHz | | | Digital_E8010_Base_300_450MHz | | | Digital_E8010_A_0_1800Mbps | | | Digital_E8010_A_1800_2700Mbps | | | Digital_E8010_A_2700_3200Mbps | | | Digital_E8010_WF_0_ | | | Digital_E8010_WF_8_ | | | Digital_E8010_WF_16_ | | | | | | Vectors | Wave- | Edges | Channel | HW | Speed | SMEM | VMEM | forms | DRV | RCV | misc |PS3600| 0 Mbps | 280k | 4k | | 2 | 0 |
Additional pop-up window is shown when licenses couldn‘t be checked out!
The first section again shows the requested configuration. The next table shows the requested licenses, how many would have been required to fulfill the requested configuration in the model file, how many SmarTest was able to acquire and how many are missing.
The last configuration table again shows the final HW configuration available to the user. Since no licenses were available in this case the HW is started in the minimum configuration.
09 - FlexLM Licensing

13. Report Window Errors
This example shows the model file is setup incorrectly, sample a, for the licenses a customer
has bought. This leads to check out errors in the UI Report Window. A correction in the model file,
sample b, will clean up these errors.
(sample a)
IOCHANNEL
:HW = PS800, speed = 800 Mbps, smem = 2M, vmem = 54M, tim = w256-d8-r8,diff, ppTIA
(sample b)
:HW = PS800, speed = 200 Mbps, smem = 2M, vmem = 28M, tim = w256-d8-r8,diff
09 - FlexLM Licensing

14. Report Window Errors
Connection error is a global failure. Two examples which lead to this message:
Base license on local server expired.
Conflict between issued licenses and emergency license which had not expired.
09 - FlexLM Licensing

15. Failure Cases and Recovery
Impact on Test System
Recovery
FLEXlm License Server crash
Systems that get their licenses from this server stop once they change device, reboot, calibrate, run diagnostic. Otherwise the testers keep running
If Harddisk failure, repair Harddisk, install SW and existing licenses. If Motherboard failure. Use ELF process via WEB to obtain 10 days license. Within 10 days obtain ReHosted licenses from Verigy Support.
Test Floor Network down
For long time Network outage:
Use Elf process on a network outside the test floor (Internet Café) to obtain local licenses for each tester computer. (gives 10 days access)
FLEXlm License Server Crash and Test Floor Network down
Use ELF process on a Network outside Test Floor (e.g. Internet Cafe) and obtain license. Use floppy disk, Flash card, any removable media, or print out license key and type in on test floor computers.
FLEXlm License Server Crash and Verigy Server (ELF) down
No recovery until Verigy server is up again.
(probablility of both failures occuring simultaneously estimated at ~0.001)
09 - FlexLM Licensing

16. Troubleshooting
Summary of commands related to license server or client:
Start licence server with the license files located in /opt/flexlm/license and the debug log file defined to be located in /opt/flexlm/log: /opt/flexlm/bin/lmgrd -c /opt/flexlm/license -l /opt/flexlm/log
Stop license server: /opt/flexlm/bin/lmutil lmdown -vendor socbu –q
Re-read all license files located in /opt/flexlm/license and make them available for use: /opt/flexlm/bin/lmutil lmreread -c /opt/flexlm/license
Location of debug log file: /opt/flexlm/log
Reads out status of license server and lists up the allocated licenses of the different testers: /opt/flexlm/lmutil lmstat -a
09 - FlexLM Licensing

17. License Renewel
Licensing rights for V93000 cards are purchased on a permanent basis, but nevertheless you must redeem your licenses on an annual basis.
All permanent licenses are delivered with an expiration date of 31, January of the following year.
During the month of January of the year after your first license redemption, you will need to repeat the license redemption process for your licenses on 1 January, or any day after 1 January, of each subsequent year.
Since all V93000 System licenses expire at the same time, regardless of when they were purchased and redeemed you can renew all licenses (acquired in different purchase orders) during the same web session.
Renewable licenses are there to protect Verigy of misuse of license files after a rehosting was done. It also enables any customer to sell or move tester from one place to the other.
09 - FlexLM Licensing

18. Emergency Licensing Facility (ELF)
In case of problems:
license server down (eg. defective HDD; defective PC mother board)
or network connection problems
There is a possibility to request Emergency Licenses for the installed systems.
New Link for Emergency License:
SW & HW emergency licenses (no change -just like before)
SW ELF – no change
09 - FlexLM Licensing

19. Emergency Licensing Facility (ELF)
New Link for Emergency License:
HW ELF - enter Entitlement ID after Support Area Login:
09 - FlexLM Licensing