Reverse Proxy Backup and Upgrade Guide
Posted by Aly Essa, Last modified by Aly Essa on 05 May 2020 11:04 AM

Overview

This article will cover the steps needed to back up your Reverse Proxy configurations and upgrade the deployment.

Use the links below to access to get access to upgrade guide for your OS:


Environment

FileCatalyst Reverse Proxy

Resolution


Windows

  1. Backup

    Before you proceed please make sure your Reverse Proxy is shut down properly. Open the Windows Service Manager (services.msc) and stop the FileCatalyst Proxy service.

    These files and folders below will be located inside your installation directory. By default, the Windows installation path is C:\Program Files\FileCatalyst Proxy\. Move the following files to a safe location:

    • backup folder: This folder stores previous copies of your fcproxy.conf
    • fcproxy.conf: This file contains your Reverse Proxy configurations.
    • wrapper.conf: This file contains the Java additional properties and any changes made to the Service Wrapper.

  2. SSL Certificates (optional)

    If third-party SSL certificates have been installed you will need to move them to the backup location as well. Open the fcproxy.conf file in a text editor locate the following parameters and move files specified in the paths to your backup directory:

    # Use these values to enable SSL Security on the TCP channels
    FC.proxy.config.certificate.file=/path/to/your/certificate.pem
    FC.proxy.config.private.key=/path/to/your/privatekey.pvk

  3. Download the FileCatalyst Proxy installer.
  4. Run the executable and install the application in the existing location.
  5. Once the installation is complete, you can start the FileCatalyst Proxy from the Windows Service Manager (services.msc)


Linux

Note: All commands run in the terminal window will require elevated privileges (sudo).

  1. Backup

    Before you proceed please make sure your Reverse Proxy is shut down properly. In your terminal run ps -ef | egrep -i "wrapper|fc|proxy" and shut down all processes.

    These files and folders below will be located inside your installation directory. By default, the Linux installation path is /opt/utechsoft/proxy/

    • backup folder: This folder stores previous copies of your fcproxy.conf
    • fcproxy.conf: This file contains your Reverse Proxy configurations.
    • wrapper.conf: This file contains the Java additional properties and any changes made to the Service Wrapper.

  2. Execute the following commands to back up configuration files:

    cd /opt/utechsoft/proxy
    mkdir ./upgrade
    mkdir ./upgrade/backup

    cp ./fcproxy.conf ./upgrade
    cp ./conf/wrapper.conf ./upgrade
    cp ./backup/* ./upgrade/backup/


    If the start/stop scripts have been modified, these must be saved:

    cd /opt/utechsoft/proxy
    cp *.sh ./upgrade

  3. SSL Certificates (optional)

    If third-party SSL certificates have been installed you will need to move them to the backup location as well. Open the fcproxy.conf file in a text editor locate the following parameters and move files specified in the paths to your backup directory:

    # Use these values to enable SSL Security on the TCP channels
    FC.proxy.config.certificate.file=/path/to/your/certificate.pem
    FC.proxy.config.private.key=/path/to/your/privatekey.pvk

  4. Download the FileCatalyst Proxy installer.

  5. Extract the TAR/ZIP and set permissions:

    cd /opt/utechsoft/proxy
    gunzip ./fc_proxy.tar.gz
    tar -xvf ./fc_proxy.tar

    Set execute permissions on the launch scripts:

    cd /opt/utechsoft/proxy
    chmod u+x *.sh

  6. Install the FileCatalyst Proxy Service:

    cd /opt/utechsoft/proxy/service_wrapper
    chmod u+x *.sh
    ./install.sh


  7. Restore your configuration files from your backup:

    cp /opt/utechsoft/proxy/upgrade/fcproxy.conf /opt/utechsoft/proxy/
    cp /opt/utechsoft/proxy/upgrade/wrapper.conf /opt/utechsoft/proxy/conf/ 

  8. (Optional) If you backed up your SSL Certificates in step 3, copy them back to where they were originally stored. The fcproxy.conf will reference the path where they are going to be accessed from.

  9. Start the Reverse Proxy service using service fcproxy start