IBM SG24-6320-00 User Manual

Front cover

Draft Document for Review July 28, 2004 7:33 pm SG24-6320-00

Keeping Commerce ce Applications Updateddated

WebSphere Commerce 5.1 to 5.6 Migration Guide

Migration Strategy and Planning

Production and Development Environments

Step-by-Step Instructions

ibm.com/redbooks

Hernan Cunico

Andrew Hays

Steve Insley Khurram Wyne Nicolai Nielsen

Sanjeev Sharma

Sanjay Shah

Drake Philbrook

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

International Technical Support Organization

Keeping Commerce Applications Updated WebSphere Commerce 5.1 to 5.6 Migration Guide

July 2004

SG24-6320-00

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

Note: Before using this information and the product it supports, read the information in

“Notices” on page xi.

First Edition (July 2004)

This edition applies to Version 5, Release 6, Modification 0 of WebSphere Commerce.

This document created or updated on July 28, 2004.

Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

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

Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi

Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

The team that wrote this redbook. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

Become a published author . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv

Comments welcome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv

Part 1. Introduction to WebSphere Commerce V5.6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Chapter 1. Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

1.2 Structure of the book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Chapter 2. WebSphere Commerce V5.6 Overview . . . . . . . . . . . . . . . . . . . . 7

2.1 Product overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2.2 WebSphere Commerce software components . . . . . . . . . . . . . . . . . . . . . 10

2.2.1 Web server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

2.2.2 WebSphere Application Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

2.2.3 Database Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

2.2.4 WebSphere Commerce Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

2.2.5 WebSphere Commerce Payments Server . . . . . . . . . . . . . . . . . . . . 13

2.2.6 Enablement software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

2.3 WebSphere Commerce Server subsystems . . . . . . . . . . . . . . . . . . . . . . . 15

2.3.1 Member subsystem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

2.3.2 Catalog subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

2.3.3 Trading subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

2.3.4 Order subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

2.3.5 Merchandising subsystem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

2.3.6 Marketing subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

2.3.7 Inventory subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

2.3.8 Messaging subsystem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

2.4 WebSphere Commerce Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

2.5 WebSphere Commerce Business models. . . . . . . . . . . . . . . . . . . . . . . . . 22

2.5.1 Direct Sales. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

2.5.2 Value Chain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

2.5.3 Hosting Ex-Sites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

2.6 What’s new in WebSphere Commerce V5.6 . . . . . . . . . . . . . . . . . . . . . . . 26

2.6.1 WebSphere Commerce Development Environment . . . . . . . . . . . . . 26

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

2.6.2 WebSphere Commerce Payments . . . . . . . . . . . . . . . . . . . . . . . . . . 27

2.6.3 Configuration Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

2.6.4 Loader Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

2.6.5 Password Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

2.6.6 Adaptor for CrossWorld. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

2.6.7 Catalog and product management . . . . . . . . . . . . . . . . . . . . . . . . . . 28

2.6.8 Business Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

2.6.9 Access Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

2.6.10 Collaboration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

2.6.11 Campaigns and Promotions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

2.6.12 Order and inventory Management . . . . . . . . . . . . . . . . . . . . . . . . . 31

2.6.13 Analytics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

2.6.14 Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

2.6.15 Caching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

2.6.16 Product Advisor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Chapter 3. Migration Strategy and Planning. . . . . . . . . . . . . . . . . . . . . . . . 37

3.1 Migration Strategy considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

3.1.1 Add or replace functionality. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

3.1.2 Take advantage of DynaCache. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

3.1.3 Optimization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

3.1.4 External product and user management . . . . . . . . . . . . . . . . . . . . . . 39

3.1.5 How does custom code impact the process? . . . . . . . . . . . . . . . . . . 39

3.1.6 Prepare a detailed Plan. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

3.2 Migration Planning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

3.2.1 Skill requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

3.2.2 Hardware and software prerequisites . . . . . . . . . . . . . . . . . . . . . . . . 41

