Installation Instructions for Hot Fix U51001

Solaris for x64


Hot fix U51001 addresses the issue(s) in SAS Environment Manager Enablement Kit Server 2.1 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/U51.html#U51001


The hot fix downloaded, U51001pt.zip, contains the updated files required to address the documented issues.
Do NOT extract the contents of U51001pt.zip. The hot fix installation process will extract the contents as needed.


IMPORTANT NOTES

  1. You must have SAS Environment Manager Enablement Kit Server 2.1 installed on your system before applying this hot fix. Refer to SN-35968 for instructions on how to determine which product releases you have installed.

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

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

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

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


INSTALLATION

The U51001 hot fix for SAS Environment Manager Enablement Kit Server 2.1 will be installed using the SAS Deployment Manager. By default, the SAS Deployment Manager will search in the <SASHOME>/InstallMisc/HotFixes/New directory for hot fixes to be applied, but will also prompt for a location if you have downloaded hot fixes to a different directory.

After downloading U51001pt.zip, follow the instructions for applying hot fixes in the SAS Deployment Wizard and SAS Deployment Manager 9.4: User's Guide.

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


POST-INSTALLATION INSTRUCTIONS

Copy three files from the SAS Home area to the SAS Configuration area
  1. Copy getmetacreds.sas
    FROM: <SASHome>/SASEnvironmentManagerEnablementKitServer/2.1/core/SASMacros/
    TO: <SASConfig>/LevX/Web/SASEnvironmentManager/emi-framework/SASMacros/
  2. Copy create_get_tz_format.sas and getMetricData.sas
    FROM: <SASHome>/SASEnvironmentManagerEnablementKitServer/2.1/core/SASJobs/
    TO: <SASConfig>/LevX/Web/SASEnvironmentManager/emi-framework/SASJobs/

Modify four groovy programs to hard-code the appropriate parameter value passed to the hq.api.resourceApi.getPlatformResourceByFqdn function

NOTE:  If the platform resource (host) on which the SAS Environment Manager Service Architecture is deployed has a single-level hostname (i.e. “myServer” rather than “myServer.myDomain.com”), the following additional steps are required. If that is not the case, these steps should be skipped.

  1. Modify emiInit.groovy in /LevX/Web/SASEnvironmentManager/emi-framework/Scripts
    Change the following line (~line number 332), from this:
    if (!hq.api.resourceApi.getPlatformResourceByFqdn(platform, false, false)) {
    to this:
    if (!hq.api.resourceApi.getPlatformResourceByFqdn('192.168.0.1', false, false)) {
    NOTE: The value shown above (‘192.168.0.1’) is only an example. Replace this with the value of shown in the field "Fully Qualified Domain Name" on the Inventory tab of the platform-level resource corresponding to the host with a single-level hostname within the SAS Environment Manager web interface. Note that while this will often be the same as the platform’s IP address, it may not be. The important thing is to make sure this value matches what is shown in that field.

  2. Modify createHTTPChecks.groovy in /LevX/Web/SASEnvironmentManager/emi-framework/Scripts

    Change the following line (~line number 199), from this:

    def platform = hq.api.resourceApi.getPlatformResourceByFqdn(platform , false, false).resource
    to this:
    def platform = hq.api.resourceApi.getPlatformResourceByFqdn('192.168.0.1' , false, false).resource
    See note above about the proper value to use.

  3. Modify createGroups.groovy in /LevX/Web/SASEnvironmentManager/emi-framework/Scripts

    Change the following line (~line number 109), from this:
    if (!hq.api.resourceApi.getPlatformResourceByFqdn(platform, false, false)) {
    to this:
    if (!hq.api.resourceApi.getPlatformResourceByFqdn('192.168.0.1', false, false)) {
    See note above about the proper value to use.

  4. Modify evKitInstaller.groovy in /LevX/Web/SASEnvironmentManager/emi-framework/Scripts

    Change the following line (~line number 125), from this:
    if (!hq.api.resourceApi.getPlatformResourceByFqdn(platform, false, false)) {
    to this:
    if (!hq.api.resourceApi.getPlatformResourceByFqdn('192.168.0.1', false, false)) {
    See note above about the proper value to use.



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


Copyright 2015 SAS Institute Inc. All Rights Reserved.