airControl - Server and Desktop Client Startup Options


Overview


This article shows different startup options that airControl server and client can take to perform such actions as increase JVM allocated memory size, reset user passwords, migrate data etc.


Table of Contents


  1. Passing Parameters to Client/Server
  2. General Options
  3. Server Specific Options
  4. Client Specific Options

Passing Parameters to Client/Server


Back to Top

To specify additional VM parameters for an airControl server or client, the appropriate airControl2Server.vmoptions or airControl2Client.vmoptions file is used. Those files can be found in the root catalog of the airControl installation. Each line in the file is interpreted as a single VM parameter. The last line must be followed by a line feed.

Program parameter can be passed in those files using -D<parameter> syntax. Here is the example of airControl2Server.vmoptions file:

-Xmx1024m
-DlogToConsole
-DserverPort=9082

 It is possible to include other .vmoptions files with the following syntax: 

-include-options <path to other .vmoptions file>

General Options


Back to Top

  Parameter

Purpose

logToConsole Outputs logs to console.
dontLogToFile  Prevents logging to file.
serverPort=<port> Sets new server/client communication port.

Server Specific Options


Back to Top

  Parameter

Purpose

migrateData=<number of months|all>

Migrates legacy (pre Beta19) data to new PostgreSQL database. <number of months|all> specifies how many months of historical statistics data should be migrated.

resetUsers Resets all users' GUI properties to defaults.enableGPSSync if option is set, it allows to change device GPS coordinates to selected user.
resetAdminPassword Resets all admins' passwords to 'ubnt'.
bindToAllIPs Resets server IP binding option and binds to all available IPs.
disableInitialScan Turns off initial discovery scan when server is started for the first time.

Client Specific Options


Back to Top

  Parameter

Purpose

serverIp=<ip> IP of server to connect to.
enableTextureCoordFix mac OS X specific option. If on mac OS X, and the client view is blurred, use this option to fix the problem.
maxSelectedDevicesForStatistics=<number of devices> Statistics will be retrieved only for first selected <number of devices> devices in airControl client device list. Default value is 10.

We're sorry to hear that!