websphere commerce server v6 install guide

WebSphere® Commerce Developer EnterpriseCommerce Developer Professional

Installation Guide

Version 6.0

GC10-4255-06

��

WebSphere® Commerce Developer EnterpriseCommerce Developer Professional

Installation Guide

Version 6.0

GC10-4255-06

��

Note:Before using this information and the product it supports, be sure to read the general information under “Notices” on page55.

Edition Notice

This edition applies to Version 6.0 of the following editions of WebSphere Commerce Developer and to allsubsequent releases and modifications until otherwise indicated in new editions:v IBM WebSphere Commerce Developer Enterprise (product number 5724–i39)

v IBM WebSphere Commerce Developer Professional (product number 5724–i41)

Ensure that you are using the correct edition for the level of the product.

Order publications through your IBM representative or the IBM branch office serving your locality.

IBM welcomes your comments. You can send your comments by using the online IBM WebSphere Commercedocumentation feedback form.

When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in anyway it believes appropriate without incurring any obligation to you.

© Copyright International Business Machines Corporation 1996, 2007.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

https://www14.software.ibm.com/webapp/iwm/web/signup.do?lang=en_US&source=swgmail-rcf&product=wc60

https://www14.software.ibm.com/webapp/iwm/web/signup.do?lang=en_US&source=swgmail-rcf&product=wc60

Contents

Preface . . . . . . . . . . . . . . . vAbout this book . . . . . . . . . . . . . v

Document description . . . . . . . . . . vUpdates to this book . . . . . . . . . . vConventions and terminology used in this book viPath variables . . . . . . . . . . . . viiKnowledge requirements . . . . . . . . . vii

Obtaining WebSphere Commerce software. . . . viii

Part 1. Welcome to WebSphereCommerce Developer . . . . . . . . 1

Products included with WebSphereCommerce Developer . . . . . . . . . 3

Part 2. Planning your WebSphereCommerce Developer installation . . 5

About WebSphere Commerce Developer 7

Migrating previous versions ofWebSphere Commerce Developer . . . 9

Coexistence with previous versions ofWebSphere Commerce Developer . . . 11

Pre-installation requirements . . . . . 13Prerequisite hardware . . . . . . . . . . . 13Prerequisite software . . . . . . . . . . . 13Network configuration requirements . . . . . . 13

Part 3. Installing WebSphereCommerce Developer . . . . . . . 15

Applying fixes to Rational ApplicationDeveloper . . . . . . . . . . . . . 17

Applying fixes to the WebSphereApplication Server Test Environment. . 19

Installing the WebSphere Commercetoolkit . . . . . . . . . . . . . . . 21

Part 4. Configuring WebSphereCommerce Developer . . . . . . . 23

Changing the development database 25Databases supported by the test environment . . . 25

Configuring the development environment to useDB2 Universal Database . . . . . . . . . . 26Configuring the development environment to useDB2 Universal Database for iSeries . . . . . . 30Configuring the development environment to useOracle Database . . . . . . . . . . . . . 32Configuring the development environment to useCloudscape . . . . . . . . . . . . . . 36

Configuring additional WebSphereCommerce software for WebSphereCommerce Developer . . . . . . . . 37WebSphere Commerce business integration . . . . 37

WebSphere MQ . . . . . . . . . . . . 37IBM WebSphere InterChange Server . . . . . 38

Adding IBM Sales Center development environmentto an existing WebSphere Commerce Developer . . 39Installing the IBM Gift Center for WebSphereCommerce . . . . . . . . . . . . . . . 39

Part 5. Uninstalling WebSphereCommerce Developer . . . . . . . 41

Uninstalling the WebSphere Commercetoolkit . . . . . . . . . . . . . . . 43

Uninstalling Rational ApplicationDeveloper . . . . . . . . . . . . . 45

Part 6. Appendixes. . . . . . . . . 47

Appendix A. Troubleshooting yourinstallation . . . . . . . . . . . . . 49Error message in the setup.log . . . . . . . . 49Problems starting the WebSphere Commerce testserver . . . . . . . . . . . . . . . . 49WebSphere Commerce test server does not appearto start . . . . . . . . . . . . . . . . 49The WebSphere Commerce developmentenvironment does not start . . . . . . . . . 49

Appendix B. WebSphere Commercedevelopment environment tasks. . . . 51Starting WebSphere Commerce Developer . . . . 51

Starting multiple instances of WebSphereCommerce Developer . . . . . . . . . . 51Starting IBM Sales Center developmentenvironment for WebSphere Commerce . . . . 51

Starting and stopping WebSphere Commerce . . . 51Starting the WebSphere Commerce informationcenter . . . . . . . . . . . . . . . . 52

© Copyright IBM Corp. 1996, 2007 iii

||

|||

Enabling help access from the WebSphereCommerce tools in the development environment 52

Starting the WebSphere Application ServerAdministrative Console in the WebSphereCommerce development environment . . . . . 52

Notices . . . . . . . . . . . . . . 55

Trademarks. . . . . . . . . . . . . 59

iv WebSphere Commerce Developer Installation Guide

Preface

About this book

Document descriptionThis installation guide describes how to install and configure the followingproducts:v IBM® WebSphere® Commerce Developer Enterprisev IBM WebSphere Commerce Developer Professional

It is intended for developers or system administrators who are using WebSphereCommerce Developer to develop store-front assets and back-office business logic torun with the following products:v WebSphere Commerce Enterprisev WebSphere Commerce Professional

When developing for an edition of WebSphere Commerce, you must use thematching edition of WebSphere Commerce Developer. For example, whendeveloping for WebSphere Commerce Professional, you must use WebSphereCommerce Developer Professional.

Updates to this bookUpdated versions of this book are available as PDF files from the IBM publicationsWeb site.

Update historyThis section provides an outline of the history of changes to this book:

Edition Publicationnumber

Updates

First edition,Fifth Revision

GC10-4255-05 v Updates for WebSphere Commerce fix pack 3.

First edition,FourthRevision

GC10-4255-04 v Added information on obtaining software.

v Updates for WebSphere Commerce fix pack 2.

First edition,Third Revision

GC10-4255-03 v Minor updates to the Installing WebSphere CommerceDeveloper section.

First edition,SecondRevision

GC10-4255-02 v Minor updates.

First edition,First Revision

GC10-4255-01 v Minor updates.

First edition GC10-4255-00 v Original publication of this book.

© Copyright IBM Corp. 1996, 2007 v

http://www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgi?CTY=US&FNC=SRX&PBL=GC104255

http://www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgi?CTY=US&FNC=SRX&PBL=GC104255

Conventions and terminology used in this bookThis book uses the following highlighting conventions:

Boldface type Indicates commands or graphical user interface (GUI) controlssuch as names of fields, icons, or menu choices.

Monospace type Indicates examples of text you enter exactly as shown, file names,and directory paths and names.

Italic type Used to emphasize words. Italics also indicate names for whichyou must substitute the appropriate values for your system.

host_name The fully qualified host name of the WebSphere Commercedevelopment environmentsystem (for example,server1.torolab.ibm.com is fully qualified).

This icon marks a Tip - additional information that can help youcomplete a task.

ImportantThese sections highlight especially important information.

AttentionThese sections highlight information intended to protect your data.

2000Enterprise Indicates information specific to WebSphere Commerce Developer Enterprise

2000Professional Indicates information specific to WebSphere Commerce Developer Professional

Cloudscape Indicates information specific to IBM Cloudscape database.

2000DB2 All references to DB2 Universal Database™ in this book refer to the edition of DB2Universal Database supported by the edition of WebSphere Commerce Developeryou are using.

If you are using WebSphere Commerce Developer Enterprise or Professionedition, DB2 Universal Database Enterprise Server Edition is supported.

