The default MQ integration mode for a Communications Server cluster instance is LOCAL. When Communications Server is installed in a location (PATH) that is long (read “not short”), imqbrokerscv.exe crashes when the cluster instance starts. The problem is a memory allocation problem in imqbrokersvc.
The JMS service type for the cluster instance must be changed from the default LOCAL to REMOTE. In this configuration, all the instances point back to the DAS broker. Follow the instructions below to configure a cluster in REMOTE mode.
When using REMOTE mode, all instances are using one broker (DAS) , and therefore no broker cluster is created when the Communications Server cluster starts up. See “Auto-clustering” in Section 4.1, Division iii of the one-pager at http://www.glassfishwiki.org/gfwiki/attach/OnePagersOrFunctionalSpecs/as-mq-integration-gfv2.txt for more information. The above functionality will not be available!
Modify the port and password file according to your environment. Note that in the instructions below, the cluster name is racluster, the DAS admin port is 5858, and the DAS JMS port is 7676.
Modify the cluster configuration, changing the JMS type to REMOTE.
as-install/bin/asadmin.bat set --port 5858 --user admin --passwordfile \ as-install/bin/password_file racluster.jms-service.type=REMOTE
Create a JMS host corresponding to the DAS JMS host.
as-install/bin/asadmin.bat create-jms-host --port 5858 --user admin --passwordfile \ as-install/bin/password_file --target racluster --mqhost localhost --mqport 7676 \ --mquser admin --mqpassword admin dashost
Set the default JMS host to be the DAS JMS host created in the previous step.
as-install/bin/asadmin.bat set --port 5858 --user admin --passwordfile \ as-install/bin/password_file racluster.jms-service.default-jms-host=dashost
Go to Configurations->cluster-name-config->Java Message Service->JMS Hosts.
Click New to create a new JMS host; name it dashost.
Enter configuration settings corresponding to the JMS service for the DAS; defaults are as follows:
Admin user: admin
Modify these settings as appropriate for your DAS JMS service.
Navigate back to the Java Message Service tab, and change the JMS service type to REMOTE (default is LOCAL).
Choose dashost from the default-jms-host drop-down list.
Save the changes, and then start your node-agent or cluster.