virtualMachineresourcespace

Upgrade ResourceSpace

NOTE: We are in the process of modifying the file structure and configuration for many Bitnami stacks. On account of these changes, the file paths stated in this guide may change depending on whether your Bitnami stack uses native Linux system packages (Approach A), or if it is a self-contained installation (Approach B). To identify your Bitnami installation type and what approach to follow, run the command below:

 $ test ! -f "/opt/bitnami/common/bin/openssl" && echo "Approach A: Using system packages." || echo "Approach B: Self-contained installation."

The output of the command indicates which approach (A or B) is used by the installation, and will allow you to identify the paths, configuration and commands to use in this guide. Refer to the FAQ for more information on these changes.

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 /opt/bitnami/ctlscript.sh 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 http://svn.resourcespace.com/svn/rs/releases/VERSION
    
  • 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): /opt/bitnami/resourcespace/

  • Approach B (Self-contained Bitnami installations): /opt/bitnami/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 /opt/bitnami/ctlscript.sh restart
    
Last modification March 3, 2021