lustre/doc/mount.lustre.8

   1 .\" -*- nroff -*-
   2 .\" Copyright 2006 by Cluster FileSystems.  All Rights Reserved.
   3 .\" Copyright 2008 by Sun Microsystems.  All Rights Reserved.
   4 .\" This file may be copied under the terms of the GNU Public License v2.
   5 .\"
   6 .TH mount.lustre 8 "2008 Mar 15" Lustre "configuration utilities"
   7 .SH NAME
   8 mount.lustre \- start a Lustre client or target service
   9 .SH SYNOPSIS
  10 .br
  11 .BI "mount \-t lustre [\-o " options "] " directory
  12 .SH DESCRIPTION
  13 .B mount.lustre
  14 is used to start a Lustre client or target service.  This program should not be
  15 called directly; rather it is a helper program invoked through
  16 .BR mount (8)
  17 as above.  Lustre clients and targets are stopped by using the
  18 .BR umount (8)
  19 command.
  20 .br
  21
  22 There are two forms for the
  23 .I device
  24 option, depending on whether a client or a target service is started:
  25 .TP
  26 .IR <mgsspec> :/ <fsname>
  27 mounts the Lustre filesystem named
  28 .I fsname
  29 on the client by contacting the Management Service at
  30 .IR mgsspec
  31 on the pathname given by
  32 .IR directory .
  33 The format for
  34 .I mgsspec
  35 is defined below.  A mounted client filesystem appears in
  36 .BR fstab (5)
  37 and is usable like any local filesystem and provides a full
  38 POSIX-compilant interface.
  39 .TP
  40 .I disk_device
  41 starts the target service defined by the
  42 .I mkfs.lustre
  43 command on the physical disk
  44 .IR disk_device .
  45 A mounted target service filesystem is only useful for
  46 .BR df (1)
  47 operations and appears in
  48 .BR fstab (5)
  49 to show the device is in use.
  50 .SH OPTIONS
  51 .TP
  52 .BI <mgsspec>:= <mgsnode>[:<mgsnode>]
  53 The mgs specification may be a colon-separated list of nodes:
  54 .TP
  55 .BI <mgsnode>:= <mgsnid>[,<mgsnid>]
  56 each node may be specified by a comma-separated list of NIDs.
  57 .PP
  58 In addition to the standard options listed in
  59 .BR mount (8),
  60 Lustre understands the following
  61 .B client-specific
  62 options:
  63 .TP
  64 .BI flock
  65 Enable full flock support, coherent across all client nodes.
  66 .TP
  67 .BI localflock
  68 Enable local flock support, using only client-local flock (faster, for applications that require flock but do not run on multiple nodes).
  69 .TP
  70 .BI noflock
  71 Disable flock support entirely.  Applications calling flock will get an error.
  72 .TP
  73 .BI user_xattr
  74 Enable get/set of extended attributes by regular users.  See the
  75 .BR attr (5)
  76 manual page.
  77 .TP
  78 .BI nouser_xattr
  79 Disable use of extended attributes by regular users.  Root and system processes can still use extended attributes.
  80 .TP
  81 .BI acl
  82 Enable POSIX Access Control List support.  See the
  83 .BR acl (5)
  84 manual page.
  85 .TP
  86 .BI noacl
  87 Disable Access Control List support.
  88 .PP
  89 In addition to the standard mount options and backing disk type
  90 (e.g. ext3) options listed in
  91 .BR mount (8),
  92 Lustre understands the following
  93 .B server-specific
  94 options:
  95 .TP
  96 .BI nosvc
  97 Only start the MGC (and MGS, if co-located) for a target service, and not the actual service.
  98 .TP
  99 .BI nomgs
 100 Start a MDT with a co-located MGS without starting the MGS.
 101 .TP
 102 .BI exclude= ostlist
 103 Start a client or MDT with a (colon-separated) list of known inactive OSTs.
 104 .TP
 105 .BI abort_recov
 106 Abort client recovery and start the target service immediately.
 107 .SH EXAMPLES
 108 .TP
 109 .B mount -t lustre cfs21@tcp0:/testfs /mnt/myfilesystem
 110 Start a client for the Lustre filesystem 'testfs' at the mount point
 111 /mnt/myfilesystem. The Management Service is running on a node reachable
 112 from this client via the nid cfs21@tcp0.
 113 .TP
 114 .B mount -t lustre /dev/sda1 /mnt/test/mdt
 115 Start the Lustre metadata target service from /dev/sda1 on mountpoint /mnt/test/mdt.
 116 .TP
 117 .B mount -t lustre -L testfs-MDT0000 -o abort_recov /mnt/test/mdt
 118 Start the testfs-MDT0000 service (by using the disk label), but abort the
 119 recovery process.
 120 .SH BUGS
 121 Not very many mount options can be changed with
 122 .BR "-o remount" .
 123 Please report all bugs to Sun Microsystems using http://bugzilla.lustre.org/
 124 .SH AVAILABILITY
 125 .B mount.lustre
 126 is part of the
 127 .BR Lustre (7)
 128 filesystem package and is available from Sun Microsystems, Inc.
 129 .br
 130 http://downloads.lustre.org
 131 .SH SEE ALSO
 132 .BR Lustre (7),
 133 .BR mount (8),
 134 .BR mkfs.lustre (8),
 135 .BR tunefs.lustre (8),
 136 .BR lctl (8),
 137 .BR lfs (1)