Installation Instructions for Hot Fix D43001

Linux for x64


Hot fix D43001 addresses the issue(s) in SAS BI Dashboard 4.2_M2 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/D43.html#D43001


IMPORTANT NOTES

  1. You must have SAS BI Dashboard 4.2_M2 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 D43001la.bin. Verify that the installation binary has execute permission. If it does not, use the chmod command to make it executable.
$> chmod 755 D43001la.bin
2. Set your $DISPLAY environment variable
export DISPLAY=<your_node_name>:0
3. Execute D43001la.bin
<path_to_downloaded_file>/D43001la.bin
    For example:
./D43001la.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.


POST-INSTALLATION INSTRUCTIONS

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


Step 1: Re-build Web Applications

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

1.1 Set the DISPLAY environment variable, for example

$ export DISPLAY=<displayname>:0

1.2 Invoke the SAS Deployment Manager 9.2

From the SASDeploymentManager directory execute config.sh, for example

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

1.3 Select a language in the Choose Language box

1.4 Select Rebuild Web Applications

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

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

1.7 Select BI Dashboard 4.2 as the Web Application to Rebuild

1.8 Verify the information on the Summary screen and select Start

1.9 Select Finish when the deployment is complete

This process will update the SAS BI Dashboard ears in <CONFIGDIR>/Lev1/Web/Staging and place the updated exploded ears in <CONFIGDIR>/Lev1/Web/Staging/exploded. The SAS BI Dashboard ears include:

For this hot fix, only sas.bidashboard4.2.ear will need to be re-deployed.

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


Step 2: Re-deploy Web Applications

2.1 Re-deploy the updated ears 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 D43001 on Linux for x64.