Edit online

Installing Oxygen XML on Linux

System Requirements

Operating System
CPU
Memory
Storage
Java
X.org
The version of Java bundled with Oxygen XML requires X.org (Wayland is not supported).

Linux Installer

To install Oxygen XML using the Linux installer, follow these steps:
  1. Make sure that your system meets the system requirements.
  2. Download the Linux installer.
  3. [Optional] Validate the integrity of the downloaded file by checking it against the MD5 sum published on the download page.
  4. Run the installer and follow the instructions in the installation program.
    Note:
    For example, open a shell, cd to the installation directory, and at the prompt type sh ./oxygen-32bit.sh or sh ./oxygen-64bit.sh, depending on which installer you downloaded.
    Warning:
    If you are running the installer as root and your Linux distribution uses Wayland (such as Ubuntu 17.10 or Fedora 25), before running the installer, the local user must first allow the root user to access the X server by running the following command (as the local user):
    xhost +SI:localuser:root
  5. Start Oxygen XML using one of the following methods:
    • Use the oxygenauthordeveloperjsoneditorsyncroSVNClient shortcut created by the installer.
      Note:
      For Ubuntu 17.10 (or later), a security dialog box will appear the first time you start the application where you need to select Trust and Launch to continue. This dialog box will not appear on subsequent launches.
    • From a command line, type sh oxygen.shsh oxygenAuthor.shsh oxygenDeveloper.shsh oxygenJSONEditor.shsh syncroSVNClient.sh. This file is located in the installation folder.
  6. To license your copy of Oxygen XML go to Help > Register and enter your license information.

Linux Unattended Installation

You can run the installation in unattended mode by running the installer from the command line with the -q parameter. By default, running the installer in unattended mode installs Oxygen XML with the default options and does not overwrite existing files. You can change various options for the unattended installer using the installer command-line parameters.

Linux Installer Command-Line Reference

The Oxygen XML installer for Linux supports a variety of command-line parameters:

-q
Instructs the installer to run in unattended mode. The installer will not prompt the user for input during the install. Default settings will be used for all options unless a response.varfile is specified using the -varfile option.
-overwrite
In unattended mode, the installer does not overwrite files with the same name if a previous version of the Oxygen XML is installed in the same folder. The -overwrite parameter added after the -q parameter forces the overwriting of these files.
-console
Displays a console during the installation.
-varfile
Specifies the location of a response.varfile, normally to be used during an unattended installation.
-V
Used to define a variable parameter to be used by an installation.
EXAMPLE:
oxygen.sh -q -overwrite -console -VautoVersionChecking=false

Command-Line Variables for Preconfiguring License Server Details

For organizations that use a license server to manage user licenses, the Oxygen XML installer also supports the following command-line variables used for preconfiguring license server details:

autoVersionChecking
Used for automatic version checking. Possible values are true (default) or false.
backup.license.servlet.url
Specifies the URL of the backup HTTP license server.
backup.license.servlet.user.name
Specifies the user name for the backup HTTP license server.
backup.license.servlet.password
Specifies the password for the backup HTTP license server, in clear form (will be stored encrypted).
backup.license.servlet.password.encrypted
Specifies the password for the HTTP license server, in encrypted form. Can be obtained from an entry with the same name in an existing license.xml file (found in: [user_home_directory]\AppData\Roaming\com.oxygenxml[user_home_directory]\AppData\Roaming\com.oxygenxml.author[user_home_directory]\AppData\Roaming\com.oxygenxml.developer[user_home_directory]\AppData\Roaming\com.oxygenxml.jsoneditor).
downloadResources
Used to download resources (links to video demonstrations, webinars, and upcoming events) from to populate the application welcome screen. Possible values are true (default) or false.
license.servlet.url
Specifies the URL of the HTTP license server.
license.servlet.user.name
Specifies the user name for the HTTP license server.
license.servlet.password
Specifies the password for the HTTP license server, in clear form (will be stored encrypted).
license.servlet.password.encrypted
Specifies the password for the HTTP license server, in encrypted form. Can be obtained from an entry with the same name in an existing license.xml file (found in: [user_home_directory]\AppData\Roaming\com.oxygenxml[user_home_directory]\AppData\Roaming\com.oxygenxml.author[user_home_directory]\AppData\Roaming\com.oxygenxml.developer[user_home_directory]\AppData\Roaming\com.oxygenxml.jsoneeditor).
reportProblem
Used to report a problem encountered while using Oxygen XML. Possible values are true (default) or false.
EXAMPLE:
oxygen.sh "-Vlicense.servlet.url=http://main.licenseserver:8080/oXygenLicenseServlet/license-servlet"
 "-Vlicense.servlet.user.name=user" "-Vlicense.servlet.password=mypass" 
 "-Vbackup.license.servlet.url=http://backup.licenseserver:8080/oXygenLicenseServlet/license-servlet"
 "-Vbackup.license.servlet.user.name=user" "-Vbackup.license.servlet.password=mypass"
Note:

Linux Installer response.varfile

The Oxygen XML installer for Linux also creates a file called response.varfile, which records the choices that the user made when running the installer interactively. The generated response file is found in the [OXYGEN_INSTALL_DIR]/.install4j folder. You can use the response.varfile to set the options for an unintended install. For more information about the response.varfile format, see install4j site.

Variable Parameters (can be used in the response.varfile or from the command line)

The following variable parameters are supported in the response.varfile (or from the command line):

autoVersionChecking
Used for automatic version checking. Possible values are true (default) or false.
checkNotifications
Used to control checking for application-related news and events. Possible values are true (default) or false.
reportProblem
Used to report a problem encountered while using Oxygen XML. Possible values are true (default) or false.
downloadResources
Used to download resources (links to video demonstrations, webinars, and upcoming events) from to populate the application welcome screen. Possible values are true (default) or false.
installAddons
Set to false to prohibit the application from allowing the end user to install add-ons.
installAIPositronAddons
Set to false to prohibit the application from allowing the end user to install any of the AI Positron Assistant add-ons.