How can we run the Hotfix APM10.5.2HF17 script?

Document ID : KB000016493
Last Modified Date : 14/02/2018
Show Technical Document Details
Introduction:

1. This fix is for server side patches only, no install/deployment to agents. If you already have received 10.5.2 hotfixes for agent side from support, these will not be included in this patch.

2. If you have any pre-10.5.2 version installed you cannot use this script, use the 10.5.2 product installer to upgrade.

3. If you have 10.5.2 GA version (10.5.2.15) or higher installed, you have 2 options:

   a) Use the product installer to upgrade
      Remember, any customization done earlier needs to be manually merged after the installation. Depending of your implementation this can be a complex process with many steps.

   b) (Recommended) Use this script to apply "10.5.2-HF17"
      Please note that APM10.5.2.54XHF.jar is not intended to perform an upgrade of the complete product, it only replaces the affected jars. The rest of the product files remain intact at the original release number.
      This process is simple and should take a few minutes only.

4. For the list of fixes in this Hotfix, refer to [Fixed Issues] in "Additional Information" section

Question:

How can we run the hotfix APM10.5.2HF17 script?

Environment:
APM 10.5.2SP2
Answer:

HOW TO RUN THE HOTFIX SCRIPT:
***************************
1. This hotfix script updates the following product components: Enterprise Manager, WebView, Workstation 

2. Stop:
   - Enterprise Manager (MOM/collector)
   - Webview
   - Workstation
   
   NOTE: individual components that are installed together can be also patched in one go, for example, EM, Webview and APMSQLSERVER

3. Copy APM10.5.2.54XHF.jar  to the HOME directory of the product components you would like to apply the hotfix. For example, if WebView is installed separately, run the hotfix script from
   that WebView HOME directory.

4. Execute
   - If windows: jre\bin\java -jar APM10.5.2.54XHF.jar
   - If unix:    jre/bin/java -jar APM10.5.2.54XHF.jar

   NOTE: Make sure to run the script using the appropriate user credentials.
   
5. Verify the results: 

   >> Hotfix 10.5.2-HF17 was applied successfully.
  
   If the HF script fails for some reason with the below message, the script will automatically rollback the changes. Open a support case and attach the hotfix.log file.
   
   >> Hotfix 10.5.2-HF17 was rolled back successfully   
   
6. Start:
   - Enterprise Manager (MOM/collector)
   - Webview
   - Workstation
   


HOW TO UNINSTALL THE HOTFIX:
**************************
The script doesn't provide with an option to automatically uninstall the Hotfix.
If for some reason, you need to uninstall it, you should proceed as below:

1. Stop:
   - Enterprise Manager (MOM/collector)
   - Webview
   - Workstation

2. The original files are available under "hotfix/10.5.2-HF17" folder. All the files are organized accordingly to the product directory structure.
   - Copy the files manually to the original location.

   NOTE: Make sure to use the appropriate user credentials.

3. Start:
   - Enterprise Manager (MOM/collector)
   - Webview
   - Workstation

 

Additional Information:

[Fixed Issues]

