Generate Cluster Plugin


Generate Cluster Plugin sample script for Liberty Collectives

Generate Cluster Plugin


In IBM WebSphere Application Server Network Deployment Version 8.5.5, Liberty profile has introduced the Liberty collective feature.
Refer to information about collectives in the WebSphere Application Server Version 8.5.5 Information Center for more specifics.

The sample demonstrates how to call the ClusterManager MBean from a Jython script to generate a cluster plugin configuration for a cluster.

  • The ClusterManager MBean operation used:
    • generateClusterPluginConfig script

The genClusterPlugin sample script demonstrates how to generate the cluster plugin configuration for the given cluster.
A connection is made to the collective controller located at the given host and port, and the request to generate the
cluster plugin configuration for the cluster is passed to the ClusterManager MBean.


Required parameters

First parameter The cluster name.
--truststore The path to the truststore to be used when establishing a connection to the collective controller.
--truststorePassword The password for the truststore specified by the --truststore parameter.
--host The host name where the collective controller is running.
--port The https port where the collective controller is listening.
--user The user name to use when connecting to the collective controller.
--password The password to use when connecting to the collective controller.

Optional parameters

--help Displays help text.
--debug Displays additional details when an error occurs.

Sample use and resulting messages

>> jython defaultCluster

Connecting to the server...
Successfully connected to the server "localhost:9443"
Generated plugin-cfg.xml file: c:/wlp/servers/controller1/pluginConfig/defaultCluster-plugin-cfg.xml
This file will reside in the host file system of the controller.


The following additional sample scripts provide shared code which is used by this sample:

  • Carla Sadtler

    I have tried this process multiple times but always get the following error: java.lang.RuntimeException:
    nectException: Connection refused: connect. I believe I have followed all the instructions, but can’t get past this. I get the same thing using jconsole, so it isn’t the script, but something I have missed in the setup. All Liberty servers are on one Windows 7 system and I don’t belong to a Windows domain. Any ideas?