Upgrading PCA with user authentication

If your PCA is operating in a Tealeaf® environment where user authentication is enabled, more steps in the upgrade process might be required.

About this task

Before PCA version 3200, major changes were implemented to the way user authentication is configured. Upgrading from PCA 31xx to a 32xx or 33xx build is more complex if user authentication is enabled. The following steps are required to upgrade:

Procedure

  1. Make a copy of /usr/local/ctccap/etc:
    
    mkdir /root/tmp
    cp -r /usr/local/ctccap/etc /root/tmp
    
  2. Remove the existing tealeaf-pca package. Remove the remaining files in /usr/local/ctccap:
    
    rpm -e tealeaf-pca
    cd /usr/local/ctccap
    rm -rf *
    
    Note: Verify that you are in the correct directory before you run the rm command.
  3. Install the new PCA package:
    
    rpm -ivh tealeaf-pca-3315.rpm
    
  4. Copy the original ctc-conf.xml, privacy.cfg and any *.ptl files to /usr/local/ctccap/etc. If prompted, overwrite the current files:
    
    cd /root/tmp/etc
    cp ctc-conf.xml privacy.cfg *.ptl /usr/local/ctccap/etc
    
  5. Copy httpd.users file to /usr/local/ctccap/etc and to tealeaf-web.users:
    
    cp httpd.users /usr/local/ctccap/etc
    cd /usr/local/ctccap/etc
    cp httpd.users tealeaf-web.users
    
  6. Edit /usr/local/ctccap/etc/runtime.conf, and add the following lines to the end of the file:
    
    httpd_userauth_enable="YES"
    httpd_userauth_realm="Tealeaf PCAv2"
    httpd_userauth_require="valid-user"
    httpd_userauth_type="Basic"
    
  7. Start httpd.
    
    tealeaf start all
    
  8. Verify that the web console is running and that user authentication is still enabled. Verify that capture is running.
  9. The upgrade is complete.