2000Oracle Indicates information specific to Oracle9i Database.

Indicates information specific to Oracle10g Database

This book uses the following terms:

back-office business logicThe part of your store that customers do not see. Back-office business logicincludes WebSphere Commerce commands, data beans, enterprise beans

development machineThe machine onto which you install WebSphere Commerce Developer todevelop store-front assets or back-office business logic for WebSphereCommerce.

vi WebSphere Commerce Developer Installation Guide

store-front assetsThe part of your store with which your customers interact. Store-frontassets include HTML pages, JSP files, style sheets, images, graphics, andother multimedia file types that define the layout and content of your Webpages.

Path variablesThis guide uses the following variables to represent directory paths:

WCDE_installdirThis is the installation directory for the WebSphere Commerce toolkit. Thedefault installation directory for the WebSphere Commerce toolkit, dependson your edition of WebSphere Commerce Developer:

2000Enterprise C:\WCToolkitEE60

2000Professional C:\WCToolkitPro60

Important: Long installation paths can cause errors with some WebSphereCommerce additional software. You should use a short directory namesuch as C:\WCToolkit60.

RAD_installdirThis is the installation directory for Rational® Application Developer. Thedefault installation directory for Rational Application Developer isC:\Program Files\IBM\Rational\Application Developer.

Important: This default installation path is too long for configuration withsome WebSphere Commerce additional software. You should use a shortdirectory name such as C:\RAD601.

Knowledge requirementsThis book should be read by developers or system administrators who areinstalling WebSphere Commerce Developer to develop store-front assets andback-office business logic to run with WebSphere Commerce.

Developers or system administrators who are installing and configuringWebSphere Commerce Developer should have knowledge in the following areas:v Knowledge of one of the following operating systems:

– Microsoft® Windows® 2000 Professional Edition– Microsoft Windows 2000 Server Edition– Microsoft Windows 2000 Advanced Server Edition– Microsoft Windows XP Professional

v 2000Enterprise 2000Professional IBM DB2® Universal Database, IBM DB2 Universal Databasefor iSeries®, or Oracle database

v Cloudscape Databasev Basic SQL commands

This knowledge should include how to complete administration and configurationtasks for the operating system and database server.

Preface vii

|||

|||

Obtaining WebSphere Commerce softwareWebSphere Commerce software media is obtained through the IBM PassportAdvantage® Web site. Through this Web site, you can either download mediaimages or order physical media (CDs).

For instruction on obtaining WebSphere Commerce software, refer to DownloadingWebSphere Commerce media images.

viii WebSphere Commerce Developer Installation Guide

|

|||

||

http://publib.boulder.ibm.com/infocenter/wchelp/v6r0m0/index.jsp?topic=/com.ibm.commerce.admin.doc/tasks/tigdownloadpak.htm

http://publib.boulder.ibm.com/infocenter/wchelp/v6r0m0/index.jsp?topic=/com.ibm.commerce.admin.doc/tasks/tigdownloadpak.htm

Part 1. Welcome to WebSphere Commerce Developer

This book describes how to install and configure WebSphere Commerce Developer.It is intended for developers or system administrators who are using theWebSphere Commerce Developer to develop stores and WebSphere Commerceapplication code.

2000Enterprise If you are using WebSphere Commerce Developer Enterprise to createcustomized Java™ code, it can only be deployed to a WebSphere CommerceEnterprise application.

2000Professional If you are using WebSphere Commerce Developer Professional to createcustomized Java code, it can only be deployed to a WebSphere CommerceProfessional application.

For instructions on the installation and configuration of WebSphere Commerce,refer to WebSphere Commerce Installation Guide.

WebSphere Commerce Developer should be installed on a separate machine from aWebSphere Commerce production or staging environment.

© Copyright IBM Corp. 1996, 2007 1

2 WebSphere Commerce Developer Installation Guide

Products included with WebSphere Commerce Developer

The following products and components are packaged with WebSphere CommerceDeveloper:v Rational Application Developer

Note: The WebSphere Commerce Developer package does not contain the fullversion of Rational Application Developer. The only options available are– Rational Application Developer 6.0– WebSphere Application Server 6.0 Integrated Test Environments– Remote Agent

v WebSphere Commerce Version 6.0 toolkitv WebSphere Commerce, Version 6.0

WebSphere Commerce for Windows is included with WebSphere CommerceDeveloper for testing purposes. If you want to put your site into productionusing WebSphere Commerce, you must purchase a licensed copy of WebSphereCommerce.For a list of products and components provided with WebSphere Commerce,refer to WebSphere Commerce Installation Guide.



Part 2. Planning your WebSphere Commerce Developerinstallation

This section contains information on planning your installation of WebSphereCommerce Developer, including the prerequisites for WebSphere CommerceDeveloper.



About WebSphere Commerce Developer

WebSphere Commerce Developer is the combination of Rational ApplicationDeveloper and the WebSphere Commerce toolkit. The WebSphere Commercetoolkit provides a test environment, a workspace, and published starter stores inRational Application Developer. The test environment and workspace arecustomized for WebSphere Commerce development.

If you are developing assets for more than one target application, you might needto configure multiple WebSphere Commerce workspaces. To obtain multipleWebSphere Commerce workspaces, install the WebSphere Commerce toolkitmultiple times.



Migrating previous versions of WebSphere CommerceDeveloper

Migration to WebSphere Commerce Developer, Version 6.0 from the followingversions of WebSphere Commerce Developer is supported:v WebSphere Commerce Developer Version 5.6.1v WebSphere Commerce Developer Version 5.6v WebSphere Commerce Studio Version 5.5

Migration from other versions of WebSphere Commerce Studio is not supported.

For information on how to migrate to WebSphere Commerce Developer, Version6.0 from previous versions of WebSphere Commerce, refer to the WebSphereCommerce Developer Migration Guide.

The Migration Guides are available from the WebSphere Commerce technicallibrary.


http://www.ibm.com/software/webservers/commerce/library/

http://www.ibm.com/software/webservers/commerce/library/


Coexistence with previous versions of WebSphere CommerceDeveloper

WebSphere Commerce Developer, Version 6.0 can coexist on the same machinewith the following previous versions of WebSphere Commerce Developer:v WebSphere Commerce Developer Version 5.6.1v WebSphere Commerce Developer Version 5.6v WebSphere Commerce Studio Version 5.5

Coexistence with other versions of WebSphere Commerce Studio is not supported.

When installing WebSphere Commerce Developer, Version 6.0 in a coexistenceenvironment, no additional steps are required to prepare for or complete aninstallation of WebSphere Commerce. Follow the instructions for installingWebSphere Commerce Developer, Version 6.0 in this book.



Pre-installation requirements

Before installing WebSphere Commerce Developer, ensure that your machine meetsthe following hardware and software prerequisites.

Prerequisite hardwareEnsure that the machine on which you want to install WebSphere CommerceDeveloper meets the requirements listed in the IBM WebSphere CommerceDeveloper Version 6.0 Hardware prerequisites Technote #7007490.

Prerequisite softwareEnsure that the machine on which you want to install WebSphere CommerceDeveloper meets the requirements listed in IBM WebSphere Commerce DeveloperVersion 6.0 Software prerequisites Technote #7007488.

Network configuration requirementsEnsure that the machine on which you want to install WebSphere CommerceDeveloper meets the requirements listed in IBM WebSphere Commerce DeveloperVersion 6.0 Networking prerequisites Technote #7007489.


http://www.ibm.com/support/docview.wss?uid=swg27007490







Part 3. Installing WebSphere Commerce Developer

Installing WebSphere Commerce Developer is a six-step process:Step 1. Ensure that your are logged on as user with Administrator privilegesStep 2. Install Rational Application Developer.

