Converting Large StarTeam Databases Seapine Software Knowledgebase

- Conferences
- Webinars

Search the Knowledgebase	Browse by Category
Advanced Search \| Home

Knowledgebase Home > Surround SCM

Converting Large StarTeam Databases

Last Updated
8th of April, 2009

Print this page

Email this page

Add to favorites

Export to PDF

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

Problem

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.

Cause

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.

Solution

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:

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:

[Sun1.4.2_01]
folder=Sun1.4.2_01
vendor=Sun Microsystems
version=1.4.2_01
exe=bin\javaw.exe
dll=bin\client\jvm.dll
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.
Save the Java.ini file.
Restart the StarTeam to Surround SCM conversion utility.

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

Attachments

No attachments were found.