Installation Instructions for Hot Fix Z41007

Linux for x64


Hot fix Z41007 addresses the issue(s) in SAS Fraud Management 4.3 as documented in the Issue(s) Addressed section of the hot fix download page:

http://ftp.sas.com/techsup/download/hotfix/HF2/Z41.html#Z41007


Z41007 is a "container" hot fix that contains the following "member" hot fixes which will update the software components as needed.

Z92002  updates  SAS Fraud Management Common Macros 4.3
Z43006  updates  SAS Fraud Management Decision Engine 4.3***
Z42007  updates  SAS Fraud Management Mid-Tier 4.3***
B1L001  updates  SAS Fraud Management Reporting History ETL Server Macros 4.3
A3K004  updates  SAS Fraud Management System of Record DB Maintenance Macros 4.3
B1M002  updates  SAS Fraud Management Transaction Extensions 4.3

*** member hot fixes that have been updated since the previously released hot fix (Z41006)


See What is a container hot fix? in the Hot Fix FAQ for more information about container hot fixes.


HOT FIX COMPONENT HISTORY

Software Component Server Z41001 HF1 Z41002 HF2 Z41003 HF3 Z41004 HF4 Z41005 HF5 Z41006 HF6 Z41007 HF7
SAS FM Common Macros 4.3 Batch Server (Unix) Z92001 - Z92002 - - - -
SAS FM Decision Engine 4.3 Decision Server Z43001 Z43002 Z43003 Z43004 Z43005 - Z43006
SAS FM Mid-Tier 4.3 Midtier Z42001 Z42002 Z42003 Z42004 Z42005 Z42006 Z42007
SAS FM Reporting History ETL Server Macros 4.3 Batch Server (Unix) - - B1L001 - - - -
SAS FM System of Record DB Maintenance Macros 4.3 Batch Server (Unix) - A3K001 A3K002 A3K003 - A3K004 -
SAS FM Transaction Extensions 4.3 Decision Server (Unix), Rules Server (Unix) - - B1M001 - B1M002 - -


IMPORTANT NOTE

CONFIGURATION: No automatic configuration scripting is included for this hot fix. If you have previously configured software installed, the SAS Deployment Manager may present a screen where you will see "Apply SAS Hot Fixes" and "Configure SAS Hot Fixes" options. On this screen, you must ensure that the "Configure SAS Hot Fix" option is *not* selected. If this option is automatically selected, please de-select it prior to proceeding with the SAS Deployment Manager Screens. Failure to do so could have unintended consequences when applying this hot fix.


PRE-INSTALLATION INSTRUCTIONS

  1. Create a Deployment Registry report:

    Before applying this hot fix, follow the instructions in SAS Note 35968 to generate a SAS Deployment Registry report.

    Commands to create the report:
    1. cd <SASHome>/deploymntreg
    2. <JAVA_HOME>/bin/java -jar sas.tools.viewregistry.jar

    Two files are created: DeploymentRegistry.txt and DeploymentRegistry.html. Either of these files can be used to verify that the appropriate product releases are installed on your system. The release number information in the Deployment Registry report should match the 'member' release number provided above for the software components installed on each machine in your deployment. In addition, you can determine the current hot fix level by comparing the HOT FIX COMPONENT HISTORY chart above with the hot fix entries in the Deployment Registry report.

  2. Download Oracle JDBC Driver for JDK 7:

    For Oracle 11g environments, download the ojdbc7.jar from the Oracle website and add it to the <ORACLE_DIR>/client_1/jdbc/lib directory on the ODE server(s).

  3. Backups:  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.

    Backup the following:

    1. The <SASHOME> directory
    2. The <CONFIGDIR> directory
    3. Each database that will be updated by this hot fix. Review the POST-INSTALLATION INSTRUCTIONS section to determine if there are database updates.

    For a detailed list of updated files, see the hot fix manifest.  NOTE: The manifest is cumulative for all hot fixes for this release.

  4. Stop Servers:

    1. Stop the OnDemand Decision Engine (ODE) server(s).
      $ cd <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.3/<Auth-Domain>/engine/Server<n>/bin
      $ ./ose.sh stop
    2. All batch jobs running against the SAS FM databases should be paused.