3.3 Product versions mapping. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

3.4 Migration approach for development environment . . . . . . . . . . . . . . . . . . 44

3.5 Migration approaches for runtime environment. . . . . . . . . . . . . . . . . . . . . 45

3.5.1 Switch-Over migration scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

3.5.2 Co-existence migration scenario. . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

3.5.3 In-place migration scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

3.6 Approach used for this migration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

3.6.1 Detailed overview of development migration steps. . . . . . . . . . . . . . 50

3.6.2 Detailed overview of production environment migration . . . . . . . . . . 51

Chapter 4. Commerce Application used during the migration . . . . . . . . . 55

4.1 Commerce application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

4.1.1 Application environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

4.2 Commerce customization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

4.2.1 Shopping flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

4.2.2 Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

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

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

4.2.3 Database tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

4.3 Catalog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

4.4 Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Part 2. Development environment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Chapter 5. Installing WebSphere Commerce Development Environment 67

5.1 Development environment overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

5.2 Pre-installation requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

5.2.1 VisualAge for Java V4.0 prerequisites . . . . . . . . . . . . . . . . . . . . . . . 69

5.3 Installing WebSphere Studio Application Developer . . . . . . . . . . . . . . . . . 69

5.3.1 Pre-installation steps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

5.3.2 Installing WebSphere Studio Application Developer V5.1.1 . . . . . . . 70

5.3.3 Apply fixes to the test environment . . . . . . . . . . . . . . . . . . . . . . . . . . 71

5.4 Installing WebSphere Commerce V5.6 Toolkit . . . . . . . . . . . . . . . . . . . . . 75

5.4.1 Installing WebSphere Commerce V5.6 Toolkit . . . . . . . . . . . . . . . . . 76

5.5 Installing DB2 Universal Database V8.1 . . . . . . . . . . . . . . . . . . . . . . . . . . 77

5.5.1 Backup development databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

5.5.2 Installation requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

5.5.3 Preparing a Windows user for DB2. . . . . . . . . . . . . . . . . . . . . . . . . . 79

5.5.4 Installing DB2 Universal Database V8.1 . . . . . . . . . . . . . . . . . . . . . . 80

5.5.5 Installing DB2 Universal Database fixpack 5 . . . . . . . . . . . . . . . . . . 83

5.5.6 Migrate databases to DB2 Universal Database V8.1 level . . . . . . . . 85

5.6 Configuring the development environment for DB2 . . . . . . . . . . . . . . . . . 85

5.7 Installing VisualAge for Java V4.0. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

5.7.1 Installing VisualAge for Java V4.0. . . . . . . . . . . . . . . . . . . . . . . . . . . 87

5.7.2 Configuring VisualAge for Java V4.0 . . . . . . . . . . . . . . . . . . . . . . . . 89

Chapter 6. Pre-migration steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

6.1 Preparation overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

6.2 Instance preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

6.2.1 Updating the product information file . . . . . . . . . . . . . . . . . . . . . . . . 97

6.2.2 Prepare resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

6.2.3 Merge EJB groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

6.2.4 Export code from VisualAge for Java V3.5.3 . . . . . . . . . . . . . . . . . 100

6.3 Database preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

6.3.1 Update database configuration values . . . . . . . . . . . . . . . . . . . . . . 102

6.3.2 Unsent messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

6.3.3 Order status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

6.3.4 Catalog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

6.3.5 Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

6.3.6 Custom message types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

6.3.7 Dropping foreign key references . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

6.3.8 Erroneous data in encrypted fields . . . . . . . . . . . . . . . . . . . . . . . . . 109

Contents v

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

Chapter 7. Migrating the development environment . . . . . . . . . . . . . . . . 111

7.1 Current development environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

7.2 Development environment migrated . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

7.3 Migrating the development instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

7.3.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

7.3.2 Running the tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114

7.4 Migrating the development database . . . . . . . . . . . . . . . . . . . . . . . . . . . 116