For instructions, refer to the Rational Application Developer 6.0documentation.

Important installation instructionsWhen installing Rational Application Developer 6.0 ensure that youdo the following tasks:v Ensure that you are logged on as a user with Administrator

privileges.v Do not accept the default installation path for Rational Application

Developer 6.0. Specify a short directory name such as C:\RAD601.The default installation path is too long for configuration with theWebSphere Commerce toolkit.Also, avoid using periods (″.″), spaces, or dollar signs (″$″) in thedirectory names.

v When prompted to select the features to install, ensure that youselect WebSphere Application Server 6.0 Integrated TestEnvironments.

v During the installation process you will see options to installsoftware that does not ship with WebSphere Commerce Developer.WebSphere Commerce Developer does not ship a full set ofRational Application Developer CD images. The only options thatare available for installation are:– Rational Application Developer 6.0– WebSphere Application Server 6.0 Integrated Test Environments– Remote Agent

Step 3. Apply IBM Rational Application Developer 6.0.1.1 fixes.For instructions, refer to “Applying fixes to Rational ApplicationDeveloper” on page 17.

Step 4. If you plan to use the WebSphere Commerce development environment,you must apply WebSphere Application Server fixes to the WebSphereApplication Server Test Environment in Rational Application Developer.For instruction, refer to “Applying fixes to the WebSphere ApplicationServer Test Environment” on page 19.

Step 5. If you plan to use the IBM Sales Center development environment, youmust preinstall IBM Sales Center for WebSphere Commerce client. Toinstall the IBM Sales Center client refer to the Installing IBM Sales Centerfor WebSphere Commerce topic in the WebSphere Commerce InformationCenter.

Step 6. Install the WebSphere Commerce toolkit.For instructions, refer to “Installing the WebSphere Commerce toolkit” onpage 21.


|||||

|

|

|

|||||

http://publib.boulder.ibm.com/infocenter/wchelp/v6r0m0/index.jsp?topic=/com.ibm.commerce.telesales.admin.doc/tasks/ttrinstalling.htm


Step 7. Obtain and apply the most recent WebSphere Commerce Developer fixpack.

ImportantEnsure that WebSphere Commerce Developer and WebSphereCommerce are at the same fix pack level. If you apply a fix pack toWebSphere Commerce Developer, apply the same fix pack level toWebSphere Commerce. For example, if you apply WebSphereCommerce Developer fix pack 6.0.1 to WebSphere CommerceDeveloper, you must apply WebSphere Commerce fix pack 6.0.1 toWebSphere Commerce.

WebSphere Commerce Developer fix packs are available fromtheWebSphere Commerce Developer support Web site.Instructions for applying the fix pack are provided with the fix pack at theWebSphere Commerce Developer support Web site.


http://www.ibm.com/software/genservers/commerce/commercestudio/support/

Applying fixes to Rational Application Developer

Update Rational Application Developer to the 6.0.1.1 level. To apply RationalApplication Developer fixes complete the following steps:1. Open the Rational Product Updater by selecting Start > Programs > IBM

Rational > Rational Product Updater.2. Select IBM Rational Application Developer and click Find Updates.3. The updater detects all of the applicable fixes. Click Select All and click Install

Updates.

Note: If you have chosen to install the Remote Agent Controller, ensure thatyou apply the latest fixes that are available for the that component.

4. Accept the license agreement and click Finish.5. Follow the prompts to install all of the updates.

Note: Incremental updates might be required. To apply these updates theRational Product Updater must be run multiple times.



Applying fixes to the WebSphere Application Server TestEnvironment

Prerequisites

v The machine on which you are installing meets all prerequisites outlined in“Pre-installation requirements” on page 13.

v You have installed IBM Rational Application Developer 6.0.1.1 with theWebSphere Application Server Version 6.0 Test Environment on the machine.

v You have stopped any applications running on your machine.v You are logged on as a user with Administrator privileges.

Procedure

To apply WebSphere Application Server fixes to the WebSphere Application ServerVersion 6.0 Test Environment in Rational Application Developer, do the following:1. Depending on the location of your WebSphere Application Server CD image,

complete one of the following:v Insert the WebSphere Application Server CD Disk 2 from the WebSphere

Commerce package provided with WebSphere Commerce Developer, into theCD-ROM drive of the machine where you have Rational ApplicationDeveloper installed.

v Navigate to the location of the WebSphere Application Server CD Disk 2image on the machine where you have Rational Application Developerinstalled.

2. Prepare the update installation wizard as follows:a. Start a command prompt session.b. Do the following in the command prompt session:

1) Change directories to the \WAS\ directory on the CD image.2) Issue the following command:

install.exe

You can close the command prompt session at this point.c. Select the WebSphere Application Server that is used by Rational

Application Developer.d. When prompted by the install wizard, select Apply maintenance and add

features.e. Ensure that the following directory is selected to update:

RAD_installdir/runtimes/base_v6

Click Next.3. When the update installation wizard completes, click Finish.

For the most current list of required maintenance, see the WebSphere CommerceDeveloper required maintenance Technote #1236356.





Installing the WebSphere Commerce toolkit

Prerequisites

v The machine on which you are installing meets all prerequisites outlined in“Pre-installation requirements” on page 13.

v You have installed IBM Rational Application Developer 6.0.1.1 with the IBMWebSphere Application Server, Version 6.0.2.5 Test Environment on the machine.

v You have stopped any applications running on your machine.v Disable any Web server that you have configured on your machine.v You are logged on as a user with Administrator privileges.v If you plan to use the IBM Sales Center development environment, you must

preinstall IBM Sales Center client.

Procedure

To install the WebSphere Commerce toolkit, do the one of the following:v Complete a GUI installation of the WebSphere Commerce toolkit on page 21.v Complete a silent installation of the WebSphere Commerce toolkit on page 22.

Complete a GUI installation of the WebSphere Commerce toolkit

v To complete a GUI installation of the WebSphere Commerce toolkit, complete thefollowing steps:1. Depending on the location of your WebSphere Application Server CD image,

complete one of the following:– Insert WebSphere Commerce Developer CD in the CD-ROM of the

Rational Application Developer machine.The WebSphere Commerce toolkit installation wizard should startautomatically.If the WebSphere Commerce toolkit installation does not startautomatically, run setup.exe on the root of the WebSphere CommerceDeveloper CD.

– Navigate to the location of the WebSphere Commerce Developer CDimage on the machine where you have Rational Application Developerinstalled.From the root directory of the WebSphere Commerce Developer CDimage, run the following command:setup.exe

2. Follow the instructions on the panels and complete your installation.Important: Long installation paths can cause errors with some WebSphereCommerce additional software. You should use a short directory name suchas C:\WCToolkit60.

3. Ensure that the install was successful by doing the following:– Examine the contents of WCDE_installdir/logs/setup.log. If setup.log is

empty or has errors, try running WCDE_installdir/bin/setup.bat from thecommand line.

– If you have installed the IBM Sales Center development environmentcomponent examine the contents of the WCDE_installdir/logs/setupmsc.log for errors.


||

|||

– If errors appear in the log, examine the WCDE_installdir/bin/setenv.batfile. Ensure that the RAD_HOME environment variable points to thecorrect Rational Application Developer installation location, and that theWED_HOME environment variable points to the correct IBM Sales Centerfor WebSphere Commerce location.

– Check that the install was able to properly detect Rational ApplicationDeveloper on your system by ensuring that WCDE_installdir/bin/setenv.bat sets the RAD_HOME environment variable to RAD_installdircorrectly.

Complete a Silent installation of the WebSphere Commerce toolkit

