Install IWWCM integration for WebSphere Commerce on the WebSphere Commerce system

+

Search Tips   |   Advanced Search

To install IBM Workplace Web Content Management integration for WebSphere Commerce on the WebSphere Commerce system, perform these steps on both the WebSphere Commerce authoring and production servers, unless specified otherwise.

  1. Copy the CommerceAssets.zip file to the WebSphere Commerce system.

  2. Create a backup of the current WebSphere Commerce application by exporting it.

  3. Extract the contents of the CommerceAssets.zip file to WC_installdir. After extracting the files, you should have the following files:

    The WWCM directory is WWCM_60.

  4. Update the partial EAR file.

  5. Stop WebSphere Commerce:

    1. Start the WAS Administration Console

    2. Click Applications > Enterprise Applications to see a list of installed applications.

    3. Select the WebSphere Commerce application, for example WC_demo , and click Stop.

  6. Update the WebSphere Commerce application with the completeAppsforEar.zip partial application file you created when updating the partial EAR file.

    See the Updating applications topic in the WebSphere Application Server Information Center, noting the following information:

    • Follow the instructions to update a partial application.

    • The default name for the WebSphere Commerce application is wc_demo.

  7. Save the changes to the master WAS configuration.

  8. Ensure that WebSphere Commerce is stopped. If WebSphere Commerce is not stopped:

    1. Start the WAS Administration Console

    2. Click Applications > Enterprise Applications to see a list of installed applications.

    3. Select the WebSphere Commerce application, for example WC_demo , and click Stop.

  9. Update the WebSphere Commerce application with the IWWCMIntegrationAssetsData.jar file:

    1. Start the WAS wsadmin tool by entering the following command in a command prompt session:

      WC_profiledir /bin/wsadmin

    2. At the wsadmin prompt, enter the following command:

      $AdminApp update  WC_enterprise_application modulefile 
      {
          -operation addupdate 
          -contents  SRC_PATH 
          -contenturi IWWCMIntegrationAssetsData.jar 
          -nodeployejb 
          -usedefaultbindings 
          -defaultbinding.datasource.jndi " JNDI_NAME" 
          -defaultbinding.cf.jndi " JNDI_NAME" 
          -defaultbinding.cf.resauth Per_Connection_Factory
      }
      

      where the variables in the command are:

      WC_enterprise_application

      WC_instance. For example, given the instance demo, the value of WC_enterprise_application is WC_demo.

      SRC_PATH

      The full path to the IWWCMIntegrationAssetsData.jar file appropriate for the WebSphere Commerce database. Use a forward slash '/' , in the SRC_PATH.

      WC_installdir/refapps/WWCM/wc.ear.ext/db2/IWWCMIntegrationAssetsData.jar

      For Oracle, use... WC_installdir/refapps/WWCM/wc.ear.ext/oracle/IWWCMIntegrationAssetsData.jar

JNDI_NAME

The JNDI name for your WebSphere Commerce database:

where instance is the name of the WebSphere Commerce instance. For example, demo.

You may encounter a warning message after you run the command. Ignore the message and continue with the installation.

  • When the command completes, enter the following command:

    $AdminConfig save

  • When the command completes, enter the following command:

    exit

  • Set Web server aliases to display images from Web Content Management.

  • Restart WebSphere Commerce.

  • Publish the IBM Workplace Web Content Management enabled store... ConsumerDirect-IWWCMEnabled.sar

  • Synchronize your WebSphere Commerce authoring and production servers.

  • (Authoring server only) From an SQL command window:

    1. Change directories to the location of the iwwcm.sql file for the database you are using with WebSphere Commerce:

      • WC_installdir/refapps/WWCM/schema/db2

      • WC_installdir/refapps/WWCM/schema/oracle

    2. Start an SQL session.

    3. Run the iwwcm.sql file by issuing the following command:

  • (Authoring server only) If you have existing workspaces, update the workspace database schemas.

    This update is only required for existing workspaces. Any workspaces you create later do not require this step.

  • (Authoring server only) Update the access control policies for the new business logic that will be added when you install IWWCM integration for WebSphere Commerce.

    1. Use the acpload utility to load the policies defined in the iwwcmacpolicies.xml file provided with IWWCM integration for WebSphere Commerce.

    2. Update the registries: Access Control Policies and Access Control Policy Groups.

  • (Authoring server only) Configure WebSphere Commerce integration with Web Content Management.

  • Publish the authoring server updates to the production server.

    Related concepts

    IWWCM integration for WebSphere Commerce

    Related tasks

    Overview: Integrating WebSphere Commerce and IWWCM

    Related reference

    acpload utility