Navigation
This documentation refers to the on-premises edition of MongoDB Charts. Read the Atlas service documentation to learn how to use MongoDB Charts with your Atlas project.

Upgrade MongoDB Charts

The following document describes how to upgrade MongoDB Charts from an older version.

System Requirements

Metadata Database

MongoDB Charts requires a MongoDB deployment running version 3.6 or later to store Charts metadata. The Charts metadata cluster can run MongoDB Atlas, the cloud-hosted service for running, monitoring, and maintaining MongoDB deployments.

Note

Charts does not require its own dedicated MongoDB deployment. If Charts uses an existing MongoDB deployment, it will create and use the following databases:

  • app,
  • auth,
  • events,
  • hosting,
  • log,
  • metadata.

Charts Server

MongoDB Charts must be installed on a single server running Docker CE or EE (v17.06 or higher). The server must be in a network location that can communicate with the metadata database and MongoDB servers that contain the data you wish to visualize.

Supported Browsers

End users accessing MongoDB Charts must use a current desktop version of Chrome, Firefox, or Safari on any operating system.

Procedure

When you upgrade MongoDB Charts to a new version, you only need to remove the old Docker stack and redeploy the Docker stack using the new version of Charts. You do not need to re-create the Docker secret for your deployment.

1

Download the latest MongoDB Charts Docker Compose file.

Download the latest version of the Charts Docker Compose file from the MongoDB Download Center.

2

From your command prompt, navigate into the directory where you downloaded the Compose file.

3

Remove the Charts Docker stack.

Removing the Charts Docker stack does not delete any Charts metadata (e.g., existing charts and dashboards).

docker stack rm mongodb-charts
4

Pull down the Charts image for the new version.

The following command assumes you are using the latest version of MongoDB Charts, 19.09.

docker pull quay.io/mongodb/charts:19.09

Note

If you are using a different version of Charts, replace 19.09 with the version number of your release.

This command may take a while as it downloads a large file to the host server.

4

Launch the Charts container using the new version of Charts.

The following command assumes you are using the latest version of MongoDB Charts, 19.09.

docker stack deploy -c charts-docker-swarm-19.09.yml mongodb-charts

Note

If you are using a different version of Charts, replace 19.09 with the version number of your release.

5

Verify that the container is running.

Check that the container is running by executing:

docker service ls

The Charts container should appear with mode replicated with 1/1 replicas:

ID             NAME                    MODE         REPLICAS   IMAGE                   PORTS
j77uo3slyg4l   mongodb-charts_charts   replicated   1/1        mongodb-charts:latest   *:80->80/tcp

Troubleshooting

If you encounter issues during the upgrade process, refer to the Troubleshooting section of the Installation page.