Server Configuration (for FIXEdge C++)
- 1 Consul Monitoring
- 2 Server Configuration
- 2.1 Adding a new FIX server configuration
- 2.1.1 Manual
- 2.1.2 Auto server adding
- 2.2 Removing an existing FIX server configuration
- 2.3 Monitoring
- 2.3.1 Servers page
- 2.3.1.1 Server health
- 2.3.1.2 Filtering
- 2.3.2 Server Details page
- 2.3.1 Servers page
- 2.1 Adding a new FIX server configuration
Consul Monitoring
Please note that the FIXICC H2 monitors the current state of the Consul application. If the Consul is not available at the moment, a warning banner appears at the top of the application screen, (see example below).
When the Consul application doesn't work operationally, the FIXICC H2 can't guarantee the true health state of the servers. Thus, the list and status of the sessions that is displayed can differ from the actual list and statuses.
The warning banner is displayed on the screens below:
Figure. The banner when the Consul is unavailable.
Figure. The Servers page when the Consul is unavailable.
Server Configuration
FIXICC H2 allows adding and working with several server configurations.
Adding a new FIX server configuration
Manual
Go to Configurations on the sidebar (item 1 in the figure below)
Click Servers (item 2 in the figure below)
To see the list of added server configurations, click Show all servers (item 3 in the figure below)
The following application tab appears:Figure. The Servers page.
Add a new server configuration by picking one of the following options:
Click Add in the top panel (item 4 in the figure above)
Click Add in the context menu (item 5 in the figure above)
Press Ctrl+\
Then FIXICC H2 displays the Server Editor page:
Figure. Server Editor.To complete the server configuration, set the following mandatory parameters (below)
Name - any unique value describing the server being added
Type - FIXEdge Cpp is a preconfigured value and cannot be changed on the fly
After specifying all the details, you have the following options:
Click OK to create the server configuration
If the mandatory parameter is specified and the server name is unique, the FIXICC H2 displays the Servers page with the servers list including the new server configuration
If the mandatory parameter is empty, the FIXICC H2 displays the following alert form:
Figure. The alert form appears if the server name is empty.If the server name is not unique, the FIXICC H2 displays the following error form:
When you close this warning form, the FIXICC H2 displays the Server editor page again to change the server name
Click Cancel to cancel creating the server configuration. The FIXICC H2 displays the Servers page without changes.
Leave the page. In this case, the new server configuration won't be added. If you edit the server parameters and leave the page, the FIXICC H2 displays the following warning form:
Figure. The warning form.
The options are as follows:Skip the changes by clicking Don't save. The servers list won't be changed.
Stay on the Server Editor page by clicking Cancel button. The FIXICC H2 displays the Server Editor page to continue the editing.
Save the entered values as a new server configuration. You should complete filling the form to save the server configuration. An incomplete configuration won't be saved.
Optionally. Depends on BL configuration settings, with a new server configuration, the default business layer configuration is added to the FIXICC H2 database
Figure. The default business rules configuration.
Auto server adding
To configure the auto server-adding:
Set the
fixicch2.unknownServer.autoRegistrationproperty in the property file
or
Go to the Administration left menu item
Go to the Application properties node under the Administration
Peak the fixicch2 properties set
Go to the unknownServer set
Click the
fixicch2.unknownServer.autoRegistrationpropertyClick the Edit button
Figure. The Edit form for
fixicch2.unknownServer.autoRegistrationproperty
Set the Current value into true
Click the OK button
or
To cancel the changes:
Click the Cancel button.
Now, when the configured FIXEdge C++ server connects to FIXICC H2 a new server configuration will be added to the FIXICC H2 database.
A new server configuration will be saved to the FIXICC H2 database with configured name and type.
In case the server type of the connecting server doesn't match with the existing server configuration, FIXICC H2 will display the notification and refuse the connection
Go to Configurations on the sidebar (item 1 in the figure below)
Click Servers (item 2 in the figure below)
To see the list of added server configurations, click Show all servers (item 3 in the figure below)
The following application tab appears:Figure. The Servers page.
On the Servers page, you can choose the server configuration to remove by clicking the chosen server row in the servers list table
Select one of the following options to remove the server configuration:
Click Remove in the top panel (item 4 in the figure above)
Choose Remove(Ctrl+Del) in the context menu (item 5 in the figure above)
Remove the server configuration by pressing Ctrl+Del on your keyboard
The FIXICC H2 displays the following confirmation window:
Figure. Confirmation window.
You have two options:To confirm the removing server configuration by clicking Yes. The FIXICC H2 displays the Servers page without the removed server configuration.
The sessions that were created for the removing server configuration are disconnected and stopped then deleted too.
The schedules that were configured for the removed server are deleted.
or
To cancel the removing server configuration by clicking No. The FIXICC H2 displays the Servers page without changes.
Monitoring
Servers page
Server health
You can monitor the server's dynamic health state on the Servers page.
Select Servers in the menu bar on the left side and click Show all servers item.
The FIXICC H2 displays the server's monitoring layout.
The servers table is shown in the Table view.
You can monitor the current state of the server on the Servers page.
Figure. The Servers page.
The first column of the table contains the server health indicator.
You can easily detect the server health according to the list:
Table. The server health indicator.
Indicator | Description |
|---|---|
the server is running | |
the server is stopped | |
the server is misbehaving |
Filtering
You have the ability to filter the server list by using the Default Filter.
You can filter servers by Name, Type, or both.
You can also use the Extended Filter for searching server information.
Server Details page
To see the details and metrics of a server in the Object info layout part, click the server in the servers table in the Table view layout part.
The FIXICC H2 displays the Server Details page in the Object info layout part.
The Server Details page contains the server health state, server metrics, and the drop-down menu that contains the operations.
Figure. Server details in the Object info layout part.
To open the Server Details page in a single tab:
Click View in the tab (item 1 in the figure above) in the Object info layout part
orGo from the Server sessions page by clicking View server details in the figure below in the Table view layout part
Figure. The View server details button on the Server Sessions page.
or
Go from the Server schedules page by clicking View server details in the figure below from the Table view layout part
Figure. The View server details button on the Server Schedules page.
or
Go from the Notifications page by clicking the desired server's name
Figure. The Notifications page with the name of the selected server.
or
Go from the Notification Details page by clicking the Event Source:
Figure. The Notification Details page.
Now you can see the server's detailed info in the single tab.
Figure. The Server Details page.
On the Server Details page, you have access to the server FIX logs, server BL configurations, and Remove server operation.