Knowledgebase
Upgrading FileCatalyst Workflow
Posted by Greg Pettit on 06 March 2008 08:42 PM

* This article describes how to upgrade an existing FileCatalyst Workflow installation. It is assumed that Workflow is deployed on Apache Tomcat.

New License Key. Upgrading from version 3.x.x to 4.x.x will require a new set of license keys. Please contact your FileCatalyst representative with a license request string to obtain your new license key.

* Version History: http://support.filecatalyst.com/index.php?/Knowledgebase/Article/View/35/13/filecatalyst-webmail-and-workflow-release-notes

* To update, you will need the latest WAR file from our web site: http://download.filecatalyst.com Contact your FileCatalyst representative in order to obtain a username and password; then, locate and download the FileCatalyst Workflow application (fcwebworkflow_war.zip).

  1. Log in as Super Admin to FileCatalyst Workflow. Click on the "About" page, and make a note of the path to your configuration folder
  2. Stop Tomcat
  3. Make a backup copy of the configuration folder.
  4. Make a backup of MySQL Database, using mysqldump tool, or by any other method that you find convenient.
  5. Backup workflow.war and workflow folder to a location outside of Tomcat.
  6. Unzip workflow.war from the zip file and place it in /Tomcat-Home/webapps/, overwriting the existing file
  7. Delete the /Tomcat-Home/webapps/workflow directory
  8. Delete the /Tomcat-Home/work/Catalina directory
  9. Start Tomcat; Tomcat will redeploy the new WAR file and make a new directory /Tomcat-Home/webapps/workflow
  10. Open your web browser and access FileCatalyst Workflow as usual; or if you are on the local machine, go to http://localhost/workflow or http://localhost:8080/workflow (assuming the Tomcat default port 8080; otherwise, substitute an appropriate port)
  11. Log in with username "Init" and password "aaaaa"
  12. Click on the button for Existing or Custom Configuration folder
  13. Enter the path you noted in Step 1
  14. FileCatalyst Web Workflow will re-initialize and all your previous settings will be intact



*To roll back to a previous version of the application you need to do the following steps.

  1. Stop Tomcat
  2. Delete the /Tomcat-Home/webapps/workflow directory
  3. Delete the /Tomcat-Home/webapps/workflow.war file
  4. Delete the /Tomcat-Home/work/Catalina directory
  5. Place the backup version of workflow.war in the /Tomcat-Home/webapps/ folder
  6. You can either backup the existing config folder (workflow-config) or delete it
  7. Place the previously backup config folder in the original location.
  8. Start Tomcat; Tomcat will redeploy the WAR file and make a new directory /Tomcat-Home/webapps/workflow
  9. Open your web browser and access FileCatalyst Workflow as usual; or if you are on the local machine, go to http://localhost/workflow or http://localhost:8080/workflow (assuming the Tomcat default port 8080; otherwise, substitute an appropriate port)
  10. Log in with username "Init" and password "aaaaa"
  11. Click on the button for Existing or Custom Configuration folder
  12. Enter the path you noted in Step 1
  13. FileCatalyst Workflow will re-initialize and all your previous settings will be intact




Comments (0)