Chronicall/ACR 3.10 and above
Please note, the following steps are for v.3.10 and above, as these newer versions have Java 64-bit built-in, so their RAM allocations can go higher (unless you are Shoretel/Mitel based, which is limited to 32-bit)
Windows
- Navigate to the tomcat/bin/app folder in the Chronicall/ACR directory
- Default locations
-
C:\Program Files (x86)\Xima Software\Chronicall\bin\app
-
C:\Program Files\Chronicall\bin\app
-
C:\Program Files\Avaya Call Reporting\bin\app
-
- Default locations
- Right-click and run ChronicallServerw.exe as an Administrator
- Click the Java tab
-
Java's "Initial memory pool" and "Maximum memory pool" are listed at the bottom
-
NOTE: 32-bit versions of Chronicall (Shoretel/Mitel and 32 bit Chronicall installs) have a "Maximum memory pool" value of 1024 MB
-
-
Adjust your "Maximum memory pool" up to the amount you need. It is recommended that you add RAM in multiples of 1024 MB. So if you have 2 GB free on the server, you could set your Maximum memory pool to 2048 (2 x 1024)
-
Make sure your server has the available RAM resources before making this change. You don't want to tell Chronicall to use more RAM than the server has available
-
-
You will need to restart Chronicall\ACR before your changes will take effect
Linux
- Navigate to the tomcat/bin/app folder in the Chronicall/ACR directory
- Default locations
- /var/lib/Xima Software/Chronicall/bin/app
- /var/lib/Chronicall/bin/app
- /var/lib/Avaya Call Reporting/bin/app
- Default locations
- Open the ChronicallServer.cfg file
- Edit the -Xmx4g line to the correct amount of RAM you wish to allocate
- NOTE: Your amount of initial RAM allocation may be different
- NOTE: -Xmx4g is equal to 4 GB of RAM, -Xmx256m is equal to 256 MB of RAM
- Make sure your server has the available RAM resources before making this change
- Save the changed file
- Restart Chronicall/ACR services for this to go into effect
Chronicall 3.9.4 and earlier
Please note that the following steps are for v.3.9.4 and earlier, as the newer versions have Java 64-bit built-in, so their allocations can go higher. If you are on an earlier version of Chronicall and would like to upgrade to 64-bit Java, you can follow this article to upgrade Java to 64-bit. This will allow you to allocate more than 1024 MB of memory.
Windows
-
Navigate to the tomcat/bin folder in the Chronicall directory
- Default location
-
C:\Program Files (x86)\Xima Software\Chronicall\tomcat\bin\
-
- Default location
-
Right-click and run chronicallw.exe or ChronicallServerw.exe as an Administrator
-
Click the Java tab
-
Java's "Initial memory pool" and "Maximum memory pool" are listed at the bottom
-
NOTE: 32-bit Chronicall/Java has a "Maximum memory pool" value of 1024 MB
-
-
Adjust your "Maximum memory pool" up to the amount you need
- Make sure your server has the available RAM resources before making this change
-
You will need to restart Chronicall before your changes will take effect
Linux
To increase Java's memory limit on a Linux Chronicall server we need to download and edit the setenv.sh file in the tomcat/bin folder.
-
If you have not made any prior modifications, simply open a command terminal and go through the following steps
-
NOTE: This will stop and restart the Chronicall service
-
-
Gain root access to the server either with
-
su root
-
or
-
-
sudo su
-
- Enter your root password
- Stop the Chronicall service
-
service chronicall stop
-
-
Navigate to the tomcat/bin file in the Chronicall directory
- Default location
-
/var/lib/Xima\ Software/Chronicall/tomcat/bin
-
- Default location
-
Run the following command to pull in the setenv.sh file
-
wget ftp://media.ximasoftware.com/ChronicallLinux/setenv.sh
-
-
Turn the file into an executable with this command:
-
chmod +x setenv.sh
-
-
Start the Chronicall service back up again
-
service chronicall start
-
-
If you have made prior modifications such as an alternate Java JRE, then add the following line to the setenv.sh file
-
export JAVA_OPTS="$JAVA_OPTS -Xms512m -Xmx512m"
-
You can modify the "512m" as needed, for example:
-
export JAVA_OPTS="$JAVA_OPTS -Xms256m -Xmx1024m"
-
-
Web Client (Windows)
If you experience performance issues while using the Chronicall Web client, you may be able to solve them by allowing Java to use more RAM.
-
Navigate to Java in the Control Panel menu of Windows
-
Under the Java tab, click "View..."
-
This will open the Java Runtime Environment Settings window
-
Your current version of Java will be listed in the "Product" column
-
-
Double-click the "Runtime Parameters" field and enter:
-
-Xmx400m
-
NOTE: You can replace 400 with the number of megabytes you want Java to be able to use.
-
-
Make sure your computer has the available RAM resources before making this change
-
- Click "OK" to save your changes
- Before your changes will take effect, you will need to restart your web browser.