You can rename nodes in a deployment environment definition
using the wsadmin command.
Before you begin
The admin client has to connect to the deployment manager
from which you are renaming nodes in the deployment environment definition.
Required security role for this task: When security and role-based authorization are enabled,
you must use a userid and password with administrator or operator
authority to perform this task.
About 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
- Open a command window.
The wsadmin command can be found at either the <ESB>/profiles/<dmgr
profile>/bin directory, or the <ESB>/bin directory.
- At the command prompt, enter the wsadmin command
to enter the command environment.
Note: Make sure wsadmin connects
to the correct deployment manager, when running in connected mode.
- Use the renameNodeInDeploymentEnvDef command
to rename a node in the deployment environment definition.
Note: 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.
Note: 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.
Note: If the node
is running on the local host, you don not need to specify -host
Note: 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.