SERVER INSTALLATION

  1. Important:  Install this hot fix using the same userid who performed the initial software installation.
  2. Install the hot fix using the SAS Deployment Manager (SDM):

    Hot Fix Z41007 must be installed on each machine where the updated components of the product, listed above, are installed.

    The hot fix will be applied using the SAS Deployment Manager (SDM). By default, the SDM 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. Do NOT extract the contents of   Z41007pt.zip into the selected directory. The hot fix installation process will extract the contents as needed.

    After copying Z41007pt.zip, follow the instructions for applying hot fixes in the SAS Deployment Wizard and SAS Deployment Manager 9.4: User’s Guide.

    For example:

    1. Set the DISPLAY environment variable, for example
      $ export DISPLAY=<displayname>:0
    2. From the SASDeploymentManager directory execute sasdm.sh

      $ cd <SASHOME>/SASDeploymentManager/9.4
      $ ./sasdm.sh

    Notes:

    The hot fix installation process generates the log file

    <!SASHOME>/InstallMisc/InstallLogs/IT_date-and-time-stamp.log
    for example, IT_2011-10-31-13.18.21.log. Each attempt to apply a hot fix results in the creation of a new log file giving detailed information regarding the installation process.

    Postexec log files are created after the installation is completed and identifies the files that were added, backed up, changed and removed. These log files include the ‘member’ hot fix id in the name of the file and are also written to the <!SASHOME>/InstallMisc/InstallLogs directory. There is one postexec log for each ‘member’ hot fix applied (member hot fixes are listed at the top of these instructions).


POST-INSTALLATION INSTRUCTIONS: SERVER TIER

    This section describes custom steps that depend on the starting version of your system before this hot fix was installed. Locate your starting version in the first column of the table below and perform only those steps listed in the second column for that version.

    Starting Version Steps
    4.3M0 (No hot fix)
    or
    4.3M0 HF1 through HF4

    Steps for upgrade from 4.3M0, HF1, HF2, HF3, HF4 to HF7

    1. Update ODE Server Configuration Files

      If you have customized any of the files copied in this step, you must merge your updates into the new versions.

      1. On each ODE server, back up the ose.xml and log4j-dev.xml files in the <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.3/<Auth-Domain>/engine/Server<n>/etc directory.

      2. On each ODE server, copy or merge these files:
        • ose.xml
        • log4j-dev.xml

        From: <SASHOME>/SASFraudManagementDecisionEngine/4.3/Config/etc
        To:   <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.3/<Auth-Domain>/engine/Server<n>/etc
    4.3M0 HF5
    or
    4.3M0 HF6

    Steps for upgrade from HF5 or HF6 to HF7

    There are no custom steps for the server tier to upgrade from HF5 or HF6 to HF7.


POST-INSTALLATION INSTRUCTIONS: DATA TIER

  1. Update the Databases:

    IMPORTANT: Database updates may not be required for every hot fix. Review this section carefully to determine if updates are needed.
    IMPORTANT: Files that have been run during previous hot fix installations should NOT be run a second time.

    1. Select the database update files to run. If there are no files that need to be run, skip to Step 2.

      The table below indicates the files that need to be run for each individual hot fix. These files are not cumulative. You will need to know the prior hot fix level of your system to determine which files to run. The SAS Deployment Registry report created in the PRE-INSTALLATION INSTRUCTIONS step can be used to determine the prior hot fix level if you do not already know it.

      • Run the files against the appropriate database in sequential order by HF number. Do not run files that have already been run during a prior hot fix install.
      • Run only the files for your database vender.
      • Database updates are generally performed by the database administrator (DBA).

      Vendor Database Hot fix File Instructions
      DB2 SOR HF2 sor_db2_upgrade_4.3.0.2.tar.gz SOR_DB2 updates: Installation Instructions for SOR_DB2 updates (1)
      DB2 SOR HF3 sor_db2_upgrade_4.3.0.3.tar.gz SOR_DB2 updates: Installation Instructions for SOR_DB2 updates (2)
      DB2 SOR HF6 sor_db2_upgrade_4.3.0.6.tar.gz SOR_DB2 updates: Installation Instructions for SOR_DB2 updates (3)
      DB2 TDR HF1 tdr_db2_upgrade_4.3.0.1.tar.gz TDR_DB2 updates: Installation Instructions for TDR_DB2 updates (1)
      DB2 TDR HF2 tdr_db2_upgrade_4.3.0.2.tar.gz TDR_DB2 updates: Installation Instructions for TDR_DB2 updates (2)
      Oracle SOR HF1 sor_oracle_upgrade_4.3.0.1.tar.gz SOR_Oracle updates: Installation Instructions for SOR_Oracle updates (1)
      Oracle SOR HF2 sor_oracle_upgrade_4.3.0.2.tar.gz SOR_Oracle updates: Installation Instructions for SOR_Oracle updates (2)
      Oracle SOR HF3 sor_oracle_upgrade_4.3.0.3.tar.gz SOR_Oracle updates: Installation Instructions for SOR_Oracle updates (3)
      Oracle SOR HF6 sor_oracle_upgrade_4.3.0.6.tar.gz SOR_Oracle updates: Installation Instructions for SOR_Oracle updates (4)
      Oracle TDR HF1 tdr_oracle_upgrade_4.3.0.1.tar.gz TDR_Oracle updates: Installation Instructions for TDR_Oracle updates (1)
      Oracle TDR HF2 tdr_oracle_upgrade_4.3.0.2.tar.gz TDR_Oracle updates: Installation Instructions for TDR_Oracle updates (2)
      Oracle TDR HF4 tdr_oracle_upgrade_4.3.0.4.tar.gz TDR_Oracle updates: Installation Instructions for TDR_Oracle updates (3)

    2. Create a "Z41007pt" directory on your machine and unzip the contents of Z41007pt.zip into that directory. The database update files are found in the Miscellaneous subdirectory.
    3. Copy the files to a location accessible by the DBA on the database server. Review all database update instructions carefully before running each update.


