________________________________________________________________________________

IBM WEBSPHERE APPLICATION SERVER, ADVANCED SINGLE SERVER EDITION FOR OS/2(R) 
V4.0.1 README

This is the Readme for IBM WebSphere Application Server, Advanced Single Server 
Edition for OS/2 V4.0.1 (WebSphere). This Readme contains information about 
installing WebSphere and the required software for WebSphere.
_______________________________________________________________________________
Table of Contents

  1.0 SYSTEM REQUIREMENTS
      1.1 Hardware Requirements
      1.2 Software Requirements
  2.0 CONTENTS OF THE WEBSPHERE CD
      2.1 WebSphere Prerequisite Installation Files
      2.2 WebSphere Installation Files
      2.3 Additional Required and Optional Installation Files
  3.0 INSTALLING WEBSPHERE APPLICATION SERVER
      3.1 Installing WebSphere Application Server
      3.2 Installing WebSphere InfoCenter
  4.0 STARTING WEBSPHERE APPLICATION SERVER
  5.0 UNINSTALLING WEBSPHERE APPLICATION SERVER
  6.0 WORKAROUNDS
  7.0 TRADEMARKS

________________________________________________________________________________
1.0 SYSTEM REQUIREMENTS

WebSphere Application Server for OS/2 Version 4.0.1 has the following system
requirements:

1.1 Hardware Requirements

     o  500Mhz Pentium processor
     o  512 MB RAM
     o  500 MB of free space on your hard drive
     o  CD-ROM Drive
     o  Connectivity to a TCP/IP network

1.2 Software Requirements

     o  OS/2 Warp Server for e-business V4.50 or, 
        Convenience Package for OS/2 Warp Server for e-business V4.51, or 
        Convenience Package for OS/2 Warp Server for e-business V4.52
     o  IBM HTTP Server Powered by Apache for OS/2 version 1.3.20
     o  TCP/IP 4.3.2
     o  DB2 version 7.2.0 for OS/2 (required only for some WebSphere samples or
        if needed for customer applications)
     o  If you have OS/2 Warp Server for e-business V4.50 and you plan to use 
        the Netscape browser to view the InfoCenter, you must install Java 1.1.8 
        to replace Java 1.1.7.
     o  If you plan to use IBM Web Browser V1.1 to view the WebSphere InfoCenter, 
        you must install Java 1.3.0 SR7 or later to use the InfoCenter search 
        facility and the navigation applet.

        NOTE: If you have a Chinese, Taiwanese, or Japanese OS/2 Warp Server for 
        e-business V4.50 system, you must install a corresponding OS/2 PTF:

        o  XRJE002 for Japanese
        o  XRME002 for Traditional Chinese
        o  XRTE002 for Simplified Chinese

        These PTFs are not required on systems running either of the Convenience 
        Packages for OS/2 Warp Server for e-business.

________________________________________________________________________________
2.0 CONTENTS OF THE WEBSPHERE CD

The WebSphere CD contains the installation files for WebSphere and the
prerequisite software needed to run WebSphere.  The packages should be installed
in the order presented below.

2.1 WebSphere Prerequisite Installation Files

The WebSphere CD contains the installation files for the following products and
upgrades:

     o  TCP/IP 4.3.2

        The TCP/IP 4.3.2 installation files are in the "tcpip43" directory on 
        the CDs. There is a subdirectory for each language version of TCP/IP. 
        English (en), Spanish (es), and Brazilian Portueguese (br) are provided 
        on CD1. Simplified (cx) and Traditional (tw) Chinese, German (de), 
        French (fr), Italian (it), and Japanese (jp) are provided on CD2.
        Refer to files "readme.mpt" and "readme.txt" in the respective language
        directory for installation instructions.  Note that MPTS is required for 
        WebSphere and must be installed before TCP/IP.

     o  IBM HTTP Server Powered by Apache for OS/2 version 1.3.20

        The IBM HTTP Server installation files are in the "ihs" directory.
        Refer to the file "OS2.README" in that directory for requirements and
        installation instructions.

