Installation instructions for hot fix E54003 on Linux

Installation Instructions for Hot Fix E54003

Linux

Hot fix E54003 addresses the issue(s) in SAS Forecast Server 3.1_M3 on Linux as documented in the Issue(s) Addressed section of the hot fix download page:

http://ftp.sas.com/techsup/download/hotfix/HF2/E54.html#E54003

E54003 is a "container" hot fix that contains the following "member" hot fixes which will update the software components as indicated. See the Container Hot Fixes section in the Maintenance Install Tool (MIT) Usage Guide for more information about container hot fixes.

E56003 for SAS Forecast Server Batch Interface 3.1_M3
E58003 for SAS Forecast Server Mid-Tier 3.1_M3
E55003 for SAS Forecast Server Plug-ins for SAS Management Console 3.1_M3

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.
This download is intended for customers running an HP-UX IPF server. To install the Windows client updates, you must download and install the Windows version of this hot fix on your Windows system.
The SAS Analytics Platform server must be restarted after installing this hot fix. There are POST INSTALLATION instructions below to guide you through this process.

INSTALLATION

This hot fix must be installed on each machine where the updated components of the product, listed above, are installed. The installation process will determine which components of SAS Forecast Server 3.1_M3 are installed on each machine, and apply the appropriate updates.

If the updated 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.

The installer downloaded is E54003lx.bin.

When downloading SAS 9.2 hot fix packages, you must choose to Save the hot fix to disk, then execute the install from the saved location. Attempting to install a hot fix directly from the download page results in the error documented in SAS Note 37104.

To install the hot fix:

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

$> chmod 755 E54003lx.bin

2. Set your $DISPLAY environment variable

export DISPLAY=<your_node_name>:0

3. Execute E54003lx.bin

<path_to_downloaded_file>/E54003lx.bin

For example:

./E54003lx.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 Install Tool (MIT) Usage Guide for more details on the installation of hot fixes.

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

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

POST-INSTALLATION INSTRUCTIONS

After installing this hotfix, you must restart the SAS Analytics Platform server so that changes in the SAS Forecast 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 Forecast Server. 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 Forecast Studio as Java Web Start, you must uninstall the Forecast Server from the Java Web Start cache. This can be done by issuing the command
javaws -uninstall

This completes the installation of hot fix E54003 on Linux.