Internet Explorer/Outlook Express 4.01 for HPUX Readme

ID: Q188583

The information in this article applies to:

SUMMARY

     README for Internet Explorer 4.01 for HP-UX with
Outlook Express
            August 24, 1998

Copyright (c) Microsoft Corporation, 1997-1998

This document provides information you need to get started with Internet Explorer 4.01 for HP-UX with Outlook Express. It supplements the product documentation found under the Help menu within the product.

You can find additional information on Internet Explorer and Outlook Express in the form of Knowledge Base articles on http://support.microsoft.com. To do so, specify Internet Explorer 4.0 or Outlook Express in field one and the topic information in field two.

CONTENTS

SYSTEM REQUIREMENTS SETUP

 Downloading Internet Explorer with Outlook Express
 Installing Internet Explorer with Outlook Express
 Uninstalling Internet Explorer with Outlook Express
NEW FEATURES
 Outlook Express
 NTLM Authentication
 SOCKS Proxies
USING JAVA
 JRE packaging via the IEAK
USER AGENT AN ALTERNATIVE WAY TO ORGANIZE FAVORITES COMMON DESKTOP ENVIRONMENT (CDE) INTEGRATION KNOWN ISSUES
 HP-UX Compatibility
 Performance
 Internet Explorer User Interface Issues
 Miscellaneous Issues

SYSTEM REQUIREMENTS

To run Internet Explorer for UNIX, your system must meet the following minimum requirements:

* HP 9000 Enterprise Server, HP 9000 Workstation or HP

  Visualize Workstation
* English HP-UX Operating System version 10.20 or later * 64 MB of RAM (96 MB recommended) * 72 MB of hard-disk space to perform the installation

SETUP

Downloading Internet Explorer with Outlook Express

You can download the file ie4setup from the following sites. The file ie4setup is a self-extracting executable that contains all the necessary files. If you ftp this file, be sure to use binary transfer mode.

FTP:

      ftp.microsoft.com/deskapps/ie/unix/hp/ 

HTTP:
    http://www.microsoft.com/unix/ie

Installing Internet Explorer with Outlook Express

1) Change directory to where you downloaded the file

   ie4setup: 'cd <download directory>'
2) Make the downloaded file executable: 'chmod +x ie4setup' 3) Run the executable: './ie4setup' 4) When Setup prompts you for an installation directory,
   you can accept the default directory or type in a new
   directory path

Note: We highly recommend that Internet Explorer and Outlook Express be installed locally and not in an NFS mounted partition. Depending on the performance of your network and the NFS configuration, Internet Explorer initialization performance may degrade unsatisfactorily.

Note: Installing to the default directory, /usr/local/microsoft, may require that you be logged in as root.

After Internet Explorer is installed, you can start the browser by running "<installation directory>/bin/iexplorer". Similarly, you can start Outlook Express by running "<installation directory>/bin/oexpress".

If you have already installed the Solaris version of Internet Explorer or Outlook Express, you can install the HP- UX release in the same directory. If this update is a branded install (via the IEAK) and the earlier release was not branded, then the users' registry (~/.microsoft/registry) should be removed before running the new ie4setup.

Internet Explorer and Outlook Express 4.01 introduce new features that may not be compatible with earlier releases of these products. We recommend that installations on all platforms be upgraded to the latest revision.

You should not install this version in the same installation directory as a later release of Internet Explorer and/or Outlook Express. Nor should you install an earlier version of Solaris Internet Explorer or Outlook Express in the same installation directory as Internet Explorer for HP-UX.

Uninstalling Internet Explorer with Outlook Express

To uninstall this installation of Internet Explorer, you must perform the following: - Remove the installation directory

  For example: 'rm -r /usr/local/microsoft'
- Remove the ".microsoft" sub-directory from your home
  directory: 'rm -r ~/.microsoft'

Note: If you or your administrator have installed other versions of Internet Explorer or Outlook Express in this installation directory, you should not remove this directory. If you have installed versions of Internet Explorer or Outlook Express on other systems, and you share home directories between systems, do not remove the ".microsoft" directory, as they are shared between all UNIX versions of both Internet Explorer and Outlook Express.

If you implemented CDE integration as explained below, you should remove it by deleting the files "IE4.dt" and "IE4.HP- UX.dt" from the system or user directory.

New Features

The following features have been added since the original release of Internet Explorer 4.0 for Solaris.

Outlook Express:

Outlook Express is now available on the HP platform together with Internet Explorer. This version of Outlook Express for the first time includes full support for IMAP4 as well as LDAP, SMTP, POP3, and NNTP protocols.