7.4.1 Migrating unencrypted data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116

7.4.2 Migrating encrypted data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

7.4.3 Summary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

7.5 Migrating custom EJBs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

7.5.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

7.5.2 Export the EJB project from VisualAge for Java V3.5.3 . . . . . . . . . 120

7.5.3 Import the EJB projects into VisualAge for Java V4.0. . . . . . . . . . . 121

7.5.4 Regenerate the deployed code for the EJBs . . . . . . . . . . . . . . . . . 122

7.5.5 Export EJBs as EJB 1.1 JAR files. . . . . . . . . . . . . . . . . . . . . . . . . . 122

7.5.6 Import the EJBs into WebSphere Studio Application Developer. . . 123

Chapter 8. Post-migration steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

8.1 Setting up aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

8.2 Migrating custom code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129

8.2.1 Access control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129

8.2.2 Command parameter validation . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

8.2.3 User registration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

8.2.4 Logon command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

8.2.5 Calculation usage framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

8.2.6 Configuration and code changes for migrated EJBs. . . . . . . . . . . . 144

8.2.7 J2EE Connector Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152

8.2.8 Pricing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153

8.2.9 Product Advisor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

8.2.10 Rule server administration commands . . . . . . . . . . . . . . . . . . . . . 155

8.2.11 JSP and property file changes . . . . . . . . . . . . . . . . . . . . . . . . . . . 155

Part 3. Production environment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

Chapter 9. Installing WebSphere Commerce V5.6 . . . . . . . . . . . . . . . . . . 163

9.1 Single-node runtime overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

9.1.1 Hardware. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

9.1.2 Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

9.2 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165

9.2.1 Install WebSphere Commerce V5.6 . . . . . . . . . . . . . . . . . . . . . . . . 166

9.2.2 Configuring IBM HTTP Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168

9.3 Verifying the installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

9.3.1 Verify installation log files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

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

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

9.3.2 Create test instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

9.3.3 Removing test instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177

Chapter 10. Pre-migration steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183

10.1 Preparation overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184

10.2 Instance preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185

10.2.1 Updating the product information file . . . . . . . . . . . . . . . . . . . . . . 185

10.2.2 Prepare resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188

10.2.3 Disable security on WebSphere Application Server . . . . . . . . . . . 188

10.3 Database preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188

10.3.1 Unsent messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189

10.3.2 Copying the database from Commerce V5.1 to Commerce V5.6 . 190

10.3.3 Updating database configuration values . . . . . . . . . . . . . . . . . . . . 192

10.3.4 Orders status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

10.3.5 Catalog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

10.3.6 Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

10.3.7 Custom message types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199

10.3.8 Dropping foreign key references . . . . . . . . . . . . . . . . . . . . . . . . . . 199

10.3.9 Erroneous data in encrypted fields . . . . . . . . . . . . . . . . . . . . . . . . 200

Chapter 11. Migrating WebSphere Commerce components . . . . . . . . . . 201

11.1 Migration overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202

11.2 Migrating commerce instance configuration . . . . . . . . . . . . . . . . . . . . . 202

11.2.1 Migrating the instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203

11.3 Migrating commerce database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

11.3.1 Migrating the database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208

11.3.2 Choosing the master catalog . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

11.3.3 Migrating the encrypted data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214

11.4 Migrating Payment Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217

11.4.1 Install Fixpack for WebSphere Payment Manager . . . . . . . . . . . . 218

11.4.2 Install WebSphere Commerce Payments remote node . . . . . . . . 219

11.4.3 Package and transfer the WCIM tool . . . . . . . . . . . . . . . . . . . . . . 221

11.4.4 Backup the WebSphere Payment Manager instance . . . . . . . . . . 222

11.4.5 Backup the WebSphere Payment Manager database . . . . . . . . . 223

11.4.6 Transfer assets to WebSphere Commerce Payments node . . . . . 224

