Description
How do I increase the amount of RAM that is available to Universal Type Server 5?
Solution
If you are using UTS 5 in a demanding setup, that is, with a large number of LDAP users or large number of workgroups, you may find it necessary to increase the amount of memory available to the Java environment (JVM) that it runs in. This is usually necessary if the Java service uses close to 2 GB of RAM, or if your server logs have Java Heap Space errors.
By default, the memory allocation is configured for 2 GB of RAM, which is enough for most setups. It can be increased to use more memory as long as there is enough available on the server it’s installed on. Make sure you leave enough RAM for the operating system and other services that may be running on the server. For example, if your server has a total of 8 GB of RAM, do not give UTS more than 6 GB.
Increasing UTS’s JVM Memory Allocation
Warning: This is an advanced procedure. If you are not familiar with changing Mac OS X configuration or Windows batch files, please contact Extensis Technical Support for assistance.
On Mac OS X, UTS uses a file named standalone.conf to configure how much memory is used by its JVM. On Windows, the file is named standalone.conf.bat.
Note: On Windows, it will look as if there are two files named Standalone.conf if file extensions are hidden. Make sure that you edit the .bat file.
Mac OS X:
- Log into UTS Administration (port 18081) and stop UTS
- Open
/Applications/Extensis/Universal Type Server/applications/jboss/bin - Make a backup of the standalone.conf file
- Launch Terminal from
/Applications/Utilities - Type in:
Sudo pico /Applications/Extensis/Universal\ Type\ Server/applications/jboss/bin/standalone.confYou will be asked to authenticate with your Mac administrator password. Type that in and hit the Return key. This should open the configuration file in PICO.
- Scroll down to the line that starts with:
JAVA_OPTS="-Xms64m -Xmx2048m …" - Change the -Xmx setting to the desired value. For example, if you want to double the allocation to 4 GB, use this setting:
JAVA_OPTS=" -Xms128m –Xmx4096m …" - When you’re ready to save the changes, use the ‘Control + O’ keyboard combination to save them
- PICO will ask you to confirm the name of the file. Hit the Return key to do that
- When you’re done with PICO, use ‘Control + X’ to exit
- Restart your Mac server
- After the restart, log into UTS Administration and start UTS. If it does not start, check your changes to the standalone.conf file. If you can’t find any mistakes, replace it with the backup you made earlier and restart your server. At this point, it is advisable to contact Extensis Technical Support for assistance.
Windows:
- Log into UTS Administration (port 18081) and stop UTS
- Open
C:\Program Files\Extensis\Universal Type Server\applications\jboss\bin\ - Locate the standalone.conf.bat file. There is also a file named standalone.conf; do not edit this one..
- Make a backup copy of the standalone.conf.bat file, just in case you need to go back to it.
- Open the original copy of of standalone.conf.bat in a text editor
- Look for the line that starts with:
set "JAVA_OPTS=-Xms64M -Xmx2048M - Change the -Xmx setting to the desired value. For example, if you want to double the allocation to 4 GB, use this setting:
set "JAVA_OPTS=-Xms64M -Xmx4096M …" - Save the changes and quit the text editor
- Restart your server
- After the restart, log into UTS Administration and start UTS. If it does not start, check your changes to the standalone.conf.bat file. If you can’t find any mistakes, replace it with the backup you made earlier and restart your server. At this point, it is advisable to contact Extensis Technical Support for assistance.