datacenter.properties file

The datacenter.properties file defines Global Mailbox properties that apply to all nodes on the local data center. The Mailbox configuration properties are the combination of three different property files: the global system properties (global.properties), the local data center properties (datacenter.properties), and the local node properties (mailbox.properties).

Usage

One datacenter.properties file is required for each local data center. Each data center has its own config_root. Properties defined in the datacenter.properties file override the same properties defined in the global.properties file.

Edit the properties file with a text editor.

File location

The global system properties and the local data center properties are stored on a directory tree on a shared file system that must accessible by all nodes (Sterling B2B Integrator clients and Global Mailbox Admin servers) in the same data center. The full path is:<config_root>/datacenter.properties

Where config_root is the path to a directory on a shared file system that designates the start of the configuration tree (for example: /DMShare/config). The path to the config_root directory is specified by the individual Mailbox nodes through a property in their local mailbox.properties file (com.ibm.mailbox.config.root.path). This property is initially set by the installation program.

Environment

Linux®, UNIX, and Windows

Authorization

Only users with administrative permissions can edit the datacenter.properties file.

Syntax

parmname=value

Option descriptions

com.ibm.mailbox.allow.eventrule.management.during.failure: When set to true, this allows event rule management operations (via REST APIs, import/export utilities, and Global Mailbox administration UI) to be performed even when other data centers are not operational or they are inaccessible. Default value is false.

com.ibm.mailbox.database.cassandra.host.<n>: The IP address or host name of each additional Cassandra server that is configured in the cluster. Each Cassandra node in the cluster is represented by a unique integer value, <n>, for example, 2. Default is (none).

com.ibm.mailbox.database.cassandra.host.1: The host name or IP address of first Cassandra server. Default value is the localhost.

com.ibm.mailbox.database.cassandra.jmx.port: JMX port number for Cassandra. Default JMX port is 7199.

com.ibm.mailbox.database.cassandra.native.transport.port: Native port number for Cassandra. Default Native port is 9042.

com.ibm.mailbox.database.cassandra.rpc.port: RPC port number for Cassandra. Default RPC port is 9160.

com.ibm.mailbox.database.cassandra.ssl.ciphers: The list of cipher suites to use to communicate with servers when SSL is enabled. Default value is TLS_RSA_WITH_AES_128_CBC_SHA.
Restriction: Must be set by running the dbConfigUtility setSSL command.

com.ibm.mailbox.database.cassandra.ssl.enabled: Whether to secure client-to-node communications with SSL. Default value is false.
Restriction: Must be set by running the dbConfigUtility setSSL command.

com.ibm.mailbox.database.cassandra.ssl.protocol: The security protocol to use to communicate with servers when SSL is enabled. Default value is TLS.
Restriction: Must be set by running the dbConfigUtility setSSL command.

com.ibm.mailbox.database.cassandra.ssl.trust.any: Whether the client can trust any certificate presented by the server. Default value is true.
Restriction: Must be set by running the dbConfigUtility setSSL command.

com.ibm.mailbox.database.cassandra.ssl.truststore.file: The fully-qualified path of the trust store file containing the list of server certificates that the client will trust when trust any is disabled. Default value is (none).
Restriction: Must be set by running the dbConfigUtility setSSL command.

com.ibm.mailbox.database.cassandra.ssl.truststore.type: The type (for example: PKCS12, JKS) of the trust store file. Default value is (none).
Restriction: Must be set by running the dbConfigUtility setSSL command.

com.ibm.mailbox.database.cassandra.ssl.truststore.password: The password of the trust store file. Default value is (none).
Restriction: Must be set by running the dbConfigUtility setSSL command.

com.ibm.mailbox.database.zookeeper.conn.<n>: More zookeeper contact points. N=2,3,4, an so on. Default value is none.

com.ibm.mailbox.database.zookeeper.conn.1: ZooKeeper contact point consisting of host:port. Default value is (none).
Tip: This is slightly different than the Cassandra property.

com.ibm.mailbox.database.zookeeper.connection.timeout: ZooKeeper connection timeout indicated in seconds. Default value is 15 seconds.

