Updating or upgrading the agent installation

This section outlines the steps required to update or upgrade the agent installation, and includes:

Related topics

Upgrading

Upgrading-the-core-components-of-the-product 

The installation might need to be updated after application of updates at the server. Server updates can include updates to the agent packages and are applied to the server so that they can be distributed and applied. The installation might need to be upgraded when those updates are a new release.

There are three ways of updating the installation. The first is to distribute the packages individually; the remaining two involve applying an updated bootstrap package when using the Default Layout or manually transferring the files when using the Flat Directory Layout. Additionally, you can upgrade from the Flat Directory Layout to a Default Layout.

Warning

Agent and extension packages have files that have configuration information. To back up and restore the files when you upgrade either the agent or extension packages, see the list of upgrade sections (mentioned above) as per your requirement. 

As with all agent Fix Packs and agent platforms, we recommend you update the bootstrap package prior to updating any extensions. While performing the update process make sure you preserve the eaa.xml and other files so you retain your current configuration. For more details, see Updating-the-Default-Layout-installation-by-applying-a-bootstrap-package.

Whenever a new Windows bootstrap package is installed or updated after a Fix Pack is applied, you may need to update the Microsoft runtime libraries. There is no harm in executing the installer if the runtime libraries are already installed. We recommend you execute vcredist_x64.

Important

When updating your agent installation, you should review the upgrade steps as they have been altered to accommodate the changes in JRE implementations. For example, never extract the bootstrap archive over the top of an existing installation. This is especially important with the JRE changes as it results to a non-working JRE.
You must make a copy of the existing installation, extract it into a new directory and then copy/restore the required files, such as eaa.xml. This is also applicable to the bmmtm-agent directory.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*