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