Installation instructions for hot fix D12001 on Linux for x64

Installation Instructions for Hot Fix D12001

Linux for x64

Hot fix D12001 addresses the issue(s) in SAS Warranty Analysis 4.2_M1 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/D12.html#D12001

This hot fix contains updates to the following software components:

SAS Warranty Analysis for Analytics Platform 4.2_M1
SAS Warranty Analysis Logical Types 4.2_M1
SAS Warranty Analysis Mid-Tier 4.2_M1
SAS Warranty Analysis Server 4.2

Before applying this hot fix, follow the instructions in SAS Note 35968 to generate a SAS Deployment Registry report, then verify that the appropriate product releases are installed on your system. The software components and release numbers should match the list of software components updated by the individual hot fix installers.

IMPORTANT NOTES

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

The installer downloaded is D12001la.bin. Copy D12001la.bin to each Linux for x64 machine on which SAS Warranty Analysis 4.2_M1 components are installed.

To install the hot fix, on each machine:

1. Verify that the installation binary has execute permission. If it does not, use the chmod command to make it executable.

$> chmod 755 D12001la.bin

2. Set your $DISPLAY environment variable

export DISPLAY=<your_node_name>:0

3. Execute D12001la.bin

<path_to_downloaded_file>/D12001la.bin

For example:

./D12001la.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.

The installation process will determine which components of SAS Warranty Analysis 4.2_M1 are installed on the machine, and apply the appropriate updates.

If components of this product are installed on multiple operating systems, you must download the hot fix for the appropriate operating system(s) and follow the installation instructions provided to complete the deployment of this hot fix.

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

This completes the installation of D12001. Please perform any "Post-Installation Instructions" documented below to successfully complete the deployment of this hot fix.

POST-INSTALLATION INSTRUCTIONS

For each product installed, click the link to be redirected to post-installation instructions.

SAS Warranty Analysis Client 4.2_M1
SAS Warranty Analysis for Analytics Platform 4.2_M1
SAS Warranty Analysis Logical Types 4.2_M1
SAS Warranty Analysis Mid-Tier 4.2_M1
SAS Warranty Analysis Server 4.2

SAS Warranty Analysis Client 4.2_M1

Updates to your SAS Warranty Analysis Client machines are also required.
Since the clients can only be installed on Windows or Windows for x64, you must download D12001 for Windows to your client machines and apply the hot fix per the installation instructions provided.

SAS Warranty Analysis for Analytics Platform 4.2_M1

After installing this hotfix, you must restart the SAS Analytics Platform server so that changes in the SAS Warranty Analysis Server are incorporated into this component.

Restarting in a Windows Environment
To restart the SAS Analytics Platform server in a Window environment, use one of these methods:
- From the Start menu, select Programs, SAS, SAS Configuration, Config-Lev, Analytics Platform Server - Start
- At a command prompt, navigate to the SAS-configuration-directory\Lev1\AnalyticsPlatform directory and type
  AnalyticsPlatform.bat start
Note: When you initially installed SAS, you might have selected Windows options: run as managed scripts or services in the SAS Deployment Wizard. If you selected this option, then the SAS Analytics Platform is run as a Windows Service. Generally, you can start the service by using the Services window. However, the first time that you restart the server after installing a hotfix, you must use either the Start menu or a command prompt. If you restart the server from the Services window, then the SAS Analytics Platform does not pick up the updates in the SAS Warranty Analysis. After you have restarted the server from either the Start menu or at a command prompt once, the next time that you restart the server you can again use the Services window.
Restarting in a UNIX Environment
To restart the SAS Analytics Platform server:
1. Verify that your X server is running and is available.
2. At the UNIX prompt, navigate to the directory where the SAS Analytics Platform server is configured. Usually, this directory is SAS-configuration-directory/Lev1/AnalyticsPlatform
3. If the SAS Analytics Platform server is currently running, type
  ./AnalyticsPlatform.sh stop
4. To start the SAS Analytics Platform server, type
  ./AnalyticsPlatform.sh start

NOTE
For customers running Warranty Analysis as Java Web Start, you must uninstall the Warranty Analysis Server from the Java Web Start cache. This can be done by issuing the command
javaws -uninstall

SAS Warranty Analysis Logical Types 4.2_M1

NONE

SAS Warranty Analysis Mid-Tier 4.2_M1

Web application Update

This hot fix requires 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 Invoke the SAS Deployment Manager 9.2

From the SASDeploymentManager directory launch config.sh. The default installation path for the SAS Deployment Manager is

SASHOME/SASDeploymentManager/9.2

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 Warranty Analysis Mid-Tier 4.2 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 Warranty Analysis ear in <CONFIGDIR>\Lev1\Web\Staging. A backup of the original ear file will be placed in the Backup directory.

Step 2: Re-deploy Web Applications

Follow the steps provided for your initial Solution deployment to re-deploy the updated ear to your web application.

SAS Warranty Analysis Server 4.2

Step 1: Copy files

After installation of hot fix, some files need to be copied from SAS Install directories to SAS Config directories.

Note: Some of the files listed below are already present in the destination directories. If prompted to overwrite, say yes and proceed.

1.1 Copy following files from
<SASHOME>/SASFoundation/9.2/misc/wrtyanlmva/install/configure to
<CONFIGDIR>/Lev1/Applications/SASWarrantyAnalysis4.2/install/configure
      * analysismacvars.csv
      * analysisoptionattributes_base.csv
      * dataselectionattributes_base.csv
      * eiautoparms.csv
      * migration_objects.sas

1.2 Copy following files from
<SASHOME>/SASFoundation/9.2/misc/wrtyanlmva/install to
<CONFIGDIR>/Lev1/Applications/SASWarrantyAnalysis4.2/install
      * swa42_migration.sas
      * swa42_migration.sql
      * swa42_hotfix_updates.sas

Step 2: Run SAS code

Run swa42_hotfix_updates.sas present in
<CONFIGDIR>/Lev1/Applications/SASWarrantyAnalysis4.2/install

Note:
1. The SAS script requires parmsl library to be pre-assigned. To have the pre-assigned library, you must invoke the SAS session by issuing a command similar to the following one:
<SASHOME>/SASFoundation/9.2/sas -config <CONFIGDIR</Lev1/Applications/SASWarrantyAnalysis4.2/install/sasv9_swaconn.cfg

2. The following warnings are expected in the log when swa42_hotfix_updates.sas is run:
      WARNING: Variable DSATTRID has different lengths on BASE and DATA files (BASE 10 DATA 15).
      ......
      ......
      WARNING: Variable INPUTFIELDLABELCOLUMN was not found on DATA file.

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