Configuring license settings manually

Most licensing for AppScan® Source is handled by the License Manager. Through the License Manager, you can configure licensing using a cloud or local license server, or a proxy server. You can configure license settings manually either by editing the license.ozsettings config file directly or running the licensemanager.bat script with parameters.

Editing the license.ozsettings config file

The license configuration file, license.ozsettings, specifies properties for how licenses are managed for HCL® AppScan® Source. The license.ozsettings file resides in <data_dir>\config (where <data_dir> is the location of your AppScan® Source program data, as described in Installation and user data file locations). You can use the command line to edit the file.

On the rare occasions that you must edit the license.ozsettings file directly, the file directs licensing with these properties:
Property Default Value Description
use_node_lock_license false Specify whether node-locked license is configured:
  • true: configured
  • false: not configured
license_server_url n/a License server URL
license_borrow_interval 24 The inactivity interval, in hours, for which AppScan® Source retain a license. The minimum is 24 hours and the maximum is 168 hours. When a license is inactive for the specified number of hours, the license is released back to the license server for use by another instance of the product.
use_local_ssl_cert true While authenticating certificate to a local license server:
  • true: Use local certificate for authentication, downloaded in config folder
  • false: Use certificate if imported through the windows cert manager
You must restart the License Manager after making edits to the license.ozsettings file.
Note: Take care to ensure there are no extra spaces in any parameter value.

Running the licensemanager.bat script

Use licensemanager.bat at the command line.

To configure proxy server details to connect through to access the license server. This must be configured first:
licensemgr.bat -configure -proxy -host <proxyHost> -port <proxyPort> [-user <username> -password <password>]

  • -host: Specifies proxy server hostname.

  • -port: Specifies proxy server port.

  • -user: Optional. Specifies username to connect to proxy server.

  • -password: Optional. Specifies password to connect to proxy server.

To configure AppScan® Source with license information:
licensemgr.bat -configure -url <licenseServerUrl> [-acceptcert]

  • -url: Specifies license server URL.

  • -acceptCert: Optional. If provided, accepts certificate to connect to the license server.

To import a node-locked license file:
licensemgr.bat -importLicenseFile licensefile.license
  • -importLicenseFile: Specifies that the license file is imported from the subsequent named file.
  • licensefile.license: The name of the license file to import.
To view the fingerprint of the local host:
licensemgr.bat -getFingerPrint
  • -getFingerPrint: Retrieves the fingerprint of the local host.