conf/settings.cfg

The conf/settings.cfg file contains general global settings that are used across a cluster. These setting are managed under the System > Global Settings section of the Admin Server UI or by using functions under the GlobalSettings section of the SOAP API and CLI.

Key

Description

admin!honor_fallback_scsv

Whether or not the admin server, the internal control port and the config daemon honor the Fallback SCSV to protect connections against downgrade attacks.

Value type: Yes / No

Default value: "Yes"

admin!insert_extra_fragment

Whether or not admin server SSL3 and TLS1 use one-byte fragments as a BEAST countermeasure for admin server and internal connections.

Value type: Yes / No

Default value: "No"

admin!ssl3_allow_rehandshake

Whether or not SSL3/TLS re-handshakes should be supported for admin server and internal connections.

Value type: enumeration

Default value: "rfc5746"

Permitted values:

always: Always allow

safe: Allow safe re-handshakes

rfc5746: Only if client uses RFC 5746 (Secure Renegotiation Extension)

never: Never allow

admin!ssl3_ciphers

The SSL ciphers to use for admin server and internal connections. For information on supported ciphers see the online help.

Value type: string

Default value: <none>

admin!ssl3_diffie_hellman_key_length

The length in bits of the Diffie-Hellman key for ciphers that use Diffie-Hellman key agreement for admin server and internal connections.

Value type: enumeration

Default value: "2048"

Permitted values:

1024: 1024

2048: 2048

3072: 3072

4096: 4096

admin!ssl3_min_rehandshake_interval

If SSL3/TLS re-handshakes are supported on the admin server, this defines the minimum time interval (in milliseconds) between handshakes on a single SSL3/TLS connection that is permitted. To disable the minimum interval for handshakes the key should be set to the value 0.

Value type: unsigned integer

Default value: "1000"

admin!ssl_elliptic_curves

The SSL elliptic curve preference list for admin and internal connections. For information on supported curves see the online help.

Value type: string

Default value: <none>

admin!ssl_max_handshake_message_size

The maximum size (in bytes) of SSL handshake messages that the admin server and internal connections will accept. To accept any size of handshake message the key should be set to the value 0.

Value type: bytes

Default value: "10240"

admin!ssl_prevent_timing_side_channels

This configuration is now obsolete and has no effect whether set or unset.

Value type: Yes / No

Default value: "No"

admin!ssl_signature_algorithms

The SSL signature algorithms preference list for admin and internal connections. For information on supported algorithms see the online help.

Value type: string

Default value: <none>

admin!support_ssl3

Whether or not SSL3 support is enabled for admin server and internal connections.

Value type: Yes / No

Default value: "No"

admin!support_tls1

Whether or not TLS1.0 support is enabled for admin server and internal connections.

Value type: Yes / No

Default value: "Yes"

admin!support_tls1_1

Whether or not TLS1.1 support is enabled for admin server and internal connections.

Value type: Yes / No

Default value: "Yes"

admin!support_tls1_2

Whether or not TLS1.2 support is enabled for admin server and internal connections.

Value type: Yes / No

Default value: "Yes"

admin!support_tls1_3

Whether or not TLS1.3 support is enabled for admin server and internal connections.

Value type: Yes / No

Default value: "Yes"

afm_enabled

Is the application firewall enabled.

Value type: Yes / No

Default value: "No"

allow_consecutive_chars

Whether or not to allow the same character to appear consecutively in passwords.

Value type: Yes / No

Default value: "Yes"

appliance!bootloader_password

The password used to protect the bootloader. An empty string means there will be no protection.

Value type: password

Default value: <none>

appliance!return_path_routing_enabled

Whether or not the traffic manager will attempt to route response packets back to clients via the same route on which the corresponding request arrived.

Note that this applies only to the last hop of the route - the behaviour of upstream routers cannot be altered by the traffic manager.

Value type: Yes / No

Default value: "No"

appliance!returnpath!*!ipv4

The MAC address/network interface to IPv4 address mapping of a router the software is connected to. The value is the IPv4 address, the * (asterisk) in the key name is the MAC address and an optional network interface name, for example, 00:50:56:a6:24:3d or 00:50:56:a6:24:3d#eth0.

Value type: string

Default value: <none>

appliance!returnpath!*!ipv6

The MAC address/network interface to IPv6 address mapping of a router the software is connected to. The value is the IPv6 address, the * (asterisk) in the key name is the MAC address and an optional network interface name, for example, 00:50:56:a6:24:3d or 00:50:56:a6:24:3d#eth0.

Value type: string

Default value: <none>

aptimizer!max_dependent_fetch_size

The maximum size of a dependent resource that can undergo Web Accelerator optimization. Any content larger than this size will not be optimized. Units of KB and MB can be used, no postfix denotes bytes. A value of 0 disables the limit.

Value type: string

Default value: "2MB"

aptimizer!max_original_content_buffer_size

The maximum size of unoptimized content buffered in the traffic manager for a single backend response that is undergoing Web Accelerator optimization. Responses larger than this will not be optimized. Note that if the backend response is compressed then this setting pertains to the compressed size, before Web Accelerator decompresses it. Units of KB and MB can be used, no postfix denotes bytes. Value range is 1 - 128MB.

Value type: string

Default value: "2MB"

aptimizer!watchdog_interval

The period of time (in seconds) after which a previous failure will no longer count towards the watchdog limit.

Value type: seconds

Default value: "300"

aptimizer!watchdog_limit

The maximum number of times the Web Accelerator sub-process will be started or restarted within the interval defined by the aptimizer!watchdog_interval setting. If the process fails this many times, it must be restarted manually from the Diagnose page. Zero means no limit.

Value type: unsigned integer

Default value: "3"

asp_cache_size

