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

Page 156

Advertising
background image

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

Advertising