File Name: dsa_installable_readme.txt
******************************************************************
|                                                                |
|   IBM(R) Dynamic System Analysis (DSA) Installable Edition,    |
|   Version 1.20.40                                              |
|                                                                |
|   (C) Copyright International Business Machines Corporation    |
|       2004, 2005. All rights reserved.                         |
|                                                                |
|   US Government Users Restricted Rights -- Use, duplication    |
|   or disclosure restricted by GSA ADP Schedule Contract with   |
|   IBM Corp.                                                    |
|                                                                |
|   Note: Before using this information and the product it       |
|         supports, read the general information under           |
|         "NOTICES" in this document.                            |
|                                                                |
|   This readme file is provided only in English. You can        |
|   obtain the latest version of the readme file from the IBM    |
|   Support Web site.                                            |
|                                                                |
|   Updated 16 August 2005                                       |
******************************************************************

CONTENTS
--------

1.0  Overview
  1.1  Product overview
  1.2  Operating-system support
  1.3  Server support
  1.4  Other prerequisites for systems running Windows
  1.5  Compatibility with ServeRAID Manager
  1.6  Compatibility with Network Virtual Teaming software
  1.7  Compatibility with UpdateXpress

2.0  Change history
 
3.0  Installing Dynamic System Analysis
   3.1  Performing an attended DSA installation  
   3.2  Performing an unattended DSA installation
   3.3  Installing DSA using Remote Deployment Manager (RDM)

4.0  Uninstalling Dynamic System Analysis

5.0  Running Dynamic System Analysis 
  5.1  Running DSA from the Start menu    
  5.2  Running DSA from a command prompt
  5.3  Running DSA from IBM Director Console 

6.0  Using DSA command-line options
  6.1  Sending DSA output to IBM xSeries Service and Support
  6.2  Using DSA with UpdateXpress

7.0  Accessing and viewing DSA output
  7.1  Naming convention used for output files and directories
  7.2  Viewing a compressed collection file
  7.3  HTML files created by DSA

8.0  Known problems and workarounds

9.0  Support Web sites

10.0  Notices

11.0 Third-party license terms and conditions, notices and 
     information
  11.1 zlib software
  11.2 boost software


1.0  OVERVIEW
-------------

This readme file provides information about IBM Dynamic System
Analysis (DSA) Installable Edition, version 1.20.


1.1  Product overview
---------------------

IBM DSA Installable Edition is a system information collection and
analysis tool that is used by IBM xSeries(R) Service and Support
personnel to aid in the diagnosis of system problems. This
software can be used while the operating system is running.

DSA collects information about the following aspects of a system:

o  System configuration
o  Installed packages
o  Kernel Modules
o  Network interfaces and settings
o  Performance data and details for running processes
o  Hardware inventory, including PCI information
o  Vital product data, firmware, and basic input/output system
   (BIOS) information
o  Drive Health Information
o  ServeRAID configuration
o  Event logs for the operating system, ServeRAID controllers, 
   and service processors

Additionally, DSA creates a merged log that includes events from
all collected logs. DSA also can compare the firmware configurations 
on a server to those on an UpdateXpress CD or CD image.  

For more information, see "6.2 Using DSA with UpdateXpress."

The system information is collected into a compressed XML file
that can be sent to IBM Service. Additionally, you can view the
system information through optionally generated HTML Web pages.
For more information, see "7.0 ACCESSING AND VIEWING DSA OUTPUT." 

If you want to run DSA without installing it, use DSA Portable
Edition, which is designed to fit on removable media such
as a CD or USB key.


1.2  Operating-system support
-----------------------------

DSA 1.20 is supported on the following 32-bit Linux operating systems:

o  Red Hat(TM) Enterprise Linux 3 (Updates 1-5), AS, ES, & WS 

o  SUSE Linux Enterprise Server 9 (Base Level, SP 1, SP 2)

Note: There are unique DSA executables for each of the supported 
Linux distributions. The SLES 9 version of DSA is not compatible with 
RHEL 3, and vice versa.  Verify that the correct DSA executables have 
been obtained before running DSA. 

1.3  Server support
-------------------

DSA is supported on the following xSeries(R) servers:

