----------------------------------
				README
		    Internet Explorer 5 for HP-UX
			    March 17, 1999
		  ----------------------------------
				   
	      Copyright (c) Microsoft Corporation, 1999
				   
The readme for your version of Internet Explorer for UNIX is named
readme.<PLATFORM>.txt, where PLATFORM refers to sun, hp, etc.

This document provides the information you need to get started and
late-breaking information to supplement the product documentation.

========
CONTENTS
========

SYSTEM REQUIREMENTS
SETUP
 Downloading Internet Explorer 5
 Installing Internet Explorer 5
 Uninstalling Internet Explorer 5
USER AGENT
AN ALTERNATIVE WAY TO ORGANIZE FAVORITES
USING JAVA
 Java Packaging via the IEAK
KNOWN ISSUES
 HP-UX Compatibility
 Outlook Express Issues
 Internet Explorer User Interface Issues
 Miscellaneous Issues
 IEAK Issues
 Performance
NTLM DOMAIN AUTHENTICATION
CUSTOM PACKAGING VIA THE IEAK
SUPPORT

===================
SYSTEM REQUIREMENTS
===================

To run Internet Explorer 5 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 (with the patches
  mentioned below)
* 64 MB of RAM (96 MB recommended) 
* 87 MB of hard-disk space to perform the installation

=====
SETUP
=====

Downloading Internet Explorer 5 
--------------------------------- 

You can download Internet Explorer 5 from the following HTTP and FTP
sites:

	http://www.microsoft.com/unix/ie/ie5
	ftp://ftp.microsoft.com/deskapps/ie/unix/hp/ie5

The file ie5setup is a self-extracting executable that contains all
the files you will need. 

Installing Internet Explorer 5
------------------------------

1) Change directory to where you downloaded the file ie5setup: 
   'cd <download directory>'
2) Make the downloaded file executable: 'chmod +x ie5setup'
3) Run the executable: './ie5setup'
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 performance may degrade.

Note: Installing to the default directory, /usr/local/microsoft, may
require root access.
				   
After Internet Explorer 5 is installed, you can start the browser by
running "<installation directory>/bin/iexplorer".  To start Outlook
Express from the command line, use - 
"<installation directory>/bin/oexpress".

Please do not install Internet Explorer 5 for HP-UX in the same
directory as any lesser version number of Internet Explorer for HP-UX
or Solaris. Moreover, please do not install an earlier version of
Internet Explorer for any platform in the same installation directory
as Internet Explorer 5 for HP-UX.
				   
Moving the installation directory after Internet Explorer 5 for
HP-UX has been installed is not supported.
 
Uninstalling Internet Explorer 5
--------------------------------

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 have installed other versions of Internet Explorer or
Outlook Express and you share home directories between systems, do not
remove the ".microsoft" directory, as it is shared between all UNIX
versions of both Internet Explorer and Outlook Express.

==========
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 5.0; HP-UX B.10.20 9000/780; X11)

   HP 9000 K-250, HP-UX 10.20:
      Mozilla/4.0 (compatible; MSIE 5.0; 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.


==========
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 have Internet
Explorer configured to run the JVM then a dialog will appear on any
page containing an applet reminding you that you are not currently
configured to run Java.

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, set the MS_JAVA_VM environment
variable to point directly to your JVM executable. For example:
   setenv MS_JAVA_VM /opt/java/jre/java

Alternatively, you can 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 "<JVM Install Dir>:$PATH"

NOTE: If you decide to add the JVM's directory to your path, please
make sure the JVM directory location occurs before references to
"/bin" or "/usr/bin" in your PATH environment variable.

After performing the above steps, Internet Explorer will launch HP's
applet viewer when Java Applets are encountered on web sites.

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
may 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. However, if the environment variable
MS_SHOW_JAVA_OUTPUT is set to TRUE (e.g. setenv MS_SHOW_JAVA_OUTPUT
TRUE), 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.

Java Packaging via the IEAK
---------------------------

The Runtime Environment for Java on Solaris can be included in your
Internet Explorer Administration Kit (IEAK) customized package.
Instructions to create the JRE package to redistribute via the IEAK
can be found by navigating to the following page:

     http://www.microsoft.com/unix/ie/ie5/jvm.htm.

When the runtime is packaged according to these instructions, it will
be installed to <install>/external/sunos5/ when the user runs the
custom Internet Explorer setup program.

============
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_16585 (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_15841 (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_15841 or PHSS_16585, for example).  If the
patch has been superceded, 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), built from the public
sources. 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).

Outlook Express Issues
----------------------

o Automatic disconnect

  Some IMAP4 servers are configured to disconnect OE after a preset amount of
  idle time.  When this happens, OE will report the server disconnection with
  a warning dialog.  To reconnect, click on another mail folder which will
  allow OE to automatically reconnect to the IMAP4 server.

o Upgrading from OE4 to OE5

  OE will automatically upgrade your OE4 settings the first time OE5 is
  run.  Any changes made to your OE4 configuration after the upgrade will
  not affect your OE5 configuration.

o Mail import from Unix files

  OE will create duplicate copies of any messages that are imported
  more than once.  To prevent any confusion during mail import, it is best
  to use an empty mail folder for import operations.

o Mail import from Netscape
  
  OE is not able to automatically import unsent mail from Netscape.

o Upgrading from OE5 Beta

  Upgrading from Beta versions of IE/OE is not supported.  If the previous
  version of OE is a beta version, be sure to install this version of OE
  into an empty directory tree to prevent any potential conflicts with the
  Beta pre-release software.

Internet Explorer User Interface Issues
---------------------------------------

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

