Network Deployment (Distributed operating systems), v8.0 > Administer applications and their environment > Administer Service integration > Administer messaging engines > Configure messaging engines


Remove a messaging engine from a bus

We can remove a messaging engine from a service integration bus if you no longer require it to send and receive messages on the bus.

You should be wary of deleting and recreating messaging engines on bus members for which WS-Notification-administered subscribers have been configured, because in some cases this can leave the remote web service subscription active (and passing notification messages to the local server) even though there is no longer any record of it. See the WS-Notification troubleshooting tip Problems can occur when deleting administered subscribers and messaging engines.


Procedure

  1. Stop the messaging engine. We can stop either in Immediate or Force mode, as described in Stop a messaging engine.

  2. Use the wsadmin command deleteSIBEngine to delete the messaging engine. All service integration bus links, MQ links, and custom properties that are owned by the engine are deleted.

    When you remove a messaging engine, WAS does not delete the data store tables automatically. We must remove them manually, or delete all the rows in all the tables. If you do this, a new messaging engine might fail to start if it attempts to use an orphaned data store. Refer to the documentation for your chosen relational database management system for information about deleting tables.

    Alternatively, for Apache Derby, you can delete the database directory, which is located in PROFILE_ROOT/databases/com.ibm.ws.sib, where PROFILE_ROOT is the directory in which profile-specific information is stored. However, do this only if the messaging engine is the sole user of the database.

    See Data store life cycle.

    Similarly, the file store files are not automatically deleted when you delete the messaging engine. You might want to delete the file store files to reclaim disk space.


Messaging engines
Emptying the data store for a messaging engine
Delete files following removal of a messaging engine


Related


deleteSIBEngine command
Messaging engine troubleshooting tips

+

Search Tips   |   Advanced Search