Unconfiguring the data collector in silent mode

You can unconfigure the data collector using the unconfiguration utility in silent mode.

Before you begin

Use the user ID for configuring the data collector to unconfigure the data collector, which is also the user ID for installing the application server. Verify that this user ID has read and write permissions to the data collector home directory and all its sub-directories. The data collector home directory is as follows, where install_dir is the WebSphere® Applications agent installation directory.
  • Windowsinstall_dir\dchome\7.3.0.14.08
  • Linux or AIXinstall_dir/yndchome/7.3.0.14.08

About this task

When you unconfigure the data collector in silent mode, you first specify configuration options in a properties file. A sample properties file, sample_silent_unconfig.txt, is packaged with the unconfiguration utility. The file is available in bin directory within data collector home directory.

Procedure

  1. Log in to the system with the user ID that is used to configure the data collector.
  2. Specify the configuration options in the properties.txt file.
    The following properties are available for unconfiguring the data collector in silent mode:
    WebSphere Application Server connecting settings
    was.wsadmin.connection.host
    Specifies the name of the host to which the wsadmin tool is connecting.
    WebSphere Application Server global security settings
    was.wsadmin.username
    Specifies the user ID of a user who is authorized to log on to the IBM® WebSphere Application Server administrative console. This user must have the agent role on the application server.
    was.wsadmin.password
    Specifies the password that corresponds to the user specified in the was.wsadmin.username property.
    WebSphere Application Server settings
    was.appserver.profile.name
    Specifies the name of the application server profile you want to unconfigure.
    was.appserver.home
    Specifies the WebSphere Application Server home directory.
    was.appserver.cell.name
    Specifies the WebSphere Application Server cell name.
    was.appserver.node.name
    Specifies the WebSphere Application Server node name.
    Backup of the WebSphere Application Server configuration
    was.backup.configuration
    Specifies whether to back up the current configuration of the WebSphere Application Server data collector before unconfiguring the data collector. Valid values are True and False.
    was.backup.configuration.dir
    Specifies the location of the backup directory.
    WebSphere Application Server runtime instance settings
    was.appserver.server.name
    Specifies an application server instance within the application server profile for which you want to unconfigure the data collector.
    Tip: The silent response file can have multiple instances of this property.
  3. Navigate to the following directory:
    • Windowsinstall_dir\dchome\7.3.0.14.08\bin
    • Linux or AIXinstall_dir/yndchome/7.3.0.14.08/bin
  4. Run the following command:
    • Windows
      unconfig.bat -silent path_to_silent_file
    • Linux or AIX
      unconfig.sh -silent path_to_silent_file
  5. After the data collector unconfiguration completes, restart the application server instances.
    The data collector configuration takes effect when the application server instances are restarted. PMI resource monitoring for the server instance is still available.
  6. Optional: If you want to use resource monitoring for a server instance after unconfiguring the data collector, restart the monitoring agent by running the following commands:
    • Windows
      cd install_dir\bin
      was-agent.bat stop
      was-agent.bat start
    • Linux or AIX
      cd install_dir/bin
      ./was-agent.sh stop
      ./was-agent.sh start