11.4.7 Restore WebSphere Payment Manager database . . . . . . . . . . . . 224

11.4.8 Migrate the WebSphere Payment Manager instance . . . . . . . . . . 224

11.4.9 Migrate the WebSphere Payment Manager database . . . . . . . . . 227

Chapter 12. Post-migration steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229

12.1 Post migration steps for IBM HTTP Server . . . . . . . . . . . . . . . . . . . . . . 230

12.1.1 Migrating static content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230

12.1.2 Updating configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230

12.2 Deploying . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231

Contents vii

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

12.2.1 Deploying EJBs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231

12.2.2 Deploying commands and databeans . . . . . . . . . . . . . . . . . . . . . . 233

12.2.3 Deploying store assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234

Part 4. Appendixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237

Appendix A. Managing WebSphere Commerce components . . . . . . . . . 239

WebSphere Commerce instance management . . . . . . . . . . . . . . . . . . . . . . . 240

Checking instance status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240

Starting the instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240

Stopping the instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241

WebSphere Commerce Payments instance management . . . . . . . . . . . . . . 241

Checking instance status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241

Starting the instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242

Stopping the instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242

Start the Configuration Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242

Restarting IBM HTTP Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

Modifying trace strings for a running server . . . . . . . . . . . . . . . . . . . . . . . . . . 244

Tracing with WebSphere Commerce V5.6 Toolkit . . . . . . . . . . . . . . . . . . . . . 247

Tracing for Lightweight WebSphere Test Environment. . . . . . . . . . . . . . . 247

Tracing for Full WebSphere Test Environment . . . . . . . . . . . . . . . . . . . . . 248

Create missing password scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249

Create wcs_password script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249

Create wcs_pmpassword script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249

Appendix B. Backup WebSphere Commerce Suite V5.1 . . . . . . . . . . . . . 251

File system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252

Default directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252

Custom directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252

Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253

Database backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253

Appendix C. Migration scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255

WebSphere Commerce V5.6 migration scripts behavior . . . . . . . . . . . . . . . . 256

migratedb.bat behavior . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256

migrateEncryptedInfo.bat behavior . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257

wcim.bat behavior . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258

Custom database migration scripts behavior . . . . . . . . . . . . . . . . . . . . . . . . . 260

Database preparation batch script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261

Database preparation SQL script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263

Database migration batch script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264

Database post migration batch script . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265

Database post migration SQL script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266

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

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

Appendix D. Moving from single to multi-node environment . . . . . . . . . 267

Single-node environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268

Installing and configuring the database node . . . . . . . . . . . . . . . . . . . . . . . . . 268

Create a Windows user for DB2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268

Installing DB2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269

Moving the database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270

Connecting to the remote database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270

Verify connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271

Appendix E. Additional material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273

Locating the Web material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273

Using the Web material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273

How to use the Web material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274

Abbreviations and acronyms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275

Related publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277

IBM Redbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277

Other publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277

Online resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277

How to get IBM Redbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278

Help from IBM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279

Contents ix

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

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

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

Notices

This information was developed for products and services offered in the U.S.A.

IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to:

IBM Director of Licensing, IBM Corporation, North Castle Drive Armonk, NY 10504-1785 U.S.A.

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES

THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.

COPYRIGHT LICENSE: This information contains sample application programs in source language, which illustrates programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. You may copy, modify, and distribute these sample programs in any form without payment to IBM for the purposes of developing, using, marketing, or distributing application programs conforming to IBM's application programming interfaces.

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

Trademarks

The following terms are trademarks of the International Business Machines Corporation in the United States, other countries, or both:

AFP™ Approach® Cloudscape™ CrossWorlds® DB2 Universal Database™ DB2® Domino®

Eserver®

The following terms are trademarks of other companies:

Intel, Intel Inside (logos), MMX, and Pentium are trademarks of Intel Corporation in the United States, other countries, or both.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.

Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

