Whamcloud - gitweb
LUDOC 299 protocol: Spell-check document
[doc/protocol.git] / introduction.txt
1 Introduction
2 ------------
3
4 The Lustre parallel file system provides a global POSIX namespace for
5 the computing resources of a data center. Lustre runs on Linux-based
6 hosts via kernel modules, and delegates block storage management to
7 the servers while providing object-based storage to its
8 clients. Servers are responsible for both data objects (the contents
9 of actual files) and index objects (for directory information). Data
10 objects are gathered on Object Storage Servers (OSSs), and index
11 objects are stored on Metadata Servers (MDSs). Each storage volume is
12 a target with Object Storage Targets (OSTs) on OSSs, and Metadata
13 Targets (MDTs) on MDSs.  Clients assemble the data from the MDTs and
14 OSTs to present a single coherent POSIX-compliant file system. The
15 clients and servers communicate and coordinate among themselves via
16 network protocols. A low-level protocol, LNet, abstracts the details
17 of the underlying networking hardware and presents a uniform
18 interface, originally based on Sandia Portals <<PORTALS>>, to Lustre
19 clients and servers. Lustre, in turn, layers its own protocol atop
20 LNet. This document describes the Lustre protocol.
21
22 The remainder of the introduction presents several concepts that
23 illuminate the operation of the Lustre protocol. In
24 <<file-system-operations>> a subsection is devoted to each of several
25 semantic operations (setattr, statfs, ...). That discussion introduces
26 the RPCs of the Lustre protocol, to give an idea of how RPCs are used
27 to implement the file system. In <<lustre-rpcs>> each RPC of the
28 Lustre protocol is presented in turn.
29
30 include::client.txt[]
31
32 include::target.txt[]
33
34 include::rpc.txt[]
35
36 include::connection.txt[]
37
38 include::transno.txt[]
39
40 include::path_lookup.txt[]
41
42 include::lov_index.txt[]
43
44 include::grant.txt[]
45
46 include::ldlm.txt[]
47
48 include::llog.txt[]
49
50 include::security.txt[]
51