OS X Server (Mountain Lion): Advanced configuration of the Caching service
If you're running OS X Server (Mountain Lion), read on to learn about the advanced settings you can use with the Caching service.
If you're running OS X Server (Mavericks), see the "Configure advanced cache settings" section of the OS X Server Advanced Administration Guide to learn about the Caching service's advanced settings.
For more information about the Caching service, run the Server app and choose Server Help from the Help menu.
You can specify advanced configuration settings for the Caching service with the command line or by editing /Library/Server/Caching/Config/Config.plist. The keys and description of values are listed below.
Note: Settings in the Config.plist file not outlined below should not be changed.
|CacheLimit||0 (unlimited)||The maximum number of bytes of disk space will be used to cache assets. This can be set using Server app.|
|DataPath||/Library/Server/Caching/Data||The path to the directory used to store cached assets. This can be set using Server app.|
|Interface||Listen on all interfaces||The BSD name of a network interface to be used by the Caching service.|
|ListenRanges||None||An array of dictionaries used to define which Caching servers clients on a given network will prefer. More details are outlined below.|
|ListenRangesOnly||False||If ListenRangesOnly is set to true, it will cause the server to provide assets only to clients in the ranges specified by the ListenRanges key. You must specify the ListenRanges key in order to use the ListenRangesOnly key.|
|LogLevel||info||The level of verbosity used when logging. You can set this to any of the following:
|MaxConcurrentClients||0 (allow unlimited clients)||The maximum allowed number of simultaneous client requests.|
|Port||0 (use any port)||The TCP port number on which the Caching service accepts requests for downloads.|
|ReservedVolumeSpace||25000000000||The minimum number of bytes of free disk space to be maintained for the volume which stores the cached assets.|
The ListenRanges key
The ListenRanges key can be used to specify preferred Caching servers in advanced network topologies where multiple Caching servers are used behind the same public IP address. For example:
- caching1.example.com uses the ListenRanges key to specify a range of 10.0.0.1 through 10.0.0.254 and 10.1.0.1 through 10.1.0.254.
- caching2.example.com uses the ListenRanges key to specify a range of 10.1.0.1 through 10.1.0.39 (note the overlap with caching1's second range).
- If a client whose IP address is 10.0.0.10 requests an asset, it will be directed to caching1.
- If a client whose IP address is 10.1.0.10 requests an asset, it will be directed to either caching1 or caching2. The server will be chosen randomly.
- If a client whose IP address is 10.2.0.10 requests an asset, it will be directed to either caching1 or caching2. The server will be chosen randomly.
- If caching1 is shut down or loses power but caching2 remains available, all clients will be directed to caching2.
Setting values for a key
To set a key with a simple value, you can use the serveradmin(8) command. For example, to set the Interface key to en1, you would execute this command as an administrator:
sudo serveradmin settings caching:Interface = en1
The ListenRanges key has a complex value, making it easier to edit /Library/Server/Caching/Config/Config.plist in order to set it. If you edit this file manually, be sure to first stop the Caching service and quit Server app. Once you've finished editing the file, set the user and group ownership to _assetcache prior to starting the Caching service with this command:
sudo chown _assetcache:_assetcache /Library/Server/Caching/Config/Config.plist
Below is an example Config.plist file.
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>CacheLimit</key> <!-- Set a CacheLimit of 200 GB --> <integer>200000000000</integer> <key>DataPath</key> <string>/Volumes/BigDisk/Caching/Data</string> <key>Interface</key> <string>en1</string> <key>ListenRanges</key> <array> <dict> <key>type</key> <string>IPv4</string> <key>first</key> <string>10.0.0.1</string> <key>last</key> <string>10.0.0.254</string> </dict> <dict> <key>type</key> <string>IPv4</string> <key>first</key> <string>10.1.0.1</string> <key>last</key> <string>10.1.0.254</string> </dict> </array> <key>ListenRangesOnly</key> <true/> <key>LogLevel</key> <string>info</string> <key>MaxConcurrentClients</key> <integer>100</integer> <key>Port</key> <integer>12345</integer> <key>ReservedVolumeSpace</key> <!-- Set the ReservedVolumeSpace to 1 GB --> <integer>1000000000</integer> </dict> </plist>