ANT target: RemoveInstance

RemoveInstance removes the WebSphere Commerce instance configuration completely such as the site data, bootstrap data, schema, application, Web server configuration (IBM HTTP server only), and instance configuration files.

The following sub-targets are run to completely remove the WebSphere Commerce instance.

 

Calls:

• RemoveCommerceServer

• RemoveWorkspaceComponentConfiguration

• RemoveHTTPService

• UnregisterInstance

• RemoveInstanceDir

 

Prerequisites:

The createInstance.properties file must exist for this Ant target to work. For information on generating the properties file, see ANT targets.

 

Required parameters:

instance

The name of the WebSphere Commerce instance with which you are working (for example, demo).

 

Example

• AIX|Linux|Solaris|I5/OS:

  WC_installdir/bin/config_ant.sh -DinstanceName=instance RemoveInstance

• Windows:

  WC_installdir/bin/config_ant.bat -DinstanceName=instance RemoveInstance

 

Recovery:

1. Review the output of the ANT command.

2. Identify which step (ANT target) failed.

3. Resolve the problem.

4. Follow the recovery instructions in the failed target.

5. Execute the rest of the targets.

The following type of error may be encountered when removing the WebSphere Commerce instance using the config_ant.sh script

 WASX7017E: Exception received while running file
 "/QIBM/ProdData/ CommerceServer60/config/deployment/scripts/uninstallEar.jacl";
 exception information: com.ibm.websphere.management.exception.
 ConfigServiceExceptioncom.ibm.websphere.management.exception.
 ConnectorException org.apache.soap.SOAPException:[SOAPException:
 faultCode=SOAP-ENV:Client; msg=READ TIMED UT; targetException= java.net.SocketTime
 outException: READ TIMED OUT]
 WASX7309W: No "save" was performed before the script
 "/QIBM/ProdData /CommerceServer60/Config/deployment/scripts/uninstallEar.jacl"exited;
  configuration changes will not be saved.

If this error is encountered...

1. Open the following file in a text editor: WC_profiledir/properties/soap.client.props

2. Search for the com.ibm.SOAP.requestTimeout entry, and set the value to 6000 (com.ibm.SOAP.requestTimeout=6000).

3. Stop and restart your WAS profile.

4. Follow the recovery instructions in the failed target.

5. Execute the rest of the targets.

• ANT target: RemoveWorkspaceComponentConfiguration
  The RemoveWorkspaceComponentConfiguration target completes two steps to remove the workspace content management configurations from the WebSphere Commerce instance.

Related concepts

ANT targets

Related Reference

ANT target: RemoveCommerceServer

ANT target: RemoveHTTPService

ANT target: UnregisterInstance

ANT target: RemoveInstanceDir