----------------------------------------------------------------------------
     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/ie/unix/

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 recom-
mend 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.asp

============
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.

