StarTeam® Import/Export Manager Release Notes

Last updated: August 25, 2006

This file contains important information that may not appear in online Help. Read this file in its entirety.

Important: Review the section, Overview of StarTeam Import/Export Manager in this document for important information regarding a reduction in the feature set for StarTeam Import Export Manager.

For information about installing StarTeam Import/Export Manager, see install_IEM.htm. The default location is C:\Program Files\Borland\StarTeam Import Export Manager.

Overview of StarTeam Import Export Manager

Important: This release of StarTeam Import/Export Manager works with no servers prior to StarTeam 2005 Release 2.

As a one-time necessity, StarTeam Import/Export Manager is a set of utilities that allows you to copy data from a project from one StarTeam Server to another that already has projects in it. The feature set for this product has been reduced because it promised more than it could deliver. Most customers have used StarTeam Import/Export Manager in the past to move single projects and that is now the supported use case.

StarTeam Import/Export Manager is made up of two utilities, stexport and stimport. The stexport utility copies the data to a set of XML files. It copies file revisions to a set of text and binary files, depending on the contents of the file. The stimport utility copies the output from the dump utility to the designated server configuration, parent view, or parent folder.

See the StarTeam Import/Export Manager User's Guide (stiemgr.pdf) for more details. In particular, you should review the limitations for StarTeam Import/Export Manager. The utilities cannot accurately copy all StarTeam server information because of deletions, moved items, and shared items. Additionally, project names, branching views based on labels, links, custom fields, licenses, and illegal XML characters can also cause problems.

Important: This product should not be used as a way of backing up StarTeam Server. For more information about backups, refer to the StarTeam Installation Guide, install.pdf (http://info.borland.com/techpubs/starteam).

System Requirements/Prerequisites

Following are the system requirements for installing and running StarTeam Import/Export Manager.

Note: Refer to StarTeam Import/Export Manager Best Practices for more information about running StarTeam Import/Export Manager.

Top

Installation Instructions

See Installing StarTeam Import Export Manager located on the product CD.

StarTeam Import/Export Manager Best Practices

The following are tips and best practices for running StarTeam Import/Export Manager.

• The import must be to a StarTeam Server whose release is the same or later than that of the StarTeam Server used for the export. You must use the same version of StarTeam Import/Export Manager with both the source and target servers.
• It is best to run the export and import utilities on the same computer as the StarTeam Server that they are copying from or to. This is not a requirement, but running either utility on a different computer can degrade performance.
• If you run the export or import utility on a different computer than StarTeam Server, select one that is connected to the server via a high-speed LAN connection. Make sure that the system times on both computers are synchronized. If the two are not synchronized, you may experience errors while running the utilities.

• The SOURCE_LOGIN and TARGET_LOGIN parameters for the Diffcheck.exe utility are obsolete. Use SOURCE_USERNAME and TARGET_USERNAME instead.
  

Top

Known Issues

The following are known issues in StarTeam Import/Export Manager.

To review the limitations of StarTeam Import/Export Manager, see the StarTeam Import/Export Manager User's Guide (stiemgr.pdf) located in the <Drive>:\Program Files\Borland\StarTeam Import Export Manager\PDF folder.

Use Only Valid Server Configurations

The export and import utilities will fail if they are run against an “invalid” server configuration. An invalid server configuration has an invalid database or a repository that is either corrupted or out of synchronization with the database.

Synchronize Times

If you run the export or import utility on a different computer than StarTeam Server, make sure that the system times on both computers are synchronized. Otherwise, you may experience errors while running the utilities.

Use Xmx Option to Allow for More Memory Usage

The installer sets the Xmx option for both stimport.lax and stexport.lax as follows:

lax.nl.java.option.additional=-Xmx1024m

If you see OutOfMemory errors, try increasing the Xmx option setting as follows:

lax.nl.java.option.additional=-XmxMAX_ALLOWED_MEMORY -XX:+UseDefaultStackSize -Xss128K -Xint

Where MAX_ALLOWED_MEMORY may be up to 1600m on a Windows computer, depending on the versions of your operating system and the JRE.

Running StarTeam Import/Export Manager with the Server and Client on Different Machines

Be sure to synchronize the system clocks if you plan to run StarTeam Import/Export Manager with the server/client on different machines. Without the system clocks syncronized, the application generates an exception message including the text, The selected configuration is not valid for the current view.

Top

Getting Help

For more information about Borland support services, please see Borland Answers, our support web site, at http://support.borland.com.

Top