o In the Associations tab of the Internet Options Menu, the command
  line field can not contain output redirection statements, e.g.
  cat %1>dev/audio.

o In the Programs tab of the Internet Options Menu, the script
  specified can not include command line arguments.

o Changes to the user style sheet (Internet Options, General tab,
  Accessibility) take effect once Internet Explorer is restarted.

o Experienced users of X11 can set color preferences using X resources
  with the class name "Iexplorer". For detailed information about
  these settings, see <installation directory>/ie/resources.txt.

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>/ie5/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 Using Internet Explorer with the Exceed X Server may produce
  undesirable interface side-effects.  For example, the accelerator
  keys or keyboard access to the address bar may not function.

o IE does not display properly under GrayScale or GreyStatic mode.

o When viewing a local file (for example, readme.hp.txt), the Internet
  Options item in the Tools menu is not displayed. ]

o When you enumerate a new fontcache through the Internet Options ->
  General -> Fonts dialog by clicking on "Find other Fonts", you must
  restart Internet Explorer after the enumeration has finished for 
  the changes to take effect.

Miscellaneous Issues
--------------------

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

o News URLs which contain a # character in the message ID will fail
  to open in the news viewer specified by the Internet Options Programs
  tab.

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 third party programs such as telnet, emacs, or vi
  in the View -> Internet Options -> Programs tab, please make sure
  the third party software is included in your PATH environment
  variable.

o If you manipulate or delete files in the .microsoft directory while
  the browser is running, it may hang.
  
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 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". Typical file suffixes are .wav, .au,
  and .snd.

o If an invalid name is given to the SOCKS proxy setting, Internet
  Explorer will bypass the proxy altogether.

o Internet Explorer may leave files in a temporary directory
  (/var/tmp, /tmp, or the directory pointed to by the $TMPDIR 
  variable). These files are not needed and may be safely deleted 
  whenever Internet Explorer is not running.

o The snews protocol is not recognized in links or the address bar.

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

o When downloading files, IE will sometimes append "(1)" to the first
  extension in the filename, replacing the remainder of the filename
  if it exists.  For example xxx.tar.Z would be renamed xxx.tar(1).

o When saving a file, Internet Explorer will only append the file
  extension which has been explicitly specified in the "File Name" 
  section of the Save As dialog. The file extension shown in the
  "Filter" section of the dialog does not have an effect on the 
  filename.

o Download may fail if the Temporary Internet Files cache doesn't have
  sufficient space to accommodate the downloaded file size.  You can
  change the amount of space allocated for Temporary Internet Files
  size from the Internet Options General tab.

o When saving a file, IE may not append the correct file extension to
  the filename suggested in the "Save As" dialog.  For example, .Z
  files may be saved as .z files, or the filename may have no
  extension at all.  Without this extension, IE will not reinterpret
  the file correctly upon reopening.  To work around this problem,
  ensure the appropriate extension is appended to the filename before
  saving.

o Internet Explorer 5 for UNIX supports most of the features and
  technologies of Internet Explorer for Windows, but also differs in
  some respects.  For example, Internet Explorer for UNIX does not
  support downloadable ActiveX controls or browsing and organizing
  your local files and folders within the browser window.  Other
  unsupported features include filters/transitions in CSS, the DHTML
  Editing component, and HTML Applications (HTAs).  These differences
  are noted in the comprehensive product documentation on Site Builder
  Workshop (http://www.microsoft.com/workshop).

o Internet Explorer for UNIX offers some features not found on the
  Windows version as well, such as Emacs-style keyboard shortcuts and
  external program associations.  For a complete list of the latest
  features in Internet Explorer 5 for UNIX, see the product home page
  at http://www.microsoft.com/unix/ie.

IEAK Issues
-----------

o Setup will not extract signed custom component CABs.

o A customized browser will not install to the same directory as a
  previously customized browser installation.

o Windows carriage returns must be removed from custom mail, news, and
  source viewer scripts added via the IEAK.
  Type 'dos2unix <scriptname>' at the UNIX prompt.

o Setting the size of the Temporary Internet Files cache or
  customizing toolbar buttons via an auto configuration script will
  not take effect until restart.

o If you are running IIS4 (NTOP4) or have a custom http 404 error file
  which exceeds 128 characters in length, some files needed for
  branding may not be downloaded correctly upon auto configuration.
  To work around this problem, extract the contents of config.cab to
  the same location as the .INS file or reduce the length of the 404
  error file returned by your web server.

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. 

========================== 
NTLM DOMAIN AUTHENTICATION
==========================

This release of Internet Explorer supports authenticating users
against web servers which are configured to do NTLM Challenge Response
Authentication. NTLM Domain Authentication allows you to access your
organization's secure Windows-NT IIS/BackOffice based Intranet
applications from your UNIX desktop.

=============================
CUSTOM PACKAGING VIA THE IEAK
=============================
The Internet Explorer Administration Kit (IEAK) allows administrators
to customize, configure, and restrict browser settings, lowering the
total cost of ownership to maintain a organization-wide installation
of Internet Explorer.  The IEAK is available for this release; see
http://ieak.microsoft.com for registration and download information.


=======
SUPPORT
=======

Microsoft sponsors a public peer-to-peer newsgroup named
"microsoft.public.inetexplorer.unix".  To access this newsgroup, use
Outlook Express to access the Microsoft public news server at
msnews.microsoft.com.

You may also use Microsoft's online Knowledge Base to obtain detailed
product information at http://support.microsoft.com.  The Knowledge
Base also contains late-breaking information and answers to frequently
asked customer questions, so check it often! To get information on
these products, specify Internet Explorer or Outlook Express in field
one and topic information in field two.