Page Comparison

This page provides instructions for upgrading a FlexDeploy installation to the latest version.

Upgrade Instructions

• Stop the Tomcat server. Use shutdown.sh on Linux and shutdown.bat on Windows.
  
  

• Backup the FlexDeploy schemas and Artifact Repository. In case you need to back out FlexDeploy, you can use these backup data.
  
  For back-out purposes, it is highly recommended that a database backup of the Oracle database be taken using standard tools like RMAN. Another option would be to export the FD, FD_ADMIN, and FF schemas using data pump. The schemas can be exported using the following data pump command:

  Tip
  title Backup Database
  expdp system directory=DATA_PUMP_DIR dumpfile=fd_bkup.dmp schemas=FD,FF,FD_ADMIN If this database is exclusively used for just FlexDeploy application, you can rely on Database backup and recovery processes (RMAN) instead of export data procedure.

  It is recommended that a backup of the artifact repository file system be taken in case a back-out is required. The location of the artifact repository can be identified by looking at value of -Dflexagon.fd.repository.root in setenv.sh or setenv.bat file. This file will be in <FlexDeploy Home>/apache-tomcat-flexdeploy/bin/. Standard file backup procedures can be followed. Optionally, the following command (unix only) can be used to create a tar file backup of the entire directory.

  Tip
  title Backup Artifact Repository
  tar –cvzf artifact.tar.gz <artifact repository location>

  
  

• Upgrade the FlexDeploy schemas
  
  

  Include Page
  FlexDeploy Schema Upgrade FlexDeploy Schema Upgrade

  
  
  
• From the FlexDeploy Tomcat distribution, copy /apache-tomcat-flexdeploy/webapps/flexdeploy.war into <TOMCAT_HOME>/webapps (overwrite existing file).
  
  
• If using the Salesforce integration, from the FlexDeploy Tomcat distribution, copy /apache-tomcat-flexdeploy/lib/ant-salesforce.jar into <TOMCAT_HOME>/lib
  
  
• Configure Tomcat logging as per Tomcat Logging Setup.

...

• If using IBM ClearCase, you will need to copy some jar files from your ClearCase server to the FlexDeploy installation
  1. Copy all of the jar files found in the com.ibm.rational.teamapi_8.0.1.vxxx folder of your ClearCase server to <FlexDeploy Home>/apache-tomcat-flexdeploy/lib.
     
     

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

• Start tomcat by running the following script
  
  1. <TOMCAT_HOME>/bin/startup.sh (startup.bat on Windows)
     
     
• Launch FlexDeploy in your browser - http://<hostname>:<port>/flexdeploy
  
  

• There is no need to activate plugins with FlexDeploy 4.5 after Step 8. FlexDeploy will automatically upload and activate new versions of plugins once they are copied to plugins folder.