Installation Instructions for Hot Fix P38005

Linux for x64


Hot fix P38005 addresses the issue(s) in SAS Web Application Server 9.4 on Linux for x64 as documented in the Issue(s) Addressed section of the hot fix download page:

https://tshf.sas.com/techsup/download/hotfix/HF2/P38.html#P38005


The hot fix downloaded, P38005pt.zip, contains the updated files required to address the documented issues.
This hot fix should be applied to all applicable operating systems on which SAS Web Application Server 9.4 has been installed.

Do NOT extract the contents of P38005pt.zip. The hot fix installation process will extract the contents as needed.

SPECIAL NOTE REGARDING SECURITY VULNERABILITY

This hot fix requires that your software must already be configured prior to installation. If no configuration directory exists at the time of installation, security updates built into this hot fix will not be completed, leaving your software in a vulnerable state.

IMPORTANT NOTES

  1. You must have SAS Web Application Server 9.4 installed on your system before applying this hot fix. Refer to SN-35968 for instructions on how to determine which product releases you have installed.

  2. Before applying this hot fix, please ensure that you have the JAVA_HOME environment variable pointing to a JDK or JRE at version 1.7 or higher. As an example, this environment variable can be set to point to the SAS Private JRE at:
    <SASHome>SASPrivateJavaRuntimeEnvironment/9.4/jre
  3. Files delivered in this hot fix will be backed up during the installation process. However, it is good general practice to back up your system before applying updates to software.

  4. You must have Administrator Privileges on your CLIENT or SERVER machine.

  5. All currently active SAS sessions, daemons, spawners and servers must be terminated before applying this hot fix.

  6. This hot fix should be installed using the same userid who performed the initial software installation.

  7. CONFIGURATION: No automatic configuration scripting is included for this hot fix. If you have previously configured software installed, the SAS Deployment Manager may present a screen where you will see "Apply SAS Hot Fixes" and "Configure SAS Hot Fixes" options. On this screen, you must ensure that the "Configure SAS Hot Fix" option is *not* selected. If this option is automatically selected, please de-select it prior to proceeding with the SAS Deployment Manager Screens. Failure to do so could have unintended consequences when applying this hot fix.


INSTALLATION

The P38005 hot fix for SAS Web Application Server 9.4 will be installed using the SAS Deployment Manager. By default, the SAS Deployment Manager will search in the <SASHOME>/InstallMisc/HotFixes/New directory for hot fixes to be applied, but will also prompt for a location if you have downloaded hot fixes to a different directory.

After downloading P38005pt.zip, follow the instructions for applying hot fixes in the SAS Deployment Wizard and SAS Deployment Manager 9.4: User's Guide.

Please review the CONFIGURATION Important Note above concerning proper selection of the "Configure SAS Hot Fix" option in the SAS Deployment Manager.

The content of this hot fix is listed in the hot fix manifest.


POST-INSTALLATION INSTRUCTIONS

  1. Navigate to <SASHome>/SASWebApplicationServer/9.4/hotfix

    1. Execute the following command:

      activemq_jarfix_m0-lax.sh <SASHome location>

      where <SASHome location> is the full path to SASHome

    2. Examine activemq_jarfix_m0-lax<datetimestamp>.log located in the directory where the tool was executed. The log will contain the configuration directories the tool found specified with the text (SASCONFIG: ). If you have an installation where there are multiple configuration directories and one or more are missing from the log, re-execute the activemq_jarfix_m0-lax tool and specify both SASHome and the SAS Configuration directory.

      For example:

      activemq_jarfix_m0-lax.sh <SASHome location> <SAS Configuration location>
      Note: The tool can safely be run multiple times.

    3. Any errors that are found will be written to the error log located in the same directory that the code is executed from.


IMPORTANT NOTE: If your SAS Web Server is configured for TLS, you will need to install the latest Java 7 Update. Please visit the Updates for Java 7 download page for the latest available updates.

Upgrade-in-place installations or update existing configuration in SAS Deployment Manager:

Due to changes in the xml files during upgrade-in-place scenarios, the SAS Deployment Manager will show a failure during the upgrade of existing configuration for SAS Web Application Server after this hot fix has been applied. In a clustered configuration, this failure could happen on the primary machine and all cluster nodes. When this occurs, leave the SAS Deployment Manager running and use a separate session to make the following change:

  1. For SASServer1, navigate to <SASConfig>/LevX/Web/WebAppServer/SASServer1_?/conf/Catalina/localhost/

    NOTE: The '?' in SASServer1_? can be an integer starting from 1 in a configuration with vertical cluster nodes. If you have custom server names, the server instance names should end with 1_?.

  2. Edit the SASWorkflowServices.xml file as follows:
    Change

    <ResourceLink global="sas/jms/QueueConnectionFactory" name="jms/QueueConnectionFactory" type="org.apache.activemq.ActiveMQConnectionFactory"/>

    to

    <ResourceLink global="sas/jms/QueueConnectionFactory" name="jms/QueueConnectionFactory" type="javax.jms.ConnectionFactory"/>

  3. Once this change has been made, return to the SDM and click the retry button. This should allow the SDM to complete the upgrade configuration task.



This completes the installation of hot fix P38005 on Linux for x64.


Copyright 2018 SAS Institute Inc. All Rights Reserved.