How to Upgrade FileCatalyst Workflow
Posted by Aly Essa, Last modified by Aly Essa on 13 April 2017 11:01 AM

Overview

This article describes how to upgrade an existing FileCatalyst Workflow installation to the latest release version. It is assumed that Workflow is deployed on Apache Tomcat. Please note if after your upgrade your Language File entries do not show, you will need to restart the Tomcat Web Server.

Environment

FileCatalyst Workflow v4.7 and later.

Resolution

Download Update:

You will need the latest WAR file from our website http://download.filecatalyst.com.

Contact your FileCatalyst Sales Representative in order to obtain a username and password. Locate and download the FileCatalyst Workflow application called fcwebworkflow_war.zip.

Upgrade Instructions:

  1. Log in as Super Admin to FileCatalyst Workflow. Click on the About FileCatalyst icon and make a note of the path to your Configuration Folder. Look for it in the field named Configuration Path.
  2. Stop Tomcat service.
  3. Make a backup copy of the Configuration Folder.
  4. Make a backup of MySQL Database, using a MySQL dump tool, or by any other method that you find convenient.
  5. Backup workflow.war and /workflow folder to a location outside of Tomcat. This folder and WAR file are located in /<Tomcat-Home>/webapps/
  6. Delete the workflow.war and /workflow folder from /<Tomcat-Home>/webapps/.
  7. Unzip the workflow.war from the fcwebworkflow_war.zip file and place it in /<Tomcat-Home>/webapps/.
  8. Delete the /<Tomcat-Home>/work/Catalina directory.
  9. Start Tomcat service. Tomcat will re-deploy the new WAR file and make a new directory /<Tomcat-Home>/webapps/workflow/ automatically.
  10. Open a web browser of your choice and access FileCatalyst Workflow as usual. 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 with the password aaaaa.
  12. Click on the button for Existing or Custom Configuration Folder.
  13. Enter the path you noted in Step 1 from the Configuration Path.
  14. FileCatalyst Workflow will re-initialize and all your previous settings will be imported into the new deployment.

Roll-Back Guide

  1. Stop the Tomcat service.
  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 into /<Tomcat-Home>/webapps/ folder.
  6. You can either backup the existing configuration folder or delete it.
  7. Place the previously backup Configuration Folder in the original location.
  8. Start the Tomcat service. Tomcat will redeploy the WAR file and make a new directory /<Tomcat-Home>/webapps/workflow/ automatically.
  9. Open a web browser of your choice and access FileCatalyst Workflow as usual. 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 with the password aaaaa.
  11. Click on the button for Existing or Custom Configuration folder.
  12. Enter the path you noted in Step 1 from the Configuration Path.
  13. FileCatalyst Workflow will re-initialize and all your previous settings will be imported into the new deployment.