Monitoring Mode
Intro
Monitoring and admin roles enhance system security, efficiency, and accountability by assigning specific permissions and responsibilities. Monitoring users in FIXICC H2 have enhanced capabilities compared to admin users. They can add and edit servers, view sessions and logs but cannot delete the servers as well as create new roles and add users.
In this mode sessions configuration will be got from FIXEdge.properties file for FIXEdge C++ and from <sessionId>.properties files for FIXEdge Java. As for schedules, they will be read from FIXEdge.properties file for FIXEdge C++ and from schedules.xml file for FIXEdge Java. With regard to business rules, they will be used from BL_Config.xml file for FIXEdge C++ and from rules.groovy file for FIXEdge Java. As for Kafka and JMS Java sessions, they will be read from kafka-adaptor.properties and jms-adaptor.properties.
FIXEdge C++ configuration
The following lines should not be added to FIXEdge.properties if a user needs to configure FE C++ to work with FIXICC H2 in monitoring mode:
Components.Service.FIXICCH2.Host = 127.0.0.1
Components.Service.FIXICCH2.Port = 8080
Components.Service.FIXICCH2.ReconnectInterval = 1000
Components.Component.Configuration = FIXICCH2
FIXICC H2 configuration
Navigate to the FIXICC H2 installation directory.
Within the installation directory, find the folder named FIXICC H2 and the file named local.app.properties.
Add the following line to the local.app.properties file and save it
fixicch2.monitoringMode=true
Configuring a New User
By default, when H2 is installed, the only user is the administrator. Therefore, it is necessary to configure an additional user with permissions limited to monitoring only. The admin user should:
Navigate to Administration section
Select “Users” and “Create”.
A window will appear prompting you to set a login and password. Fill in this information.
Once done, it is required to proceed to the "Roles" section and click "Add."
From the list, choose the "FIXICCH2 Monitoring" role. This will grant the user the necessary permissions
” Monitoring” User Permissions
Monitoring users can view and manage server information. They can add and update server details when accessing "Servers" > "Show all servers". However, they cannot delete servers.
Adding a Server (for non-Consul mode only)
To add a server, click "Add" and complete the required fields. Server details can be changed by clicking the "Edit" button.
Working with sessions
Monitoring users can view, start, and stop sessions and watch the logs. They can also modify the sequence number, send arbitrary messages, heartbeats, and test requests, or resend requests. However, adding, editing, or deleting sessions is restricted.
Business rules
Monitoring users can access and reload business rules.
Business rules command will send a request to server and show back the content of BL_Config.xml.
The file is currently not editable. The user can only monitor it
The "Business Rules" button provides access to the contents of the BL_Config.xml file, which serves as the configuration file for FIXEdge. It is important to note that this screen does not reflect the currently active business rules within FIXEdge. Instead, it displays the content of the BL_Config.xml file. The user can edit the file from the server and apply the made changes on the runtime by clicking on the “Reload business rules” command. In that case the updated rules, not the original configuration will be used by FE in runtime.