NTLM Domain Authentication:

Internet Explorer now supports authenticating users against Web servers that are configured to do NTLM Challenge Response Authentication. As a result, you can now access your organization's secure Windows-NT IIS/BackOffice based Intranet applications from your UNIX desktop.

SOCKS:

Users can now access the Internet via Internet Explorer using SOCKS Proxies.

USING JAVA

In order to ensure the best possible performance and support for the underlying operating system, Internet Explorer for HP-UX integrates Hewlett-Packard's Java Virtual Machine (JVM) to support Java applets. The HP JVM is highly optimized for HP-UX, includes a Just-in-Time (JIT) Compiler, and provides support for 1.1.3 Java technology or later. Version B.01.13.05 of the HP-UX Runtime Environment for Java (JRE) and the HP-UX Developer's Kit for Java (JDK) have been verified as interoperable with Internet Explorer, and are available for both HP-UX 10.20 and 11.0.

Note: Installation of the JVM is optional. If you do not install it, applets will simply not display when encountering Web pages where they have been incorporated.

In the event that you encounter issues while installing or using HP's JVM, support and training are available at the web site indicated below.

If you do not already have the 1.1.3 Release or later of HP's JRE or JDK installed on your system, have your system or network administrator download and install the JRE or JDK for your platform from the following site:

   http://www.hp.com/esy/go/java.html

Note: Customers ordering systems from HP with the HP-UX Instant Ignition option will automatically have a Java environment integrated with their system. The version that is most widely available is Release 1.0.2. This version does not support automatic proxy configuration, and must be upgraded to work with Internet Explorer.

After the run-time is installed, simply add the JVM's directory to your UNIX path. Internet Explorer will find and execute the first "java" or "jre" available in this path. For example:

   setenv PATH "$PATH:<JVM Install Dir>"

Alternatively, you can set the MS_JAVA_VM environment variable to point directly to your JVM executable. For example:
   setenv MS_JAVA_VM /opt/java/jre/java

This approach allows you to choose between multiple JVMs on your system, to rename this particular JVM, or to move it at any time.

You are now ready to have Java Applets automatically launched in HP's Applet Viewer when encountered on web sites via Internet Explorer.

You can add parameters to the Java runtime's invocation using the MS_JAVA_PARAMS environment variable. Using this variable to add command line parameters will disable the default enabled by Internet Explorer for trustProxy. Therefore, when setting this variable, you should also set "trustProxy=TRUE":

    % setenv MS_JAVA_PARAMS "-DtrustProxy=TRUE <your
    parameters>"
To see the list of available parameters use the following command:
    % jre -help.

If the "Java Logging Enabled" checkbox is selected in Internet Options, the applet viewer will provide log output to ~/.microsoft/Java/javalog.txt. If the environment variable MS_SHOW_JAVA_VM is set however, logging output will go to the console, regardless of how the "Java Logging Enabled" option is set.

If you do not have a complete install of HP's JDK (if you install just the JRE, for example), a nearly empty window with the title "Copyright notice" will appear when rendering some pages containing Java content.

The Java VM must be at JDK Release 1.1.3 or greater, or the Java Proxy must be manually configured within the applet viewer. The same is true if you set proxies via the auto- proxy feature of the browser.

Use of the JRE or JDK from HP is governed by the licensing terms, conditions, and waivers that accompany it.

JRE PACKAGING VIA IEAK:

Note to Administrators:

The Runtime Environment for Java on HP-UX can be included in your Internet Explorer Administration Kit (IEAK) customized package. We have provided detailed instructions for this procedure on our web site. Instructions to create the JRE package to redistribute via the IEAK can be found by navigating to http://www.microsoft.com/ie/unix. Click on the "Features" selection in the contents section and then click on the "Administration Kit (IEAK)" selection. Once the customized package has been created, the user can then install this component.

Note to Users:

If an interactive install option has been selected by the administrator, then you will be prompted whether the JRE package should be installed or not. The actual prompt will vary depending on the custom component description defined by the administrator (e.g. 'Do you want to install "Runtime environment for Java" [y]/n ?' ). If you choose to install this component, it will be installed into <install>/external/ux10/.

USER AGENT

The User Agent String for Internet Explorer is constant except for the third field, which depends on the Operating System and the processor you are using.

Here are some common configurations and the user agent strings generated by Internet Explorer on these platforms:

   HP 9000 C-180, HP-UX 10.20:
      Mozilla/4.0 (compatible; MSIE 4.01; HP-UX B.10.20
      9000/780; X11)

   HP 9000 K-250, HP-UX 10.20:
      Mozilla/4.0 (compatible; MSIE 4.01; HP-UX B.10.20
      9000/802; X11)

