i4admin [ - Standard X Arguments ]
i4admin -a [ -n server-name ] [ -f filename ]
[ -v "'vendor-name' [ vendor-id vendor-password ]"
-p "'product-name' 'product_version' license_password
[ 'license_annotation' ]" ]
i4admin -d [ -n server-name ] -v vendor-name
-p product-name
-t timestamp
i4admin -l s|v|p [ -i ] [ -n "server-name..." ]
[ -v "'vendor-name'..." ] [ -p "'product-name'..." ]
[ -u "user-name..." ]
i4admin -s [ -n "server-name..." ]
[ -v "'vendor-name'..." ] [ -p "'product-name'..." ]
[ -u "user-name..." ]
i4admin -r 1|2|3|4|5 [-e 1|234567]
[-b start-date] [-g end-date]
[ -n "server-name..." ] [ -v "'vendor-name'..." ]
[ -p "'product-name'..." ] [ -u "user-name..." ]
i4admin -x before-date -n "server-name..."
i4admin -h
The i4admin tool has a Graphical User Interface (GUI) and a Command Line Interface (CLI). If i4admin is invoked with non-X arguments, the CLI version is started, otherwise the GUI version is started.
If the license information has not been provided in a license certificate, the parameters must be entered individually. All three vendor parameters are not always required. If the vendor for the product is already installed on the server, only the vendor-name must be specified, otherwise the vendor-name, vendor-id and vendor-password must be specified.
By default the product list contains a summary of product information. Detailed product information can be queried by specifying the -iparameter. The product list can be filtered by server, vendor, and user. If more than one vendor-name is entered, the list of vendor-names must be enclosed in double quotes. Any vendor-name which contains white space must also be enclosed in single quotes.
Specify one or more user-names to limit the product list to products currently in use by the those users.
Error events 2-7 can be combined, e.g -e357 to list vendor messages, error events, and fatal error events.
The i4admin GUI provides an intuitive dialog based interface to manage all aspects of the LicensePower/iFOR licensing system. The main window is divided into four functional areas:
The GUI tool can perform the following tasks which will be described in detail in succeeding sections.
The Administrative tasks are adding licenses, deletingn licenses, and cleaning up stale licenses. There are two ways to add a license. If the license information has been provided in the form of a license certificate (a flat file describing the license), follow the first procedure. If the license information has been provided in any other form, follow the second procedure.
Adding a license from a license certificate
1. Open the Add pull-down menu and select the License... menu-item.
2. Select the server to add the license to from the Server drop-down listbox.
3. Select the Read certificate... button.
4. Enter the name of the license certificate in the Selection entry field. The Filter entry field and the Filter button can be used to limit the selection to a specific file or range of files.
5. Select OK to accept the file selection and close the dialog. Verify that the Vendor name, Product name, and Product version appear correctly on the Add License panel.
6. Select OK to add the license to the selected server and close the Add license dialog.
Adding a license manually
1. Open the Add pull-down menu and select the License... menu-item.
2. Select the server to add the license to from the Server drop-down listbox.
3. Select the Enter manually... button.
4. Select the product's vendor from the dropdown list of vendors which are displayed. If the product's vendor is not displayed, select the New vendor button to specify the vendor information.
4. Enter the Product name, Product version, License password, and optional License annotation (if provided) in the fields.
5. Select OK to accept the information and close the dialog. Verify that the Vendor name, Product name, and Product version appear correctly on the Add license dialog.
Deleting a license
1. Change to the Product details view. To change views select the desired view from the View pulldown menu.
2. Select a license to delete. Note that selected items which can be acted on are distinguished from plain text by the highlight color of the selection.
3. Select Delete license button from the Selected pulldown menu. The tool will ask for confirmation before deleting the license. Note that compound passwords, and use-once licenses cannot be deleted before their expiration date.
Cleaning up stale licenses
When a client application aquires a license from the license server, it also periodically checks back with the server to tell the server the application is still running. The interval between checks is referred to as the check-in period. The server does not automatically release licenses for applications which have missed their check-in period. However, if a client application attempts to aquire a license and none are available, the server will check all the outstanding licenses to make sure the respective clients have checked in. If a client has missed its check-in period, that client's license will be granted. The clean stale license command forces the server to iterate through the outstanding licenses, releasing the licenses which have not been checked.
To clean up stale licenses for a product or products:
1. Select one or more products from the Product summary view or the Product status view. Multiple entries can be selected by holding the Shift or Control key down while selecting.
2. Open the Selected menu and choose the Clean stale licenses menu item.
This set of reports are generated based on installed license details, and current usage information. The reports are generated based on a snapshot of the license system at a particular instant in time. Since the license system may be constantly changing, the information contained in these reports is only as current as the last snapshot.
These reports contain information which is summed accross the license system. The i4admin tool constructs a single logical view of the license system from which these reports are generated. This logical view is referred to as a snapshot of the license system. There are three reports based on the snapshot. The reports are accessed via the View pulldown menu.
* The product summary is a terse view of a product's installed licenses and current license usage. From this view the administrator can quickly identify problem areas, i.e. a product has 10 licenses installed, and 10 are in use.
* The product details view reports detailed installed product information, including the number of license installed, the start and expiration date of the licenses, and the server that the license is installed on. From this view, the adminsitrator can select delete a license.
* The product status view generates a detailed current usage report which includes; the number of licenses installed, the number of licenses currently checked out, who is using the license from what node, and how long the user has had the license.
By default these reports are based on all the installed products and licenses on all the servers contained in the current snapshot. The scope of any of these reports can be limited by applying one or more View Filters. The View filter allows the report to be scoped by server, vendor, product, or user. To change the View filter:
1. Select Filter... from the View pulldown menu.
2. From the View filter dialog select the type of filter to apply.
3. Select OK to close the individual filter selction dialog. Select OK to close the View filter dialog. The view will be immediately updated based on the new view when the View filter dialog is closed.
Its important to remember that these reports are only as current as the last snapshot. The snapshot can be updated manually or automatically.
To update the snapshot manually, select Refresh now from the Snapshot pulldown menu. The snapshot will be immediately updated,
To update the snapshot automatically, open the Automatic refresh dialog from the Snapshot pulldown menu. Select the Automatic refresh radio button, and enter a refresh interval in minutes.
These reports are generated by querying information directly from a server or servers. Since the amount of logged event information may be extensive it is impractical to create a local snapshot of all the log information to generate reports from.
The reports can be filtered using the same View Filter as previously discussed. A log report can be scoped by server, vendor, product, or user. By default, the View filter dialogs allow the administrator to select from the servers, vendors, products, and users which are contained in the current snapshot. If the desired filter item is not contained in the current snapshot, the administrator can manually specify the name in an entry field on the filter dialog.
There are five log reports which are summarized below.
* License event log reports which reports logged server events without deriving additional information. There are seven catagories of events which can be included in this reports.
2. (default) License related events (license request, license
release ...etc)
3. Vendor messages
4. License database modifications.
5. Error events (license request failed, vendor not found ... etc.)
6. Server start/stop
7. Fatal error events (server out of memory, server file IO error
... etc.)
Note that error events 2-7 can be combined.
* License requests by product. For each product lists the number of requests for licenses, the number of licenses granted, adn the percent of rejected requests.
* License requests by user. Lists the same information and the previous reports, but breaks out a separate entry for each user.
* License use by product. For each product lists the maximum concurrent nodes, maximum concurrent users, and average time in use.
* License use by user. For each product, lists the number of times each user invoked the product and the average time the product was in use.