Installation Instructions for Hot Fix R94007

Windows for x64


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

https://tshf.sas.com/techsup/download/hotfix/HF2/R94.html#R94007


The hot fix downloaded, R94007pt.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.41 has been installed.

Do NOT extract the contents of R94007pt.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.41 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 on a Windows system, 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 R94007 hot fix for SAS Web Application Server 9.41 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 R94007pt.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

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.
Update to sas.vfabrictcsvr.jar
  1. Stop all mid-tier servers.

  2. Copy <SASHome>/SASWebApplicationServer/9.4/hotfix/sas.vfabrictcsvr.jar to the <SASConfig>/Lev1/Web/WebAppServer/SASServer1_1/lib/ directory.

  3. Repeat Step 2 for each SASServer1_<X> instance (where <X> indicates the server instance number, eg: SASServer1_6) by copying the sas.vfabrictcsvr.jar to the corresponding SASServer1_<X>/lib directory.

  4. Copy <SASHome>/SASWebApplicationServer/9.4/hotfix/sas.vfabrictcsvr.jar to the <SASHome>/SASDeploymentManager/9.4/products/cfgwizard__94496__prt__xx__sp0__1/Utilities/AppServer/Source/Config/vfabrictcsvr/jars/sas/ directory.

    NOTE: If you find multiple <SASHOME>/SASDeploymentManager/9.4/products/cfgwizard* directories, copy the sas.vfabrictcsvr.jar to the cfgwizard* directory that contains the highest number in its naming string.

  5. Restart all mid-tier servers including each SASServer1_<X> instance where the jar was copied.


This completes the installation of hot fix R94007 on Windows for x64.


Copyright 2019 SAS Institute Inc. All Rights Reserved.