Installation

| Windows NT/2000 |

| Source distribution |

The Xerces-C++ source is available in the source distribution.

Install the Xerces-C++ source distribution by using `unzip` on the xerces-c-src2_3_0.zip archive in the Windows environment. You can use WinZip, or any other UnZip utility.

    unzip xerces-c-src2_3_0.zip

This creates a 'xerces-c-src2_3_0' sub-directory containing the Xerces-C++ source distribution.

If you need to build the Xerces-C++ source after installation, please follow the Build Instructions.

| Binary distribution |

Install the Xerces-C++ binary distribution by using `unzip` on the xerces-c2_3_0-win32.zip archive in the Windows environment. You can use WinZip, or any other UnZip utility.

    unzip xerces-c2_3_0-win32.zip

This creates a 'xerces-c2_3_0-win32' sub-directory containing the Xerces-C++ binary distribution.

You need to add the 'xerces-c2_3_0-win32\bin' directory to your path:

To do this under Windows NT, go to the start menu, click the settings menu and select control panel. When the control panel opens, double click on System and select the 'Environment' tab. Locate the PATH variable under system variables and add <full_path_to_xerces-c2_3_0>\bin to the PATH variable. To do this under Windows 2000 add this line to your AUTOEXEC.BAT file:

    SET PATH=<full_path_to_xerces-c2_3_0>\bin;%PATH%

or run the `SET PATH` command in your shell window.

Besides, if the parser is built with icu message loader (like IBM XML4C binaries), or message catalog loader, then you need to create a new environment variable, XERCESC_NLS_HOME to point to the directory, $XERCESCROOT/msg, where the message files reside.

    SET XERCESC_NLS_HOME=<full_path_to_xerces-c2_3_0>\msg

The binary distribution has the built parser library and some samples executables. Please refer to the Samples for how to run the samples.

| UNIX |

| Source distribution |

The Xerces-C++ source is available in the source distribution.

Install the Xerces-C++ source distribution xerces-c-src2_3_0.tar.gz by extracting the files from the compressed archive.

    gunzip xerces-c-src2_3_0.tar.gz
    tar xerces-c-src2_3_0.tar

This creates a 'xerces-c-src2_3_0' sub-directory containing the Xerces-C++ source distribution.

| On Solaris, please use `gtar` instead of tar. See FAQ for more information.

If you need to build the Xerces-C++ source after installation, please follow the Build Instructions.

| Binary distribution |

Install the binary distribution xerces-c2_3_0-xxx.tar.gz by extracting the files from the compressed archive; where 'xxx' is the corresponding UNIX platform. For example:

    gunzip xerces-c2_3_0-linux.tar.gz
    tar -xvf xerces-c2_3_0-linux.tar

This will create an 'xerces-c2_3_0-linux' sub-directory containing the Xerces-C++ binary distribution.

| On Solaris, please use `gtar` instead of tar. See FAQ for more information.

You will need to add the xerces-c2_3_0-linux/bin directory to your PATH environment variable:

For Bourne Shell, K Shell or Bash, type:

    export PATH="$PATH:$HOME/xerces-c2_3_0-linux/bin"

For C Shell, type:

    setenv PATH "$PATH:$HOME/xerces-c2_3_0-linux/bin"

If you wish to make this setting permanent, you need to change your profile by changing your setup files which can be either .profile or .kshrc.

In addition, you will also need to set the library search path. (LIBPATH on AIX, LD_LIBRARY_PATH on Solaris and Linux, SHLIB_PATH on HP-UX).

For Bourne Shell, K Shell or Bash, type:

    export LIBPATH=$XERCESCROOT/lib:$LIBPATH (on AIX)
    export LD_LIBRARY_PATH=$XERCESCROOT/lib:$LD_LIBRARY_PATH (on Solaris, Linux)
    export SHLIB_PATH=$XERCESCROOT/lib:$SHLIB_PATH (on HP-UX)

For C Shell, type:

    setenv LIBPATH "$XERCESCROOT/lib:$LIBPATH" (on AIX)
    setenv LD_LIBRARY_PATH "$XERCESCROOT/lib:$LD_LIBRARY_PATH" (on Solaris, Linux)
    setenv SHLIB_PATH "$XERCESCROOT/lib:$SHLIB_PATH" (on HP-UX)

Besides, if the parser is built with icu message loader (like IBM XML4C binaries), or message catalog loader, then you need to create a new environment variable, XERCESC_NLS_HOME to point to the directory, $XERCESCROOT/msg, where the message files reside.

    export XERCESC_NLS_HOME=$XERCESCROOT/msg
    or
    setenv XERCESC_NLS_HOME=$XERCESCROOT/msg

The binary distribution has the built parser library and some samples executables. Please refer to the Samples for how to run the samples.

| Cygwin |

| Source distribution |

The Xerces-C++ source is available in the source distribution.

Install the Xerces-C++ source distribution xerces-c-src2_3_0.tar.gz by extracting the files from the compressed archive.

    tar -xvzf xerces-c-src2_3_0.tar.gz

This creates a 'xerces-c-src2_3_0' sub-directory containing the Xerces-C++ source distribution.

If you need to build the Xerces-C++ source after installation, please follow the Build Instructions.

| Binary distribution |

Install the binary distribution by running Cygwin setup.exe. When you reach the "Packages" step of the Cygwin Setup wizard, expand the "Devel" category, then click in the "New" column next to "xerces-c-devel" until it reads "2.3.0-X".

This will install the necessary libraries and include files for the Xerces-C++ binary distribution.

If you wish to run programs linked to Xerces-C++ that were built in the Cygwin environment, you need to add your Cygwin "bin" directory to your Windows PATH environment variable. In typical Cygwin installations, the bin directory is in the Cygwin directory on the drive that windows is installed on. For instance, if windows is installed to C:\WINNT\System32, Your Cygwin bin directory may be "C:\cygwin\bin".

The binary distribution has the built parser library. Sample executables may be available in a future release on the Cygwin platform. In the meantime, they may be built from the source distribution by following the Build Instructions for "Building samples".

Copyright © 2003 The Apache Software Foundation. All Rights Reserved.