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 <WPS>/profiles/<dmgr profile>/bin directory,
or the <WPS>/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.