Versions Compared

Key

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

...

Upgrade Instructions

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

  2. 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
    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 was identified in the first step of this document. 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
    tar –cvzf artifact.tar.gz <artifact repository location>


  3. Upgrade the FlexDeploy schemas

    Include Page
    FlexDeploy Schema Upgrade
    FlexDeploy Schema Upgrade


  4. From the FlexDeploy Tomcat distribution, copy /apache-tomcat-flexdeploy/webapps/flexdeploy.war into <TOMCAT_HOME>/webapps (overwrite existing file).

  5. If using the Salesforce integration, from the FlexDeploy Tomcat distribution, copy /apache-tomcat-flexdeploy/lib/ant-salesforce.jar into <TOMCAT_HOME>/lib

  6. 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.

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

  8. Start tomcat by running the following script
    1. <TOMCAT_HOME>/bin/startup.sh (startup.bat on Windows)

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

  10. You should activate newer versions of the Plugins by clicking Activate button as explained below.

    1. Make sure there are no plugin jar files left in folder where you copied new plugin jar files as part step 7 above. It may take few minutes for all plugins to load. If there are still plugin jar files after 10 minutes, please look at logs and contact Flexagon support or upload plugins using Upload button on plugins page.
    2. Go to Administration - Plugins.
    3. You will see newly uploaded plugins on top. Refer to Installed On date.
    4. Activate each new plugin version one at a time. In future versions, plugins will automatically be activated.