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

Rename a deployment environment definition using the command line

You can rename a deployment environment definition using wsadmin.sh.

You must be at the dmgr from which you are renaming deployment environment definitions.

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

This task renames a deployment environment definition and uses wsadmin.sh.

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 load using wsadmin.sh than there would be using the administrative console.


Procedure

  1. Open a command window. .

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

  2. At the command prompt, enter wsadmin.sh to enter the wsadmin.sh environment.

  3. Use the renameDeploymentEnvDef command to rename a deployment environment definition.

    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.sh -connType SOAP -host myDmgr -port 8879 -user dmgrAdmin -password -dmgrPass
> $AdminTask renameDeploymentEnvDef {-topologyName myDepEnv 
-oldName TheOldDepEnvName -newName TheNewDepEnvName}

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.

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 don not need to specify -host

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

Administer deployment environments


Related information:
Commands and scripts
renameDeploymentEnvDef command