Install

Prerequisites Copied

The following Obcerv apps must be installed before installing the FIX Monitor app:

• Web Console
• Query Service

FIX message data source Copied

Before installing the app, you must determine how your FIX message log data will be sent to Obcerv. See Log Ingestion for details.

Install Copied

Caution

Before upgrading to FIX Monitor 2.2.0, you must first uninstall all Obcerv apps. Due to a breaking change in a core library (Spring Boot), you need to upgrade all Obcerv apps at the same time. Make sure that you reinstall the latest mutually compatible versions of Obcerv apps. See the Obcerv Compatibility Matrix.

To install the FIX Monitor app, you must first create a Helm values file with the appropriate configuration parameters for your environment.

See Configuration for information on the configuration parameters that can be set.

Create a file, such as fixmonitor.yaml with content similar to the following:

externalHostname: "www.obcerv.local"
ingress:
  annotations:
    kubernetes.io/ingress.class: "nginx"
    nginx.org/mergeable-ingress-type: "minion"
bffDaemon:
  config:
    # Override to match your FIX enviornment
    defaultSchedule:
      timezone: America/New_York
      logonTime:
        hour: 8
      logoutTime:
        hour: 15
        minute: 30
      endOfDayTime:
        hour: 16
  pvc: 
    index:
      # Override based on sizing estimates
      storageSize: 20Gi      

• The externalHostname parameter is required and must match the DNS name configured for the Web Console.
• Your ingress controller may require custom annotations on the ingress (this example is for ingress-nginx)
• A bffDaemon.config.defaultSchedule is required in order to start the application. Generally this is set to the schedule that a majority of your sessions follow. Individual session schedules can be set in the app or via REST API.
• Set the storageSize value by referencing message index volume sizing.

Install using Helm:

helm install -f fixmonitor.yaml obcerv-app-fixmonitor \
itrs/obcerv-app-fixmonitor \
--version 2.2.0 -n <namespace> --wait

Uninstall Copied

helm uninstall obcerv-app-fixmonitor -n <namespace>

Upgrade Copied

To upgrade the app, first uninstall and then install it again using the new version.