How can we run the Hotfix APM10.5.1HF44 script?

Document ID : KB000016556
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 any 10.5.1 hotfixes for agent side from support, these will not be included in this patch.

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

3. If you have 10.5.1 GA version (10.5.1.6) 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.1HF44"
      Please note that APM10.5.1.60XHF.jar is not intended to perform an upgrade of the complete product, it only replaces the affected jars and modifies the IntroscopeEnterpriseManager.properties and teamcenter-status-mapping.properties files. 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.1HF44 script?

Environment:
APM 10.5.1
Answer:

HOW TO RUN THE HOTFIX SCRIPT:
**************************
1. Stop:
   - Enterprise Manager (MOM/collector), APMSQLSERVER
   - Webview
   - Workstation
   
   NOTE: individual components that are installed together can be also patched in one go, for example, EM, Webview and APMSQLSERVER

2. Copy APM10.5.1.70XHF.jar  to the HOME directory of the product you would like upgrade.

3. Execute
   - If windows: jre\bin\java -jar APM10.5.1.70XHF.jar
   - If unix:    jre/bin/java -jar APM10.5.1.70XHF.jar

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

   >> Hotfix 10.5.1-hf44 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.1-hf44 was rolled back successfully   
   
5. Start:
   - Enterprise Manager (MOM/collector), APMSQLSERVER
   - Webview
   - Workstation
   
If you are using ACC:
You DO NOT need to execute jre/bin/java -jar APM10.5.1.70XHF.jar for ACC. Instead, you need to manually remove the "Automation Attribute Decoration" bundle because it is not possible to provide support of this bundle in CA APM 10.5.1. 

1. Login to ACC
2. Remove the "Automation Attribute Decoration" bundles from the packages if it is included.
3. Apply the updated Package to the Update the Agents.
4. Click on "Bundles"
5. Find Bundle named "Automatic Attribute Decoration".
6. Click "Delete".


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), APMSQLSERVER
   - Webview
   - Workstation

2. The original files are available under "hotfix/10.5.1-hf44" folder. All the files are organized accordingly to the product directory structure.
   - Copy the files manually to the original location.
   - Delete APMSqlServer/repo/com.ca.apm.server.teiid-10.5.1.70.jar if present.

   NOTE: Make sure to use the appropriate user credentials.

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

Additional Information:

[Fixed Issues]

