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:

• Windows
• Linux

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