Troubleshooting
Problem
After installing IBM Cloud Application Performance Management 8.1.4.0 Server Interim Fix 11 and editing an application in the IBM Cloud APM console, the application membership information is removed from the APM SCR32 Db2 database. The application membership information is one of the factors determining which agents are shown in the My Components application for each Cloud APM console user.
Symptom
After a user edits an existing application in the Cloud APM console then users who are authorized to view the application may not see agents from the application in My Components. However, they will continue to see the expected agents in the modified application.
Environment
Cloud APM server 8.1.4 with IBM Cloud Application Performance Management 8.1.4.0 Server Interim Fix 11
Diagnosing The Problem
To determine if your Cloud APM server has the problem, perform these steps:
1) Confirm the IBM Cloud APM 8.1.4.0 Server Interim Fix 11 is installed on the Cloud APM server:
1a) Change to the install_dir/ccm/fixes directory where install_dir is the directory where you installed the Cloud APM server.
1b) If you see the server-8.1.4.0-IF0011.xml file and there is not a later server-8.1.4.0.IF0*.xml file then you need to perform the steps in the "Resolving The Problem" section after performing step 2 below.
Note: if a later Cloud APM server interim fix is installed (for example, server-8.1.4.0.IF012.xml) then you do not need to perform the recovery steps since the fix will be included in all future server interim fixes.
2) If IBM Cloud APM 8.1.4.0 Server Interim Fix 11 is installed then perform these steps to identify the applications that are affected by the problem:
2a) Enter this URL in a browser window:
where you need to replace apm-server with the hostname or IP address of the Cloud APM server.
When prompted for credentials, enter smadmin / apmpass. If you created a custom password for the apmadmin user during the APM server install or used the smapasswd.sh script to change the password of the smadmin user then specify your custom password in place of apmpass.
2b) For each row in the table where the LABEL column contains http://www.ibm.com/APMUI/ServiceInstance and the parentId column contains a number such as 46, click on the Application Model link.
If you see a page similar to the one below where there only three lines of text then application membership information is not available in the SCR32 Db2 database and you should edit the application when performing the steps in the Resolving The Problem section.
Application Model: application name
2021-03-01 15:14:38.332
2021-03-01 15:14:38.332
- application name - crtv:Application (C-286) - Clear
Resolving The Problem
To resolve the problem:
1) Download ASICLTools.jar to the /tmp directory on the Cloud APM server and then perform these steps on the Cloud APM server:
1a) cp install_dir/ccm/SCR/XMLtoolkit/jars/ASICLTools.jar install_dir/ccm/backup/scr-10/ASICLTools.jar.if11
where install_dir is the home directory of the Cloud APM server, for example /opt/ibm/ccm
1b) cp /tmp/ASICLTools.jar install_dir/ccm/SCR/XMLtoolkit/jars
1c) apm restart scr
2) Log into the Cloud APM console as a role administrator or as a user who can edit the affected applications. Then perform the following steps for each application that was modified after IBM Cloud Application Performance Management 8.1.4.0 Server Interim Fix 11 was installed:
2a) Edit the application.
2b) Remove an instance from the application.
2c) Add the same instance back to the application.
2d) Save the application.
Notes:
a) If you did not edit any applications after installing interim fix 11 then you can skip step 2. If you do not know if any applications were edited after interim fix 11 was installed, see the steps in the Diagnosing The Problem section to determine which applications have the problem.
b) See this Cloud APM Knowledge Center topic for information about editing an application and removing and adding instances for an application:
Related Information
Document Location
Worldwide
[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSVJUL","label":"IBM Application Performance Management"},"Component":"kafka","Platform":[{"code":"PF016","label":"Linux"}],"Version":"8.1.4","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]
Product Synonym
apm;apmv8
Was this topic helpful?
Document Information
Modified date:
03 March 2021
UID
ibm16417533