com.ibm.mailbox.local.datacenter.id: The UUID of the local data center. Default value is (none).

com.ibm.mailbox.local.datacenter.name: The name of the local data center. The local data center name must match the name of a data center that is specified in your Global Mailbox system topology configuration.

com.ibm.mailbox.messaging.event.notification.enabled: Whether event notifications are enabled. If enabled, individual applications can override. Default value is true.

com.ibm.mailbox.replication.barrier.maxwaittime: The maximum time in milliseconds to wait for an immediate (synchronous) replication request to complete. Default value is 1800 milliseconds.

com.ibm.mailbox.replication.encrypt: Defines the encryption status for the connection between replication servers. Valid values are true and false. The default value is true.

com.ibm.mailbox.replication.hang.threshold: If a replication request remains in IN_PROGRESS state for the specified time (in seconds), the request is considered hung, and moved to PENDING status. Requests in PENDING status are retried, when the replication polling agent runs again. If a replication request failed because the replication server became non-functional in the middle of a transfer, the incomplete file is overwritten when the next replication request starts. Valid range for hang threshold is 1 - 9999 seconds.

com.ibm.mailbox.replication.impl: Custom exit point implementation for IReplicationConfiguration interface. Default value is null.

com.ibm.mailbox.replication.monitor.interval: Time in seconds that the system checks for hung replication requests. Default value is 60 seconds.

com.ibm.mailbox.replication.polling.interval: Time in seconds that the system checks for pending replication requests. Default value is 1 second.

com.ibm.mailbox.replication.polling.threads: The number of threads that run the replication polling task. Default value is 4 threads.

com.ibm.mailbox.replication.queue.depth: The maximum number of replication requests that can be queued for a single replication server connection. The value of this property multiplied by the value of the com.ibm.mailbox.replication.server.max.sessions property is the number of PENDING replication request records that is read from the database each time the replication polling task is run. Default value is 10 replication requests.

com.ibm.mailbox.replication.segment.size: The minimum MB size limit which is used to segment a payload for faster replication. Default value is 100 MB.

com.ibm.mailbox.replication.server.max.consecutive.failures: The number of times the polling agent tries to reach a replication server. If consecutive attempts to reach the replication server fails, the server is marked offline. Valid range for maximum consecutive failures is 1 - 99999.

com.ibm.mailbox.replication.server.max.sessions: The maximum number of sessions on a replication server. Default value is 10 sessions.

com.ibm.mailbox.replication.server.offline.time: The time (in minutes) for which a replication server is marked offline after consecutive connection failures. Valid range for server offline time is 1 - 99999 minutes.

com.ibm.mailbox.replication.type

The type of replication. Valid values are:

asynchronous - delayed (default)
synchronous - immediate

com.ibm.mailbox.storage.async.thread.max: The maximum number of threads to be used for asynchronous requests in storage. Default value is 10 threads.

com.ibm.mailbox.event.scan.query.buckets: Number of buckets to scan for unprocessed events for resending. Default value is 60 (one hour worth of events, which at a load of 100 events/sec writes 360,000 events in a bucket). Increasing this value might cause time outs or excessive tombstones to accumulate.

Example

The following code is a example datacenter.properties file as it is created during the installation. The required properties are defined with default values. The UUID and data center name values are set based on information entered during your installation.

com.ibm.mailbox.local.datacenter.id=cf5fxx97-fd11-4cxy-a1be-155e6yy8c7d8
com.ibm.mailbox.local.datacenter.name=MY DATA CENTER
com.ibm.mailbox.replication.barrier.maxwaittime=300
com.ibm.mailbox.replication.encrypt=true
com.ibm.mailbox.replication.hang.threshold=300
com.ibm.mailbox.replication.monitor.interval=60
com.ibm.mailbox.replication.polling.interval=1
com.ibm.mailbox.replication.server.max.consecutive.failures=3
com.ibm.mailbox.replication.server.offline.time=5
com.ibm.mailbox.replication.type=ASYNCHRONOUS