Upgrading RapidDeploy and its plugins from an earlier version

1. Upgrading the RapidDeploy Framework Server using the provided script

On Linux, Unix and Mac operating systems you can follow the process below to quickly upgrade RapidDeploy from any version of RapidDeploy 4.0+ to the latest download version.
You will require the new RapidDeploy assembly (zip file) which can be downloaded from the download pages.
  1. In this example, ${MV_HOME}, the directory under which all the RapidDeploy folders can be found,  is /var/midvision. Your RapidDeploy installation may have a different ${MV_HOME}. On the MidVision Cloud images on the AWS and Azure marketplaces, the ${MV_HOME} is /var/rd/midvision.
  2. Prior to upgrading, run the following script in your existing RapidDeploy installation with the ‘backup’ argument, which stops RapidDeploy and copies the required files to the /tmp directory on your server into a new folder with the current date stamp:
    ${MV_HOME}/bin/upgrade.sh backup
  3. Now move your existing RapidDeploy installation to a safe location by moving the $MV_HOME directory to another (backup) location. For example, if your current installation is in /var/midvision folder, you can run:
    cd /var
    mv midvision midvision-backup-1
  4. Unzip the new RapidDeploy assembly (in the /var folder). The midvision folder will be recreated.
    cd /var
    unzip rapiddeploy-web-app-lnx.zip
  5. Rerun the upgrade script with the ‘restore’ argument in the new installation. The will pull the saved folders back from the /tmp directory:
    ${MV_HOME}/bin/upgrade.sh restore
  6. You will be prompted to amend the new rapiddeploy.properties file with any differences detected between the two versions.
    vi ${MV_HOME}/bin/rapiddeploy.properties
  7. Restart the RapidDeploy server. This process will also populate the RapidDeploy lib folders:

2. Upgrading the RapidDeploy Framework Server Manually

To upgrade RapidDeploy from an earlier version of 4.x, perform the following steps:

  • Stop RapidDeploy as follows, which will write the in-memory database (if used) to file:
  • Check that the following file is present [only required if using the internal HSQL database]:

    Where RD-USER is the OS user you used to install/start RapidDeploy.

  • Back up the following directories:
  • Install the new version of RapidDeploy
  • Restore the directories you backed up to the same locations
  • If you have made changes to the $MV_HOME/bin/rapiddeploy.properties file, re-apply these changes to the new file (perform a diff if necessary).
  • Start the new instance of RapidDeploy as follows:

3. Upgrading the RapidDeploy Framework Server in Docker

Upgrading RapidDeploy that is running in a Docker container is very simple. To upgrade (In this example we’re upgrading from RapidDeploy 5.0.20 to 5.0.21. Replace 5.0.21 with the actual version you are upgrading to):

  • Pull the new version from docker hub using: docker pull midvision/rd:5.0.21
  • Stop the currently running RapidDeploy container: docker stop midvision_rapiddeploy
  • Rename the old container: docker rename midvision_rapiddeploy midvision_rapiddeploy_5020
  • Run the new container using the new image: docker run -t -d -p 9090:9090 -v ~/dockershare/external/rd/libraries:/rd/libraries -v ~/dockershare/external/rd/resources:/rd/resources -v ~/dockershare/external/rd/snapshots:/rd/snapshots -v ~/dockershare/external/rd/logs:/rd/logs -v ~/dockershare/external/rd/projects:/rd/projects -v ~/dockershare/external/rd/db:/rd/users/root -v ~/dockershare/external/rd/buildstore:/rd/buildstore -v ~/dockershare/external/rd/promotionstore:/rd/promotionstore -v ~/dockershare/external/rd/users:/rd/users --name "midvision_rapiddeploy" midvision/rd:5.0.21

4. Upgrading RapidDeploy Installed Plugins

Install New Plugins
After upgrading using one of the methods above, you will need to re-install any plugins that are not shipped with the framework server according to the article here: https://www.midvision.com/rapiddeploy-how-to-guides/install-additional-plugins/
Update Plugin Data
Sometimes after upgrading the RapidDeploy Framework Server, you will need to upgrade your plugin data for compatibility with new plugin fields. You can check if the release requires a plugin upgrade in the changes report. If this is the case, use the following procedure:
  • Upgrade the RapidDeploy Framework Server as detailed below.
  • Log in to RapidDeploy.
  • Navigate to ‘System Icon’ -> ‘Plugin Manager’
  • Click the ‘Update Plugin Data’ button in the top right-hand corner.
  • All your Resource, Server and Project (artifact and SCM) plugins will be updated.
You can also upgrade individual plugin types for Resource, Server and Project plugins on their respective list pages. You do this by clicking on the ‘Spanner’ icon in the top right hand corner.