Administer > Manage WebSphere Commerce features > WebSphere Commerce integration with WebSphere Portal > Maintain the WebSphere Commerce portlet application

Upgrade an existing WebSphere Commerce component service in MVCPortlet

It can become necessary over time to upgrade the existing WebSphere Commerce component service in the MVCPortlet application.

When updating an existing WebSphere Commerce component service in the MVCPortlet application, be aware of the following components inside of the MVCPortlet application:

1. Runtime libraries

   • Client library JAR

   • Data object JAR

2. Deployment descriptor

   • Component service WSDL

   • Service handler

3. Component service configuration

   • get-data-config.xml

   • SDO.properties

   • wc-component-client.xml

Before you begin

Ensure that you have completed the following tasks when upgrading the Foundation runtime libraries in the MVCPortlet application:

• Setup the WebSphere Portal development environment.

• Update the Foundation runtime libraries:

  1. Right-click the MVCPortlet/WebContent/WEB-INF/lib directory in the Project Explorer.

  2. Select Import > General > File System.

  3. Click Next.

  4. Click Browse and navigate to the wc.modules/workspace/WC directory from the WebSphere Commerce installation.

  5. Select the Foundation runtime library JAR files:

     • Foundation-Core.jar

     • Foundation-DataObjects.jar

     • Foundation-Samples.jar

     • Foundation-Taglib.jar

  6. Click Finish.

• Import the Foundation schema definitions:

  1. Right-click the MVCPortlet/WebContent/WEB-INF directory in the Project Explorer.

  2. Select Import > General > File System.

  3. Click Next.

  4. Click Browse and navigate to the wc.modules/workspace/WebServicesRouter/WebContent directory from the WebSphere Commerce installation.

  5. Select the xsd directory.

  6. Click Finish.

• Verify the JAX-RPC Web service generation settings:

  1. Select Window > Preferences.

  2. Select Web Services.

  3. Select WebSphere.

  4. Select Select JAX-RPC Code Generation.

  5. Select the WSDL2Java tab.

  6. Select Disable data binding and use SOAP element.

  7. Click OK.

  1. Select Window > Preferences.

  2. Select Web Services.

  3. Select Scenario Defaults.

  4. Select Java Proxy for Client Type.

  5. Select Deploy Client in the slider.

  6. Click OK.

  1. Select Window > Preferences.

  2. Select Server Runtime.

  3. Select WebSphere Application Server v7 as the Server.

  4. Select IBM WebSphere JAX-RPC as the Web service runtime.

  5. Click OK.

Procedure

1. Import the component service client library:

   1. Right-click the MVCPortlet/WebContent/WEB-INF/lib directory in the Project Explorer.

   2. Select Import > General > File System.

   3. Click Next.

   4. Click Browse and navigate to the wc.modules/workspace/WC directory of the WebSphere Commerce installation.

   5. Select the component service client library JAR files. For example: Catalog-Client.jar, CatalogData-Objects.jar.

   6. Click Finish.

   7. Click Yes to overwrite the existing version of the JAR file in the workspace.

2. Configure the component service client library:

   1. Expand the MVCPortlet project to MVCPortlet/Java Resources: src/config.

   2. Right-click the directory with the component name, for example, com.ibm.commerce.catalog, and select Import > General > File System.

   3. Click Next.

   4. Click Browse and navigate to the xml/config/component_name directory of the WebSphere Commerce installation, where component_name is the name of the component service. For example: com.ibm.commerce.catalog.

   5. Select the component service SDO.properties client configuration file.

   6. Click Finish.

   7. Click Yes to overwrite the existing version of the file in the workspace.

3. Configure the get-data JSTL tag library:

   1. Expand the MVCPortlet project to MVCPortlet/WebContent/WEB-INF/config.

   2. Right-click the directory with the component name, for example, com.ibm.commerce.catalog, and select Import > General > File System.

   3. Click Next.

   4. Click Browse and navigate to the Stores/WebContent/WEB-INF/config/component_name directory within the workspace, where component_name is the name of the component service. For example: com.ibm.commerce.catalog.

   5. Select the get-data-config.xml configuration files.

   6. Click Finish.

   7. Click Yes to overwrite the existing version of the file in the workspace.

4. Enable the component service in the MVCPortlet application:

   1. Import the component service WSDL:

      1. Right-click MVCPortlet/WebContent/WEB-INF/wsdl.

      2. Select Import > General > File System.

      3. Click Next.

      4. Click Browse and navigate to the wc.modules/workspace/WebServicesRouter/WebContent/component-services/wsdl directory of the WebSphere Commerce installation.

      5. Select a component service WSDL file. For example: CatalogServices.wsdl.

      6. Click Finish.

      7. Click Yes to overwrite the existing version of the file in the workspace.

   2. Generate the JAX-RPC Web service:

      1. Right-click the newly imported WSDL file, for example, CatalogServices.wsdl, in the MVCPortlet/WebContent/WEB-INF/wsdl directory.

      2. Select Web Services.

      3. Select Generate Client and click Finish.

      4. Accept all warnings related to Automatic File Overwriting.

+

Search Tips   |   Advanced Search