x205  (8480)
x206  (8482)
x206  (8487)
x225  (8647)
x225  (8649)
x226  (8648)
x226  (8488)
x235  (8671)
x236  (8841)
x255  (8685)
x260  (8865)
x305  (8673)
x306  (8836)
x306  (8489)
x335  (8676)
x336  (8837)
x345  (8670)
x346  (8840)
x360  (8686)
x365  (8861)
x365  (8862)
x366  (8863)
x366  (8874)
x440  (8687)
x445  (8870)
x460  (8872) (Single Node)


DSA is also supported on the following eServer(TM)
products:

e325 (8835)
e326 (8836)
e326 (8848)
BladeCenter(TM)(HS20) (8678)
BladeCenter(HS20) (8832)
BladeCenter(HS20) (8843)
BladeCenter(HS40) (8839)
BladeCenter(LS20) (8850)

 

In addition, DSA is supported on the following IntelliStation 
systems:

A10 (6224)
A10 (6217)
Z20 (6223)
Z20 (6227)
M20 (6220)
M20 (6230)
M30 (6225)
M30 (6228)

1.4  Other prerequisites for systems running Linux
----------------------------------------------------

Installation of DSA requires 15MB of disk space.

DSA requires 50 to 100MB of available memory during the data collection
process.  The amount of memory required for this process depends on the 
size of the logs being collected from the system.

To view the information that is collected by DSA, you must use
either Internet Explorer 6.0 (Service Pack 1 or later) or Mozilla 1.40 
or later. Either browser requires 30 to 100MB of available memory to 
display DSA data. The amount of memory required depends on the size of 
the logs being viewed. 

In order to collect Broadcom(TM) Ethernet firmware levels, the Broadcom(TM)
NetXtreme Gigabit Ethernet Drivers must be installed.  The tg3 driver provided
by default in current Linux distributions does not export this information.
These drivers are available for download from the IBM Support
website at: http://www.ibm.com/support

In order to collect LSI Logic(TM) 1020/1030 SCSI Controller & RAID information,
the "mptctl" driver must be loaded.  Run "lsmod" and verify that "mptctl"
is loaded before running DSA.

In order to collect Service Processor logs, configuration, and 
environmental data the appropriate Service Processor driver must be
installed.  These drivers are available from the IBM Support website.

DSA requires libcurl to be installed in order transfer data collections
to the IBM Support site via FTP.

Use of the UpdateXpress comparison analysis feature requires that
an UpdateXpress CD be available for the system on which the analysis
is performed. UpdateXpress versions 4.01 and later are supported.

Notes: 

o  The UpdateXpress comparison analysis feature will only support 
   System Firmware comparisons including BIOS, Diagnostics, and 
   Service Processor. Device drivers will not be compared in this 
   release, due to limitations with the UpdateXpress CD.


1.5  Compatibility with ServeRAID Manager
----------------------------------------- 

DSA Installable Edition 1.20 can collect ServeRAID log information
from ServeRAID Manager 6.10 and later versions.

DSA cannot collect information from the following ServeRAID
controllers:

o  ServeRAID-7t SATA RAID
o  ServeRAID-7e (Adaptec HostRAID)
o  ServeRAID-7k
o  ServeRAID 8i Serial Attached SCSI (SAS) Controller


1.6  Compatibility with Network Virtual Teaming software
----------------------------------------- 

DSA Portable Edition 1.20 is supported for use with
the following Network Virtual Teaming software:

o  Linux Bonding versions 2.4.1, 2.6.0, & 2.6.1


1.7  Compatibility with UpdateXpress
------------------------------------ 

DSA Installable Edition 1.20 is supported for use 
with UpdateXpress 4.01 and later versions.


2.0  CHANGE HISTORY
-------------------

This section provides information about product updates and features.


2.1 Dynamic System Analysis 1.20 
---------------------------------

o  Support for 32-bit Linux distributions.
 

2.2  Dynamic System Analysis 1.10
-------------------------------

o  Added data collection capabilities for service processor TCP/IP
   configuration, service processor dial-up configuration, service 
   processor status, video adapter, and display settings.

o  Created additional ways to view collected information.