v To complete a silent installation of the WebSphere Commerce toolkit, completethe following steps:1. Depending on the location of your WebSphere Application Server CD image,

complete one of the following:– Insert WebSphere Commerce Developer CD in the CD-ROM of the

Rational Application Developer machine.The WebSphere Commerce toolkit installation wizard should startautomatically. Exit the installation and copy the responsefile.txt of the CDto a temporary directory.Navigate to the location of the WebSphere Commerce Developer responsefile.

– Navigate to the location of the WebSphere Commerce Developer responsefile on the machine where you have Rational Application Developerinstalled.

2. Open the responsefile.txt file in a text editor.3. Modify the entries in the responsefile.txt to match the desired installation

options.4. Run the following command from the location of the CD image to start the

silent installation process:silentsetup.exe -silent -options temp_dir/responsefile.txt

5. Ensure that the install was successful by doing the following:– Examine the contents of WCDE_installdir/logs/wc_toolkit.log. Ensure

that the CWXAI7782S: WebSphere Commerce Developer editioninstallation complete message appears at the end of the wc_toolkit.log.

Note: If wc_toolkit.log is not located in the WCDE_installdir/logsdirectory, the file found can be found in the user temp location. Forexample:C:\Documents and Settings\Administrator\Local Settings\Temp\wc_toolkit.log

– If you have installed the IBM Sales Center development environmentcomponent examine the contents of the WCDE_installdir/logs/setupmsc.log for errors.

– If errors appear in the log, examine the WCDE_installdir/bin/setenv.batfile. Ensure that the RAD_HOME environment variable points to thecorrect Rational Application Developer installation location, and that theWED_HOME environment variable points to the correct IBM Sales Centerfor WebSphere Commerce location.

You now have a fully functioning WebSphere Commerce developmentenvironment installed.


Part 4. Configuring WebSphere Commerce Developer

The chapters in this section describe how to perform any of the optionalconfigurations for WebSphere Commerce Developer beyond the initialconfiguration when you install WebSphere Commerce Developer. Topics covered inthis section include:v “Changing the development database” on page 25v “Configuring additional WebSphere Commerce software for WebSphere

Commerce Developer” on page 37



Changing the development database

The initial configuration of the WebSphere Commerce development environmentuses Cloudscape as the development database. However, you can switch to usingDB2 Universal Database, DB2 Universal Database for iSeries, or Oracle Database asthe development database.

Consider the following guidelines when switching between database types:v If you are developing session beans or custom entity bean finders that have

database-specific SQL statements, you should consider moving to using DB2Universal Database, DB2 Universal Database for iSeries, or Oracle Database, asappropriate. The alternative is to code your session beans and custom finders toexamine the useCloudscape, useDB2, useDB2_400, and useOracle methods of theBaseJDBCHelper class and then generate the database specific SQL statements.

v The effort of maintaining code that will work with Cloudscape and your targetdatabase, must be weighed against the additional setup and configuration effortrequired in setting up development environments that works directly against thetarget database.

ImportantAs you create a new database or switch your database using the setdbtypecommand, keep in mind that the Stores Web project assets can be impactedby this change. The Stores Web project contains a Struts configuration filewhich ties the store_id in the database to the JSP pages of your store. If yourexisting database does not have the same stores with the same store_id it isrecommended that you make a copy of the WCDE_installdir/workspace/Stores directory and save it with a reminder of which database it is assignedto.

If required, restore this directory anytime that you switch the databases. Ifyou are starting from a clean database and would like a clean Stores Webproject, you can run the resetstores command. If this step is omitted, it mightresult in a incorrect Struts configuration file, causing routing errors while younavigate the store pages.

Databases supported by the test environmentFor more information on the databases supported by the WebSphere Commercetest environment, see Databases supported by the test environment Technote#7007559




Configuring the development environment to use DB2 UniversalDatabase

ImportantThe instructions in this section do not apply to using DB2 Universal Databasefor iSeries as the development database.

If you want to configure the development environment to use DB2 UniversalDatabase for iSeries, refer to “Configuring the development environment touse DB2 Universal Database for iSeries” on page 30.

The initial installation of WebSphere Commerce Developer provides a WebSphereCommerce development environment that uses IBM Cloudscape as the WebSphereCommerce database.

You should reconfigure the development environment to use DB2 UniversalDatabase if any of the following statements apply to your development needs:v You are developing enterprise beans that require you to write database specific

SQL.v You are making significant changes to the database schema

You can use either local or remote DB2 Universal Database.

Prerequisites

v You have installed Rational Application Developer with the IBM WebSphereApplication Server, Version 6.0.2.5 Test Environment.

v You have applied the required fixes to Rational Application Developer asdocumented in “Applying fixes to Rational Application Developer” on page 17

v You have applied the required fixes to IBM WebSphere Application Server,Version 6.0.2.5 Test Environment as documented in “Applying fixes to theWebSphere Application Server Test Environment” on page 19.

v 2000Enterprise 2000Professional You have one of the following versions of DB2 UniversalDatabase installed or a local or remote Windows machine:– IBM DB2 Universal Database Enterprise Server Edition Version 8.1.5– IBM DB2 Universal Database Enterprise Server Edition Version 8.2.3Ensure the Application Development Tools component is installed.

v If you are using a remote DB2 Universal Database database server, you haveinstalled the DB2 Universal Database Administration Client on the WebSphereCommerce development environment machine.


v You have the following information gathered about your database server:

Local DB2 Universal Database Remote DB2 Universal Database

v The root directory of DB2 UniversalDatabase

For example, C:\SQLLIB

v The database administrator ID

v The database administrator password

v The database user ID (schema owner ID)

v The database user password

v The root directory of the DB2 UniversalDatabase client

For example, C:\SQLLIB



v The database user ID (schema owner ID)


v The fully qualified host name of thedatabase server

v The port number on the database serverused for remote connections

v The node name of the remote database

Procedure

To configure the development environment to use DB2 Universal Database, do thefollowing:1. Ensure that IBM Rational Application Developer 6.0.1.1 is not running.2. If you are using a remote a WebSphere Commerce, Version 6.0 development

database, complete one of the following steps:v If you are creating a new remote WebSphere Commerce, Version 6.0

development database, the database is catalogued for you automatically.v If you have an existing, remote WebSphere Commerce, Version 6.0

development database that you want to use, do the following on yourWebSphere Commerce Developer machine the first time you switch to theexisting database:a. Catalog the remote database node.b. Catalog the remote database.

For information on how to catalog a remote database node and how tocatalog a remote database, refer to the “Catalog Database command” helpfile in the DB2 Information Center.Once a remote database node and a remote database are cataloged onmachine, they will not have to be cataloged again. You can switch to thecataloged remote database without repeating this step.

3. Start a Windows command prompt session.4. Switch directories to the WCDE_installdir/bin directory.5. Do one of the following steps:

If this is the first time you are configuring the development environment touse DB2 Universal Database and you are not using an existing WebSphereCommerce, Version 6.0 development database:

Issue the following command:setdbtype db2 DB2_HOME dbName dbAdminID dbAdminPassword dbUserIDdbUserPassword [dbHost dbServerPort dbNode] [createdb]

where the command parameters are defined as follows:

Changing the development database 27

http://publib.boulder.ibm.com/infocenter/db2help/index.jsp

DB2_HOMEThe root directory of DB2 Universal Database or the DB2Universal Database client, depending on if you are using a localor remote database.

For example, C:\SQLLIB.

dbNameThe name of the database you want to use with WebSphereCommerce Developer.

If this is the first time you are switching database, this is thename you want to give the database that will be created in thenext step.

dbAdminIDThe database administrator ID.

dbAdminPasswordThe database administrator password.

dbUserIDThe database user ID (schema owner).

