InformixHQ Agent Configuration Parameters
A properties file is required to run the InformixHQ agent.
When starting the agent, you can pass the properties file name as part of the start command. Otherwise, the agent will look for a properties file named agent.properties in the classpath.
An example configuration file documenting the supported InformixHQ agent configuration properties can be found at $INFORMIXDIR/hq/informixhq-agent-example.properties.
- Required configuration properties
- Optional configuration properties
- dataSource.IFX_ISOLATION_LEVEL
- pool.connectionTimeout
- pool.idleTimeout
- pool.maximumPoolSize
- pool.minimumIdle
- ssl.enable
- ssl.keystore.file
- ssl.keystore.password
- target.informixdir
- target.onlinelog
- target.ping.frequency
- user.password.minLength
- user.password.requireLowerCase
- user.password.requireUpperCase
- user.password.requireNumber
- user.password.requireSpecialCharacterFromSet
informixServer.id
The id of the Informix database server in InformixHQ. You find the server’s id on the server’s Setup page in the InformixHQ UI.
server.host
The host name on which the InformixHQ server is running.
server.port
The port on which the InformixHQ server is running.
dataSource.IFX_ISOLATION_LEVEL
Specifies the isolation level to set on JDBC connections to the target and repository Informix database servers.
The default value is 1 (DIRTY READ).
pool.connectionTimeout
Specifies the number of milliseconds to wait for a JDBC connection to the target or repository Informix database server to be established before it times out. The default value is 5000 (5 seconds).
pool.idleTimeout
Specifies the number of milliseconds that a JDBC connection can be idle in the connection pool before it is closed.
The default value is 60000 (1 minute).
pool.maximumPoolSize
The maximum number of JDBC connections in each connection pool. The InformixHQ agent will maintain a connection pool for the target database server and another a connection pool for the repository database server. The pool.maximumPoolSize puts a cap on the total number of open JDBC connections that can be established to each database. The default value is 3.
pool.minimumIdle
The minimum number of idle JDBC connections in each connection pool. The InformixHQ agent will maintain a connection pool for the target database server and another a connection pool for the repository database server. Setting pool.minimumIdle to zero indicates that all JDBC connections in the connection pool should be closed when they exceed the pool.idleTimeout. Setting pool.minimumIdle to a positive integer indicates the number of connections that should be kept open in the connection pool even when they exceed the pool.idleTimeout.
The default and recommended value is 0.
ssl.enable
If ssl.enable is set to true, you must also configure the ssl.keystore.file and ssl.keystore.password configuration properties.
The default value is false.
ssl.keystore.file
The path to the keystore file that contains the certificate to use for encrypting web socket communication between the agent and the InformixHQ server. This property must be set if ssl.enable is set to true.
ssl.keystore.password
The password to unlock the keystore file for used for encrypting web socket communication between the agent and the InformixHQ server.
This property must be set if ssl.enable is set to true.
target.informixdir
Optionally, specify the directory on the local machine where Informix is installed. If left empty, the agent will query the server for the INFORMIXDIR property. This property is used by sensors that gather data from onstat or other Informix utilities
target.onlinelog
Optionally specify the path to the online.log file for the target Informix database server.
If this is left empty and the Online Log monitoring sensor is enabled for this server, the agent will lookup the online.log file path by querying the database server.
There is no default value.
target.ping.frequency
Specifies the interval, in seconds, between pings to the target database server to see if it is still online. When the agent is running, it will regularly monitor whether the target database server is online or offline. This property controls the duration between these checks.
The default value is 1, indicating to check the server status every second.
user.password.minLength
Controls the minimum length for a user password. The default value is 8.
user.password.requireLowerCase
Controls whether user passwords are required to include at least one lowercase character. The default value is true.
user.password.requireUpperCase
Controls whether user passwords are required to include at least one uppercase character. The default value is true.
user.password.requireNumber
Controls whether user passwords are required to include at least one number. The default value is true.
user.password.requireSpecialCharacterFromSet
Controls whether user passwords are required to include at least one special character. An empty string indicates that no special characters are required. Setting this value to “!@#$%^&*()" would require user passwords to include at least one of those characters. The default value is an empty string.