Page Comparison

...

1. Stop your existing FlexDeploy Tomcat server from OLD_TOMCAT_HOME. 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. Extract the zip file in the desired location (referred to as "FlexDeploy Home"). This should be an empty directory, and not unzipped over an existing install.
   
   
4. Upgrade the FlexDeploy schemas
   
   

   Include Page
   FlexDeploy Schema Upgrade FlexDeploy Schema Upgrade

   
   
   

5. Copy the Tomcat configuration files from your existing install (OLD_TOMCAT_HOME) to the new FlexDeploy Home. This will make sure that new installation points to your existing Database and existing Working folder & Artifact Repository.

   Info
   title Windows
   Copy <OLD TOMCAT_HOME>/conf/context.xml to <FlexDeploy Home>/apache-tomcat-flexdeploy/conf/context.xml Copy <OLD TOMCAT_HOME>/conf/server.xml to <FlexDeploy Home>/apache-tomcat-flexdeploy/conf/server.xml Copy <OLD TOMCAT_HOME>/bin/setenv.bat to <FlexDeploy Home>/apache-tomcat-flexdeploy/bin/setenv.bat

   
   

   Info
   title Linux
   Copy <OLD TOMCAT_HOME>/conf/context.xml to <FlexDeploy Home>/apache-tomcat-flexdeploy/conf/context.xml Copy <OLD TOMCAT_HOME>/conf/server.xml to <FlexDeploy Home>/apache-tomcat-flexdeploy/conf/server.xml Copy <OLD TOMCAT_HOME>/bin/setenv.sh to <FlexDeploy Home>/apache-tomcat-flexdeploy/bin/setenv.sh chmod +x <FlexDeploy Home>/apache-tomcat-flexdeploy/bin*.sh

   
   

6. If using the Salesforce integration, from the FlexDeploy Tomcat distribution, copy /apache-tomcat-flexdeploy/lib/ant-salesforce.jar into <TOMCAT_HOME>/lib
   
   
7. 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.
      
      

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

9. Start tomcat by running the following script
   
   1. <FlexDeploy Home>/apache-tomcat-flexdeploy/bin/startup.sh (startup.bat on Windows)
      
      
10. Launch FlexDeploy in your browser
    1. http://<hostname>:<port>/flexdeploy
    2. default credentials are fdadmin/welcome
       
       

11. 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 8 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.