Installation Instructions for Hot Fix L89001

64-bit Enabled Solaris


Hot fix L89001 addresses the issue(s) in SAS Social Network Analysis Mid-Tier 3.1_M1 on 64-bit Enabled Solaris as documented in the Issue(s) Addressed section of the hot fix download page:

http://ftp.sas.com/techsup/download/hotfix/HF2/L89.html#L89001


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


IMPORTANT NOTES

  1. You must have SAS Social Network Analysis Mid-Tier 3.1_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 L89001 hot fix for SAS Social Network Analysis Mid-Tier 3.1_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 L89001pt.zip, follow the instructions for applying hot fixes in the SAS Deployment Wizard and SAS Deployment Manager 9.3: User’s Guide.

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.socialnetworkanalysis3.1.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 files and directories from the exploded ear directory to the SAS Social Network Analysis deployment area.

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

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

1.2 Copy the following files/directories 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.socialnetworkanalysis3.1.ear/sas.sso.snaserver.war/WEB-INF/lib
to
<JBOSSHOME>/server/SASServer8/deploy_sas/sas.socialnetworkanalysis3.1.ear/sas.sso.snaserver.war/WEB-INF/lib

Step 5: 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 6: 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 7: 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 L89001 on 64-bit Enabled Solaris.