airControl - Change JVM settings like memory size and path directory

Overview


Readers will learn how to adjust parameters for Java virtual machine (JVM) used by airControl.

airControl relies on a Java virtual machine (JVM), which can be configured by the operator for different parameters. As such, it can be installed on any OS which supports Java7 / Java8. However, the airControl service may fail to start or even crash due to insufficient memory on a system. If less devices will be managed by airControl, the memory heap size may be decreased accordingly but plan on at least 512M of heap space for airControl. It's also crucial that the service can locate the java directory upon startup. If this path is incorrect or the location changes, the service won't start properly. Similarly, the JSVC directory should point correctly since airControl relies on this to run as a java service.

Java tab inside airControl service configuration panel

Adjust memory heap size


Linux

  1. Locate the startup script for Ubiquiti airControl—by default it's found at airControl2Server.vmoptions
  2. Use an editor like vi or pico to open the file and begin editing
    "sudo pico airControl2Server.vmoptions"
  3. Under JAVA_OPTS, edit the line, where -Xmx1024M can be changed accordingly (-Xmx512M, -Xmx2048M, etc.)
    "JAVA_OPTS="-Djava.awt.headless=true -Xmx1024M $JAVA_OPTS"
  4. Save & exit editor

Windows 

  1. Visit the airControl service configuration panel under the airControl program group
  2. Click on the "Java" tab & deselect "Use default"
  3. Under "Java Options" edit the first line, where -Xmx1024M can be changed accordingly (-Xmx512M, -Xmx2048M, etc.)
  4. Once finished, click OK to save settings

Change java home directory


Linux

  1. Locate the startup script for Ubiquiti airControl—by default it's found at /etc/init.d/aircontrol
  2. Use an editor like vi or pico to open the file and begin editing
    "sudo pico /etc/init.d/aircontrol"
  3. Just below the line # setup JAVA_HOME, edit the path to java
    "JAVA_HOME=/path/to/jvm/java-6-openjdk/jre
  4. Save & exit editor

Windows

  1. Visit the airControl service configuration panel under the airControl program group
  2. Click on the "Java" tab & deselect "Use default"
  3. Under "Java Virtual Machine" specify the path of the jvm.dll belonging to the Java Runtime Environment
  4. Under "Java Classpath" specify the location of the bootstrap.jar file found in airControl directory
  5. Once finished, click OK to save changes
Powered by Zendesk