Verigy V93000 Service Training Module 9: FlexLM Licensing

Verigy V93000Service Training

Module 9:FlexLM Licensing

09 - FlexLM LicensingPage 2

Verigy Restricted

• 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)

Licensing Feature for HW Capabilities


Verigy Restricted

8 to 16MV memory license

50M to 100MHz speed upgrade

FLEXlm License File



50M to 100MHz speed upgrade0 to 12MHz

speed license

50M to 100MHz speed upgrade12 to 25MHz

speed license




0 to 8MVmemory licenseFLEXlm License Server

• Supported Computer Operating Systems:

• Linux Redhat Enterprise 3 or newer• HP-UX 10.20 or newer• Solaris 7 or newer

• 3 Programs (executables):• socbu (868Kb) *• lmgrd (536Kb) *• lmutil (567Kb)

• Programs (all 3) available at • http://www.verigy.com/

* Red bullets indicate required files.*

A computer with (at least) two* FLEXlm executables… ...to manage license sharing over a client/server network

What is a FlexLM License Server?


Verigy Restricted

• Simple to administer – no LAN or 2nd computer needed• Easy to move tester with licenses (anywhere)

Tester A

FlexLM License Local Server


Verigy Restricted

Tester A Tester B Tester C Tester D

check out check inLAN (or WAN)

FLEXlm License 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 Remote Server


Verigy Restricted

A collection of FLEXlm license strings

Actual lines have been truncated for slide clarity.

**

Host ID (unique in the world)

Right-to-Use License Quantity (pins)More than 6000 licenses are in this file!File size approx 3 kbytes

License server hostname (should include domain – preferred: IP-address)

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

**

***

***

*

# Comment line – License File for 24 PIN SCALE 800 Cards with base capabilitySERVER mucagl11 001185ae94f3

VENDOR socbu

INCREMENT Digital_E7945_0_50Mbps socbu 1.0 31-jan-2007 768 VENDOR_STRING=



INCREMENT Digital_E7945_WF_0_8 socbu 1.0 31-jan-2007 768 VENDOR_STRING=



INCREMENT Digital_E7945_DIFF socbu 1.0 31-jan-2007 384 VENDOR_STRING=

INCREMENT Digital_Shared_Mem_0_8MB socbu 1.0 31-jan-2007 768 VENDOR_STRING=


INCREMENT DC_E9711_CH_4_8 socbu 1.0 31-jan-2007 8 VENDOR_STRING=

What is a FlexLM License?


Verigy Restricted

INCREMENT Digital_E7945_Base_0_50Mbps socbu 1.0 31-January-2007 320 \ VENDOR_STRING="1680247.ou-5413" SIGN="0592 4113 F65A 39CF 20D1 349B"

ASCII text – Easy to email, 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).

FLEXlmKeyword

PINSCALE800 Card Feature

Vendor Daemon

LicenseVersion

ExpirationDate

License Count (pins)

Digital Signature (encryption key)

ContinuationCharacter

Customer’s Order Number

A character string adhering to FLEXlm syntax

What is a FlexLM License?


Verigy Restricted

1. SmarTest is started in online mode and reads model file, which tells what HW licenses are needed.

2. 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_50MbpsDigital_E8010_Std_50_100MbpsDigital_E8010_Std_100_200MbpsDigital_E8010_Std_200_400MbpsDigital_E8010_Std_400_660MbpsDigital_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.

3. 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.

4. When SmarTest quits it will check-in the checked-out licenses and the licenses are again available for other testers.

FlexLM License Server Process


Verigy Restricted

For details see Pin Scale Digital / Memory Test Card User’s Guide (E8000-91010/E8600-91007).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

10101-10216: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.

FlexLM Model File Entry


Verigy Restricted

MAXIMUM POSSIBLE CONFIGURATION BASED ON THE DETECTED HW:

| | | Vectors | Wave- | Edges | Channel | HW | Speed | SMEM | VMEM | forms | DRV | RCV | misc------------+--------+------------+------+------+-------+-----+-----+------------

10101-10816 | PS3600 | 3600 Mbps | 2M | 54M | 256 | 8 | 8 | diff, ppTIA

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:

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-------------+-------+------------+------+------+-------+-----+-----+------------ 10101-10616 |PS3600 | 3600 Mbps | 2M | 14M | 256 | 8 | 8 | diff 10701-10816 |PS3600 | 800 Mbps | 2M | 7M | 256 | 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.

