Installation Instructions for Hot Fix D01001

Windows


Hot fix D01001 addresses the issue(s) in SAS Human Capital Management 5.1 on Windows as documented in the Issue(s) Addressed section of the hot fix download page:

http://ftp.sas.com/techsup/download/hotfix/HF2/D01.html#D01001


This hot fix contains updates to the following software components:

SAS Human Capital Management JPS Extension 5.1
SAS Human Capital Management Mid-Tier 5.1
SAS Human Capital Management Server 5.1


PRE-INSTALLATION INSTRUCTIONS

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

  2. Backup the entire SAS Human Capital Management 5.1 system, all tiers. This will entail stopping all SAS sessions, daemons, spawners, and servers. Instructions for using the Metadata Backup Wizard can be found in the SAS 9.2 Intelligence Platform - System Administration Guide in Part 4, Chapter 10. The easiest method is to use the Backup Wizard, but if this method is to be used, it is imperative to ensure that the appropriate User Credentials are used. Chapters 9 - 11 cover all of the methods for metadata backup.

    If there are problems backing up the metadata, open a Technical Support Track with the Metadata Support Team.


IMPORTANT NOTES

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

  2. You must have Administrator Privileges on your CLIENT or SERVER machine.

  3. All currently active SAS sessions, daemons, spawners and servers must be terminated before applying this hot fix.

  4. This hot fix should be installed using the same userid who performed the initial software installation.


INSTALLATION

The installer downloaded is D01001wn.exe.
  1. Copy D01001wn.exe to each Windows machine on which SAS Human Capital Management 5.1 components are installed.

  2. Execute D01001wn.exe on each machine where SAS Human Capital Management 5.1 components are installed.


This will initiate the installation wizard, which will guide you through the hot fix installation process. The installation process will determine which components of SAS Human Capital Management 5.1 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 D01001. 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 Human Capital Management JPS Extension 5.1
SAS Human Capital Management Mid-Tier 5.1
SAS Human Capital Management Server 5.1


SAS Human Capital Management JPS Extension 5.1

None


SAS Human Capital Management Mid-Tier 5.1

Updates to the SAS Human Capital Management Mid-Tier 5.1 provided in this hot fix require that Web Applications be rebuilt and redeployed. If this component is installed on Windows, follow the steps below to rebuild and redeploy the web application:

Re-build Web Application

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

1. Invoke the SAS Deployment Manager 9.2

From the SASDeploymentManager directory launch config.exe.
SAS Deployment Manager is installed in the following default location:

<SASHOME>\SASDeploymentManager\9.2

2. Select a language in the Choose Language box

3. Select Rebuild Web Applications

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

5. Specify Connection Information, including the sasadm User ID and Password

6. Select SAS Human Capital Management Mid-Tier 5.1 as the Web Application to Rebuild

7. Verify the information on the Summary screen and select Start

8. Select Finish when the deployment is complete

This process will update the SAS Human Capital Management Mid-Tier 5.1 ear in

<SASCONFIGDIR>\Web\Staging
A backup of the original ear file will be placed in the directory
<SASCONFIGDIR>\Web\Staging\Backup
Re-deploy Web Application

1. Re-deploy the web application using WebLogic Admin console.


SAS Human Capital Management Server 5.1

The following steps are necessary to successfully implement the update to SAS Human Capital Management Server 5.1.

  1. Open the SASV9.CFG file in Notepad. The default location for this file is C:\Program Files\sas\SASFoundation\9.2\nls\en.

  2. Add the path for files soldatatier.txt and hcmdatatier.txt. For example,
    -SET _CFGSOL "C:\SAS\Config\Lev1\Applications\SASSolutionsServices5.1\SASConfig\soldatatier.txt"
    -SET _CFGHCM "C:\SAS\Config\Lev1\Applications\SASHumanCapitalManagement5.1\SASConfig\hcmdatatier.txt"

  3. Save the file and close.

  4. Open the SAS session and run the macro. Add the include statement before running the macro, for example,
    %include "C:\Program Files\SAS\SASFoundation\9.2\hrds\sasmacro\hcmcatg.sas";
    %custom_category_add(<IMAP / Table name which you want to add as custom category>, <Employee Profile document ID>);


This completes the deployment of hot fix D01001 on Windows.