IBM SG24-6320-00 manual Migrating the development instance, Overview

Draft Document for Review July 28, 2004 7:33 pm 6320ch_DEV_migration.fm

7.3 Migrating the development instance

This section details the use of the WCIM tool to perform the instance migration in your development environment. In WebSphere Commerce Suite V5.1, the development environment is reliant on a local run-time instance. Configuration of the WebSphere Test Environment in VisualAge is taken from the configuration files of this instance. During migration of the development environment to WebSphere Studio Application Developer V5.1.1, this configuration must be read and duplicated in the new environment.

7.3.1 Overview

The WCIM tool performs this instance migration in a very similar manner to that of a run-time migration. The following is an overview of its behavior:

The instance.xml file is migrated.

Store front assets are copied from VisualAge into a Web project in WebSphere Studio Application Developer V5.1.1. This includes any JSPs, HTML, CSS files, images etc. that are within the WebSphere Test Environment. The files are copied from the following directory and its subdirectories within the VisualAge installation directory:

<vaj_home>\ide\project_resources\IBM WebSphere Test Environment\hosts\de fault_host\default_app\web

JSPs are updated to conform to the JSP 1.2 specification as is required by the new version of WebSphere Commerce.

Properties files used for national language support are copied from the WebSphere Commerce run-time to the new development environment. The files are copied from the following directory and subdirectories thereof:

<wcs_home>\stores\properties

Custom code is extracted from the JAR file exported from VisualAge and is imported into the WebSphereCommerceServerExtensionsLogic project in WebSphere Studio Application Developer V5.1.1.

Important: Before running the instance migration tool, you must ensure that neither VisualAge for Java nor WebSphere Studio Application Developer V5.1.1 are running.

Also, we recommend that you perform a full system backup of the WebSphere Commerce Suite V5.1 development system before proceeding.

Chapter 7. Migrating the development environment 113