Monitoring, Management & Location Tracking

How to increase the default memory configured for IGC

Aruba Employee
Aruba Employee

Introduction- Instant GUI Config aka IGC is a module in Airwave, which helps us to manage IAP's from Airwave. The default value of memory configured to use for IGC is 512Mb. This KB will be helpful, in scenario's where the instant GUI config, will not load and will be throwing a message saying it is disabled, although it is enabled in the group basic page.
Upon looking up in the igc.log, in /var/log/igc/igc.log, we could see the following message:

2015-01-22 09:25:20,095 ERROR HTTP[5]      com.airwave.core.Service Problem loading instance[com.airwave.config.model.impl.SettingImpl]
2015-01-22 09:25:16,025 FATAL HTTP[4] fatal error, shutting down
java.lang.OutOfMemoryError: Java heap space

2015-01-22 09:25:26,752 FATAL HTTP[5] fatal error, shutting down
java.lang.OutOfMemoryError: Java heap space

Environment- Airwave Managing IAP's using Instant GUI Config (IGC)

Configuration Steps- We could see the memory configured for the IGC to use at the below location, by doing the following from the airwave CLI:


[root@localhost mercury]# cat /usr/local/airwave/lib/igc/
export _JAVA_SR_SIGNUM=37
"$JAVA_HOME"/bin/java -XX:-AllowUserSignalHandlers -Xmx512m -DHTTP_PORT=6655 -XX:+UseParNewGC -XX:+UseConcMarkSweepGC -XX:+CMSParallelRemarkEnabled -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/var/log/igc -XX:+PerfDisableSharedMem -Digc.memory.size=512 -Digc.memory.overload=0 -jar airwave.igc.jar

Answer- IGC needs enough memory to startup. if IGC is not loading because of the less memory, if we see the above error messages mentioned in the igc.log, we could edit the below file to increase the memory, using vi or any other text editor.

we could do:

# vi /usr/local/airwave/lib/
once the file gets open, key in the letter "I" which allows us to insert and change the content below:

$JAVA_HOME"/bin/java -XX:-AllowUserSignalHandlers -Xmx512m -DHTTP_PORT=6655 -XX:+UseParNewGC -XX:+UseConcMarkSweepGC -XX:+CMSParallelRemarkEnabled -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/var/log/igc -XX:+PerfDisableSharedMem -Digc.memory.size=512 -Digc.memory.overload=0 -jar airwave.igc.jar


$JAVA_HOME"/bin/java -XX:-AllowUserSignalHandlers -Xmx2048m -DHTTP_PORT=6655 -XX:+UseParNewGC -XX:+UseConcMarkSweepGC -XX:+CMSParallelRemarkEnabled -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/var/log/igc -XX:+PerfDisableSharedMem -Digc.memory.size=512 -Digc.memory.overload=0 -jar airwave.igc.jar

basically we just changed the value Xmx512m to Xmx2048m

then hit "esc" on the keyboard and key in the letters "wq!"  which will save the change.

then restart the Instant GUI config (IGC) by running the following command from the CLI

# psk airwave.igc.jar

once done, the IGC should startup, without throwing the out of memory errors.


Version history
Revision #:
1 of 1
Last update:
‎04-03-2015 12:26 AM
Updated by:
Labels (1)
you don't increase -Digc.memory.size=512 to 2048 as well? I see the default now is 1000 on version
Search Airheads
Showing results for 
Search instead for 
Did you mean: