Upgrade ResourceSpace

Before running the commands shown on this page, you should load the Bitnami stack environment by executing the installdir/use_APPNAME script (Linux and MacOS) or by clicking the shortcut in the Start Menu under “Start -> Bitnami APPNAME Stack -> Application console” (Windows). On OS X VMs, the installation directory is /opt/bitnami and OS X VM users can click the “Open Terminal” button to run commands. Learn more about the Bitnami stack environment and about OS X VMs.

NOTE: The Approach A sections referred to below do not apply to Bitnami native installers. Users of Bitnami native installers should refer only to the Approach B sections.

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

To upgrade the application only without modifying any other stack components, follow the steps below:

  • Back up the stack so that if anything goes wrong, you can restore it. The most important file is config.php, which stores all the ResourceSpace configuration settings.

  • Stop all the services.

      $ sudo installdir/ stop
  • Download the latest version of ResourceSpace from the official website. Replace the VERSION placeholder with the correct filename for the version you wish to download.

      $ cd /home/bitnami
      $ git svn clone
  • Copy all files from the new version over the old files in the ResourceSpace installation directory. Alternatively, remove existing files first (except those in the /filestore directory) and copy the new files to the installation directory, so that if some files have changed their location, duplication can be prevented.

NOTE: Depending on your installation type, the ResourceSpace installation directory could be in different paths:

  • Approach A (Bitnami installations using system packages): installdir/resourcespace/

  • Approach B (Self-contained Bitnami installations): installdir/apps/resourcespace/htdocs/

  • When executing the command below select “A [overwrite all files]” if prompted with an overwrite confirmation message. Remember to replace the VERSION placeholder with the correct version number

      $ cp /home/bitnami/ResourceSpaceVERSION/* -r .
      $ rm -r /home/bitnami/ResourceSpaceVERSION
  • Replace any files containing local changes from your backup copy (for example, config.php, title.gif or others).

  • Restart services.

      $ sudo installdir/ restart
Last modification June 16, 2021