Whamcloud - gitweb
92194fb3100deeb3d4fd648a0a789c42534d6e9f
[doc/protocol.git] / glossary.txt
1 [glossary]
2 Glossary
3 --------
4 Here are some common terms used in discussing Lustre, POSIX semantics,
5 and the protocols used to implement them.
6
7 [glossary]
8 back end file system::
9 Storage on a server in support of the object store or of metadata is
10 stored on the back end file system. The two available file systems are
11 currently ldiskfs and ZFS.
12
13 Client::
14 A Lustre client is a computer taking advantage of the services
15 provided by MDSs and OSSs to assemble a POSIX-compliant file system
16 with its namespace and data storage capabilities.
17
18 Distributed Lock Manager::
19 The distributed lock manager (DLM, often referred to as the Lustre
20 Distributed Lock Manager, or LDLM) is the service that enforces a
21 consistent (cache-coherent) view of the data objects in the file
22 system.
23
24 early reply::
25 A partial message reply returned in response to a request message
26 that allows the target to indicate to the requestor to increase its
27 timeout value without otherwise indicating the request has progressed.
28
29 export::
30 The term for the per-client shared state information held by a server.
31
32 extent:: A range of offsets in a file.
33
34 import::
35 The term for the per-target shared state information held by a client.
36
37 Inodes and Extended Attributes::
38 Metadata about a Lustre file is encoded in the extended attributes of
39 an inode in the back-end file system on the MDT. Some of that
40 information establishes the stripe layout of the file. The size of the
41 stripe layout information may be different for each file. The amount
42 of space reserved for layout information is a small as possible given
43 the maximum stripe count on the file system. Clients, servers,
44 and the distributed lock manager will all need to be aware of this
45 size, which is communicated in the 'ocd_max_easize' filed of the
46 <<obd_connect_data>> structure.
47
48 LNet::
49 A lower level protocol employed by PtlRPC to abstract the mechanisms
50 provided by various hardware centric protocols, such as TCP or
51 Infiniband.
52
53 The Log Subsystem::
54
55 Fixme:
56 The log subsystem (LOG) is something I have no idea about right now.
57
58 Logical Object Volume::
59 The logical object volume (LOV) layer abstracts the targets on a server.
60
61 Management Server::
62 The Management Server (MGS) maintains an understanding of the other
63 servers, targets, and client in the Lustre file system. It holds their
64 identities and keeps track of disconnections and reconnections in
65 order to support imperative recovery.
66
67 Metadata Server::
68 A metadata server (MDS) is a computer responsible for running the
69 Lustre kernel services in support of managing the POSIX-compliant name
70 space and the indices associating files in that name space with the
71 locations of their corresponding objects. As of Lustre 2.4 there can be
72 multiple MDSs in a single Lustre file system.
73
74 Metadata Target::
75 A metadata target (MDT) is the service provided by an MDS that
76 mediates the management of name space indices on the underlying file
77 system hardware. As of Lustre 2.4 there can be multiple MDTs on an MDS.
78 An MDT can be served by different MDS nodes at different times, but
79 will only be available from a single MDS at any given time.
80
81 Object Based Disk::
82 Object Based Disk (OBD) is the term used for any target, MDT or OST.
83
84 Object Storage Server::
85 An object storage server (OSS) is a computer responsible for running
86 Lustre kernel services in support of managing bulk data objects on the
87 underlying storage. There can be multiple OSSs in a Lustre file
88 system.
89
90 Object Storage Target::
91 An object storage target (OST) is the service provided by an OSS that
92 mediates the placement of data objects on the specific underlying file
93 system hardware. There can be multiple OSTs on a given OSS.  An OST
94 may be served by different OSS nodes at different times, but will
95 only be available from one OSS at any given time.
96
97 protocol::
98 An agreed upon formalism for communicating between two entities, such
99 as between two servers or between a client and a server.
100
101 PtlRPC::
102 The protocol (or set of protocols) implemented via RPCs that is (are)
103 employed by Lustre to communicate between its clients and servers.
104
105 Remote Procedure Call::
106 A mechanism for implementing operations involving one computer acting
107 on the behalf of another (RPC).
108
109 server::
110 A computer that provides a service. For example, management (MGS),
111 Metadata (MDS), or object storage (OSS) services in support of a
112 Lustre file system.
113
114 target::
115 Storage available to be served, such as an OST or an MDT. Also the
116 service being provided.
117
118 UUID:: A universally unique identifier.