Installation Instructions for Hot Fix C64001

Linux for x64


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

http://ftp.sas.com/techsup/download/hotfix/HF2/C64.html#C64001


IMPORTANT NOTES

  1. You must have SAS Web Application Themes 9.24 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

1. The installer downloaded is C64001la.bin. Verify that the installation binary has execute permission. If it does not, use the chmod command to make it executable.
$> chmod 755 C64001la.bin
2. Set your $DISPLAY environment variable
export DISPLAY=<your_node_name>:0
3. Execute C64001la.bin
<path_to_downloaded_file>/C64001la.bin
    For example:
./C64001la.bin

This will initiate the installation wizard, which will guide you through the hot fix installation process. During the installation you will be prompted for the SASHOME location to be updated. You should provide the path to the top level SAS directory where the deploymntreg directory exists.


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


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


POST-INSTALLATION INSTRUCTIONS

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


Step 1: Update Custom Themes

This step is only necessary if you have created custom themes and should be performed for each custom theme.

1.1 Copy SASthemes.vtl from

<SASHOME>/SASWebApplicationThemes/9.2/Static/tars/sas.themeresources/Velocity/ThemeDescriptors

to

<CONFIGDIR>/Web/Utilities/SASThemeExtensions/themes/{CustomTheme}/Velocity/ThemeDescriptors/custom/{CustomTheme}

where {CustomTheme} is the name of your custom theme.

1.2 Copy LogonArtTopRTL.gif from

<SASHOME>/SASWebApplicationThemes/9.2/Static/tars/sas.themeresources/themes/default/images/Common

to

<CONFIGDIR>/Web/Utilities/SASThemeExtensions/themes/{CustomTheme}/themes/{CustomTheme}/images/Common

where {CustomTheme} is the name of your custom theme.

1.3 Copy LogonArtTileRTL.gif from

<SASHOME>/SASWebApplicationThemes/9.2/Static/tars/sas.themeresources/themes/default/images/Common

to

<CONFIGDIR>/Web/Utilities/SASThemeExtensions/themes/{CustomTheme}/themes/{CustomTheme}/images/Common

where {CustomTheme} is the name of your custom theme.


Step 2: Re-build Web Applications

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

2.1 Set the DISPLAY environment variable, for example

$ export DISPLAY=<displayname>:0

2.2 Invoke the SAS Deployment Manager 9.2

From the SASDeploymentManager directory execute config.sh, for example

$ cd <SASHOME>/SASDeploymentManager/9.2
$ ./config.sh

2.3 Select a language in the Choose Language box

2.4 Select Rebuild Web Applications

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

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

2.7 Select SAS Themes as the Web Application to Rebuild

2.8 Verify the information on the Summary screen and select Start

2.9 Select Finish when the deployment is complete


This process will update the SAS Web Application Themes ear in <CONFIGDIR>/Lev1/Web/Staging and place the updated exploded ear in <CONFIGDIR>/Lev1/Web/Staging/exploded. The SAS Web Application Themes ear includes:

A backup of the original ear file will be placed in the Backup directory.


Step 3: Re-deploy Web Applications

3.1 Re-deploy the updated ear listed above to the web application server you are using based on the instructions appropriate for your web application server. See SAS 9.2 Intelligence Platform Web Application Administration Guide , Chapter 8, for more details.



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