POST-INSTALLATION INSTRUCTIONS: MID TIER

  1. Update the web application deployed to your application server:

    IMPORTANT: Perform this step only if "SAS Fraud Management Mid-Tier" component was updated by this hot fix.

    1. Re-build Web Applications

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

      1. Set the DISPLAY environment variable, for example
        $ export DISPLAY=<displayname>:0
      2. Invoke the SAS Deployment Manager 9.4

        From the SASDeploymentManager directory execute sasdm.sh, for example

        $ cd <SASHOME>/SASDeploymentManager/9.4
        $ ./sasdm.sh
      3. Select a language in the Choose Language box
      4. Select Rebuild Web Applications
      5. Select Configuration Directory or Enter the Configuration Directory and Level that needs to be updated
      6. Specify Connection Information, including the sasadm User ID and Password
      7. Select SAS Fraud Management Mid-Tier as the Web Application to Rebuild
      8. Verify the information on the Summary screen and select Start
      9. Select Finish when the deployment is complete

      This process will update the Fraud Management ear in <CONFIGDIR>/Lev1/Web/Staging. A backup of the original ear file will be placed in the Backup directory.

    2. Re-deploy Web Application

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

      1. Set the DISPLAY environment variable, for example
        $ export DISPLAY=<displayname>:0
      2. Invoke the SAS Deployment Manager 9.4

        From the SASDeploymentManager directory execute sasdm.sh, for example

        $ cd <SASHOME>/SASDeploymentManager/9.4
        $ ./sasdm.sh
      3. Select a language in the Choose Language box
      4. Select Deploy Web Applications
      5. Select Configuration Directory or Enter the Configuration Directory and Level that needs to be updated
      6. Specify Connection Information, including the sasadm User ID and Password
      7. Check the Allow the application server to stop checkbox
      8. Select SAS Fraud Management Mid-Tier as the Web Application to Deploy
      9. Verify the information on the Summary screen and select Start
      10. Select Finish when the deployment is complete

      See SAS 9.4 Intelligence Platform Middle-Tier Administration Guide for more details on deploying Web Applications.


    POST-INSTALLATION: START SERVERS

    1. Redeploy Rules Files in SAS Fraud Management Web Application:

      Log in to the web application as a user with the privilege to deploy rules on the Console tab. Deploy all the existing rules files.

    2. Start Servers:

      1. Start the ODE server(s). Confirm there are no errors in the log.
        $ cd /Lev1/Applications/SASFraudManagement/4.3/<Auth-Domain>/engine/Server<n>bin
        $ ./ose.sh start tail
      2. Start any batch jobs that were paused before the installation.
    3. Create a final Deployment Registry report on each server:

      Run a new SAS Deployment Registry report following the same steps as in the PRE-INSTALLATION INSTRUCTIONS. The new report files will overwrite the existing ones. To retain the old files, save them to a new location or rename them before running the commands.

      Please send a copy of the final Deployment Registry report to SAS Fraud Management support.


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


    Copyright 2016 SAS Institute Inc. All Rights Reserved.