Configure recommended settings for Xsan volumes created in OS X Server (Yosemite)

Learn how to set the recommended values for Xsan volumes created in OS X Server (Yosemite).

Before You Begin

This article applies to volumes created with Server version 4.0. Volumes created with Server 4.0.3 or later are not affected by this issue.

Volumes created with OS X Server v4.0

Xsan volumes created in OS X Server (Yosemite) don't include certain volume configuration settings. For best results, use these steps to set the recommended values for these settings:

1. Make a backup copy of the volume's current .cfgp file from /Library/Preferences/Xsan.

2. Use the following Terminal commands to set the recommended values for volume configuration:

sudo /usr/libexec/PlistBuddy -c "Add :config:globals:bufferCacheSize string 33554432" /Library/Preferences/Xsan/volumeName.cfgp

sudo /usr/libexec/PlistBuddy -c "Add :config:globals:inodeCacheSize string 32768" /Library/Preferences/Xsan/volumeName.cfgp

sudo /usr/libexec/PlistBuddy -c "Add :config:globals:threadPoolSize string 256” /Library/Preferences/Xsan/volumeName.cfgp

sudo /usr/libexec/PlistBuddy -c "Add :config:globals:maxConnections string 256" /Library/Preferences/Xsan/volumeName.cfgp

3. Then use this Terminal command to propagate the new configuration for the volume to other Xsan metadata controllers:

sudo xsanctl pushConfigUpdate

4. Go to the Xsan pane in Server app and select the volume from the Volumes list. Then choose Stop Volume from the gear menu at the bottom of the window.

5. Once the volume status shows it's offline, choose Start Volume from the gear menu to restart the volume with the new settings applied.

Learn more

Yosemite Xsan clients may not mount volumes if they exceed max connections. Xsan volumes created with Server 4.0 default to a maxConnections value of 10. See this article for more information.