The maximum number of entries in the ASP session persistence cache. This is used for storing session mappings for ASP session persistence. Approximately 100 bytes will be pre-allocated per entry.

Value type: unsigned integer

Default value: "32768"

auditlog!via_eventd

Whether to mirror the audit log to EventD.

Value type: Yes / No

Default value: "No"

auditlog!via_syslog

Whether to output audit log message to the syslog.

Value type: Yes / No

Default value: "No"

auth!saml!key_lifetime

Lifetime in seconds of cryptographic keys used to decrypt SAML SP sessions stored externally (client-side).

Value type: seconds

Default value: "86400"

auth!saml!key_rotation_interval

Rotation interval in seconds for cryptographic keys used to encrypt SAML SP sessions stored externally (client-side).

Value type: seconds

Default value: "14400"

autoscaler!verbose

Whether or not detailed messages about the autoscaler's activity are written to the error log.

Value type: Yes / No

Default value: "No"

banner_accept

Whether or not users must explicitly agree to the displayed login_banner text before logging in to the Admin Server.

Value type: Yes / No

Default value: "No"

bgp!as_number

The number of the BGP AS in which the traffic manager will operate. Must be entered in decimal.

Value type: unsigned integer

Default value: "65534"

bgp!enabled

Whether BGP Route Health Injection is enabled

Value type: Yes / No

Default value: "No"

chunk_size

The default chunk size for reading/writing requests.

Value type: bytes

Default value: "16384"

client_first_opt

Whether or not your traffic manager should make use of TCP optimisations to defer the processing of new client-first connections until the client has sent some data.

Value type: Yes / No

Default value: "No"

cluster_identifier

Cluster identifier. Generally supplied by Services Director.

Value type: string

Default value: <none>

control!canupdate!default

The default value of control!canupdate for new cluster members. If you have cluster members joining from less trusted locations (such as cloud instances) this can be set to No in order to make them effectively "read-only" cluster members.

Value type: Yes / No

Default value: "Yes"

controlallow

The hosts that can contact the internal administration port on each traffic manager. This should be a list containing IP addresses, CIDR IP subnets, and localhost; or it can be set to all to allow any host to connect.

Value type: string

Default value: "all"

dns!max_ttl

Maximum Time To Live (expiry time) for entries in the DNS cache.

Value type: seconds

Default value: "86400"

dns!min_ttl

Minimum Time To Live (expiry time) for entries in the DNS cache.

Value type: seconds

Default value: "86400"

dns!negative_expiry

Expiry time for failed lookups in the DNS cache.

Value type: seconds

Default value: "60"

dns!size

Maximum number of entries in the DNS cache.

Value type: unsigned integer

Default value: "10867"

dns!timeout

Timeout for receiving a response from a DNS server.

Value type: seconds

Default value: "12"

ec2!access_key_id

Deprecated: This key is unused. Amazon authentication credentials are now extracted from IAM Roles assigned to an EC2 instance.

Value type: string

Default value: <none>

ec2!awstool_timeout

The maximum amount of time requests to the AWS Query API can take before timing out.

Value type: unsigned integer

Default value: "10"

ec2!metadata_server

URL for the EC2 metadata server, http://169.254.169.254/latest/meta-data for example.

Value type: string

Default value: <none>

ec2!query_server

URL for the Amazon EC2 endpoint, https://ec2.amazonaws.com/ for example.

Value type: string

Default value: <none>

ec2!secret_access_key

Deprecated: This key is unused. Amazon authentication credentials are now extracted from IAM Roles assigned to an EC2 instance.

Value type: password

Default value: <none>

ec2!verify_query_server_cert

Whether to verify Amazon EC2 endpoint's certificate using CA(s) present in SSL Certificate Authorities Catalog.

Value type: Yes / No

Default value: "No"

errlevel

The minimum severity of events/alerts that should be logged to disk. ERR_INFO will log all events; a higher severity setting will log fewer events. More fine-grained control can be achieved using events and actions in the Alerting section of the UI.

Value type: enumeration

Default value: "6"

Permitted values:

1: ERR_FATAL

2: ERR_SERIOUS

5: ERR_WARN

6: ERR_INFO

errlog

The file to log event messages to.

Value type: string

Default value: "%zeushome%/zxtm/log/errors"

fips!enabled

Enable FIPS Mode (requires software restart).

Value type: Yes / No

Default value: "No"

flipper!arp_count

The number of ARP packets a traffic manager should send when an IP address is raised.

Value type: unsigned integer

Default value: "10"

flipper!autofailback

Whether or not traffic IPs automatically move back to machines that have recovered from a failure and have dropped their traffic IPs.

Value type: Yes / No

Default value: "Yes"

flipper!autofailback_delay

Configure the delay of automatic failback after a previous failover event. This setting has no effect if autofailback is disabled.

Value type: seconds

Default value: "10"

flipper!child_timeout

How long the traffic manager should wait for status updates from any of the traffic manager's child processes before assuming one of them is no longer servicing traffic.

Value type: seconds

Default value: "5"

flipper!frontend_check_addrs

The IP addresses used to check front-end connectivity. The text %gateway% will be replaced with the default gateway on each system. Set this to an empty string if the traffic manager is on an Intranet with no external connectivity.

Value type: list

Default value: "%gateway%"

flipper!heartbeat_method

The method traffic managers should use to exchange cluster heartbeat messages.

Value type: enumeration

Default value: "unicast"

Permitted values:

multicast: multicast

unicast: unicast

flipper!igmp_interval

The interval between unsolicited periodic IGMP Membership Report messages for Multi-Hosted Traffic IP Groups.

Value type: seconds

Default value: "30"

flipper!monitor_interval

