renameNodeInDeploymentEnvDef command

Use the renameNodeInDeploymentEnvDef command to rename a node across all roles in an existing deployment environment definition.

You would typically run this command after importing a topology from another deployment environment.

After using the command, save your changes to the master configuration using one of the following commands:
  • For Jython:
    AdminConfig.save()
  • For Jacl:
    $AdminConfig save

Required parameters

-topologyName name_of_topology
Specifies the name of the deployment environment that contains the node you are renaming.
-oldName name_of_node_to_be_renamed
Indicates the name of the node you are renaming.
-newName new_name_assigned_to_node
Specifies the new name you are assigning to the node.

Optional parameters

None.

Example

Note: The examples are for illustrative purposes only. They include variable values and are not meant to be reused as snippets of code.
The following example uses renameNodeInDeploymentEnvDef to rename a node from (TheOldNodeName) to (MyNewNodeName) in a deployment environment definition (MyDepEnv).
  • Jython example:
    AdminTask.renameNodeInDeploymentEnvDef('-[topologyName MyDepEnv
     -oldName TheOldNodeName -newName TheNewNodeName]')
  • Jacl example:
    $AdminTask renameNodeInDeploymentEnvDef { -topologyName MyDepEnv 
       -oldName TheOldNodeName -newName TheNewNodeName }