Knowledgebase

Search:     Advanced search

Surround SCM Server Does Not Start Due to Memory Issues

Article ID: 675  |  Last updated: 23 Dec, 2014

Note: This information only applies to Surround SCM 2009 and later.

Problem

The Surround SCM Server does not start and the server log contains memory errors or unhandled exceptions.

Cause

The Surround SCM Server computer does not have enough memory to cache branches during server start up.

Mainline branches are always cached when the Surround SCM Server starts. By default, baseline, snapshot, and workspace branches are set to cache on demand, which means they are cached when users perform actions that access a branch.

When the Surround SCM Server starts, the most recently used cache on demand, or dynamic, branches as of the last server shutdown are cached. If these branch types are changed to always cache, they are always loaded when the server starts. As additional branches are created, the cache may become too large and cause memory issues and slow server startup times.

Solution

  1. Start the Surround SCM Server using the –mincache parameter.
  2. This parameter tells the Surround SCM to only load mainline branches. Branches set to Always Cache and the most recently used branches are not loaded.
    Windows:
    Enter the following in the Windows Run command window and click OK:
    "C:\Program Files\Seapine\Surround SCM\Surround SCM Server.exe" -mincache

    Unix:
    Enter the following at the command prompt:
    surroundscm start – mincache
  3. Start the Surround SCM Client.
  4. Choose Tools > Administration > Branch Maintenance.
  5. Evaluate the branches set to always cache to determine if any can be set to cache on demand. To set a branch to cache on demand, select the branch and click Toggle Caching.
  6. Click Close to close the Branch Maintenance dialog box.

Note: You may also want to adjust the caching server options to reduce the number of cached dynamic branches and set other options. Choose Tools > Administration > Server Options and click the Caching category. See the Surround SCM User Guide for information about caching server options.

Article ID: 675  |   Last updated: 23 Dec, 2014
Tags
server memory exceptions

Prev   Next
Enabling and Customizing PostgreSQL Logging     Microsoft Project Files Are Not Added to Surround SCM