i4target(1M) — iFOR/LS Version 3

NAME

i4target − Returns the local iFOR/LS target id.

SYNOPSIS

i4target

i4target [ −c ] [ −C ] [ −h ] [ −H ] [ −o ] [ −O ] [ −q ] [ −Q ] [ −v ] [ −V ]

DESCRIPTION

i4target is used to find the target ID that can be used by iFOR/LS for locking licenses to a particular system.

To create iFOR/LS licenses for an application, an application supplier will need the target ID of the machine where the iFOR/LS licenses will be installed. The target ID tool (i4target) should be run on the machine where you want to identify an iFOR/LS target ID. For server-based licensing, this will be the machine that is executing the license server (i4lmd) where you plan to install this application supplier’s licenses. For nodelocked licensing, this will be the system where the application will be executing.

The algorithm that is used to identify an iFOR/LS target ID may vary depending on operating system platform.

For example: On an HP-UX machine licenses managed by the i4lmd (concurrent and use once licenses), the iFOR/LS target ID is derived from the link level address of the LAN card accessed by the device file /dev/i4target on the machine that is running the i4lmd. If /dev/i4target does not exist and the super-user is executing i4target, i4target will create /dev/i4target. On an HP 9000 Series 700 or 800, the device file will be for the lan0 LAN card. This is the same method used by the i4lmd for determining the iFOR/LS ID of the machine on which it is executing.

On HP-UX, for iFOR/LS nodelocked licenses, the iFOR/LS ID is derived from:

• The LAN card accessed by /dev/i4target, or

• The built in SPU ID number, or

• An HIL ID Module.

Options

−c -C Change the permanent target ID value.

−h -H Help. Display a list of options.

−o -O Display operating system name.

−q -Q Display target ID in quiet mode (without headers).

−v -V Display a verbose list of the iFOR/LS target IDs from each possible source. The list consist of the link level address of the installed LAN cards. A super-user can then use the address to change to an alternate LAN card. This lets you change the IO slot where a LAN card is installed without losing the use of iFOR/LS licenses locked to that LAN card.

RETURN VALUE

i4target always returns 0.

DIAGNOSTICS

Messages displayed during execution are self-explanatory.

EXAMPLES

To find the current local iFOR/LS target ID(s):

i4target

Examples for each of the options are shown below:

i4target -c
or
i4target -C

Current Permanent Target ID: 3e53d0

1. Target ID value: 3e53d0
LAN card at logical unit 0

There is only one choice for the new Permanent Target ID.
Enter ’1’ to select it; enter any other character to abort: 1

New Permanent Target ID: 3e53d0

NOTE: i4lmd must be restarted for the new
Permanent Target ID to take effect.

i4target -h
or
i4target -H

Usage:
i4target [options]
        options are:
                -[vV] : verbose mode; detailed output
                -[qQ] : quiet mode; no headers in output
                -[cC] : change Permanent Target ID;
                -[hH] : displays this message
                -[oO] : displays os name

i4target -o
or
i4target -O

HP-UX

i4target -q
or
i4target -Q

3e53d0

i4target -v
or
i4target -V

Permanent Target ID: 3e53d0

SPU Target ID: 70328251

The Permanent Target ID is derived from a permanent hardware source
on the system from which the i4target program is executed.
This target ID may be used for all license types.

The SPU ID is derived from a hardware identification number on the
SPU. It is used as the Permanent Target ID when no higher-priority
sources for Permanent Target ID (i.e., LAN cards) are present.

AUTHOR

i4target was developed by HP and further enhanced for other platforms by Gradient.

Museum