From Seapine Labs
The Surround SCM Proxy Server, which was introduced in version 2008, is a file caching proxy that improves performance of file retrievals at remote locations. As such, the proxy server is usually installed on a separate computer from the master server at the remote location where the clients using the proxy reside. This is not a requirement.
 About the proxy server
The proxy server is a client of the master Surround SCM Server and a server to Surround SCM client applications. This means it listens for transactions from Surround clients (GUI clients and the CLI), and it connects to the Surround SCM master server to get files that meet client requests. The proxy server needs the same connection information that the Surround clients use to connect to the master server. The master server also needs connection information to provide to the clients that use the proxy.
Keep the following in mind:
 Recommended installation and configuration steps
To ensure security of the master Surround SCM Server data, you must configure it to accept connections from known proxy servers before attempting to use the proxy server. The installation and configuration of the proxy server requires information about both the Surround SCM Server and proxy servers. You must set the configuration options on both computers.
We strongly recommend adding a proxy server to the master Surround SCM Server before installing the proxy server. However, if the proxy server is already installed and you add a proxy server to Surround SCM, you can use the registry utility to configure the proxy server settings.
 Setting up a proxy server
You need the following information to set up a proxy server.
 Configuring the master server
Before a proxy server is allowed to connect to a master server, you must configure the master server to accept proxy requests.
In the Surround SCM client, choose Tools > Administration > Proxy Maintenance. Enter the following in the Proxy Maintenance dialog.
The configuration information regarding limits on proxy server disk usage or how long files are cached on the proxy is optional. You can set the options when configuring the master server or modify them later.
 Configuring the proxy server
After you configure a proxy server definition on the master Surround SCM Server, you can run the Surround SCM installer to install just the proxy server on the proxy computer. During the installation enter the required name, password, and connection information when prompted.
If the proxy server is already installed and you configured a proxy server definition, you can use the Surround SCM Registry Utility to configure the proxy server.
The proxy server is installed in the 'Surround application directory' specified during the installation (e.g., Windows - C:\Progam Files\Seapine\Surround SCM or
The Surround SCM Registry Utility is located in the application directory (e.g., Windows - Surround SCM Registry Utility.exe or Mac OS X/Linux - scmregistryutil). Run the registry utility and use it to set the proxy server options.
 Starting the proxy server
The method for starting the proxy server depends on the platform, and whether you installed it as a service or as an application.
If you installed the proxy server as a service, open the Control Panel and double-click Administrative Tools. Double-click Services. Select the Surround SCM Proxy Server from the Services list and start the service. The proxy server will automatically connect to the configured master Surround SCM Server.
If you are running the proxy server as an application, double-click the proxy server icon in the Surround SCM application directory. The proxy server will connect to the configured master Surround SCM Server.
Enter surroundscmproxy start. The proxy server will connect to the configured master Surround SCM Server.
 Mac OS X
Start the proxy server from System Preferences. The proxy server will connect to the configured master Surround SCM Server.
 Troubleshooting help
If the proxy server does not start, check the SCMProxyStartup.log file for error messages. By default the startup log is located in the Surround SCM application directory on Windows or \var\log on Linux and Mac OS X.
Following are some common reasons why the proxy server may not start: