How to Migrate an Existing Install of FileCatalyst Server
Posted by , Last modified by Jeyram Sachchithananthan on 28 March 2022 02:30 PM


If an existing install of FileCatalyst Direct Server 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. 

This resolution is platform-agnostic, so you can change operating systems if required.


FileCatalyst Server v3.0 or later.



  1. Backup the old configuration files:

    The following list of files will be required for the migration from the old machine to the new one. Move them into a folder outside of the install location for now.
    These files and folder 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.
    • wrapper.conf (Linux only): This file is used to configure Java heap and other wrapper properties that impact the service. It is located in /opt/utechsoft/server/conf/ folder.
    • 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.

  2. If a third-party SSL certificate has been deployed into the FileCatalyst Server, the files associated with them need to be migrated as well. It is possible that these files may be located outside of the FileCatalyst Server installation directory. Open the fcconf.conf file in a text editor and search for the properties:

    • FCServer.server.config.private.key=
    • FCServer.server.config.certificate.file=

      These two properties will point to the path where the SSL Certificate and .p12, .key, .pem or .pvk files are located.

  3. Install FileCatalyst Direct Server on the new hardware.

  4. Run the FileCatalyst Server in stand-alone mode to obtain the new request string. There are two methods of getting the request string:
    1. Start the FileCatalyst Server with a UI. 
    2. Alternatively, the FileCatalyst Server can be started from the command line by using the following from the FileCatalyst Server as the working directory:

      java -jar FileCatalystServer.jar

      The software will output the request string to the console. 

    3. Copy and paste this request string into an email and send it to Our Customer Operations department ([email protected]) to obtain a new key.

  5. Import settings to the new FileCatalyst Server:
    1. Shut down the current instance of the FileCatalyst Server, if it is open.
    2. Navigate to the FileCatalyst Server installation directory.
    3. From the backup folder in step 1, copy and overwrite the current files into the FileCatalyst Server installation directory:

      • .fcdb folder
      • fcconf.conf
      • ipfilters.xml
      • wrapper.conf (Linux)
  6. If you are using UNC path mounts or other types of NAS, make sure that this machine has access to them and the user account that you are going to use to launch the FileCatalyst Server Service has sufficient permissions to Read, Write, and Delete. Check that all Firewall rules NAT redirections are properly set up to point to this machine.

  7. Edit the configuration files fcconf.conf(Windows only), wrapper.conf(Linux only) and have the following entry applied if it's not found ""
    This change will ensure to use of the inbuilt Java Runtime Environment (JRE) which is now prepackaged with all our FileCatalyst applications.

    Windows : <path to>\FileCatalyst Server\fcconf.conf  
    Linux: /opt/utechsoft/server/conf/wrapper.conf

  8. Edit the configuration file "fcconf.conf", Replace the existing license with the new license acquired in step 4. c

  9. Start the new FileCatalyst Server in stand-alone mode.

  10. Make sure that your user accounts, network information, ports and IP Masquerade information are properly set up.

  11. If you have used a third-party SSL certificate in the FileCatalyst Server, add them back in from the Security tab.