whibr08

Tech Tip - CA MAA: Migrating MAA 15.2 to APM 10.x

Discussion created by whibr08 Employee on Jul 16, 2015
Latest reply on Jul 17, 2015 by Dharmaraj01

CA Mobile Application Analytics (MAA) Tuesday Tip by Bryan Whitmarsh, Sr Principal Technical Consultant for Tuesday, July 14, 2015


In this Tuesday tip I’ll walk you through how to configure your 15.2 MAA Server environment to support APM 10.0. The assumption here is that you are running an on-premise install of CA MAA version 15.2 or higher along with CA APM version 10.0 or higher. If your MAA/APM landscape doesn’t yet meet these requirements, stop what your doing and upgrade ASAP, you’re really missing out on some awesome new product releases from CA!!!


Now if you don’t care about the new 15.2 MAA APM Deep Link feature you’re already done. APM 10.0 can support MAA with the same functionality it did in 9.7 out of the box (check boxing the MAA “Send data to CA APM” app profile setting). With this box checked APM can monitor your application calls. But in MAA 15.2 there’s new functionality that allows you to jump straight from a Transaction within MAA to that same Transaction inside of APM 10.x’s new Team Center console.

Image_01.jpg

Image_02_v2.jpg

Ok, the first step is to configure your MAA Server to use the new APM 10.0 Team Center url syntax. By default, MAA 15.2 assumes you are running APM version 9.7. If you do not follow this step, your MAA “Deep Links” to APM will not work. On your MAA Server you will need to edit a file called “mdo-server_instance.properties” which is located just off the home directory of your MAA Server in the “conf” directory (/$CA_EMM_HOME/conf). At the bottom of this file you will find the APM URL section.

prop_file_updated_url.jpg

Comment out the line just under “#APM url for 9.7” by adding a “#” in front of it.

 

Now this is where it gets tricky. If you are running APM 10.1 you will simply uncomment out (remove the “#”) the line just under the “#APM url for 10.0”. But there is currently an issue with version 10.0 that requires us to use a different APM Team Center view based on the Business Service. Please type in the below line under the #APM url for 10.0” section. PLEASE DO NOT COPY AND PASTE. Copy and paste can cause the syntax errors between fonts where a “”” isn’t really an “””, etc. Trust me on this one!   

 

apm.url=http://{APMHostPort}/ApmServer/#/map?m=H&ts1={starttime}&ts2={endtime}&f={"bsf":["{bsname}"]}

 

You will need to restart your MAA Server for this change to take affect.

 

Now we are ready to tell the MAA Server which Mobile Apps you want to support the new MAA Deep Link functionality. You do this by running a script (sorry, I’m sure this will be a check box soon). The script is called “createAppConfig.sh” in your /$CA_EMM_HOME/testscripts folder on your MAA Server. Before running this script be sure to update the variables at the top of the script file to match your MAA and APM setup.

 

Example:

###### Change these values to create tenant-app specific config key and value ######

appId=<your appId>

tenantId=<your tenantId – long alpha numeric value>

configKey=APMHostPort

configValue=<IP Address of your APM Server:Port Number>

######################################################################

 

####### Environment details to execute the API ###############################

USER=<your MAA UserID with access to this tenant>

COHORT=<the friendly tenant ID or Name you enter when logging into the MAA Console>

PASS=<your user password>

SERVER=http://<your MAA Server:Port>

URL_CREATE_APP_CONFIG=$SERVER/mdo/v1/apps/config

#####################################################################

 

Tip: Download/view a PLIST for the app to find most of this information above.

 

Once you have modified the script you can run it. This information can be found on the CA Product Wiki (https://wiki.ca.com/display/CAMAA152/Integrate+CA+Mobile+App+Analytics+with+CA+APM).

 

Now you are ready to test by clicking on a specific “TRANSACTION” on the “TRANSACTIONS” tab on an “APP SESSION”. If the blue APM link appears, click on it and it should take you to your APM 10.0 Team Center with the correct Business Session or Business Transaction in the “PERSPECTIVE”.

Image_01.jpg

Outcomes