The frequency, in milliseconds, that each traffic manager machine should check and announce its connectivity.

Value type: unsigned integer

Default value: "500"

flipper!monitor_timeout

How long, in seconds, each traffic manager should wait for a response from its connectivity tests or from other traffic manager machines before registering a failure.

Value type: seconds

Default value: "5"

flipper!multicast_address

The multicast address and port to use to exchange cluster heartbeat messages.

Requires: flipper!heartbeat_method is set to "multicast"

Value type: string

Default value: "239.100.1.1:9090"

flipper!unicast_port

The unicast UDP port to use to exchange cluster heartbeat messages.

Requires: flipper!heartbeat_method is set to "unicast"

Value type: unsigned integer

Default value: "9090"

flipper!use_bindip

Whether or not cluster heartbeat messages should only be sent and received over the management network.

Value type: Yes / No

Default value: "No"

flipper!verbose

Whether or not a traffic manager should log all connectivity tests. This is very verbose, and should only be used for diagnostic purposes.

Value type: Yes / No

Default value: "No"

ftp_data_bind_low

Whether or not the traffic manager should permit use of FTP data connection source ports lower than 1024. If No the traffic manager can completely drop root privileges, if Yes some or all privileges may be retained in order to bind to low ports.

Value type: Yes / No

Default value: "No"

gslb!verbose

Write a message to the logs for every DNS query that is load balanced, showing the source IP address and the chosen datacenter.

Value type: Yes / No

Default value: "No"

idle_connection_timeout

How long an unused HTTP keepalive connection should be kept before it is discarded.

Value type: seconds

Default value: "10"

ip_cache_expiry

IP session persistence cache expiry time in seconds. A session will not be reused if the time since it was last used exceeds this value. 0 indicates no expiry timeout.

Value type: unsigned integer

Default value: "0"

ip_cache_size

The maximum number of entries in the IP session persistence cache. This is used to provide session persistence based on the source IP address. Approximately 100 bytes will be pre-allocated per entry.

Value type: unsigned integer

Default value: "32768"

j2ee_cache_expiry

J2EE session persistence cache expiry time in seconds. A session will not be reused if the time since it was last used exceeds this value. 0 indicates no expiry timeout.

Value type: unsigned integer

Default value: "0"

j2ee_cache_size

The maximum number of entries in the J2EE session persistence cache. This is used for storing session mappings for J2EE session persistence. Approximately 100 bytes will be pre-allocated per entry.

Value type: unsigned integer

Default value: "32768"

java!classpath

CLASSPATH to use when starting the Java runner.

Value type: string

Default value: <none>

java!command

Java command to use when starting the Java runner, including any additional options.

Value type: string

Default value: "java -server"

java!enabled

Whether or not Java support should be enabled. If this is set to No, then your traffic manager will not start any Java processes. Java support is only required if you are using the TrafficScript java.run() function.

Value type: Yes / No

Default value: "No"

java!lib

Java library directory for additional jar files. The Java runner will load classes from any .jar files stored in this directory, as well as the * jar files and classes stored in traffic manager's catalog.

Value type: string

Default value: <none>

java!max_conns

Maximum number of simultaneous Java requests. If there are more than this many requests, then further requests will be queued until the earlier requests are completed. This setting is per-CPU, so if your traffic manager is running on a machine with 4 CPU cores, then each core can make this many requests at one time.

Value type: unsigned integer

Default value: "256"

java!session_age

Default time to keep a Java session.

Value type: seconds

Default value: "86400"

kerberos!verbose

Whether or not a traffic manager should log all Kerberos related activity. This is very verbose, and should only be used for diagnostic purposes.

Value type: Yes / No

Default value: "No"

license_servers

A list of license servers for FLA licensing. A license server should be specified as a <ip/host>:<port> pair.

Value type: list

Default value: <none>

listen_queue_size

The listen queue size for managing incoming connections. It may be necessary to increase the System's listen queue size if this value is altered. If the value is set to 0 then the default system setting will be used.

Value type: unsigned integer

Default value: "0"

load_change_limit

The maximum change to load per second, when monitored by GLB. This limit does not apply to external setting of the load by a SOAP agent.

Value type: unsigned integer

Default value: "800"

log!flushtime

How long to wait before flushing the request log files for each virtual server.

Value type: seconds

Default value: "5"

log!rate

The maximum number of connection errors logged per second when connection error reporting is enabled.

Value type: unsigned integer

Default value: "50"

log!reopen

How long to wait before re-opening request log files, this ensures that log files will be recreated in the case of log rotation.

Value type: seconds

Default value: "30"

log!time

The minimum time between log messages for log intensive features such as SLM.

Value type: seconds

Default value: "60"

log_export!auth!hec_token

The HTTP Event Collector token to use for HTTP authentication with a Splunk server.

Value type: string

Default value: <none>

log_export!auth!http

The HTTP authentication method to use when exporting log entries.

Value type: enumeration

Default value: "none"

Permitted values:

none: None

basic: Basic (Username and Password)

splunk: Splunk (HEC token)

log_export!auth!password

The password to use for HTTP basic authentication.

Value type: password

Default value: <none>

log_export!auth!username

The username to use for HTTP basic authentication.

Value type: string

Default value: <none>

log_export!enabled

Monitor log files and export entries to the configured endpoint.

Value type: Yes / No

Default value: "No"

log_export!endpoint

The URL to which log entries should be sent. Entries are sent using HTTP(S) POST requests.

Value type: string

Default value: <none>

log_export!request_timeout

The number of seconds after which HTTP requests sent to the configured endpoint will be considered to have failed if no response is received. A value of 0 means that HTTP requests will not time out.

Value type: seconds

Default value: "30"

log_export!tls_verify