UNIX is a registered trademark of The Open Group in the United States and other countries.

SET, SET Secure Electronic Transaction, and the SET Logo are trademarks owned by SET Secure Electronic Transaction LLC.

Other company, product, and service names may be trademarks or service marks of others.

eServer™ ibm.com® IBM® Intelligent Miner™ iSeries™ Lotus® Notes® Perform™

QuickPlace® Redbooks ™ Sametime® Tivoli® VisualAge® WebSphere® z/OS®

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

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

Preface

This redbook is based on our experience migrating a customer application. Carrot Bunch Companies, Inc is the customer that provided the application, Chapter 4, “Commerce Application used during the migration” on page 55 covers the details of the application, runtime used, hardware specification and degree of customization.

The team that wrote this redbook

This redbook was produced by a team of specialists from around the world working at the International Technical Support Organization, Raleigh Center.

Figure 0-1 The team who wrote this book. From left to right: Sanjeev Sharma, Hernan Cunico, Andrew Hays, Drake Philbrook, Steve Insley, Sanjay Shah, Nicolai Nielsen and Khurram Wyne.

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

Hernan Cunico is an Senior I/T Specialist, WebSphere Specialist at the IBM

International Technical Support Organization (ITSO), Raleigh Center. He has nine years of experience in Information Technology and e-business consulting. Hernan has written extensively on WebSphere Commerce and Application Server. His areas of expertise include networking, Internet security, e-business and e-commerce solutions architecture.

Andrew Hays is a Senior IT Consultant at Daniel IT Services, Inc., located in Athens, AL. He has over four years of experience in information systems focusing on internet technologies. His areas of expertise include internet site development, web application design & development, systems integration, and WebSphere Commerce solutions. He holds a degree in Computer Science from Athens State University in Athens, AL. Over the last three years he has worked on several WebSphere Commerce Suite V5.1 projects.

Steve Insley is a Senior IT Consultant / Lead Architect for Retail at European Technology Consultants Ltd. in the United Kingdom. He has seven years of experience in the field of application development, system integration and consulting for e-commerce and e-business solutions. He also has four years experience in technical architecture and design. Steve holds a degree in Computer Science from the University of Warwick, England. He has written extensively on WebSphere Commerce and worked on several major WebSphere Commerce customer engagements in the UK.

Khurram Wyne is an I/T Specialist with IBM Global Services Denmark. He has 4 years of experience in application development, systems integration and consulting for J2EE solutions. He holds a Software Engineering degree from Ballerup Technical University in Denmark. His areas of expertise include application design and architecture, systems integration and WebSphere Commerce solutions (including V5.1 and V5.4).

Nicolai Nielsen is an I/T Specialist with IBM Global Services Denmark. He has nine years of experience in the field of consulting, application development and systems integration. Nicolai holds a degree in Engineering from the Technical University of Denmark. Over the last three years, he has worked on several WebSphere Commerce B2C and B2B projects.

Sanjeev Sharma is a team lead of WebSphere Commerce Solutions in IBM Canada’s software development lab in Toronto. He has 5 years of experience in WebSphere Commerce and database administration fields. He holds a Computer Engineering degree from McGill University in Canada. His areas of expertise include solution design, installation, integration and testing. He has written extensively on installation and integration test methodologies.

Sanjay Shah works for IBM Global Services and is an Advisory I/T Specialist for the e-Commerce Solutions practice, which is responsible for defining,

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

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

architecting, developing and implementing Enterprise B2C and B2B e-Commerce solutions. He has over five years experience in Product Integration, Information Technology and e-business consulting. Sanjay is skilled in providing infrastructure support, e-commerce solutions, application development and formal document writing.

Drake Philbrook is the Vice President of WebSphere Commerce Practice for Shared Vision Group. Shared Vision Group is an IBM ISSW Core Business Partner working directly with the IBM Commerce Lab to deliver WebSphere Commerce implementation and enablement. Drake is a Senior Web Architect with over 20 years of software development and technical consulting experience and a focus on Java-based enterprise solutions.