o  Added BladeCenter data collection capabilities for:
   -  Broadcom Virtual Teaming Software support and information
   -  Intel PROSet support and information
   -  IDE drive SMART data
   -  Onboard LSI RAID controller data

o  Improved support for ServeRAID 6 and earlier ServeRAID systems.

o  Implemented optional full system event log retrieval for ISMP and 
   IPMI systems.
   
o  Increased number and type of systems supported.

o  Improved usability of HTML output from DSA.


2.3  Dynamic System Analysis 1.02
-------------------------------

DSA, Version 1.02 included the following changes:

o  Fixed an issue that prevented IPMI event log data collection in 
   DSA 1.01 on machines with IPMI BMC implementations.

   Affected systems will have this message in the DSA Error log:
     Error: Plugin IPMISEL threw exception fdrStatusInvalidDateTime


2.4  Dynamic System Analysis 1.01
-------------------------------

DSA, Version 1.01 included the following changes:

o  Fixed an issue that would cause the HTML generation to fail in 
   version 1.0 when the /v option is used in conjunction with the 
   /i option.

   The following error message was reported by the tool: 
     ERROR: PopulateContainerFromFile returned exception code 
     fdrStatusInvalidDateTime.


2.5  Dynamic System Analysis 1.00
-------------------------------

First release.


3.0  INSTALLING DYNAMIC SYSTEM ANALYSIS 
---------------------------------------

DSA Installable Edition is installed on one or more supported
servers. 

3.1  Performing a DSA installation
--------------------------------------------

Complete the following steps to perform a installation
of DSA Installable Edition on a system running Linux. These
steps are for a typical installation.

Note: The operating-system account that is used to install DSA
must have local Administrator authority.

1.  Download the DSA Installable Edition rpm file.

2.  Install the DSA Installable Edition rpm for RHEL3 using the 
    following commandline:

       rpm -ivh dsa-rhel-1.20-1.rpm 

3.  The install will proceed and place the package in the /opt/IBM/DSA
    directory.

4.0  UNINSTALLING DYNAMIC SYSTEM ANALYSIS
-----------------------------------------

Complete the following steps to perform an uninstallation of DSA.

1.  Open a linux command shell. 

2.  Uninstall the DSA Installable Edition rpm for SLES9 using the 
    following commandline:

        rpm -e dsa-sles-1.20-1

3.  The uninstall will proceed and remove the package from the 
   /opt/IBM/DSA directory.


5.0  RUNNING DYNAMIC SYSTEM ANALYSIS 
------------------------------------

DSA Installable Edition can be run from a linux shell prompt.

5.1  Running DSA from Linux
--------------------------------------

The DSA executable file is collectall. It is installed in the following 
directory: 

/opt/IBM/DSA

Complete the following steps to run DSA from a linux shell:
 

1. Change to the /opt/IBM/DSA directory.

2. Type ./collectall

3. (Optional) Type DSA command-line options after the executable
   file name. For more information, see "6.0 USING DSA COMMAND-LINE 
   OPTIONS."

DSA will begin collection. When DSA is completed, collectall exists. 
For information about the DSA results, see "7.0 ACCESSING AND VIEWING
DSA OUTPUT." 

If you ran DSA without any options, DSA collects information into
one compressed XML file that can be sent to IBM Service. For
information about sending the file to IBM Service, see "6.1
Sending DSA output to IBM Service and Support." 

6.0  USING DSA COMMAND-LINE OPTIONS
-----------------------------------

The command-line syntax in this document uses the following
conventions:

o  Options are shown with a hyphen (-).
o  Options are shown as lowercase, but are not case-sensitive.
o  Variables are shown in angle brackets.

DSA has the following command-line options:
   
   
-?   Display help for DSA command-line options.
-h   Display help for DSA command-line options.
-b   Run in batch mode.
-c   Create the directory specified by the -d option,
     if it doesn't already exist.
-d <directory> Place DSA output files in the specified directory
     rather than in the default location, which is
     the /var/log/IBM_Support directory. If not specified with
     -c, the directory must already exist or the
     command-line client exits with an error message.
-f   Retrieve the full ISMP log if present. If the machine 
     does not have an ISMP service processor, this option 
     is ignored.  You must stop the IBM Director service 
     (twgipc) to collect ISMP logs from a system with an 
     ISMP service processor and IBM Director installed.
