Keeping Commerce Applications Updated: WebSphere Commerce 5.1 to 5.6 Migration Guide

Keeping Commerce Applications Updated: WebSphere Commerce 5.1 to 5.6 Migration Guide

by Hernan Cunico, Andrew Hays, Steve Insley, Nicolai Nielsen, Drake Philbrook, Sanjeev Sharma, Khurram Wyne
Released August 2004
Publisher(s): IBM Redbooks
ISBN: None

Read it now on the O’Reilly learning platform with a 10-day free trial.

O’Reilly members get unlimited access to books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.

Start your free trial

Book description

Migrating complex applications, such as IBM WebSphere Commerce sites, demands a lot of effort and preparation. This IBM Redbooks publication guides you through the process of migrating WebSphere Commerce Suite V5.1 applications. It presents a migration strategy, discusses the planning and migration tools that are involved, and explains the production and development environments.

This book covers migration from VisualAge for Java V3.5.2 and WebSphere Commerce Studio V5.1 to WebSphere Studio Application Developer V5.1.1, which is included in WebSphere Commerce Developer V5.6, on the Microsoft Windows 2000 platform. It uses a WebSphere Commerce Suite V5.1 customer application as the starting point and a sample site for our version-to-version migration scenario.

The chapters in this book reflect details about the application as it is today and how it was migrated. Plus it explains the details of the application, the runtime used, the hardware specification, and the degree of customization.

Please note that the additional material referenced in the text is not available from IBM.

