Server Configuration

Owned by AntonA (Unlicensed)
Last updated: Dec 03, 2022 by Yaroslav Melyn

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 are 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

The FIXICC H2 allows adding and working with several server configurations.

Adding a new FIX server configuration

Manual

  1. Go to Configurations on the sidebar (item 1 in the figure below)
  2. Click Servers (item 2 in the figure below)
  3. 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.

  4. 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+\ 

  5. Then FIXICC H2 displays the Server Editor page:

    Figure. Server Editor.
  6. 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

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

Auto server adding

To configure the auto server-adding:

  1. Set the fixicch2.unknownServer.autoRegistration property in the property file

or

  1. Go to the Administration left menu item
  2. Go to the Application properties node under the Administration
  3. Peak the fixicch2 properties set
  4. Go to the unknownServer set
  5. Click the fixicch2.unknownServer.autoRegistration property
  6. Click the Edit button
    2. Figure. The Edit form for fixicch2.unknownServer.autoRegistration property
  7. Set the Current value into true
  8. Click the OK button

or

To cancel the changes:

  1. 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

  1. Go to Configurations on the sidebar (item 1 in the figure below)
  2. Click Servers (item 2 in the figure below)
  3. 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.

  4. On the Servers page, you can choose the server configuration to remove by clicking the chosen server row in the servers list table

  5. 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

  6. 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.

IndicatorDescription

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.

 Default Filter description

The Default Filter depends on the type of objects that are shown on the current page.

To use the Default Filter, type or select a value in the Default Filter fields.
To start a search, move the focus from the completed field or press Enter.
To reset the search results:

  • Click Clear (item 1 in the figure below)

    Figure. Default Filter.

  • Or click Clear in the context menu (as shown below)

    Figure. The Clear context menu item.

Then you can see a full list of rows.

You can also use the Extended Filter for searching server information.

 Extended Filter description

The Extended Filter allows adding custom search conditions.

To add a new search condition:

  1. Click Add search condition (item 1 in the figure below)

    Figure. The Extended Filter.

  2. To specify the parameter you want to search for in the "Add condition" form, either:
    • Select it from the list
      or
    • Type the parameter name in the Filter field

      Figure. The "Add condition" form.
  3. To confirm your choice, click Select or to cancel the operation, click Cancel
  4. Select an operation type from the drop-down list according to the parameter type 

    Figure. The operations list.

To start a search:

Click Refresh (item 1 in the figure below)

Figure. The Refresh button.

To remove a filter condition:

Click x to see the full list of objects

Figure. The removing condition symbol.

To reset search results:

  • Select the <Reset Filter> from the drop-down menu in the Refresh button

    Figure. Reset Filter operation.

  • Or click Clear in the context menu 

    Figure. The Clear context menu item.

To save a filter:

  1. When you add a list of conditions, click the   button and select the save option
  2. Add the mandatory information to save the filter
  3. Click OK to confirm the changes or click Cancel to cancel the operation

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

Figure. The Notifications page with the name of the selected server.

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.