-i <file> Read input from <file> rather than collecting data
     from the local server. If the file does not exist, 
     the command-line client exits with an error message.
-t   Transfer collected data to IBM Service and Support.
-u <directory> Specify location of UpdateXpress CD or CD Image 
     for use with the UpdateXpress Firmware Analysis plugin. 
-v   Create HTML output files.
-text Create an ASCII Text output file. 
-x   Do not create a compressed XML file.
 
All options must be separated with one or more spaces. You must 
use a fully-qualified path name with the -d and -i options.

For example, to run DSA and generate HTML output files that can be
viewed with a browser:
 
 ./collectall -v 

To run DSA, and create HTML output files in the directory 
/usr/foo/DSA_Output, run this command:

 ./collectall -v -c -d /usr/foo/DSA_Output

DSA has the following environment variable options:
   
DSA_INCLUDE <plugin1, plugin2>

where <plugin1, plugin2> is a space, comma, or semi-colon separated 
list of plugins to include when collectall is run. The basename of the 
plugin is used.  

DSA_EXCLUDE <plugin1, plugin2>

where <plugin1, plugin2> is a space, comma, or semi-colon separated 
list of plugins to exclude when collectall is run. The basename of 
the plugin is used.  

Note: DSA_INCLUDE and DSA_EXCLUDE are mutually exclusive.


6.1  Sending DSA output to IBM xSeries Service and Support 
----------------------------------------------------------

Use the -t option to send the collected data to IBM xSeries
Service and Support. DSA uses File Transfer Protocol (FTP) to
transfer the compressed XML output file to IBM Service.

For example, the following command collects data and sends it to
IBM Service:

./collectall.exe -t

If you already have a compressed XML output file from DSA that you
want to send to IBM Service, run DSA from a command prompt and
use the /i option with the /t option. The /i option requires that
you specify a fully qualified path name to the compressed XML
output file from DSA.

For example, the following command sends the specified output
file to IBM Service:

./collectall.exe -t -i /var/log/IBM_Support/<output file>.xml.gz

where <output_file> is the name of a compressed XML file that was
previously created by DSA. For example, an output file could be
named 86865RZ_23D0600_20041004-190308.xml.gz.

6.2  Using DSA with UpdateXpress
--------------------------------

Use the -u option to designate a fully qualified path to an
UpdateXpress CD or CD image. When you do so, DSA compares the
device driver and firmware configurations on the server to those
that were extracted from the specified UpdateXpress CD or CD
image.

When the -v option is used to create HTML files, you can view the
results of the comparison from the DSA home page. To do so, click
"UpdateXpress Comparison" in the Analysis category in the left
pane of the DSA home page. For more information about the DSA home
page, see "7.3 HTML files created by DSA."


7.0  ACCESSING AND VIEWING DSA OUTPUT
-------------------------------------

By default, DSA output is created in the /var/log/IBM_Support 
directory. Use the -d option to specify a different output directory.

When DSA is run from a command prompt with no command-line
options, it creates only a compressed XML file in the IBM_Support
directory. 

When DSA is run with the -v option, it creates a subdirectory that  
contains HTML files that you can view with a Web browser.


7.1  Naming convention used for output files and directories
------------------------------------------------------------

DSA uses the following naming convention for compressed XML files
and for subdirectories that it creates:

<machine_type_model>_<serial_no>_<date>-<time>

where

o  <machine_type_model> is the machine type and model number of
   the server.
o  <serial_no> is the serial number of the server.
o  <date> is the date that DSA collected information.
o  <time> is the hour, minute, and seconds that DSA was run.

For example, on an xSeries 360 system, DSA could create a
a compressed XML file that has the following name:

86865RZ_23D0600_20041007-191612.xml.gz 

If DSA cannot obtain a valid machine type and model number or 
serial number of a system, any resultant output file and
subdirectory will use the string "Unknown" in place of these
values.


7.2  Viewing a compressed collection file
-----------------------------------------

If you have a compressed XML file that was created by DSA, you can
run DSA again to generate HTML files from that compressed XML
file. Then, you can view the HTML files with a Web browser. To
generate HTML files from a compressed XML file, run the following
command:

