Installation Instructions for Hot Fix D49002

Solaris for x64


Hot fix D49002 addresses the issue(s) in SAS IT Resource Management 3.2 on Solaris for x64 as documented in the Issue(s) Addressed section of the hot fix download page:

http://ftp.sas.com/techsup/download/hotfix/HF2/D49.html#D49002


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

C44013 for SAS Enterprise Guide 4.305
D54002 for SAS IT Management Solutions Core Components MVA Data 3.2
D53001 for SAS IT Resource Management Client 3.2
D50001 for SAS IT Resource Management Data Tier 3.2
D52002 for SAS IT Resource Management Mid-Tier 3.2
D51001 for SAS IT Resource Management SAS Enterprise Guide Components 3.2


IMPORTANT NOTES



OVERVIEW

To properly install this hot fix you will perform the following steps:
  1. Generate the SAS Deployment Registry Report.
  2. Determine your installation scenario.
  3. Apply Hot Fixes C44013, D50001, D51001, D52002, D53001 and D54002.
  4. Perform the appropriate Post Installation tasks.


GENERATE THE SAS DEPLOYMENT REGISTRY REPORT

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.


INSTALLATION

Installation Scenarios

We have identified several installation scenarios for SAS IT Resource Management 3.2 Hot Fix D49002.

  1. A site that is an existing SAS IT Resource Management 3.2 customer.

  2. A site that is a new SAS IT Resource Management 3.2 customer:

  3. a.  Installing and configuring SAS IT Resource Management 3.2
    b.  Installing and configuring SAS IT Resource Management 3.2 and migrating from SAS IT Resource Management 2.7 to SAS IT Resource Management 3.2 using the %RMPDB2DM migration macro.
    c.  Installing SAS IT Resource Management 3.2 and migrating from SAS IT Resource Management 3.1.1 to SAS IT Resource Management 3.2 using the SAS Migration Utility (SMU).

Scenario 1

You will apply the hot fix following the Installation Instructions below.

Scenario 2.a or 2.b

You will also follow the Installaton Instructions below after you have successfully installed and configured the SAS IT Resource Management 3.2 software on the various target machines.

Scenario 2.c

To ensure that updated migration code delivered with this hot fix is available when your migration is performed, the following additional steps must be followed in a specific order on your Server Tier during installation and configuration.

Scenario 2.c Server Tier steps:

Note that the following steps only apply to the Server Tier; software intended for the Middle Tier or Client Tier can be both installed and configured during the SAS Deployment Wizard execution on that specific Tier. The hot fixes can be then applied on those Tiers following the Installation Instructions below.


Installation Instructions

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 IT Resource Management 3.2 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 D49002sx.bin. 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 D49002sx.bin
2. Set your $DISPLAY environment variable
export DISPLAY=<your_node_name>:0
3. Execute D49002sx.bin
<path_to_downloaded_file>/D49002sx.bin
    For example:
./D49002sx.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.

This completes the installation of D49002. You must 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.

C44013 for SAS Enterprise Guide 4.305 - NONE
D54002 for SAS IT Management Solutions Core Components MVA Data 3.2 - NONE
D53001 for SAS IT Resource Management Client 3.2
D50001 for SAS IT Resource Management Data Tier 3.2
D52002 for SAS IT Resource Management Mid-Tier 3.2
D51001 for SAS IT Resource Management SAS Enterprise Guide Components 3.2 - NONE


C44013 for SAS Enterprise Guide 4.305

NONE


D54002 for SAS IT Management Solutions Core Components MVA Data 3.2

NONE


D53001 for SAS IT Resource Management Client 3.2

Re-deploy SAS IT Resource Management Jobs

Any SAS IT Resource Management Jobs that were created and deployed with the previous version of the software will need to be redeployed.


D50001 for SAS IT Resource Management Data Tier 3.2

  1. Update SAS Data Integration Studio Server Data

    You will need to copy a portion of the SAS IT Resource Management Data Tier update to the SAS Data Integration Studio Server Data product directory to complete the installation of D50001 . Follow the steps below:

    1. Locate the plugins/itrmdatatier folder containing the file 'picklist' for your SAS IT Resource Management Data Tier installation. By default, this folder is located in:

      <SASHOME>/SASITResourceManagementDataTier/3.2/plugins/itrmdatatier
    2. Copy the file "picklist" file stored in the "itrmdatatier" folder to the following location:
      <SASHOME>/SASDataIntegrationStudioServerData/4.2/plugins


  2. Update SAS IT Resource Management Metadata

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

    You should be logged into the machine hosting your SAS IT Resource Management metadata server using the same userid that was used for both your original and hot fix installations.

    Ensure that an X11 DISPLAY variable has been properly set and exported. Also inspect the level_env.sh script file located

    <SAS Configuration Directory>/Level
    to confirm whether a JDK_HOME environment variable is being defined. If you do not see a line specifying "JDK_HOME=" then you need to set the JDK_HOME variable from the command line prior to invoking the script s pecified below. The setting should be to an installed, compatible JDK, and should not include the "/bin" portion of the path.

    Change directory to the installation location of the SAS IT Resource Management Data Tier component. This should be

    <SASHOME>SASITResourceManagementDataTier/3.2

    The script to update the SAS IT Resource Management metadata is named applyHotFix.sh and it requires two positional parameters to be passed to it. The first is the password for the SAS administrative user id. The second is the SAS Configuration Directory path including the Level subdirectory. The syntax for invoking this script is:

    applyHotFix.sh <metaPass> <SASConfigDir>
    For example,
    applyHotFix.sh AdminAdmin1 /install/ITRM32/Lev1
    Note: if your configuration directory path contains a space (embedded blank) you must enclose the entire path in double quotes ("path with blanks").

    During the execution of this script you should see messages similar to the following output to your shell:

    Output from this script is redirected to the log file: itrmhotfix.log

    Buildfile: /install/SAS/SASITResourceManagementDataTier/3.2/Config/itrmhotfix.xml

    applyHotFix.sh has completed.
    and the output from this task will be written to the itrmhotfix.log file. This log file is located in the same directory that the script was invoked from.

    After successful execution the final lines of this log file will be similar to:

    BUILD SUCCESSFUL
    Total time: 45 seconds
    Note: If you do not see the BUILD SUCCESSFUL message you should contact SAS Technical Support.


D52002 for SAS IT Resource Management Mid-Tier 3.2

Step 1: Re-build Web Application

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 SAS Deployment Manager is installed in the following default location:

<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 ITRM Gallery Manager 3.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 rebuild task is complete

This process will update the ITRM Gallery Manager 3.2 ear in <SASCONFIGDIR>/Lev1/Web/Staging. A backup of the original ear file will be placed in the directory below:

<SASCONFIGDIR>/Lev1/Web/Staging/Backup
where <SAS Configuration Directory> is the configuration directory for the mid-tier

Step 2: Re-deploy Web Application

2.1 Re-deploy the sas.itresourcemanagement3.2.ear web application using SASŪ 9.2 Intelligence Platform Web Application Administration Guide.


D51001 for SAS IT Resource Management SAS Enterprise Guide Components 3.2

NONE


This completes the installation of hot fix D49002 on Solaris for x64.