TOCPREVNEXTINDEX


Appendix A

Hostids for FLEXlm-Supported Machines


FLEXlm uses different machine identifications for different machine architectures. For example, all Sun Microsystems machines have a unique hostid, whereas all DEC machines do not. For this reason, the ethernet address is used on some machine architectures as the hostid. An ethernet address is a 6-byte quantity, with each byte specified as two hexadecimal digits. Specify all twelve hex digits when using an ethernet address as a hostid. For example, if the ethernet address is “8:0:20:0:5:ac,” specify “0800200005ac” as the hostid.

A.1 Hostid Formats

Numeric, 32-bit hostids are normally used in hexadecimal format. On some systems, the system command returns the ID in decimal format. Use a “#” before the hostid to indicate a decimal number. For example, if the system command returns “2005771344,” FLEXlm accepts “#2005771344.” Alternatively, convert the decimal value to hexadecimal.

A.2 Expected FLEXlm Hostids

The lmhostid utility prints the exact hostid that FLEXlm expects to use on any given machine. The following table lists alternate methods to obtain the required hostid for each machine architecture. FLEXlm also supports a group of special hostids and vendor-defined hostids.

Hardware Platform
Hostid
Type this command on the license server:
Example
AIX (RS/6000, PPC)
32-bit hostid
uname -m (returns 000276513100), then remove last two digits, and use remaining last eight digits
02765131
DEC Alpha
ethernet address
netstat -i
080020005532
HP
(32-bit and
64-bit
platforms,
non-Itanium)
32-bit hostid
uname -i and convert to hex, or prepend with #
778DA450 or #2005771344
HP
(64-bit
Itanium
machine
identification
getconf \
CS_PARTITION_
IDENT then prefix with “ID_STRING=”
ID_STRING=9c766319-db72-d411-af62-0060b05e4c05
Linux
ethernet address
/sbin/ifconfig eth0 and remove colons from HWaddr 00:40:05:16:E5:25
00400516E525
SCO
Hostid String
uname -x (Serial is SCO00354), then prefix with “ID_STRING=”
ID_STRING=SCO00354
SGI
32-bit hostid
/etc/sysinfo -s, convert to hex, or prefix #
69064C3C or #1762020412
SUN
32-bit hostid
hostid
170a3472
Windows
ethernet address
lmutil lmhostid
00B0A9DF9A32
Disk serial number
DIR C: (look for “Volume Serial Number is”, and remove “-”)
DISK_SERIAL_NUM=
3e2e17fd
FLEXid parallel or USB port hardware key (dongle)
lmhostid -flexid
FLEXID=7-b28520b9
FLEXids are made available by your vendor. Your vendor can also provide you with an installer that installs drivers for all FLEXids.
 

A.3 Special FLEXlm Hostids

FLEXlm contains a number of special hostid types which apply to all platforms. These hostid types are valid to use in both SERVER lines and FEATURE lines, wherever a hostid is required. These are:

ANY
Locks the software to any machine (i.e., does not lock anything).
DEMO
Similar to ANY, but only for use with uncounted FEATURE lines.
COMPOSITE=
composit_hostid
Locks the software to a composite hostid. A composite hostid is a hashed 12-character hexidecimal value formed by combining the values of one or more simple hostids types, as defined by the software vendor..
DISPLAY=display
Locks the software to display display. On UNIX, display is /dev/ttyxx (which is always /dev/tty when an application is run in the background) or the X-Display name. On Windows, it is the system name or, in the case of a terminal server environment, the terminal server client name. (v8+ licensed applications only)
HOSTNAME=host
Locks the software to computer host name host.
ID=n
Functionally equivalent to the “ANY” hostid—it runs on any machine. The difference is that the license is unique and is used to identify the customer. This hostid is used to lock the license server (on the SERVER line) or the licensed application (on the FEATURE/INCREMENT line). The number can have dashes included for readability—the dashes are ignored.
Examples:
ID=12345678 is the same as
ID=1234-5678 is the same as
ID=1-2-3-4-5-6-7-8
INTERNET=
###.###.###.###
Locks the software to an Internet IP address, or group of IP addresses. Wildcards are allowed. For example, 198.156.*.* means any host with a matching internet IP address. The main use is to limit usage access by subnet, implying geographic area. For this purpose, it is used on the FEATURE/INCREMENT line as a hostid lock.
USER=user
Locks the software to user name user.

Examples

FEATURE f1 demo 1.0 1-jan-2005 uncounted \
        HOSTID=FLEXID=6-a6300015f SIGN=AB28E0011DA1

or

FEATURE f1 demo 1.0 1-jan-2005 uncounted \
        HOSTID=INTERNET=10.10.10.* SIGN=EB78201163B0


TOCPREVNEXTINDEX

 

FLEXlm End Users Guide
March 2003