Troubleshooting
Under high client concurrency, a local license server may experience delays or become unresponsive when large numbers of clients reconnect and continuously send heartbeat requests. This can occur when incomplete client connections remain open and consume server resources.
To help improve server stability and aid troubleshooting, the local license server provides the following configuration options:
| • | Socket Read Timeout—Automatically closes incomplete client connections. |
| • | Client IP Logging—Enables tracking of incoming client IP addresses in the flexnetls.log file. |
Socket Read Timeout
The socket read timeout feature automatically closes incomplete client connections that do not complete communication within a specified time period.
|
Parameter |
Description |
|
readTimeoutEnabled |
Enables or disables socket read timeout processing. Default: false |
|
readTimeout |
Specifies the timeout value, in milliseconds. Default: 15000 ms (15 seconds) when activated Configurable Range: 1,000 ms to 60,000 ms. |
Client IP Logging
Client IP logging records the IP address of each connecting client in the flexnetls.log file. This information can be useful when troubleshooting connectivity issues or analyzing client traffic patterns.
|
Parameter |
Description |
|
logClientIpEnabled |
Enables or disables client IP address logging. Default: true |
Configuration Guidelines
On Linux, the logClientIpEnabled, readTimeoutEnabled, and readTimeout parameters can be configured using either:
| • | Command-line options during installation |
| • | The local-configuration.yaml file. |
On Windows, these parameters can be configured only via local-configuration.yaml.
Configuration Combinations
| • | Default Installation (read timeout disabled, client IP logging enabled). |
| • | Command line: |
./install-systemd.sh
| • | local-configuration.yaml: |
readTimeoutEnabled: false
logClientIpEnabled: true
| • | Enable read timeout with default value (15 seconds), with client IP logging enabled (default): |
| • | Command line: |
./install-systemd.sh --enable-read-timeout
| • | local-configuration.yaml: |
readTimeout: 15000
readTimeoutEnabled: true
logClientIpEnabled: true
| • | Enable read timeout with a custom value (for example, 5 seconds), with client IP logging enabled (default): |
| • | Command line: |
./install-systemd.sh --enable-read-timeout --read-timeout 5000
| • | local-configuration.yaml: |
readTimeout: 5000
readTimeoutEnabled: true
logClientIpEnabled: true
| • | Disable client IP logging (read timeout disabled by default): |
| • | Command line: |
./install-systemd.sh --log-client-ip-enabled false
| • | local-configuration.yaml: |
readTimeoutEnabled: false
logClientIpEnabled: false
| • | Enable custom read timeout and disable client IP logging: |
| • | Command line: |
./install-systemd.sh --enable-read-timeout --read-timeout 5000 --log-client-ip-enabled false
| • | local-configuration.yaml: |
readTimeout: 15000
readTimeoutEnabled: true
logClientIpEnabled: false