Installation Instructions for Hot Fix C4E010
Linux for x64
Hot fix C4E010 addresses the issue(s) in SAS Fraud Management 4.4_M1 as documented
in the Issue(s) Addressed section of the hot fix download page:
http://ftp.sas.com/techsup/download/hotfix/HF2/C4E.html#C4E010
On SAS 9.4 M6:
- This hot fix requires SAS Security Updates to be installed IMMEDIATELY after applying this hot fix.
- Please read this entire document before beginning the hot fix installation.
- If you do not complete the SAS Security Updates after installing this hot fix, SAS Fraud Management will be inoperable.
On SAS 9.4 M5:
- There are no SAS Security Updates.
C4E010 is a "container" hot fix that contains the following "member" hot fixes which will update the software components
as needed.
D4U001 updates SAS Fraud Management Common Macros 4.4_M1
C6G008 updates SAS Fraud Management Decision Engine 4.4_M1***
C4F009 updates SAS Fraud Management Mid-Tier 4.4_M1***
C6I003 updates SAS Fraud Management Reporting History ETL Server Macros 4.4_M1
C8J002 updates SAS Fraud Management Scoring Engine for zOS 4.4_M1
C7Q002 updates SAS Fraud Management System of Record DB Maintenance Macros 4.4_M1
C4G008 updates SAS Fraud Management Transaction Extensions 4.4_M1
C6H007 updates SAS Fraud Transactional Analysis Engine 4.4_M1***
*** member hot fixes that have been updated since the previously released hot fix (C4E009)
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 |
C4E001 HF1 |
C4E002 HF2 |
C4E003 HF3 |
C4E004 HF4 |
C4E005 HF5 |
C4E006 HF6
| C4E007 HF7
| C4E008 HF8
| C4E009 HF9
| C4E010 HF10
|
SAS FM Common Macros 4.4_M1 |
Batch Server (Unix) |
- |
- |
D4U001 |
- |
- |
- |
- |
- |
- |
- |
SAS FM Decision Engine 4.4_M1 |
Decision Server |
- |
C6G001 |
C6G002 |
C6G003 |
C6G004 |
C6G005 |
C6G006 |
C6G007 |
- |
C6G008 |
SAS FM Mid-Tier 4.4_M1 |
Midtier |
- |
C4F001 |
C4F002 |
C4F003 |
C4F004 |
C4F005 |
C4F006 |
C4F007 |
C4F008 |
C4F009 |
SAS FM Reporting History ETL Server Macros 4.4_M1 |
Batch Server (Unix) |
- |
C6I001 |
C6I002 |
- |
- |
C6I003 |
- |
- |
- |
- |
SAS FM Scoring Engine for zOS 4.4_M1 |
Decision Server |
- |
C8J001 |
- |
- |
- |
- |
C8J002 |
- |
- |
- |
SAS FM System of Record DB Maintenance Macros 4.4_M1 |
Batch Server (Unix) |
- |
C7Q001 |
- |
C7Q002 |
- |
- |
- |
- |
- |
- |
SAS FM Transaction Extensions 4.4_M1 |
Decision Server (Unix), Rules Server (Unix), Scoring Server (Z64) |
C4G001 |
C4G002 |
C4G003 |
C4G004 |
C4G005 |
C4G006 |
C4G007 |
C4G008 |
- |
- |
SAS Fraud Transactional Analysis Engine 4.4_M1 |
Transaction Analysis Server |
- |
C6H001 |
C6H002 |
C6H003 |
- |
- |
C6H004 |
C6H005 |
C6H006 |
C6H007 |
IMPORTANT NOTES
- It is strongly recommended that you install hot fixes in a non-production environment and test *before* installing them in production.
- The POST-INSTALLATION INSTRUCTION sections are *not* optional. These steps must be reviewed and performed where
applicable for all hot fix installations. Any questions on these steps should be directed to support before you begin the installation.
- On SAS 9.4 M6, this hot fix requires the installation of the SAS Security Updates after the POST-INSTALLATION steps. Failure to install the SAS Security Updates will result in the SAS Fraud Management solution being inoperable.
Please refer to SAS Note 69006 for details.
PRE-INSTALLATION INSTRUCTIONS
- Important: If your current system is at 4.4M1 HF2 (Version 5 Release 8) or lower and your Multi-Entity History (MEH) database is Oracle,
please read SAS Note 63933 carefully before beginning this hot fix install.
- Create a Deployment Registry report on each server:
Before applying this hot fix, follow the instructions in SAS Note 35968 to generate a SAS Deployment Registry report.
Commands to create the report:
- cd <SASHome>/deploymntreg
- <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. You can determine the
current hot fix level by comparing the member hot fix numbers in the HOT FIX COMPONENT HISTORY chart above with the hot
fix entries in the Deployment Registry report.
- Backups: Full backups are required. The backups will be needed to roll-back this hot fix installation should an issue occur.
Backup the following on each Server:
- <SASHOME> directory
- <CONFIGDIR> directory
- Database(s) that will be updated by this hot fix. Review the POST-INSTALLATION INSTRUCTIONS: DATA TIER
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.
- Stop SAS Fraud Management Servers and Processes:
- Stop the OnDemand Decision Engine (ODE) server(s). Log on as the ODE user and run:
$ cd <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/engine/Server<n>/bin
$ ./ose.sh stop
- Stop the Transactional Analysis Server (TAS). Log on as the TAS user and run:
$ cd <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/analysis/bin
$ ./tas.sh stop
- All batch jobs and processes running against the SAS FM databases should be stopped.
- All rule estimations should be stopped.
- Stop SAS Servers:
Stop the SAS servers using the sas.servers script located in <CONFIGDIR>/Lev1 directory:
$ ./sas.servers stop
SERVER INSTALLATION
- Important: Install this hot fix using the same userid who performed the initial software installation.
- Install the hot fix using the SAS Deployment Manager (SDM):
Hot Fix C4E010 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
C4E010pt.zip into the selected directory. The hot fix installation process will extract the contents as needed.
After copying C4E010pt.zip, follow the instructions for applying hot fixes
in the SAS Deployment Wizard and SAS Deployment Manager 9.4: User's Guide.
For example:
- Set the DISPLAY environment variable, for example
$ export DISPLAY=<displayname>:0
From the SASDeploymentManager directory execute sasdm.sh
$ cd <SASHOME>/SASDeploymentManager/9.4
$ ./sasdm.sh
Important: The SAS Deployment Manager will present a screen with two options: "Apply SAS hot fix" and "Configure SAS hot fix"
On this screen, you must ensure that the "Configure SAS hot fix" option is *not* selected before continuing.
Notes:
- If this hot fix has been previously installed, use the -reinstallhotfix option when running the SDM.
$ ./sasdm.sh -reinstallhotfix
- If friendly fixes have been previously installed or manual file updates have been made in <SASHOME>,
use the -alwaysoverwrite option to ensure that those files are overwritten by the SDM.
$ ./sasdm.sh -alwaysoverwrite
The hot fix installation process generates a log whose name matches this pattern:
<SASHOME>/InstallMisc/InstallLogs/IT_date-and-time-stamp.log
An example file name is: IT_2021-05-28-11.00.31.log. Each attempt to apply a hot fix results in the
creation of a new log file giving detailed information regarding the installation process.
For each member hot fix, additional logs are written to the <SASHOME>/InstallMisc/InstallLogs directory.
The logs whose names end with "_Install_postexec.log" identify the files that
were added, backed up, changed and removed by the installation of that member hot fix.
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.4M1(No Hot Fix) or 4.4M1 HF1 or 4.4M1 HF2 |
Steps for upgrade from base 4.4M1 or HF1 or HF2 to HF10
- Update TAS Script Files:
IMPORTANT: If you have customized any of the files copied in this step, you must merge your updates into the new versions.
- Back up the <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/analysis/bin directory.
- Copy these files:
- esrt.sh
- esrt_tests.sh
- functions.sh
- tas-esc.sh
- tas.sh
- wipeout.sh
From: <SASHOME>/SASFraudTransactionalAnalysisEngine/4.4/Config/bin
To: <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/analysis/bin
- Update TAS Server Property File:
- Back up the <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/analysis/etc/tas.properties file.
>
-
Merge the updates
From: <SASHOME>/SASFraudTransactionalAnalysisEngine/4.4/Config/etc/tas.properties.orig
To: <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/analysis/etc/tas.properties
- Update ODE Server Configuration Files:
IMPORTANT: If you have customized any of the files copied in this step, you must merge your updates into the new versions.
On each ODE Server:
- Back up the <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/engine/Server<n>/etc directory.
- Copy these files:
- actions.xml
- database.xml
- jms.xml
- log4j2-test.xml
- ose.xml
- post-score-actions.xml
- redis.xml
- txn.xml
From: <SASHOME>/SASFraudManagementDecisionEngine/4.4/Config/etc
To: <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/engine/Server<n>/etc
- Update ODE Server Property File:
On each ODE Server:
Merge the updates
From: <SASHOME>/SASFraudManagementDecisionEngine/4.4/Config/etc/ose.properties.orig
To: <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/engine/Server<n>/etc/ose.properties
- Update ODE Script Files:
IMPORTANT: If you have customized any of the files copied in this step, you must merge your updates into the new versions.
On each ODE Server:
- Back up the <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/engine/Server<n>/bin directory.
- Copy these files:
- jose.sas
- msgapi_pb2.py
- ose.py
- ose.sh
From: <SASHOME>/SASFraudManagementDecisionEngine/4.4/Config/bin
To: <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/engine/Server<n>/bin
- Update DBMS Configuration File:
On the Batch Server:
- Back up the <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/dbms/etc/initialLoad.xml file.
- Merge the updates
From: <SASHOME>/SASFoundation/9.4/misc/fsmcm/dbms/etc/initialLoad.xml.orig
To: <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/dbms/etc/initialLoad.xml
- Update DBMS Script File:
On the Batch Server:
- Back up the <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/dbms/bin/tdrddl.sh file.
- Merge the updates
From: <SASHOME>/SASFoundation/9.4/misc/fsmcm/dbms/bin/tdrddl.sh.orig
To: <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/dbms/bin/tdrddl.sh
- Update Common Point of Purchase (CPP) SAS File:
On the Batch Server:
- Back up the <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/batch/cpp/src/sas/cpp_autoexec.sas file.
>
-
Merge the updates
From: <SASHOME>/SASFoundation/9.4/misc/fsmetl/source/cpp_autoexec.sas
To: <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/batch/cpp/src/sas/cpp_autoexec.sas
|
4.4M1 HF3 or 4.4M1 HF4 or 4.4M1 HF5 |
Steps for upgrade from 4.4M1 HF3 or HF4 or HF5 to HF10
- Update ODE Server Configuration Files:
IMPORTANT: If you have customized any of the files copied in this step, you must merge your updates into the new versions.
On each ODE Server:
- Back up the <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/engine/Server<n>/etc directory.
- Copy these files:
- actions.xml
- ose.xml
- post-score-actions.xml
From: <SASHOME>/SASFraudManagementDecisionEngine/4.4/Config/etc
To: <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/engine/Server<n>/etc
- Update ODE Server Property File:
On each ODE Server:
Merge the updates
From: <SASHOME>/SASFraudManagementDecisionEngine/4.4/Config/etc/ose.properties.orig
To: <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/engine/Server<n>/etc/ose.properties
- Update ODE Script Files:
IMPORTANT: If you have customized any of the files copied in this step, you must merge your updates into the new versions.
On each ODE Server:
- Back up the <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/engine/Server<n>/bin directory.
- Copy these files:
From: <SASHOME>/SASFraudManagementDecisionEngine/4.4/Config/bin
To: <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/engine/Server<n>/bin
|
4.4M1 HF6 |
Steps for upgrade from 4.4M1 HF6 to HF10
- Update ODE Server Configuration Files:
IMPORTANT: If you have customized any of the files copied in this step, you must merge your updates into the new versions.
On each ODE Server:
- Back up the <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/engine/Server<n>/etc directory.
- Copy these files:
From: <SASHOME>/SASFraudManagementDecisionEngine/4.4/Config/etc
To: <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/engine/Server<n>/etc
- Update ODE Server Property File:
On each ODE Server:
Merge the updates
From: <SASHOME>/SASFraudManagementDecisionEngine/4.4/Config/etc/ose.properties.orig
To: <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/engine/Server<n>/etc/ose.properties
- Update ODE Script Files:
IMPORTANT: If you have customized any of the files copied in this step, you must merge your updates into the new versions.
On each ODE Server:
- Back up the <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/engine/Server<n>/bin directory.
- Copy these files:
From: <SASHOME>/SASFraudManagementDecisionEngine/4.4/Config/bin
To: <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/engine/Server<n>/bin
|
4.4M1 HF7 |
Steps for upgrade from 4.4M1 HF7 to HF10
- Update ODE Server Configuration Files:
IMPORTANT: If you have customized any of the files copied in this step, you must merge your updates into the new versions.
On each ODE Server:
- Back up the <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/engine/Server<n>/etc directory.
- Copy these files:
From: <SASHOME>/SASFraudManagementDecisionEngine/4.4/Config/etc
To: <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/engine/Server<n>/etc
- Update ODE Server Property File:
On each ODE Server:
Merge the updates
From: <SASHOME>/SASFraudManagementDecisionEngine/4.4/Config/etc/ose.properties.orig
To: <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/engine/Server<n>/etc/ose.properties
- Update ODE Script Files:
IMPORTANT: If you have customized any of the files copied in this step, you must merge your updates into the new versions.
On each ODE Server:
- Back up the <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/engine/Server<n>/bin directory.
- Copy these files:
From: <SASHOME>/SASFraudManagementDecisionEngine/4.4/Config/bin
To: <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/engine/Server<n>/bin
|
4.4M1 HF8 or 4.4M1 HF9 |
Steps for upgrade from 4.4M1 HF8 or HF9 to HF10
There are no custom steps for the server tier to upgrade from 4.4M1 HF8 to 4.4M1 HF9.
|
- Execute SAS Fraud Management DBMS Package to Update the Databases
-
The following table describes the database changes for each hot fix. The DBMS script for each database will examine the current state
of the database and apply the required changes for the all previous hot fixes and the current hot fix.
Vendor |
Database |
Hot fix |
Updates |
DB2 |
MEH |
HF2 |
Add stored procedures to support signature retrieval and updates from the ODE. |
Oracle |
MEH |
HF2 |
- Introduce use of Oracle Packages for some stored procedures.
- Add package procedure to support signature updates from ODE. Signature retrieval for Oracle delivered previously.
|
DB2 and Oracle |
SOR |
HF2 |
- Add new table FCM_ESTIMATE_RULE.
- Add new properties: template.callScript.maxSize, analyst.memo.maxSize, analyst.memo.enableHTML.
- Hide the fulfillment.enabled, fulfillment.white.list.alert.types, fulfillment.white.list.multiOrgIds properties.
- Drop check constraint FCM_ENTITY_DETAIL_METADATA.CK_ENTITY_DETAIL_METADATA4.
- Add TEMPLATE_CONTENT column to FCM_FIELD_DEFINITION and FCM_TEMPLATE tables.
- Populate TEMPLATE_CONTENT column in FCM_TEMPLATE table from TEMPLATE_TEXT column.
- Add MEMO_CONTENT and MEMO_PREVIEW columns to FCM_ALERT_FULFILLMENT table to support larger memo fields.
- Populate MEMO_CONTENT and MEMO_PREVIEW columns in FCM_ALERT_FULFILLMENT table from MEMO_TEXT column.
- Modified insert_alert_action, save_alert_fulfil, save_alert procedures to support FCM_ALERT_FULFILLMENT table changes.
- (Oracle only) Introduce use of Oracle Packages for some stored procedures.
|
DB2 and Oracle |
MEH |
HF3 |
- Fix code in Oracle Packages that introduces deadlocks in High insert contentious scenarios.
|
Oracle |
MEH |
HF3 |
Please read SAS Note 63933 regarding this update.
Important: If you have partition compression enabled, you must follow the steps in the SAS Note to manually add the database column to these tables before running the mehddl.sh to update the MEH.
- Add Z_CONV_ID Column to FMH_Z_DATA and FMH_Z_DATA_00 - FMH_Z_DATA_33 tables to support Signature migration.
- Add V_CONV_ID Column to FMH_V_DATA and FMH_V_DATA_00 - FMH_V_DATA_33 tables to support Signature migration.
|
Oracle |
SOR |
HF3 |
- Grant CREATE TABLE authorization to SAS_SOR_BATCH in Oracle.
|
DB2 and Oracle |
SOR |
HF3 |
- In initial load, the default grid has rqo_tran_date_alt and rqo_tran_time_alt fields in field_order=3. They should be 1 and 2 repectively. This change fixes the field_order.
- Add OPERATIONAL_STATE column to FCM_RULE table to support disabling rules. 0- Not Disabled;1=disable for execution ;2=disabled for decisions.
- Add CK_RULE_OPSTATE check constraint on OPERATIONAL_STATE column to FCM_RULE table.
- Add the new privilege DISENARULE.
- Add the new privilege "DISENARULE" to "Senior Rules Editor" role and the "Rules Administrator" role.
- Add OPERATIONAL_TIME_LIMIT column to the FCM_RULE table to identify maximum expected rule execution time in microseconds.
- Add the new property rule_time_limit.
- Add the 375 characters srp_rule_overtime column to the SRP segment.
- Update the SRP segment set SEGMENT_OSE_IO_TYPE "U".
|
Oracle |
TDR |
HF3 |
- Grant CREATE TABLE authorization to SAS_TDR_BATCH in Oracle.
|
DB2 and Oracle |
TDR |
HF3 |
- Add missing DUA Segments columns to the FCM_CCNM, FCM_CSNM, FCM_LCNM, FCM_MANM, FCM_NANM, FCM_SLNM tables.
|
DB2 |
SOR |
HF4 |
- Assign authorization to the temp tablespace to the SAS_SOR_APP role.
|
DB2 |
MEH |
HF5 |
- Cluster the primary key indexes on the FMH_V_DATA and FMH_Z_DATA partitioned tables. The change impacts new databases only.
|
Oracle |
MEH |
HF5 |
- Queries are changed from dynamic to static in the Oracle packages.
|
Oracle |
TDR |
HF7 |
- Update the decode_base64_signature function.
|
- Log on to the Batch Server as the SAS installation user.
- Change to the <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/dbms/bin directory.
- (Optional) To preview the SQL for the changes that will be applied to each database, run the following commands:
$ ./mehddl.sh preview
$ ./sorddl.sh preview
$ ./tdrddl.sh preview
- Run the database update scripts. Check each log for errors. By default, the logs are in <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/dbms/logs directory.
$ ./mehddl.sh update
$ ./sorddl.sh update
$ ./tdrddl.sh update
Notes:
- You can run all three <db>ddl.sh scripts whether there are database changes or not. The DBMS package will determine what updates are needed and skip the rest.
-
If a script fails with a checksum error, clear the checksums for the failed database followed by the update command:
$ ./mehddl.sh clearCheckSums
$ ./mehddl.sh update
$ ./sorddl.sh clearCheckSums
$ ./sorddl.sh update
$ ./tdrddl.sh clearCheckSums
$ ./tdrddl.sh update
- You can update the logging level and log file location the database properties files located in the <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/dbms/etc directory.
- Update the web application deployed to your application server:
IMPORTANT:
- On SAS 9.4 M6, skip this step. The SAS Security Updates in the next step require that all
web applications be rebuilt and redeployed.
- On SAS 9.4 M5, perform this step only if "SAS Fraud Management Mid-Tier" component
was updated by a hot fix since your starting hot fix version.
- Rebuild Web Applications
In order for this step to execute correctly, the Metadata Server must be running.
- Set the DISPLAY environment variable, for example
$ export DISPLAY=<displayname>:0
- Invoke the SAS Deployment Manager 9.4
From the SASDeploymentManager directory execute sasdm.sh,
for example
$ cd <SASHOME>/SASDeploymentManager/9.4
$
./sasdm.sh
- Select a language in the Choose Language box
- Select Rebuild Web Applications
- Select Configuration Directory or Enter the Configuration Directory
and Level that needs to be updated
- Specify Connection Information, including the sasadm User ID
and Password
- Select SAS Fraud Management Mid-Tier as the Web
Application to Rebuild
- Verify the information on the Summary screen and select Start
- 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.
- Redeploy Web Application
In order for this step to execute correctly, the Metadata Server must be running.
- Set the DISPLAY environment variable, for example
$ export DISPLAY=<displayname>:0
- Invoke the SAS Deployment Manager 9.4
From the SASDeploymentManager directory execute sasdm.sh,
for example
$ cd <SASHOME>/SASDeploymentManager/9.4
$
./sasdm.sh
- Select a language in the Choose Language box
- Select Deploy Web Applications
- Select Configuration Directory or Enter the Configuration Directory
and Level that needs to be updated
- Specify Connection Information, including the sasadm User ID
and Password
- Check the Allow the application server to stop checkbox
- Select SAS Fraud Management Mid-Tier as the Web
Application to Deploy
- Verify the information on the Summary screen and select Start
- Select Finish when the deployment is complete
See SAS 9.4 Intelligence Platform Middle-Tier Administration
Guide for more details on deploying Web Applications.
IMPORTANT: This step only applies to SAS 9.4 M6. Skip this step if you are on SAS 9.4 M5.
On SAS 9.4 M6, this hot fix requires the installation of the SAS Security Updates. Please refer to
SAS Note 69006 for details. A link to the security update instructions is on this download page:
SAS Security Updates and Hot Fixes.
All web applications must be rebuilt and redeployed during the final step of the SAS Security Updates installation instructions.
- Run the SAS Deployment Manager. Select Rebuild Web Applications to rebuild all web applications.
- Remove log4j JARS from the newly rebuilt SAS Fraud Management web application by running these commands:
$ cd <CONFIGDIR>/Lev1/Web/Staging/exploded/sas.finserv.frdmgmt4.4<Auth-Domain>.ear/sas.finserv.frdmgmt4.4<Auth-Domain>.war/WEB-INF/lib
$ rm log4j*
- Run the SAS Deployment Manager. Select Deploy Web Applications to redeploy all web applications.
Failure to install the SAS Security Updates on SAS 9.4 M6 will result in the SAS Fraud Management solution being inoperable.
Restart the SAS servers using the sas.servers script located in <CONFIGDIR>/Lev1 directory:
$ ./sas.servers stop
$ ./sas.servers start
- 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.
Note: After a hot fix install, all users may need to clear their web browser cache before running the web application.
- Start SAS Fraud Management Servers:
- Start the TAS server. Log on as the TAS user and run:
$ cd <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/analysis/bin
$ ./tas.sh start
Confirm there are no errors in the log.
- Start the ODE server(s). Log on as the ODE user and run:
$ cd <CONFIGDIR>/Lev1/Applications/SASFraudManagement/4.4/<Auth-Domain>/engine/Server<n>bin
$ ./ose.sh start
Confirm there are no errors in the log.
- Start any batch jobs that were stopped before the installation.
- 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.
If SAS Business Orchestration Services (BOSS) is used to send transactions to the SAS OnDemand Decision Engine, then three JAR files must match between the OnDemand Decision Engine
and the BOSS installation.
The three JAR files are:
- sas.finance.fraud.engine.jar
- sas.finance.fraud.transaction.jar
- sas.finserv.creditfraud.common.jar
If these jars have been updated by this hot fix or any previous hot fix, they must be copied into the 'lib' subdirectory of the BOSS installation directory.
For additional details see SAS Note 68969.
Important: Save a backup copy of the jars from the BOSS directory before replacing them.
This completes the installation of hot fix C4E010 on Linux for x64.
Copyright 2017 SAS Institute Inc. All Rights Reserved.