How to Upgrade FileCatalyst Server in a Windows Environment
Posted by Aly Essa, Last modified by Aly Essa on 22 May 2018 09:14 AM

Overview

The following article describes how to perform an upgrade of FileCatalyst Server. While the installer itself will operate gracefully under most situations, the following steps will provide the maximum insurance that no steps are being overlooked. The article assumes that the application is set to run as a service.

Environment

FileCatalyst Server v3.4 and later.

 

Resolution

  1. Shut down the application:

    1. Stop the service:
      1. Close all FileCatalyst Remote Admin Applications.
      2. Hit Start and open the Run command.
      3. Open the Service Manager console opening services.msc.
      4. Scroll down to FileCatalyst Server and hit Stop.

    2. Stand-alone:
      1. Close the FileCatalyst Remote Admin Application by clicking on File and selecting Exit Administration.
      2. Check the system tray to for any other open sessions of the Remote Admin Application.

  2. Backup the old configuration files:

    The following list of files will be required for the rest of the upgrade. Move them into a folder outside of the install location for now.
    These files and folders will be located in the root of the installation directory of the FileCatalyst Server:

    • .fcdb folder: This folder is hidden on some operating systems and contains the database information.
    • fcconf.conf: This file contains most of the settings that belong to the FileCatalyst Server and your license.
    • ipfilters.xml: The contents of this file contain the IP access rules to the FileCatalyst Server.
    • users.xml: This file will only exist on deployments older than v3.0. It has been replaced by the .fcdb.
    • authentication.xml: This file will only exist on deployments older than v3.0. It has been replaced by the .fcdb.
    • backup folder: Archived copies of the configuration files are stored in this folder.
     
  3. Run the installer of the new build. If you intend to use the same configuration and data, the installation path should match the current one.

  4. Replace back backup files from step 2. This step is optional for Windows, as the installer should not overwrite configuration files if it already finds them on the system. 

  5. Edit the fcconf.conf and modify the wrapper.java.command=java. This will force the system to push the location of your Java 8 installation. Save the file and close it.

  6. Once the installer has finished, run the application in stand-alone mode. As the application runs, watch to see that it is successfully opening the data and administration ports. You will see warnings if these ports do not open, both in dialogue boxes and at the bottom of the GUI.

  7. If you intend to run the FileCatalyst Server as a service, install the service by selecting Run at Startup from the File menu.

  8. Close the GUI by clicking File and selecting Exit FileCatalyst Server Administration.

  9. Start the service from the Service Manager:
    1. Hit Start and open the Run command.
    2. Open the Service Manager console opening services.msc.
    3. Scroll down to FileCatalyst Server and hit Start.

  10. Launch the FileCatalyst Remote Admin Application (FCServerAdmin.exe) to connect to the FileCatalyst Server service.