./collectall -i <path>/<output_file>.xml.gz -x -v

where

o  <path> is the fully qualified path to the compressed XML file
   that was previously created by DSA.
o  <output_file> is the name of the compressed XML file.


7.3  HTML files created by DSA
------------------------------

When DSA is run with the -v option a subdirectory is created that
contains several HTML files, which list the results of the DSA
data collection.

The top-level DSA HTML page is index.html. This Web page is
referred to as the DSA home page in this readme file. The DSA
home page contains links to the other HTML files that are created
by DSA.

To view the DSA home page when you run DSA from the Start menu or
from a command prompt, open the index.html file in your Web
browser.

The DSA home page organizes collected information into various
categories that you can access by clicking a subcategory name
in the left pane of the Web page. For example, to view information
about the network settings on a server, click "Network Settings"
in the Software category in the left pane of the DSA home page.


8.0  KNOWN PROBLEMS AND WORKAROUNDS
-----------------------------------

DSA Installable Edition has the following known problems
and workarounds:

o  During normal DSA operation, entries will be written to the system
   messages log (/var/log/messages).  By default, these messages are 
   also written to the root console of the system.  This is a normal 
   side-effect of DSA operation and the messages, including any errors, 
   can safely be ignored.

o  DSA does not collect environmental information from the 
   standard service processors on IntelliStation systems or the 
   following xSeries servers:

   x200 (8479)   x226 (8648)
   x200 (8481)   x226 (8488)
   x205 (8480)   x236 (8841)
   x206 (8482)   x300 (8672)
   x220 (8646)   x305 (8673)
   x225 (8647)   x306 (8836)
   x225 (8649)   x306 (8489)
   
o  On systems with IPMI BMC subsystems and an ASM adapter installed, 
   DSA may report the following message in the critical details section:
   
   The IPMI drivers are not present.
   
   This message can be disregarded when an ASM adapter and associated 
   device drivers are installed on the system.

o  On systems with PCI Express slots, The type of slot may be listed as 
   "Other". These slots will not be associated with the appropriate PCI 
   device that may be in the PCI Express slot.

o  Certain, rare conditions on the SCSI bus may temporarily prevent DSA 
   from collecting sense data from SCSI-attached tape devices.  In the event 
   that this data is not collected on a machine with a SCSI-attached tape 
   device, it is recommended that DSA be run again to collect the data.  
   
o  When DSA collects dates and times that are before 
   January 1, 1970, 00:00:00, or after January 19, 2038, 03:14:07; 
   DSA will report these dates and times as January 1, 1970, 00:00:00.  
   These dates fall outside the valid range for a date in DSA.

o  DSA cannot collect SMART data from SATA disk drives that are using 
   the Linux libata drivers.  This is due to limitations of the 
   libata driver.

o  DSA may report the memory speed as "Unknown" in the Memory section 
   of the Hardware Information report.  This is due to issues with 
   SMBIOS support on some systems.

o  For the xSeries 460 system, DSA is supported only on single node 
   configurations due to limitations in the current Linux distributions.
   
o  For the IntelliStation M20 (6220 and 6230) an extra blank line is 
   returned in the System BIOS table of the Firmware/VPD report.

o  For the xSeries 236 system, only slots 1 & 2 are reported in the PCI 
   Information report due to an issue with the x236 SMBIOS support.  
   Slots 3 - 6 will not displayed. 

o  For the xSeries 225 system, the PCI Information report may misrepresent 
   which slot a PCI device is in due to an SMBIOS issue.  Specifically, 
   a device in PCI slot 2 will appear as being in slot 6 and devices in 
   slots 4 - 6 will not have a slot association.

o  For the xSeries 226 system, the Firmware/VPD report may erroneously 
   report that there is an RSA card installed.  This is due to an issue 
   with the SMBIOS support.

o  The Merged Devices report will not be available on 
   Red Hat(TM) Enterprise Linux 3 due to operating system limitations.

o  The ServeRAID report may report the number of Logical Drivers as 1, 
   while ServeRAID Manager reports the number of Logical Drives as 0.  
   This is due to an issue with the tool used by DSA to collect this data.

o  IBM Director integration will not be available in this release of DSA.


