FLEXNET OPERATIONS SOAP WEB SERVICES GUIDE

FlexNet Operations Web Services Guide

Appendix E: Supported Hostid Types

The following supported FlexNet Publisher host ID types can be differentiated by the Vendor Certificate Generator (VCG):

Hostid Type  Description 
ANY
Special FlexNet Publisher Licensing Toolkit host ID ANY. Allows the license to run on any machine.
DEMO
Special FlexNet Publisher Licensing Toolkit host ID DEMO: Can be used only for node-locked licenses, never for Server host IDs. Allows the license to run on any machine.
Ethernet
Ethernet address and also called MAC address. This is the hardware address from the Network Interface Card (NIC). This value consists of 12 hexadecimal digits (a 48-bit number).
TPM ID
The Trusted Platform Module host ID adds an additional layer of security for Windows platform certificate based licensing to minimize software piracy. This feature is available with VCG kit 16.2.2.0. The length of the TPM ID should be in the following format: xxxxx-xxxxx-xxxxx-xxxxx (4 sequences of 5 characters and 3 hyphens for a total of 23 characters). Can be used in conjunction with other host ID types in case of redundant servers.
Long
Used only with Solaris machines. It is the Solaris 32-bit hardware machine ID. This value consists of 8 hexadecimal digits (a 32-bit number).
User
User name: Enter as USER=user_name. The FlexNet C/C++ Licensing toolkit uses the login name. FlexNet Publisher Licensing Toolkit for Java uses the username environment variable.
Host Name
This can a simple host name or a fully qualified DNS name. Host name: Enter as HOSTNAME=host_name.
Display
On Unix, this is the X display name. On Windows, it is the display adapter. Display name: Enter as DISPLAY=display_name.
Routable IP Address

This setting allows you to define the host ID as a routable, public IP addresses. Use the format, INTERNET=w.x.y.z, where each letter represents an octet with a decimal value between 0 and 255.

FlexNet Operations validates that the address is not among the private, non-routable sets. The routable address cannot be an address in the primary three reserved, private network address ranges: 10.0.0.0-10.255.255.255, 172.16.0.0-172.31.255.255, and 192.168.0.0-192.168.255.255. In addition, the address cannot be 127.0.0.1 (localhost).

Note: FlexNet Operations’s IP address validation can be disabled in the Administrative Console’s system configuration settings and in the VCG.

Routable IP Address with Wildcards

This setting allows you to define the host ID as a routable, public IP addresses with a wildcard (*) as one or more octets. Use the format, INTERNET=w.x.y.z, where each letter represents an octet with a decimal value between 0 and 255.

FlexNet Operations validates that the address is not among the private, non-routable sets. The routable address cannot be an address in the primary three reserved, private network address ranges: 10.0.0.0-10.255.255.255, 172.16.0.0-172.31.255.255, and 192.168.0.0-192.168.255.255. In addition, the address cannot be 127.0.0.1 (localhost).

The wildcard rules for routable IP addresses also apply. For an IP address of w.x.y.z

  • If w is less than or equal to 127, then x, y, and z can be wildcards.

  • If w is between 127 and 192, then only y and z can be wildcards.

  • If w is greater than or equal to 192, then only z can be a wildcard.

Note: FlexNet Operations’s IP address validation can be disabled in the Administrative Console’s system configuration settings and in the VCG.

FLEXid

This is for Windows, Mac, Linux only. Locks the software to a PC with a hardware dongle (hardware key) with serial number id_string. The format of this identifier depends on the brand of dongle used.

Enter as FLEXID=id_string.

Composite

A composite host ID combines multiple FlexNet Publisher Licensing Toolkit host IDs together to provide a more secure host ID. For instance, you can use USER and Disk SN to identify a host ID. A composite host ID is a hashed 12-character hexadecimal value formed by combining the values of multiple simple host IDs types.

If you select the Composite format, you must provide your end user with a program to calculate the Composite host ID for the host machine. Enter as COMPOSITE=comp_id. For more information about using Composite host IDs, see the FlexNet Publisher Licensing Toolkit Toolkit documentation.

Vendor Defined

Pass the vendor-defined host as VENDOR_DEFINED=<vendor_defined_hostid>, where <vendor_defined_hostid> is formed as <name>=<string>. Hence a vendor defined hostid takes the form of VENDOR_DEFINED=<name>=<string>.

For example, where TWVDH=2 is the vendor defined hostid as it would appear in a license file, in the web service request you must pass

VENDOR_DEFINED=TWVDH=2

A vendor-defined hostid is returned the same way in a query response:

...
   <nodeIds>
      <nodeId>VENDOR_DEFINED=TWVDH=2</nodeId>
   </nodeIds>
...

Note: If you specify a vendor-defined host ID, you must build your VCG to support your vendor-defined host ID type.

Note: You can use a completely new entity to validate the host. The host ID for this entity is defined in Operations as <name>=<string>, where <name> is the entity name you want to use. You must define a list of allowable name values in the VCG. You must also create the code in the application or vendor daemon that obtains the string value.

Virtualization-Aware

Virtualization-aware host ID prefixes define server host ID types that permit or restrict the kind of virtual environments, if any, on which a license server can run. These new host ID types begin with PHY_, VM_, VMW_, HPV_, or LMB_.

  • Use the PHY_ prefix with ETHER, INTERNET, HOSTNAME, DISPLAY, USER, DISK_SERIAL_NUMBER, or FLEXID to restrict license operation to physical machines.

  • Use the VM_ prefix with UUID to restrict license server operation to any supported virtual environments: Xen, Hyper-V, and VMWare. VM_UUID supersedes VMW_UUID and HPV_UUID.

  • Use the VMW_ prefix with UUID, ETHER, INTERNET, and HOSTNAME to restrict license server operation to VMWare Workstation and ESX Server virtualizations. VMW_UUID is still supported, but has been superseded by VM_UUID.

  • Use the HPV_ prefix with UUID, ETHER, INTERNET, HOSTNAME, and VSN to restrict license server operation to Microsoft Hyper-V virtualizations. HPV_UUID is still supported, but has been superseded by VM_UUID.

  • Use the LMB_ prefix with ETHER, INTERNET, HOSTNAME, or FLEXID (9 or 10) to permit license server operation with bare metal binding. This permits operation in a virtualization but binds the license to the physical host machine.

Note: VMW_HOSTNAME, HPV_HOSTNAME, and LMB_HOSTNAME host IDs cannot contain wildcards (asterisks).

Note: When used with three-server redundancy, virtualization-aware host ID types for all servers in the triad must use the same prefix: PHY_, VW_, VMW_, HPV_, or LMB_.

Cloud-Specific

Cloud-specific hostid types permit the kinds of cloud-hosted environments, if any, in which the product can operate. There are two server hostid type options and two nodelocked hostid type options:

  • AMZN Routable EIP Address and AMZN Routable EIP Address with Wildcards—The AMZN_EIP hostid types permit license server operation in Amazon EC2 (public cloud) environments with binding to an elastic IP address. Routable and Routable with Wildcard addresses are supported. Non-routable addresses are not supported. This hostid type cannot be used with three-server redundancy.

  • AMZN AMI Template ID and AMZN IID Instance ID—The AMZN_AMI and AMZN_IID hostid types permit nodelocked licensing in Amazon EC2 environments with binding to the AMI template ID or AMI instance ID, respectively. Template ID binding is typically used in virtual appliance scenarios. Instance ID binding supports more generic cloud-based usage such as running software in the public cloud or in a virtual private cloud.