bchmahara

Upgrade Mahara

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

  • Log in to the server console.

  • Create a directory to save all the data you need to backup.

     $ mkdir ~/mahara-backup

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

  • Copy the data and maharadata directories and the config.php configuration file to your backup directory:

     $ sudo cp -rf /opt/bitnami/apps/mahara/maharadata ~/mahara-backup
 $ sudo cp -rf /opt/bitnami/apps/mahara/conf ~/mahara-backup
 $ sudo cp /opt/bitnami/apps/mahara/htdocs//config.php ~/mahara-backup

  • If you use non-core plugins or themes in your site, make sure to copy them to the backup directory.

  • Compress the backup directory.

     $ tar cfz mahara-backup.tar.gz ~/mahara-backup

  • Download the backup files mahara-backup.tar.gz and backup.sql using SFTP. Refer to the FAQ for more information on this.

  • Launch a new Mahara server.

  • Upload via SFTP the backups files mahara-backup.tar.gz and backup.sql to the new server. Refer to the FAQ for more information on this.

  • Log in to the server console.

  • Browse to http://SERVER-IP/admin/ (SERVER-IP is a placeholder, please, replace it with the actual domain of your Mahara server). In the section “Close site”, click the “Close” button in order to set the “Maintenance mode”.

  • Restore the database backup as described on the MySQL page.

  • Uncompress and restore the backup files in the new Mahara stack.

     $ tar xfz mahara-backup.tar.gz
 $ sudo cp -rf ~/mahara-backup/maharadata /opt/bitnami/apps/mahara/maharadata
 $ sudo cp -rf ~/mahara-backup/conf /opt/bitnami/apps/mahara/conf
 $ sudo cp ~/mahara-backup/config.php /opt/bitnami/apps/mahara/htdocs/

  • Restore the permissions.

     $ sudo chown -R bitnami:daemon /opt/bitnami/apps/mahara/htdocs/
 $ sudo chown -R daemon:daemon /opt/bitnami/apps/mahara/maharadata

  • Open the file /opt/bitnami/apps/mahara/htdocs-backup/config.php and obtain the value of the property $cfg->urlsecret.

NOTE: In the example below, replace the URLSECRET placeholder with the value you obtained in the previous step.

  • Browse to http://SERVER-IP/admin/upgrade.php?urlsecret=URLSECRET. (SERVER-IP is a placeholder, please, replace it with the actual domain of your Mahara server).
  • Click the “Upgrade” button.
  • Browse to http://SERVER-IP/admin/. (SERVER-IP is a placeholder, please, replace it with the actual domain of your Mahara server).
  • In the section “Close site”, click the “Open” button in order to unset the “Maintenance mode”.
  • That’s all! You updated your whole server!

Upgrade only Mahara in the Bitnami Mahara Stack

  • Browse to http://SERVER-IP/admin/. (SERVER-IP is a placeholder, please, replace it with the actual domain of your Mahara server).

  • In the section “Close site”, click the “Close” button in order to set the “Maintenance mode”.

  • Browse to https://launchpad.net/mahara/+download and find the link for the latest version of Mahara.

  • Log in your server console and download the latest version using the link you obtained in the previous step. For example (for version 17.04.0), run the commands below:

      $ wget https://launchpad.net/mahara/17.04/17.04.0/+download/mahara-17.04.0.tar.gz
  $ tar xfz mahara-17.04.0.tar.gz

  • Backup your current Mahara Installation.

      $ sudo mv /opt/bitnami/apps/mahara/htdocs/ /opt/bitnami/apps/mahara/htdocs-backup/

  • Substitute your old installation with the new version and recover the configuration file.

      $ sudo mv ~/mahara-17.04.0/htdocs/ /opt/bitnami/apps/mahara/htdocs/
  $ sudo cp /opt/bitnami/apps/mahara/htdocs-backup/config.php /opt/bitnami/apps/mahara/htdocs/

  • Restore the permissions.

      $ sudo chown -R bitnami:daemon /opt/bitnami/apps/mahara/htdocs/

  • Open the file /opt/bitnami/apps/mahara/htdocs-backup/config.php and note down the value of the property $cfg->urlsecret.

NOTE: In the example below, replace the URLSECRET placeholder with the value you obtained in the previous step.

  • Browse to http://SERVER-IP/admin/upgrade.php?urlsecret=URLSECRET. (SERVER-IP is a placeholder, please, replace it with the actual domain of your Mahara server).
  • Click the “Upgrade” button.
  • Browse to http://SERVER-IP/admin/. (SERVER-IP is a placeholder, please, replace it with the actual domain of your Mahara server).
  • In the section “Close site”, click the “Open” button in order to unset the “Maintenance mode”.
  • That’s all! You updated your application!
Last modification September 7, 2018