Installation Instructions for Hot Fix D49002

z/OS

Hot fix D49002 addresses the issue(s) in SAS IT Resource Management 3.2 on z/OS 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.

D50001 for SAS IT Resource Management Data Tier 3.2
D52002 for SAS IT Resource Management Mid-Tier 3.2
D54002 for SAS IT Management Solutions Core Components MVA Data 3.2

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.

• SASŪ IT Resource Management supplies an initial copy of a SAS data set that contains currently available LSPR information, as well as additional columns that enhance the reporting of resource utilization for various categories of SMF activity. The D49002 hot fix will update the default Large System Performance Reference (LSPR) table information located in SASHELP.ITMS_SMF_LSPRDATA. For more information about the LSPR table, updating its values, or backing up and restoring the default table after applying hot fix D49002, please refer to SAS Note 40936.

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

• The hot fix installer has a graphical user interface that requires the use of an X11 server. If an X11 server is not available at your site, the "Method A" silent installation process described in the hot fix instructions may be used.

• Before proceeding with the execution of the hot fix binary, ensure that there are no SAS 9.2 jobs running because this step requires exclusive access to the SASHELP library.

• SAS Hot Fixes are installed into new datasets after which they can be promoted to your production libraries. Several new datasets will be created in this process.

• The hotfix CLIST or PROC jcl will be customized with the concatenate hotfix datasets.

OVERVIEW

1. Evaluate whether Installation Note 43499 affects your site.
2. Generate the SAS Deployment Registry Report.
3. Determine your installation scenario.
4. Apply Hot Fixes D50001, D52002 and D54002.
5. Perform the appropriate Post Installation tasks.

EVALUATE INSTALLATION NOTE 43499

Installing SAS 9.2 with java 1.6 SR9, or updating to java 1.6 SR9 in an existing SAS configuration, may cause errors. This may also be the case when performing the Post Installation tasks for this hot fix. If you are running java 1.6 SR9 and you have not already followed the steps in SAS Note 43499, then please do so before proceeding.

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. Verify that the appropriate product releases are installed on your system:

SAS IT Resource Management Data Tier 3.2
SAS IT Resource Management Mid-Tier 3.2
SAS IT Management Solutions Core Components MVA Data 3.2

INSTALLATION

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:

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:

• Install the SAS IT Resource Management 3.2 software, and deselect Configure in the SAS Deployment Wizard dialog.
• Install the SAS IT Resource Management 3.2 hot fixes using the Installation Instructions below, and perform step 1 in the Post Installation Instructions for the SAS IT Resource Management Data Tier 3.2 component.
• Perform the migrated configuration by running the SAS Deployment Wizard again. This time deselect Install, but do select Configure. In a subsequent dialog you should also select Migrate and provide the location of your SAS Migration Utility package.
• After the migrated configuration has successfully completed on the Server Tier, perform Post Installation steps below for D54002 for SAS IT Management Solutions Core Components MVA Data 3.2, followed by step 2 in the Post Installation Instructions for the SAS IT Resource Management Data Tier 3.2 component.

Note that the steps above 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

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.

1. The hot fix package downloaded is a compressed pax file named D49002os.pax. Download this file to a working directory on the UNIX File System on z/OS. If you download D49002os.pax to a Windows or UNIX system, you must FTP the pax file in binary mode to a UNIX File System working directory on z/OS before continuing with the instructions.

2. Uncompress the pax file with this command from the working directory on the UNIX File System on z/OS:
   

   pax -r -v -osaveext -f D49002os.pax

   This command will create a D49002 subdirectory and extract these components:

   Hot Fix D50001
   

   D50001os.bin: Apply on each machine where SAS IT Resource Management Data Tier 3.2 resides.
   

   Hot Fix D52002
   

   D52002os.bin: Apply on each machine where SAS IT Resource Management Mid-Tier 3.2 resides.
   

   Hot Fix D54002
   

   D54002os.bin: Apply on each machine where SAS IT Management Solutions Core Components MVA Data 3.2 resides.
   D54002_jars.pax: Apply on each machine where SAS IT Management Solutions Core Components MVA Data 3.2 resides.
   

3. Follow the INSTALLATION instructions for each individual hot fix to complete the deployment of this hot fix.

   SAS IT Resource Management Data Tier 3.2: Installation Instructions for Hot Fix D50001
   
   SAS IT Resource Management Mid-Tier 3.2: Installation Instructions for Hot Fix D52002
   
   SAS IT Management Solutions Core Components MVA Data 3.2: Installation Instructions for Hot Fix D54002
   
   

   NOTE: You must complete the install of one hot fix before initiating the install for the next hot fix. Once the 3 hot fixes have been installed, perform the appropriate Post Installation tasks.

POST INSTALLATION

For each product installed, click the link to be redirected to Post Installation Instructions.

D50001 for SAS IT Resource Management Data Tier 3.2
D52002 for SAS IT Resource Management Mid-Tier 3.2
D54002 for SAS IT Management Solutions Core Components MVA Data 3.2

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

   1. Ensure that an X11 DISPLAY environment variable has been properly set and exported. Set your DISPLAY environment variable as follows:

      export DISPLAY=>your_node_name<:0
      

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

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

      <SASHOME>SASITResourceManagementDataTier/3.2

   4. The script to update the SAS IT Resource Management metadata is named applyHotFix_mvs.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_mvs.sh <metaPass> <SASConfigDir>

      For example,

      chmod 755 applyHotFix_mvs.sh
applyHotFix_mvs.sh AdminAdmin1 <CONFIGDIR>/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_mvs.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

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.rexx
   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 Administrator 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

   
   

2. Re-deploy Web Application

   Re-deploy the sas.itresourcemanagement3.2.ear web application using the instructions found in the section titled "Redeploying EAR Files to a Single Server or Multiple Servers" of the SASŪ 9.2 Intelligence Platform Web Application Administration Guide.

D54002 for SAS IT Management Solutions Core Components MVA Data 3.2

From the UNIX file system working directory where the D49002 subdirectory was created, extract the pax file D54002_jars.pax with the command:

pax -r -v -osaveext -f D49002/D54002_jars.pax

sas.solutions.itms.adapter.hpovpa.nls_302001.0.0.20110518102523_f0rm32
sas.solutions.itms.adapter.hpovpa_302001.0.0.20110518102523_f0rm32
sas.solutions.itms.adapter.hpovrep_302001.0.0.20110518102524_f0rm32
sas.solutions.itms.adapter.patrol_302001.0.0.20110518102524_f0rm32
sas.solutions.itms.adapter.vmware_302001.0.0.20110518102524_f0rm32
sas.solutions.itrm.adapter.hpovpa_302001.0.0.20110518102336_f0rm32
sas.solutions.itrm.adapter.hpovrep_302001.0.0.20110518102336_f0rm32
sas.solutions.itrm.adapter.patrol_302001.0.0.20110518102336_f0rm32
sas.solutions.itrm.adapter.vmware_302001.0.0.20110518102337_f0rm32
sas.solutions.itrm.adapter.weblog_302001.0.0.20110518102336_f0rm32

cd D54002_jars
cp -R sas.solutions.it*f0rm32 <SASHOME>/SASVersionedJarRepository/9.2/eclipse/plugins