Thanks to the following people/cars for their contributions to this project:

David Yuan, IBM Canada Michael Au, IBM Canada Yanchun Zao, IBM Canada Cherry Cheng, IBM Canada Bing Jiang Sun, IBM China

Become a published author

Join us for a two- to six-week residency program! Help write an IBM Redbook dealing with specific products or solutions, while getting hands-on experience with leading-edge technologies. You'll team with IBM technical professionals, Business Partners and/or customers.

Your efforts will help increase product acceptance and customer satisfaction. As a bonus, you'll develop a network of contacts in IBM development labs, and increase your productivity and marketability.

Find out more about the residency program, browse the residency index, and apply online at:

ibm.com/redbooks/residencies.html

Comments welcome

Your comments are important to us!

We want our Redbooks to be as helpful as possible. Send us your comments about this or other Redbooks in one of the following ways:

Preface xv

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

 Use the online Contact us review redbook form found at:

ibm.com/redbooks

 Send your comments in an Internet note to:

redbook@us.ibm.com

 Mail your comments to:

IBM Corporation, International Technical Support Organization Dept. HZ8 Building 662 P.O. Box 12195 Research Triangle Park, NC 27709-2195

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

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

Part 1

Part 1 Introduction to

WebSphere Commerce V5.6V5.6

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

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

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

Chapter 1. Introduction

This book describes all the necessary steps needed to successfully migrate a WebSphere Commerce Suite V5.1 application to WebSphere Commerce V5.6 on the Microsoft Windows 2000 platform. This book covers both production and development environments.

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

1.1 Overview

Migrating complex applications as WebSphere Commerce always demands a lot of effort and preparation. In this book we used a WebSphere Commerce Suite V5.1 customer application as the starting point, a sample site, for the version-to-version migration scenario.

This book covers all the steps we followed to migrate that application as well as the development environment from WebSphere Commerce Suite V5.1 to WebSphere Commerce V5.6.

Some things were changed from the original customer scenario, some extra customization has been done in order to make that application more generic and to cover more topics during the migration process. The following chapters will provide details about the application as it is today and how is was migrated.

For a real WebSphere Commerce Suite V5.1 customer environment we choose Carrot Bunch Companies, Inc. We will refer to this customer from now on as Carrot Ink. This customer is already a success story implementing WebSphere Commerce Suite V5.1 in 2002, the following URL provides the details of this implementation.

http://www.ibm.com/software/success/cssdb.nsf/CS/CDIR-5GRNK9

Changes done from the original customer environment (just for the purposes of this book) and the differences from the default (out-of-the-box) implementation in terms of WebSphere Commerce customization, Catalog, Database and shopping flow are described in detail in Chapter 4, “Commerce Application used during the migration” on page 55.

1.2 Structure of the book

This book is organized in parts and it is designed to easily identify the general concepts for the migration planning, then proceed with the actual migration procedures for both production and development environments.

Part 1, “Introduction to WebSphere Commerce V5.6”

Part 1 of the book describes how the book is laid out, what is new in WebSphere Commerce V5.6, strategy and planning as well as a description of the customer application we migrated. This part of the book is organized as follows:

 Chapter 1, “Introduction”  Chapter 2, “WebSphere Commerce V5.6 Overview”  Chapter 3, “Migration Strategy and Planning”

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

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

 Chapter 4, “Commerce Application used during the migration”

Part 2, “Development environment”

Part 2 of the book provides all the necessary steps to perform the development environment migration. This part of the book is organized as follows:

 Chapter 5, “Installing WebSphere Commerce Development Environment”  Chapter 6, “Pre-migration steps”  Chapter 7, “Migrating the development environment”  Chapter 8, “Post-migration steps”

Part 3, “Production environment”

