Deleting an integration server

Delete integration servers by using IBM® App Connect Enterprise Toolkit, the web user interface, or a command.

Before you begin

Check that the integration server is running; you cannot delete an integration server that is stopped.

About this task

Use one of the following methods to complete this task:

You can also use the IBM Integration API to delete integration servers on all platforms; see Managing resources by using the IBM Integration API.

Deleting an integration server by using the IBM App Connect Enterprise Toolkit

Procedure

Complete the following steps to delete an integration server:

  1. Open the IBM App Connect Enterprise Toolkit, and switch to the Integration Development perspective.
  2. In the Integration Explorer view, expand your integration node.
  3. Right-click the integration server that you want to delete, and click Delete > Integration Server.

Results

Your integration server and all resources that are deployed to it are deleted.
  • If you created any integration server profiles for this integration server, delete them manually if they are no longer required.
  • If the shared-classes directory (under workpath/config/<my_int_node_name>/<my_int_server_label>) is empty, this directory is automatically deleted.
    Note: If the shared-classes directory is not empty but is no longer required, the directory can be deleted manually.

Deleting an integration server by using the web user interface

Procedure

Complete the following steps to delete an integration server:

  1. Start the web user interface for your integration node; see Accessing the web user interface.
    The navigator is displayed on the left side of the pane, showing the servers (integration servers), message flows, and other resources that are owned by your integration node.
  2. Expand the Servers folder, click the down arrow beside the integration server you want to delete to display the menu, and then click Delete.
  3. Click Yes to confirm that you want to delete the integration server.

Results

Your integration server and all resources that are deployed to it are deleted.
  • If you created any integration server profiles for this integration server, delete them manually if they are no longer required.
  • If the shared-classes directory (under workpath/config/<my_int_node_name>/<my_int_server_label>) is empty, this directory is automatically deleted.
    Note: If the shared-classes directory is not empty but is no longer required, the directory can be deleted manually.

Deleting an integration server by using the mqsideleteexecutiongroup command

Procedure

Complete the following steps to delete an integration server:

  1. If you are deleting an integration server on Linux®, UNIX, and Windows systems:
    1. Open a command window for your installation.
    2. Enter the mqsideleteexecutiongroup command, and specify the parameters for the integration server that you want to delete.
      • If the integration node is local, specify the integration node name; for example:
        mqsideleteexecutiongroup -n INODE -e IServer_2
      • If the integration node is remote, you can specify a configuration file; for example:
        mqsideleteexecutiongroup -n INODE.broker -e EGroup_2
      • If the integration node is remote, you can alternatively specify the connection parameters -i and -p; for example:
        mqsideleteexecutiongroup -e IServer_2 -n INODE -e IServer_2 -p 4414 -i

      See the mqsideleteexecutiongroup command description for more details about these options.

  2. If you are deleting an integration server on z/OS®:
    1. Configure the BIPDLEG job to specify the properties for the integration server that you want to delete.
    2. Run the BIPDLEG job.

Results

Your integration server and all resources that are deployed to it are deleted.
  • If you created any integration server profiles for this integration server, delete them manually if they are no longer required.
  • If the shared-classes directory (under workpath/config/<my_int_node_name>/<my_int_server_label>) is empty, this directory is automatically deleted.
    Note: If the shared-classes directory is not empty but is no longer required, the directory can be deleted manually.