You can rename a deployment environment definition using
the wsadmin command.
Before you begin
You must be at the deployment manager from which you are
renaming deployment environment definitions.
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 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 topology from another 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 wsadmin environment.
- Use the renameDeploymentEnvDef command
to rename a 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 deployment environment
definition (
TheOldDepEnvName) to the (
TheNewDepEnvName)
with administrative security enabled:
wsadmin -connType SOAP -host myDmgr -port 8879 -user dmgrAdmin -password -dmgrPass
> $AdminTask renameDeploymentEnvDef {-topologyName myDepEnv
-oldName TheOldDepEnvName -newName TheNewDepEnvName}
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.