i4target(1M)

NAME

i4target — returns the local LicensePower/iFOR 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 LicensePower/iFOR for locking licenses to a particular system.

To create LicensePower/iFOR licenses for an application, an application supplier will need the target ID of the machine where the LicensePower/iFOR licenses will be installed. The target ID tool (i4target) should be run on the machine where you want to identify a LicensePower/iFOR 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 a LicensePower/iFOR 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 LicensePower/iFOR 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 LicensePower/iFOR ID of the machine on which it is executing.

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

The LAN card accessed by /dev/i4target, or
The built in SPU ID number, or
An HIL ID Module.

A printable on-line administration guide is also available. (See the FILES section below.)

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 LicensePower/iFOR 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 LicensePower/iFOR 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 LicensePower/iFOR 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 is a product of Isogon Corporation.

FILES

/opt/ifor/ls/bin/i4target
/opt/ifor/ls/doc/i4admin.pdf: LicensePower/iFOR Administrator's Guide (Adobe Acrobat format)
/opt/ifor/ls/doc/i4admin.ps: LicensePower/iFOR Administrator's Guide (postscript format)