Export/Import Server Configuration (for FIXEdge C++)

Export/Import Server Configuration (for FIXEdge C++)

Export/Import server configuration

FIXICC H2 provides availabilities of:

  • Exporting the server configuration in a ZIP archive
  • Importing the previously exported server configuration on a specified server
  • Importing a legacy server configuration on a specified server

Access to importing, exporting, and migrating server configuration is provided via the Configurations dropdown on the Server details view 

The Dropdown contains the following items:

  • Business Layer Configuration
  • Business Layer Scripts
  • Export Server Configuration
  • Import Server Configuration
  • Migrate Server Configuration

Export Server Configuration

To export the configuration of the selected server, click on the "Export configuration" menu item.

If your browser is configured to download files to the pre-defined location, the ZIP archive named <server_name>_configuration.zip will be downloaded automatically and the file name appears in the downloads section at the bottom of the screen.

Otherwise, the system dialog "Save As" appears.

Specify the desired location, change the name if required, and click the button "Save".

The downloaded ZIP archive contains the following items:

TitleTypeContent description

BL_configuration

folder
  • files <component_name>.json (one file per component)

schedules

folder
  • file schedules.properties with sessions' schedules in form of CRON expressions
  • file schedules.json with the list of sessions' schedules in JSON format

scripts

folder
  • files with Java Scripts
  • JSON files for each .js file
sessionsfolder
  • file FIXEdge.properties with the legacy FIX sessions
  • file sessions.json with the list of FIX sessions stored in the FIXICC H2 database
BL_Config.xmlfileXML file with BL rules, DLL handlers, Histories, and event handlers

This file can be imported to the FIXEdge server of the same type as described in the next section.

Import Server Configuration

To import the configuration, click on the "Import Configuration" menu item.

The dialog "Upload the file" appears.

You can drag the appropriate ZIP file and drop it in the specified area, or click on the button "Upload" to open the system dialog "Open".

Loading


Loading


Loading
Loading
Loading
Loading

Migrate Legacy FIX Sessions

FIXICC H2 imports the legacy sessions specified in the FIXEdge.properties file.

As the FIXEdge.properties file contains registered FIX session properties and the default session properties, the FIX session properties are merged with default session properties before importing: the default property is used when the registered session does not have it.

The sessions specified in the file FIXEdge.properties are to be imported to the FIXICC H2 DB as follows:

Loading

In case the FIXEdge.properties file within the ZIP file is invalid:

Loading

Migrate Legacy Business Layer Configuration

FIXICC H2 imports the legacy FE BL configuration specified in the BL_Config.xml file.

In case the BL component with the <component_name> name already exists, then the duplicated component is saved under the name copy of <component_name> in FIXICC H2 DB.

Although, the BL components in the BL_Config.xml file can have no name attributes. The unnamed BL components will be saved in FIXICC H2 DB under the generated names in <component_type>-UUID format (Generated name example: Rule-0d5de170-8a75-11ec-a8a3-0242ac120002).

If a BL component has an inline script, the BL component is saved in DB as is (with the inline script)

Migrate Legacy Scripts 

The BL_Config.XML file may contain the scripts section with built-in scripts that will be imported as well as the scripts in the folder scripts.

Loading

Migrate Legacy Schedules

The FIXEdge.properties file may contain the server schedules that will be imported as well as the schedules in the file schedules.json.

Loading