Xsan: Advanced options for mounting Xsan volumes
There are several advanced command line options for controlling how Xsan volumes are mounted on Xsan clients. This article explains how to use the xsanctl command options.
Xsan 2.2, Xsan 2.3, Xsan 3
The following arguments may be used with the xsanctl command to provide additional control over how an Xsan volume is mounted. The xsanctl command must be run on each computer where you want to use the given mount options.
- The argument --at will specify that the Xsan volume should mount over a specific folder, instead of the standard location in /Volumes. This option will persist through subsequent mounts and restarts.
- The argument --ro will allow the Xsan volume to be mounted read-only instead of the standard read-write.
- The argument --rw will allow the Xsan volume to be mounted read-write. This can be used to change a volume that was previously configured to mount read-only. This is the default value for Xsan clients.
- The argument --threads will adjust the number of threads used by the Xsan client for I/O requests. This option is not recommended for normal use and should be tested thoroughly before using in a production environment.
- The argument --dircachesize will set the size of the directory information cache on Xsan clients. This cache could improve the speed of certain functions such as reading directories in some circumstances. The default value of 10485760 is fine for most usage scenarios. This option is not recommended for normal use and should be tested thoroughly before using in a production environment.
For best results, adjustments to the default values for --threads and --dircachesize should be done in small increments and tested thoroughly before deploying into a production environment.
These examples of the options listed above use a volume name of "MyVolume":
xsanctl mount MyVolume --at /MyVolume
xsanctl mount MyVolume --ro
xsanctl mount MyVolume --at /MyVolume --ro