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

 

  1. Navigate to the FIXICC H2 installation directory. 

  2. 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”. 

Screenshot 2024-08-09 182458.png
  • 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."
     

    Screenshot 2024-08-09 182734.png
  • 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.