Upgrading multiple Agents

BMC Database Automation (BDA) allows you to upgrade all eligible Agents in a domain at the same time.

BDA Agent media is now part of the Manager artifacts. Installing BDA 2023 Release 02 or later versions automatically places Agent media on the Manager at /app/clarity/var/agentupdates/.

Prerequisites

You must have upgraded the Manager to BDA 2021 Release 01.

Follow these steps:

1. On the Manager, download the file BDA_Release_VersionNumber_Manager.tar.gz or later versions which contains the BMC Database Automation Manager software.
2. Use the following command to extract this tar file on the Manager:tar -xvf BDA_Release_VersionNumber_Manager.tar.gz
3. Navigate to the folder BDA_AGENTS inside the BDA_Release_VersionNumber_Manager folder.
4. Copy all the Agent media files to the location /app/clarity/var/agentupdates/ on this Manager.

Upgrading multiple Agents

To upgrade multiple agents of a domain, perform the following steps:

1. Log in to the BDA Manager console. Make sure this Manager is upgraded to BDA 2021 Release 01.
2. In the Context Frame, identify the domains that might have legacy Agents.
3. Click to select the domain identified in the previous step.
   Agents that pertain to the selected domain appear under the Content tab.

4. On the Content tab, go to Maintenance and click Upgrade Agents.

   Warning

   Note

   If no Agents are available for upgrade under the selected domain, the following alert is displayed:

   There are no agents available for upgrade under selected domain.
5. On the Job Options panel, click Next.

6. On the Scheduling panel, select a time for the job execution.
   You can choose from the following available values:

   • Now
   • At a future time
   • Every hour
   • Every day
   • Every week
   • On certain days every week
   • Every month

   The default is Now.

7. Click Next.
   Job Options lists candidate Agents that are scheduled to be upgraded. Scheduling displays the schedule that you selected in the previous step.
8. Click Execute Job.
   A new job starts, and a progress bar indicates the job's status. The process upgrades the legacy Agents in parallel but separately shows upgrade activity and a progress indicator for each Agent.

Multi-Manager configuration

If your environment has a Multi-Manager configuration, repeat the steps in Upgrading multiple Agents for all Satellite Managers.

Upgrading only some Agents in a domain

When you upgrade to BDA 2023 Release 02 or later versions, you cannot upgrade specific Agents in a domain. We recommend that you upgrade all the Agents to version 2023 Release 02 or later at a time.

If it is mandatory to upgrade specific Agents, use any one of the following workarounds:

Scenario 1 - No Domain-wise Upgrade

Follow these steps when there are domains which contain both upgradable and non-upgradable candidates:

1. Set up a new BDA Manager on version 2021 Release 01.
2. Run the script reconfigure_dagent.sh to move all the Agents which you do not want to upgrade to this new Manager. Make sure that each Agent has the hostname of the new Manager as a parameter.
3. Upgrade the remaining Agents and then the Manager to version 2023 Release 02 or later.

When required, you can upgrade the Agents in the new Manager to version 2023 Release 02 or later individually and reconfigure these Agents with the upgraded Manager.

Scenario 2 - Domain-wise upgrade

Follow these steps when all the nodes in a domain are upgradable candidates:

1. Use the Upgrade Agents option to upgrade the Agents within a domain to BDA 2023 Release 02 version or later.
2. Upgrade the BDA Manager to BDA 2023 Release 02 version or later. After you upgrade the Manager, the Agents from other domains appear red stating that they cannot be managed under this domain.
3. Run the script reconfigure_dagent.sh to move these non-upgraded Agents to another Manager which is running on BDA 2021 Release 01 or earlier suitable versions. Make sure that each Agent has the hostname of the new Manager as a parameter.

When required, you can upgrade these Agents to the Manager running on BDA 2023 Release 02 version or later individually. You can also use the  Upgrade Agents option on these Agents to move them back to the first manager.