i4tv(1M)

NAME

i4tv — verify that LicensePower/iFOR License Servers are working

SYNOPSIS

i4tv [-n hostname | -z | -v] [-h | -usage | -version]

DESCRIPTION

The i4tv tool can be used after the license servers have been started to verify that that they are running properly. The i4tv program resides in the /opt/ifor/ls/bin directory. A message describing a completed license transaction and a list of all license servers will be displayed. Once a license server has been configured using i4config, the i4tv tool is used to quickly verify the status of the license server i4lmd.

Options

-n hostname: The -n option is used to check that the specified machine is running a license server. It returns 0 if the hostname is running i4lmd and it returns 1 if the hostname is not running i4lmd.
-z: The -z option turns on RPC tracing messages, which can be used to diagnose problems.
-v: Displays progress messages during the license request operation.
-h: Displays command usage information (same as -usage).
-usage: Displays command usage information (same as -h).
-version: Displays command version information.

If you can run i4tv successfully but are still having a problem with a licensed product, the problem is probably with the licenses, or possibly with the product itself: in this case, talk to the vendor of the licensed software product.

If you can not run i4tv successfully or it takes more than 10 seconds to retrieve a license, verify that glbd and i4lmd are running. Use the utility lb_admin to clean the database. Answer YES to all database entries that do not respond. If you receive one of the error messages listed below, use the explanation of the error to fix the problem. Then try running i4tv again.

If you can not run i4tv successfully and receive an error that's not listed below, it means there is a problem with the software on which LicensePower/iFOR ARK is layered (for example, TCP), or a hardware problem.

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

ERROR MESSAGES

netls_no_svrs_found: No license servers are running or someone has deleted the LicensePower/iFOR Test Vendor from the license servers.
netls_license_not_found: Someone has deleted the Test Vendor licenses that each server automatically installs the first time that it starts. This prohibits anyone from using the test and verification tool (i4tv).
netls_not_authorized: Someone has edited the user file to restrict the use of i4tv.
netls_bad_timestamp: System clocks have not been synchronized to within 12 hours.

EXAMPLES

Run the i4tv test and verification tool:

i4tv

i4TV Version 4.0 -- LicensePower/iFOR Test and Verification Tool
A product of Isogon Corporation
Completed license transaction on node 3541b8 running LicensePower/iFOR 4.0
Active LicensePower/iFOR Servers:
   hp_snake.gradient.com (HP-UX) running LicensePower/iFOR Version 3.0.0

Check for the presence of the license server hp1030:

i4tv -n hp1030

A product of Isogon Corporation
hp1030 running

AUTHOR

i4tv is a product of Isogon Corporation.

FILES

/opt/ifor/ls/bin/i4tv
/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)

i4tv(1M)

Technical documentation

» Table of Contents

» Index