You can export deployment environment definitions using
the wsadmin command. You can use the wsadmin command
to perform the same definition-export task that you perform in the
administrative console. This capability allows you to use a script
to export large numbers of deployment environment definitions from
a deployment manager freeing the administrative console for other
tasks and enables you to replicate working configurations to other
deployment managers.
Before you begin
You must be at the deployment manager from which you are
exporting the 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
You can use the command line to export deployment environment
definitions in the following situations:
- You must export multiple deployment environment definitions and
prefer to use the command line.
- You prefer to use the command line to export one deployment environment
definition.
- You must export a large number of deployment environment definitions;
using wsadmin reduces the time for performing the
task.
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 exportDeploymentEnvDef command
to export the deployment environment definition from the deployment
manager to an output file. The file name is in the form depEnvName.xml
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 exports the deployment environment
myDepEnv on
the host
myDmgr 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 exportDeploymentEnvDef {-filePath c:/dmgr01/DeploymentEnvs
-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.