DE318328 - Harvest spikes on collector once a day
DE319075 - ArrayIndexOutOfBoundsException in debug logger of metric query
DE309789 - MoM Losing Conn w/ Collectors - Deadlock
DE312165 - Double encryption of DB connection password
DE314778 - SmartStor tool for fixing metadata corruption
DE308408 - Team Center slow and MOM low on memory
DE285052 - UIM action not showing caution or danger only Critical
DE299068 - Using webservices API causes collectors disconnections
DE305489 - APM 10.5.1 HF# 33 : Transaction trace filter problem
DE288486 - Error: "20-Apr-2017 11:15" is an invalid value for "closeDate"
DE305112 - 10.5.1 HF#33 - 00790258-Seeing negative value for metrics
DE308581 - 00794336-APM alerts to SOI after HF21 install
DE310220 - Slow performance in ATC (gzip for REST API)
US381480 - rootContext application name override on server side
DE306800 - Security vulnerability on Teamcenter
DE307631 - Experience View take too long appear
DE295987 - Move back button on Webview/Workstation does not show historic data
DE309466 - DSE Not able to delete manually changed attribute values
DE305224 - Prevent empty map when agent end time is in future
DE305319 - 00750514: 10.5.1 HF#20 - Collectors Disconnecting
DE304871 - Exclude alerts caused by errors per interval from calculation
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
DE291332 - APM 10.5.1 HF# 22 : Continuation of DE283380 to get hotfix for /castylesr5.1.2/ scenario.
DE250244 - FIX - Href value missing from webstart workstation.jsp
DE263800 - APM SSO using EEM and Siteminder not working
DE269370 - [post10.5.1] Search doesn't work on edges
DE271947 - Group (perspective) status on the map does not considered backend vertices statuses
DE272647 - FIX - cannot start second webview on same machine
DE273797 - Number of group components not consistent
DE275086 - Large tile hover icon overflows node container
DE275548 - Windows IE11 can't touch a scrollbar in Team Center
DE276331 - Team Center is not visible after the server restart and the page reload
DE277929 - Doubleclicking on an edge that is between group and terminal node results in exceptions in the console
DE278411 - Timeline - JavaScript exception
DE278434 - Clicking timeline event in notebook is generating error message
DE280061 - Missing metric mapping for Backend REST webservices in ATC details panel (no Blamepoint Metrics visible)
DE280165 - Merge - APM 10.3 Hotfix#32 - 00676206 - 10.3 HF26 creating invalid view names for custom reports
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
DE281478 - Setting default perspective doesn’t work
DE282139 - LDAP User search in Universe User Assignment doesn't work
DE282651 - 00701154 - Resizing Browser Window breaks Team Center display
DE284600 - High ART for Patch graph/vertex
DE284606 - Incorrect time stamp for Last Modification in Universes
DE285010 - Fix - APM 10.5.0 HF#7 - MOM not able to start
DE286436 - SmartStor Metadata directory is default to data/metadata during upgrade
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
DE288738 - [bug bash]Transaction Count does not match across Overall and Transaction Volume Graph
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.
DE291362 - 10.5.2_SupportBundler tool fails to collect Smartstor data
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
DE292414 - [bug bash] 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
DE293463 - DOM based Cross site Scripting in /diagramming/SOADependencyMap.jsp?drawingContextID=90026
DE294163 - HTTP status 400 Bad Request when deleting custom attributes
DE294842 - Pin-at layout issues in webview chart
DE273881 - ATC REST API should handle larger number of concurrent requests without affecting WebView
DE284600 - High ART for Patch graph/vertex
DE295611 - Alerts - Incorrectly firing
DE294218 - Webview Home Page Graph Issue
DE284339, DE289774 - Topology map does not contain complete map of application components, because transaction processing does not handle the load and is discarding traces.
DE291527 - Non-Admin user's are seeing data related to admin. It seems to be permission issues when clicked on HOME tab on WebView.
DE297388 - I often got an IE11 error page when I clicked on links in ATC, especially on "Go To Map"
DE297389 - I sometimes got "long running script" error messages
DE297391 - There is no link back from the Analysis Notebook to the last card that I viewed before opening the notebook, only one level higher
DE285829 - No Apply/Revert/Delete buttons for TT Action
DE283380 - Team Center/Webview not using context path properly
DE287337 - RemoteHttpCallService throws spring exception agent cannot deserialize
DE284575 - When EEM is involved, users are unable to login into APM sometimes, until the MOM is restarted
DE280989 - Long time to login after upgrade to APM 10.5.1
US321408 - Performance: ACA settings cache. This is formally a story but the behavior is really defective without this fix.
DE286423 - UI fix. It fixes disabled Drop down menu in case user has no access. It also fixes performance issue in Card edit preview
DE275548 - deregister live mode watch on HomeController destroy
DE283806 - 'Average DOM Processing Time' for Browser Page load metrics is not reported in ATC
DE282662 - BA JS calculator does not aggregate BA metrics
DE277100 - Private cards sharing - APM 10.5 Hotfix#07
DE284214 - Dashbard Resolution
DE282378 - 10.5.1.6 - Future time range showing on graph on workstation
DE280422 - APM 10.5.1 HF#3 - 00691951 - 10.5: workstation starts a metric a few data points off of graph
DE282381 - 10.5.1.6 - 15 seconds reverting to 30 seconds on miscellaneous tab on graph
DE281772 - 10.5.1.6 top n filter graphs incorrect
DE281767 - 10.5.1.6 Resolution ignored for graph display widgets in webview
DE280667 - 10.5.1.6 Resolution ignored for graph display widgets
DE280888 - Team Center Bad Performance
DE277100 - Private cards sharing
DE281123 - Use live data clamp when possible
DE281137 - Disable legacy appmap backend
DE280064 - com.wily.introscope.server.enterprise.entity.rocksdb.RocksDBInternalException: org.rocksdb.RocksDBException: Corruption: checksum mismatch
DE279628 - greyed metrics are showing after agent connects regardless of activity
DE270510 - 10.5 Team Center Analysis Notebook showing incorrect number (0) of poor transactions
DE281693 - EM WONT START AFTER 10.5.1.8 UPGRADE
DE277867 - Memory leak in Team Center - simple click on tile leaks 2MB
DE282582 - Prod MOM down
DE279390 - APM 10.5.1 HF#4 - 10.5.1.6 - ORA-01400 Cannot insert NULL value into apm_owner
DE272528 - Order by failed count of cards is not working
DE273141 - docops links not working in 10.5.1
DE269372 - [post10.5.1] Edges inside group and grouped edges -- highlight doesn't propagate
DE269703 - duplicate doctype element
DE269797 - ""Experience View"" in the menu is the last option in Internet Explorer (as compared with Chrome and Firefox browsers)
DE271622 - Proxy vertex with uppercase host name not matched to backend call
DE272038 - Selecting group (perspective) does not consider backend vertices to be displayed in RHS panel and timeline
DE272518 - Remote http call does not support PATCH operation
DE272537 - Inferred DB does not have Hostname attribute
DE272538 - No Metric Mapping for Backend REST webservices
DE273131 - NullPointerException: Decoration rule cannot be created
DE269369 - [post10.5.1] Status on edges is not updated correctly
DE270358 - AT Panel Story never changes to inactive
DE271654 - Webserver PP not resolving localhost/127.0.0.1
DE271674 - Attribute list not sorted alphabetically
DE272042 - ART charts drop to zero on the right.
DE272254 - Selecting evidence will not move view for selected vertex
DE273009 - Tile status has to be calculated from ordinary vertex alerts only - UVB alerts has to be ignore
DE273012 - Variance Intensity alerts are not visualized on metric charts
DE273110 - Added Application Errors and Application Response Time into Default MM, modified Metric Expressions for Transaction Errors, Transaction Response Time and Response Time Variance Intensity
DE275020 - Experiences drop-down does not respect the user's selection
DE271901 - 10.5 - APMSQLserver property not being honored
DE272970 - Sometimes DBTC stories don't come up in 10.5.1
DE273272 - Alerts on Application Entry Points do not create AT Evidences
DE271972 - Drilldown from anomaly or problem sometimes show different BTs
DE313018 - 00828458 - ATC Experience View display problem with large values in Aggregated Response Time Histogram
DE316874 - 00823730-Authentication error with LDAP Users on local ATC