9.0  SUPPORT WEB SITES
----------------------

The following Web pages provide resources for understanding, 
using, and troubleshooting systems-management tools:

o  IBM support page
   http://www.ibm.com/pc/support/

   This is the IBM Support Web site for IBM hardware and systems-
   management software. For systems-management software support, 
   click "Systems management". 

o  IBM Dynamic System Analysis page
   http://www.ibm.com/servers/eserver/xseries/systems_management/
   dsa.html

   This Web page presents an overview of Dynamic System Analysis
   and links to download the product and readme files.

o  IBM xSeries(R) Systems Management page
   http://www.ibm.com/pc/ww/eserver/xseries/systems_management/
   index.html

   This Web page presents an overview of IBM systems management 
   and IBM Director. Click "IBM Director" for the latest 
   information and documentation. It also contains links to Web 
   pages for IBM Director extensions, including Remote Deployment 
   Manager, Scalable Systems Manager, Virtual Machine Manager,
   Server Plus Pack, and Software Distribution (Premium Edition).

o  IBM ServerProven(R) page
   http://www.ibm.com/pc/us/compat/index.html

   This Web page provides information about IBM hardware
   compatibility with IBM systems-management software. 

o  Electronic Service Agent compliments your DSA tool by providing
   24x7 pro-active monitoring of IBM eServers.

   For more information on Electronic Service Agent go to
   http://www.ibm.com/support/electronic/serviceagent


10.0  NOTICES
-------------

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS
PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR
PURPOSE. Some jurisdictions do not allow disclaimer of express or
implied warranties in certain transactions, therefore, this
statement may not apply to you.

This information could include technical inaccuracies or
typographical errors. Changes are periodically made to the
information herein; these changes will be incorporated in new
editions of the publication. IBM may make improvements and/or
changes in the product(s) and/or the program(s) described in this
publication at any time without notice.

The following terms are trademarks of the IBM Corporation in the
United States, other countries, or both:
   
BladeCenter
e-business logo
eServer
IBM
IntelliStation
ServerProven
xSeries

Linux is a trademark of Linus Torvalds in the United States, other 
countries, or both. 

Microsoft and Windows are trademarks of Microsoft 
Corporation in the United States, other countries, or both.

Red Hat, the Red Hat “Shadow Man” logo, and all Red Hat-based trademarks
and logos are trademarks or registered trademarks of Red Hat, Inc., in
the United States and other countries.

Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, 
Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and 
Pentium are trademarks or registered trademarks of Intel Corporation or its 
subsidiaries in the United States and other countries.

Other company, product, or service names may be trademarks or
service marks of others.


11. THIRD-PARTY LICENSE TERMS AND CONDITIONS, NOTICES AND
    INFORMATION
---------------------------------------------------------

The license agreement for this product refers you to this file for
details concerning terms and conditions applicable to third party
software code included in this product, and for certain notices
and other information IBM must provide to you under its license
to certain software code. The relevant terms and conditions,
notices and other information are provided or referenced below. 
Please note that any non-English version of the licenses below is
unofficial and is provided to you for your convenience only.  The
English version of the licenses below, provided as part of the
English version of this file, is the official version.

Notwithstanding the terms and conditions of any other agreement
you may have with IBM or any of its related or affiliated entities
(collectively "IBM"), the third party software code identified
below are "Excluded Components" and are subject to the following
terms and conditions:

o  the Excluded Components are provided on an "AS IS" basis

o  IBM DISCLAIMS ANY AND ALL EXPRESS AND IMPLIED WARRANTIES AND
   CONDITIONS WITH RESPECT TO THE EXCLUDED COMPONENTS, INCLUDING,
   BUT NOT LIMITED TO, THE WARRANTY OF NON-INFRINGEMENT OR
   INTERFERENCE AND THE IMPLIED WARRANTIES AND CONDITIONS OF
   MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE

o  IBM will not be liable to you or indemnify you for any claims
   related to the Excluded Components

o  IBM will not be liable for any direct, indirect, incidental,
   special, exemplary, punitive or consequential damages with
   respect to the Excluded Components.


11.1 zlib software
------------------

