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
- 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.
- 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
- Download the FileCatalyst Proxy installer.
- Run the executable and install the application in the existing location.
- 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).
- 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.
- 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
- 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
- Download the FileCatalyst Proxy installer.
- 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
- Install the FileCatalyst Proxy Service:
cd /opt/utechsoft/proxy/service_wrapper chmod u+x *.sh ./install.sh
- 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/
- (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.
- Start the Reverse Proxy service using service fcproxy start
|