Collapse AllExpand All

1. Installing XMLmind XML Editor (XXE for short)

Requirements

  • Oracle (ex Sun) or Apple Java[1] runtime 1.6 or above. Note that Oracle Java™ 1.7 is supported on the Mac.

  • At least 2Gb of memory and a 2GHz CPU.

  • 200Mb of free disk space; 400Mb for the self-contained distribution which includes a private Java™ runtime.

XXE is officially supported on Windows XP/Vista/7/8, on Linux and on Mac OS X 10.6 (Snow Leopard)/10.7 (Lion)/10.8 (Mountain Lion). It is possible to use it on other Java™ 1.6+ platforms (e.g. Mac OS X 10.5 (Leopard)), 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 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

  • A Java™ runtime allowing to run XXE is installed by default in Mac OS X 10.6 (Snow Leopard).

  • As of Mac OS X 10.7 (Lion), you'll have to install Apple Java™ on your Mac. Normally, your Mac will automatically suggest to install Java™ the first time you'll attempt to run XXE. If this is not the case, you can download Java™ for Mac OS X from various sites on the Web, for example, from http://support.apple.com/kb/DL1572.

  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.

If, for any reason, the automatic “unpacking” of the .dmg file described above does not happen:

  1. Download the .dmg file.

  2. Double-click on the corresponding icon to open a Finder window showing the contents of the downloaded .dmg file. This Finder window contains a folder called xxe-edition-version.

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

  4. The downloaded .dmg file is not needed anymore, so:

    1. In the Finder window, click the Eject icon found at the right of the “device” called "XMLmind XML Editor".

    2. Delete the downloaded .dmg file by dragging it to the Trash.

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

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_6_0.tar.gz
    $ ls xxe-eval-5_6_0
    addon/
    bin/
    demo/
    doc/
    ...
  3. XXE is intended to be used directly from the xxe-eval-5_6_0/ directory. That is, you can start XXE by simply executing:

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

    After that, you may want to add xxe-eval-5_6_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 [2] to unzip the XXE distribution inside any directory you want:

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

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

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

    Note that the bin directory contains not only xxe.exe, but also an equivalent xxe.bat which may be handy if you intend to customize the way XXE is started.



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

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