dbUserPasswordThe database user password.

dbHost Remote database only The fully qualified host name of thedatabase server.

dbServerPortRemote database only The port number on the database serverused for remote connections. The default port is 50000.

dbNodeRemote database only The node name of the remote database.

This command creates and populates the DB2 Universal Databasedevelopment database and switches the development database to thisnew database.

If you want to switch to an existing, DB2 Universal Database developmentdatabase:

Issue the following command:setdbtype db2 DB2_HOME dbName dbAdminID dbAdminPassword dbUserIDdbUserPassword [dbHost dbServerPort dbNode]


DB2_HOMEThe root directory of DB2 Universal Database or the DB2Universal Database client, depending on if you are using a localor remote database.

For example, C:\SQLLIB.


If this is the first time you are switching database, this is thename you want to give the database that will be created in thenext step.




dbUserIDThe database user ID (schema owner).



dbServerPortRemote database only The port number on the database serverused for remote connections.

dbNodeRemote database only The node name of the remote database.

This command switches the development database to the existingdevelopment database.

6. Restart your WebSphere Commerce server. To restart the WebSphere Commerceserver, refer to “Starting and stopping WebSphere Commerce” on page 51.

7. Run the following commands from your WCDE_home/bin if you want to reset theStores project:resetstores.bat

Note: If you run these commands you will not be able to properly use theexisting stores if you decide to switch back to the Cloudscape database.

The WebSphere Commerce development environment is now configured to useDB2 Universal Database as its database.

All data in the Cloudscape database remains unchanged until you return to usingCloudscape as the development database unless you run the resetdb.bat orresetstores.bat commands. If you run these commands your Cloudscapedatabase is reset and cleaned.

Note: If you run the resetdb.bat command after you have applied a WebSphereCommerce fix pack, you must run the updatedb.bat command to bring thatdatabase back to the appropriate level. For instructions on running theupdatedb.bat command refer to the appropriate WebSphere Commerce fixpack installation guide.

Notes:

1. The DB2 Universal Database development database does not come with allstarter stores published, unless you are connecting to an existing DB2 UniversalDatabase development database. You must run the resetstores.bat file beforepublishing any of the starter stores. You must publish any starter stores youwant to work using the WebSphere Commerce Administration Console. Formore information on publishing starter stores, refer to the WebSphereCommerce Information Center.

2. If you had enabled any WebSphere Commerce features on your previousdatabase, you need to enable the features again. Refer to enabling features.


+++++

++

http://publib.boulder.ibm.com/infocenter/wchelp/v6r0m0/index.jsp?topic=/com.ibm.commerce.admin.doc/tasks/tigfepenable.htm

Configuring the development environment to use DB2 UniversalDatabase for iSeries

The initial installation of WebSphere Commerce Developer provides a WebSphereCommerce development environment that uses IBM Cloudscape as the WebSphereCommerce database.

You should reconfigure the development environment to use DB2 UniversalDatabase for iSeries if any of the following statements apply to your developmentneeds:v You want to run your development database on an iSeries machine.v You are developing enterprise beans that require you to write database specific


DB2 Universal Database for iSeries will be running on a machine remote from yourWebSphere Commerce development environment machine.

Prerequisites


v You have applied the required fixes to Rational Application Developer asdocumented in “Applying fixes to Rational Application Developer” on page 17

v You have applied the required fixes to IBM WebSphere Application Server,Version 6.0.2.5 Test Environment as documented in “Applying fixes to theWebSphere Application Server Test Environment” on page 19.

v Your iSeries machine is running one of the following database managementsystems:– DB2 Universal Database for iSeries V5R3 (provided with i5/OS® V5R3)– DB2 Universal Database for iSeries V5R4 (provided with i5/OS V5R4)

v You have the following information gathered about your database server:– The relational database name in which the WebSphere Commerce

development environment database tables should be created– The database user profile used to access the database– The password for the user profile– The fully qualified host name of the database server

Procedure

To configure the development environment to use DB2 Universal Database foriSeries, do the following:1. Ensure that the iSeries user profile uses the localized settings for a language as

listed in the table below.

Table 1. Localized settings for iSeries user profiles

Language CCSID LangID CountryID

English 37 ENU US

French 297 FRA FR

German 273 DEU DE

Italian 280 ITA IT


Table 1. Localized settings for iSeries user profiles (continued)

Language CCSID LangID CountryID

Spanish 284 ESP ES

Brazilian Portuguese 37 PTB BR

Japanese 5035 JPN JP

Korean 933 KOR KR

Traditional Chinese 937 CHT TW

Simplified Chinese 935 CHS CN

Important: Using localized settings for an iSeries user profile other than thosedefined above might work, but has not been tested.

2. Ensure that Rational Application Developer is not running.3. Start a Windows command prompt session.4. Switch directories to the WCDE_installdir/bin directory.5. Do one of the following steps:

If this is the first time you are configuring the development environment touse DB2 Universal Database for iSeries and you are not using an existingWebSphere Commerce, Version 6.0 development database

Issue the following command:setdbtype iseries dbName dbHost dbUserID dbUserPassword createdb


dbNameThe name of the relational database you want to use withWebSphere Commerce Developer.

dbHost The fully qualified host name of the remote iSeries databaseserver.

dbUserIDThe database user profile used to access the database.

dbUserPasswordThe password for the user profile.

This command creates and populates the DB2 Universal Database foriSeries development database and switches the development databaseto this new database.

If you want to switch to an existing, DB2 Universal Database for iSeriesdevelopment database

Issue the following command:setdbtype iseries dbName dbHost dbUserID dbUserPassword



dbHost The fully qualified host name of the remote iSeries databaseserver.


dbUserIDThe database user profile used to access the database.

dbUserPasswordThe password for the user profile.

This command switches the development database to the existingdevelopment database.


7. Run the following commands from your WCDE_home/bin if you want to reset theStores project:resetstores.bat


The WebSphere Commerce development environment is now configured to useDB2 Universal Database for iSeries as its database.

Notes:

1. The new DB2 Universal Database for iSeries development database does notcome with all starter stores published. You must run the resetstores.bat filebefore publishing any of the starter stores. You must publish any starter storesyou want to work using the WebSphere Commerce Administration Console. Formore information on publishing starter stores, refer to the WebSphereCommerce Information Center.


Configuring the development environment to use Oracle DatabaseThe initial installation of WebSphere Commerce Developer provides a WebSphereCommerce development environment that uses IBM Cloudscape as the WebSphereCommerce database.

You should reconfigure the development environment to use Oracle Database ifany of the following statements apply to your development needs:v You are developing enterprise beans that require you to write database specific


Prerequisites


v If you plan to use the full WebSphere Commerce test environment, you haveapplied the required fixes to Rational Application Developer as documented in“Applying fixes to the WebSphere Application Server Test Environment” onpage 19.

v You have installed the WebSphere Commerce toolkit and have a testenvironment.

v You have installed Oracle Database on a local or remote Windows machine. Thefollowing table lists the components you should install for a local and a remoteWindows machine:


++

http://publib.boulder.ibm.com/infocenter/wchelp/v6r0m0/index.jsp?topic=/com.ibm.commerce.admin.doc/concepts/cpbpublish.htm

http://publib.boulder.ibm.com/infocenter/wchelp/v6r0m0/index.jsp?topic=/com.ibm.commerce.admin.doc/concepts/cpbpublish.htm


Local Oracle Database Remote Oracle Database

v Oracle Database

v Oracle Net Services

v Oracle Net Protocol Support

v SQL*Plus

v Oracle JDBC/OCI Interfaces

Database server machine

v Oracle Database

v Oracle Net Services


WebSphere Commerce Developermachine

