Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This page provides instructions for upgrading a FlexDeploy installation to the latest version.to use newer version of FlexDeploy Docker image. You will need to download appropriate version of FlexDeploy Tomcat distribution for database scripts and plugins. 

Upgrade Instructions

Step 1. Stop the Tomcat server. Use shutdown.sh on Linux and shutdown.bat on Windows.Docker container using name. docker stop <name>

Step 2. Backup the FlexDeploy schemas and Artifact Repository. In case you need to back out FlexDeploy, you can use these backup data.

...

Step 3. Upgrade the FlexDeploy schemas

Include Page
FlexDeploy Schema Upgrade
FlexDeploy Schema Upgrade

Step 4. From the FlexDeploy Tomcat distribution, copy /apache-tomcat-flexdeploy/webapps/flexdeploy.war into <FlexDeploy Home>/apache-tomcat-flexdeploy/webapps (overwrite existing file). If you want to take backup of existing file, please copy it outside of FlexDeploy installation folder to avoid confusion later. If you keep copy of older war in webapps folder, then two applications will start and cause issues as well.

Step 5. Review <FlexDeploy Home>/apache-tomcat-flexdeploy/conf/context.xml changes as per FlexDeploy 5.2 Release Notes - See Platform Recommendations. Alternatively, you can compare your context.xml file with FlexDeploy Tomcat distribution (/apache-tomcat-flexdeploy/conf/context.xml) and make changes as necessary.

Step 6. From the FlexDeploy Tomcat distribution, copy /apache-tomcat-flexdeploy/lib/FlexDeployAPI.jar into <FlexDeploy Home>/apache-tomcat-flexdeploy/lib (overwrite existing file if present). If you want to take backup of existing file, please copy it outside of FlexDeploy installation folder to avoid confusion later

Step 7. Copy plugins from download zip for auto upload.

...

Step 8 . Start tomcat by running the following script

<FlexDeploy Home>/apache-tomcat-flexdeploy/bin/startup.sh (startup.bat on Windows)

Step 9Copy plugins from download zip for auto upload. This would be a volume that you had configured during installation process.

Include Page
Copy Plugins for Auto Upload - Migration Guide
Copy Plugins for Auto Upload - Migration Guide

Step 5 . Pull and start new docker image for FlexDeploy.

Code Block
docker pull flexdeploy/fd_tcat_53:5.3.0.0

User same values as used for previous version of FlexDeploy when starting new version of image.

Code Block
docker run --name flexdeploy53 -p 8004:8080 -e FLEX_DB_URL="jdbc:oracle:thin:@129.213.91.244:1521:xe" -e FD_ADMIN_PWD="welcome1" -e TZ=America/Chicago -e dbtype=oracle|postgres|mysql -v /scratch/DockerVolume/flexdeploy:/home/oracle flexdeploy/fd_tcat_53:5.3.0.0


Tip
titleExample JDBC URL (FLEX_DB_URL)

Step 6. Launch FlexDeploy in your browser - http://<hostname>:<port>/flexdeploy

Step 107. There is no need to activate plugins manually. FlexDeploy will automatically upload and activate new versions of plugins once they are copied to plugins folder. You will notice that plugins that you copied in Step 8 will eventually be uploaded automatically and folder will not have any jar files left. You can also look at Administration - Plugins in UI and see newer versions of plugins.