Netscape Communicator 4.04 for OS/2 Warp README Welcome to Netscape Communicator 4.04 for OS/2 Warp. This README contains the latest information on installing and using this feature. Note: To help you locate information in this README, you can use the Find option under the Edit menu of the OS/2 System Editor. You can print the file by dragging it to your printer object or by selecting Print from the file object's pop-up menu. Using the right mouse button, click the object to display the pop-up menu. In the following sections, Netscape Communicator refers to Netscape Communicator 4.04 for OS/2 Warp. CONTENTS __________________________________________________________________ 1.0 Hardware and Software Requirements 2.0 Installation and Configuration Instructions 3.0 WorkSpace On-Demand System Administrator Notes 4.0 Functions Included in This Feature 5.0 Using Netscape Communicator behind a Firewall 6.0 Known Limitations 7.0 CID Installation Information 8.0 Service and Support 9.0 Trademarks 1.0 HARDWARE AND SOFTWARE REQUIREMENTS __________________________________________________________________ This section contains information on the minimum hardware and software required to run Netscape Communicator. If you plan to install and use Java with Netscape Communicator, you might need to consider additional hardware and software requirements. See the minimum hardware and software requirements for the version of Java you have or plan to have installed. 1.1 Minimum hardware requirements ------------------------------------------------------------------ To install and use Netscape Communicator, your workstation needs at least: o A 486 microprocessor; a Pentium(R) or compatible microprocessor at 90 MHz or higher provides better results. o A VGA display (65536 colors or higher provides better results). o 16 MB of RAM (32 MB or higher provides better results). o 10 MB free hard disk space and 22 MB of temporary disk space. o A connection to the Internet (modem, ISDN, or LAN). 1.2 Minimum software requirements ------------------------------------------------------------------ Netscape Communicator 4.04 for OS/2 is supported on the following: o OS/2 Warp 4 o OS/2 Warp Server Version 4.0 o OS/2 Warp Server Advanced Version 4.0 o OS/2 Warp Server Advanced SMP Feature o WorkSpace On-Demand 1.3 Required FixPaks and updates ------------------------------------------------------------------ Depending on your operating system, the following FixPaks or updates might be required or recommended. To download FixPaks or Corrective Service Diskette levels, go to the IBM FixPak Database Web site at http://service5.boulder.ibm.com/pspfixpk.nsf. 1.3.1 OS/2 Warp 4 ---------------------------------------------------------------- No additional FixPaks or updates are required. FixPak 5 or higher is recommended. 1.3.2 All Versions of OS/2 Warp Server ---------------------------------------------------------------- All versions of OS/2 Warp Server require at least FixPak 29. If you do not have FixPak 29 or higher installed on your system, install FixPak 32 or higher (depending on which FixPaks are available in the IBM FixPak Database). To determine if additional updates are necessary for your system, type SYSLEVEL at an OS/2 command prompt. SYSLEVEL displays a list of the software currently installed on your system, the version number of the software, and the Corrective Service Diskette (CSD) levels of the software. o If you have IBM TCP/IP Version 2.0 (see the SYSLEVEL.TCP entry in the SYSLEVEL output) and do not have CSD level UN64092 or higher installed, install CSD files level UN64092 or higher (depending on which CSD level is available in the IBM FixPak Database). o If you have IBM OS/2 LAN Adapter and Protocol Support (see the SYSLEVEL.TRP file in the SYSLEVEL output) and do not have CSD level WR08210 or higher installed, install CSD files level WR08210 or higher (depending on which CSD level is available in the IBM FixPak Database). 1.3.3 DBCS FixPaks ---------------------------------------------------------------- The following DBCS versions of OS/2 Warp Version 4 require FixPak FX00002 or higher: o OS/2 Warp 4 Japanese version (without VoiceType) o OS/2 Warp 4 Korean version o OS/2 Warp 4 Traditional Chinese version o OS/2 Warp 4 Simplified Chinese (GB) version o OS/2 Warp 4 Simplified Chinese (GBK) version All DBCS versions of OS/2 Warp Server require FixPak WX03006 or higher. 1.3.4 DBCS 16-bit Printer Drivers ---------------------------------------------------------------- If you are using the following or any other 16-bit printer drivers on DBCS versions of OS/2 Warp 4, download and apply program temporary fix (PTF) JR12305. EPSON.DRV PSCRIPT.DRV PMLIPS3.DRV IBM5584.DRV IBMPG55P.DRV IBMPS55P.DRV ESCPAGE.DRV DESKJET.DRV IBMPGNET.DRV HPDJPM.DRV LASERJET.DRV Note: JR12305 is not required for any version of OS/2 Warp Server. To download the PTF, go to o Japanese version: http://www.ibm.co.jp/aspc/fixpak.html o Korean version: http://www.ibm.co.kr/ibm/product/sw_biz/down/os2.html o Traditional Chinese version: Contact PSS Taiwan for the PTF o Simplified Chinese version: No PTF required 1.3.5 PS/55 Display Adapter II (Japanese and Korean only) ---------------------------------------------------------------- If you are using PS/55 Display Adapter II, apply program temporary fix (PTF) JR12322 before starting Netscape Communicator. To download the PTF, go to o Japanese version: http://www.ibm.co.jp/aspc/fixpak.html o Korean version: http://www.ibm.co.kr/ibm/product/sw_biz/down/os2.html 2.0 INSTALLATION AND CONFIGURATION INSTRUCTIONS __________________________________________________________________ The following sections describe how to install and configure Netscape Communicator. For information on CID installations, see section 7.0 CID Installation Information. Note to Netscape Navigator 2.02 for OS/2 Users: To make it easier to distinguish between Netscape Communicator and Netscape Navigator 2.02 for OS/2 files, install Netscape Communicator in a different directory than Netscape Navigator 2.02 for OS/2. 2.1 Installing ------------------------------------------------------------------ After you download Netscape Communicator, follow these steps: Note: To install Netscape Communicator as a client network application in a WorkSpace On-Demand environment, see section 2.2 Installing as a Client Network Application. To install Netscape Communicator as an application on a WorkSpace On-Demand server, use the following general instructions. 1. From an OS/2 prompt, change to the directory where you downloaded the comm404.exe file. 2. Type comm404 to run the executable file that unpacks the files for installing Netscape Communicator. 3. To start the installation program, type: INSTALL 4. Follow the online instructions. o If you are installing on an OS/2 Warp 4 system, the first question asks whether you want to convert the default browser for your Desktop URL object to Netscape Navigator. If you click Yes, the Netscape Navigator component of Netscape Communicator is the default program to open the URL objects on your Desktop. Note: Any URL objects that are set to open with a specific browser are not affected. o The next question (or first question if you are not using OS/2 Warp 4) asks whether you want to convert the IBM WebExplorer QuickList entries to Netscape Navigator Bookmark entries. If you answer Yes, a file named WEBEXQL.HTM is created in the x:\netscape\PROGRAM\LANG\language\DEFAULTS directory where x:\netscape is the installation drive and directory for Netscape Communicator, and language is the language of the version installed. (For example, EN_US.) Whenever user profiles are created, this file is copied into the new profile. You can then use the Netscape Bookmarks window to import the migrated bookmark entries and make them part of the default bookmark file, or open the migrated bookmark entries (and therefore make them the bookmark file). o The last question asks whether you want to associate the Netscape Navigator component of Netscape Communicator with HTML files (files with an extension of .htm and .html and files of type HTML and text/html). If you answer Yes, you can open an HTML file by selecting Open As, and then Netscape Navigator from the file object's pop-up menu. Using the right mouse button, click the object to display the pop-up menu. 5. Restart your system. The installation program creates a shadow of the Netscape Communicator icon and a Netscape Communicator 4.04 folder on your desktop. This folder includes the Communicator objects, this README file, and an installation utility, which can be used to delete, update, and reinstall Netscape Communicator. Notes: o The x:\OS2\DLL\PMDDEML.DLL system file (where x: is the boot drive) is updated during installation if an older version of the file exists. o If you get a network or TCP error and you are using Netscape Communicator behind a Firewall, you need to setup a socks server or proxy gateway. See section 5.0 or the Communicator helps for more instructions. 2.2 Installing as a Client Network Application ------------------------------------------------------------------ This installation can be done only by someone with System Administrator authority. ATTENTION: If a drive letter other than Z: is used for the clients, modify the NS40COMM.PKG file. Search for Z: and replace with the correct drive letter. Z: is specified as the drive letter in approximately lines 1652, 1799, 1802, 1805, and 1808. Line numbers might be different on some editors. To install Netscape Communicator as a client network application in a WorkSpace On-Demand environment: 1. Log on as a system administrator. Note: If you are not logged on as a system administrator, the installation fails and the following error message is displayed or written to the log file: EPFIE187: A product-specific installation error occurred while executing the 'EXEC' exit routine. The return code is 0x0002. 2. From an OS/2 prompt, change to the directory where you downloaded the comm404.exe file. 3. Type comm404 to run the executable file that unpacks the files for installing Netscape Communicator. 4. To start the installation program, type: INSTNSWS Note: All parameters that are valid for the INSTALL command are valid for the INSTNSWS command. 5. Follow the online instructions. The installation program creates a Netscape Communicator 4.04 - WorkSpace On-Demand folder on your desktop. This contains the README file and an installation utility, which can be used to delete, update, and reinstall Netscape Communicator. Notes: o If WorkSpace On-Demand was installed in a directory other than x:\IBMLAN\RPL\BB10.cc (where x: is the drive and cc is the country code), then type the correct installation directory in place of the defaults on the main installation window. o To install Netscape Communicator as an application on a WorkSpace On-Demand server, see section 2.1 Installation. 2.3 Configuring as a Client Network Application ------------------------------------------------------------------ This configuration can be done only by someone with System Administrator authority. To configure Netscape Communicator as a Client Network Application on WorkSpace On-Demand, you must perform two tasks after installing Netscape Communicator and before a client can use Netscape Communicator: 1. Modify your default FIT file. o If you are using WorkSpace On-Demand 2.0, the APPPOST.FIT file is installed when you install Netscape Communicator. WorkSpace On-Demand 2.0 uses this file for the Netscape Communicator FIT file entries. If you make any changes to the Netscape Communicator FIT file entries after installation, modify the APPPOST.FIT file. o If you are using WorkSpace On-Demand 1.0, add the following entries to the default WorkSpace On-Demand FIT file (x:\IBMLAN\DCDB\BB10ccDU.FIT, where cc is the country code for the version of WorkSpace On-Demand that is installed): Note: Each entry should be on only one line. The lines are split here for printability. ?:\NSCPDIR \\\IBMLAN$\DCDB\USERS\\COMM404 ?:\OS2\NSCP.INI \\\IBMLAN$\DCDB\USERS\\COMM404\NSCP.INI ?:\OS2\NSCP.### \\\IBMLAN$\DCDB\USERS\\COMM404\NSCP.### ?:\OS2\NSCP.!!! \\\IBMLAN$\DCDB\USERS\\COMM404\NSCP.!!! ?:\NETSCAPE\PROGRAM\NETSCAPE.INI \\\IBMLAN$\DCDB\USERS\\COMM404\NETSCAPE.INI ?:\NETSCAPE\PROGRAM\NETSCAPE.### \\\IBMLAN$\DCDB\USERS\\COMM404\NETSCAPE.### ?:\NETSCAPE\PROGRAM\NETSCAPE.!!! \\\IBMLAN$\DCDB\USERS\\COMM404\NETSCAPE.!!! ?:\NETSCAPE\PROGRAM\DYNFONTS\FONTS.CAT \\\IBMLAN$\DCDB\USERS\\COMM404\FONTS.CAT ?:\NETSCAPE\USERS \\\IBMLAN$\DCDB\USERS\\COMM404\USERS Note: The above FIT entry assumes that the default directory (x:\NETSCAPE\USERS, where x: is the drive) is the directory containing your preference files. If a directory other than the default directory is used, change this entry to match the actual directory name. If a different FIT file is being used for a particular user, then that FIT file must be updated for the user to run Netscape Communicator. The above FIT entries assume that Netscape Communicator was installed into the NETSCAPE subdirectory of the WorkSpace On-Demand RPL directory (x:\IBMLAN\RPL\BB10.cc, where x: is the drive and cc is the country code). If Netscape Communicator was installed into a different directory, this directory name needs to replace the NETSCAPE part of the FIT entries. 2. Copy the NSCP.INI file, created during the installation of Netscape Communicator, to each defined client's workarea based upon the specification in the FIT file. There are two methods that can be used to accomplish this: o Manually create the directory within the client's workarea that will contain the NSCP.INI file, and then copy the NSCP.INI file to this directory: a. From an OS/2 command prompt, change to the x:\IBMLAN\DCDB\USERS\user directory. b. Type MD COMM404 to make a directory named COMM404 within the user's directory. c. Copy the NSCP.INI file located in the Netscape Communicator PROGRAM directory of the WorkSpace On-Demand RPL directory, x:\IBMLAN\RPL\BB10.cc\ NETSCAPE\PROGRAM (where x: is the drive, cc is the country code, and NETSCAPE is the directory where Netscape Communicator is installed), into the directory created in step b. Note: The above steps need to be performed for each user/client that uses Netscape Communicator. o Update the public applications that were defined during the installation to invoke the Netscape Communicator Wrapper Utility (NSWS.EXE): a. Open the "settings" for the public application definition. b. Click on the "Invocation" tab. c. Change the command from NETSCAPE.EXE to NSWS.EXE Note: If you are experiencing difficulties with this utility, you can create and view a log file by adding >file.log, where file.log is the name of the log file, to the end of the NSWS.EXE command. After the utility has executed, type e file.log, where file.log is the name of the log file, to view the log file. d. Close the "settings" notebook. Note: The above steps need to be performed for each public application definition associated with Netscape Communicator. 2.4 Netscape Communicator Wrapper Utility for WorkSpace On-Demand ------------------------------------------------------------------ The Netscape Communicator Wrapper Utility makes the manual operation of copying the NSCP.INI file into each client's workarea easier. It reads an input file that contains specifications on the files to be copied and the directories to be created, and then executes the commands specified. The input file's name and location are created from the executable's name and location by replacing the executable's file extension with "DSF." So, if the utility is named NSWS.EXE and, the client locates the file in the Z:\NETSCAPE\PROGRAM directory, then the input file used is Z:\NETSCAPE\PROGRAM\NSWS.DSF. The input file consists of keywords and keyword values that describe the steps needed to copy the files for the application. The input file has a line limit of 256 bytes and supports the following keywords: EXE = {program} where {program} is the program to be executed (via DosExecPgm). Do not specify the EXE keyword more than once. The value of the last occurrence is used. FILE = {target file} {source file} where {target file} is the file that needs to be created and {source file} is the "template" file to be copied DIR = {target dir} where {target dir} is the directory that needs to be created in order for the file to be copied successfully You need a DIR entry for every subdirectory under the specification in the file's FIT entry. For example, if the FIT entry is ?:\OS2\NSCP.INI \\\IBMLAN$\DCDB\USERS\\BROWSERS\COMM404\NSCP.INI You would need the following DIR entries after the FILE = \OS2\NSCP.INI NSCP.INI entry: DIR = NSCPDIR1 DIR = NSCPDIR2 You also need corresponding entries in the FIT file to create these directories. Using the above example, the corresponding FIT entries would be: ?:\NSCPDIR1 \\\IBMLAN$\DCDB\USERS\\BROWSERS ?:\NSCPDIR2 \\\IBMLAN$\DCDB\USERS\\BROWSERS\COMM404 Netscape Communicator requires that the NSCP.INI file exist in the x:\OS2 directory (where x: is the boot drive). Since this file is written to as well as read from, each client is required to have one. The FIT entry information supplied in this README defines the file indirection into the client's workarea. The Netscape Communicator Wrapper Utility input file supplied is defined based upon the FIT entries defined in this README and requires no modification of these FIT entries. 2.5 Uninstalling a Previous Version ------------------------------------------------------------------ To uninstall a previous version of Netscape Communicator: 1. Double-click the Netscape Communicator Installation Utility located in the Netscape Communicator 4.04 folder or the Netscape Communicator 4.04 - WorkSpace On-Demand folder. 2. Click Netscape Communicator 4.04 for OS/2. 3. From the Action menu, click Delete. 4. Click Netscape Communicator 4.04, and then click Delete. 5. Restart your system. Note: You do not have to restart if you are uninstalling Netscape Communicator on WorkSpace On-Demand. 2.6 Creating a user profile ------------------------------------------------------------------ The first time you open Netscape Communicator, the Profile Manager prompts you for the following information. You cannot use Messenger or Collabra until all of the information is provided. If you attempt to open Messenger or Collabra before filling out all of the information required by the Profile Manager, the Profile Manager prompts you for the information again. o Your Full Name: o E-mail Address (if available): o Profile Name: (A default is provided.) o User profile directory: (A default name is provided.) o Your name: o Your e-mail address: If Netscape Navigator 2.02 for OS/2 is installed, the following three options appear: o Move previous files: Click if you want your mail and news user profile from Netscape Navigator 2.02 shared with Netscape Communicator. If you select this option, any mail or postings you receive in Netscape Communicator, you can also see in Netscape Navigator 2.02. o Copy previous files: Click if you want your mail and news user profile from Netscape Navigator 2.02 copied to the Netscape Communicator folder. If you select this option, the mail and postings you receive in Netscape Communicator is separated from the mail and postings you see in Netscape Navigator 2.02. o Start as a new user: Click if you want to ignore your Netscape Navigator 2.02 mail and news user profile and start Netscape Communicator as if Netscape Navigator 2.02 does not exist on the system. If you do not have Netscape Navigator 2.02 for OS/2 installed and this is the first user profile created for Netscape Communicator, you are prompted for the following information. If you do not know the information, contact your system administrator or Internet Service Provider (ISP). o Outgoing mail (SMTP) server: o Mail server user name: (your e-mail id) o Incoming mail server: (A default is provided.) o Mail Server type: o Discussion groups (news) server: o Port After you fill in the information, Netscape Communicator starts up using the new profile you created. To create additional profiles: 1. In the Netscape Communicator 4.04 folder on your desktop, double-click the Profile Manager icon. 2. Click New. 3. Enter the information listed above. If you have more than one profile, you are prompted to select one when you open Netscape Communicator. 3.0 WORKSPACE ON-DEMAND SYSTEM ADMINISTRATOR NOTES __________________________________________________________________ Netscape Communicator is supported as a client network application in a WorkSpace On-Demand environment. o Netscape Communicator creates the following six network applications during installation. - Netscape Communicator - Netscape Navigator - Netscape Messenger - Netscape Collabra - Netscape Composer - Netscape Profile Manager o To assign a Netscape Communicator network application to a client, you must be logged on as SysAdmin. o If the following IDs are defined when you attempt to install Netscape Communicator, the install fails: - NS40COMM - NS40NAV - NS40COLL - NS40COMP - NS40MSGR - NS40PROF This occurs only when attempting to install as a new application. It does not effect an update of a current installation. o For information on CID keywords for installing on WorkSpace On-Demand, see section 7.0 CID Installation. 4.0 FUNCTIONS INCLUDED IN THIS FEATURE __________________________________________________________________ Netscape Communicator 4.04 for OS/2 Warp includes the following components: o Netscape Navigator o Netscape Messenger o Netscape Collabra o Netscape Composer o Netscape Profile Manager 4.1 Voice Navigation ------------------------------------------------------------------ In OS/2 Warp 4, users can use voice navigation to surf the net and interact with Netscape Communicator 4.04 for OS/2 Warp. You can use the Links menu to navigate to links on the current Web page. The Links menu lists all links displayed on the current page. As you scroll down the page, new links are added to the menu as they are displayed. 4.2 Java ------------------------------------------------------------------ By default Java support is enabled during installation. You can turn the Java support off by selecting Preferences from the Edit menu, clicking Advanced, and clearing the Enable Java check box. You can modify Java properties within the browser by selecting Preferences from the Edit menu, and then clicking OS/2. Click Java Properties. The following operations are available: o Selecting the version of the Java Virtual Machine (JVM) being used by Navigator. Currently, only Java version 1.1.4, 1.1.6, and 1.1.7 are supported. o Setting parameters to be passed to the JVM. o Modifying the CLASSPATH used by the JVM. 4.3 Security ------------------------------------------------------------------ Netscape Communicator uses the Netscape Security model. Netscape Communicator contains the fix for the long filename mail vulnerability problem and the ClassLoader vulnerability exposure. For more information, see section 6.0 Known Limitations. 5.0 USING NETSCAPE COMMUNICATOR BEHIND A FIREWALL __________________________________________________________________ If you are behind a firewall you must configure either a socks server or proxy gateway to enable access to the World Wide Web. If you do not know the name of your local socks server or proxy gateway or whether you are behind a firewall, contact your system administrator or Internet Service Provider (ISP). See the Communicator helps for information on configuring a socks server or proxy gateway using the Communicator Preferences. Note: If you receive a message saying 'no DNS entry', ensure that you have a name server in your TCP/IP configuration that supports the resolution of names that are outside of their firewall. That server should be the first entry in the name server configuration list (usually x:\MPTN\ETC\RESOLV2, where x: is your boot drive) if you have more than one name server configured. OS/2 Warp 4 includes socks support within the TCP/IP protocol stack. You can enable all TCP/IP applications to cross your firewall during TCP/IP Configuration. To enable socks support within the TCP/IP protocol stack: 1. Open the System Setup folder. 2. Double-click the TCP/IP Configuration icon. The TCP/IP configuration notebook opens. 3. Click the Socks tab and fill in each of the three pages. Click Help for instructions on filling out the pages. Notes: o When you enable socks support in OS/2 Warp 4, it is not necessary to use the Netscape Communicator Preferences to configure any socks server or proxy gateway. o If you experience poor network performance from Netscape Communicator, configure the socks server or proxy gateway directly in Communicator as described in the helps. For further assistance, contact your system administrator or your ISP. 6.0 KNOWN LIMITATIONS __________________________________________________________________ The following limitations might occur or exist in Netscape Communicator. To view the latest information about known limitations for Netscape Communicator, click Release Notes from the Help menu. For information on how to report any limitations, click Product Information and Support from the Help menu. 6.1 General ------------------------------------------------------------------ o On OS/2 Warp 4 with FixPak 6 installed, some graphics might have black or white bands running through them. If you have this problem, try creating and running the following command file. To create and run the command file: 1. Copy and paste the following text into a new OS/2 System Editor session, and then save the file as an OS/2 Command File: /* REXX Command file for Netscape Communicator */ call RxFuncAdd 'SysLoadFuncs', 'RexxUtil', 'SysLoadFuncs' call SysLoadFuncs call SysIni 'USER', 'FixPak', 'Current', 'xr0m006' 2. At an OS/2 command prompt, type the name of the command file. If this does not solve your problem or you are using a different configuration of OS/2 Warp, change the command file as follows: 1. Change 'Current' to 'Shift'. 2. Change 'XR0M006' to '2' or '1'. If your problem still exists, click Help --> Release Notes for the most recent information. o Drag and drop is supported only to the OS/2 Desktop and within Netscape Communicator. o For monitors set to a resolution of 1024 x 768 or higher, the default font of Tms Rmn 10 pt. might cause overlapping. Change the default font to Tms Rmn 8 pt. to correct this problem. To change the font: 1. Click Edit --> Preferences --> Fonts to display the Fonts window. 2. To the right of Variable Width Printer Font, click Select. 3. In the Size box, type or select 8. 4. Click OK to close the Font window. 5. Click OK to save your changes and close Preferences window. o When using some font sizes, text on some Web pages might overlap or appear outside areas defined by the background color. To correct this problem, change the font. See above for instructions. o If you are experiencing difficulty with the Matrox Millennium video driver version 2.21 at a resolution higher than 64K colors, reduce your resolution to 64K or lower. If you continue to experience difficulty, contact Matrox. o During installation, if a message is displayed stating that you do not have the correct FixPak level installed and you have verified that you have the correct software requirements (see sections 1.2 Software Requirements and 1.3 FixPaks and Other Updates), then edit the NS40COMM.PKG file. Delete the following three lines: FILE EXITWHEN = 'INSTALL&& ("%NSWS%" == "FALSE")', EXIT = NETSCAPEFIXPAK o SmartUpdate/AutoInstall is not available for Netscape Communicator 4.04 for OS/2 Warp. o If you experience a SYS3175 in mozilla.dll when you start Netscape Communicator, make sure you have the latest printer driver for your printer. 6.2 Printing ------------------------------------------------------------------ o If you experience any printer problems, make sure you have the latest device driver for your printer installed. o The Print Preview function is not available. o If Netscape Communicator is printing text upside down, do one of the following: - Apply the latest FixPak. - Change the font you use for printing to a TrueType font (for example, Arial, Courier New, Times New Roman MT30). o If Netscape Communicator does not print to your network printer, make sure you have connected to the printer through a NET USE statement before starting Netscape Communicator. o If you are still experiencing printing problems, make sure you have FixPak 6 or higher installed. If your problem still exists, click Help --> Release Notes for the most recent information on the problem. 6.3 Java and JavaScript Support ------------------------------------------------------------------ o Some LiveConnect applications might not function. o See section 6.6 Performance for information on the default Initial Java Heap size. 6.4 Security ------------------------------------------------------------------ Netscape Communicator uses the Netscape Security model, instead of the Java Security model used in Netscape Navigator 2.02 for OS/2. The following limitations occur as a result of this difference. o Netscape Communicator cannot load applets signed with the Netscape Signing Tool (SignTool) when these JAR files reside in the CLASSPATH. If you attempt to load one of these applets, following error message appears on the Java console: java.io.IOException: bad zip file format JAR files signed with SignTool that are loaded through the URL or from a local hard drive directory that is not in the CLASSPATH can be successfully loaded. o Netscape Communicator can load applets signed with Sun's Javakey signing tool. However, if these applets use the Netscape security APIs (for example, enablePrivilege/revertPrivilege), the following error message appears on the JavaConsole when you attempt to load the applet: ForbiddenTargetException: User didn't grant the xxxxxxxx privilege. To resolve this problem, have the originator of the JAR file sign the JAR file using Netscape's SignTool. o Applets and JAR files requiring special privileges to system resources (for example, file system access or additional network access) must use the Netscape security model. o When signed applets are loaded from the network, the classes must be signed using the Netscape SignTool and you are prompted to grant permission. o When signed applets and JAR files are in the CLASSPATH, you are not prompted to grant permission. Permission is automatically granted whether the applet or JAR file is signed or unsigned. o If an applet needs to download files onto your local drive, you are prompted to grant permission. Be very careful when allowing an applet even limited access your file system even if it is a signed applet, unless you fully trust the signer. If you allow these files to be downloaded or otherwise placed in the Java CLASSPATH, these applets might gain full access to resources on the machine, including full access to your file system. o The UniversalMemberAccess privilege cannot be granted or enabled. 6.5 Mail & News ------------------------------------------------------------------ o Switching between IMAP and POP mail servers requires Communicator to be restarted to take effect. 6.6 Performance ------------------------------------------------------------------ o The help might take a long time to display. Avoid opening more than one session of help for better performance. o If you don't specify an Initial Java Heap (IJH) size, Netscape Communicator lets Java set the default. Java does not take into account the size of Netscape Communicator when it calculates the default IJH size. The default is determined by how much memory the machine has. Java sets a default IJH size when Netscape Communicator runs an applet. The default memory is reserved by Java until Netscape Communicator is closed. You need to set the Intial Java Heap size as follows: 1. Click Edit --> Preferences --> OS/2 Preferences to display the OS/2 Preferences window. 2. Click IBM Java Properties. 3. In the Java Options box, type -ms where number depends on the following, and m stands for megabytes and k for kilobytes: - If you have 32MB or less of system memory, set the IJH size to 4MB (-ms4m). - If you have 64MB of system memory, set the IJH size to 8MB (-ms8m). - If you have 80MB or more of system memory, let the IJH size default. 6.7 Voice Navigation ------------------------------------------------------------------ o Voice navigation can be used to select from menus such as following a link on the Links menu. It cannot be used to select list boxes or push buttons on a page. o Java applets do not support voice navigation. o VoiceType cannot detect the contents of dynamically created menus, such as Bookmarks. To move to the next item, say "Up" or "Down," rather than saying the name of the item. 6.8 Feature Install and Netscape Navigator 2.02 for OS/2 ------------------------------------------------------------------ o If you are going to install any package from Software Choice that uses Feature Install, be sure you have version 1.2.3 or higher of Feature Install from the Software Choice Web site at: http://service.boulder.ibm.com/asd-bin/doc/ 6.9 DBCS Information ------------------------------------------------------------------ o If you are using the English version of Netscape Communicator on a Korean operating system, entering text with the NUM LOCK on can cause numbers to appear in the text. o For some DBCS Web pages to print correctly, you need to do the following: 1. Click Edit --> Preferences --> Fonts to display the Fonts window. 2. To the right of Variable Width Printer Font, click Select. 3. In the Name box, type or select o Japanese - OS/2 Warp 4: MINCHO/HeiseiMincho-P or other outline font. - All versions of OS/2 Warp Server: HeiseiMincho-W3-90-TT/Normal or other outline font. o Korean - OS/2 Warp 4: MINCHO/IBM Myung Jo or other outline font. - All versions of OS/2 Warp Server: Myung Jo or other outline font. o Traditional Chinese: - OS/2 Warp 4: System default or other outline font. - All versions of OS/2 Warp Server: System default or other outline font o Simplified Chinese: - OS/2 Warp 4: Song Ti Chang Gui or other outline font. - All versions of OS/2 Warp Server: Song Ti Chang Gui or other outline font. 4. In the Size box, type or select 10. 5. Click OK to close the Font window. 6. To the right of Fixed Width Printer Font, click Select. 7. In the Name box, type or select o Japanese - OS/2 Warp 4: MINCHO/HeiseiMincho or other outline font. - All versions of OS/2 Warp Server: HeiseiMincho-W3-90-TT/Normal or other outline font. o Korean - OS/2 Warp 4: MINCHO/IBM Myung Jo or other outline font. - All versions of OS/2 Warp Server: Myung Jo or other outline font. o Traditional Chinese - OS/2 Warp 4: System default or other outline font. - All versions of OS/2 Warp Server: System default or other outline font. o Simplified Chinese: - OS/2 Warp 4: Song Ti Chang Gui or other outline font. - All versions of OS/2 Warp Server: Song Ti Chang Gui or other outline font. 8. In the Size box, type or select 10. 9. Click OK to close the Font window. 10. Click OK to save your changes and close Preferences window. 11. Close Communicator. When you reopen Communicator, you can print the Web page. 7.0 CID INSTALLATION INFORMATION __________________________________________________________________ CID installation is accomplished by using response files to install Netscape Communicator in a CID environment. A response file is a flat ASCII file that consists of a series of lines separated by newline sequences (0x0A, 0x0D, or a combination of these two sequences). Each line in a response file has a maximum line length of 255 bytes. A response file has two kinds of lines: o Comment lines contain only white space characters or have either an asterisk (*) or a semicolon (;) as the first nonwhite space character on the line. o Response lines are used by Software Installer to determine the options and configurations to install on the target system. Response lines have the following syntax: keyword = value o Keywords cannot contain imbedded spaces. o Keywords are not case-sensitive. You can group keywords together in value lists using the following syntax: keyword = ( keyword1 = value keyword2 = value . . keywordn = value ) Keyword-value pairs used in a response file can be in any order. However, only one pair is allowed per line. If you use any keyword names other than the supported keywords, they are treated as installation variables. For example, MONITOR = VGA creates a installation variable with the name of MONITOR and a value of VGA. Note: Do not use quotes around the component name, even when the name is more than one word with blanks between words. 7.1 Sample Installation Response Files ------------------------------------------------------------------ The following command is an example of the command needed to start a response file installation of Netscape Communicator: INSTALL /X /A:I /NMSG /O:DRIVE /R:responsefile /L2:outputfile The following is an example of a response file used to install the US English version Netscape Communicator 4.04 for OS/2 Warp in the C:\NETSCAPE directory: COMP = Netscape Communicator 4.04 for OS/2 FILE = C:\NETSCAPE CFGUPDATE = AUTO DELETEBACKUP = NO OVERWRITE = YES SAVEBACKUP = NO NSCONVERTBROWSER = YES NSCONVERTQL = YES NSASSOCIATEHTML = YES The following is an example of a response file used to install the US English version of Netscape Communicator 4.04 for OS/2 Warp in a WorkSpace On-Demand environment residing on the C drive: COMP = Netscape Communicator 4.04 for OS/2 FILE = C:\IBMLAN\RPL\BB10.US\NETSCAPE AUX1 = C:\IBMLAN\RPL\BB10.US CFGUPDATE = AUTO DELETEBACKUP = NO OVERWRITE = YES SAVEBACKUP = NO 7.2 Communicator keywords ------------------------------------------------------------------ Note: The following keywords are not used when installing Netscape Communicator on a WorkSpace On-Demand client. The following response file keywords are available to allow you to install Netscape Communicator in a CID environment. The possible values for each keyword are YES (perform the operation) or NO (do not perform the operation): NSCONVERTBROWSER (required) Changes the browser settings so that the Netscape Navigator component of Netscape Communicator is set as the default browser for all URL objects (OS/2 Warp 4 only). NSCONVERTQL (required) Converts the WebExplorer QuickList to Netscape Communicator bookmarks. NSASSOCIATEHTML (required) Associates the Netscape Navigator component of Netscape Communicator with HTML files (files with an extension of .htm and .html and files of type HTML and text/html). You can then open an HTML file within the Netscape Navigator component of Netscape Communicator by selecting Open As then Netscape Navigator from the file object's pop-up menu. Right-click the object to display the pop-up menu. Notes: o If, in the response file, you specify the drive and directory of an existing Netscape Communicator or Navigator installation (including an installation for another operating system), the existing installation is overwritten. o The value given in the COMP keyword in the response file must exactly match the string specified by the NAME keyword of the COMPONENT entry (see about line 397 in the NS40COMM.PKG file). o For more information on the install.exe command line parameters, enter VIEW EPFIHELP in either the installation or the target directory. 7.3 Software Installer keywords ------------------------------------------------------------------ Software Installer supports the following keywords: AUXn (conditionally required) Specifies the new default path for the auxiliary directory, where n is any number between 1 and 18. (There are 18 possible auxiliary directories: AUX1, AUX2,...AUX18.) This keyword is used only for installation processing. This AUXn value is used in place of the AUXn keyword of the PATH entry of the package file. This keyword is required if you have specified an AUXn keyword in the PATH entry. CFGUPDATE (required) Specifies whether the CONFIG.SYS file is automatically updated. Valid values for this keyword are: AUTO Automatically updates CONFIG.SYS MANUAL Does not update CONFIG.SYS COMP Specifies the unique name of a component of the product for which passed information applies. There can be a maximum of 100 components. The COMP value must match the NAME keyword of the COMPONENT entry in the package file. Note: Do not use quotation marks around the component name, even when the name is more than one word with blanks between words. COPY Specifies the source and target files for a copy process. The format of this keyword is: COPY = source_filespec target_filespec If the target_filespec already exists, it is overwritten. If either file specification is not valid, the copy is not made. DELETEBACKUP (required) Specifies whether to delete only the backup versions of the product or to delete the entire product. Valid values for this keyword are YES and NO. It is required because an existing dialog requests this information in the attended mode. If an unattended deletion is attempted and the DELETEBACKUP is not present in the response file, the deletion fails with an EPFIE212 error. FILE (conditionally required) Provides the new default path for the file directory. This keyword is used only for installation processing. This FILE value is used in place of the FILE keyword of the PATH entry in the package file. This keyword is required if you have specified a FILE keyword in the PATH entry. INCLUDE Specifies which general response files to include with a specific response file. The format of this keyword is: INCLUDE = filespec Where filespec is the general response file to be included. If the file specification contains any global characters (* or ?), the first file found that matches the specification is included. If the specification is not valid, no general response file is included. Note: You cannot have more than five levels of included response files. The following search order is used to find the general response files specified. 1. The fully qualified file specification, if specified with filespec. 2. The current directory. 3. The file name together with the /G: invocation parameter. 4. Each directory in the PATH environment variable. 5. Each directory in the DPATH environment variable. OVERWRITE (required) Specifies whether to automatically overwrite files during installation. Valid values for this keyword are YES and NO. This keyword is required for unattended processing. SAVEBACKUP (required) Specifies whether to save a backup version of the product when it is updated. Valid values for this keyword are YES and NO. It is required for unattended processing because an existing dialog requests this information in the attended mode. USEREXIT Specifies the name of an exit that you want started. The format of this keyword is: USEREXIT = filespec Where filespec is the name of a user exit. If the file specification contains any global characters (* or ?), the first executable file found that matches the specification is started. If the specification is not valid, Software Installer displays an error message. The following search order is used to find the specified user exit. 1. The fully qualified file specification, if specified with filespec. 2. The current directory. 3. Each directory in the PATH environment variable. 4. Each directory in the DPATH environment variable. If the exit does not already exist on the system, you must pack the exit in the INSTALL.IN_ file. WORK (conditionally required) Provides the new default path for the data directory. This WORK value is used in place of the WORK keyword of the PATH entry in the package file. This keyword is required if you have specified a WORK keyword in the PATH entry. 8.0 SERVICE AND SUPPORT __________________________________________________________________ It is the intent of IBM OS/2 Technical Support to provide technical support for Netscape Communicator in accordance with the following terms and conditions. The support provided has been categorized into three categories: Installation and Registration, Usage/How-to, and Product (defect) support. 8.1 Installation Support ------------------------------------------------------------------ Installation Support is intended to assist in getting Netscape Communicator installed and prepared for basic operation and configuration. Installation is considered completed when all of the following are true: o The Netscape Communicator folder is properly displayed on the OS/2 Desktop. o Launching one of the program icons (for example Navigator or Composer) in the product's folder results in the proper display of the program's main window. o Selecting each of the preference items from the Options menu item results in the display of the proper dialog box, where the user can enter the configuration information necessary to access a specific Internet Service Provider's network or other required information. Note: You are responsible for knowing, or contacting and obtaining from the Internet Service Provider, the proper information to enter. o Selecting Exit from the File menu item results in the proper shutdown of Netscape Communicator. Personal System Support Family (PSSF) offering customers may obtain installation assistance from their SupportLine Premium or Standard entitlement by calling 1-800-237-5511. Note: This installation-only support can be withdrawn at any time and will not extend past the Service End date of the OS/2 operating system on which it is installed. Registration is also online at the following Web page: http://service.boulder.ibm.com/reg/run?netscp/nsreg-1 8.2 Usage/How-to Support ------------------------------------------------------------------ o Usage/How-to Support is intended to assist you in using or learning how to use the many functions and features of Netscape Communicator. o Some of the actions or tasks that fall in this category are: - Specifically configuring Netscape Communicator to access a specific Internet Service Provider's network. - Setting up and using Messenger and Collabra features. - Installation, configuration, and operation of plug-ins and Helper applications for Netscape Communicator. - General navigation of the Internet. o Assistance for Usage/How-to support is available from many online sources. Some of the available sources are: - README files included with Netscape Communicator and the specific Plug-in or Helper products. - The Netscape Communicator online help accessible by pressing F1 on any Communicator window, clicking the Help button on some windows, and clicking Help Contents from the Help menu. - Clicking Product Information and Support from the Help menu. o In addition, if you want direct technical support from IBM call 1-800-237-5511 and obtain assistance using one of the PSSF SupportLine fee-based offerings. Note: PSSF SupportLine Premium and Standard offering users may obtain usage support in accordance with the terms and conditions of those offerings. 8.3 Product (Defect) Support ------------------------------------------------------------------ Note: Defect support is provided in accordance with the product license agreement. o Defect support is intended to provide the user with a method of reporting suspected product defects to IBM. o You can use any of the currently existing methods for reporting defects about the OS/2 operating system (such as FAX and e-mail) to submit defect reports on the Netscape Communicator. o You can click Product Information and Support from the Help menu to receive assistance in getting to the proper Internet address to report a suspected defect using the Internet. o Corrective code, when available, is deposited for electronic retrieval and a news item is posted at http://ps.software.ibm.com Note: All of the support described in this document may not be available in all countries. Countries other than the United States should refer to the documentation provided with the OS/2 Warp 4 and 3.0 products for available support and service information. 9.0 TRADEMARKS __________________________________________________________________ The following terms, are registered trademarks of the IBM Corporation in the United States or other countries or both: o IBM o OS/2 o WebExplorer o VoiceType The following terms are trademarks of other companies: Netscape, Netscape Navigator, and the Netscape N logo are registered trademarks of Netscape Communications Corporation in the United States and other countries. Netscape Collabra, Netscape Composer, Netscape Messenger, and Netscape Communicator are also trademarks of Netscape Communications Corporation, which may be registered in other countries. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Pentium is a registered trademark of Intel Corporation in the US and other countries. THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IBM AND NETSCAPE DISCLAIM 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 AND NETSCAPE COMMUNICATIONS GRANT NO LICENSES TO ANY PATENTS OR COPYRIGHTS. (C) Copyright IBM Corporation and Netscape Communications Corporation 1995, 1999. All rights reserved.