wiki:Manual/Setup/Memory

You are here: Manual / Setup/ Memory

TracNav


SEAMCAT Memory Allocation

Abstract

The purpose of this page is to explain the why and how memory allocation for SEAMCAT is done. It might be necessary to increase the memory available to SEAMCAT if you are simulating scenarios with a large number of interfering links (10+).

Java Memory Basics

As SEAMCAT is written in java it is running inside an instance of the Java virtual machine. Part of the virtual machine startup procedure is to allocate a FIXED amount of memory. This is done automaticly when you launch SEAMCAT. At the moment the SEAMCAT configuration is allocating 256 megabytes of memory.

How to increase memory available to SEAMCAT

Depending on which version of SEAMCAT you are using the way to increase the available memory is very different. This page only holds information for the windows installer. If you need to run SEAMCAT on a non windows platform with more than the default memory - please contact seamcat@…

Windows Installer Version

When launching SEAMCAT through the .msi installer the memory configuration is stored in a file called SEAMCAT [version].ini (i.e. "SEAMCAT 3.1.44.ini") which is stored in the installation folder. (i.e. c:/Program Files/SEAMCAT/3.1.44). To change the amount of memory available to SEAMCAT you must edit this file and relaunch SEAMCAT. The file will look something like this:

[Java Runtime Environment]
Maximum Version=any
Virtual Machine Parameters=-Xmx256M -Dsun.java2d.noddraw=true
Minimum Version=1.6
Main Class=org.seamcat.Seamcat
[Product Information]
Product Code={B9E54115-E5BE-4683-9A40-A052A8FCC398}
Product Name=SEAMCAT
[Application]
Application Type=gui
Failure Check=yes
Output File=C:\Program Files (x86)\SEAMCAT\3.1.44\output.log
Error File=C:\Program Files (x86)\SEAMCAT\3.1.44\error.log
[Class Path]
Class Path=C:\Program Files (x86)\SEAMCAT\3.1.44\activation.jar;... [removed on the wiki]

You need to change the line that looks like this:

Virtual Machine Parameters=-Xmx256M -Dsun.java2d.noddraw=true

to look something like this

Virtual Machine Parameters=-Xmx1024M -Dsun.java2d.noddraw=true

the configuration above changes the amount of memory available to SEAMCAT from 256 MB to 1GB. Do NOT assign all available memory in your pc to SEAMCAT - Windows does NOT like that.
Please note that any changes to this file only takes affect after restarting SEAMCAT.