# Installation and Configuration Guide

Note
Before using this information and the product it supports, read the general information under Appendix A, Notices.

First Edition (June 2003)

This edition applies to the IBM Web Browser for OS/2 V2.0.1 (Web Browser) and to all subsequent releases and modifications until otherwise indicated in new editions.

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

# Contents

About this book

Components and requirements

- IBM Web Browser components
- Hardware requirements
- Software requirements

  Installing IBM Web Browser in an OS/2 Warp environment

  Installing Web Browser in a WorkSpace On-Demand 2.0 environment

  Migrating from Netscape Communicator 4.x to IBM Web Browser

- About the MOZILLA_HOME entry in CONFIG.SYS

  Uninstalling Web Browser

  Appendix A. Notices

- Trademarks

  # About this book

  This Installation and Configuration Guide provides instructions to install and configure IBM Web Browser for OS/2 V2.0.1.

  # Components and requirements

  The following sections list the components of the IBM Web Browser and the hardware and software requirements that you need to run Web Browser.

  ## IBM Web Browser components

  The IBM Web Browser includes the following components:

  - Mozilla browser
  - Mail/News
  - SpellChecker

  ## Hardware requirements

  The following lists minimum hardware requirements to run the IBM Web Browser:

  - A Pentium(R) II or compatible microprocessor at 233 MHz or higher.
  - 96MB of RAM.
  - 30MB free hard disk space.
  - 38MB of temporary hard disk space (for installation).
  - 256 color display or greater.
    Note:
      The IBM Web Browser will run on systems with 16 color display. However, the quality of the display becomes significantly lower.
  - A connection to the Internet.

  ## Software requirements

  The IBM Web Browser supports the following:

  - Convenience Packages for OS/2 Warp(R) Server for e-business
  - Convenience Packages for OS/2 Warp 4

  # Installing IBM Web Browser in an OS/2 Warp environment

  After you download the IBM Web Browser, complete the following instructions to extract and then install the IBM Web Browser in a Convenience Package for OS/2 Warp Server for e-business or a Convenience Package for OS/2 Warp 4.0 environment:

  Note:
    To avoid a potential SYS2070 trap condition, uninstall any previous version of the IBM Web Browser before proceeding with the installation steps.
  1. Open an OS/2 window and type `browser` to start the installation program or open the folder where you downloaded browser.exe and double-click browser.exe.
  2. When the IBM Web Browser Setup -- Welcome dialog displays, click Next.
  3. Read the license agreement and click Accept to accept the agreement.
  4. Select the type of setup you prefer:
     Browser only
       Installs minimal browser options.
     Complete
       Installs all of the browser components.
     Custom
       Installs selected options which you select.

     If you want to read the README file at this time, click Read Me.

     Notes:

     1. To install Mail/News or SpellChecker, you must install the browser component.
     2. By default, IBM Web Browser installs in the `OS2WEB` directory. To change the installation directory, click Browse and specify the directory you prefer.
  5. Click Next. The IBM Web Browser Setup -- OS/2 Integration dialog displays.
  6. If you want to use the IBM Web Browser as the default program for opening URL objects on the desktop, check Make IBM Web Browser my default Internet Browser.
     Note:
       Checking this check box does not affect URL objects that are set to open with a specific browser.
  7. If you want to enable Web Browser as a browser that you can select when you open HTML files, check Associate HTML files with IBM Web Browser.
  8. Click Next. The IBM Web Browser Setup -- Start Install dialog displays.
  9. Click Install to start the installation process.

     The installation program creates a shadow of the browser and an IBM Web Browser folder on your desktop. The IBM Web Browser folder includes the Browser object, Profile Manager object, and the uninstall utility object. It might also include the Mail object if you installed Mail/News.

  10. Double-click the Web Browser icon on your desktop to start Web Browser.

      If no profiles are found for migration, Web Browser creates a default profile. If more than one profile exists, the User Profile Manager opens automatically when you start Web Browser. You can use the User Profile Manager to select the profile that Web Browser uses. The User Profile Manager also enables you to add or delete profiles.

      Note:
        A network or TCP error might occur when you use Web Browser behind a firewall. To resolve the error, set up a socks server or proxy gateway. See the online help for more information.

  # Installing Web Browser in a WorkSpace On-Demand 2.0 environment

  This chapter explains how to install Web Browser in a WorkSpace On-Demand 2.0 environment. There are several ways to install and share an application on WSOD 2.0. This section describes how to manually install Web Browser.

  Complete the following instructions to install Web Browser in a WorkSpace On-Demand 2.0 environment:

  1. Log on to a WorkSpace On-Demand 2.0 server as a system administrator.
  2. Stop the RIPL service by typing the following command at a command prompt:

         C:\NET STOP RPL

  3. Download the Web Browser install file, browser.exe.
  4. Run the self-extracting install file, c:\browser.exe.
     Note:
       You can install Web Browser V2.0.1 over the previous version of Web Browser. If you encounter installation problems, use the uninstall utility to remove the previous browser before installing Web Browser V2.0.1. The uninstall utility does not delete the user profiles and plug-ins. If you decide to completely remove Web Browser and all of its files and profiles, delete the following directories:
       - c:\ibmlan\dcdb\users\username\commbr
       - c:\ibmlan\rpl\bb20.cc\os2\os2web
  5. When the IBM Web Browser Setup -- Welcome dialog displays, click Next.
  6. Read the license agreement and click Accept to accept the agreement.
  7. Select the type of setup you prefer:
     Browser only
       Installs minimal browser options.
     Complete
       Installs all of the browser components.
     Custom
       Installs selected options which you select.

     If you want to read the README file at this time, click Read Me.

     Notes:

     1. To install Mail/News or SpellChecker, you must install the browser component.
     2. Type the following as the Destination Directory:

             c:\ibmlan\rpl\bb20.cc\os2\os2web

        Note:
          To avoid modifying client FIT files, install Web Browser in the `os2` directory or in a subdirectory of the `os2` directory. The default directory is `ibmlan\rpl\bb20.cc\os2\os2web`, where cc represents the two-character country or region code.

          To install to a directory other than `ibmlan\rpl\bb20.cc\os2\os2web`, type the directory where you want to install Web Browser in the Installation Directory field; then, modify the `apppost.fit` file to reflect the directory name. The name of the installation directory cannot exceed 32 characters.

  8. Click Next. The IBM Web Browser Setup -- OS/2 Integration dialog displays.
  9. If you want to use Web Browser as the default program for opening URL objects on the desktop, check Make IBM Web Browser my default Internet Browser.
     Note:
       Checking this check box does not affect URL objects that are set to open with a specific browser.
  10. If you want to enable Web Browser as a browser that you can select when you open HTML files, check Associate HTML files with IBM Web Browser.
  11. Click Next. The IBM Web Browser Setup -- Start Install dialog displays.
  12. Click Install to start the installation process.

      The installation program creates an os2web folder. The folder contains the README file and an installation utility.

      The installation program also creates an application, named BRCOMM, for the browser and an application, named BRPRF, for the User Profile Manager.

  13. If the installation fails, you might need to uninstall, or delete, or both the previous browser.
  14. Using a text editor, create the apppost.fit file by copying the text of the following sample FIT file and make the appropriate substitutions noted in the header, and save that file to the Destination Directory, for example, c:\ibmlan\rpl\bb20.cc\os2\os2web:

          ;APPFIT     ; required for application FITs
          ;
          ;  Default FIT file for Mozilla Based Browser
          ;     ?:\ is replaced with the client's boot drive
          ;     <DCSERVER> is replaced by the server name of Domain Controller
          ;     <USER> is replaced by the user id
          ;     <RPLBOOTSERVER> is replaced by the name of the RPL Boot Server
          ;     <MACHINE> is replaced by the machine name
          ;     <OSVERSION> is replaced by the Operating System version. (bb20.us etc)
          ;
          ;  The BRCPDIR1 entry is required by the BRWS.EXE utility in order to create the
          ;  COMMBR subdirectory under the \\<DCSERVER>\IBMLAN$\DCDB\USERS\<USER> directory.
          ;  The BRCPDIR2 entry is required by the BRWS.EXE utility in order to create the
          ;  MOZILLA subdirectory under the \\<DCSERVER>\IBMLAN$\DCDB\USERS\<USER>\COMMBR directory.
          ;  The BRCPDIR3 entry is required by the BRWS.EXE utility in order to create the
          ;  CHROME subdirectory under the \\<DCSERVER>\IBMLAN$\DCDB\USERS\<USER>\COMMBR directory.
          ;
          ;  The last 3 entries allow migration of profiles from default install of Netscape
          ;  Communicator 4.61.
          ;
          ?:\OS2\OS2WEB\MOZILLA                      \\<DCSERVER>\IBMLAN$\DCDB\USERS\<USER>\COMMBR
          ?:\OS2\OS2WEB\MOZREGISTRY.DAT              \\<DCSERVER>\IBMLAN$\DCDB\USERS\<USER>\COMMBR\MOZREGISTRY.DAT
          ?:\OS2\OS2WEB\COMPONENT.REG                \\<DCSERVER>\IBMLAN$\DCDB\USERS\<USER>\COMMBR\COMPONENT.REG
          ?:\OS2\OS2WEB\COMPONENTS\XPTI.DAT          \\<DCSERVER>\IBMLAN$\DCDB\USERS\<USER>\COMMBR\XPTI.DAT
          ?:\OS2\OS2WEB\COMPONENTS\XPTITEMP.DAT      \\<DCSERVER>\IBMLAN$\DCDB\USERS\<USER>\COMMBR\XPTITEMP.DAT
          ?:\OS2\OS2WEB\COMPONENTS\COMPREG.DAT       \\<DCSERVER>\IBMLAN$\DCDB\USERS\<USER>\COMMBR\COMPREG.DAT
          ?:\OS2\OS2WEB\REGISTRY.DAT                 \\<DCSERVER>\IBMLAN$\DCDB\USERS\<USER>\COMMBR\REGISTRY.DAT
          ?:\OS2\OS2WEB\PLUGINREG.DAT                \\<DCSERVER>\IBMLAN$\DCDB\USERS\<USER>\COMMBR\PLUGINREG.DAT
          ;?:\\NSCPDIRB                             \\<DCSERVER>\IBMLAN$\DCDB\USERS\<USER>\COMMBR
          ?:\OS2\NSCP.INI                         \\<DCSERVER>\IBMLAN$\DCDB\USERS\<USER>\COMM461\NSCP.INI
          ?:\OS2\NSCP.###                         \\<DCSERVER>\IBMLAN$\DCDB\USERS\<USER>\COMM461\NSCP.###
          ?:\OS2\NSCP.!!!                         \\<DCSERVER>\IBMLAN$\DCDB\USERS\<USER>\COMM461\NSCP.!!!
          ?:\OS2\NSREG.DAT                        \\<DCSERVER>\IBMLAN$\DCDB\USERS\<USER>\COMM461\NSREG.DAT
          ?:\NETSCAPE\PROGRAM\\NETSCAPE.INI        \\<DCSERVER>\IBMLAN$\DCDB\USERS\<USER>\COMMBR\NETSCAPE.INI
          ?:\NETSCAPE\PROGRAM\\NETSCAPE.###        \\<DCSERVER>\IBMLAN$\DCDB\USERS\<USER>\COMMBR\NETSCAPE.###
          ?:\NETSCAPE\PROGRAM\\NETSCAPE.!!!        \\<DCSERVER>\IBMLAN$\DCDB\USERS\<USER>\COMMBR\NETSCAPE.!!!
          ?:\NETSCAPE\PROGRAM\\DYNFONTS\\FONTS.CAT  \\<DCSERVER>\IBMLAN$\DCDB\USERS\<USER>\COMMBR\FONTS.CAT
          ?:\NETSCAPE\USERS                       \\<DCSERVER>\IBMLAN$\DCDB\USERS\<USER>\COMMBR\USERS

      Notes:

      1. The IBM Web Browser uses directories (based on the directories specified in the FIT file) in each user's workarea. Client machines cannot access IBM Web Browser unless these directories have been created.
      2. If you installed IBM Web Browser in a directory other than the default (os2\os2web), modify the apppost.fit file to reflect the new location. The default directory location is similar to ?:\OS2\OS2WEB... For example, if you installed IBM Web Browser in the \IBMLAN\RPL\BB20.US\NETSCAPE\M directory, change the location to ?:\NETSCAPE\M. Do not install the IBM Web Browser into any directory that is not a subdirectory of the OS2 or NETSCAPE directories. If you install into a directory other than the default, the directory name cannot exceed 32 characters. If the directory name exceeds 32 characters, the installation of additional components will fail.
  15. IBM Web Browser writes to several files in the x:\os2\os2web directory (where x represents the boot drive). Every client machine must have its own set of these files to read from and write to. The directories for the files must exist in each client machine's write area before you open IBM Web Browser for the first time. You must create these directories manually because client machines cannot access IBM Web Browser unless these directories have been created.

      To create the directories manually:

      1. At an OS/2 command prompt, change the directory to x:\ibmlan\dcdb\users\user. Where x represents the drive letter for the user's workarea and user represents the name of the user.
      2. Create a subdirectory named commbr within the user's directory. For example, type:

              MD COMMBR

      3. Change to the commbr directory. For example, type:

             CD COMMBR

      4. Create a subdirectory named mozilla within the commbr directory. For example, type:

             MD MOZILLA

      5. Create a subdirectory named chrome within the commbr directory. For example, type:

              MD CHROME

      6. Complete Steps a through e for each client machine that uses Web Browser.
  16. Use the GUI as follows to manually create applications BRCOMM, for Web Browser and BRPRF, for the User Profile Manager:
      1. Open LAN Services File and Print.
      2. Open LAN Server Administration.
      3. Open the Domain icon.
      4. Open Public Application Definitions.
      5. Drag and drop the "WorkSpace on Demand Template" to an empty space in the Public Applications Definition folder.
      6. Fill out the notebook pages as described for the Public Application:

         Identity
           - Specify os2web in the Application Name field.
           - Specify IBM Web Browser in the Description field. This title appears under an icon on the desktop.

         Invocation
           - Specify os2web.exe in the Command field.
           - Specify -profilemanager in the Parameters field. (for BRPF only)

         Program Location
           - Check On requestor for the Program location check box.
           - Specify \os2\os2web in the Remaining path to program field.
           - Specify the letter of the drive on which the os2\os2web directory resides in the Specified drive field.

         Work Directory
           - Check On requestor for the Work directory location check box.
           - Specify \os2\os2web in the Remaining path field.
           - Specify the letter of the drive on which the os2\os2web directory resides in the Specified drive field.

         Program Mode
           Select OS/2 PM as the program mode.

         Parameters
           Add the following parameters:

           User | Name | Append | Value
           --- | --- | --- | ---
           No | LIBPATH | Begin | Z:\OS2\OS2WEB
           No | MOZILLA_HOME | Replace | Z:\OS2\OS2WEB
           No | NCC_SETUP_POST | Begin | ICONFILE= Z:\OS2\OS2WEB\OS2WEB.ICO
           No | PATH | Begin | Z:\OS2\OS2WEB

      7. Click Create to create the Public Application.
  17. Assign BRCOMM to the users that you want to have the browser.
  18. Assign BRPRF to the users that you want to have the User Profile Manager.

      Drag and drop the application, or select individual users under User Accounts and Add to each user's Application Tab

  19. Run the GETRPL utility. The GETRPL utility sets access rights for the new subdirectory. If the defaults are acceptable, the client machines can access IBM Web Browser.
  20. Start the RPL service by running the following command in an OS/2 window:

           C:\NET START RPL

  21. Start the WSOD client machine, logon with a valid userid, and start the browser application BRCOMM.

  If no profiles are found for migration, IBM Web Browser creates a default profile. If more than one profile exists, the User Profile Manager opens automatically when you start IBM Web Browser. You can use the User Profile Manager to select the profile that Web Browser will use. The User Profile Manager also enables you to add or delete profiles.

  Notes:

  1. The apppost.fit file provided with IBM Web Browser contains the necessary FIT entries to locate and migrate Netscape Communicator 4.61 profiles (assuming that you installed Netscape Communicator 4.61 in its default directories). If you installed Netscape Communicator 4.61 to different directories, or if you are using Netscape Communicator 4.04, you must modify the IBM Web Browser apppost.fit file entries to match the directory where you installed Netscape Communicator 4.61 or Netscape Communicator 4.04. Modify the apppost.fit file entries immediately after you install IBM Web Browser to allow each user to migrate the first time they log on and open the browser. (If they want to migrate later, they can open the User Profile Manager on the desktop to delete all existing profiles and then open the browser. If no profile is found to migrate, a new default profile is created.)

  2. A network or TCP error might occur when you use the IBM Web Browser behind a firewall. To resolve the error, set up a socks server or proxy gateway. See the online help for more information.

  # Migrating from Netscape Communicator 4.x to IBM Web Browser

  To migrate your files from Netscape Communicator 4.x for OS/2 (version 4.61 or 4.04) to the IBM Web Browser, follow the installation steps for your environment. The first time you open IBM Web Browser, a window is displayed that asks if you want to migrate. Select Yes to migrate your profile and bookmarks. If you have multiple profiles, Web Browser prompts you to select the one that you want to migrate.

  Notes:

  1. IBM Web Browser is not intended to replace Netscape Communicator 4.x.
  2. You cannot export address books from Netscape Communicator.

  ## About the MOZILLA_HOME entry in CONFIG.SYS

  The MOZILLA_HOME entry enables you to specify where the registry and profile information is stored for the IBM Web Browser. The location that MOZILLA_HOME points to must be on a HPFS or JFS drive. The IBM Web Browser cannot store registry and profile information on a FAT drive. If this entry is not specified in CONFIG.SYS, Web Browser places the profile directory in the same directory as the executable. If you want to put your profiles somewhere else, you must explicitly add MOZILLA_HOME to CONFIG.SYS and have it point to the desired location.

  # Uninstalling Web Browser

  IBM Web Browser for OS/2 V2.0.1 provides a utility that you can use to uninstall the IBM Web Browser from Convenience Package for OS/2 Warp 4 or Convenience Package for OS/2 Warp Server for e-business.

  To uninstall the IBM Web Browser:

  1. Open the Web Browser folder on your desktop.
  2. Double-click the Uninstall IBM Web Browser object.
  3. Click Yes.

  # Appendix A. Notices

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

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

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

  The following paragraph does not apply to the United Kingdom or any other country or region where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

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

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

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

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

  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 material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement, or any equivalent agreement between us.

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

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

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

  All IBM prices shown are IBM's suggested retail prices, are current and are subject to change without notice. Dealer prices may vary.

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

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

  COPYRIGHT LICENSE:

  This information contains sample application programs in source language, which illustrates programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written.

  These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. You may copy, modify, and distribute these sample programs in any form without payment to IBM for the purposes of developing, using, marketing, or distributing application programs conforming to IBM's application programming interfaces.

  Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows:

  (C) (your company name) (year). Portions of this code are derived from IBM(R) Corp. Sample Programs. (C) Copyright IBM Corp. 2003. All rights reserved.

  If you are viewing this information softcopy, the photographs and color illustrations may not appear.

  ## Trademarks

  The following terms are registered trademarks of International Business Machines Corporation in the United States, or other countries or regions, or both:
  IBM
  OS/2
  OS/2 Warp

  Pentium is a registered trademark of Intel Corporation in the United States, other countries, or both.

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