Whether the server certificate should be verified when connecting to the endpoint. If enabled, server certificates that do not match the server name, are self-signed, have expired, have been revoked, or that are signed by an unknown CA will be rejected.

Value type: Yes / No

Default value: "Yes"

login_banner

Banner text displayed on the Admin Server login page and before logging in to appliance SSH servers.

Value type: string

Default value: <none>

login_delay

The number of seconds before another login attempt can be made after a failed attempt.

Value type: seconds

Default value: "4"

max_idle_connections

The maximum number of unused HTTP keepalive connections with back-end nodes that the traffic manager should maintain for re-use. Setting this to 0 (zero) will cause the traffic manager to auto-size this parameter based on the available number of file-descriptors.

Value type: unsigned integer

Default value: "0"

max_login_attempts

The number of sequential failed login attempts that will cause a user account to be suspended. Setting this to 0 disables this feature. To apply this to users who have never successfully logged in, track_unknown_users must also be enabled.

Value type: unsigned integer

Default value: "0"

max_login_external

Whether or not usernames blocked due to the max_login_attempts limit should also be blocked from authentication against external services (such as LDAP and RADIUS).

Value type: Yes / No

Default value: "No"

max_login_suspension_time

The number of minutes to suspend users who have exceeded the max_login_attempts limit.

Value type: unsigned integer

Default value: "15"

max_tcp_buff_mem

The maximum amount of memory allowed to be used to buffer network data in user space for all TCP connections. The TCP data buffered are either received from clients but before sending to pool nodes, or recevied from pool nodes but before sending to clients. This is specified as either a percentage of system RAM, 5% for example, or an absolute size such as 1024MB and 2GB. A numeric value without suffix MB, GB or % defaults to MB. A value of 800 means 800MB. A value of 0 means unlimited.

Value type: string

Default value: "0"

maxfds

The maximum number of file descriptors that your traffic manager will allocate.

Value type: unsigned integer

Default value: "1048576"

min_alpha_chars

Minimum number of alphabetic characters a password must contain. Set to 0 to disable this restriction.

Value type: unsigned integer

Default value: "0"

min_numeric_chars

Minimum number of numeric characters a password must contain. Set to 0 to disable this restriction.

Value type: unsigned integer

Default value: "0"

min_password_length

Minimum number of characters a password must contain. Set to 0 to disable this restriction.

Value type: unsigned integer

Default value: "0"

min_special_chars

Minimum number of special (non-alphanumeric) characters a password must contain. Set to 0 to disable this restriction.

Value type: unsigned integer

Default value: "0"

min_uppercase_chars

Minimum number of uppercase characters a password must contain. Set to 0 to disable this restriction.

Value type: unsigned integer

Default value: "0"

monitor_memory_size

The maximum number of each of nodes, pools or locations that can be monitored. The memory used to store information about nodes, pools and locations is allocated at start-up, so the traffic manager must be restarted after changing this setting.

Value type: unsigned integer

Default value: "4096"

multiple_accept

Whether or not the traffic manager should try to read multiple new connections each time a new client connects. This can improve performance under some very specific conditions. However, in general it is recommended that this be set to 'No'.

Value type: Yes / No

Default value: "No"

notify!mail_interval

The minimum length of time that must elapse between alert emails being sent. Where multiple alerts occur inside this timeframe, they will be retained and sent within a single email rather than separately.

Value type: seconds

Default value: "30"

notify!max_attempts

The number of times to attempt to send an alert email before giving up.

Value type: unsigned integer

Default value: "10"

ospfv2!area

The OSPF area in which the traffic manager will operate. May be entered in decimal or IPv4 address format.

Value type: string

Default value: "0.0.0.1"

ospfv2!area_type

The type of OSPF area in which the traffic manager will operate. This must be the same for all routers in the area, as required by OSPF.

Value type: enumeration

Default value: "normal"

Permitted values:

normal: Normal area

stub: Stub area

nssa: Not So Stubby Area (RFC3101)

ospfv2!authentication_key_id_a

OSPFv2 authentication key ID. If set to 0, which is the default value, the key is disabled.

Value type: unsigned integer

Default value: "0"

ospfv2!authentication_key_id_b

OSPFv2 authentication key ID. If set to 0, which is the default value, the key is disabled.

Value type: unsigned integer

Default value: "0"

ospfv2!authentication_shared_secret_a

OSPFv2 authentication shared secret (MD5). If set to blank, which is the default value, the key is disabled.

Value type: string

Default value: <none>

ospfv2!authentication_shared_secret_b

OSPFv2 authentication shared secret (MD5). If set to blank, which is the default value, the key is disabled.

Value type: string

Default value: <none>

ospfv2!dead_interval

The number of seconds before declaring a silent router down.

Value type: seconds

Default value: "40"

ospfv2!enabled

Whether OSPFv2 Route Health Injection is enabled

Value type: Yes / No

Default value: "No"

ospfv2!hello_interval

The interval at which OSPF "hello" packets are sent to the network.

Value type: seconds

Default value: "10"

password_changes_per_day

The maximum number of times a password can be changed in a 24-hour period. Set to 0 to disable this restriction.

Value type: unsigned integer

Default value: "0"

password_reuse_after

The number of times a password must have been changed before it can be reused. Set to 0 to disable this restriction.

Value type: unsigned integer

Default value: "0"

post_login_banner

Banner text to be displayed on the appliance console after login.

Value type: string

Default value: <none>

protection!conncount_size

The amount of shared memory reserved for an inter-process table of combined connection counts, used by all Service Protection classes that have per_process_connection_count set to No. The amount is specified as an absolute size, eg 20MB.

Value type: string

Default value: "20MB"

rate_class_limit

