Install > Installing WebSphere Commerce

Delete a WCS instance

Overview

Deleting a commerce instance does not delete the corresponding WAS profile...

WAS_HOME/profiles/instance

To remove the WAS profile, see the one of the following topics:

• Delete a profile topic I
• Delete a profile topic II
• Delete a profile topic III
• Delete a profile topic IV

Procedure

1. Stop the Web server associated with the instance.

2. From the console, export the commerce enterprise application: WC_instance

   This is optional, to save customizations of, for example, Store Publishing.

3. In federated or cloned environments, start the WAS deployment manager

   For standalone environments, Start the appserver (server1) associated with the instance.

4. As the commerce non-root user, open a command line session.

5. Delete the instance...

   cd WC_INSTALL/bin/
   ./config_ant.sh -DinstanceName=instance RemoveInstance

   The command does the following:

   1. Removes the commerce data source from WAS.
   2. Removes the commerce virtual hosts from WAS.
   3. Removes JAAS authentication data alias for the commerce database.
   4. Removes the commerce JDBC Provider.
   5. Uninstalls the commerce EAR from WAS.
   6. Removes commerce Web server configuration file.
   7. Removes the Windows service.
   8. Deletes the commerce instance directory.
   9. Regenerates the WAS Web server plug-in configuration file.
   10. Removes the commerce instance from Configuration Manager.

6. Drop the commerce database.

   The ANT command RemoveInstance in the step above does not drop the database automatically for you. If you choose to drop the database, refer to the database software documentation for instructions on dropping a database.

   If you do not drop the database, you can reuse the database when you create a new instance by selecting the appropriate options in Configuration Manager wizard.

7. If you have a federated or cloned environment, optionally, use the dmgr console to...
   • Remove cluster members
   • Remove the cluster

8. To delete a commerce instance from a deployment manager cell, remove the commerce node.

9. Web server tasks...

   • IBM HTTP Server

     For a local IHS, no additional steps need to be performed.

     For a remote IHS...

     1. Delete the following directory on the remote IBM HTTP Web Server node:

        WAS_HOME/installedApps/cellname/WC_instance.ear

     2. Copy the Web server plug-in configuration file from the commerce node to the remote Web server node.

     3. Restart the Web server.

     For IBM i, delete the HTTP entry from the QATMHINSTC file located in the QUSRSYS library. The HTTP entry is the name of the commerce instance being deleted.

     
     

   • Microsoft IIS

     1. Remove the following commerce aliases from the IIS configuration:
        • accelerator
        • adminconsole
        • orgadminconsole
        • wcadmin
        • wcorgadmin
        • wcs
        • wcsstore

     2. If the IIS node is remote from the commerce node, delete the following directory on the IIS node:

        WAS_HOME/installedApps/hostname/WC_instance.ear

     3. If the IIS node is remote from the commerce node, copy the WAS Web server plug-in configuration file from the commerce node to the remote Web server node.

     4. Restart the Web server.

     Refer to the Microsoft IIS documentation for instructions.

     
     

   • Sun Java System Web Server 7.0 Update 4

     1. From the Sun Java System Web Server 7.0 Update 4 configuration files (for each commerce port), remove any sections delimited by the following text:

        IBM WebSphere Commerce (Do not edit this section)
        End of IBM WebSphere Commerce (Do not edit this section)

     2. If the Sun Java System Web Server 7.0 Update 4 node is remote from the commerce node, delete the following directory on the Sun Java System Web Server 7.0 Update 4 node:
        WAS_HOME/installedApps/hostname/WC_instance.ear

     3. If the Sun Java System Web Server 7.0 Update 4 node is remote from the commerce node, copy the WAS Web server plug-in configuration file from the commerce node to the remote Web server node. For instructions, refer to Copy the plugin-cfg.xml file to Web server.

     4. Restart the Web server.

10. To delete an authoring server instance...

    1. Delete the Oracle user IDs that start with the...
       • Workspaces Read schema prefix (WCR)
       • Workspace Write schema prefix (WCW)

    2. Remove all Oracle users associated with the authoring instance.

       If these users are not removed, future attempts to create an instance may fail.

    3. For IBM i, to delete the user profile associated with your commerce instance...

       DLTUSRPRF USRPRF(instance) OWNOBJOPT(*DLT)

       All jobs associated with the user profile must be ended before the user profile can be deleted. This will also delete the database for the instance.

       To save the information contained in the database, ensure that you backup the database before performing this step.

    4. To keep the authoring server database, drop all database schemas that start with...
       • Workspace Read schema prefix (WCR)
       • Workspace Write schema (WCW)

    5. If you do not want the authoring server database to remain, drop the database.

11. If you choose to delete the WAS profile, the WAS profile service is not removed from the Services panel.

    To remove the WAS profile service...

    cd WAS_HOME/bin
    WASService.exe -remove WC_instance

    Verify that the WAS profile is stopped.

+

Search Tips   |   Advanced Search