1

Client Installation and Configuration

Server Installation and Configuration

Using eBusiness Gateway with Prophet 21

EBUSINESS GATEWAY

ii

EBUSINESS GATEWAYDocumentation Updates

Date Description Where Changed

01/13/00 Added a tip box that describes how to verify the version of the EBGsoftware you are currently using.

Verify Version of EBG Software(page 116)

01/11/00 Revised the sections on determining if the Java RuntimeEnvironment (and the X11 and Java software) is installed. You cannow determine if you have the accurate JRE version by simplyentering the command java version at a command prompt or AIXprompt.

Determine if Java RuntimeEnvironment is Already Installed(page 19)

Verify X11 and Java Software isInstalled (page 35)

01/11/00 Divided the Troubleshooting chapter into five sections: AIX, Java,OpenLink Server, EBG Server, and Networking. Each section listsvarious things to troubleshoot in that area of the EBG software.

Chapter 9, Troubleshooting(page 109)

12/29/99 Added a new chapter that describes things to check whentroubleshooting any issues that occur with the EBG software.

Chapter 9, Troubleshooting(page 109)

11/30/99 Rewrote the chapter on installing the client software on operatingsystems other than Windows NT and AIX.

Chapter 4, Client Installation OnOther Operating Systems on page 48.

11/30/99 Reorganized the installation instructions for the Windows NT andAIX client installations.

Chapter 2, Windows NT ClientInstallation on page 19.

Chapter 3, AIX Client Installationon page 35.

10/11/99 Added the OpenLink version 3.2 requirement to the ClientInstallation Requirements Table in Chapter 1.

Client Installation Requirements Tablein Chapter 1, Introduction on page17.

iii

10/11/99 Changed the AIX requirement throughout the manual if you areusing an AIX version not including and lower than 4.2.1, you mustupgrade to the most current version of AIX to install the eBusinessGateway software. If you are currently using AIX version 4.2.1, youcan install the eBusiness Gateway software, but you first need toinstall the X11 and Java software.

Throughout the manual.

10/11/99 Added a step to the AIX Client Installation chapter after youselect the List Installed Software and Related Information option,you need to select the option List Installed Software on thefollowing screen.

Chapter 3, AIX Client Installationon page 35.

iv

The documentation in this publication is provided pursuant to a Sales and Licensing Contract for theProphet 21 System entered into by and between Prophet 21 and the Purchaser to whom this documentation isprovided (License Agreement). In addition, the licensed software to which this documentation refers may besupported in accordance with a customer support agreement by and between the same parties (SupportAgreement). All warranties, conditions of use, transfer restrictions, and other provisions in the LicenseAgreement or Support Agreement which are applicable to Licensed Software, are applicable to thispublication. In addition, this publication may include inadvertent technical inaccuracies or typographicalerrors for which Prophet 21 is not responsible. Changes may be periodically made to this publication; thesechanges will be incorporated in new editions of the publication. Any questions about the material contained inthe publication should be addressed to the Prophet 21 Customer Support Department at 1-800-ITS-PR21.

Nothing in this statement amends or extends the terms of your agreement with Prophet 21, including anywarranties that might be included in our products. Warranties for such agreements are set forth in youragreement with Prophet 21.

Improvements and/or changes to the Licensed Software described in this publication may be made byProphet 21 at any time without notice.

DOCUMENTATION CONVENTIONS The eyeglass symbol () indicates a field on which you can browse. The star () indicates the system default for a field. You can override the system

defaults via the Acclaim Screens company option, which allows you to customizeyour own defaults for specific fields in Catalog Item Maintenance.

To allow for the widest possible parameters when printing a report or performing afunction, accept the defaults for all of the parameter fields. To accept the defaults,either escape through all the fields, or press [Enter] without specifying any values.Generally, samples in the documentation are shown using the default values.

Start and End parameters define the limits to a range of information you will print ona report. If information does not appear on a report, it may be because theinformation was excluded from the Start, End range.

For a detailed explanation on how maintenance screens function, refer to the TourGuide manual.

Use the search tool in Adobe Acrobat Reader to find which manual describes aspecific module, job, or function.

2/22/00Prophet 21 Acclaim Version 10

The Prophet 21 system and Prophet 21 Acclaim are registered trademarks, and Prophet 21 and ScratchPad are trademarks of Prophet 21.All other trademarks and registered trademarks are the property of their respective companies.

v

Table of Contents

1 INTRODUCTION ____________________________________________________9

Overview ___________________________________________________________9Internet Commerce__________________________________________________9Version 3.0 New Features ____________________________________________9System Administrator Requirements ___________________________________10Integration Requirements ____________________________________________10Java Requirements_________________________________________________10Overall System Requirements ________________________________________11

Client Installation _________________________________________________11Server Installation ________________________________________________12

eBusiness Gateways Architecture _____________________________________12Client Installation __________________________________________________16Client Installation Requirements Table __________________________________17

Begin the Installation _________________________________________________18Serial Numbers____________________________________________________18Client Installations _________________________________________________18

2 WINDOWS NT CLIENT INSTALLATION _________________________________19

System Requirements ________________________________________________19

Java Runtime Environment ____________________________________________19Determine if Java Runtime Environment is Already Installed _________________19

Installation _________________________________________________________20Installing the Java Runtime Environment ________________________________20Installing the eBusiness Gateway Client Software _________________________28

3 AIX CLIENT INSTALLATION _________________________________________35

System Requirements ________________________________________________35

Verify X11 and Java Software is Installed _________________________________35

Installation _________________________________________________________36Installing the X11 Software___________________________________________36

vi

Installing Java_____________________________________________________41Installing the AIX Client Software ______________________________________45

4 CLIENT INSTALLATION ON OTHER OPERATING SYSTEMS _______________48

Before You Begin ___________________________________________________48

Create Directories and Copy Files_______________________________________48Create Directories__________________________________________________49Copy Files________________________________________________________49

Set Up Environment Variable __________________________________________51

Using the Configuration Servlet_________________________________________52Using the JSDK Server______________________________________________52

Configure the JSDK Server _________________________________________52Running the JSDK Web Server (Starting the Configuration Server) __________52Configure the Client Software _______________________________________53Edit the servlets.properties File ______________________________________53

Use Your Own Web Server __________________________________________53Advanced Servlet Configuration _____________________________________54Configure The Client Software_______________________________________54

Class Files_________________________________________________________54

5 CONFIGURE THE CLIENT SOFTWARE_________________________________55

Starting Configuration Server on AIX_____________________________________55Starting Configuration Server on Windows NT ____________________________56

Logging Configuration Form ________________________________________65Add New Store __________________________________________________65Edit / Delete Store ________________________________________________66Retrieve a Deleted Store ___________________________________________68

6 EBG SERVER INSTALLATION & BASIC CONFIGURATION ________________70

Installing the EBG Server _____________________________________________70

Basic Configuration of the EBG Server in AIX______________________________76Controlling the EBG Server __________________________________________79

7 WEB-BASED CONFIGURATION OF THE EBG SERVER ___________________82

Setup Windows NT Client for Server Configuration__________________________82Setup AIX Client for Server Configuration _______________________________85

vii

Configure the EBG Server ________________