ZLIB: The Program includes zlib software, and the following
notice(s) are required by the license under which IBM acquired
this software. (Copyright notices which varied only by the years
of copyright are omitted for brevity.)

Copyright notice:

zlib.h -- interface of the 'zlib' general purpose compression
library version 1.2.1, November 17th, 2003

Copyright (C) 1995-2003 Jean-loup Gailly and Mark Adler

This software is provided 'as-is', without any express or implied
warranty.  In no event will the authors be held liable for any
damages arising from the use of this software.

Permission is granted to anyone to use this software for any
purpose, including commercial applications, and to alter it and
redistribute it freely, subject to the following restrictions:

1. The origin of this software must not be misrepresented; you
   must not claim that you wrote the original software. If you use
   this software in a product, an acknowledgment in the product
   documentation would be appreciated but is not required.

2. Altered source versions must be plainly marked as such, and
   must not be misrepresented as being the original software.

3. This notice may not be removed or altered from any source
   distribution.

Jean-loup Gailly        Mark Adler
jloup@gzip.org          madler@alumni.caltech.edu


11.2 boost software
-------------------

BOOST: The Program includes Boost software, and the following
notice(s) are required by the license under which IBM acquired
this software. (Copyright notices which varied only by the years
of copyright are omitted for brevity.)

Boost Software License - Version 1.0 - August 17th, 2003

Permission is hereby granted, free of charge, to any person or
organization obtaining a copy of the software and accompanying
documentation covered by this license (the "Software") to use,
reproduce, display, distribute, execute, and transmit the
Software, and to prepare derivative works of the Software, and to
permit third-parties to whom the Software is furnished to do so,
all subject to the following:

The copyright notices in the Software and this entire statement,
including the above license grant, this restriction and the
following disclaimer, must be included in all copies of the
Software, in whole or in part, and all derivative works of the
Software, unless such copies or derivative works are solely in the
form of machine-executable object code generated by a source
language processor.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND
NON-INFRINGEMENT. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR
ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE FOR ANY DAMAGES OR
OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.

(C) Samuel Krempp 2001, 2003   krempp@crans.ens-cachan.fr

Permission to copy, use, modify, sell and distribute this software
is granted provided this copyright notice appears in all copies.
This software is provided "as is" without express or implied
warranty, and with no claim as to its suitability for any purpose.

(C) Copyright Jeremy Siek 2001.
Copyright (c)  2000 David Abrahams. 
Copyright (c) 1994
Hewlett-Packard Company
 
Permission to use, copy, modify, distribute and sell this software
and its documentation for any purpose is hereby granted without
fee, provided that the above copyright notice appear in all copies
and that both that copyright notice and this permission notice
appear in supporting documentation.  Hewlett-Packard Company makes
no representations about the suitability of this software for any
purpose.  It is provided "as is" without express or implied
warranty. 
 
Copyright (c) 1996-1998 Silicon Graphics Computer Systems, Inc.
 
Permission to use, copy, modify, distribute and sell this software
and its documentation for any purpose is hereby granted without
fee, provided that the above copyright notice appear in all copies
and that both that copyright notice and this permission notice
appear in supporting documentation.  Silicon Graphics makes no
representations about the suitability of this software for any
purpose.  It is provided "as is" without express or implied
warranty.

Copyright (c) 1997 - 1998 Silicon Graphics Computer Systems, Inc.
Copyright (c) Jeremy Siek 2001, Marc Wintermantel 2002
 
Permission to use, copy, modify, distribute and sell this software
and its documentation for any purpose is hereby granted without
fee, provided that the above copyright notice appear in all copies
and that both that copyright notice and this permission notice
appear in supporting documentation.  Silicon Graphics makes no
representations about the suitability of this software for any
purpose.  It is provided "as is" without express or implied
warranty.

Copyright (C) 2001-2003 Doug Gregor 

Permission to use, copy, modify, distribute and sell this software
and its documentation for any purpose is hereby granted without
fee, provided that the above copyright notice appears in all
copies and that both the copyright notice and this permission
notice appear in supporting documentation. No representations are
made about the suitability of this software for any purpose. It is
provided "as is" without express or implied warranty.

Copyright (c) 2000 Cadenza New Zealand Ltd