Part 3 of the book provides all the necessary steps to perform the production environment migration. This part of the book is organized as follows:

 Chapter 9, “Installing WebSphere Commerce V5.6”  Chapter 10, “Pre-migration steps”  Chapter 11, “Migrating WebSphere Commerce components”  Chapter 12, “Post-migration steps”

Part 4, “Appendixes”

Part 4 of the book provides additional information on managing the different components of the WebSphere Commerce environment and detailed information about the scripts behaviors. This part of the book is organized as follows:

 Appendix A, “Managing WebSphere Commerce components”  Appendix B, “Backup WebSphere Commerce Suite V5.1”  Appendix C, “Migration scripts”  Appendix D, “Moving from single to multi-node environment”  Appendix E, “Additional material”

Chapter 1. Introduction 5

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

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

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

Chapter 2. WebSphere Commerce V5.6

Overview

This chapter provides an overview of WebSphere Commerce V5.6. Sections include an overview of the product, tools used to manage a site or store, and a description of the business and data models.

The chapter is organized into the following sections:

 Product overview  WebSphere Commerce software components  WebSphere Commerce Server subsystems  WebSphere Commerce Tools  WebSphere Commerce Business models  What’s new in WebSphere Commerce V5.6

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

2.1 Product overview

WebSphere Commerce V5.6 provides you with all the functionality that is needed to have a fully functional e-commerce site. It runs on industry leading products like DB2 and WebSphere Application Server. It is designed for security, scalability and performance that any e-commerce site demands. It comes pre-packaged with all the software required to have a fully functional e-commerce site.

In this section we introduce the key components of the WebSphere Commerce runtime architecture. We have categorized the components for the WebSphere Commerce Server as follows (see Figure 2-1 on page 10):

 WebSphere Commerce software components

We have listed the primary software components for WebSphere Commerce.

There are many additional software components included in the IBM

WebSphere Commerce V5.6 product packaging that have not been listed

here but that can be integrated with WebSphere Commerce.

–Web server – WebSphere Application Server – Database Server – WebSphere Commerce Server – WebSphere Commerce Payments Server – Enablement software

 WebSphere Commerce Server subsystems

The subsystems run within the WebSphere Commerce enterprise application

on the WebSphere Commerce Server, and provide the infrastructure to

support the features used by the administration tooling and stores.

– Member subsystem – Catalog subsystem – Trading subsystem – Order subsystem – Merchandising subsystem – Marketing subsystem – Inventory subsystem – Messaging subsystem

 Common server runtime (framework)

The common server runtime provides a framework in which the commerce

applications are deployed and executed.  Business interaction engine

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

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

The subsystems and server runtime operate within an interaction engine that

provides all of the components with the necessary business context. These

are governed by the contextual frameworks such as policies, entitlement,

stores, personalization, and globalization.  Administration tools

The administration tools are used to configure and manage the WebSphere

Commerce site and store operations.

– WebSphere Commerce Configuration Manager – WebSphere Commerce Administration Console – WebSphere Commerce Accelerator – WebSphere Commerce Organization Administration Console – WebSphere Commerce Payments Administration Console. – WebSphere Commerce Password Manager

Chapter 2. WebSphere Commerce V5.6 Overview 9

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

Web Browser Administration Tools

WC Payments Administration Console

Administration

Console

Commerce

Accelerator

Organization

Administration

Console

Development Tools

WebSphere Commerce

Developer

Configuration Tools

Configuration

Manager

(client)

Web Server + WebSphere plug-in

WebSphere Commerce node

WebSphere Application Server

WebSphere Commerce Payments Server

WebSphere Commerce Server

Administration tools

Administration

Console

Business Interaction Engine

Policies EntitlementStores

Personalization

Subsystems

Member

Subsystem

Marketing

Subsystem

Inventory

Subsystem

Configuration Manager Server

Commerce

Accelerator

Common Server Runtime

Trading

Subsystem

Merchandizing

Subsystem

WebSphere Commerce

<instance>.xml

Organization

Administration

Console

Globalization

Catalog

Subsystem

Messaging

