Unconfiguring the data collector for on-premises applications

If you do not need to monitor your Liberty servers or if you want to upgrade the data collector to a new version, you must unconfigure the data collector that you deployed to the Liberty server.

About this task

To unconfigure the data collector that is deployed to the Liberty server, roll back the changes that are made when you configure the data collector. You can choose to configure the data collector manually or with the provided unconfig_liberty_dc script.

• To manually unconfigure the data collector, complete the following steps:
  1. Navigate to the Liberty server home directory. For example, /opt/ibm/wlp/usr/servers/defaultServer.
  2. Edit the jvm.options file to remove the following parameters if any.

     -agentlib:am_ibm_16=server_name
     -Xbootclasspath/p:dc_home/toolkit/lib/bcm-bootstrap.jar
     -Djava.security.policy=dc_home/itcamdc/etc/datacollector.policy
     -Dliberty.home=liberty_home
     -Xhealthcenter:level=inprocess
     -Xgc:allocationSamplingGranularity=10000
     -verbosegc
     -Xverbosegclog:absolute_path_to_log_file,1,10000

  3. Edit the server.env file in the same directory to remove the following value for the LD_LIBRARY_PATH

     /lib:dc_home/toolkit/lib/lx8266:dc_home/toolkit/lib/lx8266/ttapi

     where dc_home is the home directory of the data collector. For example, /opt/ibm/apm/liberty_dc/.gdc/7.3.0.14.08.

  4. Edit the server.xml file in the same directory to remove <feature>monitor-1.0</feature> from the <featureManager> section.
  5. Restart the Liberty server.
• To unconfigure the data collector with the unconfig_liberty_dc.sh script, complete the following steps:
  1. Change to the dc_home/bin directory. For example, /opt/ibm/apm/liberty_dc/.gdc/7.3.0.14.08/bin.
  2. Start the unconfiguration script by running the following command:

     ./unconfig_liberty_dc.sh

  3. When prompted, enter the root of your Liberty installation directory or accept the default. For example, /opt/ibm/wlp.
  4. The unconfiguration program can automatically discover and list the application servers that are configured within the specified directory. Enter the number that corresponds to the Liberty server that you want to unconfigure. To select more than one server, separate the numbers by space or enter * to select all.
  5. After the unconfiguration program finishes updating files for all Liberty servers, restart the servers for changes to take effect.

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.

You can also delete the home directory of the data collector if you do not need it anymore.