win8_logo [HKEY_LOCAL_MACHINE\SOFTWARE\WIBU-SYSTEMS\CodeMeter\Server\CurrentVersion]

MacOS LINUX Section "General"

ActionTimeInterval

 

specifies the time interval the ActionHandler is to scan for an open task to perform.

Value

Description

[0, 1000]

Interval between 0 and 1000 milliseconds (default: 10 milliseconds).

ApiCommunicationMode

 

specifies the communication mode between the WibuCm.dll library and CodeMeter License Server used by the library.

Modes may be combined.

Mode

Description

1

platform specific (default)

2

shared memory

4

IPv4

8

IPv6

Platform specific default:

win8_logo Windows

IPv6, IPv4, shared memory

MacOS LINUX macOS / Linux

IPv6, IPv4

WinCE

IPv4, shared memory

ApiCommunicationModeServer

 

specifies the communication mode between the WibuCm.dll library and CodeMeter License Server used by CodeMeter License Server.

Modes may be combined.

Mode

Description

1

platform specific (default)

2

shared memory

4

IPv4

8

IPv6

Platform specific default:

win8_logo Windows

IPv6, IPv4, shared memory

MacOS LINUX macOS / Linux

IPv6, IPv4

WinCE

IPv4, shared memory

information_grau_klein26

If ApiCommunicationMode is set to a communication mode that is excluded by ApiCommunicationModeServer, the communication between DLL and CodeMeter License Server will not work. For example, ApiCommunicationModeServer is set to '4' (IPv4) and ApiCommunicationMode is set to '8' (Ipv6).

BindAddress

 

specifies the IP Address of the network adapter used by CodeMeter License Server.

Typical examples are 0.0.0.0 which binds to all network adapter (default) or 192.168.0.1.

BorrowIdentifyByIpAddress

 

specifies the IP Address (server identification) for a prepared borrowing.

CleanUpTimeOut

 

contains a timeout value (in minutes) used by CodeMeter License Server to clean up internal handles and threads. The default value is 120 minutes.

Starting with CodeMeter Version 6.70a this value only affects LAN handles.

CmActPath

 

contains in the case of applied write filters the location (path information) to which the data of CmActLicense is to be saved persistently. If filters are used your software vendor is likely to inform you.

Please do not mix up this with the location of the default CmActLicense read and backup mechanism,
e.g. C:\ProgramData\CodeMeter\CmAct.

information_grau_klein26

This configuration option applies only to Universal Firm Codes and must be explicitely set in conjunction with set write filter methods EWF (Enhanced Write Filter) or FBWF (File Based Write Filter).  

For EWF, please note to select the location on a non-write-protected partition. With FBWF, this can also be an excluded directory on the partition protected with a write filter.

CmInstanceUid

 

On starting, CodeMeter License Server calculates a unique ID used to discern client computers for station share accesses.

CmWANPort

 

specifies the port address for the CmWAN communication used by the server side only. The default value is the port address 22351.

CmWebSocketApi

 

specifies whether the CmWebSocket API is used or not.

information_grau_klein26

This entry only affects old versions of the CmWebSocket API prior to CodeMeter Version 7.10a that do not perform origin checks.

information_grau_klein26

Origin check

The new CmWebSocket API from CodeMeter version 7.10a on requires a check for the origin of a request when information and data is exchanged via Web Components with CodeMeter License Server. This is done by a certificate issued by Wibu-Systems.

At the same time, old versions of the CmWebSocket API prior to CodeMeter Version 7.10a due to security reasons are deactivated by default.

The old versions can be activated by setting the profiling entry CmWebSocketAllowWithoutOriginCheck'='1'. Such activation, however, is not recommended.

If the value 0 (disabled) is set, the online activation in the WebDepot of CodeMeter License Central cannot be used. The Software Activation Wizard using the CodeMeter License Central Gateways and the file-based activation in WebDepot still work.

Value

Description

0

disable

1

enabled (default)

If the value 0 (deactivated) is set, the online activation in WebDepot of CodeMeter License Central cannot be used. However, the Software Activation Wizard, which uses the CodeMeter License Central Gateways, and the file-based activation in WebDepot still work.

CmWebSocketAllowWithoutOriginCheck

 

specifies since CodeMeter Version 7.10a whether the CmWebSocket API is additionally used without check of the origin of a request for the CmWebSocket API or not.