The maximum number of Rate classes that can be created. Approximately 100 bytes will be pre-allocated per Rate class.

Value type: unsigned integer

Default value: "25000"

recent_conns

How many recently closed connections each traffic manager process should save. These saved connections will be shown alongside currently active connections when viewing the Connections page. You should set this value to 0 in a benchmarking or performance-critical environment.

Value type: unsigned integer

Default value: "500"

recent_conns_retain_time

The amount of time for which snapshots will be retained on the Connections page.

Value type: seconds

Default value: "60"

recent_conns_snapshot_size

The maximum number of connections each traffic manager process should show when viewing a snapshot on the Connections page. This value includes both currently active connections and saved connections. If set to 0 all active and saved connection will be displayed on the Connections page.

Value type: unsigned integer

Default value: "500"

remote_licensing!comm_channel_enabled

Whether to create a Communications Channel agent to send and receive messages from the Services Director Registration Server. This will be disabled when performing self-registration with a Services Director which does not support this feature.

Value type: Yes / No

Default value: "Yes"

remote_licensing!comm_channel_port

The port number the Services Director instance is using for access to the traffic manager Communications Channel.

Value type: unsigned integer

Default value: "8102"

remote_licensing!owner

The Owner of a Services Director instance, used for self-registration.

Value type: string

Default value: <none>

remote_licensing!owner_secret

The secret associated with the Owner.

Value type: string

Default value: <none>

remote_licensing!policy_id

The auto-accept Policy ID that this instance should attempt to use.

Value type: string

Default value: <none>

remote_licensing!registration_server

A Services Director address for self-registration. A registration server should be specified as a <ip/host>:<port> pair.

Value type: string

Default value: <none>

remote_licensing!server_certificate

The certificate of a Services Director instance, used for self-registration.

Value type: string

Default value: <none>

rest!auth_timeout

The length of time after a successful request that the authentication of a given username and password will be cached for an IP address. A setting of 0 disables the cache forcing every REST request to be authenticated which will adversely affect performance.

Value type: seconds

Default value: "120"

rest!enabled

Whether or not the REST service is enabled.

Value type: Yes / No

Default value: "Yes"

rest!max_http_header_len

The maximum allowed length in bytes of a HTTP request's headers.

Value type: unsigned integer

Default value: "4096"

rest!maxfds

Maximum number of file descriptors that the REST API will allocate. The REST API must be restarted for a change to this setting to take effect.

Value type: unsigned integer

Default value: "1048576"

rest!repabstime

Configuration changes will be replicated across the cluster after this period of time, regardless of whether additional API requests are being made.

Value type: seconds

Default value: "20"

rest!replulltime

Configuration changes made via the REST API will be propagated across the cluster when no further API requests have been made for this period of time.

Value type: seconds

Default value: "5"

rest!reptimeout

The period of time after which configuration replication across the cluster will be cancelled if it has not completed.

Value type: seconds

Default value: "10"

shared_pool_size

The size of the shared memory pool used for shared storage across worker processes (e.g. bandwidth shared data).This is specified as either a percentage of system RAM, 5% for example, or an absolute size such as 10MB.

Value type: string

Default value: "10MB"

slm_class_limit

The maximum number of SLM classes that can be created. Approximately 100 bytes will be pre-allocated per SLM class.

Value type: unsigned integer

Default value: "1024"

snmp_user_counters

The number of user defined SNMP counters. Approximately 100 bytes will be pre-allocated at start-up per user defined SNMP counter.

Value type: unsigned integer

Default value: "10"

so_rbuff_size

The size of the operating system's read buffer. A value of 0 (zero) means to use the OS default; in normal circumstances this is what should be used.

Value type: bytes

Default value: "0"

so_wbuff_size

The size of the operating system's write buffer. A value of 0 (zero) means to use the OS default; in normal circumstances this is what should be used.

Value type: bytes

Default value: "0"

soap!idle_minutes

The number of minutes that the SOAP server should remain idle before exiting. The SOAP server has a short startup delay the first time a SOAP request is made, subsequent SOAP requests don't have this delay.

Value type: unsigned integer

Default value: "10"

socket_opt

Whether or not the traffic manager should use potential network socket optimisations. If set to auto, a decision will be made based on the host platform.

Value type: enumeration

Default value: "auto"

Permitted values:

auto: auto

Yes: Yes

No: No

ssl!allow_rehandshake

Whether or not SSL/TLS re-handshakes should be supported. Enabling support for re-handshakes can expose services to Man-in-the-Middle attacks. It is recommended that only "safe" handshakes be permitted, or none at all.

Value type: enumeration

Default value: "safe"

Permitted values:

always: Always allow

safe: Allow safe re-handshakes

rfc5746: Only if client uses RFC 5746 (Secure Renegotiation Extension)

never: Never allow

ssl!cache!enabled

Whether or not the SSL server session cache is enabled, unless overridden by virtual server settings.

Value type: Yes / No

Default value: "Yes"

ssl!cache!expiry

How long the SSL session IDs for SSL decryption should be stored for.

Value type: seconds

Default value: "1800"

ssl!cache!per_virtualserver

Whether an SSL session created by a given virtual server can only be resumed by a connection to the same virtual server.

Value type: Yes / No

Default value: "Yes"

ssl!cache!size

How many entries the SSL session ID cache should hold. This cache is used to cache SSL sessions to help speed up SSL handshakes when performing SSL decryption. Each entry will allocate approximately 1.75kB of metadata.

Value type: unsigned integer

Default value: "6151"

ssl!cipher_suites

The SSL/TLS cipher suites preference list for SSL/TLS connections, unless overridden by virtual server or pool settings. For information on supported cipher suites see the online help.

Value type: string

Default value: <none>

ssl!client_cache!enabled

