Node names always take the form nodeName.clusterName, in which you both specify a name for the node and assign it membership in a cluster.
When you run a fragment in StreamBase Studio, Studio assigns each fragment a node and cluster name, following a defined naming pattern.
For EventFlow fragments, Studio's default node name is:
-
project_module_nn, whereprojectis the Studio project's name,moduleis the basename of the primary EventFlow module in the fragment, andnnis an integer sequence number for this fragment, if more than one instance is running.
For LiveView fragments, Studio's default node name is:
-
project_nn, whereprojectis the Studio project's name, andnnis an integer sequence number for this fragment if more than one instance is running.
For both EventFlow and LiveView fragments, Studio's default cluster name is your system login name. This keeps your Studio-launched nodes in a separate cluster from other colleagues using StreamBase in the same subnet.
You can customize these defaults as follows:
-
For any fragment, you can customize the node name to be assigned to the next launch of that fragment using its Run Configuration dialog.
-
You can specify default node and cluster name assignments for all fragment launches in Studio Preferences, in the > panel.
When using the epadmin command to install a node on the command line, you assign a name to the node with the nodename parameter, using the nodename.clusterName format.
Do not re-use any node name currently in use, including any node names assigned by Studio launches. The cluster name is your system login name by default, but can be any string. For example:
epadmin install node nodename=B.sbuser application=...
If not specified, the default node name is hostname.cluster, where hostname is the return value from the hostname command, and where the cluster name is the literal string "cluster".
The application archive being installed can declare one or more node names in the NodeDeploy > nodes > name object of a HOCON configuration file of type c.t.ep.dtm.c.node. In this case, you must use one of the configuration-declared node names when installing that application archive with epadmin.