Upgrading

This section describes the upgrade and migration options that are available from previous versions of BMC Discovery.

No architecture changes required

Note

When upgrading from BMC Discovery 20.02 (12.0), 20.08, 21.05, 21.3, 22.1, or 22.2 to 23.1, there is no need to change your deployment architecture. Rather, we strongly recommend that you upgrade using your existing architecture and test version 23.1 in a known configuration. After you have tested BMC Discovery 23.1 in a known configuration, you might choose to explore the deployment opportunities offered by the BMC Discovery Outpost.

Existing Windows proxies will continue to operate with upgraded appliances.

Related topic

Release notes and notices

Planning

Troubleshooting

BMC Community: FAQ on BMC Discovery upgrade Open link

Upgrade and migration overview

To summarize the upgrade paths and outcomes:

New installations of BMC Discovery 11.3 used CentOS 7 as their operating system.
Any appliance upgraded to 11.3 runs on CentOS 6. BMC Discovery 11.3.x was the last version of BMC Discovery to support CentOS 6.
You cannot upgrade a CentOS 6 or Red Hat Enterprise Linux (RHEL) 6 based appliance to CentOS 7; you must migrate. Migration involves backing up the CentOS 6 or RHEL 6 based appliance (version 10.1.x to 11.3.x) and restoring to a new BMC Discovery 23.1 appliance running on CentOS 7.
BMC Discovery 23.1 is also available on Red Hat Enterprise Linux 7. You cannot upgrade a CentOS 7 based appliance to RHEL 7; you must migrate. Migration involves backing up the CentOS 7 based appliance and restoring to a new appliance running on RHEL 7.

This diagram show the upgrade paths available. You can also migrate using backup/restore. Using the backup/restore migration method, you can move your data to a new BMC Discovery using any of the supported operating systems shown.

You can also migrate between versions of BMC Discovery running on CentOS 7 and RHEL 7, but for clarity, it is not shown in the diagram.

Supported upgrade versions

You can upgrade to BMC Discovery 23.1 running on CentOS 7 from the following versions of BMC Discovery running on CentOS 7:

Version	Supported upgrade versions
22.2 (12.5)	22.2 (12.5), patch 1, patch 2
22.1 (12.4)	22.1 (12.4), patch 1
21.3 (12.3)	21.3 (12.3), patch 1, patch 2, patch 3
21.05 (12.2)	21.05 (12.2), patch 1, patch 2, patch 3, patch 4, patch 5
20.08 (12.1)	20.08 (12.1), patch 1, patch 2, patch 3, patch 4
20.02 (12.0)	20.02 (12.0), patch 1, patch 2, patch 3, patch 4, patch 5, patch 6

You can upgrade to BMC Discovery 23.1 running on RHEL 7 from the following version of BMC Discovery running on RHEL 7:

Version	Supported upgrade versions
22.2 (12.5)	22.2 (12.5), patch 1, patch 2
22.1 (12.4)	22.1 (12.4), patch 1
21.3 (12.3)	21.3 (12.3), patch 1, patch 2, patch 3
21.05 (12.2)	21.05 (12.2), patch 1, patch 2, patch 3, patch 4, patch 5
20.08 (12.1)	20.08 (12.1), patch 1, patch 2, patch 3, patch 4
20.02 (12.0)	20.02 (12.0), patch 1, patch 2, patch 3, patch 4, patch 5, patch 6

The formally tested and supported upgrade paths are listed above. We expect upgrades from 11.3 to also work, but they have not undergone the same level of detailed validation.

Change of supported OS for BMC Discovery Outpost

The minimum supported version of the OS for the BMC Discovery Outpost is Windows Server 2016. Before upgrading your BMC Discovery Outposts to BMC Discovery 23.1, you must upgrade any BMC Discovery Outpost hosts to Windows Server 2016 and later.

OS migration

The replacement of earlier OS versions with CentOS 7 ensures continued support for the appliance OS during its lifetime, and provides support for newer hardware where you choose to install on hardware. It also provides SMB 2 support, and the ability to run Apache 2.4. CentOS is an enterprise-class Linux platform that is derived from and aims to be functionally compatible with its upstream source, RHEL. This compatibility enables BMC to perform the same CentOS testing against the Red Hat 6 and 7 STIGs.

When applying OS upgrades to BMC Discovery 23.1, ensure that you download and apply the correct CentOS operating system upgrade.

Red Hat Enterprise Linux 7 is a separately licensed release intended for customers whose organizations require particular certifications, such as Common Criteria Security Certification. You cannot upgrade an appliance running on CentOS 7 to a later version appliance running on RHEL 7; rather, you must migrate. The various upgrade paths and more information on migration is provided in the upgrading section.

Which OS am I using?

Click here to expand...

To determine whether your appliance is running on CentOS 6, CentOS 7, or RHEL 7, check the footer of any UI page. The BMC Discovery version number, build number, and OS version are provided on the bottom line.

Alternatively, from the command line, enter:

tideway@appliance01 ~]$ cat /etc/redhat-release

For CentOS 6 the output begins:
CentOS release 6.x
For CentOS 7 the output begins:
CentOS Linux release 7.x
For RHEL 7 the output begins:
Red Hat Enterprise Linux Server release 7.x

For a summary about user-facing OS-level changes from previous BMC Discovery releases, see BMC Discovery on CentOS 7 compared to previous versions.

OS migration considerations

If any disk changes were made to the existing appliance before the migration, such as moving the datastore to a separate disk, these changes must be repeated on the new appliance. Otherwise, the restore from the old appliance may fail because of insufficient disk space.

The following file locations can be changed if needed in the $TIDEWAY/etc/link.conf file:

core datastore files
datastore log files
backup archive files

This section contains the following topics: