Obtaining a License File

License features are provided by TIBCO Software Inc. to customers when OpenSpirit software is purchased. License features are delivered as a zipped text file attachment to an e-mail. The name and identification number of the host computer that are used to run the license service must be provided to the TIBCO OpenSpirit license administrator when requesting your license file. The Installing the License Service section below describes how the license file is installed into the license service.

The identification number of the host that is used to run the license service is called a hostid. A hostid is represented by an eight to twelve-digit hexadecimal number.

Linux Hostid

The simplest way to determine a Linux computer's hostid is to use the lmhostid command-line utility that is provided with the OpenSpirit license service. The utility is located in the Linux_i386 subdirectory of a Linux license service installation.

Following is an example of running the lmhostid command. The quoted number shown in bold is the hostid that should be provided when requesting your OpenSpirit license file.

./lmhostid
lmhostid - Copyright (c) 1989-2007 Macrovision Europe Ltd. and/or Macrovision Corporation. All Rights Reserved.
The FLEXnet host ID of this machine is "0018fe878b66"

Windows Hostid

Obtaining the hostid on Windows hosts can be more involved. A command-line executable named lmhostid.exe is provided in the WIndows_x86 folder of a Windows license service installation. However, it is common for the command to return several hostids. Hostids are sometimes returned for network adapters that are not always enabled such as a WIFI network adapter or a VPN connection. It is better to provide the output from the ipconfig command than from the lmhostid.exe.

Following is an example of running the ipconfig /all command from a Windows command window.

C:\>ipconfig /all 
Windows IP Configuration Host Name . . . . . . . . . . . . : win-host
Primary Dns Suffix . . . . . . . : tibco.com
Node Type . . . . . . . . . . . . : Hybrid IP Routing Enabled. . . . . . . . : No WINS Proxy Enabled. . . . . . . . : No DNS Suffix Search List. . . . . . : tibco.com
Ethernet adapter Local Area Connection* 9: Media State . . . . . . . . . . . : Media disconnected
Connection-specific DNS Suffix . : Description . . . . . . . . . . . : Juniper Network Connect Virtual Adapter Physical Address. . . . . . . . . : 00-FA-B0-3B-67-0A DHCP Enabled. . . . . . . . . . . : Yes
Autoconfiguration Enabled . . . . : Yes
Ethernet adapter Local Area Connection:
Connection-specific DNS Suffix . : tibco.com
Description . . . . . . . . . . . : Broadcom NetXtreme 57xx Gigabit Controller
Physical Address. . . . . . . . . : 00-23-E7-3E-AF-5B DHCP Enabled. . . . . . . . . . . : Yes
Autoconfiguration Enabled . . . . : Yes Link-local IPv6 Address . . . . . : fe80::30eb:10b6:e27:4ded%10(Preferred)
IPv4 Address. . . . . . . . . . . : 192.164.20.52(Preferred) Subnet Mask . . . . . . . . . . . : 255.255.255.0 Lease Obtained. . . . . . . . . . : Wednesday, January 25, 2012 5:22:43 PM
Lease Expires . . . . . . . . . . : Thursday, February 02, 2012 5:22:43 PM
Default Gateway . . . . . . . . . : 192.164.20.1 DHCP Server . . . . . . . . . . . : 192.164.10.41 DHCPv6 IAID . . . . . . . . . . . : 234791472 DHCPv6 Client DUID. . . . . . . . : 00-01-03-01-12-55-A8-DB-00-34-E8-3E- AE-4B
DNS Servers . . . . . . . . . . . : 192.164.10.17, 192.164.10.19, 192.97.174.20, 192.106.136.20
NetBIOS over Tcpip. . . . . . . . : Enabled
Tunnel adapter isatap.openspirit.com: Media State . . . . . . . . . . . : Media disconnected
Connection-specific DNS Suffix . : tibco.com Description . . . . . . . . . . . : Microsoft ISATAP Adapter
Physical Address. . . . . . . . . : 00-00-00-00-00-00-00-E0 DHCP Enabled. . . . . . . . . . . : No Autoconfiguration Enabled . . . . : Yes

The physical address value is the information that is needed to determine the computer's hostid. Note that the /all option must be specified on the ipconfig command to display the physical address value. Also note that there may be several adapters, each having a physical address. Supply all of the output from the ipconfig command to TIBCO OpenSpirit support so they can select the best physical address to use for the hostid.