awsmattermost

Upgrade Mattermost Team Edition

It is strongly recommended to create a backup before starting the update process. If you have important data, create and restore a backup to ensure that everything works properly.

Follow these steps to upgrade Mattermost:

  • Stop the server:

      $ sudo /opt/bitnami/ctlscript.sh stop mattermost

  • Back up the current configuration files:

      $ sudo mkdir /opt/bitnami/apps/mattermost/backup/
  $ sudo cp /opt/bitnami/apps/mattermost/server/config/config.json /opt/bitnami/apps/mattermost/backup/

  • Back up the database as described on the MySQL page.

  • Download the latest version of Mattermost:

      $ cd /opt/bitnami/apps/mattermost/
  $ sudo wget https://releases.mattermost.com/X.X.X/mattermost-team-X.X.X-linux-amd64.tar.gz

  • Remove previous Mattermost files (already backed up in previous steps).

      $ sudo rm -rf /opt/bitnami/apps/mattermost/server/*

  • Uncompress the new version:

      $ sudo tar xzf mattermost-team-X.X.X-linux-amd64.tar.gz -C /opt/bitnami/apps/mattermost/server --strip-components=1

  • Restore the previous configuration file:

      $ sudo cp /opt/bitnami/apps/mattermost/backup/config.json /opt/bitnami/apps/mattermost/server/config/config.json

  • Adjust file permissions:

      $ sudo chown -R root:root /opt/bitnami/apps/mattermost/server
  $ sudo touch /opt/bitnami/apps/mattermost/server/logs/mattermost.log
  $ sudo chown -R bitnami:mattermost /opt/bitnami/apps/mattermost/server/logs
  $ sudo chmod g+w /opt/bitnami/apps/mattermost/server/logs/mattermost.log
  $ sudo chown -R bitnami:mattermost /opt/bitnami/apps/mattermost/server/client/
  $ sudo chmod -R g+w /opt/bitnami/apps/mattermost/server/client/

  • Restart the server:

      $ sudo /opt/bitnami/ctlscript.sh restart mattermost

  • Open the “System Console” and save a change. Doing this will upgrade your config.json schema to the latest version using default values for any new settings added.

Last modification April 8, 2020