1. Installing XMLmind XML Editor (XXE for short)

Requirements

XXE should run fine on any platform supporting Java™ 1.6+. However it is officially supported only on:

It is possible to use XXE on other platforms —notably Mac OS X 10.6 (Snow Leopard), 10.7 (Lion) or Oracle® Java 1.7 on the Mac— and/or with other LAFs, but without support from XMLmind.

Install on Windows

  1. Download one of the two setup.exe files.

    Normally you should choose xxe-edition-version-setup.exe. However, if you have a publicly installed[2] Java™ 1.6+ runtime already installed on your machine, you may prefer xxe-edition-version-setup-nojvm.exe.

  2. Double-click on the setup.exe file to launch the installer.

  3. Follow the instructions of the installer.

Install on the Mac

Java on Mac OS X

The .dmg distribution requires Apple Java™ 1.6. This distribution will not work with Oracle Java™ 1.7. However, the .tar.gz or .zip distributions —see manual install below— will work just fine with Oracle Java™ 1.7.

As of Mac OS X 10.7 (Lion), you'll have to install Apple Java™ 1.6 on your Mac. Normally, your Mac will automatically install Apple Java™ 1.6 for you the first time you'll run XXE. In the unlikely event of a failure of this automatic install, you can always download Apple Java™ 1.6 from http://support.apple.com/kb/DL1572 in order to install it manually.

  1. Download the .dmg file.

    The Web browser is supposed to automatically copy the contents of the .dmg file — a folder called xxe-edition-version — to the download directory and then to move the downloaded .dmg file to the Trash.

  2. Copy folder xxe-edition-version anywhere you want. For example, drag&drop this folder to your desktop or to the /Applications folder.

  3. Start XMLmind XML Editor by double-clicking on the icon called XMLEditor found in the xxe-edition-version folder you have just moved.

Caution

You must copy folder xxe-edition-version in its entirety. Copying the XMLEditor icon (that is, XMLEditor.app) alone would not give you a fully functioning XXE.

Install on Linux (or manual install on the Mac)

Tip

On the Mac, it is strongly recommended to download and install the .dmg file.

  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.7.0"
    Java(TM) SE Runtime Environment (build 1.7.0-b147)
    Java HotSpot(TM) 64-Bit Server VM (build 21.0-b17, mixed mode)
  2. Unpack the XXE distribution inside any directory you want:

    $ cd
    $ tar zxvf xxe-eval-5_9_0.tar.gz
    $ ls xxe-eval-5_9_0
    addon/
    bin/
    demo/
    doc/
    ...
  3. XXE is intended to be used directly from the xxe-eval-5_9_0/ directory. That is, you can start XXE by simply executing:

    $ xxe-eval-5_9_0/bin/xxe &

    After that, you may want to add xxe-eval-5_9_0/bin/ to your $PATH.

Manual install on Windows

Tip

On Windows, it is strongly recommended to download and install one of the two auto-installable setup.exe files.

  1. Make sure that you have a Java™ 1.6+ runtime installed on your machine. To check this, open a command window and type "java -version" followed by Enter. You should get something looking like this:

    C:\>java -version
    java version "1.7.0"
    Java(TM) SE Runtime Environment (build 1.7.0-b147)
    Java HotSpot(TM) Client VM (build 21.0-b17, mixed mode, sharing)
  2. Use a tool like WinZip, 7-Zip or Info-Zip [3] to unzip the XXE distribution inside any directory you want:

    C:\> mkdir XMLmind
    C:\> cd XMLmind
    C:\XMLmind> unzip xxe-eval-5_9_0.zip
    C:\XMLmind> dir xxe-eval-5_9_0
    ... <DIR> addon
    ... <DIR> bin
    ... <DIR> demo
    ... <DIR> doc
    ...
  3. XXE is intended to be used directly from the xxe-eval-5_9_0/ directory. That is, you can start XXE by simply executing:

    C:\XMLmind> xxe-eval-5_9_0\bin\xxe.exe

    After that, you may want to add a shortcut to "C:\XMLmind\xxe-eval-5_9_0\bin\xxe.exe" on your desktop.

    Note that the bin/ directory contains not only xxe.exe, but also xxe-c.bat, which starts XXE with a console. On Windows, a console is needed to be able to see low-level error messages, for example, when developing custom configurations or extensions.



[1] Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

[2] That is, the private runtime of a JDK will not do.

[3] Note that Windows XP has built-in support for .zip archives.