Instances of SAS® Web Application Server fail to start after you apply Hot Fix E3V006 and later


After you apply Hot Fix E3V006 and later, instances of SAS Web Application Server might fail to start. When this happens, SAS Web Application Server generates errors in the server.log file that are similar to the following errors:

2020-10-15 10:45:40,805 WARN (main) [com.springsource.tcserver.security.TcDecoder] Using tcenc:// for property encoding is deprecated and has been removed as of 4.1.0. Please use pbkdf2:// instead

2020-10-15 10:45:40,892 FATAL (main) [com.springsource.tcserver.security.PropertyDecoder] Unable to decode key: pw.sas.jdbc.themes

2020-10-15 10:45:41,125 WARN (main) [com.springsource.tcserver.security.TcDecoder] Using tcenc:// for property encoding is deprecated and has been removed as of 4.1.0. Please use pbkdf2:// instead

2020-10-15 10:45:41,172 FATAL (main) [com.springsource.tcserver.security.PropertyDecoder] Unable to decode key: pw.sas.jdbc.themecontent

2020-10-15 10:45:41,376 WARN (main) [com.springsource.tcserver.security.TcDecoder] Using tcenc:// for property encoding is deprecated and has been removed as of 4.1.0. Please use pbkdf2:// instead

2020-10-15 10:45:41,421 FATAL (main) [com.springsource.tcserver.security.PropertyDecoder] Unable to decode key: pw.sas.jdbc.SharedServices

In addition, the following error is displayed:

Caused by: org.postgresql.util.PSQLException: FATAL: password authentication failed for user "SharedServices"

This issue can occur under either of the following circumstances:

To resolve the issue:

  1. Stop all instances of SAS Web Application Server, as follows:
    • In Windows operating environments: Stop SASServerN_N by using Windows Services.
    • In Linux operating environments: Submit this command:
      SAS-configuration-directory/Lev1/Web/WebAppServer/SASServerN_N/bin/tcruntime-ctl.sh stop
  2. Locate the catalina.properties file, which resides in these locations:
    • Under Linux: SAS-configuration-directory/Lev1/Web/WebAppServer/SASServerN_N/conf/

    • Under Windows: SAS-configuration-directory\Lev1\Web\WebAppServer\SASServerN_N\conf\

  3. For each sas.pw encoding value in the catalina.properties file, change tcEnc:// back to pbkdf2​​​​​://.

  4. Restart all instances of SAS Web Application Server, as follows:
    • Under Windows: Start SASServerN_N using Windows Services

    • Linux command: SAS-configuration-directory/Lev1/Web/WebAppServer/SASServerN_N/bin/tcruntime-ctl.sh start