Skip to main content
This content has been archived and is no longer being updated. Links may not function; however, this content may be relevant to outdated versions of the product.

Managing nodes automatically in a System Management Application cluster

You can now enable Auto Node Discovery instead of using the System Management Application (SMA) to manually manage nodes in a cluster. Auto Node Discovery configures the IP addresses of the nodes in a cluster, automatically adds new nodes, and updates the cluster node list. This process works for both Pega Cloud and on-premises deployments to facilitate cluster node management and tracking.

These instructions are for enabling Auto Node Discovery on an Apache Tomcat server. For other application servers, contact your system administrator for configuring JVM arguments.

Enter the following JVM arguments to enable Auto Node Discovery before starting JVM:

  1. Modify the setenv.bat file, which is in the <TOMCAT_HOME>/bin directory, by setting the following JVM argument to true:


  1. If necessary, you can override the default values for port number, JMX port, user name, and password:






<PRPCPort> is the port number where Pega 7 Platform is running. The default port is 8080.

<JMXport> is the JMX port. The default port is 9004.

<userid> is the user ID for JMX authentication.

<password> is the password for JMX authentication.

An example configuration:

-DSMAAutoNodeDiscoveryPort=xxxx -DSMAAutoNodeDiscoveryJMXPort=xxxx -DSMAAutoNodeDiscoveryUserID=xxxx


  1. To verify that Auto Node Discovery is enabled, open <host>:<port>/prsysmgmt in the SMA browser.
After you configure these settings, the SMA no longer includes the option to add or delete a node. However, if Auto Node Discovery fails, an error message is displayed, and you must manually manage the nodes in the SMA.
Did you find this content helpful?

100% found this useful

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

We'd prefer it if you saw us at our best.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us