Permission to use, copy, modify, distribute and sell this software
and its documentation for any purpose is hereby granted without
fee, provided that the above copyright notice appears in all
copies and that both the copyright notice and this permission
notice appear in supporting documentation.  Cadenza New Zealand
Ltd makes no representations about the suitability of this
software for any purpose.  It is provided "as is" without express
or implied warranty.

Copyright Jens Maurer 2000

Permission to use, copy, modify, sell, and distribute this
software is hereby granted without fee provided that the above
copyright notice appears in all copies and that both that
copyright notice and this permission notice appear in supporting
documentation,
 
Jens Maurer makes no representations about the suitability of this
software for any purpose. It is provided "as is" without express
or implied warranty.

Adaptable closures

Phoenix V0.9
Copyright (c) 2001-2002 Joel de Guzman

This software is provided 'as-is', without any express or implied
warranty. In no event will the copyright holder be held liable for
any damages arising from the use of this software.

Permission is granted to anyone to use this software for any
purpose, including commercial applications, and to alter it and
redistribute it freely, subject to the following restrictions:

1.  The origin of this software must not be misrepresented; you
    must not claim that you wrote the original software. If you
    use this software in a product, an acknowledgment in the
    product documentation would be appreciated but is not
    required.

2.  Altered source versions must be plainly marked as such, and
    must not be misrepresented as being the original software.

3.  This notice may not be removed or altered from any source
    distribution.

URL: http://spirit.sourceforge.net/

Copyright Jens Maurer 2000
Copyright Maarten Keijzer 2000
Copyright Herv? Br?nnimann, Guillaume Melquiond, Sylvain Pion  
   2002 - 2003

Permission to use, copy, modify, sell, and distribute this
software is hereby granted without fee provided that the above
copyright notice appears in all copies and that both that
copyright notice and this permission notice appear in supporting
documentation,

None of the above authors nor Polytechnic University make any
representation about the suitability of this software for any
purpose. It is provided "as is" without express or implied
warranty.

Copyright (C) 2000, 2001 Stephen Cleary

This file can be redistributed and/or modified under the terms
found in "copyright.html". This software and its documentation is
provided "as is" without express or implied warranty, and with no
claim as to its suitability for any purpose.

See http://www.boost.org for updates, documentation, and revision
history.

boost/python/detail/python22_fixed.h

Copyright (c) 2001, 2002 Python Software Foundation; All Rights
   Reserved

Copyright (c) 1998-2002 Dr John Maddock
Copyright (c) 2003 Doug Gregor
 
Permission to use, copy, modify, distribute and sell this software
and its documentation for any purpose is hereby granted without
fee, provided that the above copyright notice appear in all copies
and that both that copyright notice and this permission notice
appear in supporting documentation.  Dr John Maddock makes no
representations about the suitability of this software for any
purpose. It is provided "as is" without express or implied
warranty.

Copyright (C) 2001-2003 William E. Kempf

Permission to use, copy, modify, distribute and sell this software
and its documentation for any purpose is hereby granted without
fee, provided that the above copyright notice appear in all copies
and that both that copyright notice and this permission notice
appear in supporting documentation.  William E. Kempf makes no
representations about the suitability of this software for any
purpose. It is provided "as is" without express or implied
warranty.

boost/thread/detail/force_cast.hpp
boost/thread/detail/singleton.hpp

Copyright (C) 2001 Mac Murrett

Permission to use, copy, modify, distribute and sell this software
and its documentation for any purpose is hereby granted without
fee, provided that the above copyright notice appear in all copies
and that both that copyright notice and this permission notice
appear in supporting documentation.  Mac Murrett makes no
representations about the suitability of this software for any
purpose.  It is provided "as is" without express or implied
warranty.


11.3 linux real mode interface software
---------------------------------------

LINUX REAL MODE INTERFACE: The Program includes Linux Real Mode Interface 
software, and the following notice(s) are required by the license under which 
IBM acquired this software. (Copyright notices which varied only by the years 
of copyright are omitted for brevity.)

Linux Real Mode Interface - A library of DPMI-like functions for Linux.

Copyright (C) 1998 by Josh Vanderhoof

Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL JOSH VANDERHOOF BE LIABLE FOR ANY CLAIM, DAMAGES OR
OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.