You can upgrade an existing OpenText Cloud Bridge Agent instance by running the installation script on the host server. The installation script detects that an older version is already installed and prompts you to upgrade.
Before you upgrade, you should consider the following:
Whether you want to replace all the connectors you currently have installed on the Agent host server. For more information, see Planning to Upgrade Connectors.
Whether you want to make changes in your high availability environment. For more information, see Planning for High Availability Before Upgrade.
NOTE:Upgrading your Agent environment does not remove old Agent images. As a best practice, after you have upgraded successfully you should periodically review and remove unneeded old images to free up disk space. For more information, see Removing Old Agent Images.
Before you begin upgrading your Agent environment, review your existing connectors and take the appropriate action as outlined below. When you upgrade the OpenText Cloud Bridge Agent, the connector .jar files that reside in the <Agent_install_dir>/agent/bridgelib/ folder on the Agent host server take precedence over the connector .jar files that are included in the /collectors folder.
IMPORTANT:Work with your SaaS support team to address any questions or concerns you have about upgrading connectors.
Consider the following:
If you have older patched connectors in the /bridgelib folder and the newer Agent has better built-in .jar files, you should remove the outdated files in the /bridgelib folder before you install the Agent. Remove any copies of dist-collectors, daas-ldap, or any other updated .jar files provided by your SaaS support team.
If your /bridgelib folder contains files such as a supporting .jar file for JDBC or other custom collector .jar files, you should leave those files alone.
If you have older connectors in your /bridgelib folder that are working well and you do not want to risk upgrading them, you can choose to keep an older version in /bridgelib and not use the updated version included with the Agent in the /collectors folder.
If you currently have only one Agent instance in your environment, we strongly recommend that you install and configure one or more secondary or backup Agent servers for failover. For more information to help you plan, see Planning for High Availability.
Consider the following possible high availability upgrade scenarios:
You want to keep your current Agent as your primary Agent instance. For more information, see Upgrading with Your Current Agent as the Primary Instance.
You want to use another server for your primary Agent. For more information, see Upgrading with a New Agent as the Primary Instance.
NOTE:You can reconfigure your Agent instances as needed after installation by rerunning the installation script on the appropriate servers. For more information, see Updating High Availability and Other Agent Settings.
If you are upgrading your Agent environment and want to assign your current Agent as your primary instance, complete the following steps:
Run the Agent installation script on your Agent server. For more information, see Installing Your Primary Agent Instance.
At the upgrade prompt, enter y.
IMPORTANT:OpenText Cloud Bridge saves your Agent credentials when you upgrade. If you respond n at the upgrade prompt and do a fresh installation, you lose those credentials.
Set the instance and site to Primary.
Wait for the server to restart.
Run a fresh installation for each secondary and backup Agent that you want to use in your environment. Ensure that you use the encryption key and IV from your first Agent instance for all secondary and backup Agent instances. For more information, see Installing Secondary and Backup Agent Instances.
Configure your primary Agent instance with the credentials for all data source connections you plan to use, then export those credentials to a file. For more information, see Manage Credentials for Data Source Connections.
Import the data source credentials to each secondary and backup Agent instance one at a time.
If you are upgrading your Agent environment and want to use a new host server as your primary Agent instance, complete the following steps:
Configure the host server that you plan to use as your primary Agent instance with all of the Agent prerequisites. For more information, see Understanding Requirements and Setting Up the Agent Server.
Run the Agent installation script on the new host server and set the instance and site to Primary. Since this is a new installation, there is no prompt to upgrade. For more information, see Installing Your Primary Agent Instance.
Wait for the server to restart.
Run the Agent installation script on your existing Agent server, enter y at the upgrade prompt, and set the instance and site to Secondary or Backup as appropriate for your environment.
Run a fresh installation for any additional secondary and backup Agents that you want to use in your environment. Ensure that you use the encryption key and IV from your first Agent instance for all secondary and backup Agent instances. For more information, see Installing Secondary and Backup Agent Instances.
Configure your primary Agent instance with the credentials for all data source connections you plan to use, then export those credentials to a file. For more information, see Manage Credentials for Data Source Connections.
Import the data source credentials to each secondary and backup Agent instance one at a time.