Whether or the SSL client cache will be used, unless overridden by pool settings.

Value type: Yes / No

Default value: "Yes"

ssl!client_cache!expiry

How long in seconds SSL sessions should be stored in the client cache for, by default. Servers returning session tickets may also provide a lifetime hint, which will be used if it is less than this value.

Value type: seconds

Default value: "14400"

ssl!client_cache!size

How many entries the SSL client session cache should hold, per child. This cache is used to cache SSL sessions to help speed up SSL handshakes when performing SSL encryption. Each entry will require approx 100 bytes of memory plus space for either an SSL session id or an SSL session ticket, which may be as small as 16 bytes or may be as large as a few kilobytes, depending upon the server behavior.

Value type: unsigned integer

Default value: "1024"

ssl!client_cache!tickets_enabled

Whether or not session tickets, including TLS >= 1.3 PSKs, may be requested and stored in the SSL client cache.

Value type: Yes / No

Default value: "Yes"

ssl!crl_mem!size

How much shared memory to allocate for loading Certificate Revocation Lists. This should be at least 3 times the total size of all CRLs on disk. This is specified as either a percentage of system RAM, 1% for example, or an absolute size such as 10MB.

Value type: string

Default value: "5MB"

ssl!diffie_hellman_modulus_size

The size in bits of the modulus for the domain parameters used for cipher suites that use finite field Diffie-Hellman key agreement.

Value type: enumeration

Default value: "2048"

Permitted values:

1024: 1024

2048: 2048

3072: 3072

4096: 4096

ssl!elliptic_curves

The SSL/TLS elliptic curve preference list for SSL/TLS connections using TLS version 1.0 or higher, unless overridden by virtual server or pool settings. For information on supported curves see the online help.

Value type: string

Default value: <none>

ssl!honor_fallback_scsv

Whether or not ssl-decrypting Virtual Servers honor the Fallback SCSV to protect connections against downgrade attacks.

Value type: Yes / No

Default value: "Yes"

ssl!insert_extra_fragment

Whether or not SSL3 and TLS1 use one-byte fragments as a BEAST countermeasure.

Value type: Yes / No

Default value: "No"

ssl!log_keys

Whether SSL connection key logging should be available via the ssl.sslkeylogline() TrafficScript function. If this setting is disabled then ssl.sslkeylogline() will always return the empty string.

Value type: Yes / No

Default value: "No"

ssl!max_handshake_message_size

The maximum size (in bytes) of SSL handshake messages that SSL connections will accept. To accept any size of handshake message the key should be set to the value 0.

Value type: bytes

Default value: "10240"

ssl!middlebox_compatibility

Whether or not TLS 1.3 middlebox compatibility mode as described in RFC 8446 appendix D.4 will be used in connections to pool nodes, unless overridden by pool settings.

Value type: Yes / No

Default value: "Yes"

ssl!min_rehandshake_interval

If SSL3/TLS re-handshakes are supported, this defines the minimum time interval (in milliseconds) between handshakes on a single SSL3/TLS connection that is permitted. To disable the minimum interval for handshakes the key should be set to the value 0.

Value type: unsigned integer

Default value: "1000"

ssl!ocsp_cache!size

The maximum number of cached client certificate OCSP results stored. This cache is used to speed up OCSP checks against client certificates by caching results. Approximately 1040 bytes are pre-allocated per entry.

Value type: unsigned integer

Default value: "2048"

ssl!ocsp_stapling!default_refresh_interval

How long to wait before refreshing requests on behalf of the store of certificate status responses used by OCSP stapling, if we don't have an up-to-date OCSP response.

Value type: seconds

Default value: "60"

ssl!ocsp_stapling!maximum_refresh_interval

Maximum time to wait before refreshing requests on behalf of the store of certificate status responses used by OCSP stapling. (0 means no maximum.)

Value type: seconds

Default value: "864000"

ssl!ocsp_stapling!mem_size

How much shared memory to allocate for the store of certificate status responses for OCSP stapling. This should be at least 2kB times the number of certificates configured to use OCSP stapling. This is specified as either a percentage of system RAM, 1% for example, or an absolute size such as 10MB.

Value type: string

Default value: "1MB"

ssl!ocsp_stapling!time_tolerance

How many seconds to allow the current time to be outside the validity time of an OCSP response before considering it invalid.

Value type: seconds

Default value: "30"

ssl!ocsp_stapling!verify_response

Whether the OCSP response signature should be verified before the OCSP response is cached.

Value type: Yes / No

Default value: "No"

ssl!prevent_timing_side_channels

This configuration is now obsolete and has no effect whether set or unset.

Value type: Yes / No

Default value: "No"

ssl!signature_algorithms

The SSL/TLS signature algorithms preference list for SSL/TLS connections using TLS version 1.2 or higher, unless overridden by virtual server or pool settings. For information on supported algorithms see the online help.

Value type: string

Default value: <none>

ssl!support_ssl3

Whether or not SSL3 support is enabled.

Requires: fips!enabled is set to "Yes"

Value type: Yes / No

Default value: "No"

ssl!support_tls1

Whether or not TLS1.0 support is enabled.

Value type: Yes / No

Default value: "Yes"

ssl!support_tls1_1

Whether or not TLS1.1 support is enabled.

Value type: Yes / No

Default value: "Yes"

ssl!support_tls1_2

Whether or not TLS1.2 support is enabled.

Value type: Yes / No

Default value: "Yes"

ssl!support_tls1_3

Whether or not TLS1.3 support is enabled.

Value type: Yes / No

Default value: "Yes"

ssl!tickets!enabled

Whether or not session tickets will be issued to and accepted from clients that support them, unless overridden by virtual server settings.

Value type: Yes / No

