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
- 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.
- At the command prompt, enter wsadmin.sh to enter the wsadmin.sh environment.
- 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