Docs Menu

Upgrade MongoDB Charts

On this page

  • System Requirements
  • Procedure
  • Troubleshooting

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

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.

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.

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

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 version of the Charts Docker Compose file from the MongoDB Download Center.

2
3

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

docker stack rm mongodb-charts
4

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

docker pull quay.io/mongodb/charts:19.12.2
Note

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

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

5

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

docker stack deploy -c charts-docker-swarm-19.12.2.yml mongodb-charts
Note

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

6

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

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

Give Feedback
© 2021 MongoDB, Inc.

About

  • Careers
  • Legal Notices
  • Privacy Notices
  • Security Information
  • Trust Center
© 2021 MongoDB, Inc.