| Table of Contents |
|---|
Environment requirements
Hardware
Physical A physical or virtual server with:
- 2 core CPU
- 2Gb RAM
- 40G storage
...
- FIXICC H2 machine:
- RHEL 7 / RHEL 8
- OpenJDK 1.8
- Consul agent in the client mode
- FIXEdge Cpp machine:
- Consul agent in the client mode
- On the network:
- PostgreSQL Database
- 1 user with DDL privileges (to run the database migration, can also be used to run the normal FIXICC H2 operation)
- (Optional) 1 user without DDL privileges (to run the normal FIXICC H2 operation)
- Consul cluster (can be deployed on the same machines as FIXEdge Cpp or FIXICC H2)
- PostgreSQL Database
- Client workstations:
- Chrome browser
Preconfiguration
Before you start work working with the FIXICC H2, you should install and configure the FIX engine and Consul application.
...
To find the Consul installation instructions, please follow the link.
For non-production use, you can run Consul in developer mode with the command: consul agent -dev.
...
You have your FIXICC H2 instance in the app.jar file and to . To complete the configuration, please create the local.app.properties file.
You can place the app.jar file for the FIXICC H2 application and local.app.properties (FIXICC H2 properties file) in the same directory, or store them separately.
...
| Name | Example value | Default Value | Description |
|---|---|---|---|
*cuba.dbmsType | postgres |
| Type of the RDBMS |
cuba.dataSourceProvider | application |
| The value indicates that the data source must be configured using application properties |
*cuba.dataSource.username | C##CUBA |
| The user name for the database |
*cuba.dataSource.password | cuba |
| The password for the database |
*cuba.dataSource.dbName | PTGSDB |
| The database name |
*cuba.dataSource.host | 10.68.21.182 |
| Host for the database |
*cuba.dataSource.port | 1521 |
| Port for the database |
| true |
| The property enables the use of HTTPS |
| 8501 |
| The number of the port, configured for Consul |
| false |
| Allows accepting Consul insecure certificate. Is not recommended to set "true" in the production mode |
fixicch2.fixServerType | FIXEdge CPP | all | Configures the type of the server to work with. Allowed values: FIXEdge CPP, FIXEdge Java, any other value means two types of the supported servers. |
* - marks the mandatory parameter | |||
...
| Name | Example value | Default Value | Description |
|---|---|---|---|
fixicch2.fixServerType | FIXEdge CPP | all | Configures the type of the server to work with. Allowed values: FIXEdge CPP, FIXEdge Java, any other value means two types of the supported servers. |
fixicch2.maxTimeToWaitServerStatusUpdate | 10 | 10 | Configures in minutes the max time slot for updating the server status from Consul. If there were no events during the period, then the Consul sends the response. The maximum value is a 10 minutes. |
fixicch2.metricsUpdatePeriod | 1 | 1 | Configures in seconds the period for request the metrics from FIXEdge |
fixicch2.mode | production | production | Marks the instance of FIXICC H2 |
fixicch2.notificationTimeZone | UTC | UTC | Specifies the time zone to display the time of the notification |
fixicch2.pauseToReconnect | 2000 | 2000 | Specifies the pause between the reconnection attempts |
...
To enable HTTPS support on FIXICC H2, you need:
- Key and trust stores with TLS certificate and private key. Please refer to the
keytooldocumentation for the details on generating key stores - keytool. - Jetty configuration file with enabled HTTPS.
- Launch FIXICC H2 with an explicit path to the Jetty configuration:
java -Dapp.home=/path/to/fixicch2-home -jar /path/to/app.jar -jettyConfPath /path/to/jetty.xml
...