lustre/doc/lustre.7

   1 .\" -*- nroff -*-
   2 .\" Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
   3 .\" This file may be copied under the terms of the GNU Public License.
   4 .\"
   5 .\" Copyright (c) 2015, 2016, Intel Corporation.
   6 .\"
   7 .TH LUSTRE 7 "2021 Nov 08" Lustre "A high-performance cluster file system"
   8 .SH NAME
   9 Lustre
  10 .SH SYNOPSIS
  11 A high-performance file system designed for Linux clusters.
  12 .SH DESCRIPTION
  13 .B Lustre
  14 is a high-performance, massively-scalable, POSIX-compliant GPL network file
  15 system that runs on the world's largest high-performance compute clusters.
  16
  17 Lustre filesystems are made up of multiple services typically distributed
  18 across multiple server nodes.  Lustre clients can contact these server nodes
  19 over multiple high-speed network fabrics via LNet, the Lustre Network
  20 system.  Clients then present the filesystem at a mount point to userspace.
  21
  22 A Lustre filesystem is comprised of one or more
  23 .IR MDTs ,
  24 MetaData Targets, which store directory and file meta-information such as
  25 file ownership, timestamps, access permissions, etc, and one or more
  26 .IR OSTs ,
  27 Object Storage Targets, which hold each file's data in one or more objects.
  28 There is sometimes, but not always, a 1:1 mapping of regular files on a
  29 client to OST objects on the server.  Each file may have a different
  30 mapping of file offset to one or more OST object(s), known as the file
  31 layout, that can be managed with the
  32 .BR lfs-setstripe (1)
  33 command.
  34
  35 Lustre and LNet are implemented as a series of Linux kernel modules, for both
  36 servers and clients.  LNet networks are defined in the modprobe.conf file on
  37 all nodes.  Lustre is started on the clients and servers using the
  38 .BR mount (8)
  39 command.
  40
  41 .SH COMMANDS
  42 .TP
  43 .BR mkfs.lustre (8)
  44 Format a Linux block device for use as a Lustre server's backend storage
  45 (aka target).
  46 .TP
  47 .BR tunefs.lustre (8)
  48 Modify configuration information on a Lustre target disk.
  49 .TP
  50 .BR mount.lustre (8)
  51 A helper program for
  52 .BR mount (8)
  53 that starts Lustre servers and clients mounts the client filesystem.
  54 .TP
  55 .BR lctl (8)
  56 A low-level tool for administrators to control Lustre configuration.
  57 .TP
  58 .BR lfs (1)
  59 A user-level tool to control Lustre-specific information for
  60 individual files.
  61 .SH BUGS
  62 Please report all bugs https://jira.whamcloud.com/
  63 .SH AVAILABILITY
  64 .B The
  65 .BR Lustre (7)
  66 filesystem packages are available for download at:
  67 .br
  68 https://downloads.whamcloud.com/
  69 and GPL source code is available at:
  70 .br
  71 https://git.whamcloud.com/
  72 .SH SEE ALSO
  73 .BR mkfs.lustre (8),
  74 .BR tunefs.lustre (8),
  75 .BR mount.lustre (8),
  76 .BR lctl (8),
  77 .BR lfs (1),
  78 .BR llobdstat (8),
  79 .BR llstat (8),
  80 .BR llverdev (8),
  81 .BR llog_reader (8),
  82 .BR lshowmount (8),
  83 .BR lustreapi (7),
  84 .BR lustre_rsync (8)