How to change Applications Manager details in RUM Agent?

1. Open the AppServer.properties file located under <RUMAgent_Home>/conf/ directory in any text editor.
2. Update Applications Manager hostname in apm.host key.
   
3. Update Applications Manager SSL Port in apm.https.port key.
   
4. Remove the key apm.apikey.encrypted (if present).
5. Add the apm.apikey (if not present). Update RUM API Key in apm.apikey key.
   
6. Save the changes and restart RUM Agent.
   

How to setup Proxy in RUM Agent to communicate with Applications Manager?

1. Open the AppServer.properties file located under <RUMAgent_Home>/conf/ directory in any text editor.
2. Search for proxy.required key.
   
1. If the key is not present uncomment following keys proxy.host, proxy.port, proxy.ishttps, proxy.authscheme, proxy.username and proxy.password by removing "#" present before the keys.
   
2. If the key is present set proxy.required key value as true.
   
3. Update proxy host name in proxy.host key.
   
4. Update proxy port number in proxy.port key,
   
5. Update  proxy.ishttps key based on the proxy protocol. Set the value as true for HTTPS protocol.
   
6. Update proxy authscheme in proxy.authscheme key.
   
7. Update proxy user name in proxy.username key.
   
8. Remove the key proxy.password.encrypted (if present).
9. Add the proxy.password (if not present). Update proxy password in proxy.password key.
10. Save the changes and restart RUM Agent.

Example : 

####proxy properties to connect to AppManager                                                                                                                                                       

proxy.host=127.0.01

proxy.port=8081

proxy.ishttps=true

proxy.authscheme=basic

proxy.username=admin

proxy.password=admin

If proxy is not required

1. Search for proxy.required key.
   
1. If the key is not present, comment following keys proxy.host, proxy.port, proxy.ishttps, proxy.authscheme, proxy.username and proxy.password by adding "#" before the keys.
   
2. If the key is present, set proxy.required key value as false.
   

How to change RUM Agent HTTP port?

1. Open the awsadapterconf.properties file located under <RUMAgent_Home>/conf/ directory in any text editor.
   
2. Update the port in webserver.port key.
   
3. Save the changes and restart RUM Agent.
   

How to change from HTTP to HTTPS or HTTPS to HTTP protocol in RUM Agent?

1. To change Agent protocol from HTTP to HTTPS refer this KB.
   
2. To change Agent protocol from HTTPS to HTTP follow the below steps.
   
1. Open the AppServer.properties file located under <RUMAgent_Home>/conf/ directory in any text editor.
   
2. Set apm.rum.isHttps key value as false.
   
3. Save the changes and restart RUM Agent.

How to use default RUM Agent Geolocation API?

1. To make use of any other third party Geolocation API refer this KB.
   
2. To use default RUM Agent Geolocation API follow the below steps
   
1. Open the AppServer.properties file located under <RUMAgent_Home>/conf/ directory in any text editor.
   
2. Set geo.api.type key value as 0.
   
3. Save the changes and restart RUM Agent.

Default RUM Agent Geolocation API will not provide ISP data of end user. To get ISP data make use of any third party Geolocation API.

How to check the RUM Agent version?

You can check the version of RUM agent directly from the RUM agent home page (shown after starting the agent) or by finding out the value displayed for the key apm.rum.version in the AppServer.properties file located under <RUMAgent_Home>/conf directory.