How Platform Automation Upgrades Ops Manager
This topic provides a high level overview of upgrading an Ops Manager using Platform Automation, including command requirements and common version check and IaaS CLI errors.
It's important to note when upgrading your Ops Manager:
- always perform an export installation
- persist that exported installation
- installation is separate from upgrade
- an initial installation is done, which maintains state
Always export your installation
It is recommended to persist the zip file exported from export-installation to an external file store (eg S3) on a regular basis. The exported installation can restore the Ops Manager to a working state if it is non-functional.
upgrade-opsman task follows the flow based on state of an Ops Manager VM.
This flowchart gives a high level overview of how the task makes decisions for an upgrade.
On successive invocations of the task, it will offer different behaviour of the previous run. This aids in recovering from failures (ie: from an IAAS) that occur.
upgrade-opsman task will delete the previous VM, create a new VM, and import
a previous installation. It requires the following to perform this operations:
- a valid state file from the currently deployed Ops Manager
- a valid image file for the new Ops Manager to install
- a configuration file for IAAS specific details
- an exported installation from a currently deployed Ops Manager
- the auth file for a currently deployed Ops Manager
When you are upgrading your Ops Manager you may get version check or IaaS CLI errors. For information about troubleshooting these errors, see
Version Check Errors and
IaaS CLI Errors below.
Version Check Errors
1) Downgrading is not supported by Ops Manager (Manual Intervention Required)
- Ops Manager does not support downgrading to a lower version.
- SOLUTION: Try the upgrade again with a newer version of Ops Manager.
2) Could not authenticate with Ops Manager (Manual Intervention Required)
- Credentials provided in the auth file do not match the credentials of an already deployed Ops Manager.
- SOLUTION: To change the credentials when upgrading an Ops Manager, you must update the password in your
Account Settings. Then, you will need to update the following two files with the changes:
3) The Ops Manager API is inaccessible (Recoverable)
- The task could not communicate with Ops Manager.
- SOLUTION: Rerun the
upgrade-opsmantask. The task will assume that the Ops Manager VM is not created, and will run the
IAAS CLI Errors
1) When the CLI for a supported IAAS fails for any reason (i.e., bad network, outage, etc) we treat this as
an IAAS CLI error. The following tasks can return an error from the IAAS's CLI:
- SOLUTION: The specific error will be returned as output, but most errors can simply be fixed by