AN ALTERNATIVE WAY TO ORGANIZE FAVORITES

In addition to being able to organize favorites through the Organize Favorites item on the Favorites menu, you can also manipulate your favorites through the file system. Your favorites are organized and maintained in the directory, ~/.microsoft/Favorites. You should shut down Internet Explorer to make changes to this directory. The changes you make will be reflected in your Favorites menu when you restart Internet Explorer.

COMMON DESKTOP ENVIRONMENT INTEGRATION

If you run Internet Explorer within a CDE session, it will adopt the CDE color scheme unless overridden with explicit color settings.

Two CDE action database files are provided, and you can use them to implement integration of Internet Explorer with the CDE desktop. The files are in the "ie4" subdirectory of the installation, and are called "IE4.dt" and "IE4.HP-UX.dt". You can copy the file "IE4.dt" to the directory /etc/dt/appconfig/types/C (usually requiring root access), which will affect all users on the system. Copy "IE4.HP-UX.dt" to your directory ~/.dt/types (do not copy it to the directory /etc/dt/appconfig/types/C, as there may be files already in that directory that specify an Open action for HTML files). Alternatively, to affect only one user, you can copy both the files to the user's directory ~/.dt/types. After installing action files, it is necessary to reload the action database, which is usually done by logging out and in again.

If you use CDE integration, then the default action for an HTML file will be to launch Internet Explorer and open the file. Also, the new CDE action "IE4" will launch Internet Explorer. See the CDE documentation for ways of invoking the action.

There is a set of Internet Explorer icons for use with CDE, in the ie4/ie4icons subdirectory of the installation. They can be used by experienced administrators who want to place the Internet Explorer logo on the desktop.

CDE integration can be removed by simply deleting the "IE4.*.dt" files from the system or user directories.

The file "IE4.dt" is identical to the file that is shipped with a Solaris distribution of Internet Explorer, except for one line which identifies the installation directory. More information on CDE Integration can be found in the Knowlege Base article Q181622, available from: http://support.microsoft.com/support/kb/articles/q181/6/22.a sp

KNOWN ISSUES

HP-UX Compatibility

Internet Explorer is not supported on HP-UX 10.10 and below. It is fully supported on HP-UX 10.20 and 11.0.

We recommend that Internet Explorer be used on HP systems patched with the Extension Software Patch bundle.

Installing and executing Internet Explorer on HP-UX 10.20 or 10.30 requires C++ runtime support to be available on your system. If you do not have the C++ runtime, you can install it by applying the Hewlett Packard patch PHSS_15043 (or later superceding patch, if it exists). If you receive the following error during installation, it is because you have not installed C++ runtime support:

"/lib/dld.sl: Unresolved symbol: $global$ (data) from /lib/libCsup.1..."

We recommend that the X server on your workstation should be at the patch level represented by the Hewlett Packard patch PHSS_14943 (or later superceding patch) for HP-UX 10.20 or 10.30 and PHSS_13905 for HP-UX 11.0. If your X server is older than this patch level, you are likely to experience minor display problems when running Internet Explorer.

To retrieve the patches, visit the page at:

      http://us-support.external.hp.com/ 

You will need to register if you have not done so already. Follow the links to "Patch Database" and "Retrieve a Specific Patch", and enter the patch number (PHSS_14943 or PHSS_15043, for example). If the patch has been superseded, the system will tell you, and you should accept the newer version. Download the patch and follow the installation instructions.

Use of Hewlett Packard patches is subject to the license terms and disclaimers that may accompany the patch.

This release of Internet Explorer includes a threads-enabled version of the X11R6.3 Xlib library (libX11.sl). If an X11- based application is run from Internet Explorer, it will inherit settings that may cause it to use this version of the X11 library instead of the standard version supplied by the system. Applications likely to be affected are Mail, News, and programs run as a result of File Associations. If it is important that you use another Xlib for an external program, you can wrap the program in a script that extends or replaces the SHLIB_PATH environment variable (see HP-UX documentation for more details).

Performance

Users can experience unsatisfactory degradation in performance when their installation directories and their home directories are remotely mounted via NFS. We highly recommend installing Internet Explorer locally (e.g. not on a remotely mounted NFS partition).

For optimum performance, Internet Explorer should have a cache and user settings on the local machine as well. The cache and user settings are stored in the '.microsoft' sub- directory of the users' home directory. To allow Internet Explorer to cache and store user settings locally, create a

