lustre/doc/mount.lustre.8

   1 .\" -*- nroff -*-
   2 .\" Copyright 2006 by Cluster FileSystems.  All Rights Reserved.
   3 .\" This file may be copied under the terms of the GNU Public License.
   4 .\"
   5 .TH mount.lustre 8 "2006 Jun 15" Lustre "configuration utilities"
   6 .SH NAME
   7 mount.lustre \- start a Lustre client or target service
   8 .SH SYNOPSIS
   9 .br
  10 .BI "mount \-t lustre [\-o " options "] " "device dir"
  11 .SH DESCRIPTION
  12 .B mount.lustre
  13 is used to start a Lustre client or target service.  This program should not be
  14 called directly; rather it is a helper program invoked through
  15 .BR mount (8)
  16 as above.  Lustre clients and targets are stopped by using the
  17 .BR umount (8)
  18 command.
  19 .br
  20
  21 There are two forms for the
  22 .I device
  23 option, depending on whether a client or a target service is started:
  24 .TP
  25 .BI <mgsspec>:/<fsname>
  26 This is a client mount command to mount the Lustre filesystem named
  27 <fsname> by contacting the Management Service at <mgsspec>.  The format for
  28 <mgsspec> is defined below.
  29 .TP
  30 .BI <disk_device>
  31 This starts the target service defined by the
  32 .I mkfs.lustre
  33 command on the physical disk <disk_device>
  34 .SH OPTIONS
  35 .TP
  36 .BI <mgsspec>:= <mgsnode>[:<mgsnode>]
  37 The mgs specification may be a colon-separated list of nodes...
  38 .TP
  39 .BI <mgsnode>:= <mgsnid>[,<mgsnid>]
  40  ...and each node may be specified by a comma-separated list of NIDs.
  41 .PP
  42 In addition to the standard mount options, Lustre understands the following
  43 .I client-specific
  44 options:
  45 .TP
  46 .BI flock
  47 Enable flock support
  48 .TP
  49 .BI noflock
  50 Disable flock support
  51 .TP
  52 .BI user_xattr
  53 Enable get/set user xattr
  54 .TP
  55 .BI nouser_xattr
  56 Disable user xattr
  57 .TP
  58 .BI acl
  59 Enable ACL support
  60 .TP
  61 .BI noacl
  62 Disable ACL support
  63 .PP
  64 In addition to the standard mount options and backing disk type
  65 (e.g. LDISKFS) options, Lustre understands the following
  66 .I server-specific
  67 options:
  68 .TP
  69 .BI nosvc
  70 Only start the MGC (and MGS, if co-located) for a target service, and not the actual service.
  71 .TP
  72 .BI exclude= ostlist
  73 Start a client or MDT with a (colon-separated) list of known inactive OSTs
  74 .TP
  75 .BI abort_recov
  76 Abort recovery (targets only)
  77 .SH EXAMPLES
  78 .TP
  79 .B mount -t lustre cfs21@tcp0:/testfs /mnt/myfilesystem
  80 Start a client for the Lustre filesystem 'testfs' at the mount point
  81 /mnt/myfilesystem. The Management Service is running on a node reachable
  82 from this client via the nid cfs21@tcp0.
  83 .TP
  84 .B mount -t lustre /dev/sda1 /mnt/test/mdt
  85 Start the Lustre target service on /dev/sda1.
  86 .TP
  87 .B mount -t lustre -L testfs-MDT0000 -o abort_recov /mnt/test/mdt
  88 Start the testfs-MDT0000 service (by using the disk label), but abort the
  89 recovery process.
  90 .SH BUGS
  91 Please report all bugs to Cluster FileSystems, support@clusterfs.com
  92 .SH AVAILABILITY
  93 .B mount.lustre
  94 is part of the
  95 .BR Lustre (7)
  96 filesystem package and is available from CFS
  97 .br
  98 http://clusterfs.com
  99 .SH SEE ALSO
 100 .BR Lustre (7),
 101 .BR mount (8),
 102 .BR mkfs.lustre (8),
 103 .BR tunefs.lustre (8),
 104 .BR lctl (8),
 105 .BR lfs (1)