HCL ZIE License Manager
License manager is a tool that facilitates effective software management between end users and software vendors, thereby enabling organization to track and document the usage of the company's software products. HCL ZIE License Manager is the license control tool used to track the license information for Mainframe Terminal emulator products like HCL ZIE for Web and HCL ZIE for Windows.
The HCL ZIE License Manager can be configured for the following versions of HCL Terminal Emulators:
* HCL ZIE for Web version 1.0 & above
* HCL ZIE for Windows version 1.0 & above
HCL ZIE License Manager (LM) can track license usage for both ZIE for Web and ZIE for Windows, when it is installed and configured with WebSphere Application Server (WAS), ZIEWeb Embedded Server or Tomcat.
* Application Server
* Flexera licensing details
Follow the below procedure to install License Manager:
For example:
http://<appserver-address>:<port-num>/<context-root>
where,
<appserver-address> : is the hostname or IP address of the server on which license manager is installed,
<port-num> : is the port that is specified during the deployment of the application server, and
<context-root> : is the location name that can be configured by the Administrator.
For all the client types (ZIEWeb Lite Client Launcher and Java Webstart client add the following parameters to the configuration file (config.properties), that is located in the ZIEWEB server publish directory.
For example:
licenseserverurl=http://127.0.0.1:9080/LicenseManager/LicenseLogger
timeout=5
enableMacAddress=true
The License Manager settings can either be configured by providing the required server details in the 'InstallShield Wizard' at the time of ZIEWin installation itself, or can be added/updated in the 'License Manager Settings' section of the Advanced tab within the Preferences.
License URL : Specifies the HTTP URL of the License Manager Server to which HCL Z and I Emulator for Windows session sends license parameters. It's mandatory to configure this field to use the product. If this field is not configured the emulator session initiation will be aborted.
Example: "http://
Interval : Specifies the time period in minutes at which HCL Z and I Emulator for Windows session sends license parameters. It is the request interval after which the server marks the client as timeout if the request is not sent. Default and the minimum value is 5 minutes and the maximum value is 30 minutes.
Note: The License Manager Settings set by "Preferences" utility takes precedence over the settings set through installation. If the installation is "user installation" where the application data location is %appdata% in user directory the setting that are set in "Preferences" utility is applicable only for the current user.
For HACL applications, developers can set the License server URL and timeout values with the below session parameters and statements:
p.put(Session.LICENSE_SERVER_URL,"http://<server-address>:<server-port>/<context-root>/LicenseLogger");
p.put(Session.LICENSE_SERVER_TIME_OUT,"5");
p.put(Session. LICENSE_SERVER_MAC_ADDRESS,"true");
p.put(Session. LICENSE_SERVER_MACHINE_NAME,"false");
Administrators can mandate license uniqueness, based on different values, by modifying the “adminConfig.properties” file in the License Manager installed directory.
For Example:
defineUniqueUser=systemusername;macaddress
Below are the available parameters that need to be modified to define uniqueness.
IP address : ip
System user name : systemusername
MAC address : macaddress
Machine name : machinename
Any combination of the above attributes can be used to define license uniqueness. If more than one parameter value has to be configured, then each parameter should be separated by a semi colon (;).
Note :
a). While re-defining a unique user with existing logs, provide a different installation location for License manger in the servlet parameters (or delete the existing License manager folder) and restart, to avoid errors during license count calculation.
b). Restart the HCL ZIE License manager, after re-defining the unique user.
Following is a list of parameters that can be used to configure the License Manager:
Property |
Value |
Description |
ZIE_WIN_Enabled |
true/false |
Enable/ disable ZIE for Windows client |
ZIE_WEB_Enabled |
true/false |
Enable/ disable ZIE for Web client |
FLEXERA_SERVER_URL |
https://[license server host]/api/1.0/instances/[license server ID] |
Flexera server URL for ZIE for Windows |
FLEXERA_SERVER_PVT_KEY |
C:\\Users\PrivateKey.pem |
Flexera private key location for ZIE for Windows |
FLEXERA_SERVER_URL_ZIEWEB |
https://[license server host]/api/1.0/instances/[license server ID] |
Flexera server URL for ZIE for Web |
FLEXERA_SERVER_PVT_KEY_ZIEWEB |
C:\\Users\PrivateKey.pem |
Flexera private key location for ZIE for Web |
Directory_Location |
C:\\dir_location |
Directory Location for logs |
Depending on the application server that is used to deploy the License Manager application, the path from which the above properties can be initialized may change.
After the server module is successfully installed, Administrators can use the license logger to monitor the client login from the License Manager Admin console.
The console can be accessed by navigating to: http://appserver-address:port-num/<context-root>/
When prompted for a username and password, Users may login with the default username admin and password password.
After logging in as a License Manager Admin, you can change the password by clicking on “admin” on the menu bar. Refer to the ”Create New User" and "Change User Password" sections below, for more information.
As a License Manager Administrator, you can perform the following tasks:
Total active licenses
- Number of active concurrent licenses for both ZIE for Web & ZIE for Windows combined.
Highest Concurrent License Count
- Highest concurrent license count gives the maximum number of distinct users who have accessed the product (ZIE for Web / ZIE for Windows) simultaneously, since the installation of License Manager.
Highest Authorized License Count
- Highest authorized license count gives the maximum number of authorized users who have accessed either of the products ZIE for Web / ZIE for Windows) on a day.
Cumulative Authorized License Count
- Cumulative Authorized License Count gives the total number of distinct authorized users who have accessed either of the products (ZIE for Web or ZIE for Windows) till date, since the installation of License Manager.
More
- Clicking on the More option takes us to the License Summary Report for both the products combined.
By default, the report shows a daily summary of licenses for the individual products, ZIE for Web and ZIE for Windows. The filter feature can be used to view the license usage for a specified date interval. It includes the following information for each product:
The Admin can sort specific columns as required.
Each section/tab shows the following information for the corresponding product.
Active Licenses
Active concurrent licenses for ZIE for Web / ZIE for Windows (for the active sessions). Admin can view the active client details by clicking the highlighted Active Licenses link. Active clients report shows the below information about all active clients at that time.
The Administrator can sort specific columns as required.
Highest Authorized License Count
Highest Authorized license count gives the maximum number of authorized license users accessing the product (ZIE for Web /ZIE for Windows) on any day since the installation of License Manager.
Cumulative Authorized License Count
Cumulative Authorized license count of distinct authorized users since the installation of license Manager for the product (ZIE for Web and ZIE for Windows).
License details report for the current day (ZIE for Web and ZIE for Windows).
Log level
This option is available on "License usage details" page.
Select the log level (from 1-LOW to 3-HIGH) to filter the number of entries to be logged. The default log level, which is Level 3 (HIGH), logs all the entry parameters, including connection closed entry along with the periodic client check-ins. All the other log levels (1 and 2) will log only the first client check-in and the connection closed entry.
Following are the parameters which are logged:
Level 3: All Parameters
Level 2: Timestamp, IP, System User Name, Client Type, Sub-Client Type, Machine Name, Connection Status
Level 1: Timestamp, IP, System User Name, Client Type, Sub-Client Type, Connection Status
The license usage report containing Log level 3 (HIGH) with license usage information can be extracted by the Admin into a .csv file (that can be opened as an Excel Workbook).
To manage Users who can access the License Manager Admin console, click on Users on the menu bar.
To create a new user, follow the below steps:
Note: New users for license manager can be created only by the Admin.
Under the Existing Users section, there is an option to delete the existing user, by selecting the icon next to the username.
If required, Admin can reset the password for a selected user to the default password (‘password’), by clicking on icon next to the username in the existing users list.
User can change the current password, by hovering the mouse pointer over the Username field displayed on top of the screen. After specifying the current and new password, Click Submit.
The licensing tool that is integrated with the HCL ZIE License Manager is Flexera, which provides a floating license model using the Flexera REST API client.
The usage of HCL ZIE License Manager sessions and requests are tracked and granted by Flexera licensing. For licensing to work in HCL ZIE License Manager applications, the Flexera server and the required runtime properties need to be pre-configured.
HCL ZIE License Manager Users may configure an on-premise license server or use HCL's Flexera Cloud Server. After configuration of the license server, License Manager Administrators need to create a public/private key pair, out of which, the public key is to be uploaded to the License server and the private key is used to configure the License Manager for communication with the server.
For more information on the Secure License Server Configuration of Flexera Licensing Integration for ZIEWeb, refer to Configuring HCL Z and I Emulator for Web with Flexera
National Translation is not available. Help files are currently available only in English.