'.microsoft' directory on a local filesystem
(/usr/local/.microsoft, for example). Copy the contents of the existing '.microsoft' directory to the new directory. Finally, create a soft link from your home directory to this local directory as follows:

   % ln -s /usr/local/.microsoft ~/.microsoft

Note: If multiple users share a single machine, then they should each create and link to unique '.microsoft' directories.

Additional Info Regarding the Internet Explorer User Interface

o Experienced users of X11 can set color preferences using

  X resources with the class name "Iexplorer".

o When highlighting text in the browser window, Internet
  Explorer will automatically highlight whole words, unless
  the cursor is backed up over a word, in which case single
  character units can be highlighted.

o When not running within a CDE session, Internet Explorer
  obtains its color specifications using standard X
  mechanisms with fallback values obtained from the file
  <installation directory>/ie4/Iexplorer. This is an X
  resource file and contains instructions that will help
  the system administrator or individual user perform
  limited color and font customization. Note: You may use
  the command line options to set the foreground and
  background colors - for example, "iexplorer -bg black
  -fg white" would be useful on a monochrome display.

o Audio files can be played on systems that have the
  appropriate hardware. Simply associate the files with the
  standard HP-UX command "/opt/audio/bin/send_sound" under
  View -> Internet Options -> Mapping. Typical file
  suffixes are .wav, .au, and .snd.

Miscellaneous Issues

o Settings for the cache size slider in Internet Options

  are made in integer increments.  Therefore, setting the
  size below 1% of the host partition will results in a
  displayed value of 0%.

o If you manually delete the directory TempInternetFiles
  while the browser is running, the browser may hang.

o HTML pages that omit file extensions for image references
  are not rendered correctly.

o Internet Explorer may leave files in a temporary
  directory (/var/tmp). These files, of the form
  trbxxxxxxxx.tmp (for example), are not needed and can be
  safely deleted whenever Internet Explorer is not running.

o If different people share a common user ID, network
  authentications made by one person may be available to
  others who are running simultaneous copies of the
  browser.

o Form items and transparent GIF images do not print
  correctly.

o Address auto-complete does not always work as expected
  for addresses with mixed case.

o In the Mappings tab of the Internet Options Menu, the
  command line field cannot contain output redirection
  statements (e.g.: cat %1> /dev/audio).

o In the Programs tab of the Internet Options Menu, the
  news command or script specified cannot be passed more
  than one argument.

o Please note that the mail, news and view->source scripts
  referenced in the View -> Internet Options -> Programs
  tab are samples and not fully functional solutions. Some
  samples depend on xterm, which should be locatable from
  your PATH environment variable.

o When referencing external programs such as telnet, emacs,
  or vi in the View -> Internet Options -> Programs tab,
  please make sure the external software is included in
  your PATH environment variable.

o If you install Internet Explorer on a host machine, and
  use NFS to mount the installation on another machine
  using a _different_ pathname, then you will not be able
  to execute Internet Explorer on the second machine.
  Similarly, if you move the installation directory to a
  different pathname, you will not be able to execute
  Internet Explorer. In both cases you will receive the
  following error message:

  "Internet Explorer is not currently supported for HP-UX
  B.10.20."

  To fix the problem, ensure that the environment variable
  MSFT_HOME is set to the name of the installation
  directory before starting Internet Explorer. For example,
  if you mounted or renamed the installation directory as
  /net/myhost/local/ms, then execute this command: (csh)
  setenv MSFT_HOME /net/myhost/local/ms/ 
     or
  (sh)  MSFT_HOME=/net/myhost/local/ms/ ; export MSFT_HOME

  Note the trailing "/" character.

  You may use alternative approaches. For example,
  experienced users may prefer to make a copy of the
  "bin/iexplorer" command, which is a simple shell script,
  and change the directory reference on line 3.

  Note that different implementations or configurations of
  automounters may introduce the NFS naming inconsistency.

o Selecting the print range option entitled "Selection"
  does not limit the print range.

o If you are using an HP X terminal, it is possible that IE
  will fail on startup while enumerating the terminal's
  fonts.  You should make sure the terminal is not using
  fonts from its host's font server.  In the following
  instructions, we assume the host's name is "myserver":
    1) Execute the command "xset q" and verify that the
    font path contains "tcp/myserver:7000"
    2) Execute the command "xset fp- tcp/myserver:7000"
    3) Start Internet Explorer
  In our testing we have found that the font server's fonts
  are not required by Internet Explorer or by other
  applications.

Additional query words: msieunix msoeunix
Keywords          : kbreadme msieunix 
Version           : UNIX:4.01
Platform          : UNIX
Issue type        : kbinfo

Last Reviewed: March 18, 1999