search cancel

DX APM - Installation of Multiple Instances of the Infrastructure Agent not honoring the blanks in the display_name.

book

Article ID: 238068

calendar_today

Updated On:

Products

DX Application Performance Management

Issue/Introduction

Symptoms:
To install the second instance of APMIA on the same server you will follow the steps from DX APM - SaaS:

https://techdocs.broadcom.com/us/en/ca-enterprise-software/it-operations-management/dx-apm-saas/SaaS/implementing-agents/infrastructure-agent/Install-the-Infrastructure-Agent-on-Windows.html

APMIACtrl.bat install service_name "<service_name>" display_name "<display_name>"

However, using the command above is not honoring the blanks in the display_name as per the below screenshot:

Cause

This problem is related to defect DE531889. This is a mishandling of the APMIACtrl.bat installation script. The wrapper.name and wrapper.ntservice.displayname properties of the conf\wrapper.conf file do not contain the proper values after executing APMIACtrl.bat.

Environment

Windows Server 2012 & 2019
APM Infrastructure Agent 10.7 - already installed
DX APM Infrastructure Agent 22.1.0.25 downloaded from SaaS installed as a 2nd instance of the APMIA on the same machine

Resolution

The one-line fix in APMIACtrl.bat is to be fixed in the next release of DX APM SaaS AMPIA Agent.

WORKAROUND:

Please reinstall your APMIA agent after modifying the line below in APMIACtrl.bat to use quotes around the 2 command line parameters:

call :update_service_details !SERVICE_NAME! !DISPLAY_NAME!

to 

call :update_service_details "!SERVICE_NAME!" "!DISPLAY_NAME!"

After this change the generated conf\wrapper.conf after executing APMIACtrl.bat install will contain the proper values for a wrapper.name and wrapper.ntservice.displayname properties.

Additional Information

You can use the following command to uninstall your 2nd APMIA instance:

APMIACtrl.bat uninstall service_name "<service_name>" display_name "<display_name>"

https://techdocs.broadcom.com/us/en/ca-enterprise-software/it-operations-management/dx-apm-saas/SaaS/implementing-agents/infrastructure-agent/Install-the-Infrastructure-Agent-on-Windows.html

Attachments