Data grid properties file
The data grid properties file enables each node and member to access the data grid for system configuration information.
The data grid properties file is the SystemConfigurationXSLoader.properties file in the install_dir\Members\resources directory.
The data grid properties provide each node and member with connection information for the data grid. This grid stores configuration information for AS4 Microservice. The grid stores the same information as the database and makes that information more quickly accessible to the components. You can use the grid to configure a new node to have the same configuration as existing nodes.
When you are adding a node to your installation of AS4 Microservice, you can directly import this file as part of the configuration of the new node.
The data grid properties are generated in one of the following ways when you run the Installation Manager:
- In production installations, from data that is entered on the Data grid configuration page.
- In proof of concept installations, in a pre-configured file.
| Property | Description |
|---|---|
| catalog.#.host | The host name or the IP address for the node on which the catalog server is located. |
| catalog.#.listenPort | The port the catalog server uses to listen to the message fabric. |
| catalog.#.serverName | The name of the catalog server. |
| catalog.#.clientPort | The catalog server client port. |
| catalog.#.peerPort | The catalog server peer port. |
| gridParm.transportType | The protocol that is used for grid communications. The value
is always TCP/IP. |
| gridParm.securityEnabled | Indicates whether security is enabled and a user name and
password are needed to access the grid. The following values are valid:
|
| gridParm.secureTokenManagerType | The only valid value is autoSecret. Future
versions of AS4 Microservice might support more values. |
| gridParm.authenticationSecret | Only used if gridParm.secureTokenManagerType is set to autoSecret. |
| gridUser | The user name for accessing the grid when security is enabled
(gridParm.securityEnabled=true). |
| gridPassword | The password for accessing the grid when security is enabled
(gridParm.securityEnabled=true). |
Example of a data grid properties file
This code is an example of a data grid properties file for a cluster that has three catalog servers:
# Provide sets of entries for each catalog server that will be deployed as part of this collective
# Remove extra sets of entries if this collective is not going to deploy at least 3 catalog servers
# Update to provide the hostname or IP address of the first appliance that will contain a catalog server
catalog.0.host=localhost
catalog.0.listenPort=2809
# When prompted for member name of the catalog server on the host listed two lines up this value must be provided
catalog.0.serverName=MEG_CS
catalog.0.clientPort=4400
catalog.0.peerPort=4500
# Update to provide the hostname or IP address of the first appliance that will contain a catalog server
catalog.1.host=192.168.130.51
catalog.1.listenPort=2809
# When prompted for member name of the catalog server on the host listed two lines up this value must be providedcatalog.1.serverName=MEG_CS2
catalog.1.clientPort=4400
catalog.1.peerPort=4500
# Update to provide the hostname or IP address of the second appliance that will contain a catalog server
catalog.2.host=megova3.ibm.com
catalog.2.listenPort=2809
# When prompted for member name of the catalog server on the host listed two lines up this value must be provided
catalog.2.serverName=MEG_CS2
catalog.2.clientPort=4400
catalog.2.peerPort=4500
# Collective wide grid configuration:
gridParm.transportType=TCP/IP
gridParm.securityEnabled=true
gridParm.secureTokenManagerType=autoSecret
# Update to provide your own secret value that the grid servers should use to
# authenticate the other grid servers as part of this collective
gridParm.authenticationSecret=sampleSecret
# Update to provide a username and password that must be created on each
# appliance that is running a catalog or container member (use the
# "user add <user>" command from the appliance console on each of these
# appliances).
# The grid clients will authenticate to the grid servers using this username
# and password.
gridUser=user456
gridPassword=password456