Compaq Secure Web Browser
for OpenVMS™ Alpha™

Installation Guide and Release Notes

Version 1.0
Based on Mozilla M1.0 RC2
CPQ-AXPVMS-CSWB-V0100--1.PCSI

Contents:

Before Installing Compaq Secure Web Browser

Installing Compaq Secure Web Browser

Running Compaq Secure Web Browser

Release Notes

Frequently Asked Questions (FAQ)

Support

Before Installing Compaq Secure Web Browser

Hardware Prerequisites

Compaq Secure Web Browser for OpenVMS is available only on the Alpha platform.

If you encounter color problems when running Compaq Secure Web Browser on an 8-plane video mode system, it is likely that you are running another application that uses a large number of colors (Navigator V3 is such an application). In this situation, start Compaq Secure Web Browser before you start the other application. These problems usually do not occur on a 16 or 24-plane video mode system.

Disk Space Requirements

The Compaq Secure Web Browser for OpenVMS PCSI kit requires approximately 150,000 blocks of working disk space to install.

Software Prerequisites

The following software is required in order to successfully run Compaq Secure Web Browser:

Compaq Secure Web Browser for OpenVMS has been tested and verified using Compaq TCP/IP Services for OpenVMS. Compaq has not formally tested and verified other TCP/IP network products, including the following TCP/IP network products from Process Software Corporation:

TCPware Version 5.5
MultiNet Version 4.3

Important: If you are running MultiNet V4.3A or lower, or TCPware V5.5-3 or lower, you must install a new LIBNSPR4.SO image in your CSWB directory. See http://www.process.com/techsupport/mozilla.html for more information.

Account Quotas

Important: If you are using Java (via the Compaq Software Development Kit (SDK) for the OpenVMS Operating System, for the Java™ Platform) with Compaq Secure Web Browser, you should add the PGFLQUOTA required for Compaq SDK to the Compaq Secure Web Browser requirement to obtain a total number. Do the same for the FILLM requirement. It is the total numbers that you must set in your SYSUAF entry.

The current Compaq SDK PGFLQUOTA requirement is 2,000,000. The current Compaq SDK FILLM requirement is 4,000. See the Compaq Software Development Kit (SDK) for the OpenVMS Operating System, for the Java™ Platform documentation website for more information.

If you use the supplied INSTALL.COM to install the Compaq Secure Web Browser images, the default FILLM of 100 is sufficient.

See The FAQ section - insufficient resources for operation error for information about setting the amount of virtual memory available to your DECwindows X server process.

System Parameters

Compaq Secure Web Browser requires a relatively large number of process sections, so you may find that you have an insufficient number. (Note: If you install the Compaq Secure Web Browser images after you install the Compaq Secure Web Browser kit, you can avoid this problem completely. See Installing the Compaq Secure Web Browser Images for more information.)

If you see an error similar to either of the following, then you have exhausted the available process sections: 

    nsNativeComponentLoader:GetFactory(/dka0/mozilla/components/libnsgif.so)
    Load FAILED with error: OpenVMS status is decimal 540

    %SYSTEM-F-SECTBLFUL, process or global section table is full

There are three ways to solve this problem, as follows:

Mozilla.org Release Notes

Compaq Secure Web Browser is based on Mozilla M1.0 RC2. Mozilla.org has provided release notes for M1.0 RC2.

The release notes contain sections about Mozilla on Windows®, Mac®, and UNIX®. Compaq Secure Web Browser for OpenVMS is ported from the UNIX code, so the notes in the UNIX section are applicable to OpenVMS.

When reading UNIX documentation, note the following differences between UNIX and OpenVMS:

Installing Compaq Secure Web Browser

Copying and Expanding the Kit

 To create the .PCSI file to install the Compaq Secure Web Browser, you must first copy the self-extracting file from the e-Business Infrastructure CD-ROM to a write-enabled disk drive, and then use the RUN command to expand the file. For example: 

    $ SET DEFAULT cddrive:[EBUSINESS.CSWB.KIT]
    $ COPY CSWB-OPENVMS-ALPHA-V100.SFX_AXPEXE diskdrive:
    $ SET DEFAULT diskdrive:
    $ RUN CSWB-OPENVMS-ALPHA-V100.SFX_AXPEXE
After the RUN command completes, the decompressed file CPQ-AXPVMS-CSWB-V0100--1.PCSI exists in the diskdrive: directory. Do not rename this file.

Important: If you expand the kit on an ODS-5 disk, the filename defaults to lowercase. PCSI requires all uppercase characters. Rename the file to the same name, but containing all uppercase characters, before you begin the installation.

