By default the maximum memory available to <oXygen/> is set to 180 MB. If <oXygen/> is used on large documents (more than 10 MB) and you see that performance slows down considerably after some time then a possible cause is that it needs more memory in order to run properly. You can increase the maximum amount of memory available to <oXygen/> by modifying a parameter in a configuration file specific to the platform that runs the application as specified below.
![]() | Warning |
---|---|
The maximum amount of memory should not be equal to the physical amount of memory available on the machine because in that case the operating system and other applications will have no memory available. |
![]() | Note |
---|---|
You can use the Large File Viewer to view huge XML files (up to two gygabytes) which would be otherwise be impossible to open in the editor. |
![]() | Note |
---|---|
The amount of memory allocated for the FOP operations is controlled by a different setting available in <oXygen/> Preferences: Memory available to the built-in FOP. |
On the Windows platform the total amount of memory is
specified by the value of the -Xmx parameter on the line
Virtual Machine Parameters in the file
oxygen.ini
found in the installation directory. The default value of the
-Xmx parameter has the form:
-Xmx40:32:700P
That means <oXygen/> takes 40% of the system memory space but the size of the memory space allocated to <oXygen/> will not be less that 32 MB or more than 700 MB. To increase the maximum space for <oXygen/> one must increase the first value, for example from 40 to 60 and also the third value, for example from 700 to 1000. Another possibility is to set a precise maximum limit for the amount of memory, for example 800 MB, using the following form of the parameter: -Xmx800m
On the Mac OS X platform to change the total amount of memory you have to right-click on the <oXygen/> application icon, in the pop-up menu select Show Package Contents, then in the Contents directory you edit the file Info.plist: in the key VMOptions modify the -Xmx parameter. The number specified in the parameter represents the number of megabytes allocated to the <oXygen/> application.
On the Linux platform you have to create a file called oxygen.vmoptions which must contain the parameters that you want to pass to the Java virtual machine. In this case the file contains only the -Xmx parameter, so the file content can be for example:
-Xmx800m
If you use the All platforms distribution
you can modify the total amount of memory by modifying the
-Xmx parameter of the java command line in the file
oxygen.bat
on Windows,
oxygenMac.sh
on Mac OS X and
oxygen.sh
on Linux. This file is located in the installation directory.
When installed on a multi-user environment such as Windows Terminal Server or Unix/Linux, to each instance of <oXygen/> will be allocated the amount stipulated in the memory value. To avoid depreciating the general performance of the host system, please ensure that the amount of memory available is optimally apportioned for each of the expected instances.
Example 2.1. Example of Java command line in startup script (Windows)
java -Xmx256m -cp %CP% ro.sync.exml.Oxygen $1 $2 $3 $4 $5 $6 $7 $8 $9
Modifying the value from 256 to 512 changes the memory available from 256 MB to 512 MB.