KB Article #178139

system role and primary role on 2 different nodes

Problem

-- As per B2Bi operational guide :

In a B2Bi cluster, the integration engines instances are assigned operating roles:

System role – The integration engine operating in the System role runs the cluster singleton tasks. Cluster singleton tasks are always running. They can only run on one integration engine instance in the cluster. The integration engine with the System role is the first node that is started in supervised mode.

Primary node –The integration engine operating in the Primary role runs the integration engine user singleton tasks. Integration engine singleton tasks support polling pickups, dedicated processing environments (integration engine HMEs) for the multi-document envelopers and sequencing activities. The integration engine with the primary role is the first to start the user tasks.

These two B2Bi-specific roles can be attributed to the same cluster node or to different nodes, however it is best to configure them on different nodes.

-- How we can configure our B2Bi cluster in such a way that the roles (Primary and System) can be configured on different nodes?



Resolution

when starting up:

  • start product B2Bi on node A, but do not start Trading Engine
    • node A will acquire "system role", since it is the only running node in the cluster
  • start product B2Bi on node B, PLUS start Trading Engine on node B
    • node B will acquire "primary node role", since it is the only node running the processing engines / user tasks
  • start Trading Engine on node A
    • now the full cluster is started
    • the roles will stay where they are assigned to, as long as no incident is triggering a failover.