v Oracle Enterprise Client

v SQL*Plus

v Oracle JDBC/Thin Interfaces


v Oracle Network Utilities

v Oracle Database Utilities

Ensure that the Oracle client and server areconfigured to communicate correctlyaccording to instructions found in theOracle Database Database documentation.

For instructions on installing these components, refer to your Oracle Databasedocumentation.

v You have created a new Oracle user ID and an empty database. Ensure that thedatabase uses the UTF-8 character set and that the Oracle user ID has access tothe new database.For instructions on creating a database, refer to your Oracle Databasedocumentation.The Oracle user ID must not be a reserved user ID like SYSTEM or SYS.

v You have set the Oracle open_cursors configuration parameter to 1000 or higher.The installation default value of open_cursors is 300. If you do not set theopen_cursors value to 1000 or higher, you might receive error messages.You must restart Oracle after changing the open_cursors value.

v You have gathered the following information about Oracle Database:

Local Oracle Database Remote Oracle Database

v The root directory of Oracle Database

For example, C:\ORACLE\ORA

v The name of the database



v The database user ID


v The root directory of Oracle Databaseclient

For example, C:\ORACLE\ORA

v The name of the remote database

v The name of the local net service for theremote database



v The database user ID


v The fully qualified host name of thedatabase server

v The port number on the database serverused for remote connections

Procedure


To configure the development environment to use Oracle Database, do thefollowing:1. Ensure that Rational Application Developer is not running.2. Start a Windows command prompt session.3. Switch directories to the WCDE_installdir/bin directory.4. Do one of the following steps:

If this is the first time you are configuring the development environment touse Oracle Database and you are not using an existing WebSphereCommerce, Version 6.0 development database

Issue the following command:setdbtype oracle ORACLE_HOME dbName dbAdminID dbAdminPassword dbUserIDdbUserPassword [dbHost dbServerPort] createdb


ORACLE_HOMEThe root directory of Oracle or the database client, dependingon if you have a local or a remote database.

For example, C:\ORACLE\ORA92.

dbNameThe name of the database to use with WebSphere CommerceDeveloper.

If you are using a remote database, this is the name of thedatabase on the remote database server.



dbUserIDThe new Oracle user ID created as part of the prerequisites.

Important: Do not specify a reserved Oracle ID used ID or thiscommand will fail. Examples of reserved Oracle IDsinclude SYSTEM and SYS.




This command connects to your Oracle development database andcreates and populates a WebSphere Commerce schema. It thenconfigures the development environment to use this new schema.

If you want to switch to an existing Oracle development schema

Issue the following command:setdbtype oracle ORACLE_HOME dbName dbAdminID dbAdminPassword dbUserIDdbUserPassword [dbHost dbServerPort]



ORACLE_HOMEThe root directory of Oracle or the database client, dependingon if you have a local or a remote database.

For example, C:\ORACLE\ORA92.

dbNameThe name of the database to use with WebSphere CommerceDeveloper.

If you are using a remote database, this is the name of thedatabase on the remote database server.



dbUserIDThe database user ID.

Important: Do not specify a reserved Oracle ID used ID or thiscommand will fail. Examples of reserved Oracle IDsinclude SYSTEM and SYS.




This command configures the development environment to use theexisting development WebSphere Commerce schema.


6. Run the following command from your WCDE_home/bin if you want to reset theStores project:resetstores.bat


The WebSphere Commerce development environment is now configured to useOracle Database as its database.

All data in the Cloudscape database remains unchanged until you return to usingCloudscape as the development database unless you run the resetdb.bat orresetstores.bat commands. If you run these commands your Cloudscapedatabase is reset and cleaned.

Notes:

1. If you run the resetdb.bat command after you have applied a WebSphereCommerce fix pack, you must run the updatedb.bat command to bring that


++

database back to the appropriate level. For instructions on running theupdatedb.bat command refer to the appropriate WebSphere Commerce fix packinstallation guide.

2. The new Oracle Database development database does not come with all starterstores published. You must run the resetstores.bat file before publishing any ofthe starter stores. You must publish any starter stores you want to work usingthe WebSphere Commerce Administration Console. For more information onpublishing starter stores, refer to the WebSphere Commerce Information Center.


Configuring the development environment to use CloudscapeIf you are using DB2 Universal Database, DB2 Universal Database for iSeries, orOracle Database you can return to using Cloudscape as the development database.

Prerequisites

v The WebSphere Commerce development environment uses DB2 UniversalDatabase, DB2 Universal Database for iSeries, or Oracle Database for thedevelopment database.

Procedure

To configure the development environment to use Cloudscape, do the following:1. Ensure that Rational Application Developer is not running.2. Start a Windows command prompt session.3. Switch directories to the WCDE_installdir/bin directory.4. Issue the following command:

setdbtype cloudscape


The WebSphere Commerce development environment is now configured to useIBM Cloudscape as its database.

All data in the DB2 Universal Database, DB2 Universal Database for iSeries, orOracle Database database remains unchanged until you return to using the DB2Universal Database, DB2 Universal Database for iSeries, or Oracle Databasedatabase as the development database.


+++

++


Configuring additional WebSphere Commerce software forWebSphere Commerce Developer

WebSphere Commerce provides additional software packages that you might wantto use in the WebSphere Commerce test environment. For more information on theadditional software packages provided with WebSphere Commerce, refer totheWebSphere Commerce Additional Software Guide for the edition of WebSphereCommerce you have.

Use the information in this section, along with the WebSphere Commerce AdditionalSoftware Guide for the appropriate edition of WebSphere Commerce, to install andconfigure the additional software packages for use with WebSphere CommerceDeveloper.

In the following sections, refer to the Edition notice to see if the softwarediscussed is supported by your edition of WebSphere Commerce Developer.

WebSphere Commerce business integrationThe business integration software packages, WebSphere MQ and IBM WebSphereInterChange Server, are not provided with either WebSphere Commerce orWebSphere Commerce Developer. They must be purchased separately.

WebSphere MQPrerequisites:

v You have installed the WebSphere Commerce development environment.

Procedure:

To use WebSphere MQ (formerly MQSeries®) with WebSphere CommerceDeveloper, do the following:1. Follow the instructions found in WebSphere Commerce Additional Software Guide

with the following changes:v For WebSphere MQ Version 5.3

– If plan to use Client mode connections to your messaging server, ensurethat you apply the fixes listed on the WebSphere MQ support Web site.

Embedded messaging clientObtain and install the fixes found under WebSphere embeddedmessaging interim fixes for WebSphere Application Server V6.0.

WebSphere MQ clientEnsure that you are at CSD08 or later.

You will need an IBM ID and password to access the fixes. If you do nothave an IBM ID or password, click My IBM registration to obtain an IDand password.

v Launch the administration console from within WebSphere CommerceDeveloper by following the instructions in “Starting the WebSphereApplication Server Administrative Console in the WebSphere Commercedevelopment environment” on page 52 instead of opening the WebSphereApplication Server Administrative Console.


https://www14.software.ibm.com/webapp/iwm/web/reg/pick.do?source=wsmqcsd

v Scope changes to the WebSphere Commerce application server by selectingServer from list of available scopes.You cannot scope any changes to the WebSphere Commerce applicationserver by entering the name of the WebSphere Commerce application serverin the Server field as this field is unavailable when the WebSphereApplication Server Administrative Console runs in the WebSphere Commercetest environment.

v Update the listener for WebSphere MQ server. To update the listener,complete the following steps:a. Open the WebSphere Commerce configuration file in a text editor. For

example:WCDE_installdir/xml/config/wc-server.xml

b. Search for “Listener for WebSphere MQ”.c. Update the Enable field from false to true.d. Save the file and exit.

