Recover the Connectivity Agent in Case of Host Failure

If the host on which the connectivity agent is running fails and makes your environment unavailable, follow these steps to recover the connectivity agent. The failed host can be an on-premises machine or in Oracle Cloud Infrastructure Compute.

Note:

  • Perform regular backups of AGENT_INSTALL_DIR.

  • Ensure that the regular backups are not on the same physical host on which the agent is currently running.

  • Ensure that backups are available in the event of an agent host failure.

If your host fails and makes the environment unavailable, do the following;

  1. Copy the AGENT_INSTALL_DIR directory from your last backup to the new host.
  2. Change directories to the AGENT_INSTALL_DIR directory.
  3. Restart the connectivity agent.
    java -jar connectivityagent.jar 

    Note:

    If you use third party JAR files, ensure that the same JARs are available under AGENT_INSTALL_DIR/agenthome/thirdparty/lib. If not, add them to the lib directory.

Note:

  • To ensure the integrity of the backups, always create a new backup if integration activations/deactivations have occurred since the last backup.

  • The agent instance name is from the backed up configuration and is mapped to the current host. If backup and recovery are performed on a different host, the agent instance name does not change to reflect the new host on which the agent is running.