Questions

Answer

IBM Terminal Emulators

 License Manager (LM), when installed and configured with application servers, can track license usage for both HOD and PCOMM.

Installation of License Manager

Pre-requisites

• WebSphere Application Server v8.5 and above.
• Tomcat 9.x.x
• Embedded Server

Installation Steps

enableMacAddress = set true to enable mac address logging

enableMachineName = set false to disable machine name logging,

For example:

licenseserverurl=http://127.0.0.1:9080/LicenseManager/LicenseLogger
timeout=5
enableMacAddress=true

For Configuring Workplace Client Technology (WCT) client pages, the same parameters must add as HTML parameters using the Deployment Wizard.

Name: licenseserverurl
Value: http://://LicenseLogger
Name: timeout
Value: n (where n = 5 to 30 [minutes], Default value = 5)
Name: enableMacAddress
Value: true or false, default is false

For Configuring Host Access Client Library (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://://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");

Add the following parameter values to the pcswin.ini file, typically located in the License section of the file as follows:

C:\Users\\AppData\Roaming\IBM\PersonalCommunications
Name: licenseserverurl
Value = http://://LicenseLogger
Interval = Logging request interval (in mins) after which the server marks the client as 
timeout if the request is not sent. The minimum value is 5.

For example:

[License]
URL=http://127.0.0.1:9080/LicenseManager/LicenseLogger
Interval=5

In an intranet environment, when a License Manager Server is configured with local Certificate Authorities, if an error occurs while verifying the certificates received from the license manager, the HTTPS connectivity from the PCOMM client to the license manager may also fail.

The following keywords have been introduced into the pcswin.ini file to handle this:

[License]
IgnoreUnknownCA=Y
IgnoreInvalidCertCN=Y
IgnoreCertRevCheck=Y

• When IgnoreUnknownCA is set to Y, it allows an invalid certificate authority. This allows PCOMM to send License information even when the License Manager Server sends an untrusted CA. The setting is recommended only under test environments. The default value of the keyword is set to N.
• When IgnoreInvalidCertCN is set to Y, it allows an invalid common name in a certificate; the server’s name specified by the application does not match the common name in the certificate. The setting is recommended only under test environments. The default value of the keyword is set to N.
• When IgnoreCertRevCheck is set to Y, it ignores certificate revocation problems. This allows PCOMM to send License information even when it cannot verify whether the host certificate is valid or revoked. The setting is recommended only under test environments. The default value of the keyword is set to N.

Also, the following keywords in the .ini file are provided to enable or disable IBM Personal Communications emulator sessions from sending the MAC Address and machine name to the HI License Manager Server. The keywords are part of the License section of the pcswin.ini file.

[License]
enableMacAddress = N
enableMachineName = Y

[License]
enableMacAddress = N
enableMachineName = Y

Configuration of Unique License Count

IP address: IP
System username: systemusername
MAC address: macaddress
Machine name: machinename

Using the License Manager

After the successful server module is installed, administrators can use the license logger to monitor the client login from the License Manager admin console. To log in to the License Manager, perform the following procedures:

To manage users who can access the License Manager Admin console, for more information on manage users, click Users from the menu.

Add a User

Admin can add the user for a selected user.

To add a new user, follow the procedure:

Note: The Admin can create new users for the license manager.

Reset Password

Admin can reset the password for a selected user.

To reset your password, follow the procedure:

  1. From the Existing User grid table, under the Reset Password.

  2. Click the Reset Password icon, and a message window popup: Do you want to reset the password?

  3. Click Reset, and a message window popup: Password updated Successfully. 

  4. Click Cancel, it redirects to the Existing User screen.

Delete an Existing User

Admin can delete a selected user.

To delete an existing user, follow the procedure:

  1. From the Existing User grid table.

  2. Click the Delete icon, and a message window popup: Do you want to delete the user? 

  3. Click Delete, and a message window popup: User deleted successfully? 

  4. Click Cancel, it redirects to the Existing User screen.

Search Option

 If more users are displayed under the Existing User, then the user can search for the appropriate user using the Search option

 

License Information

Number of Licenses Purchased: It allows the user to specify the maximum license count. The default value is set to 1 as the maximum count. The user is allowed to change the default value and specify the required maximum license count. When the Active license count crosses the maximum limit specified, a warning message is shown indicating this.

Note: Any registered license details will be shown in the table.

License Count Statistics

Highest Concurrent License Count: Highest concurrent license count gives the maximum number of distinct users who have accessed the product (HOD/PCOMM) 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 (HOD/PCOMM) 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 (HOD or PCOMM) date since the installation of License Manager.

More: Click More option takes us to the License Summary Report for the combined products (PCOMM and HOD).

By default, the report displays a daily summary of the licenses for each of the products HOD, PCOMM, and HACP. The filter feature can be used to view the license usage for a specified date interval.

It includes the following information for HOD, PCOMM, and HACP:

• Highest Concurrent License Count (MM-DD-YYYY).
• Highest Authorized License Count (MM-DD-YYYY). The tabular view shows the following license details for HOD, PCOMM, and HACP with time stamps.
• Highest Concurrent License Count
• Highest Authorized License Count
• Cumulative Authorized License Count. The admin can sort specific columns as required.

HOD and PCOMM Specific License Count Statistics

Each section/tab provides the following information for the specific product.

• Active Licenses.
• Highest Concurrent License Count (Today).
• Highest Concurrent License Count.
• Total Authorized Used License (Today).
• Highest Authorized License Count
• Cumulative Authorized License Count.

Active Licenses

Active concurrent licenses for HOD/PCOMM (for the active sessions). Admin can view the active client details, click the highlighted Active Licenses link. Active clients report displays the below information about the active clients at that time.

[License]
IP Address
System Username
Machine Name
MAC Address
Sub-Client Type
Check-In-Time
The admin can sort specific columns as required.

• Highest Authorized License Count: The Highest Authorized license count gives the maximum number of authorized license users accessing the product (HOD/PCOMM) on any day since the installation of the License Manager.
• Cumulative Authorized License Count: Cumulative Authorized license count of distinct authorized users since the installation of license Manager for the product (HOD and PCOMM).

License Usage Details

It displays the License details report for the current day (HOD and PCOMM).

Log level

This option is available on the 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, Level 3 (HIGH), logs all the entry parameters, including the connection closed entry as well as 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.

The following are the logged parameters :

• IP Address of the client.
• System Username.
• Machine Name.
• MAC Address.
• Client Type.
• Status of the connection.
• Timestamp.

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).

1. Level 3: All Parameters
2. Level 2: Timestamp, IP, System Username, Client Type, Sub-Client Type, Machine Name, Connection Status.
3. Level 1: Timestamp, IP, System Username, Client Type, Sub-Client Type, Connection Status.

• Page Options:
• Refresh: Refresh all the data on the home page.
• Save: Save all the configurations.