IBM BPM, V8.0.1, All platforms > Administer the IT infrastructure > Administer deployment environments

Rename nodes in a deployment environment definition using the command line

You can rename nodes in a deployment environment definition using the wsadmin command.

The admin client has to connect to the dmgr from which you are renaming nodes in the deployment environment definition.

When security and role-based authorization are enabled, use a userid and password with administrator or operator authority to perform this task.

This task renames a node in deployment environment definition and uses the wsadmin command.

This command will fail if the deployment environment (topology) is already configured.

You would typically perform this task after importing a deployment environment definition. There is less overhead using the wsadmin command than there would be using the administrative console.

Procedure

1. Open a command window.

   The wsadmin command can be found at either the <WPS>/profiles/<dmgr profile>/bin directory, or the <WPS>/bin directory.

2. At the command prompt, enter the wsadmin command to enter the command environment.

   Make sure wsadmin connects to the correct dmgr, when running in connected mode.

3. Use the renameNodeInDeploymentEnvDef command to rename a node in the deployment environment definition.

   If administrative security is on, you will be prompted for a user ID and password, if you do not supply it in the command.

Example

This example renames a node (TheOldNodeName) to the (TheNewNodeName) for the deployment environment definition (myDepEnv) with administrative security enabled:

wsadmin -connType SOAP -host myDmgr -port 8879 -user dmgrAdmin -password -dmgrPass
> $AdminTask renameNodeInDeploymentEnvDef -topologyName myDepEnv 
-oldName TheOldNodeName -newName TheNewNodeName

The -connType parameter specifies the type of connection to be used; the default argument is SOAP.

As the default is SOAP, you do not need to give explicitly if SOAP is the connection type that is being used.

The -host parameter specifies the host used for the SOAP or RMI connection. The default value for -host is the local host.

If the node is running on the local host, you don not need to specify -host

If you disable administrative security, you do not need to provide a user ID and password.

To save this change to the master configuration issue the command: $AdminConfig Save.

Administer deployment environments

Related information:
Commands and scripts
renameNodeInDeploymentEnvDef command