Community in read only mode June 18 & 19
This community will be set in READ ONLY mode for a while on Tuesday June 18 into Wednesday June 19 while we import content and users from our Micro Focus Forums community site. MORE INFORMATION

Overview of StarTeam Purge

Overview of StarTeam Purge

This information applies to both the Online Purge and the Offline Purge

What initiates items to be ready for purging

  • When a user deletes an item it is 'marked' for deletion in the database; it is removed from display in the StarTeam Client for the current 'point-in-time'.

  • When the Purge is run it scans the database for items marked as deleted. Further checks are then done to see if the items qualify for actual deletion (see checklist below).

  • Only if the items pass these checks, does the tool then performs a lookup on the file's MD5 value, and physically deletes the compressed (archive) file from disk (Hive).


This operation has further in-built checks so that files that are actually needed are not deleted.

The Purge will:

  • only delete archives that are not shared between Views.
  • not delete archives if a Child View was deleted and the same file(s) exist in a Parent View; but will delete new files that existed in the Child View only.
  • delete all files in a View if that View has a 'DeletedTime' value in the 'syn_view' table in the database (that is, the View has actually been deleted by a User previously via StarTeam Client).

After the Purge:

  • The file details have been removed from the archive and also from the Database tables/views.
  • The (StarTeam) View details remain in the Database table and in 'syn_view' view, but the data row(s) are marked as 'deleted'.

Note that the Purge utility will *only* delete items that are in 'deleted' Views. Therefore, deleted items in the Root View are not removed from the Hive until the actual Project itself has been deleted (this effectively is the only way to delete a Root View).
This is because StarTeam allows "time travel" or rollback functionality (to a point-in-time), so all asset versions have to be available in case someone requests an older configuration of the Root View.


Some content on Community Tips & Information pages is not officially supported by Micro Focus. Please refer to our Terms of Use for more detail.
Top Contributors
Version history
Revision #:
1 of 1
Last update:
‎2012-10-05 14:50
Updated by:
The opinions expressed above are the personal opinions of the authors, not of Micro Focus. By using this site, you accept the Terms of Use and Rules of Participation. Certain versions of content ("Material") accessible here may contain branding from Hewlett-Packard Company (now HP Inc.) and Hewlett Packard Enterprise Company. As of September 1, 2017, the Material is now offered by Micro Focus, a separately owned and operated company. Any reference to the HP and Hewlett Packard Enterprise/HPE marks is historical in nature, and the HP and Hewlett Packard Enterprise/HPE marks are the property of their respective owners.