How do I disable clustering in JBoss EAP 4.x's "production" configuration?

Solution Verified - Updated

Environment

  • Red Hat JBoss Enterprise Application Platform (EAP)
    • 4.2
    • 4.3

Issue

  • How do you disable clustering on an existing 'production' or 'all' configuration ?
  • I'm in the process of slimming an EAP instance. What configuration changes are required to remove clustering ?

Resolution

If you want a system without clustering, it is generally better to start with the 'default' configuration and add what is required, rather than trying to remove clustering from the 'production' configuration.

To disable clustering in an existing "production" or "all" configuration:

  1. Remove the following files and/or directories: 
    • deploy/cluster-service.xml
    • deploy/jboss-web-cluster.sar
    • deploy/ejb3-clustered-sfsbcache-service.xml
    • deploy/ejb3-entity-cache-service.xml
    • deploy/deploy.last/farm-service.xml
    • farm
    • deploy/deploy-hasingleton-service.xml
    • deploy-hasingleton
  2. In deploy/jboss-web.deployer/META-INF/jboss-service.xml, remove or comment the text "<depends>jboss.cache:service=TomcatClusteringCache</depends>" wherever it appears in the file.
  3. Replace deploy/httpha-invoker.sar with deploy/http-invoker.sar from the "default" configuration.
  4. EAP 4.2 Only:
    • Replace deploy/jms with deploy/jms from the "default" configuration.
  5. EAP 4.3 Only:
    • In deploy/jboss-messaging.sar/*-persistence-service.xml, change <attribute name="Clustered">true</attribute> to false.
    • In deploy/hajndi-jms-ds.xml, comment out the <attribute name="Properties"> section.
Components

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.