Network Mode Server Configuration Items

The available server configuration items for Network mode and their default values are listed in the following table.

NOTE   Thales recommends leaving configuration items at the their default value or setting them to a valid value specified in the following table. If the value of a configuration item must be changed and no valid values are given, contact Thales Customer Support for assistance.

For more information about using configuration items see Configuration Items.

Configuration Item Meaning
ET_HSM_NETSERVER_OLD_WORKER_COUNT

Number of threads to reserve for processing old ProtectToolkit-C remote client connections.

Default: 3

ET_HSM_NETSERVER_V2_WORKER_COUNT

Number of worker threads, per HSM, to reserve for processing new net client connections.

Default: 10

ET_HSM_NETSERVER_READ_TIMEOUT_SECS

Number of seconds before a connection is timed out in a read operation.

Default: 30

ET_HSM_NETSERVER_WRITE_TIMEOUT_SECS

Number of seconds before a connection is timed out in a write operation.

Default: 30

ET_HSM_NETSERVER_CONN_TIMEOUT_COUNT

Number of inactivity timeouts on a connection that would cause the connection to be closed by the server. Each inactivity timeout period is 60 seconds.

Default: 3

ET_HSM_NETSERVER_FRAG_SIZE

The threshold value, in number of bytes, where output buffers are coalesced together before being sent via TCP. Servers with fast CPUs can keep this number high, and servers with slow CPUs need to keep this number low for best performance. This is an integer configuration item.

Default: 5000

ET_HSM_NETSERVER_ALLOW_RESET

Whether the server will allow the reset command to be issued or not. This is a string configuration item with the following valid values:

>Always: Always allow reset

>Never: Never allow reset

>OnHalt (default): Allow reset only when the HSM is not in normal mode

ET_HSM_NETSERVER_PORT

TCP port number to use.

Default=12396

ET_HSM_NETSERVER_LOG_CHANNEL

Channel (destination) to write log entries to. Values are platform-dependent.

For Windows, valid values are:

>0 (default): Windows Event Log

>1: Standard out

>2: Standard error

For Unix, valid values are from 0 to 7 inclusive, and map to syslog LOG_LOCAL# values.

Default=0

ET_HSM_NETSERVER_LOG_NAME

Name of application/context to associate with log entries.
Default=etnetserver

ET_HSM_NETSERVER_LOG_LEVEL

Amount of tracing to generate.

Valid values are:

>0(default): Startup and Errors

>1: Startup + errors + client connections