Adding proxy servers

After you install the proxy server, you must set the connection information so the proxy server can communicate with the master Surround SCM Server. You can also set options to control how the server caches files and select proxy server users.

1. Choose Tools > Administration > Proxy Maintenance.

The Proxy Server Maintenance dialog box opens.

2. Click Add.

The Add Proxy Server dialog box opens.

3. Enter a Proxy name.

Enter a unique name, such as the geographical location of the proxy server computer.

4. Enter and confirm the proxy server Password. The password authenticates the proxy server with the master server. You must enter a password.

Make sure the proxy name and password match the values set for the proxy server in the registry utility. To learn more, see Surround SCM Registry Utility.

5. Enter the Proxy address.

This is the IP or host address of the computer where the proxy server application is installed. The address must be resolvable by the clients that use the proxy.

6. Enter the Proxy port.

Clients connect to the proxy server on this port via TCP/IP. The default port number is 4901. Valid values are 1-65535. Because the proxy is a client to the master server, this port does not need to be open on the firewall to the master server. It only needs to be open on the firewall of the proxy server computer (between the proxy and Surround SCM clients using it).

The proxy server port must be different from the master Surround SCM Server port if the servers are hosted on the same computer.

7. Enter the Refresh interval to indicate how often the proxy server connects to the master server to check for updates.

The proxy server periodically connects to the master server to check the proxy server settings. The default interval is 0.5 hours. Valid values are 0.25-24 hours.

8. Enter the Minimum file size for cache to set the minimum size of files to be cached.

Files smaller than the specified size are not cached and are always retrieved from the master server. The default size is 10 KB.

9. Select any additional options.

  • Maximum cache disk space sets the maximum amount of space the proxy server can use to the specified limit. If the cache exceeds the maximum disk space, the least recently used files are deleted from the cache.
  • Age limit sets the number of days to keep retrieved files in the proxy server cache.
  • Auto pre-cache recently requested files automatically checks for and retrieves newer file versions from the master server based on the files in the proxy server cache. Select Every day to pre-cache files every day at the specified time. Select Every refresh to pre-cache files when the proxy server refreshes, which is set in the Refresh interval field.
An automatic pre-cache only evaluates the last 1,000 files in the cache. If you need to pre-cache more than 1,000 files, use a batch file to get the files to a temporary or working directory. To learn more about getting files, see Surround SCM command-line interface (CLI).
  • Encrypt transactions between proxy server and master server encrypts messages sent between servers. Messages and file transfers are encrypted with a 512-bit key. Encryption provides a higher level of security, but may slow performance because of the time spent encrypting and decrypting messages.
  • Encrypt transactions between proxy server and clients encrypts messages sent between the proxy server and Surround SCM clients.
  • Compress transactions between proxy server and master server compresses data during file transfers. Compress files if you have a slow connection to the master server.

10. Select the Default Proxy Server Users. These users automatically use the proxy server to retrieve files.

  • To add a user, select the user in the Available users list and click Add to move the user to the Selected users list.
  • To remove a user, select the user in the Available users list and click Remove to move the user to the Available users list.
Users can change override the proxy server set by the administrator. See Setting proxy server options.

11. Click OK.

The proxy server is added.

We recommend adding a proxy server to the master server before installing the proxy server application. If the proxy server application is already installed and you add the connection information to Surround SCM, use the registry utility to configure the proxy server settings. The server name, password, and port number must match between the registry utility and Surround SCM. See Editing proxy server options.