Teamprise Explorer may require additional memory beyond what it has been configured for, particularly when initially connecting to a server. The server's Work Item metadata may require a large amount of memory to process. It may be necessary to experiment to determine how much memory is required by your server's Work Item metadata, but in general, 1 GB is enough for most servers datasets.
Windows and Unix users should increase the amount of memory available to Teamprise Explorer by running the executable from the command line, with additional command line arguments. The -vmargs argument is required to specify arguments to the Java Virtual Machine. The -Xmx argument will specify the memory size. For example, to increase to 1 GB of memory, you should execute:
TeampriseExplorer -vmargs -Xmx1024M
Mac OS users should increase the amount of memory available to Teamprise Explorer by editing the startup configuration file.
In Finder, navigate to the installation location for Teamprise Explorer. (For example: /Applications.) Right-click on Teamprise Explorer and select "Show Package Contents". A finder window displaying the contents of the application bundle should open.
Navigate to the Contents/MacOS directory. There should exist a Teamprise Explorer.ini file. Right click on that file and select "Open With", then choose a text editor of your choice. You should be able to edit the -Xmx line to increase the memory size. For example, to increase to 1 GB of memory, the file should appear as:
-showsplash
org.eclipse.platform
-vmargs
-Xms256M
-Xmx1024M
-Xdock:icon=../Resources/teamprise.icns
-XstartOnFirstThread
-XX:MaxPermSize=256m
-Dorg.eclipse.swt.internal.carbon.smallFonts
Once you have made this change and saved the file, you may run Teamprise Explorer.
If Teamprise Explorer was running out of memory due to the initial import of Work Item metadata, you may wish to decrease the amount of memory available to Teamprise Explorer once the download and import has completed.