Whamcloud - gitweb
LUDOC 299 protocol: Spell-check document
[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 Object Storage Device (OSD)::
9 The OSD is the storage on a server that holds objects or metadata. The
10 two kinds of file system available for OSDs are ldiskfs and ZFS.
11
12 Client::
13 A Lustre client is a computer taking advantage of the services
14 provided by MDSs and OSSs to assemble a POSIX-compliant file system
15 with its namespace and data storage capabilities.
16
17 Distributed Lock Manager::
18 The distributed lock manager (DLM, often referred to as the Lustre
19 Distributed Lock Manager, or LDLM) is the service that enforces a
20 consistent (cache-coherent) view of the data objects in the file
21 system.
22
23 early reply::
24 A partial message reply returned in response to a request message
25 that allows the target to indicate to the requester to increase its
26 timeout value without otherwise indicating the request has progressed.
27
28 export::
29 The term for the per-client shared state information held by a
30 server. See <<struct-obd-export>>.
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
36 client. See <<struct_obd_import>>.
37
38 Inodes and Extended Attributes::
39 Metadata about a Lustre file is encoded in the extended attributes of
40 an inode on the MDT. Some of that information establishes the stripe
41 layout of the file. The size of the stripe layout information may be
42 different for each file. The amount of space reserved for layout
43 information is a small as possible given the maximum stripe count on
44 the file system. Clients, servers, and the distributed lock manager
45 will all need to be aware of this size, which is communicated in the
46 'ocd_max_easize' field of the <<struct-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.