Hostids for FLEXlm-Supported Machines

> ## 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. 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. 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/tty` `xx` (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

FLEXlm End Users Guide
July 2003