Setting Parameters for the Application Launchers

Increasing the Amount of Memory that Oxygen XML Uses on Windows and Linux

For Windows and Linux installations of Oxygen XML, the startup launchers for the application and its executable internal tools (Tree Editor, XML Schema Regular Expressions Builder, Large File Viewer, SVN Client, Compare Directories, and Compare Files) include a default .vmoptions file in the installation directory that contains some startup parameters (such the -Xmx parameter, which is used for allocating memory for that particular application). If your installation contains these .vmoptions files, you can edit the parameters in them so that the applications will launch with your desired values. However, if you re-install the application, install an update for the application, or deploy it to other users or machines, those parameters will be reset to their default values.

To increase the memory available to the Oxygen XML application on Windows:

Browse the installation directory of Oxygen XML.
Locate the -Xmx parameter in the oxygen.vmoptionsoxygenAuthor.vmoptionsoxygenDeveloper.vmoptionsoxygenJSONEditor.vmoptionssyncroSVNClient.vmoptions file. If it is located in a directory where you do not have write access, copy the file to another folder (where you do have write access), modify it there, and then copy it back to the original location.
Note:
The parameters from the .vmoptions file are used when you start Oxygen XML with the oxygen launcher (or with the desktop shortcut). If you use the command-line script (<oxygen.bat> or <oxygen.sh>), make sure you use the following procedure instead: Setting Parameters in the Command-Line Scripts.
Tip:
By default, the maximum memory available to the application is about a quarter of the internal memory available on the machine. It is recommended to not use more than half of your existing physical RAM.
Restart Oxygen XML. Go to Help > About and verify the amount of memory that is actually available (see the JVM Memory Used in the last row in the Copyright tab). If Oxygen XML does not start and you receive and error message saying that it could not start the JVM, decrease the -Xmx parameter and try again.

Increasing the Amount of Memory that Oxygen XML Uses on macOS

To increase the memory available to Oxygen XML on macOS:

Create a file named vmoptions.txt.
Add the -Xmx argument (or other Java VM arguments), one per line, and do not add extra new lines at the beginning or end of the file. For example:
```
-Xmx4g
-Dcom.oxygenxml.editor.plugins.dir="$OXYGEN_HOME/plugins"
```
Make sure you save the file as plain text (in the TextEdit, go to Menu > Format > Make plain text) and copy the file to the Contents folder for the main application launcher (i.e. Oxygen XML Editor.app/ContentsOxygen XML Author.app/ContentsOxygen XML Developer.app/ContentsOxygen XML Developer.app/Contents). To show the Contents folder for the application launcher, right-click (or Command+Single-Click) the Oxygen XML icon in Finder, and choose Show Package Contents.

Setting a System Property

Depending on the operating system and type of installer, you can set a Java system property in multiple ways:

[Windows/Linux Installer] When installing the application on Windows or Linux using the provided installation kit, you can create your own custom startup parameters file in the installation folder.
[macOS Installer] Create a file named vmoptions.txt in the Contents folder within the application installation folder, similarly to this procedure. Add each system property (or Java VM argument) on a separate line. For example:
```
-DpropertyName1=value1
-DpropertyName2=value2
```
[Windows Linux/Mac Startup Scripts] The application also contains startup scripts in the installation folder. If you are using such scripts to start the application, you can follow this procedure to set system properties for them: Setting Parameters in the Command-Line Scripts.

Note:

You can also set a system property through a parameter prefixed with -Doxy in the command line used to start the application:

oxygen25.1.exe "-Doxyproperty.name=value"

but this system property will be set immediately after the application starts and might not be available if it is needed sooner.

To check the value for a system property, you can select Help > About from the main menu and look in the System properties tab.

To view the list of Oxygen XML system properties, go to Custom System Properties.

Disabling DPI Scaling

Some users may prefer the look of smaller icons in an HiDPI display. To achieve this, display scaling needs to be disabled for high DPI settings. To disable the DPI scaling, set the following property:

sun.java2d.dpiaware=false

Setting Environment Variables

When started, the application inherits and can access all environment variables set in the operating system. All processes started by the application (for example, publishing using the DITA Open Toolkit engine or starting external tools) also inherit the environment variables provided to the application. Depending on the operating system, environment variables can be set in various ways:

[Windows] (Note: You will need Administrator permissions or to work with a system administrator):
1. Go to Start > Edit the system environment variables > Environment Variables.
2. Click New in the System variables section.
3. Specify the variable name and value in the Name and Value fields.
4. Click OK.
5. Restart Windows.
[Linux]:
1. Append the following line to the /etc/environment file:
  ENV_VAR_NAME=VALUE
2. Reboot the computer.
[macOS]: There is no standard way to set an environment variable so that it is inherited by the applications regardless of the way they start.

To check the value for an environmental variable, you can select Help > About from the main menu and look in the System properties tab.