Installation instructions for hot fix D26007 on Linux for x64

Installation Instructions for Hot Fix D26007

Linux for x64

Hot fix D26007 addresses issue(s) in SAS Web Report Studio 4.3 on Linux for x64.

IMPORTANT NOTES

You must have SAS Web Report Studio 4.3 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.
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.
You must have Administrator Privileges on your CLIENT or SERVER machine.
All currently active SAS sessions, daemons, spawners and servers must be terminated before applying this hot fix.
This hot fix should be installed using the same userid who performed the initial software installation.

INSTALLATION

1. The installer downloaded is D26007la.bin. Verify that the installation binary has execute permission. If it does not, use the chmod command to make it executable.

$> chmod 755 D26007la.bin

2. Set your $DISPLAY environment variable

export DISPLAY=<your_node_name>:0

3. Execute D26007la.bin with the -alwaysoverwrite option

<path_to_downloaded_file>/D26007la.bin -alwaysoverwrite

For example:

./D26007la.bin -alwaysoverwrite

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
allow you to take advantage of fixes delivered in this hot fix

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 Web Report Studio 4.3 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 Web Report Studio ear in <CONFIGDIR>/Lev1/Web/Staging and place the updated exploded ear in <CONFIGDIR>/Lev1/Web/Staging/exploded. The Web Report Studio ear includes:

sas.webreportstudio.ear

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

Step 2: Re-deploy Web Applications

2.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.

Step 3: Configure properties to enable new functionality

The following properties must be configured to enable the new functionality delivered in this hot fix. The recommended method is to use the Configuration Manager plug-in available in SAS Management Console. See Using Configuration Manager for instructions on configuring a property for SAS Web Report Studio.

To force the display of a single applied filter string within a synchronized section, enter the property name as shown and specify the property value:
Property Name: sas.wrs.display.only.single.applied.filter
Property Value: true
To allow the display of only the leaf level of an OLAP tuple within the applied filter string, enter the property name as shown and specify the property value:
Property Name: sas.wrs.filtering.display.only.lowest.leaf
Property Value: true
To suppress the display of a hidden filter in the applied filter string, enter the property name as shown and specify the property value:
Property Name: sas.wrs.hidden.filters.allow.application
Property Value: true

The properties can also be configured by editing LocalProperties.xml. See SAS Note 32858 How to maintain custom SASŽ Web Report Studio properties for more details.

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