Installation Instructions for Hot Fix H15003

Windows for x64


Hot fix H15003 addresses the issue(s) in SAS Social Network Analysis Mid-Tier 2.3_M1 on Windows for x64 as documented in the Issue(s) Addressed section of the hot fix download page:

http://ftp.sas.com/techsup/download/hotfix/HF2/H15.html#H15003


The hot fix downloaded, H15003pt.zip, contains the updated files required to address the documented issues.
Do NOT extract the contents of H15003pt.zip. The hot fix installation process will extract the contents as needed.


IMPORTANT NOTES

  1. You must have SAS Social Network Analysis Mid-Tier 2.3_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.


INSTALLATION

The H15003 hot fix for SAS Social Network Analysis Mid-Tier 2.3_M1 will be installed using the SAS Deployment Manager (SDM). By default, the SDM 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 H15003pt.zip, follow the instructions provided in the SAS Deployment Wizard/SAS Deployment Manager 9.3: User’s Guide; see the Applying Hot Fixes for Windows and UNIX section in Chapter 5 -- SAS Deployment Manager Tasks to complete the installation of the hot fix.

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


POST-INSTALLATION INSTRUCTIONS

Note that this instructions provide example filenames and directory names based on a Unix deployment; if your deployment is to a different host OS please make the appropriate adjustments.

Web application Update

This hot fix requires steps that will update the web application deployed to your application server.

Step 1: Stop the JBoss Server
1.1 Using the Instructions.html located in <SASConfig>/Lev1/Documents, review the section labeled "Web Application Server". Located in that section are instructions for stopping the Web Application Server. An example of the command to shutdown SASServer8 on using JBoss is:

<JBOSSHOME>/bin/SASServer8.sh stop

Step 2: Backup the contents of the SAS Social Network Analysis ear.
1.1 Make a copy of the SAS Social Network Analysis ear that you have deployed. The ear is located in the JBoss install directory. Copy the following directory to the temporary location of your choice:

<JBOSSHOME>/server/SASServer8/deploy_sas/sas.socialnetworkanalysis2.3.ear

Step 3: Re-build Web Applications
In order for this step to execute correctly, the Metadata Server must be running.

1.1 Invoke the SAS Deployment Manager 9.3
From the SASDeploymentManager directory launch sasdm.sh. The default installation path for the SAS Deployment Manager is

SASHOME/SASDeploymentManager/9.3

1.2 Select a language in the Choose Language box

1.3 Select Rebuild Web Applications

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

1.5 Specify Connection Information, including the sasadm User ID and Password

1.6 Select SAS Social Network Analysis Mid-Tier as the Web Application to Rebuild

1.7 Verify the information on the Summary screen and select Start

1.8 Select Finish when the deployment is complete

This process will update the SAS Social Network Analysis Mid-Tier ear in <CONFIGDIR>/Lev1/Web/Staging. A backup of the original ear file will be placed in the Backup directory.

Step 4: Copy the WEB-INF/lib directory

1.1 Locate the exploded ear directory for SAS Social Network Analysis in the configuration directory:

<CONFIGDIR>/Lev1/Web/Staging/exploded/sas.socialnetworkanalysis2.3.ear/sas.sso.snaserver.war/WEB-INF

1.2 Copy the lib directory from the exploded ear directory (above) to the SAS Social Network Analysis deployment within the JBoss Web Application Server. For example, copy

<CONFIGDIR>/Lev1/Web/Staging/exploded/sas.socialnetworkanalysis2.3.ear/sas.sso.snaserver.war/WEB-INF/lib
to
<JBOSSHOME>/server/SASServer8/deploy_sas/sas.socialnetworkanalysis2.3.ear/sas.sso.snaserver.war/WEB-INF/lib

Step 5: Copy the swf files

1.1 Locate the exploded ear directory for SAS Social Network Analysis in the configuration directory:

<CONFIGDIR>/Lev1/Web/Staging/exploded/sas.socialnetworkanalysis2.3.ear/sas.sso.snaserver.war/

1.2 Locate the following 2 files in the directory:
sfswslayout.swf
socialnetworkdiagram.swf

1.3 Back up the 2 files by copying them to a backup directory of your choice.

1.4 Copy the following 2 swf files from the exploded ear directory (above) to the SAS Social Network Analysis deployment within the JBoss Web Application Server. For example, copy sfswslayout.swf and socialnetworkdiagram.swf

from
<CONFIGDIR>/Lev1/Web/Staging/exploded/sas.socialnetworkanalysis2.3.ear/sas.sso.snaserver.war/
to
<JBOSSHOME>/server/SASServer8/deploy_sas/sas.socialnetworkanalysis2.3.ear/sas.sso.snaserver.war/

Step 6: Delete the tmp and work directories in SASServer8

1.1 Delete the tmp and work directories in SASServer8
rm -rf <JBOSSHOME>/server/SASServer8/tmp
rm -rf <JBOSSHOME>/server/SASServer8/work

Step 7: Clear your browser cache

1.1 Please follow the instructions at the following link to clear your browser cache

   http://java.com/en/download/help/webcache.xml 

Step 8: Restart the JBoss Server

1.1 Using the Instructions.html located in <SASConfig>/Lev1/Documents, review the section labeled "Web Application Server". Review the section "Starting Your JBoss Web Application Servers". An example of the command to start SASServer8 on using JBoss is:

<JBOSSHOME>/bin/SASServer8.sh start



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