Report Window Message


Verigy Restricted

Two error scenarios are possible:• Requested configuration does not match the installed HW• Not enough licenses are available for the requested configuration

1. 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:


| | | Vectors | Wave- | Edges | Channel | HW | Speed | SMEM | VMEM | forms | DRV | RCV | misc-------------+------+-------------+------+------+-------+-----+-----+------------- 10101-10816 |PS3600| 3600 Mbps | 2M | 54M | 256 | 8 | 8 | diff*10901-11016 |PS3600| 3600 Mbps | 2M | 54M | 256 | 8 | 8 | diff

ERROR: 10901-11016 : No HW found: PS HW requestedERROR: Requested capability is not compatible with installed HW

| | | Vectors | Wave- | Edges | Channel | HW | Speed | SMEM | VMEM | forms | DRV | RCV | misc-------------+------+-------------+------+------+-------+-----+-----+------------ 10101-10816 |PS3600| 3600 Mbps | 2M | 54M | 256 | 8 | 8 | diff

Report Window Errors


Verigy Restricted

2. When no or not enough licenses canbe checked out you will see this:


| | | Vectors | Wave- | Edges | Channel | HW | Speed | SMEM | VMEM | forms | DRV | RCV | misc-------------+------+-------------+------+------+-------+-----+-----+----------- 10101-10816 |PS3600| 3600 Mbps | 2M | 54M | 256 | 8 | 8 |

ERROR: Error checking out Digital Channel licenses

License type | Required | Acquired | Missing --------------------------------+----------+-----------+----------- Digital_E8010_Mem_0_8MB | 124 | 0 | 124 Digital_E8010_Mem_8_16MB | 124 | 0 | 124 Digital_E8010_Mem_16_32MB | 124 | 0 | 124 Digital_E8010_Mem_32_64MB | 124 | 0 | 124 Digital_E8010_Base_0_12MHz | 124 | 0 | 124 Digital_E8010_Base_12_25MHz | 124 | 0 | 124 Digital_E8010_Base_25_50MHz | 124 | 0 | 124 Digital_E8010_Base_50_100MHz | 124 | 0 | 124 Digital_E8010_Base_100_166MHz | 124 | 0 | 124 Digital_E8010_Base_166_200MHz | 124 | 0 | 124 Digital_E8010_Base_200_300MHz | 124 | 0 | 124 Digital_E8010_Base_300_450MHz | 124 | 0 | 124 Digital_E8010_A_0_1800Mbps | 124 | 0 | 124 Digital_E8010_A_1800_2700Mbps | 124 | 0 | 124 Digital_E8010_A_2700_3200Mbps | 124 | 0 | 124 Digital_E8010_WF_0_8 | 124 | 0 | 124 Digital_E8010_WF_8_16 | 124 | 0 | 124 Digital_E8010_WF_16_32 | 124 | 0 | 124

| | | Vectors | Wave- | Edges | Channel | HW | Speed | SMEM | VMEM | forms | DRV | RCV | misc-------------+------+------------+------+------+-------+-----+-----+------------ 10101-10816 |PS3600| 0 Mbps | 280k | 4k | 0 | 2 | 0 |

Additional pop-up window is shown when licenses couldn‘t be checked out!



Verigy Restricted

This example shows the model file is setup incorrectly, sample a, for the licenses a customerhas 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 10101-20416:HW = PS800, speed = 800 Mbps, smem = 2M, vmem = 54M, tim = w256-d8-r8,diff, ppTIA

(sample b)IOCHANNEL 10101-20416:HW = PS800, speed = 200 Mbps, smem = 2M, vmem = 28M, tim = w256-d8-r8,diff



Verigy Restricted

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.



Verigy Restricted

Failure Case 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 Systems that get their licenses from this server stop once they change


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)

Failure Cases and Recovery


Verigy Restricted

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

Troubleshooting


Verigy Restricted

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.

License Renewel


Verigy Restricted

• 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:

www.verigy.com/go/smartest_temporary_license

• SW & HW emergency licenses (no change -just like before)• SW ELF – no change

Emergency Licensing Facility (ELF)


Verigy Restricted

• New Link for Emergency License:www.verigy.com/go/smartest_temporary_license

• HW ELF - enter Entitlement ID after Support Area Login:

Emergency Licensing Facility (ELF)

Documents

Verigy V93000 Service Training Module 9: FlexLM Licensing