Performing preinstallation tasks

Before you install HCL Local License Server (LLS), you must perform some necessary tasks.

About this task

You must first download the LLS installer package. The package contains programs that help you to generate fingerprints, and self-signed TLS certificates that are required for performing the installation.

Procedure

Download the installer package:
1. Log in to My HCLSoftware (MHS).
2. From the Downloads tab, click the HCLSoftware tile and then the License Server tile.
  All of the available LLS releases are displayed.
3. Select an appropriate release.
  The installers are listed for you to download.
  - For Windows, download HCL Local License Server 5.0 Windows.zip
  - For Linux, download HCL Local License Server 5.0 Linux.tar.gz
4. Click below the Actions menu to download the installer package.
5. Extract the installer package:
  - On Windows, use a zip program such as Winzip.
  - On Linux, enter the following command:
```
tar -xvzf packageName
```
Generate a fingerprint.
1. Go to the directory where the utility program is located.
2. From the command-line, run the utility program.
  - On Windows, run the utility.bat file as an administrator.
  - On Linux, enter the following commands with root privileges:
```
chmod +x utility.sh
```
```
./utility.sh
```
3. Specify the following information as the utility program prompts you:
  Please choose what you want to do: 1. Generate Fingerprint 2. Generate TLS Certificate 3. Generate Both 4. Quit
  Press 1 to generate the fingerprint. This option automatically captures and displays the MAC address. The following example output is displayed:
  You chose to generate a fingerprint. Found MAC address: A1-B2-C3-D4-E5-F6
  Enter the port number (port:443 preferred):
  
  Type the port number on which you want to run LLS. 443 is the preferred port number or you can specify a number between 1024 and 65535.
  The following example message is displayed indicating that the fingerprint generation is complete.
  Enter the port number (port:443 preferred):8080 The combined string is: A1-B2-C3-D4-E5-F6 Fingerprint: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Fingerprint generation completed.
  Save the generated fingerprint. It is required when you activate the LLS.
Optional: Generate a self-signed TLS certificate.
The LLS installer supports trusted third-party CA certificates and self-signed certificates.
Important:
- It is advised that you use a trusted third-party TLS certificate and skip this step.
- Your usage model for LLS and your risk tolerance should be considered in your TLS certificate selection.
- The use of a self-signed certificate comes with no warranties or liabilities.
Follow these steps to generate a self-signed certificate:
1. Press 2 for generating a self-signed TLS certificate.
2. Specify the configuration information as the utility program prompts.
  Enter FQDN (Fully Qualified Domain Name) (e.g. MYLLSSERVER.COM):
  
  Type the FQDN hostname.
  A Fully Qualified Domain Name (FQDN) is the complete address of a specific resource on the network. It includes host name, domain name, and any preceding sub-domains. You can obtain the FQDN host name on your respective OS as follows:
  
  On Windows, enter the following command:
  powershell "(Get-WmiObject win32_computersystem).Name + '.' + (Get-WmiObject win32_computersystem).Domain"
  
  On Linux, enter the following command:
  hostname -f
  Enter Your Organization Name:
  
  Type a name for the organization, such as HCL.
  
  Enter Certificate Validity Period (days, default: 365):
  
  Specify the validity period of the certificate in days. The default value is 365.
  
  Enter the directory to store certificates:
  Specify a location where you want to store the certificate. The following example message is displayed and indicates successful TLS certification generation:
  Certificate request self-signature ok subject=c=US, ST=YourState, L=YourCity (Optional), O=HCL, CN=Local Licensing Server Default self-signed certificate generated successfully Certificate and key files are located in: C:\MHS\LLS\Certificate TLS certificate generation completed. Do you want to generate something else? 1. Generate Fingerprint 2. Generate TLS Certificate 3. Generate Both 4. Quit
3. Press 4 to quit the process.
Create a deployment and allocate license to it.
1. Log in to MHS.
2. Go to the Deployments page.
  The Deployment page is blank at the initial login and displays only the Add Deployment card.
3. Create a deployment by clicking on the Add Deployment card.
4. Type a name for the deployment, select a deployment type, and click Add Deployment.
  A list of all license entitlements that you have purchased is displayed.
5. Enter the number of licenses you want to allocate to the deployment.
  The availability of the licenses changes when you modify license allocation.
6. Save all changes when done.
  A new card for the deployment is added and available from the Deployment page.
The Deployment page lists all deployments that you have added in the card form. Each card has an options button that allows you to manage your deployments.
Activate LLS and download the license file.
1. Click on the options button of the deployment you created in step 4.
2. Select Activate License Server.
  The Activate License Server window is displayed.
3. Select Local as the license server type to set up the LLS.
4. Click Activate License Server.
5. Enter the fingerprint you generated in step 2.
6. Click Save and Download to download the license file to your device.
  
  Note: The license file’s expiration date (exp) is set to the earliest entitlement expiry. You must download a new license file after the first entitlement expires to activate the new entitlement.

Results

You have completed the preinstallation tasks.

What to do next

You can begin the installation task. See Installing HCL Local License Server.