By default, the check is not switched off and is performed (0).

information_grau_klein26

For a transition period, it may happen that a not yet completed exchange of web components (WebDepot) may require activation of the old CmWebSocket API of a CodeMeter version 7.10a or newer.

Then setting the profiling entry 'CmWebSocketAllowWithoutOriginCheck' to the value '1' after a CodeMeter License Server restart can reactivate the previous CmWebSocket API without origin check.

The activation of the old CmWebSocket API on principle is explicitly not recommended.

Value

Description

0

disable (default)

1

enabled

DisableHostnameLookup

 

disables name resolution and thus prevents name resolution for logging (license tracking).

Value

Description

0

deactivated

1

acivated (default)

DisableWebSocketVersions

 

allows to explicitly disable certain WebSocket protocol versions.

To completely disable the WebSocket interface use DisableWebSocketVersions = 0xFFFFFFFFF.

Optional disabling of a version of the WebSocket API from version 4: DisableWebSocketVersions = <Matching Bit>.

information_grau_klein26

This entry is intended for cases in which individual protocol versions should be deactivated for security reasons.

EnabledContainerTypes

 

specifies the CmContainer Types activated. Currently, four flags are defined which can be bit-wise combined.

This setting is used to avoid technical problems on some systems.

Value

Description

1

Mass Storage (USB mass storage device class)

2

CmActLicense

4

HID (USB human interface device class)

8

CmCloud

EnableWebAdmin

 

This parameter is available for __CmEmbedded_4c_transp embedded systems only (LINUX Linux arm and Big Endian) and is ignored for all other platforms.

Value

Description

0

CodeMeter WebAdmin disabled (default).

1

CodeMeter WebAdmin enabled.

ExePath

 

specifies the current path information where CodeMeter License Server is stored.

On any start, CodeMeter License Server saves this path to the parameter allowing applications calling CodeMeter on request to start CodeMeter License Server.

HostNameResolveTimeout

 

specifies in milliseconds the maximum value of the timeout that is used to resolve the IP address to the host name.

This is used for optimization and adaptation to specific network properties.

The default value is 10 milliseconds. The value can also be set to a value between 0 and 0xffffffffffff (49 days) milliseconds.

HelpFile

 

specifies the complete path information and file name of the CodeMeter online help file.

IsCmWANServer

 

specifies whether CodeMeter License Server is running as a CmWAN server or not.

Value

Description

0

CodeMeter License Server as CmWAN server disabled (default).

1

CodeMeter License Server as CmWAN server enabled.

IsNetworkServer

 

specifies whether CodeMeter License Server is running as a network server on the network or not.

Value

Description

0

CodeMeter License Server as network server on the network disabled (default).
All network requests from other computers are blocked.

1

CodeMeter License Server as network server on the network enabled.

LastLogCleanup

 

specifies when all CodeMeter *.log files have been deleted using a time stamp value.

ListRejectedAllocations

 

allows users to list all rejected allocations for a specific CodeMeter License Server (local or remote) and retrieve them as log entries.

Value

Description

0

deactivates listing of rejected license allocations.

1

activates listing of rejected license allocations.

ListRejectedAllocationsFirmcode

 

allows to set restrictions on retrieving rejected allocations by specifying a single Firm Code, e.g. 6000010.

By default, listing includes all available firm Firm Codes.

ListRejectedAllocationsMaxEntries

 

allows setting a maximum number of list entries when retrieving rejected allocations.

The specified number of list entries is kept until users actively retrieve the list entries via a corresponding cmu command.

By default, the listing covers 1000 entries. Optionally, an input interval between [1..200000] is supported..

LogCleanupTimeout

 

specifies how long the timeout value is for the log file deletion. The default value is 336 hours, i.e. 14 days.

LogCmActDiag

 

specifies whether CmActLicense diagnostic logging is activated or not.

Value

Description

0

CmActLicense diagnostic logging disabled.

1

CmActLicense diagnostic logging enabled (default).

LogEventLogRotationTimeInMinutes

 

specifies after how many minutes the event log file will be rotated.

Accepted values are in the range 1 to 525600 (8760 hours, 365 days). Default value is 1440 (24h).

The default value is also used when the specified value is out of range or not specified.

LogEventLogRotationSizeInMb

 

specifies after which size in MegaByte the event log file should be rotated.

