1Lustre Parallel Filesystem Client
2=================================
3
4The Lustre file system is an open-source, parallel file system
5that supports many requirements of leadership class HPC simulation
6environments.
7Born from from a research project at Carnegie Mellon University,
8the Lustre file system is a widely-used option in HPC.
9The Lustre file system provides a POSIX compliant file system interface,
10can scale to thousands of clients, petabytes of storage and
11hundreds of gigabytes per second of I/O bandwidth.
12
13Unlike shared disk storage cluster filesystems (e.g. OCFS2, GFS, GPFS),
14Lustre has independent Metadata and Data servers that clients can access
15in parallel to maximize performance.
16
17In order to use Lustre client you will need to download the "lustre-client"
18package that contains the userspace tools from http://lustre.org/download/
19
20You will need to install and configure your Lustre servers separately.
21
22Mount Syntax
23============
24After you installed the lustre-client tools including mount.lustre binary
25you can mount your Lustre filesystem with:
26
27mount -t lustre mgs:/fsname mnt
28
29where mgs is the host name or ip address of your Lustre MGS(management service)
30fsname is the name of the filesystem you would like to mount.
31
32
33Mount Options
34=============
35
36  noflock
37	Disable posix file locking (Applications trying to use
38	the functionality will get ENOSYS)
39
40  localflock
41	Enable local flock support, using only client-local flock
42	(faster, for applications that require flock but do not run
43	 on multiple nodes).
44
45  flock
46	Enable cluster-global posix file locking coherent across all
47	client nodes.
48
49  user_xattr, nouser_xattr
50	Support "user." extended attributes (or not)
51
52  user_fid2path, nouser_fid2path
53	Enable FID to path translation by regular users (or not)
54
55  checksum, nochecksum
56	Verify data consistency on the wire and in memory as it passes
57	between the layers (or not).
58
59  lruresize, nolruresize
60	Allow lock LRU to be controlled by memory pressure on the server
61	(or only 100 (default, controlled by lru_size proc parameter) locks
62	 per CPU per server on this client).
63
64  lazystatfs, nolazystatfs
65	Do not block in statfs() if some of the servers are down.
66
67  32bitapi
68	Shrink inode numbers to fit into 32 bits. This is necessary
69	if you plan to reexport Lustre filesystem from this client via
70	NFSv4.
71
72  verbose, noverbose
73	Enable mount/umount console messages (or not)
74
75More Information
76================
77You can get more information at the Lustre website: http://wiki.lustre.org/
78
79Source for the userspace tools and out-of-tree client and server code
80is available at: http://git.hpdd.intel.com/fs/lustre-release.git
81
82Latest binary packages:
83http://lustre.org/download/
84