Installation Instructions for Hot Fix E83003

Windows


*** Please see the disclaimer regarding this experimental fix at the bottom of this page. ***


Hot fix E83003 addresses the issue(s) in SAS Solutions Services Mid-Tier 5.2_M1 on Windows as documented in the following SAS Note(s)

43896   Property searches might require a long amount of time to complete in the Document Manager
44203   Adding content to SAS® Performance Management Solutions 'My Favorites' portlet might require a long time to complete


INSTALLATION

Important Notes

  1. You must have SAS Solutions Services Mid-Tier 5.2_M1 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. 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.

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

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

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


Downloading the hot fix

  1. When downloading SAS 9.2 hot fix packages, you must choose to Save the hot fix to disk, then execute the install from the saved location. Attempting to install a hot fix directly from the download page results in the error documented in SAS Note 37104.

  2. The installer downloaded is E83003wn.exe.


Prior to executing the hot fix shut down the SAS servers

  1. Log on to the WebLogic Server Administration Console at
    http://midtierservername:7501/console

  2. On the left side of the screen under Domain Structure, select Environment > Servers

  3. Select the Control tab

  4. Select SAS Servers 3, 4 and 5 and click Shutdown > Force Shutdown Now > Yes

  5. Exit out of all Microsoft Office applications.

  6. Exit out of SAS Financial Management Studio, the SAS Financial Management Add-In for Microsoft Excel and the SAS Information Delivery Portal.


Installing the hot fix

  1. Select Start > Run and enter cmd to invoke a command prompt.

  2. Change your directory to the location where E83003wn.exe was saved (c:\temp in the following example) and enter the following
    C:\temp> E83003wn.exe -alwaysoverwrite
    to invoke the SAS Maintenace Install Tool. The wizard will guide you through the application of the hot fix. Accept the defaults, select ‘Start Install’ when prompted, and be sure to select ‘Finish’ when you are prompted with ‘Installation Complete’.


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


See the Maintenance Installation Tool (MIT) documentation for more details on the installation of hot fixes.


This completes the installation of E83003. You must perform any "Post-Installation Instructions" documented below to successfully complete the deployment of this hot fix.


POST-INSTALLATION INSTRUCTIONS

Updates provided in this hot fix require that the following Web Applications be rebuilt and redeployed.
Server 3: SAS Strategy Management Mid-Tier
Server 3: SAS Financial Management Mid-Tier
Server 3: SAS Solutions Services Mid-Tier
Server 4: SAS OLAP Data and Compute Server Mid-Tier for Solutions
Server 5: SAS Financial Management Web Data Entry


Re-build Web Application

In order for this step to execute correctly, the Metadata Server must be running.

  1. Invoke the SAS Deployment Manager 9.2

    From the SASDeploymentManager directory launch config.exe.
    SAS Deployment Manager is installed in the following default location:

    <SASHOME>\SASDeploymentManager\9.2

  2. Select a language in the Choose Language box

  3. Select Rebuild Web Applications

  4. Select Configuration Directory or Enter the Configuration Directory and Level that needs to be updated

  5. Specify Connection Information, including the sasadm User ID and Password

  6. Select the mid-tier applications listed above as the Web Applications to Rebuild

  7. Verify the information on the Summary screen and select Start

  8. Select Finish when the deployment is complete
This process will update the ears in
<SASCONFIGDIR>\Web\Staging
A backup of the original ear files will be placed in the directory
<SASCONFIGDIR>\Web\Staging\Backup


Re-deploy Web Application

  1. Remove the cache for the updated ear files under
    <drive>:\SAS\Config\Lev1\Web\SASDomain\servers\SASServer4\tmp\_WL_user
    (delete entire folder for each ear file)

  2. Re-deploy the web application using WebLogic Admin console.

    To deploy this application it is important to deploy from <SASCONFIGDIR>\Web\Staging.

    Verify that in the settings overview tab for the SAS Strategy Management Mid-Tier ear file to be re-deployed that the deployment order is set to 110.

    Verify that in the settings overview tab for the Financial Management Mid-Tier and Financial Management Web Data Entry ear files to be re-deployed that the deployment order is set to 110.

    Verify that in the settings overview tab for the Solutions Services Mid-Tier and OLAP Data and Compute Server Mid-Tier for Solutions ear files to be re-deployed that the deployment order is set to 100.


Re-start the Web Application Servers

  1. Re-start SAS Remote Services (which will likely require that you also re-start SASServer1 and SASServer2).

  2. Re-start SASServer3 and SASServer4 (you will likely also need to re-start SAS Server5 since the other application servers were stopped).

  3. From Weblogic Admin Console, select SASServer 3, 4, and 5 > Start > Yes


This completes the installation of hot fix E83003 on Windows.



SAS Institute Inc.

License Agreement for Corrective Code or Additional Functionality

SAS INSTITUTE INC. IS PROVIDING YOU WITH THE COMPUTER SOFTWARE CODE INCLUDED WITH THIS AGREEMENT ("CODE") ON AN "AS IS" BASIS, AND AUTHORIZES YOU TO USE THE CODE SUBJECT TO THE TERMS HEREOF. BY USING THE CODE, YOU AGREE TO THESE TERMS. YOUR USE OF THE CODE IS AT YOUR OWN RISK. SAS INSTITUTE INC. MAKES NO REPRESENTATION OR WARRANTY, EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NONINFRINGEMENT AND TITLE, WITH RESPECT TO THE CODE.

The Code is intended to be used solely as part of a product ("Software") you currently have licensed from SAS Institute Inc. or one of its subsidiaries or authorized agents ("SAS"). The Code is designed to either correct an error in the Software or to add functionality to the Software, but has not necessarily been tested. Accordingly, SAS makes no representation or warranty that the Code will operate error-free. SAS is under no obligation to maintain or support the Code.

Neither SAS nor its licensors shall be liable to you or any third party for any general, special, direct, indirect, consequential, incidental or other damages whatsoever arising out of or related to your use or inability to use the Code, even if SAS has been advised of the possibility of such damages.

Except as otherwise provided above, the Code is governed by the same agreement that governs the Software. If you do not have an existing agreement with SAS governing the Software, you may not use the Code.

SAS and all other SAS Institute Inc. product or service names are registered trademarks or trademarks of SAS Institute Inc. in the USA and other countries. (r) indicates USA registration. Other brand and product names are registered trademarks or trademarks of their respective companies.