Installation Instructions for Hot Fix U51002

Linux for x64


Hot fix U51002 addresses the issue(s) in SAS Environment Manager Enablement Kit Server 2.1 on Linux for x64 as documented in the Issue(s) Addressed section of the hot fix download page:

https://tshf.sas.com/techsup/download/hotfix/HF2/U51.html#U51002


The hot fix downloaded, U51002pt.zip, contains the updated files required to address the documented issues.
Do NOT extract the contents of U51002pt.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 U51002 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 U51002pt.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

  1. Copy three files from the SAS Home area to the SAS Configuration area

    1. Copy getmetacreds.sas and loadappcfg.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/

  2. 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.
  3. Re-start all SAS sessions, daemons, spawners and servers.

    For more information on the proper order for starting servers, go to SAS® 9.4 Intelligence Platform: System Administration Guide, Fourth Edition and review the section entitled "Starting, Stopping and Checking the Status of Servers".



This completes the installation of hot fix U51002 on Linux for x64.


Copyright 2018 SAS Institute Inc. All Rights Reserved.