IBM BPM, V8.0.1, All platforms > Administer the IT infrastructure > Administer deployment environments

Importing deployment environment definitions using the command line

You can import deployment environment definitions using wsadmin.sh. You can use wsadmin.sh to perform the same definition-import task that you perform in the administrative console. This capability allows you to use a script to import many deployment environment definitions to a dmgr freeing the administrative console for other tasks and enables you to replicate working configurations to other dmgrs.

When security and role-based authorization are enabled, use a userid and password with administrator or operator authority to perform this task.

Use the command line to import deployment environment definitions in the following situations:


Procedure

  1. Open a command window.

    The wsadmin command can be found at either the <WPS>/profiles/ dmgr_profile/bin directory, or the <WPS>/bin directory.

    Telnet into UNIX System Services.

  2. Copy the deployment environment definition XML file you are importing to the system.

    Copy the deployment environment definition XML file you are importing to your chosen directory

  3. Enter the wsadmin command to enter the wsadmin environment. Enter the wsadmin.sh command from the WAS_HOME/profiles/ dmgr_profile/bin or the WAS_HOME/bin directory.

  4. Use the importDeploymentEnvDef command to import the deployment environment definition from the file you just copied to the dmgr. You can rename the deployment environment when you import it.

    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 imports the deployment environment myDepEnv and renames it eastDepEnv on the dmgr myDmgr with administrative security enabled.
wsadmin -connType SOAP -host myDmgr -port 8879 -user dmgrAdmin -password -dmgrPass 
> $AdminTask importDeploymentEnvDef {-filePath
c:/dmgr01/importedEnvironments/myDepEnv.xml -topologyName eastDepEnv}

wsadmin.sh -connType SOAP -host myDmgr -port 8879 -user dmgrAdmin -password -dmgrPass 
> $AdminTask importDeploymentEnvDef {-filePath
/dmgr01/importedEnvironments/myDepEnv.xml -topologyName eastDepEnv}

The -connType parameter specifies the type of connection to be used; the default argument is SOAP.

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.

If the node is running on the local host, you do not need to specify -host

If you disable administrative security, you do not need to specify a user ID and password.


What to do next

Optiional: Validate the imported deployment environments.

Administer deployment environments


Related information:
Generate deployment environments using the command line
Manage node agents
importDeploymentEnvDef command