Subsystem

Q T P

Order

C S

Database ServerDatabase Server

WebSphere Commerce instance database

WebSphere Commerce Payments database

a i

Transport adapters

Figure 2-1 WebSphere Commerce Server runtime components

2.2 WebSphere Commerce software components

There are many software components included with IBM WebSphere Commerce V5.6. In this section, we will limit our discussion to the following software components of the WebSphere Commerce runtime architecture:

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

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

 Web server  WebSphere Application Server  Database Server  WebSphere Commerce Server  WebSphere Commerce Payments Server

Note: The WebSphere Commerce node architecture depicted in Figure 2-1 on page 10 shows a single-node configuration. The software components listed in this section can be distributed on separate nodes for scalability and security reasons.

2.2.1 Web server

The Web server can be installed on the WebSphere Commerce node or a remote node, which can be optionally clustered for load balancing using the WebSphere Application Server V5, Network Deployment Edition Edge components. Regardless of whether the Web server is local or remote, it must be configured to use the WebSphere Application Server plug-in. There are several supported Web server plug-ins. The IBM HTTP Server and plug-in are found on the WebSphere Application Server CD included with WebSphere Commerce.

The majority of the WebSphere Commerce tooling and store application assets are J2EE components (JSPs, servlets, EJBs, etc.) that run on the application server located on the WebSphere Commerce node. There are some static HTML pages and images found in the WebSphere Commerce tools and stores that can be served by the Web server.

Incoming HTTP requests from Web browser clients are received by the Web server and WebSphere plug-in. The WebSphere plug-in, via the use of the plugin-cfg.xml file, redirects requests to applications on the WebSphere Application Server on the WebSphere Commerce node.

2.2.2 WebSphere Application Server

The WebSphere Commerce Server leverages the J2EE technologies provided by the WebSphere Application Server such as JSPs, servlets (WebSphere Commerce commands), EJBs, XML, Web Services, security, MQ embedded messaging, etc.

IBM WebSphere Commerce V5.6 includes the IBM WebSphere Application Server V5 base edition and Network Deployment Edition. The base edition is suitable for single-node and multi-node runtime configurations. When multiple WebSphere Application Servers are needed for scalability, such as horizontal application clustering, then the Network Deployment Edition is needed.

Chapter 2. WebSphere Commerce V5.6 Overview 11

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

WebSphere Application Server now uses a web based interface which can be accessed at http://<hostname>:9090/admin by default. You must have application server named “server1” running to access this interface.

You will also notice that WebSphere Application Server no longer requires a database or a web server to be installed.

2.2.3 Database Server

DB2 Universal Database V8.1.5 is included with WebSphere Commerce V5.6. In addition, Oracle9i (9.2.0.1) Enterprise Server and Standard Edition are supported (not included). The Database Server is used for the WebSphere Commerce instance database and the WebSphere Commerce Payments database.

The WebSphere Commerce instance database is used for store configuration data such as taxes, shipping, customer profile information, and the product catalog.

The WebSphere Commerce Payments database is used for payment configuration, such as accounts, payment types, cassettes and payment transaction data.

The database server software can be installed on the same node as WebSphere Commerce or on a remote Database Server node.

2.2.4 WebSphere Commerce Server

The WebSphere Commerce Server is a WebSphere enterprise application, which runs on its own application server within the WebSphere Application Server. The WebSphere Commerce application software is installed via the WebSphere Commerce Installer.

After installation, WebSphere Commerce must be configured using the Configuration Manager. The Configuration Manager is used to create the WebSphere Commerce instance. During instance creation, an application server for the WebSphere Commerce Server and the enterprise application is deployed.

For most runtime topologies, the configuration of the WebSphere Application Server is performed for the user via the WebSphere Commerce Configuration Manager. When adding a remote Web server, remote WebSphere Commerce Payments node, and clustering using the WebSphere Application Server Network Deployment Edition, some manual configuration is needed.

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

+ 276 hidden pages