The upgrade steps described in the Perform the PCA upgrade article are the recommended way to upgrade the PCA. However, in some cases the upgrade process may fail, for example when upgrading from a very old version of the PCA. In that situation, uninstalling and re-installing the PCA is recommended.

Uninstall and re-install PCA

The steps below describe how to back up your existing configuration, perform the uninstallation and re-installation, and restore your configuration.

1. Download the PCA RPM package for your Linux distribution from Downloads.
2. Download the preInstall.sh and postInstall.sh scripts attached at the end of this article.

   Note: Use of the scripts is optional. You can back up and restore the configuration files manually instead if you prefer. In most cases there is no need to restore the backed up configuration; the backup is taken as a precaution. The instructions below assume the scripts are being used. Review script contents to see what is being backed up and restored.

3. Stop all Tealeaf processes.

   tealeaf stop all

4. Kill any remaining processes (e.g. memcached).

   ps -ef | head -1 ; ps -ef | grep ctccap | grep -v grep

   kill <space separated list of process IDs returned by previous command>

5. Run preInstall.sh script to back up the PCA configuration.

   ./preInstall.sh

   The script asks for the path where the PCA is currently installed (the default is "/usr/local/ctccap"). Once confirmed, the "/usr/local/ctccap/etc/" folder containing the configuration information is backed up to a new "/usr/local/pca_backup" folder.

   Note: If there are any custom configuration files located outside the "/usr/local/ctccap/etc/" folder these need to be backed up manually.

6. Uninstall the PCA (as root).

   rpm -e tealeaf-pca

7. Install the PCA (as root).

   rpm -ivh tealeaf-pca-3900-04.RHEL7.x86_64.rpm

   Note: The package name depends on the version of the PCA you are installing and the Linux distribution you are using.

8. Start the PCA (as root).

   tealeaf start all

9. Verify that the PCA is working correctly by following the instructions in the "Perform the PCA upgrade" article. In most cases you should NOT need to restore the backed up configuration as the uninstall process should preserve the configuration.
10. If the PCA is not working correctly or the configuration visible in the web console has changed since before the uninstall and re-install, you can restore your backed up configuration manually by running postInstall.sh.

    ./postInstall.sh

    As before, the script asks for the path where the PCA is installed (the default is "/usr/local/ctccap"). Once confirmed, the following files will be restored from the backup with the correct ownership and permissions:

    1 ctc-conf.xml
    2 privacy.cfg
    3 runtime.conf
    4 pktfwdr.conf
    5 spr.conf
    6 httpd.conf
    7 web.users
    8 pipeline.conf

    Note: If any additional configuration files or certificates are required they can be restored manually from the backup in "/usr/local/pca_backup".

11. Validate permissions and ownership.

    Run validation check:tealeaf validate

    This command returns a list of files and folders with incorrect permissions. Correct any issues with chmod and chown and restart the PCA:

    tealeaf stop all

    tealeaf start all