Accepted values are in the range from 1 to 3500 (3.42 GigaByte, Gb). The default value is 10 (10 MegaByte).

The default value is also used if the specified value is out of range or not specified.

Logging

 

specifies whether logging of the console or GUI output is activated or not.

Value

Description

0

Logging disabled (default).

1

Logging enabled.

LogLicenseTracking

 

specifies whether license tracking is activated or not.

Value

Description

0

License tracking disabled (default).

1

License tracking enabled.

LogLicenseTrackingPath

 

specifies the location to where the license tracking files are written to.

Default location is a directory "Licensetracking" parallel to the "Logs" directory specified in parameter LogPath.

LogLicenseTrackingLogRotationSizeInMb

 

[1..3500]

If a license tracking log file exceeds a size of x MB, the rotation starts.

The input range of x is from 1 to 3500 MB.

The default value is 1000 MB.

If the specified value is outside the input range, automatically the default value applies.

LogLicenseTrackingLogRotationTimeInMinutes

 

[0..525600]

If the oldest entry of a license tracking log file is older than n minutes, the rotation should start.

The default value is 0 hours.

The input range of n is from 0 to 525600 minutes (approx. 1 year).

If the specified value is outside the input range, automatically the default value applies.

LogPath

 

specifies the location where the log files are written to.

Default location is the directory generated platform dependently by the Installer.

win8_logo Windows

C:\ProgramData\CodeMeter\Backup\Logs

MacOS  macOS

/Library/Application Support/Logs/CodeMeter

LINUX Linux

/var/log/CodeMeter

LtClientsCleanupTime

 

specifies the period how long License Transfer client data will be stored.

The time is stored in hours to be able to test using small periods. In CodeMeter WebAdmin it is stored in days. The default setting is 100 days, i.e. 2400 hours.

MaxMessageLength

 

specifies the maximum length of TCP/IP requests in bytes. Default is 64 MB which should be sufficient for all known API calls.

NetworkAccessFsb

 

specifies whether an access to a Firm Security Box (FSB) entry is allowed via network or not.

Value

Description

0

Access to a FSB entry via network is not allowed (default).

1

Access to a FSB entry via network is allowed.

information_grau_klein26

This value will be ignored if an Access Control List (ACL) is used.

NetworkPort

 

specifies the network port address for the communication. The default value is the port address 22350.

The port 22350 is registered by Wibu-Systems at IANA (Internet Assigned Numbers Authority) and uniquely assigned for the CodeMeter communication. For a list of assigned ports see www.iana.org/assignments/port-numbers.

NetworkTimeout

 

specifies the TCP/IP network timeout value.

Values

Description

0

No timeout will be used.

[40, ∞]

Interval between minimum value of 40 and milliseconds (Default: 10 milliseconds).

ProxyPassword

 

specifies the password of the proxy server of the local network.

This must be set, if authentication is required through proxy or firewall.

Please note, that under LINUX Linux, the environment variable http_proxy is considered as system proxy. https_proxy is not yet supported.

ProxyPasswordSecure

 

specifies the password for authenticated access to the proxy server.

Please note, that under LINUX Linux, the environment variable http_proxy is considered as system proxy. https_proxy is not yet supported.

ProxyPort

 

specifies the port of the proxy server of the local network.

Please note, that under LINUX Linux, the environment variable http_proxy is considered as system proxy. https_proxy is not yet supported.

ProxyServer

 

specifies the name of the proxy server of the local network.

Please note, that under LINUX Linux, the environment variable http_proxy is considered as system proxy. https_proxy is not yet supported.

ProxyUser

 

specifies the user name of the proxy server of the local network.

This must be set, if authentication is required through proxy or firewall.

Please note, that under LINUX Linux, the environment variable http_proxy is considered as system proxy. https_proxy is not yet supported.

StartAlways

 

specifies whether CodeMeter License Server immediately starts without any dialog request.

Value

Description

0

CodeMeter License Server will not start immediately.

1

CodeMeter License Server will be started immediately (default).

StartDaemon

 

specifies whether CodeMeter License Server will start as daemon on start [Linux only LINUX].

Value

Description

0

CodeMeter License Server will not start as daemon on startup.

1

CodeMeter License Server will start as daemon on startup (default).

SystemStartThreshold

 

specifies the threshold value in seconds after Windows start [Windows only win8_logo].

