WebSphere Enterprise Service Bus, Version 6.2.0 Operating Systems: AIX, HP-UX, i5/OS, Linux, Solaris, Windows


Renaming a deployment environment definition using the command line

You can rename a deployment environment definition using the wsadmin command.

Before you begin

You must be at the deployment manager from which you are renaming 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

This task renames a deployment environment definition and uses the wsadmin command.

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 overhead using the wsadmin command than there would be using the administrative console.
Procedure
  1. Open a command window. .

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

  2. At the command prompt, enter the wsadmin command to enter the wsadmin environment.
  3. Use the renameDeploymentEnvDef command to rename a deployment environment definition.
    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 renames a deployment environment definition (TheOldDepEnvName) to the (TheNewDepEnvName) with administrative security enabled:
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.
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.

task Task topic

Terms of use | Feedback


Timestamp icon Last updated: 21 June 2010


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.websphere.wesb620.doc/doc/tadm_renamedepenvcmd.html
Copyright IBM Corporation 2005, 2010. All Rights Reserved.
This information center is powered by Eclipse technology (http://www.eclipse.org).