Installation Procedure

Use the following procedure to start the installation.

Note: Multiple users can run Compaq Secure Web Browser on the same system. You need to install CSWB only once. User specific information is maintained in a user profile, and these are stored in each user's SYS$LOGIN tree.

You must install Compaq Secure Web Browser into a top-level directory. If you do not accept the PCSI default destination, make sure that you do not attempt to install Compaq Secure Web Browser into a subdirectory.

To install the Compaq Secure Web Browser for OpenVMS Alpha kit, enter the following command: 

    $ PRODUCT INSTALL CSWB

For a description of the features you can request with the PRODUCT INSTALL command when starting an installation such as running the IVP, purging files, and configuring the installation, see the POLYCENTER Software Installation Utility User's Guide.

As the installation procedure progresses, the system displays the following information. 

     The following product has been selected:

        CPQ AXPVMS CSWB V1.0                   Layered Product

     Do you want to continue? [YES]

     Configuration phase starting ...

     You will be asked to choose options, if any, for each selected product and for
     any products that may be installed to satisfy software dependency requirements.

     CPQ AXPVMS CSWB V1.0

     * This product does not have any configuration options.

         Compaq Secure Web Browser (CSWB) for OpenVMS Alpha

     Execution phase starting ...

     The following product will be installed to destination:

         CPQ AXPVMS CSWB V1.0                   DISK$ALPHASYS:[VMS$COMMON.]

     Portion done: 0%...10%...20%...90%...100%

     The following product has been installed:

         CPQ AXPVMS CSWB V1.0                   Layered Product

     $

Stopping and Restarting the Installation

Use the following procedure to stop and restart the installation:

  1. To stop the procedure at any time, press Ctrl/Y.

  2. Enter the DCL command PRODUCT REMOVE to reverse any changes to the system that occurred during the partial installation. This deletes all files created up to that point and causes the installation procedure to exit.

  3. Go back to the beginning of the installation procedure to restart the installation.

Installing the Compaq Secure Web Browser Images

After you install Compaq Secure Web Browser using the PRODUCT INSTALL command, you can also optionally install the Compaq Secure Web Browser images. There are two benefits to installing the images:

To install the Compaq Secure Web Browser images, run the command file INSTALL.COM (which resides in the Compaq Secure Web Browser root directory). For example: 

    $ SET DEFAULT SYS$COMMON:[CSWB]
    $ @INSTALL

Approximately 48 global sections and 62,704 global pages are required to install the Compaq Secure Web Browser images. If you want to uninstall the Compaq Secure Web Browser images, enter the following: 

    $ SET DEFAULT SYS$COMMON:[CSWB]
    $ @INSTALL REMOVE

Running Compaq Secure Web Browser

Compaq Secure Web Browser is a full browser with extensions, and closely resembles Netscape 7. CSWB contains:

You invoke the CSWB application through the supplied MOZILLA.COM command file. To invoke CSWB, enter the following: 

$ @SYS$COMMON:[CSWB]MOZILLA

This assumes that you installed the kit to the default location. If you directed PCSI to install to a different location, then your command to start Compaq Secure Web Browser will contain a different disk or directory.

You can also pass arguments to the application. For example: 

$ @SYS$COMMON:[CSWB]MOZILLA
$ @SYS$COMMON:[CSWB]MOZILLA -edit
$ @SYS$COMMON:[CSWB]MOZILLA -ProfileManager

When you run Compaq Secure Web Browser, the system must have approximately 336 global pages and one global section available. A check is made when you invoke Compaq Secure Web Browser. If these requirements are not met, a warning is issued and terminating Compaq Secure Web Browser is recommended.

When running Compaq Secure Web Browser, you will see messages similar to the following appear in the terminal output. 

$ @SYS$COMMON:[CSWB]MOZILLA
Starting mozilla-bin...
$

Many other messages are displayed when using the Navigator, Mail/News and Composer components of Compaq Secure Web Browser.

Release Notes

