Upgrading FileCatalyst Webmail
Posted by Greg Pettit on 18 December 2007 11:08 PM

NOTE: As of summer 2015, Webmail is discontinued. Java Applets have also been discontinued by several browsers including Chrome and Edge. Only critical bugs will be addressed in Webmail until Aug 30th, 2016. We recommend strongly to upgrade to Workflow as soon as possible.

FileCatalyst Workflow is the replacement product and comes with an Integrated TransferAgent file transfer plugin which does not require Java Applets.

This article describes the entire base upgrade process when upgrading an existing FileCatalyst Webmail installation. It assumes that FileCatalyst Webmail is deployed on Apache Tomcat. Note that there are additional instructions for upgrading from 3.5.3 to 3.5.4 and above. If you are already at 3.5.4+, those additional instructions may be disregarded.

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.

* To update, first download the latest WAR file from our web site:

  • FileCatalyst Webmail file - (please contact us to request username/password for this page)

Once the WAR is downloaded, proceed with the backup and upgrade:

  1. Log into FileCatalyst Webmail as Super Admin. 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. Unzip fcweb.war from the zip file and place it in /Tomcat-Home/webapps/, overwriting the existing file
  6. Delete the /Tomcat-Home/webapps/files2u or fcweb directory
  7. Delete the /Tomcat-Home/work/Catalina directory
  8. Start Tomcat; Tomcat will redeploy the new WAR file and make a new directory /Tomcat-Home/webapps/files2u or fcweb
  9. Open your web browser and access the application as usual; or if you are on the server console, go to http://localhost/files2u or http://localhost:8080/files2u or http://localhost/fcweb or http://localhost:8080/fcweb (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. Application will re-initialize and all your previous settings will be intact

** The following instructions apply during an upgrade from 3.5.3 to a later version:

* You will need to reset your page template, or certain functions will be masked. Log in as Super Admin, click on Configuration, then "Change Template"; select the template that you have been previously using.

    • If you have made a custom template see the following article:
    • Note: For the purposes of this article, changing the header or a footer or setting a logo doesn’t mean that you’ve customized the page template. In these cases you can just reset your template to the default option.
    • Log in as Super Admin
    • Go to "Configuration"
    • Select "edit language file"
    • Click in the edit pane and search for a line starting with "" (ctrl-F pops up the text search in most browsers)
    • Replace the entire line with this one below:{0} has sent you {1} file(s).
    • Now, a recipient visiting their download link will see the more sensical message:

        {Name} has sent you {number} file(s).
        ex: Joe Doe has sent you 5 file(s).