removeNodeFromDeploymentEnvDef command

Use the removeNodeFromDeploymentEnvDef command to remove a node from the existing deployment environment definition.

This command to remove a node from the deployment environment will fail if the topology is already configured.

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 from which you are removing the node.
-nodeName nodeName
Specifies the name of the node you are removing.

Optional parameters

-topologyRole role_performed
Specifies the role (such as a particular cluster) from which the node will be removed. If you do not specify a role, the node is removed from all roles in the environment definition.
Valid values are as follows:
  • ADT for a deployment target role
  • Messaging for a host messaging role
  • Support for a supporting services role
  • WebApp for a web application infrastructure
You can indicate one value or more than one value, each separated by a space, for example ADT Messaging Support or Messaging or ADT Support.

Examples

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 removeNodeFromDeploymentEnvDef to remove a node (Node01) from an Application Deployment Target role.
  • Jython example:
    AdminTask.removeNodeFromDeploymentEnvDef('[-topologyName MyDepEnv 
    -topologyRole ADT -nodeName Node01]')
  • Jacl example:
    $AdminTask removeNodeFromDeploymentEnvDef {-topologyName MyDepEnv 
       -topologyRole ADT -nodeName Node01}
The following example uses removeNodeFromDeploymentEnvDef to remove a node (Node01) from a Messaging role.
  • Jython example:
    AdminTask.removeNodeFromDeploymentEnvDef('[-topologyName MyDepEnv 
    -topologyRole Messaging -nodeName Node01]')
  • Jacl example:
    $AdminTask removeNodeFromDeploymentEnvDef {-topologyName MyDepEnv 
       -topologyRole Messaging -nodeName Node01}
The following example uses removeNodeFromDeploymentEnvDef to remove a node (Node01) from a Support role.
  • Jython example:
    AdminTask.removeNodeFromDeploymentEnvDef('[-topologyName MyDepEnv 
    -topologyRole Support -nodeName Node01]')
  • Jacl example:
    $AdminTask removeNodeFromDeploymentEnvDef {-topologyName MyDepEnv 
       -topologyRole Support -nodeName Node01}