You can delete a deployment environment definition from
a deployment manager using the wsadmin command.
This will not impact any existing servers/clusters that are configured.
Before you begin
The admin client must connect to the deployment manager
from which you are removing the deployment environment definition.
Verify
that deployment environments exist on this deployment manager.
For
recover purposes, consider exporting 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
Delete the deployment environment definition from a deployment
manager when you no longer need the specific definition.
This
task uses wsadmin command to delete a deployment
environment definition on the deployment manager.
You might
want to use the command line to delete deployment environment definitions
when you are making a large number of changes to a deployment environment.
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 deleteDeploymentEnvDef command
to delete the deployment environment definition from the deployment
manager.
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 deletes a deployment environment definition
(
myDepEnv) with administrative security enabled.
Note: If you
are running the admin client from the deployment manager bin folder,
you do not need to include the -host and -port parameters
in the command.
wsadmin -connType SOAP -host myDmgr -port 8879 -user dmgradmin -password dmgrpass
> $AdminTask deleteDeploymentEnvDef {-topologyName myDepEnv }
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 a the command: $AdminConfigSave.