2. Install

2.1. Installing the XMLmind Validation Toolset

2.1.1. Requirements

  • Sun or Apple Java™ runtime 1.4.1 and above.

  • At least 128Mb of memory and a 400MHz CPU.

  • 10Mb of free disk space.

The tools included in the distribution have been tested with:

  • Sun Java runtime 1.4.1+ (up to 1.6.0-beta2) under Windows NT4, 2000, XP Home, XP Professional (up to SP2), SuSE Linux 9.0 and 9.3.

  • Mac OS X 10.3.9 and Java™ 1.4.2_09, Mac OS X 10.4.8 and Java™ 1.5.0_06.

2.1.2. Install on Unix

Procedure:

  1. Make sure that the Javabin/ directory is referenced in the $PATH and, at the same time, check that the Java™ runtime in the $PATH has the right version:

    $ java -version
    java version "1.5.0_04"
    Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_04-b05)
    Java HotSpot(TM) Client VM (build 1.5.0_04-b05, mixed mode, sharing)
  2. Unpack the distribution somewhere.

    $ cd 
    $ tar zxvf xvalid-3_6_0.tar.gz
    $ ls xvalid-3_6_0
    bin/
    doc/
  3. The tools are intended to be used directly from the xvalid-3_6_0/ directory. That is, you can add xvalid-3_6_0/bin/ to your $PATH.

    $ xvalid-3_6_0/bin/xsdvalid -s my_w3c_xml_schema.xsd

2.1.3. Install on Windows

Manual install on Windows is similar to the install on Unix. Simply run xvalid-3_6_0\bin\xsdvalid.bat, dtdvalid.bat, rngvalid.bat, schvalid.bat rather than the xvalid-3_6_0/bin/xsdvalid, dtdvalid, rngvalid, schvalid shell scripts.

2.2. Content of the installation directory

doc/xvalid

Contains this user guide.

doc/xvalid/samples/xsdvalid

Contains some files that can be used to quickly test xsdvalid. The examples given in the xsdvalid command reference section below make use of the files found in this directory.

doc/xvalid/samples/dtdvalid

Contains some files that can be used to quickly test dtdvalid. The examples given in the dtdvalid command reference section below make use of the files found in this directory.

doc/xvalid/samples/rngvalid

Contains some files that can be used to quickly test rngvalid. The examples given in the rngvalid command reference section below make use of the files found in this directory.

doc/xvalid/samples/schvalid

Contains some files that can be used to quickly test schvalid. The examples given in the schvalid command reference section below make use of the files found in this directory.

bin/xsdvalid, dtdvalid, rngvalid, schvalid, xsdvalid.bat, dtdvalid.bat, rngvalid.bat, schvalid.bat

Scripts used to run xsdvalid, dtdvalid, rngvalid and schvalid. Use xsdvalid, dtdvalid, rngvalid and schvalid on any Unix system. Use xsdvalid.bat, dtdvalid.bat, rngvalid.bat and schvalid.bat on Windows.

bin/*.jar

All the (non-system) Java™ class libraries needed to run xsdvalid, dtdvalid, rngvalid and schvalid:

  • xvalid.jar, contains the code of all the four command line tools.

  • relaxng.jar is Jing version 20030619, James Clark's RELAX NG validator, slightly modified for use in XMLmind XML Editor. The details of the modifications are found in relaxng.README (found in the xvalid-3_6_0/bin/legal/ subdirectory).

  • xp.jar, resolver.jar are needed to parse XML.

The last three class libraries have not been developed by XMLmind. Copyright information is contained in the corresponding .LICENSE file (found in the xvalid-3_6_0/bin/legal/ subdirectory). Read the corresponding .README file to have more details about these excellent packages.