Search:     Advanced search

Converting Large StarTeam Databases to Surround SCM

Article ID: 632  |  Last updated: 30 Apr, 2015

Note: This information only applies to Surround 2008.1 and earlier.


The conversion fails when you convert large StarTeam databases to Surround SCM. A large database typically has 150,000 or more files and can include numerous views and repositories.


The StarTeam to Surround SCM conversion utility is written using the COM interface provided by Borland. The COM interface is a wrapper around the StarTeam SDK, which is written in Java. As a result, the application loads a Java Virtual Machine (JVM) during runtime.

A large number of views, repositories, and files are examined during the conversion. The conversion fails if there is not enough available heap space for the JVM to use.


Configure the JVM to use additional heap space. For example, Sun’s JVM sets the maximum heap value to 64MB on the Windows platform (by default). This value may not be enough for a particular project and the conversion may fail.

Following are the steps to specify a heap value:

  1. The StarTeam SDK comes with a JVM. Open the Java.ini file, which is located in the C:\Program Files\Borland\Java directory. Following are the contents of the Java.ini file included with StarTeam SDK 7.0:
    vendor=Sun Microsystems
  2. Append the following line to the Java.ini file to specify a heap value: options= -Xmx512M
    The maximum heap parameter must be specified in multiples of 1024 and may not exceed 75% of the available physical RAM on the host computer. In this example, the maximum amount of heap space that the JVM can use is 512MB.
  3. Save the Java.ini file.
  4. Restart the StarTeam to Surround SCM conversion utility.

Note: Additional optimizations and settings can be configured for the JVM. See the JVM's documentation for available options.

Article ID: 632  |   Last updated: 30 Apr, 2015

Prev   Next
Surround SCM Integration Does Not Work if the TestTrack Client...     Surround SCM Xcode 3 Integration