Creating Multiple Nodes with the Same Name

You can create two or more nodes with the same name on a single TIBCO Host instance, where the nodes belong to different environments.

The behavior is equivalent to that in the TIBCO ActiveMatrix 2.x version. When migrating from 2.x, if the node naming convention allowed node names to be duplicated under a single TIBCO Management Daemon, in 3.3.x, enable this configuration option.

Enabling the Functionality

  1. Set the Java property java.property.com.tibco.admin.nodeservice.duplicate.node.name to true in the SystemNode.tra file.
  2. Restart SystemNode.
    Note:
    • If a node is created prior to applying the property, it is not managed by ActiveMatrix Administrator. TIBCO Configuration Tool must be run to create a new enterprise and all nodes created prior to applying the property (except the SystemNode) must be deleted.
    • If a node is created before applying the property, it shows the Not running state while deploying an application in the node distribution dialog box.

    With this functionality, ActiveMatrix Administrator effectively allows duplicate node names in different environments on the same host. However, to distinguish between nodes with the same name within the system, their identifier (name) is made unique by prepending the environment name to the node name. As a result, there are a few noteworthy changes in how the Node names are depicted in the ActiveMatrix Administrator UI, CLI, and log files. For example, if the Node name is TestNode in TestEnvironment, the actual system representation has the name TestEnvironment_TestNode.

Node Name Representation

The following extended name format is used for node names: <EnvironmentName>_<NodeName>.

Note: As the “_” is used as a separator, it is not allowed in the Environment name.

View in the ActiveMatrix Administrator UI

Since the ActiveMatrix Administrator GUI already provides an Environment selector for some of the screens, the Node name is displayed without the prepended Environment name on these screens.

For screens without such selectors, the node name prepended with the environment name is displayed.

Use in the ActiveMatrix Administrator CLI

There is no impact on the Node names required to be provided as input to CLI scripts. However, in the output, the ActiveMatrix Administrator CLI displays Node names using the representation described in Node Name Representation. For example, if the Node name is TestNode in TestEnvironment, the CLI output displays TestEnvironment_TestNode.

System Representation

The directory, representing the node and its associated files, has the Environment name prepended to the Node name. Also, the node processes that are seen in system tools such as Task Manager on Windows or the ps utilities on Linux, all have the extended name format described in Node Name Representation.

Log Files

Entries in log files for node names use the extended name format described in Node Name Representation.

TIBCO Hawk

Node metrics in Hawk use the extended name format described in Node Name Representation.

TIBCO Service Performance Manager

Node metrics in TIBCO Service Performance Manager use the extended name format described in Node Name Representation.