Default value: "Yes"

ssl!tickets!reissue_policy

When an SSL session ticket will be reissued (ie when a new ticket will be generated for the same SSL session).

Value type: enumeration

Default value: "never"

Permitted values:

always: always

never: never

ssl!tickets!ticket_expiry

The length of time for which an SSL session ticket will be accepted by a virtual server after the ticket is created. If a ticket is reissued (if ssl!tickets!reissue_policy is set to 'always') this time starts at the time when the ticket was reissued.

Value type: seconds

Default value: "14400"

ssl!tickets!ticket_key_expiry

The length of time for which an auto-generated SSL ticket key will be used to decrypt old session ticket, before being deleted from memory. This setting is ignored if there are any entries in the (REST-only) SSL ticket keys catalog.

Value type: seconds

Default value: "86400"

ssl!tickets!ticket_key_rotation

The length of time for which an auto-generated SSL ticket key will be used to encrypt new session tickets, before a new SSL ticket key is generated. The ticket encryption key will be held in memory for ssl!tickets!ticket_key_expiry, so that tickets encrypted using the key can still be decrypted and used. This setting is ignored if there are any entries in the (REST-only) SSL ticket keys catalog.

Value type: seconds

Default value: "14400"

ssl!tickets!time_tolerance

How many seconds to allow the current time to be outside the validity time of an SSL ticket before considering it invalid.

Value type: seconds

Default value: "30"

ssl!validate_server_certificates_catalog

Whether the traffic manager should validate that SSL server certificates form a matching key pair before the certificate gets used on an SSL decrypting virtual server.

Value type: Yes / No

Default value: "Yes"

ssl_cache_size

The maximum number of entries in the SSL session persistence cache. This is used to provide session persistence based on the SSL session ID. Approximately 200 bytes will be pre-allocated per entry.

Value type: unsigned integer

Default value: "32768"

ssld!accel

Whether or not the SSL hardware is an "accelerator" (faster than software). By default the traffic manager will only use the SSL hardware if a key requires it (i.e. the key is stored on secure hardware and the traffic manager only has a placeholder/identifier key). With this option enabled, your traffic manager will instead try to use hardware for all SSL decrypts.

Value type: Yes / No

Default value: "No"

ssld!azure!client_id

The client identifier used when accessing the Microsoft Azure Key Vault.

Value type: string

Default value: <none>

ssld!azure!client_secret

The client secret used when accessing the Microsoft Azure Key Vault.

Value type: password

Default value: <none>

ssld!azure!vault_url

The URL for the REST API of the Microsoft Azure Key Vault.

Value type: string

Default value: <none>

ssld!azure!verify_rest_api_cert

Whether or not the Azure Key Vault REST API certificate should be verified.

Value type: Yes / No

Default value: "Yes"

ssld!driver!pkcs11_debug

Print verbose information about the PKCS11 hardware security module to the event log.

Value type: Yes / No

Default value: "No"

ssld!driver!pkcs11_lib

The location of the PKCS#11 library for your SSL hardware if it is not in a standard location. The traffic manager will search the standard locations by default.

Value type: string

Default value: <none>

ssld!driver!pkcs11_slot_desc

The label of the SSL Hardware slot to use. Only required if you have multiple HW accelerator slots.

Value type: string

Default value: <none>

ssld!driver!pkcs11_slot_type

The type of SSL hardware slot to use.

Value type: enumeration

Default value: "operator"

Permitted values:

operator: Operator Card Set

softcard: Soft Card

module: Module Protected

ssld!driver!pkcs11_user_pin

