Docs Menu

Docs HomeMongoDB Ops Manager

Upload the Latest Version Manifest to Ops Manager with the API

On this page

  • Variables for API Resources to Update the Version Manifest
  • Prerequisite
  • Procedure

For Ops Manager deployments with limited internet access, the version manifest that Ops Manager uses might not match the latest version manifest that MongoDB provides.

You can download the latest version manifest from MongoDB, then upload it to Ops Manager with the API.

The API resources use one or more of these variables. Replace these variables with your desired values before calling these API resources.

Name
Type
Description
{PUBLIC-KEY}
string
Public API key for your API credentials.
{PRIVATE-KEY}
string
Private API Key for your API credentials.
<OpsManagerHost>:<Port>
string
URL of your Ops Manager instance.
{OPS-MANAGER-VERSION}
string

Major and minor version of your Ops Manager instance.

Example

4.2

Your API key must have the Global Automation Admin or the Global Owner role.

To update your Ops Manager version to use the latest version manifest:

1

From a machine that can access the public internet, run the following command to retrieve the latest version manifest for your Ops Manager version from MongoDB:

Tip

Replace {OPS-MANAGER-VERSION} with your Ops Manager major and minor version.

Example

4.2

curl --request GET "https://opsmanager.mongodb.com/static/version_manifest/{OPS-MANAGER-VERSION}.json" \
--header "Accept: application/json" \
--output {OPS-MANAGER-VERSION}.json

The JSON file you receive in response includes all data that your Ops Manager instance needs. This covers all versions and variants of MongoDB that your version of Ops Manager supports.

The parameters and values in this file -- as well as how they are structured -- can change without notice.

2
3

From a host that can access your Ops Manager instance, use the Update the Version Manifest endpoint to upload the latest version manifest to Ops Manager.

Run the following command, replacing the placeholders with the Variables for API Resources to Update the Version Manifest:

1curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
2 --header "Accept: application/json" \
3 --header "Content-Type: application/json" \
4 --include \
5 --request PUT "https://<OpsManagerHost>:<Port>/api/public/v1.0/versionManifest?pretty=true" \
6 --data @{OPS-MANAGER-VERSION}.json
4

From a host that can access your Ops Manager instance, use the Retrieve the Ops Manager Version Manifest endpoint to confirm that Ops Manager uses the latest version manifest. You can call this endpoint without having an API key.

Run the following command, replacing the placeholders with the Variables for API Resources to Update the Version Manifest:

1curl --include --header "Accept: application/json" \
2 --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/unauth/versionManifest?pretty=true"

The response should match the version manifest you downloaded from MongoDB and uploaded to your Ops Manager instance.

←  Automate Backup Restoration through the APIStop Monitoring a Process →