How to Migrate an Existing Install of Webmail or Workflow
Posted by Aly Essa, Last modified by Aly Essa on 18 July 2019 09:24 AM

Overview

If an existing install of FileCatalyst Workflow and Webmail needs to be moved/migrated/changed to an install on a new machine and the existing settings need to be maintained. This guide will provide instructions on how to backup your settings and export them to a new machine. 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.9 and later.

FileCatalyst Webmail v4.9 and later.
 

Resolution

  1. Backup configuration and settings.

    1. Database
      1. If you are using an Internal HSQL DB, this will be copied in the next set of steps.
      2. If you utilize a MySQL DB, it is recommended that you use MySQL Workbench or a MySQL command line to take a full backup of the database.

    2. Workflow or Webmail Configuration.
      1. Log into the FileCatalyst Workflow or Webmail deployment as the Super Admin User.
      2. Click on About FileCatalyst on the top menu bar.
      3. The path listed under Configuration Path will be the location of your deployment.
      4. Copy this folder to the new machine.

    3. Web Server Settings
      1. Shut down the Tomcat Web Server service.
      2. Navigate to the Tomcat installation folder and copy the /<path to Tomcat>/conf/ folder to the new deployment.
      3. Move into the /<path to Tomcat/webapps/ROOT/, copy the contents of this folder to your new deployment. This folder will maintain your redirectors if they have been setup.

    4. SSL Certificated (optional)
      1. Backup your SSL Certificate Directory to your new machine.
      2. Open the <path to Tomcat>/conf/server.xml in a text editor.
      3. Search for the element in your SSL connector that has the following:

        keystoreFile="c:\tomcat-ssl\.keystore"

        The path after the equal sign will point to the SSL directory.

    5. Data
      1. If a FileCatalyst Direct Acceleration Server is being used then you can skip this step as the FileCatalyst Server contains the path to the storage device.
      2. If you are using the Internal FTP only FileCatalyst Server storage you can get the path to that from the Remote Admin Applet located inside the FC Servers / Script Execution page.
        Copying the contents of your whole FTP directory could take a while depending on the size of the directory.

  2. Install Log Rotation for Tomcat on the new server (only if you are using log rotation) using this guide: 

    http://support.filecatalyst.com/index.php?/Knowledgebase/Article/View/29/0/rotating-stdout-logfiles-with-tomcat

  3. Migration

    1. Tomcat Web Server
      1. Install Tomcat 9.0.X new machine. 
      2. Restore the backup of the Root folder back into /<path to Tomcat/webapps/ROOT/.
      3. Edit the <path to Tomcat>/conf/server.xml with the connector information from your old server.xml file.
      4. If you have SSL Certificates you can import them using Step 7 from this guide and your backed up SSL Certificate files:

        http://support.filecatalyst.com/index.php?/Knowledgebase/Article/View/295/66/tomcat-csr-and-ssl-certificate-installation-and-renewal

    2. MySQL DB
      1. Install MySQL Server and Workbench if you used this tool to manage your database.
      2. Restore your old database using Workbench or MySQL command line tools.

    3. FileCatalyst Workflow or Webmail
      1. Download the latest version of workflow.war or fcweb.war from our download page.
      2. Copy this WAR file into the /<path to Tomcat/webapps/ directory.
      3. Modify the Tomcat web.xml file using this guide to prevent JSP Servlet Errors.
      4. Start the Tomcat Web Server Service.
      5. Access the Workflow or Webmail landing page. You should see a default demo landing page.
      6. Login using init and the password aaaaa.
      7. When prompted choose a Custom Directory to use an Existing Setup.
      8. Specify the path to the configuration for folder and hit Change Folder and Restart.
      9. From the Modify Configuration menu, click on the Licenses link and provide your Sales Representative with the request string. Enter the License key here and hit Save.
      10. Under the System Restart section hit the Restart System link. This will remove the Demo Banner.

Note:

  • Make sure all your NAT devices and Ports point to this machine.