文档

​
​

Development

User Acquisition

Monetization

工业

Unity Version Control

DevOps

On-prem

Gluon

Editor plug-in

Open Unity Dashboard

Unity Version Control

此页面不支持所选语言。
​
​
Unity Version Control
  • Overview
  • Cloud Repositories organization update
  • Installation
  • Use UVCS with the Unity Editor
  • Unity Version Control plugins
  • Concepts
  • Tutorials
  • On-Prem
    • Server configuration
    • Client configuration
    • Manage On-Prem licenses
    • Stop, start, or restart server
    • Server administration console
    • Configure UVCS
      • Server configuration files
      • Configure lock rules
      • Merge rules
      • Configure file compression
      • Proxy servers
      • Use a proxy server
      • Support alternative connections to a server
      • Configure repository storage
    • Use server read-only mode
    • Back up and restore data
    • Archive revisions
    • Force client upgrades
    • SSL certificates
    • GitServer
    • Use SAML authentication with Microsoft Entra
  • Gluon
  • CLI and shortcut references
  • Release Notes
  1. Unity Version Control (previously Plastic SCM)

Configure repository storage

Configure the backend for the storage of repositories.
阅读时间3 分钟
最后更新于 6 个月前
Configure the Unity Version Control (UVCS) back end. UVCS uses its own back end, Jet, as storage for repositories. Jet works to specifically deal with the way UVCS handles data reads and writes. For UVCS On-Prem, Jet uses high-scalability workload.
Configure UVCS to work with Jet in one of the following ways:
  • Manage the Repository storage settings from the server administration console.
  • Create or edit the 
    jet.conf
    file    .

Use the server administration console

  1. Launch the server administration console.
  2. Select Configuration > Repository storage.
  3. If the server is configured to work with another back end, change to the Jet repository storage:
    • Select Change storage.
    • Select Jet as your new repository storage.
    • Enter a database path. If you leave the path empty, UVCS saves the databases under the 
      server
      folder in the UVCS installation directory.
    • Choose whether you want to Migrate existing repositories or start with new empty repositories.
    • Select Change storage to change to the new storage. Note: To migrate your data, you need to stop the UVCS server which can take time if your repositories have lots of data. While the migration runs, your users can't access the UVCS server.
  4. Configure the values for the following parameters: 
    • Database path
      - Set the directory where Jet back end stores the files. Warning: Changing this path doesn't perform any actions on disk. This means that you need to manually move the repository data files unless you want to discard the repositories.
    • Max size of blob files
      - Specify the maximum size in GB for blob files, which store versioned file contents. Once the maximum size (in GB) for a file is reached, UVCS creates a new file so files don't grow too large for the underlying file system.
    • Max cached trees
      - Specify the maximum number of changesets whose directory trees are cached to reduce disk access. This value enables you to balance performance and memory usage.

Use the 
jet.conf
file

Edit or create the 
jet.conf
file under the 
server
folder in the UVCS installation directory to configure Jet.
The only required parameter is 
basepath
. Use the 
basepath
parameter to specify where to store the repositories data files.
重要
If you change the 
basepath
value, it doesn't perform any actions on disk. This means you need to manually move the repository data files unless you want to discard the repositories.

Optional parameters

Optionally, you can also configure the following parameters:

Parameter

Description

Usage

blobspath
Specify the path where Jet stores blobs.Allows you to store blobs and metadata in different paths. The recommended best practice is to store blobs in slower or cheaper storage than metadata to avoid excessive storage costs.
prefix
Create a prefix for the database name.Useful if you have multiple UVCS servers to avoid database name conflicts.
suffix
Append a string to the name of every database that UVCS creates on the back end.Helps prevent interference if you use the same back end for multiple servers.
datafilesize
Define the maximum size (in GB) for each repository's blob file.Creates new files once the limit is reached to prevent individual files from becoming too large for the file system.
maxcachedtrees
Specify the maximum number of changesets with cached directory trees.Reduces disk access and balances memory usage to improve performance.
maxcachessizeingb
Define the maximum memory (in GB) that caches use.Limits the amount of memory used by caches to optimize system memory consumption.
maxcachessizefreepercent
Defines the percentage of a cache to clean when memory usage exceeds the limit.Helps manage memory by Cleans the least recently used repositories when the set memory limit is exceeded (the default is 25%) to manage memory. . Memory doesn't release until the garbage collector runs a full collection.

Example 
jet.conf
files

basepath=/mnt/metadatablobspath=/mnt/blobsmaxcachedtrees=50datafilesize=4
basepath=c:\Users\maria\plasticdbprefix=zerosuffix=
basepath=/mnt/datamaxcachessizeingb=2maxcachessizefreepercent=30
Copyright © 2026 Unity Technologies
法律信息隐私政策CookiesDocumentation Terms of Use请勿出售或分享我的个人信息您的隐私选择（Cookie 设置）

“Unity”、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属公司在美国和其他地方的商标或注册商标（此处查看更多信息)。其他名称或品牌是其各自所有者的商标。

为方便起见，一些页面是机器翻译的，可能包含不准确的内容。如有信息不一致的情况，以英文版本为准。

  • 在本页上

    • Use the server administration console

    • Use the jet.conf file

      • Optional parameters

      • Example jet.conf files

报告此页面的问题