If Windows has not been started since the specified value, the parameter StartAlways is handled in a special way (see WaitForServiceAfterSystemStart).

TimeServerTimeout

 

specifies the timeout for the time server request in seconds. The default value is 20.

TimeServerURL1, TimeServerURL2,

 

specifies the URL of the time sever to update the Certified Time in the CmContainer. The standard installer sets the following default values:

TimeServerURL1 = cmtime.codemeter.com

TimeServerURL2 = cmtime.codemeter.fr

TimeServerURL3 = cmtime.codemeter.de

TrustedWebSocketOrigins1, TrustedWebSocketOrigins2, ...

 

sets local exceptions for checking trusted WebSocket Origins.

information_grau_klein26

Supported input formats are IPv4 and IPv6 addresses and port specifications, e.g. "http://localhost:4040", "http://[2001:db8::1%25eth0]" "https://[2001:db8::1]:4040".

    TrustedWebSocketOrigins1 = null

   TrustedWebSocketOrigins2 = file://

   TrustedWebSocketOrigins3 = http://example.com

   TrustedWebSocketOrigins4 = https://example.com

   TrustedWebSocketOrigins5 = http://example.com:33

UDPCachingTime

 

specifies the waiting time in seconds after a UDP (User Datagram Protocol) request is retried.

After a UDP search in the network the servers found are stored inside CodeMeter License Server for this time. The range of the parameter is [1, 3600]. The default value is 20 seconds.

UDPWaitingTime

 

specifies the waiting time in milliseconds in order to define the period in which a UDP (User Datagram Protocol)  request for an existing CodeMeter License Server on the network has to reply.

This is the maximum time all other servers can answer to the request. The default value is 1000 milliseconds. The range of this parameter is [100, 15000].

UseMobileHandling

 

specifies whether CodeMeter can be used mobile.

If enabled, a protected application and CodeMeter License Server can be started from a mobile disk and will terminate when the last handle of a protected application was released and the protected application has terminated.

Value

Description

0

CodeMeter Mobile Handling is disabled.

1

CodeMeter Mobile Handling is enabled.

UseMobileVars

 

specifies whether CodeMeter Mobile variables are used or not.

Value

Description

0

CodeMeter Mobile variables are disabled and absolute paths remain.

1

CodeMeter Mobile variables are enabled (default).

If CodeMeter uses a local CodeMeter.ini file, the following variables will be used:

o$(CODEMETER_HOME) - contains the absolute path of CodeMeter.exe.

o$(CODEMETER_DRIVE) - contains the drive letter of the CmStick.

For example, the LogPath may be set to "$(CODEMETER_HOME)\logs".

If set to a value 0, these variables will not be inserted into CodeMeter.ini but the absolute paths remain.

UseSystemProxy

 

specifies whether CodeMeter applies the system proxy settings or not.

Please note, that under LINUX Linux, the environment variable http_proxy is considered as system proxy. https_proxy is not yet supported.

Value

Description

0

CodeMeter does not apply the system proxy settings.

1

CodeMeter applies the system proxy settings.

UseUmsDA

 

specifies whether communication between CodeMeter License Server and CmDongle is direct or file I/O based.

Value

Description

0

Communication is based on file I/O.

1

Communication is based on direct access (PassThru) (default).

information_grau_klein26

if the user starting CodeMeter License Server has no administrator privileges, then automatically file I/O applies.

WaitForServiceAfterSystemStart

 

specifies how long after system start CodeMeter.exe waits in seconds. After that, the WibuCm.dll library starts CodeMeter.exe as an application [Windows only win8_logo].

WebSocketKeepAliveTimeout

 

specifies how long a WebSocket connection is kept open in seconds even though the client is not active.

The default maximum value for such possible inactivity is 300 seconds (5 minutes).

This timeout can be changed in seconds. The minimum value is 1 second.

The value zero is not valid and the default timeout (300 seconds) is used.

MaxBorrowDuration

 

specifies the global maximum period a license is blocked by an borrowing server in minutes.

information_grau_klein26

Please note, that Prepared License Borrowing supports only Firm Codes smaller than 6,000,000.

MaxBorrowQuantity

 

specifies the global maximum number of licenses which can be borrowed from an borrowing server.

information_grau_klein26

Please note, that Prepared License Borrowing supports only Firm Codes smaller than 6,000,000.