This section contains notes on the current release of Compaq Secure Web Browser.

  • Support for the Java™ Platform in Compaq Secure Web Browser

    Compaq Secure Web Browser for OpenVMS requires the Compaq Software Development Kit (SDK) v 1.3.1-1 for the OpenVMS Operating System, for the Java™ Platform, to run Java applets. Version 1.3.1-1 and later releases of the Compaq SDK contain the required OJI (Open JVM Integration) support.

    You can download the Compaq SDK from the Compaq Java for Alpha Systems software download page.

    Important: After you install the Compaq SDK, copy the OJI plugin from the Java installation to [CSWB.PLUGINS], then restart CSWB. Refer to the section on Mozilla/CSWB Browser Support in the documentation available from Compaq SDK Documentation website for more information.

  • Support for Plugins and Helper Apps in Compaq Secure Web Browser

    Compaq Secure Web Browser contains support for several plugins and helper apps, including a Java/OJI plugin, a Flash plugin, and a PDF viewer helper app. (Currently only the Java/OJI plugin is supported by Compaq.)

    • Java Plugin

      The Compaq SDK Java functionality is implemented in Compaq Secure Web Browser through the Java/OJI plugin. See Support for the Java™ Platform in Compaq Secure Web Browser for more information.

    • Flash Plugin

      The Flash plugin for OpenVMS is provided by Mark Berryman, who ported Olivier Debon's open source flash player. The Flash plugin for OpenVMS currently supports most of Flash 4 but does not support the actionscript features of Flash 5. Support for sound is underway.

      Download the Flash plugin from ftp://mvb.saic.com/extra/libflashplugin.so.

      Then, copy the LIBFLASHPLUGIN.SO file into SYS$COMMON:[CSWB.PLUGINS] (or into the [.PLUGINS] directory of the location where you installed CSWB) and restart your browser.

      Feedback is welcome; please send mail to Mark.Berryman@Mvb.Saic.com.

    • XPDF Helper App

      XPDF is a freeware PDF viewer. Version 0.9.2 is available on the OpenVMS Freeware CD. (More recent versions are available from http://decwarch.free.fr/pspdf#XPDF.)

      After you download and install XPDF, you must create a command file that Compaq Secure Web Browser uses to invoke XPDF. (CSWB passes the PDF filespec in UNIX format, and XPDF requires it to be in OpenVMS format).

      Assuming XPDF.EXE resides in DKA0:[TOOLS], create the command file DKA0:[TOOLS]XPDF.COM and insert the following commands: 

      $ f = "sys$scratch:" + p2 - "/tmp/"
$ mcr dka0:[tools]xpdf 'f'
$ exit

      Next, start CSWB and click on Edit -> Preferences, Navigator, Helper Applications. In the pane on the right, click "New Type..." and then fill in the following information:

      Description of type: PDF
      File extension: pdf
      MIME Type: application/pdf
      Application to use: /dka0/tools/xpdf.com

      Click on OK to add the new Helper App and then OK again to exit Preferences. The next time you try to view a PDF file, the XPDF viewer will be launched.

    Frequently Asked Questions (FAQ)

    This section contains frequently asked questions about Compaq Secure Web Browser for OpenVMS Alpha.

    Differences between Compaq Secure Web Browser and Netscape

    Q: What are the differences between Compaq Secure Web Browser and Netscape?

    A: Compaq Secure Web Browser and Netscape 7 PR1 are both based on Mozilla M1.0 RC2. The Netscape 6 (V6.2) browser was built from the Mozilla M0.9.4 code base.

    Mozilla for OpenVMS Alpha is currently available from the OpenVMS web site.

    Differences between Compaq Secure Web Browser and Mozilla

    Q: What are the differences between Compaq Secure Web Browser and Mozilla for OpenVMS?

    A: Compaq Secure Web Browser is supported by Compaq, but Mozilla for OpenVMS Alpha is not supported. CSWB Version 1.0 is based on Mozilla M1.0 RC2. Newer baselevels of Mozilla for OpenVMS Alpha will be released by Compaq shortly after new baselevels are released by Mozilla.org.

    Java Support in Compaq Secure Web Browser

    Q: Is there support for Java in Compaq Secure Web Browser for OpenVMS?

    A: Yes. See the Release Notes section Support for the Java™ Platform in Compaq Secure Web Browser for OpenVMS.

    Compaq Secure Web Browser on OpenVMS VAX

    Q: Will a version of Compaq Secure Web Browser be available on VAX systems?

    A: There are currently no plans to port Compaq Secure Web Browser to the VAX platform.

    Installing Compaq Secure Web Browser and Mozilla on the same system

    Q: Can I install Mozilla on the same system as CSWB?

    A: Yes. Both CSWB and Mozilla can coexist on the same system. User profiles are common to CSWB and Mozilla so your mail, bookmarks, and so on that you have on CSWB will be available on Mozilla. The reverse is also true: mail and bookmarks on Mozilla are available on CSWB.

    Note: Be sure to access your user profile with only one instance of the browser (CSWB or Mozilla) at any one time. There is currently no locking mechanism for user profiles, so profile corruption can occur.

    PAGE UP key doesn't work

    Q: Why doesn't the PAGE UP key work as expected?

    A: The key bindings for the six keys in the middle of the keyboard (which include PAGE UP or REMOVE) assume that you have an LK style keyboard. If you have a PC style keyboard, you should define the logical GTK_KEY_MAPPING_MODE to 2 before running Mozilla. For example: 

    $ DEFINE GTK_KEY_MAPPING_MODE 2
    Valid values for GTK_KEY_MAPPING_MODE are:

    0 - No mapping
    1 - LK keyboard (default)
    2 - PC keyboard

    GENERIC_POLL: unknown condition, errno=4 vaxc$errno=2096

    Q: From time to time I see the GENERIC_POLL message above. What's the problem?

    A: There is no problem. The message, which typically appears when a java applet starts up, is purely informational and can be ignored.

    CSWB terminates with Gdk-ERROR **: BadAlloc (insufficient resources for operation)

    Q: Why am I getting an insufficient resources for operation error, which causes Compaq Secure Web Browser to terminate?

    A: If Compaq Secure Web Browser terminates with an error similar to the following: 

    Gdk-ERROR **: BadAlloc (insufficient resources for operation)
serial 3993912 error_code 11 request_code 53 minor_code 0
Gdk-ERROR **: BadDrawable (invalid Pixmap or Window parameter)
serial 3993915 error_code 9 request_code 70 minor_code 0
    It is likely that you need to increase the amount of virtual memory available to your DECwindows X server process. The default is 100,000 pages. Compaq recommends that you set the value of virtual memory to 200,000 pages.

    To change this number, edit the file SYS$STARTUP:DECW$PRIVATE_SERVER_SETUP.COM and add a line similar to the following: 

    $ decw$server_page_file ==  200000
    If the file SYS$STARTUP:DECW$PRIVATE_SERVER_SETUP.COM does not already exist, create it and add the preceding line.

    The amount of virtual memory required depends on many factors. In general, the higher the resolution of your display and the higher the number of planes used for color (8, 16, or 24), the more virtual memory the X server needs.

    After saving the file, restart your X server for the change to take effect. To restart your X server, enter the following command: 

    $ @sys$startup:decw$startup restart
    Note: Restarting the X server will terminate all of your running DECwindows programs.

    Compaq Secure Web Browser doesn't start up - decimal error

    Q: Compaq Secure Web Browser fails to start up. I see errors similar to this displayed: 

    nsNativeComponentLoader: SelfRegisterDll(/dka0/mozilla/components/libvcard.so)
Load FAILED with error: OpenVMS status is decimal 114690

    A: One of the account quotas may be too low. See Account Quotas and System Parameters, in particular the discussion about the FILLM quota.

    Compaq Secure Web Browser doesn't start up - process or global section error

    Q: Compaq Secure Web Browser fails to start up. I see errors similar to this displayed: 

    nsNativeComponentLoader: GetFactory(/dka0/mozilla/components/libnsgif.so)
Load FAILED with error: OpenVMS status is decimal 540
%SYSTEM-F-SECTBLFUL, process or global section table is full

    A: You have a shortage of process sections. See Account Quotas and System Parameters for information about how to solve this problem.

    Can't open new DECterms

    Q: After running Compaq Secure Web Browser, I can't open any new DECterms. Normal terminal sessions (for example, telnet) still work properly. Only a reboot seems to fix the problem -- removing the installed components from memory (INSTALL.COM REMOVE), or restarting X-Windows does not help. Other X-Windows applications do not seem to be affected. What's going on?

    A: You are probably out of buffer object space. Try increasing the SYSGEN parameter MAXBOBMEM.

    Unable to open the temporary file

    Q: I can't send mail or create a page using Composer. I see a message similar to "Unable to open the temporary file." What's wrong?

    A: Make sure that you do not have any logical name or symbol definitions for tmp or tmpdir. If you do, remove them.

    Support

    V1.0 Customer Release Version

    Support for Compaq Secure Web Browser Version 1.0 for OpenVMS Alpha is provided by Compaq under existing OpenVMS service agreements through standard support channels.

    See Compaq support for worldwide support center telephone numbers.

    If you do not have a support contract and are not interested in acquiring one, you can informally exchange information with other users in the OpenVMS newsgroup comp.os.vms.

    For technical feedback to the Compaq Secure Web Browser for OpenVMS engineering team, please send mail to OpenVMS.CSWB@hp.com.