Control the xsan file system (xsanctl) – Apple Xsan 2 User Manual
Page 156

156
Appendix C
Use command-line tools
Control the Xsan file system (xsanctl)
Use the
xsanctl
command to control basic Xsan file system functions. For details, see
the
xsanctl
man page.
$ sudo xsanctl command
xsanctl commands
xsanctl command
Description
ping
Sends a ping message to the Xsan file system
to verify that it’s responding to management
requests.
mount volume [options]
Mounts an Xsan volume on the computer.
If successfully mounted, the volume will be
automounted at startup.
volume
– the name of the volume
options
– a space-delimited list of options for
the mount operation. Automatic remounts of this
volume also use the given mount options. If no
options are given, the options used for the last
mount operation are used.
Valid mount options are most of the mount
options recognized by the
mount_acfs
command. The few
mount_acfs
mount options
that don’t apply to Xsan are ignored. Options are
given by name and prefaced by two dashes (
--
).
For example, to disable atime updates, use the
noatime
option of
mount_acfs
like this:
xsanctl mount --noatime
For options that pass a parameter, the option
name is followed by an equals sign (
=
) and then
the option. For example, to specify that the kernel
should create 12 threads for the mount point, use:
xsanctl mount --threads=12
If you use the
--at
option, make sure it specifies
a location in the root file system. Xsan volumes
mounted atop other file systems may not
automatically remount correctly.
For more information about available options, see
the
mount_acfs
man page.
unmount volume
Unmounts an Xsan volume on the computer. If
successfully unmounted, the volume won’t be
automounted at startup.
volume
– the name of the volume