Welcome
Managing HCL Local License Server
After you receive your license entitlements, you must verify the system requirements, perform preinstallation tasks, and then install the HCL Local License Server (LLS) product.
Preinstallation Tasks
Before you install HCL Local License Server (LLS), you must perform some necessary tasks to prepare your system and environment.
Log Configuration
You can control the amount of detail written to the LLS log files, and the size at which they rotate, by editing the config.json file.

HCL Licensing - Overview
You must license your HCLSoftware product to get access to a full-featured version of your HCLSoftware product for an extended duration and HCLSoftware support.
Managing HCL Local License Server
After you receive your license entitlements, you must verify the system requirements, perform preinstallation tasks, and then install the HCL Local License Server (LLS) product.
- System Requirements
  Before you install HCL Local License Server, ensure that your system meets the hardware and software requirements.
- Preinstallation Tasks
  Before you install HCL Local License Server (LLS), you must perform some necessary tasks to prepare your system and environment.
  - Downloading the Installer Package
    You must download the LLS installer package into your host machine to manage your licenses for HCL products.
  - TLS Security Configuration
    HCL Local License Server (LLS) supports secure SSL communication over TLS 1.3 protocol and provides backward compatibility for TLS 1.2 protocol. Making changes to the TLS Security Configuration is optional and can be done either before or after LLS is installed. By default, LLS runs in SECURED mode. FQDN (Fully Qualified Domain Name) validation is recommended when generating or using certificates to avoid connectivity issues between LLS and clients.
  - Log Configuration
    You can control the amount of detail written to the LLS log files, and the size at which they rotate, by editing the config.json file.
  - Generating a self-signed TLS certificate
    You can use a third-party CA-signed certificate to install HCL Local License Server (LLS) on your host machine. Alternatively, you can generate a self-signed TLS certificate by running the utility.bat/sh file supplied in the LLS installer package.
- Installing HCL Local License Server
  After completing the preinstallation tasks, you can install HCL Local License Server (LLS) 5.4 as a new installation, either as a native installation or as a Docker container. You can also upgrade an existing native installation to 5.4. Once installed, you can use it to manage HCLSoftware product licenses.
- Version Upgrade Behavior
  On Windows and Linux, an existing HCL Local License Server (LLS) installation can be upgraded to a later version, and the licenses, logs, TLS certificate, and port are retained. A Docker deployment cannot be upgraded in place.
- Backup and Restore
  When HCL Local License Server (LLS) is uninstalled using the uninstall.bat/sh file, the license files, logs, TLS certificate, and port setting are saved to a backup directory. The installer can restore them during the next installation instead of requiring the server to be configured again.
- Post-installation: Generating the license file
  After installing the HCL Local License Server (LLS), you must create deployments in My HCLSoftware (MHS) to manage your entitlements. Each deployment generates a license file that must be copied to the licenses folder on your LLS host machine.
- Verifying HCL Local License Server Installation
  After you have installed HCL Local License Server (LLS), you must verify that the installation completed successfully and that the server is reachable and operational.
- Configuring HCL Local License Server
  You can configure HCL Local License Server (LLS) to update parameters such as the TLS certificate or the port number using the update.bat/sh file provided in the installer package.
- Uninstalling HCL Local License Server
  When you no longer require HCL Local License Server (LLS) on your system, you can remove it by running the uninstall.bat/sh file located in the installation directory.
- Troubleshooting HCL Local License Server
  You can troubleshoot some common issues that you might encounter during the installation or operation of HCL Local License Server (LLS).
Managing HCL Cloud License Server
After you receive your license entitlements, you can set up HCL Cloud License Server (CLS) for your HCLSoftware product license configuration.
Notices
This document provides information about copyright, trademarks, terms and conditions for the product documentation.

Log Configuration

You can control the amount of detail written to the LLS log files, and the size at which they rotate, by editing the config.json file.

About this task

Configuring the log settings is optional. The default settings are suitable for normal operation, and you usually change them only when more detail is needed to investigate a problem.

The log section of config.json contains three settings:

"log": {
    "log_level": 1,
    "disabled": false,
    "max_log_size_mb": 4
}


Setting	Description
`log_level`	The lowest level of message written to the log file. The default is `1` (Info).
`disabled`	Set to `true` to stop writing log files. The default is `false`.
`max_log_size_mb`	The size in MB at which a log file rotates. The default is `4`.

Procedure

Go to the directory where the config.json file is located.

After installation, config.json is in the installation directory.

Locate the log section and set log_level to the required value.


Value	Level	Description
-1	Trace	Very detailed debugging information
0	Debug	Detailed debugging information
1	Info	Informational messages (default)
2	Warn	Potential issues
3	Error	Application errors
4	Fatal	Severe errors
5	Panic	System halted

Only messages at or above the configured level are written to the log file. For example, at level 3 only Error, Fatal, and Panic messages appear.

Save the file after making the changes.
Restart the LLS service.

For the restart commands, see TLS Security Configuration.

Results

The new log settings take effect when the service restarts. The log files are written to the logs folder in the installation directory. See Troubleshooting HCL Local License Server.