The User PIN for the PKCS token (PKCS#11 devices only).

Value type: password

Default value: <none>

ssld!failure_count

The number of consecutive failures from the SSL hardware that will be tolerated before the traffic manager assumes its session with the device is invalid and tries to log in again. This is necessary when the device reboots following a power failure.

Value type: unsigned integer

Default value: "5"

ssld!library

The type of SSL hardware to use. The drivers for the SSL hardware should be installed and accessible to the traffic manager software.

Value type: enumeration

Default value: "none"

Permitted values:

none: None

pkcs11: PKCS#11

azure: Microsoft Azure Key Vault

statd!days

Number of days to store historical traffic information, if set to 0 the data will be kept indefinitely.

Value type: unsigned integer

Default value: "90"

state_sync_time

How often to propagate the session persistence and bandwidth information to other traffic managers in the same cluster. Set this to 0 (zero) to disable propagation.

Note that a cluster using "unicast" heartbeat messages cannot turn off these messages.

Value type: seconds

Default value: "3"

state_sync_timeout

The maximum amount of time to wait when propagating session persistence and bandwidth information to other traffic managers in the same cluster. Once this timeout is hit the transfer is aborted and a new connection created.

Value type: seconds

Default value: "6"

telemetry!enabled

Allow the reporting of anonymized usage data for product improvement and customer support purposes.

Value type: Yes / No

Default value: "Yes"

tip_class_limit

The maximum number of Traffic IP Groups that can be created.

Value type: unsigned integer

Default value: "10000"

track_unknown_users

Whether to remember past login attempts from usernames that are not known to exist (should be set to No for an Admin Server accessible from the public Internet). This does not affect the audit log.

Value type: Yes / No

Default value: "No"

trafficscript!data_local_size

The maximum amount of memory available to store TrafficScript data.local.set() information. This can be specified as a percentage of system RAM, 5% for example; or an absolute size such as 200MB.

Value type: string

Default value: "5%"

trafficscript!data_size

The maximum amount of memory available to store TrafficScript data.set() information. This can be specified as a percentage of system RAM, 5% for example; or an absolute size such as 200MB.

Value type: string

Default value: "5%"

trafficscript!execution_time_warning

Raise an event if a TrafficScript rule runs for more than this number of milliseconds in a single invocation. If you get such events repeatedly, you may want to consider re-working some of your TrafficScript rules. A value of 0 means no warnings will be issued.

Value type: unsigned integer

Default value: "500"

trafficscript!max_instr

The maximum number of instructions a TrafficScript rule will run. A rule will be aborted if it runs more than this number of instructions without yielding, preventing infinite loops.

Value type: unsigned integer

Default value: "100000"

trafficscript!memory_warning

Raise an event if a TrafficScript rule requires more than this amount of buffered network data. If you get such events repeatedly, you may want to consider re-working some of your TrafficScript rules to use less memory or to stream the data that they process rather than storing it all in memory. This setting also limits the amount of data that can be returned by request.GetLine().

Value type: bytes

Default value: "1048576"

trafficscript!regex_cache_size

The maximum number of regular expressions to cache in TrafficScript. Regular expressions will be compiled in order to speed up their use in the future.

Value type: unsigned integer

Default value: "57"

trafficscript!regex_match_limit

The maximum number of ways TrafficScript will attempt to match a regular expression at each position in the subject string, before it aborts the rule and reports a TrafficScript error.

Value type: unsigned integer

Default value: "10000000"

trafficscript!regex_match_warn_perc

The percentage of trafficscript!regex_match_limit at which TrafficScript reports a performance warning.

Value type: unsigned integer

Default value: "5"

trafficscript!variable_pool_use

Allow the pool.use and pool.select TrafficScript functions to accept variables instead of requiring literal strings.

Enabling this feature has the following effects:

Your traffic manager may no longer be able to know whether a pool is in use.

Errors for pools that aren't in use will not be hidden.

Some settings displayed for a Pool may not be appropriate for the type of traffic being managed.

Pool usage information on the pool edit pages and config summary may not be accurate.

Monitors will run for all pools (with this option disabled monitors will only run for Pools that are used).

Value type: Yes / No

Default value: "No"

transaction_export!enabled

Export metadata about transactions processed by the traffic manager to an external location.

Value type: Yes / No

Default value: "No"

transaction_export!endpoint

The endpoint to which transaction metadata should be exported. The endpoint is specified as a hostname or IP address with a port.

Value type: string

Default value: <none>

transaction_export!tls

Whether the connection to the specified endpoint should be encrypted.

Value type: Yes / No

Default value: "Yes"

transaction_export!tls_verify

Whether the server certificate presented by the endpoint should be verified, preventing a connection from being established if the certificate does not match the server name, is self-signed, is expired, is revoked, or has an unknown CA.

Value type: Yes / No

Default value: "Yes"

udp_read_multiple

Whether or not the traffic manager should try to read multiple UDP packets from clients each time the kernel reports data received from clients. This can improve performance for the situation with high UDP traffic throughput from clients to the traffic manager. Therefore, in general it is recommended that this be set to 'Yes'.

Value type: Yes / No

Default value: "Yes"

uipage_banner

Banner text to be displayed on all Admin Server pages.

Value type: string

Default value: <none>

universal_cache_expiry

Universal session persistence cache expiry time in seconds. A session will not be reused if the time since it was last used exceeds this value. 0 indicates no expiry timeout.

Value type: unsigned integer

Default value: "0"

universal_cache_size

The maximum number of entries in the global universal session persistence cache. This is used for storing session mappings for universal session persistence. Approximately 100 bytes will be pre-allocated per entry.

Value type: unsigned integer

Default value: "32768"

watchdog!timeout

The maximum time in seconds a process can fail to update its heartbeat, before the watchdog considers it to have stalled.

Value type: seconds

Default value: "5"

webcache!avg_path_length

The estimated average length of the path (including query string) for resources being cached. An amount of memory equal to this figure multiplied by max_file_num will be allocated for storing the paths for cache entries. This setting can be increased if your web site makes extensive use of long URLs.

Value type: unsigned integer

Default value: "512"

webcache!disk

Whether or not to use a disk-backed (typically SSD) cache. If set to Yes cached web pages will be stored in a file on disk. This enables the traffic manager to use a cache that is larger than available RAM. The webcache!size setting should also be adjusted to select a suitable maximum size based on your disk space.

Note that the disk caching is optimized for use with SSD storage.

Value type: Yes / No

Default value: "No"

webcache!disk_dir

If disk caching is enabled, this sets the directory where the disk cache file will be stored. The traffic manager will create a file called webcache.data in this location.

Note that the disk caching is optimized for use with SSD storage.

Value type: string

Default value: "%zeushome%/zxtm/internal"

webcache!max_file_num

Maximum number of entries in the cache. Approximately 0.9 KB will be pre-allocated per entry for metadata, this is in addition to the memory reserved for the content cache and for storing the paths of the cached resources.

Value type: unsigned integer

Default value: "10000"

webcache!max_file_size

Largest size of a cacheable object in the cache. This is specified as either a percentage of the total cache size, 2% for example, or an absolute size such as 20MB.

Value type: string

Default value: "2%"

webcache!max_path_length

The maximum length of the path (including query string) for the resource being cached. If the path exceeds this length then it will not be added to the cache.

Value type: unsigned integer

Default value: "2048"

webcache!normalize_query

Enable normalization (lexical ordering of the parameter-assignments) of the query string.

Value type: Yes / No

Default value: "Yes"

webcache!size

The maximum size of the HTTP web page cache. This is specified as either a percentage of system RAM, 20% for example, or an absolute size such as 200MB.

Value type: string

Default value: "20%"

webcache!verbose

Add an X-Cache-Info header to every HTTP response, showing whether the request and/or the response was cacheable.

Value type: Yes / No

Default value: "No"