IBM WebSphere InterChange Server

2000Enterprise

Prerequisites:

v You have installed the WebSphere Commerce development environment.

Procedure:

To use IBM WebSphere InterChange Server (formerly IBM CrossWorlds) withWebSphere Commerce Developer, do the following:v Follow the instructions found in WebSphere Commerce Additional Software Guide

with the following changes:– Replace all occurrences of WC_installdir with WCDE_installdir.– When tasks refer to the WebSphere Commerce machine, use the WebSphere

Commerce Developer machine.– Launch the administration console from within WebSphere Commerce

Developer by following the instructions in “Starting the WebSphereApplication Server Administrative Console in the WebSphere Commercedevelopment environment” on page 52 instead of opening the WebSphereApplication Server Administrative Console.

– Complete the following steps:1. Open the WebSphere Commerce configuration file in a text editor. For

example:WCDE_installdir/xml/config/wc-server.xml

2. Search for CWSAI.3. Complete the fields as described in the WebSphere Commerce Additional

Software Guide.– Scope changes to the WebSphere Commerce application server by selecting

Server from list of available scopes.You cannot scope any changes to the WebSphere Commerce applicationserver by entering the name of the WebSphere Commerce application serverin the Server field as this field is unavailable when the WebSphereApplication Server Administrative Console runs in the WebSphere Commercetest environment.


Adding IBM Sales Center development environment to an existingWebSphere Commerce Developer

If you plan to add the IBM Sales Center development environment to an existingcopy of WebSphere Commerce Developer, complete the following steps:1. You must preinstall IBM Sales Center for WebSphere Commerce. For more

information refer to:

Installing IBM Sales Center for WebSphere Commerce2. Run the WebSphere Commerce Developer installation wizard, and select to

install the IBM Sales Center development environment as described in“Installing the WebSphere Commerce toolkit” on page 21.

3. Open the following file in a text editor:WCDE_installdir/bin/setenv.bat

4. Ensure that the RAD_HOME environment variable points to the correctRational Application Developer installation location

5. Ensure that the WED_HOME environment variable points to the correct IBMSales Center for WebSphere Commerce location.

6. Save the file and exit.

For information on launching the IBM Sales Center development environment,refer to the Launching the IBM Sales Center development environment topic in theWebSphere Commerce Information Center.

Installing the IBM Gift Center for WebSphere Commerce

Edition noticeThe IBM Gift Center for WebSphere Commerce is supported by WebSphereCommerce Developer Enterprise, and WebSphere Commerce DeveloperProfessional.

For instructions on how to enable the IBM Gift Center for WebSphere Commerceon your WebSphere Commerce Developer Enterprise system, refer to the WebSphereCommerce Additional Software Guide.

Configuring additional WebSphere Commerce software for WebSphere Commerce Developer 39

|

|

||

|

|||


http://publib.boulder.ibm.com/infocenter/wchelp/v6r0m0/index.jsp?topic=/com.ibm.commerce.telesales.developer.doc/tasks/ttrdevlaunch.htm


Part 5. Uninstalling WebSphere Commerce Developer



Uninstalling the WebSphere Commerce toolkit

Note:

Uninstallation of specific components of the WebSphere Commerce toolkit is notsupported. The WebSphere Commerce toolkit uninstall will remove everything thatis installed under the WebSphere Commerce toolkit installation directory. Touninstall the WebSphere Commerce toolkit, do the following:1. Stop the WebSphere Commerce server. For instructions on stopping the

WebSphere Commerce server, refer to “Starting and stopping WebSphereCommerce” on page 51.

2. Select Start > Settings > Control Panel > Add/Remove Programs

3. Click Change or Remove Programs.4. Select one of the following, depending on the edition you have installed:

2000Enterprise IBM WebSphere Commerce Developer Enterprise 6.0

2000Professional IBM WebSphere Commerce Developer Professional 6.0

5. Click Remove.The uninstall wizard starts.

6. Complete the uninstall wizard by following the prompts.

The uninstall will only remove files that were originally installed. Files that werecreated or modified after the installation will not be removed. You must delete theWCDE_installdir directory once you have determined that you do not need any ofthe remaining files.

Uninstalling multiple toolkit installationsWhen you have multiple WebSphere Commerce toolkit installations on thesame machine, the entry in the Windows Add/Remove Programs panel onlyuninstalls the most recent WebSphere Commerce toolkit installation.

To uninstall a specific WebSphere Commerce toolkit installation, you mustissue the following command:WCDE_installdir/_uninst/uninstall

WCDE_installdir will be unique for each installation of the WebSphereCommerce toolkit on a machine.



Uninstalling Rational Application Developer

Before uninstalling Rational Application Developer, uninstall the WebSphereCommerce toolkit by following the instructions in “Uninstalling the WebSphereCommerce toolkit” on page 43.

To uninstall Rational Application Developer, complete the following steps:1. While logged on with a Windows user ID with Administrator authority, select

Start > Settings > Control Panel > Add/Remove Programs.2. Click Change or Remove Programs, select Rational Application Developer

and click Change/Remove.The uninstall wizard starts.

3. Complete the uninstall wizard by following the prompts.4. When the uninstall is complete, restart your machine.5. Delete the following directories:v RAD_installdir

where the default value for RAD_installdir is listed in “Path variables” on pagevii.



Part 6. Appendixes



Appendix A. Troubleshooting your installation

Use the information in this section to troubleshoot your installation of WebSphereCommerce Developer

Error message in the setup.logAfter the installation has completed, an error appears in the setup.log. Forexample:[addApplication] Application successfully added to the server, attempting tostop the server.

This error occurs when the installer has detect that the “publish application”process has taken too much time. This might not be an error. In order to verify ifthis is actually an error, you will need to examine the ″trace.log″ file in theWCDE_installdir/wasprofile/logs/server1 directory. If this file does not containerrors then this situation might be corrected by manually publishing theapplication through the Rational Application Developer. If there are errors in thetrace.log file, then they must first be addressed before a publish can occur.

Problems starting the WebSphere Commerce test serverWhen starting the WebSphere Commerce test server, the console output does notappear.

This is normal Rational Application Developer behavior. Rational ApplicationDeveloper does not log any messages on the console until after the server hascompleted initialization. To follow the startup progress of the test server, examinethe WCDE_installdir/wasprofile/logs/server1/trace.log file.

WebSphere Commerce test server does not appear to startThe WebSphere Commerce Test Server displays a status of ″starting...″ even thoughthe WCDE_installdir/wasprofile/logs/server1/trace.log file stated that theserver has started properly.

There are some instances where the network configuration of a machine causessome problems in the RMI communication between Rational ApplicationDeveloper and WebSphere Application Server. When this happens, RationalApplication Developer might not be able to retrieve the proper status from theWebSphere Application Server test server. In order to fix this problem, you shouldchange the communication protocol between the products from RMI to SOAP. Thiscan be done in the WebSphere Commerce Test Server configuration editor.

The WebSphere Commerce development environment does not startIf the WebSphere Commerce development environment does not start, ensure thatyou have Rational Application Developer installed and that the RAD_HOME variablein the setenv.bat file is set to the full path to the Rational Application Developer.

To correct the value for RAD_HOME, do the following:1. Open the following the file in a text editor:


WCDE_installdir/bin/setenv.bat

2. Locate the line containing RAD_HOME and ensure that it points to the full path ofthe Rational Application Developer (RAD_installdir).

3. Save any changes and exit the text editor


Appendix B. WebSphere Commerce development environmenttasks

Starting WebSphere Commerce DeveloperTo start the WebSphere Commerce development environment, do one of thefollowing, depending on your edition of WebSphere Commerce Developer:

