Setting general mainline options

You can set options to control how keywords, check outs, Unicode files, thumbnails for image files, and large files are handled.

These options apply to all branches and users, but can be overridden for specific mainline branches. See Overriding server options for specific mainline branches.

1. Choose Tools > Administration > Server Options.

The Server Options dialog box opens.

2. Select General from the Mainline Options category.

3. Select Expand keywords to enable keyword expansion.

Keywords are case-sensitive placeholders that can be inserted into text files and expanded when files are viewed or checked in. See Supported keywords.

4. Select Allow multiple users to check out a file to enable multiple check outs of the same text file.

Allowing multiple check outs can increase productivity because users can work on the same files in parallel without waiting for files to be checked in. Changes are auto-merged when users check in files.

Binary files are always exclusively checked out.

5. Select Allow check in of files without check out to allow users to check in files that are not checked out.

If this option is selected, when users check in a repository, all checked out files and any files in a Modified status are checked in. You may want to select this option if users previously used another source control tool that supports checking in files without check out and prefer this method.

We do not recommend selecting this option because it provides less control over files.

6. Select Allow workflow state changes during check in to allow users to change file states during check in.

You may want to disable this option if you use triggers to set states during check in.

7. Select any Unicode File Options.

These options are used when auto-merging text files.

The international version of the Java Runtime Environment (JRE) contains character conversion classes and support for locales other than the US English locale. If you use this JRE you can enter the character encoding set to use. Refer to Guiffy’s Help file for a list of all supported character sets.

Select Auto-detect Text files as type UTF-8 Text if all files are Unicode or Unicode standards are not followed (e.g., files do not begin with a Byte Order Mark indicating they are Unicode). For example, select this option if you are adding 500 files and only a few are text files. You can then go to file properties to mark the text files.
Select Use UTF-8 encoding for all Text file auto-merges to automatically use UTF-8 encoding when auto-merging text and UTF-8 files.
Select a UTF-8 character encoding set.
Select a UTF-16 character encoding set.

8. Enter the Thumbnail size to set the thumbnail pixel size.

The default size is 128 by 128 pixels.

If you change the thumbnail size, you can also compact the database to purge the existing, cached thumbnails.

9. Enter or select the maximum file size for adding or checking in Large Files.

Maximum file size specifies the maximum file size limit. The default value is 2000 MB.
Delta maximum file size specifies the maximum delta file size limit. Deltas contain the content differences between file versions and are used to efficiently save new file versions. When deltas are larger than the specified limit, Surround SCM adds or checks in full copies of updated files instead. The default value is 100 MB.

10. Click OK to save the changes.