2.2 WebSphere Installation Files

     o  WebSphere Application Server

        The WebSphere Installation Files are located in the "WebSphere401" 
        directory.  
        See section 3.1 below for installation instructions.

     o  WebSphere InfoCenter

        The WebSphere InfoCenter is in the "infocenter" directory on the CD.
        See section 3.2 below for installation instructions.

2.3 Additional Required and Optional Installation Files

The WebSphere CD contains the installation files for the following products and
upgrades:

     o  DB2 fix pack

        This package is required to run some of the WebSphere samples or if a
        DB2 database will be used by customer applications.  The package
        supplies the JDBC 2.0 support required by WebSphere.  DB2 version 7.2.0
        must be installed before this fix package.

        The DB2 fix pack files are in the "db2jdbc20" directory.  To install
        the DB2 fix pack, complete the following steps:
             o  Change the directory to "db2jdbc20" from the root of the
                CD-ROM drive.
             o  Run the command file "install.cmd"

     o  IBM Web Browser for OS/2 V1.1

        The IBM Web Browser for OS/2 installation files are in the "browser"
        directory. Refer to the files "read.me" and "icnguide.HTM" for product 
        information and installation instructions.

     o  IBM Web Browser for OS/2 V1.1 Fixes

        The IBM Web Browser for OS/2 V1.1 fixes are included in the "browserDLLs"
        directory. There are three DLL files here that fix various issues. To 
        install the fixes, complete the following steps.
        1.  Locate the existing DLL files you will be replacing, They are in the 
            \os2web\components directory. Rename these files to back them up.
        2.  Copy the DLLs from the CD to the \os2web\components directory.

     o  IBM OS/2 Warp Developer Kit, Java(TM) 2 Technology Edition, Version 1.3 
   
        The IBM OS/2 Warp Developer Kit, Java(TM) 2 Technology Edition, Version 
        1.3 installation files are in the "java130" directory. Installation 
        instructions can be found in the readme file in that directory. You 
        should install IBM Web Browser V1.1 before you install Java 1.3. This 
        will install the Java Plugin for the IBM Web Browser which will allow 
        you to use the WebSphere InfoCenter search facility.
               
_______________________________________________________________________________
3.0 INSTALLING WEBSPHERE APPLICATION SERVER

After you are sure you meet all the hardware and software requirements
for WebSphere, complete the instructions below to install WebSphere.

3.1 Installing WebSphere Application Server

        The WebSphere Installation Files are located in the "WebSphere401" 
        directory.             
            1.  Insert the WebSphere CD into your CD-ROM drive.
            2.  Change to the WebSphere401 directory of the WebSphere CD.
            3.  Run the command file "install.cmd".
            4.  Follow the instructions on the installation panels to complete  
                the installation. On the Choose Installation Options panel, it 
                is recommended that you select the Typical Installation. This 
                selection will install all components of WebSphere. For 
                descriptions of the Custom Installation option and command line 
                options for silent and unattended installations, see the 
                InfoCenter after you install it as described in section 3.2. 

        The installation program places a new folder named WebSphere 4.0.1 on 
        the desktop. See the InfoCenter for a description of the icons in the 
        folder and what they are for.


