Table of ContentsPreviousNextIndex


Hostids for FLEXnet Licensing-Supported Platforms

Appendix A


FLEXnet Licensing 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.

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," FLEXnet Licensing accepts "#2005771344." Alternatively, convert the decimal value to hexadecimal.

FLEXnet Licensing Hostids

The lmhostid utility prints the exact hostid that FLEXnet Licensing expects to use on any given machine. If your hostid contains characters other than ASCII A through Z, a through z, or 0 through 9, use the -utf8 option with lmhostid. To view a correct representation of the resulting hostid, use a utility, such as Notepad, that can display UTF-8 encoded strings.

The following table lists alternate methods to obtain the required hostid for each machine architecture. FLEXnet Licensing also supports a group of special hostids and vendor-defined hostids.

Hardware Platform
Hostid
Type this command on the license server system:
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
Mac OS X
ethernet address
/sbin/ifconfig eth0 and remove colons from ether value
000A277EA17E
FLEXid USB port dongle
lmhostid -flexid
FLEXID=9-b28520b9
Linux
ethernet address
/sbin/ifconfig eth0 and remove colons from HWaddr
00400516E525
FLEXid USB port dongle
lmhostid -flexid
FLEXID=9-b28520b9
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
ethernet address
lmhostid -ether
00400516E525
Windows
ethernet address
lmhostid
00B0A9DF9A32
Disk serial number
DIR C: (look for "Volume Serial Number is", and remove "-")
DISK_SERIAL_NUM=
3e2e17fd
FLEXid parallel or USB port dongle
lmhostid -flexid
FLEXID=8-b28520b9
FLEXids are made available by your vendor. Your vendor can also provide you with an installer that installs drivers for all FLEXids.
For parallel FLEXids, the parallel port must be configured in bi-directional mode.

Special FLEXnet Licensing Hostids

FLEXnet Licensing 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+ FLEXenabled 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 end user. This hostid is used to lock the license server system (on the SERVER line) or the FLEXenabled 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


 

Table of ContentsPreviousNextIndex
FLEXnet Licensing End User Guide
Version 10.8
July 2005
copyright