1. Installing XMLmind XML Editor (XXE for short)
Prev | Chapter 1. Install | Next

## 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 Java™ `bin/` 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.

Prev | Up | Next
Chapter 1. Install | Home | 2. Contents of the installation directory