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 client mode
- FIXEdge Java machine:
- Consul agent in client mode
- On the network:
- Client workstations:
- Chrome browser
Before you start work 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.
For production use - please refer to the Consul documentation.
To control the FIX connections with the FIXICC H2, you should install and configure the FIX engine application.
The first version of FIXICC H2 communicates with FIXEdge Java.
For detailed instructions on installation and configuration FIXEdge Java please follow the link.
Also, you should set the additional configurations for FIXEdge Java:
|rest.service.name||REST-AdminAPI||The name of REST service, if it is empty or disabled, REST service will not be available and registered in Service Discovery|
|rest.service.port||9010||The name of REST port, if it is empty or disabled, REST service will not be available and registered in Service Discovery|
|rest.ssl.cert.path||/ssl/cert.pem||The path to the SSL certificate, should not be empty to create REST service and register it in Discovery|
|rest.ssl.key.path||/ssl/key.pem||The path to the SSL key, should not be empty to create REST service and register it in Discovery|
|server.name||ServerA||The name of the server, if it is not empty, the server will be registered in Discovery by this name. Otherwise, it will not be registered.|
|protocol.name||FIX||The name of the protocol, used for server registration in Consul|
|service.discovery.healthcheck.interval||10||Health check interval (Service Discovery)|
|service.discovery.attempt.period||10000||Service Discovery attempt period, milliseconds|
|fixicch2.url||Fixicch2 REST API to load fix session configs and to subscribe on session changes|
|server.useFixicch2ConfigManager||true||Allows to choose the sessionConfigManager and scheduleConfigManager (original or fixxicch2)|
After the FIXEdge Java configuration is completed and FIXEdge Java is started, the Consul application will add "REST-AdminAPI" and "FIX" services for the "ServerA" server to the service list.
You can see the example in the figure below:
Figure. The list of the configured services.
To run Consul UI, open browser page with address:
The FIXICC H2 can have access to the configured services.
FIXICC H2 settings
You should choose a directory on your workstation for FIXICC H2 files.
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.
Before you start your work, please pick the database type for data storage.
FIXICC H2 is compatible with Oracle or PostgreSQL databases.
Please configure the FIXICC H2 according to the instance of the local.app.properties in your FIXICC H2 package, set the following properties:
|Type of the RDBMS, one of: |
The value indicates that the data source must be configured using application properties.
|The user name for the database|
|The password for the database|
|The database name|
|Host for the database|
|Port for the database|
To configure FIXICC H2 in Service Discovery you should add the
You should start the FIXICC H2 from the command line with the following command:
- "/opt/fixicch2-home" is the directory with the local.app.properties file, you should type full path for the file;
- "/opt/fixicch2/" is the directory with the app.jar file, you should type the full path for the file.