DE323355 - ETC is not responding or very slow
DE321832 - Experience Card - discrepancy between summary and details ART graphs
DE310236 - Experience for .NET application has no traffic
DE318332 - Webview graphs does not show negative values
DE307922 - Rendering of metric graphs with fine resolution in Webview is very slow in IE
DE318328 - Harvest spikes on collector once a day
DE319075 - ArrayIndexOutOfBoundsException in debug logger of metric query
DE309789 - MoM Losing Conn w/ Collectors - Deadlock
DE316361 - HttpErrorCodeReporter error metric increments bypasses error ignore property - part 2
DE308408 - HF35 historical query fix (HTTP error 500)
DE292019 - 00723904 - AWS: standalone EM; Webview shows blocked mixed active content
DE311433 - 00815669-EM Jetty causes redirect in some cases
DE311940 - [PO:WatchedAgentPO Mailman 1] [Manager.AT] Error processing traces; ignoring them null java.lang.NullPointerException
DE313211 - deployment issues - SAML webstart
DE303613 - HttpErrorCodeReporter error metric increments bypasses error ignore property
US381480 - missing jar in 10.5.1 hotfix 30 (rootContext application name override)
DE310220 - Slow performance in ATC
DE305085 - Adding gzip compression for ATC REST
DE248777 - 00594120 - APM 10.5.2 HF#9 - 00594120 -   10.3: EM Cluster abandoning metrics; restart required to restore metrics
DE269349 - 00624026 - 00624026 - Hebrew (or Korean) characters do not appear correctly in SOI alert UI
DE291332 - 00740228 - APM 10.5.1 HF# 22 : Continuation of DE283380 to get hotfix for /castylesr5.1.2/ scenario.
DE295987 - 00745958 - 00745958 - Move back button on Webview/Workstation does not show historic data
DE298315 - 00762747 - 00762747 - Unexpected behavior in Experience View
DE304812 - None - Remove the (value) inside the bracket (Alerts section) in ATC Component View and keep only worst state in that alert for the vertex/group
DE304871 - None - Exclude alerts caused by errors per interval from calculation
DE305224 - 00787631 - 00787631-Application of HF20 has not resolved performance issues
DE305319 - 00750514 - 00750514: 10.5.1 HF#20 - Collectors Disconnecting
DE306800 - 00796281 - 00796281-Security vulnerability on Teamcenter reveals loginID on URL
DE307631 - 00796915 - Experience View take too long appear
DE307711 - 00793780 - 00793780-Application name override property with APM agent
DE308408 - 00805577 - 00805577 - TeamCenter extremely slow and MOM low on memory after applying APM 10.5.1 Hotfix#24
DE309120 - 00809121 - APM 10.5.2 Hotfix#7 - 00809121 - .Net Browser Agent response cookie insertion error "[IntroscopeAgent.CookieUtils] Failed to decorate the Response.Input string"
DE309466 - 00809911 - APM 10.5.1 HF#28 - 00809911-DSE Not able to delete manually changed attribute values
DE312505 - None - Webview Memory regression from HF8
DE308408 - Team Center slow and MOM low on memory
DE307710 - Weblogic Agent throwing webservice error
DE285052 - UIM action not showing caution or danger only Critical
DE299068 - Using webservices API causes collectors disconnections
DE305489 - Transaction trace filter problem
DE288486 - Error: "20-Apr-2017 11:15" is an invalid value for "closeDate"
DE305112 - Seeing negative value for metrics
DE308581 - Remove hex encoding . Read the metricOID and messageOID as UTF-8 strings.
DE314778 - corrupted SmartStor metadata
DE312165 - Restart of MOM double encrypts Oracle DB pass temp workaround over writes the DB connection string
DE312152 - 00824039-10.5.2: Unable to log into CEM
DE315357 - 00819466-User not redirected to assigned Universe upon logging in to Team Center
DE292019 - 00723904 - AWS: standalone EM; Webview shows blocked mixed active content
DE311433 - 00815669-EM Jetty causes redirect in some cases
DE311940 - [ERROR] [PO:WatchedAgentPO Mailman 1] [Manager.AT] Error processing traces; ignoring themnull java.lang.NullPointerException
DE313211 - deployment issues - SAML webstart
DE291332 - Hotfix for /castylesr5.1.2/ scenario.
DE295987 - Move back button on Webview/Workstation does not show historic data
DE305224 - Prevent empty map when agent end time is in future
DE306800 - Security vulnerability on Teamcenter
DE307631 - Experience View take too long appear
DE309466 - DSE Not able to delete manually changed attribute values
US381480 - rootContext application name override on server side
DE310220 - Slow performance in ATC
DE298315 - Unexpected behavior in Experience View
DE248777 - EM Cluster abandoning metrics; restart required to restore metrics
DE250244 - FIX - Href value missing from webstart workstation.jsp
DE254845 - ORA-24816 error message in the em log
DE263800 - APM SSO using EEM and Siteminder not working
DE271947 - Group (perspective) status on the map does not considered backend vertices statuses
DE272038 - Selecting group (perspective) does not consider backend vertices to be displayed in RHS panel and timeline
DE272647 - FIX - cannot start second webview on same machine
DE273797 - Number of group components not consistent
DE273881 - ATC REST API should handle larger number of concurrent requests without affecting WebView
DE275086 - Large tile hover icon overflows node container
DE275824 - MQMonitor: "Reason code 2235 MQRC_CFH_ERROR"
DE280165 - Merge - APM 10.3 Hotfix#32 - 00676206 - 10.3 HF26 creating invalid view names for custom reports
DE280699 - APM is not reporting all stats for message broker
DE280754 - Fix - APM 10.1.0 HF #29 - Hot Fix Needed for Live Mode Query
DE280989 - Long time to login after upgrade to APM 10.5.1
DE283711 - Heap dump shows wily web services classes as leak suspect
DE284600 - High ART for Patch graph/vertex
DE285010 - Fix - APM 10.5.0 HF#7 - MOM not able to start
DE286528 - 00720350 - I sometimes got "long running script" error messages (14).
DE286529 - 00720351  - There is no link back from the Analysis Notebook to the last card that I viewed before opening the notebook, only one level higher
DE286561 - Assisted Triage problems and evidences are not shown in UI
DE287308 - SC00722638 - permission error when attempting to make a perspective default when created by another admin account
DE287625 - 00697979 - introscope.agent.metricClamp not cleared automatically
DE288486 - Error: "20-Apr-2017 11:15" is an invalid value for "closeDate"
DE288738 - [bug bash]Transaction Count does not match across Overall and Transaction Volume Graph
DE289774 - some agents not appearing over ATC.
DE290262 - Duplicate key value violates unique constraint "aca_user_pk" Error In EM for 10.6
DE290330 - Drag and drop is not possible in Experience View if the number of cards is larger than can be fitted in the view.
DE291527 - APM 10.5.1 HF# 19 : 00721859 - Non-Admin user permission issues when clicked on HOME tab on WebView
DE292175 - [bug bash] Clicking a card caused error which resulted in corrupted view
DE292187 - [bug bash] the filter on application in universe doesn't seem to work
DE292194 - [bug bash] Page Refresh loses Universes Selection
DE292201 - [bug bash] Experience cards constantly loading but not displaying data.
DE292203 - [bug bash] Edges not correctly reflecting alert status
DE292282 - Edge missing between frontends
DE292283 - Custom Metric Aggregation fails when string metrics are reported
DE292306 - SaaS-PM:  issues with sharing agents across 2 JVMs
DE292414 - Disabled menu items
DE292789 - DBTCAnalyst throws error in log when no Agent name found in attribute
DE292965 - 10.5.2_Analysis workbench properties still exist in SAP EM
DE293224 - Migration of the 10.2.0 universe security triggers on EM startup and ends with and Error.
DE293463 - DOM based Cross-site Scripting in /diagramming/SOADependencyMap.jsp?drawingContextID=90026
DE294163 - HTTP status 400 Bad Request when deleting custom attributes
DE294218 - 10.5.1 HF#9 - Webview Home Page Graph Issue
DE294842 - Pin-at layout issues in webview charts
DE296132 - Card sorting is not persistent
DE298947 - APM 10.5.1 HF#20 - HOTFIX request for DE273881 & DE284600
DE301207 - the login window is skipped or not.
DE302952 - Object doesn't support property or method exception in IE on map
DE303177 - DE291527 - 10.5.2SP1 : 00721859 - Non-Admin user permission issues when clicked on HOME tab on WebView
DE303434 - SQL rest api federated  query timeout
DE304186 - Fix - 10.5.2SP1 - 00707531 - EM failed to start up and getting "SuperDomain/EXAMPLE" does not exist when a custom domain is deleted.
DE304188 - Fix - 10.5.2SP1 - Error encountered in dbtc evaluation: null
DE304189 - Fix - 10.5.2SP1 - APM 10.5.1 HF#20 - 00752594 - Alerts - Incorrectly firing
DE304812 - Remove the (value) inside the bracket (Alerts section) in ATC Component View and keep only worst state in that alert for the vertex/group
DE304871 - Exclude alerts caused by errors per interval from calculation
DE305319 - 00750514: 10.5.1 HF#20 - Collectors Disconnecting
DE306819 - Unchecked filter gets deleted
DE306820 - attribute values are not filtered out when defining a filter
DE306821 - Duplicated attribute names in a filter should not be allowed
DE304382 - 10.5.2 Docker Agent Rest API Connection Failing over HTTPS
DE301456 - Numerous warnings in MOM's log
DE302229 - UI State Aggregation for vertex folders
DE302952 - Object doesn't support property or method exception in IE on map
DE273659 - Change session id after login to prevent session fixation attack