Configuring HCL Z and I Emulator for Web with Flexera

This document describes the procedure to acquire a license for using the product ‘HCL Z and I Emulator for Web’ and to configure the product for connecting to a host.

Follow the instructions detailed in each of the below steps :

    1. Setup the License Server (Flexera)

    2. Configure the Product (HCL ZIEWeb) with the License Server (Flexera)

    3. Configure the Flexera details in License Manager application

    4. Configure the License Manager application with the Product (HCL ZIEWeb)

Step-1 : Download the Product and License Server (CLLS) from FlexNet Operations

  1. Copy the below link and paste it in a browser address bar to access the FlexNet login page.

Figure 1: Flexera Login

  1. Enter the authorized login credentials to access the Producer Portal Home page.

  2. Under QuickSearch, select “Products” under Search and “All Products” under For and provide the relevant keywords for finding the required products.

The below image shows a keyword entered in the search field, to find the “HCL ZIE Family products”.

Figure 2 : Producer Portal Home (QuickSearch for Products)

  1. If the Search is successful, all the product packages relevant to the entered keyword will be displayed in the Search results.

Figure 3 : Package Products (Search Results)

  1. Select the required Product package from the list (HCL Z and I Emulator for Web 1.0).

  2. In the “Create A product” panel that follows, click on the “Download Packages” tab to view and download the required packages.

The below image shows the options selected for downloading ‘HCL ZIE for Web’ and ‘HCL_CLLS’.

Figure 4 : Package Products (Download Packages)

  1. Click on HCL_CLLS to download the ‘HCL Common Local License Sever 1.0’ package to a User defined location.

  2. Click on HCL_ZIE_for_Web_1.0 to download all the packages related to ‘HCL ZIE For Web v1.0’ to a User defined location.

Step-2 : Extract the Installers (for the Product and License Manager)

  1. Open the downloaded package.

For the product HCL Z and I Emulator for Web (ZIEWeb), the downloaded package ‘HCL_ZIE_for_Web_1.0’ will have the following folder structure,

Figure 5 : HCL ZIE for Web product package

  1. Extract the following components:

Step-3 : Configure the License Manager and the Product for usage

    1. Setup the License Server (Flexera)

In the HCL_CLLS package that is selected, the zipped packages shown in the below image are present. Download the relevant installer, based on your OS specification to connect to the Flexera License server.

Figure 6 : Installer Packages in HCL CLLS

Note : You can choose the Server deployment mode as Local or Cloud while setting up the license server.

Figure 7 : Server deployment mode

<https://[license server host]/api/1.0/instances/[license server ID]>

For further queries related to Flexera setup, contact the HCL Customer support team using the following link :

3.2 Configure the Product (HCL ZIEWeb) with the License server (Flexera)

To configure HCL ZIE for Web with the License Server, follow the below steps.

Pre-requisite for Key-pair generation:

Steps to Configure the product with the License Server (Flexera) :

  1. Configure the Key Tool

  2. Generate the Key-pairs

  3. Upload the public key to Flexera License server

Below is the detailed procedure to Configure ZIEWeb with Flexera server using Open SSL:

  1. Key Tool Configuration (for Open SSL):

  1. After installing Open SSL, copy the open SSL folder under C:\ drive.

  2. Configure the Open SSL path in the system environment variables as shown:

Figure 8 : Configuring the Open SSL under system environment variables

  1. Generation of Key-pairs (using Open SSL tool)

The Public/Private key pair generated is used for secure communication. The key pair should be in "RSA 2048-bit" format. The private key format should be "pksc8", and that of the public key should be "DER" format.

The following is the procedure to generate key-pairs using OpenSSL:

(Note: if your using any other third party tool for key-pair generation, you need to follow the instructions provided by them.)

  1. Generate private key.

    Open Command Prompt as an Administrator and enter the Open SSL path to change the path from the root directory (C:\OpenSSL\bin). Enter the below command, to generate the private key under C:\OpenSSL\bin,

    openssl genrsa -out private_key.pem 2048

  2. Get the public key.

    After the private key is generated, enter the below command to generate the public key also in the same path.

    openssl rsa -in private_key.pem -pubout -outform DER -out public_key.der

  3. Convert private key to pkcs8 format to use it.

    The private_key.pem file should be converted into pcks8 format for strong encryption. To do this conversion, enter the below command,

    openssl pkcs8 -topk8 -inform PEM -outform PEM -in private_key.pem -out private_key_pkcs8.pem -nocrypt

    Figure 9 : Generated keys under C:\OpenSSL\bin

  1. Uploading the public key to Flexera Server

  1. To connect to the Flexera server, the Extracted CLLS package should be available in the local machine. Navigate to the Flexera folder in the local machine. (D:\ [Extracted CLLS package]\enterprise)

  2. Open the Command Prompt and enter the below command,

    flexnetlsadmin.bat -server <https://[license server host]/api/1.0/instances/[license server ID] -authorize admin [license sever admin password] -uploadPublicKey [local path to public key (in DER format)]>

    For example:

    flexnetlsadmin.bat -server https:// -authorize admin adminpwd -uploadPublicKey C:\temp\public_key.der

  3. If the public key is successfully uploaded to the Flexera server using the above command, user will receive an acknowledgement as “Client public key has been uploaded successfully” from the Flexera server.

    (For any queries related to the Flexera setup, contact the HCL Customer support team using the following link :

  4. Enter the below Flexera server command to check the feature description and the total no. of licenses configured for that feature.

    C:\Users\Admin\Desktop\Flexera\Others\[Extracted CLLS package]\enterprise\flexnetlsadmin.bat -server <https://[license server host]/api/1.0/instances/[license server ID] / -authorize <username> <password> -licenses -verbose>

    For example:

    C:\Users\Admin\Desktop\Flexera\Others\[Extracted CLLS package]\enterprise\flexnetlsadmin.bat -server https:// -authorize admin adminpwd -licenses -verbose

    Figure 10 : Flexera server command to check Feature description & count of configured licenses

3.3 Configure the Flexera details in the License manager application (via any supported Application server)