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).
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
The 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 Create in the top panel (item 4 in the figure above)
- Click Create 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 Java is a preconfigured value and cannot be changed on the fly
After specifying all the details, use one of 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 server's list won't be changed.
- Stay on the Server Editor page by clicking the 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 out the form to save the server configuration. An incomplete configuration won't be saved.
- Click OKÂ to create the server configuration
Auto server adding
To configure the auto server-adding:
- Set the
fixicch2.unknownServer.autoRegistration
property 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.autoRegistration
property - Click the Edit button
- Figure. The Edit form for
fixicch2.unknownServer.autoRegistration
property
- Set the Current value into true
- Click the OK button
or
To cancel the changes:
- Click the Cancel button.
Now, when the configured FIXEdge Java 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 the existing server configuration, FIXICC H2 will display the notification and refuse the connection
Removing an existing FIX server configuration
- 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 server configuration that's being removed are disconnected and stopped, and 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 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
or - Go from the Server sessions page by clicking View server details (item 1 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 (item 1 in the figure below) in 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
Now you can see the server's detailed info in a single tab.
Figure. The Server Details page.
On the Server Details page, you have access to the server FIX logs and Remove server operation.