WebSphere Commerce Developer

Migrating the Stores dynamic web project

In WebSphere Commerce Developer Version 7.0, you only need to migrate custom projects.

The migration process involves exporting the following assets as archive files and then importing the archive files:
  • Custom static store assets
  • Custom Java code
  • Custom JSP files

Procedure

  1. To export the Stores dynamic web project from a WebSphere Commerce Developer Version 6.0 development environment workspace:
    1. Open your WebSphere Commerce Developer Version 6.0 development environment workspace and open the J2EE perspective.
    2. Select the project containing your customized code. Right-click the mouse button; then click Export > Zip file.
    3. Click Next.
    4. In the list of resources under Select the resources to export, clear the Stores check box, and select all contents under Stores. Ensure that your project is selected.
    5. Ensure the Create only selected directories option is selected.
    6. Click Browse and choose a path to save the exported archive file.
    7. Ensure Compress the contents of the file is selected.
    8. Click Finish to complete the export.
  2. Update the paths in your compressed archive file for the Stores project. The directory path has changed from:
    • JavaSource
    to
    • src
  3. To export the Stores dynamic web project from WebSphere Commerce Developer Version 5.6.1, or a custom Java project from version 5.6.1 or version 6.0:
    1. Open your WebSphere Commerce Developer development environment workspace and open the J2EE perspective.
    2. Select the project containing your customized code. Right-click the mouse button; then click Export > Jar file.
    3. Click Next.
    4. In the list of resources under Select the resources to export, ensure your project is selected.
    5. Ensure Export generated class files and resources and Export java source files and resources are selected.
    6. Click Browse and choose a path to save the exported archive file.
    7. Ensure Compress the contents of the JAR file is selected.
    8. Click Finish to complete the export.
  4. If you exported custom projects from a WebSphere Application Server Version 5.1 environment, you need to correct the paths in your compressed file. The directory path has changed from:
    • Stores/Web Content/ storename
    to
    • Stores/WebContent/ storename
  5. Importing a custom project:
    1. Open your WebSphere Commerce Developer Version 7.0 development environment workspace and open the Java EE perspective.
    2. Select the corresponding project.
    3. Right-click the target project; then click Import.
    4. Select the type of source to import; then click Next.
    5. Click Browse to find the file you want to import.
    6. If you are asked to overwrite any files, select Yes for each file.
    7. Click Finish.
      Notes:
      1. The class path for each custom project must be updated to resolve the dependencies on libraries and between projects.
      2. Do not import any of the meta data, or your migration will not work. Meta data includes the following files:
        • .compatibility
        • .j2ee
        • .runtime
        • .project
        • .classpath
        • .websettings
        • META-INF/
          • MANIFEST.MF
        • WebContent/WEB-INF
          • base.tld
          • flow.tld
          • struts-bean.tld
          • struts-html.tld
          • struts-logic.tld
          • struts-nested.tld
          • struts-template.tld
          • struts-tiles.tld
          • ibm-web-bnd.xml
          • ibm-web-ext.xml
          • WCEP.tld
          • web.xml
          • struts-config-catalog-services.xml
          • struts-config-contract-services.xml
          • struts-config-GiftCenter.xml
          • struts-config-management-center.xml
          • struts-config-marketing-services.xml
          • struts-config-member-services.xml
          • struts-config-order-services.xml
          • struts-config.xml
          • struts-wc-webservices.xml
        • WebContent/META-INF/
          • MANIFEST.MF
        • WebContent/WEB-INF/lib
          • wcbase.jar
          • coremetrics.jar
        For more information about migrating these files, see Migrating JSP files and store properties files.
      3. If you are migrating from WebSphere Commerce Version 6, after you migrate the Stores project and enable the DOM feature, you must complete the following steps to migrate the store properties files:
        1. Navigate to the following compressed file on your WebSphere Commerce Version 7.0 machine:
          • WCDE_installdir\workspace\WC\InitializationServlet.war\META-INF\MANIFEST.MF
        2. Search for the following line: 
          Order-OrderManagementLogic.jar
          Insert the following line below the line you searched for:
          Order-DOMIntegrationLogic.jar