Unconfiguring the data collector for IBM Cloud applications

If you do not need to monitor your Liberty profiles in IBM® Cloud environment or if you want to upgrade the data collector to a new version, you must unconfigure the data collector that you previously deployed.

About this task

To unconfigure the data collector for your Liberty profile in IBM Cloud environment, roll back the changes that are made in jvm.options, server.env and server.xml files, and then update the Liberty profile in IBM Cloud with the cf push command.

Procedure

  1. In your local directory of the Liberty profile, modify the jvm.options file to remove the following parameters. You can delete the file if it is empty after the change.
    -agentlib:am_ibm_16=defaultServer
    -Xbootclasspath/p:../../../../.gdc/7.3.0.14.08/toolkit/lib/bcm-bootstrap.jar
    -Djava.security.policy=../../../../.gdc/7.3.0.14.08/itcamdc/etc/datacollector.policy
    -Dliberty.home=/home/vcap/app/.liberty
    -Xhealthcenter:level=inprocess
    -Xgc:allocationSamplingGranularity=10000
    -verbosegc
    -Xverbosegclog:/home/vcap/app/wlp/usr/servers/defaultServer/logs/gc.log,1,10000
  2. In the server.env file, remove the following value for the LD_LIBRARY_PATH environment variable. You can delete the file if it is empty after the change.
    LD_LIBRARY_PATH=:/lib:../../../../.gdc/7.3.0.14.08/toolkit/lib/lx8266:../../../../.gdc/7.3.0.14.08/toolkit/lib/lx8266/ttapi
  3. Modify the server.xml file to remove the monitor-1.0 feature by removing the following line to the <featureManager> section
    <feature>monitor-1.0</feature>
  4. Delete the .gdc directory within the Liberty home directory.
  5. Open a command prompt, change to the directory that contains the manifest.yml file of the Liberty server.
  6. Log in to IBM Cloud and update the Liberty profile with the cf push command.

What to do next

After you unconfigure the data collector, the Cloud APM console continues to display the data collector in any applications that you added the data collector to. The Cloud APM console will show that no data is available for the application and will not indicate that the data collector is offline. For information about how to remove the data collector from applications and from resource groups, see Removing data collectors from Cloud APM console.