3.2 Installing WebSphere InfoCenter

        The WebSphere InfoCenter is in the "infocenter" directory on the CD.
        There are two installable modules in the InfoCenter.

        The first module contains information that applies directly to WebSphere
        Application Server on OS/2.  This module must be installed because it
        contains specific information about post-installation, getting started,
        and troubleshooting for WebSphere on an OS/2 system.

        The second module is the base documentation for WebSphere Application
        Server, Advanced Single Server Edition, on all platforms except OS/2.
        This module covers many topics in depth including development tips,
        administration, and others.  This module is optional, but if it is
        not installed some of the links in the OS/2 specific part which
        reference multiplatform information in the base module will be presented
        as errors by your browser.

        The InfoCenter must be installed after WebSphere Application Server is
        installed.  To install the InfoCenter, with the WebSphere CD still in
        the CD drive, complete the following steps:

             1.  Double click on the "WebSphere 4.0.1" icon which was placed on
                 the OS/2 desktop when you installed the WebSphere Application
                 Server.
             2.  Double click on the "WebSphere Command Environment" icon in the
                 WebSphere 4.0.1 folder.
             3.  Perform all the following steps in the "WebSphere Command
                 Environment" window which is now open.
             4.  Type "h:\infocenter\install", where h: is your CD-ROM drive
                 letter, then press the Enter key.
             5.  From the menu presented, decide which modules to install.  
                 Type the number for your selection, then press the Enter key.

        When the InfoCenter installation completes, it writes a log file,
        InfoCenterInstall.log, in the parent directory of the AppServer,
        typically C:\WebSphere.  You can use this file to review the messages
        displayed in the command window during installation.  Disregard the
        following errors at this time:

             o  Error 19 in Dom2Spt -- in addHistoryElement() -- Element
                appserver was not found.
             o  Error 17 in Dom2Spt -- in addEvent() --  History element could
                not added.
             o  Error 13 -- Failed to add event node.

        To view the InfoCenter, either type "viewInfo" then press the Enter key 
        or open the WebSphere 4.0.1 folder on the desktop and double-click the 
        InfoCenter icon. Either method starts a browser displaying the InfoCenter 
        Welcome page.
   
        NOTE: If you want to reinstall the InfoCenter, you must first manually 
        remove the existing InfoCenter files under the c:\WebSphere\en directory
        before reinstalling.

________________________________________________________________________________
4.0 STARTING WEBSPHERE APPLICATION SERVER

To get started running WebSphere Application Server, complete the following
steps:

    1. Stop then restart the IBM HTTP Server.
    2. Open the WebSphere 4.0.1 folder on the OS/2 desktop.
    3. Double click on the First Steps icon.
    4. Click on the line "Start the Application Server"


________________________________________________________________________________
5.0 UNINSTALLING WEBSPHERE APPLICATION SERVER

To uninstall WebSphere Application Server, complete the following steps:

    1. Before starting the uninstall process, stop the IBM HTTP Server and the 
       WebSphere Application Server and close any open WebSphere Command 
       Environment windows.
    2. Start uninstallation by selecting OS/2 Warp -> WebSphere 4.0.1 ->
       Uninstall.
    3. On the dialog that appears, click Uninstall to delete WebSphere.
    4. To completely remove WebSphere, files changed after installation 
       and the InfoCenter files must be removed manually.

________________________________________________________________________________
6.0 WORKAROUNDS

Admin Console and Netscape 4.6.1 for OS/2

    Issue:

    The Admin Console will not open in Netscape 4.6.1 on a Japanese or 
    Traditional Chinese language machine. This is a problem with a language 
    variable in Netscape 4.6.1. 


    Workaround:

    To fix this problem, complete the following steps:

      1  Open the Netscape 4.6.1 browser 
      2  Select Edit -> Preferences from the tool bar. 
      3  In the Preferences dialog box, select Languages under the Navigator 
         category. This will show the languages that were set up when Netscape was
         installed. 
      4  Delete the defaulted language (either Japanese or Traditional Chinese) 
      5  Click the Add button. 
      6  From the list box, reselect the language (ja for Japanese, zh_TW for 
         Traditional Chinese) and click OK. 
      7  Click OK on the Preferences dialog box. 
      8  Close and reopen your browser. 

________________________________________________________________________________
7.0 TRADEMARKS

The following terms are trademarks of International Business Machines
Corporation in the U.S., or other countries, or both:

    IBM
    OS/2
    OS/2 Warp
    WebSphere

Java is a trademark of Sun Microsystems, Inc. in the U.S.
and other countries. The Java technology is owned and exclusively
licensed by Sun Microsystems, Inc.

Intel and Pentium are registered trademarks of Intel Corporation
in the United States and other countries.

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

THE INFORMATION PROVIDED IN THIS README IS PROVIDED "AS IS" WITHOUT 
WARRANTY OF ANY KIND.  IBM DISCLAIMS ALL WARRANTIES, WHETHER 
EXPRESSED OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED 
WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY 
WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING
THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS.

(C) Copyright IBM Corporation, 2001. All rights reserved.
U.S. Government Users Restricted Rights -- Use, duplication or 
disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
______________________________________________________________________

  END-OF-README-FILE
______________________________________________________________________
