FLEXNET OPERATIONS SOAP WEB SERVICES GUIDE |
FlexNet Operations Web Services Guide |
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
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: ... 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_.
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:
|