Back Up and Recover the Connectivity Agent

If the host on which the connectivity agent is running fails and makes your environment unavailable, follow these steps to recover the connectivity agent.

Note:

  • Perform regular backups of the agent directory located under AGENT_INSTALL_DIR/agenthome.

  • 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. In the navigation pane, click Design, then Agents.
  2. Click Download, then Connectivity Agent.
  3. Save the oic_connectivity_agent.zip file on the agent host.
  4. Create an AGENT_INSTALL_DIR directory. The new AGENT_INSTALL_DIR directory name must match the old name.
  5. Extract oic_connectivity_agent.zip under the AGENT_INSTALL_DIR directory.
  6. Replace the new agent directory in AGENT_INSTALL_DIR/agenthome with the agent directory from your last backup.
  7. 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.