Table of contents

  1. Notices
    1. Trademarks
  2. Preface
    1. The team that wrote this redbook
    2. Become a published author
    3. Comments welcome
  3. Part 1: Migration with WebSphere Commerce V5.6
    1. Chapter 1: An overview of WebSphere Commerce V5.6
      1. Product overview
      2. WebSphere Commerce software components
        1. Web server
        2. WebSphere Application Server
        3. Database server
        4. WebSphere Commerce Server
        5. WebSphere Commerce Payments Server
        6. Enablement software
      3. WebSphere Commerce Server subsystems (1/2)
      4. WebSphere Commerce Server subsystems (2/2)
        1. Member subsystem
        2. Catalog subsystem
        3. Trading subsystem
        4. Order subsystem
        5. Merchandising subsystem
        6. Marketing subsystem
        7. Inventory subsystem
        8. Messaging subsystem
      5. WebSphere Commerce Tools
      6. WebSphere Commerce business models
        1. Direct sales
        2. Value chain
        3. Hosting ex-sites
      7. What’s new in WebSphere Commerce V5.6 (1/2)
      8. What’s new in WebSphere Commerce V5.6 (2/2)
        1. WebSphere Commerce development environment
        2. WebSphere Commerce Payments
        3. Configuration Manager
        4. Loader Package
        5. Password Manager
        6. Adapter for CrossWorlds
        7. Catalog and product management
        8. Business models
        9. Access control
        10. Collaboration
        11. Campaigns and promotions
        12. Order and inventory management
        13. Analytics
        14. Security
        15. Caching
        16. Product Advisor
    2. Chapter 2: Migration strategy and planning
      1. Migration strategy considerations
        1. Adding or replacing functionality
        2. Taking advantage of DynaCache
        3. Optimization
        4. External product and user management
        5. How custom code impacts the process
        6. Preparing a detailed plan
      2. Migration planning
        1. Skill requirements
        2. Hardware and software prerequisites
      3. Product versions mapping
      4. Migration approach for a development environment
      5. Migration approaches for a runtime environment
        1. Switch-over migration scenario
        2. Co-existence migration scenario
        3. In-place migration scenario
      6. Approach used for this migration (1/2)
      7. Approach used for this migration (2/2)
        1. Overview of the development migration
        2. Overview of the production environment migration
    3. Chapter 3: Commerce application used in the migration
      1. Commerce application
        1. Application environment
      2. Commerce customization
        1. Shopping flow
        2. Commands
        3. Database tables
      3. Catalog
      4. Database
  4. Part 2: Development environment
    1. Chapter 4: Installing the WebSphere Commerce V5.6 development environment
      1. Development environment overview
      2. Pre-installation requirements
        1. VisualAge for Java V4.0 prerequisites
      3. WebSphere Studio Application Developer
        1. Pre-installation steps
        2. Installing WebSphere Studio Application Developer V5.1.1
        3. Applying fixes to the test environment
      4. WebSphere Commerce V5.6 Toolkit
        1. Installing the toolkit
        2. Verifying the installation
      5. DB2 Universal Database V8.1 (1/2)
      6. DB2 Universal Database V8.1 (2/2)
        1. Backing up development databases
        2. Installation requirements
        3. Preparing a Windows user for DB2
        4. Installing DB2 Universal Database V8.1
        5. Installing DB2 Universal Database fixpack 5
        6. Migrating databases to DB2 Universal Database V8.1 level
      7. Configuring the development environment for DB2
      8. VisualAge for Java V4.0 (1/2)
      9. VisualAge for Java V4.0 (2/2)
        1. Installing VisualAge for Java V4.0
        2. Configuring VisualAge for Java V4.0
    2. Chapter 5: Pre-migration steps
      1. Preparation overview
      2. Preparing the development instance
        1. Updating the product information file
        2. Preparing resources
        3. Merging EJB groups
        4. Exporting code from VisualAge for Java V3.5.3
      3. Preparing the database (1/2)
      4. Preparing the database (2/2)
        1. Updating the database configuration values
        2. Unsent messages
        3. Order status
        4. Catalog
        5. Members
        6. Custom message types
        7. Dropping foreign key references
        8. Erroneous data in encrypted fields
    3. Chapter 6: Migrating the development environment
      1. Current development environment
      2. Development environment migrated
      3. Migrating the development instance
        1. Overview of the WCIM tool
        2. Running the tool
      4. Migrating the development database
        1. Migrating unencrypted data
        2. Migrating encrypted data
        3. Summary
      5. Migrating custom EJBs
        1. Overview of the migration process
        2. Exporting the EJB project from VisualAge for Java V3.5.3
        3. Importing the EJB projects into VisualAge for Java V4.0
        4. Regenerating the deployed code for the EJBs
        5. Exporting EJBs as EJB 1.1 JAR files
        6. Importing EJBs into WebSphere Studio Application Developer
    4. Chapter 7: Post-migration steps
      1. Setting up aliases
      2. Migrating custom code (1/6)
      3. Migrating custom code (2/6)
      4. Migrating custom code (3/6)
      5. Migrating custom code (4/6)
      6. Migrating custom code (5/6)
      7. Migrating custom code (6/6)
        1. Access control
        2. Command parameter validation
        3. User registration
        4. Logon command
        5. Calculation usage framework
        6. Configuration and code changes for migrated EJBs
        7. J2EE Connector Architecture
        8. Pricing
        9. Product Advisor
        10. Rule server administration commands
        11. JSP and property file changes
  5. Part 3: Production environment
    1. Chapter 8: Installing WebSphere Commerce V5.6
      1. Single-node runtime overview
        1. Hardware
        2. Software
      2. Installing on a single-tier node
        1. Installing WebSphere Commerce V5.6
        2. Configuring IBM HTTP Server
      3. Verifying the installation (1/3)
      4. Verifying the installation (2/3)
      5. Verifying the installation (3/3)
        1. Verifying the installation log files
        2. Creating a test instance
        3. Removing the test instances
    2. Chapter 9: Pre-migration steps
      1. Preparation overview
      2. Preparing the instance
        1. Updating the product information file
        2. Preparing the resources
        3. Disabling security on WebSphere Application Server
      3. Preparing the database (1/3)
      4. Preparing the database (2/3)
      5. Preparing the database (3/3)
        1. Unsent messages
        2. Copying the database from Commerce V5.1 to Commerce V5.6
        3. Updating the database configuration values
        4. Orders status
        5. Catalog
        6. Members
        7. Custom message types
        8. Dropping foreign key references
        9. Erroneous data in encrypted fields
    3. Chapter 10: Migrating WebSphere Commerce components
      1. Migration overview
      2. Migrating the commerce instance configuration
        1. Migrating the instance
      3. Migrating commerce database (1/2)
      4. Migrating commerce database (2/2)
        1. Migrating the database
        2. Choosing the master catalog
        3. Migrating the encrypted data
      5. Migrating Payment Manager (1/3)
      6. Migrating Payment Manager (2/3)
      7. Migrating Payment Manager (3/3)
        1. Installing a fixpack for WebSphere Payment Manager
        2. Installing the WebSphere Commerce Payments remote node
        3. Packaging and transferring the WCIM tool
        4. Backing up the WebSphere Payment Manager instance
        5. Backing up the WebSphere Payment Manager database
        6. Transferring assets to WebSphere Commerce Payments node
        7. Restoring the WebSphere Payment Manager database
        8. Migrating the WebSphere Payment Manager instance
        9. Migrating the WebSphere Payment Manager database
    4. Chapter 11: Post-migration steps
      1. Post migration steps for IBM HTTP Server
        1. Migrating static content
        2. Updating the configuration
      2. Deploying (1/2)
      3. Deploying (2/2)
        1. Deploying EJBs
        2. Deploying commands and databeans
        3. Deploying the store assets
  6. Part 4: Appendixes
    1. Appendix A: Managing WebSphere Commerce components
      1. WebSphere Commerce instance management
      2. Checking the instance status
      3. Starting the instance
      4. Stopping the instance
      5. WebSphere Commerce Payments instance management
      6. Checking the instance status
      7. Starting the instance
      8. Stopping the instance
      9. Starting the Configuration Manager
      10. Restarting IBM HTTP Server
      11. Modifying the trace strings for a running server
      12. Tracing with the WebSphere Commerce V5.6 Toolkit
      13. Tracing for the Lightweight WebSphere Test Environment
      14. Tracing for a Full WebSphere Test Environment
      15. Creating missing password scripts
      16. Creating the wcs_password script
      17. Creating the wcs_pmpassword script
    2. Appendix B: Backing up WebSphere Commerce Suite V5.1
      1. File system
      2. Default directories
      3. Custom directories
      4. Database
      5. Database backup
    3. Appendix C: Migration scripts
      1. WebSphere Commerce V5.6 migration scripts behavior
      2. migratedb.bat behavior
      3. migrateEncryptedInfo.bat behavior
      4. wcim.bat behavior
      5. Custom database migration scripts behavior
      6. Database preparation batch script
      7. Database preparation SQL script
      8. Database migration batch script
      9. Database post migration batch script
      10. Database post migration SQL script
    4. Appendix D: Moving from a single to multi-node environment
      1. Single-node environment
      2. Installing and configuring the database node
      3. Creating a Windows user for DB2
      4. Installing DB2
      5. Moving the database
      6. Connecting to the remote database
      7. Verifying connectivity
    5. Appendix E: Additional material
      1. Locating the Web material
      2. Using the Web material
      3. How to use the Web material
  7. Related publications
    1. IBM Redbooks
    2. Other publications
    3. Online resources
    4. How to get IBM Redbooks
    5. Help from IBM
  8. Index (1/2)
  9. Index (2/2)
  10. Back cover

Product information

  • Title: Keeping Commerce Applications Updated: WebSphere Commerce 5.1 to 5.6 Migration Guide
  • Author(s): Hernan Cunico, Andrew Hays, Steve Insley, Nicolai Nielsen, Drake Philbrook, Sanjeev Sharma, Khurram Wyne
  • Release date: August 2004
  • Publisher(s): IBM Redbooks
  • ISBN: None