Installing Oxygen XML Editor on a Linux / UNIX Server

You can install Oxygen XML Editor on Linux using any of the following methods:

• Install using the Linux installer.
• Install using the Linux installer in unattended mode.
• Install using the all platforms installer. Choose the all platforms installer if you have trouble installing using the Linux installer.

System requirements for a Linux install:

Operating system

Any Unix/Linux distribution with an available Java SE Runtime Environment version 1.6.0 or later from Oracle

CPU

• Minimum - Intel Pentium III™/AMD Athlon™ class processor, 1 GHz
• Recommended - Dual Core class processor

Memory

• Minimum - 2 GB of RAM
• Recommended - 4 GB of RAM

Storage

• Minimum - 400 MB free disk space
• Recommended - 1 GB free disk space

Java

Oxygen XML Editor requires Java. Oxygen XML Editor supports only official and stable Java Virtual Machines with the version number 1.6.0 or later (the recommended version is 1.6.0) from Oracle available at http://www.oracle.com/technetwork/java/javase/downloads/index.html. Oxygen XML Editor may work with JVM implementations from other vendors, but there is no guarantee that other implementations will work with future Oxygen XML Editor updates and releases. Oxygen XML Editor does not work with the GNU libgcj Java Virtual Machine.

Oxygen XML Editor uses the following rules to determine which installed version of Java to use:

1. If you used the Linux installer, which installs a version of Java as part of the Oxygen XML Editor installation, the version in the jre subdirectory of the installation directory is used.
2. Otherwise, if the Linux environment variable JAVA_HOME is set, Oxygen XML Editor uses the Java version pointed to by this variable.
3. Otherwise the version of Java pointed to by your PATH environment variable is used.

You can also change the version of the Java Virtual Machine that runs Oxygen XML Author by editing the script file, oxygen.sh. Go to the Java command at the end of the script file and specify the full path to the Java executable of the desired JVM version, for example:

/usr/bin/jre1.6.0_45/bin/java -Xmx256m ...

Linux installation procedure.

1. Download the Linux installer.
2. Validate the integrity of the downloaded file by checking it against the MD5 sum published on the download page.
3. Run the installer that you downloaded and follow the instructions presented in the installation program.
4. Start Oxygen XML Editor using one of the following methods:
   • Use the oxygen shortcut created by the installer.
   • Run sh oxygen.sh from the command line. This file is located in the installation folder.
5. To license your copy of Oxygen XML Editor go to Help > Register... and enter your license key.

1. Download the all platforms installation package (oxygen.tar.gz ) to a folder of your choice.
2. Extract the archive in that folder.
   Oxygen XML Editor is now installed in a new sub-folder called oxygen.
3. If you wish, you can move the directory where you installed Oxygen XML Editor to your applications directory. You can also rename it to contain the product version information. For example you can rename it as oxygen17.0.
4. Start Oxygen XML Editor by running oxygen.sh, which is located in the install folder.
5. To license your copy of Oxygen XML Editor go to Help > Register... and enter your license information.

1. Install Oxygen XML Editor on the server and make sure the oxygen.sh script is executable and the installation directory is in the PATH of the users that need to use the application.
2. If you need to run multiple instances of the Oxygen XML Editor, make sure you add the -Dcom.oxygenxml.MultipleInstances=true parameter in the startup script.
3. Make sure you allocate sufficient memory to Oxygen XML Editor by setting an appropriate value for the -Xmx parameter in the .sh startup script.
4. Make sure the X server processes located on the workstations allow connections from the server host. For this, use the xhost command.
5. Start telnet (or ssh) on the server host.
6. Start an xterm process, with the display parameter set on the current workstation. For example: xterm -display workstationip:0.0.
7. Start Oxygen XML Editor by typing oxygen.sh .