2000Enterprise Select Start > Programs > IBM WebSphere Commerce Developer Enterprise 6.0> WebSphere Commerce development environment

2000Professional Select Start > Programs > IBM WebSphere Commerce Developer Professional6.0 > WebSphere Commerce development environment

Starting multiple instances of WebSphere CommerceDeveloper

If you have the WebSphere Commerce toolkit installed multiple times, the entry inthe Windows Start menu starts the most recent installation of the WebSphereCommerce toolkit.

To start other installations of the WebSphere Commerce toolkit, issue the followingcommand:WCDE_installdir/bin/startWCToolkit

WCDE_installdir will be unique for each installation of the WebSphere Commercetoolkit on a machine.

Starting IBM Sales Center development environment forWebSphere Commerce

To start the IBM Sales Center development environment, do one of the following:v To start the IBM Sales Center development environment, do one of the

following, depending on your edition of WebSphere Commerce Developer

2000Enterprise Select Start > Programs > IBM WebSphere Commerce Developer Enterprise6.0 > IBM Sales Center development environment

2000Professional Select Start > Programs > IBM WebSphere Commerce Developer Professional6.0 > IBM Sales Center development environment

v Run the following command from a command line:WCDE_installdir/bin/startMSCToolkit.bat

Starting and stopping WebSphere CommercePrerequisites

v The WebSphere Commerce development environment is running.For instructions on starting the WebSphere Commerce developmentenvironment, refer to “Starting WebSphere Commerce Developer.”

Procedure


To start WebSphere Commerce within the WebSphere Commerce developmentenvironment, do the following:v In the Servers view, right-click one of the following, depending on the test

environment you want to start:– WebSphere Commerce Test Server

v Select Start or Stop from the pop-up menu.v The WebSphere Commerce is started successfully if there are no errors in the

Console view and the following message appears in the Console view:Server server1 open for e-business

Before accessing any of the WebSphere Commerce tools, ensure that you start theWebSphere Commerce help system by following the instructions in “Starting theWebSphere Commerce information center.”

Starting the WebSphere Commerce information centerThe help system starts automatically in the development environment. By defaultRational Application Developer runs the Help Server on a random port.

To start the help system in the WebSphere Commerce development environment,do the following:1. Ensure that the WebSphere Commerce tools in the development environment

can access the help system.For instruction on enabling help access from the WebSphere Commerce tools inthe development environment, refer to “Enabling help access from theWebSphere Commerce tools in the development environment.”

2. Start the WebSphere Commerce development environment.For instructions on starting the WebSphere Commerce developmentenvironment, refer to “Starting WebSphere Commerce Developer” on page 51.

3. Start the help system by selecting Help > Help Contents in the WebSphereCommerce development environment.

Enabling help access from the WebSphere Commerce tools inthe development environment

To enable help to be accessed from the WebSphere Commerce Accelerator,Organization Administration Console, or the Administration Console, you must setthe port that the help server uses to 8001, by doing the following:1. Select Window > Preferences > Help > Help Server.2. In the Port for the server to listen on field, type 8001.3. Click Apply.4. Restart Rational Application Developer.5. Start the help system by selecting Help > Help Contents in the WebSphere

Commerce development environment.

Starting the WebSphere Application Server Administrative Console inthe WebSphere Commerce development environment

Prerequisites

v The WebSphere Commerce development environment is running.


For instructions on starting the WebSphere Commerce developmentenvironment, refer to “Starting WebSphere Commerce Developer” on page 51.

v The test environment is available.

Procedure

To start the WebSphere Application Server Administrative Console in theWebSphere Commerce development environment, do the following:1. Start the WebSphere Commerce Test Server. Refer to “Starting and stopping

WebSphere Commerce” on page 51.2. In the Servers view, right-click on WebSphere Commerce Test Server and select

Run Administrative console.

The WebSphere Application Server Administrative Console will appear in theAdmin Console view.

Appendix B. WebSphere Commerce development environment tasks 53


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 inother countries. Consult your local IBM representative for information on theproducts and services currently available in your area. Any reference to an IBMproduct, program, or service is not intended to state or imply that only that IBMproduct, program, or service may be used. Any functionally equivalent product,program, or service that does not infringe any IBM intellectual property right maybe used instead. However, it is the user’s responsibility to evaluate and verify theoperation of any non-IBM product, program, or service.

Any reference to an IBM licensed program in this publication is not intended tostate or imply that only IBM’s licensed program may be used. Any functionallyequivalent product, program, or service that does not infringe any of IBM’sintellectual property rights may be used instead of the IBM product, program, orservice. Evaluation and verification of operation in conjunction with otherproducts, except those expressly designated by IBM, is the user’s responsibility.

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

IBM Director of LicensingIBM CorporationNorth Castle DriveArmonk, NY 10504–1785U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBMIntellectual Property Department in your country or send inquiries, in writing, to:

IBM World Trade Asia CorporationLicensing2-31 Roppongi 3-chome, Minato-kuTokyo 106, Japan

The following paragraph does not apply to the United Kingdom or any othercountry where such provisions are inconsistent with local law:

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THISPUBLICATION ″AS IS″ WITHOUT WARRANTY OF ANY KIND, EITHEREXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESSFOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express orimplied warranties in certain transactions, therefore, this statement may not applyto 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 improvementsand/or changes in the product(s) and/or the program(s) described in thispublication at any time without notice.

Any references in this information to non-IBM Web sites are provided forconvenience only and do not in any manner serve as an endorsement of those Websites. The materials at those Web sites are not part of the materials for this IBMproduct 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 itbelieves appropriate without incurring any obligation to you.

Licensees of this program who want to have information about it for the purposeof enabling: (i) the exchange of information between independently createdprograms and other programs (including this one) and (ii) the mutual use of theinformation which has been exchanged, should contact:

IBM Canada Ltd.Office of the Lab Director8200 Warden AvenueMarkham, OntarioL6G 1C7Canada

Such information may be available, subject to appropriate terms and conditions,including in some cases payment of a fee.

The licensed program described in this document and all licensed materialavailable for it are provided by IBM under terms of the IBM Customer Agreement,IBM International Program License Agreement or any equivalent agreementbetween us.

Any performance data contained herein was determined in a controlledenvironment. Therefore, the results obtained in other operating environments mayvary significantly. Some measurements may have been made on development-levelsystems and there is no guarantee that these measurements will be the same ongenerally available systems. Furthermore, some measurement may have beenestimated through extrapolation. Actual results may vary. Users of this documentshould verify the applicable data for their specific environment.

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

All statements regarding IBM’s future direction or intent are subject to change orwithdrawal without notice, and represent goals and objectives only.

This information is for planning purposes only. The information herein is subject tochange before the products described become available.

This information contains examples of data and reports used in daily businessoperations. To illustrate them as completely as possible, the examples include the


names of individuals, companies, brands, and products. All of these names arefictitious and any similarity to the names and addresses used by an actual businessenterprise is entirely coincidental.

Credit card images, trademarks and trade names provided in this product shouldbe used only by merchants authorized by the credit card mark’s owner to acceptpayment via that credit card.

Notices 57


Trademarks

The IBM logo and the following terms are trademarks or registered trademarks ofInternational Business Machines Corporation in the United States or othercountries or both:v Cloudscapev CrossWorldsv DB2v DB2 Universal Databasev i5/OSv IBMv iSeriesv MQSeriesv QuickPlace®

v WebSphere

Intel® and Pentium® is a registered trademark of Intel Corporation in the UnitedStates, other countries, or both.

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

Microsoft and Windows are trademarks or registered trademarks of MicrosoftCorporation in the United States, other countries, or both.

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



��

Printed in USA

GC10-4255-06

Education

websphere commerce server v6 install guide