The CA API Gateway uses a UUID to uniquely identify members of a Gateway cluster. It is imperative that nodes in a cluster possess unique identifiers for this purpose. These identifiers are called?node IDs?and are dynamically generated when the Gateway node is configured for the first time. If the identifiers are not unique across all cluster members then one or more Gateway nodes may fail to initialize.
This issue most commonly occurs when an existing node is cloned into a new node or an existing Gateway backup is restored to a new Gateway node. The appropriate method of creating new cluster nodes is to deploy a new appliance and use the?ssgmigrate?script to migrate an existing configuration to a new host.?ssgbackup?and?ssgrestore?should not be used to perform migrations.
The following log entry will be generated in the Gateway log file for a node that is unable to start because the node ID is already used by another cluster member. If this issue occurs then the node ID will need to be changed.
Error 'Duplicate entry 'dc32f76de7ca49fd8a66d8d8defb37a0--1-0-1360784450000' for key 'nodeid'' on query. Default database: 'ssg'.
Each node in the cluster should be started sequentially. Start a node only after the other node has completely finished initializing. This will allow the cluster membership table to be rebuilt.