Use a proxy server

You can use a proxy server with Unity Version Control (UVCS) to help you balance traffic between two machines. For more information, refer to Proxy servers.

The UVCS proxy server is bundled as a sub command of the UVCS server executable file.

To start the proxy, run plasticd proxy.

Windows operations

The following operations are available with the plasticd proxy sub command:

  • Install the proxy service: plasticd proxy --installservice.
  • Start the proxy service: plasticd proxy --start.
  • Stop the proxy service: plasticd proxy --stop.
  • Restart the proxy service: plasticd proxy --restart.
  • Print the status of the proxy service: plasticd proxy --status.
  • Stop and uninstall the proxy service: plasticd proxy --uninstallservice.

Configure the proxy server

To configure your proxy server, you can edit the configuration file.

You can find the plasticcached.network.conf file in the \PlasticSCM5\server\config_samples directory:

[
  {
    "port": 8085,
    "type": "tcp",
    "security": "none"
  }
]

Configure the clients

UVCS clients need to configure the proxy server:

  1. Select Preferences from the context menu.
  2. Check the Use a Proxy server box and enter the proxy server name in server:port format. By default, the port is 8085.
  3. Select Connect to verify the connection is ready.
  4. Select OK.

Cache data from UVCS cloud

To cache data from the cloud, install a Proxy (and your client too if you use encrypted data in the Cloud) and start to cache data.

You can limit the size of the on-disk cache.

Configure the disk cache limit

To configure the disk cache limit, edit the MaxCacheSizeInGb setting in the plasticcached.conf file. For example, the following value ensures that the proxy cache size doesn’t exceed 20.5 GB.

<PlasticCacheConf>
  <MaxCacheSizeInGb>20.5</MaxCacheSizeInGb>
</PlasticCacheConf>

A value of 0 disables the limit.

Note: For more information on proxy storage and how the UVCS monitors storage with the log file, refer to proxy storage.