X-Git-Url: https://git.whamcloud.com/?a=blobdiff_plain;f=lustre%2Fdoc%2Flustre.7;h=095d2dbaee9a4831faacfde2802f580f090884b2;hb=6a20bdcc608bc2b933774b9f34ec25395e920a54;hp=460df98fe06bdcf296d4c1442db608fec1170321;hpb=113303973ec9f8484eb2355a1a6ef3c4c7fd6a56;p=fs%2Flustre-release.git diff --git a/lustre/doc/lustre.7 b/lustre/doc/lustre.7 index 460df98..095d2db 100644 --- a/lustre/doc/lustre.7 +++ b/lustre/doc/lustre.7 @@ -1,7 +1,9 @@ .\" -*- nroff -*- -.\" Copyright 2006 by Cluster FileSystems. All Rights Reserved. +.\" Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved. .\" This file may be copied under the terms of the GNU Public License. .\" +.\" Copyright (c) 2015, 2016, Intel Corporation. +.\" .TH Lustre 7 "2006 Jun 15" Lustre "A high-performance cluster file system" .SH NAME Lustre @@ -10,67 +12,74 @@ A high-performance file system designed for clusters. .SH DESCRIPTION .B Lustre® is a high-performance, massively-scalable, POSIX-compliant network file system -designed for the world's largest high-performance compute clusters. Lustre -is under active development from Cluster FileSystems (http://clusterfs.com). +designed for the world's largest high-performance compute clusters. -Lustre filesystems are made up of multiple servers typically distributed +Lustre filesystems are made up of multiple services typically distributed across multiple nodes. Lustre clients can contact these server nodes over multiple high-speed network fabrics via LNET, the Lustre NETworking -system. Clients then present the filesystem at a mount point. +system. Clients then present the filesystem at a mount point to userspace. A filesystem is comprised of a .I MDT -, MetaData Target, which stores directory and file meta-information, and a +, MetaData Target, which stores directory and file meta-information such as +file ownership, timestamps, access permissions, etc, and a series of .I OSTs -, Object Storage Targets, which hold the file data. There is typically not -a 1:1 mapping of a file on disk and what is presented as a file on a Lustre client. +, Object Storage Targets, which hold the file data in one or more objects. +There is typically not a 1:1 mapping of OST objects and what is presented +as a file on a Lustre client. Lustre and LNET are implemented as a series of kernel modules, for both -servers and clients. LNET networks are defined in the modprobe.conf file on -all nodes. Lustre and LNET make extensive use of /proc files for making -system data available, for example -.TP -.B /proc/sys/lnet/nis -to show the local LNET Network Interfaces. -.TP -.B /proc/fs/lustre/devices -to show locally running Lustre objects. +servers and clients. LNET networks are defined in the modprobe.conf file on +all nodes. Lustre is started on the clients and servers using the +.BR mount (8) +command. .SH COMMANDS .TP -.B mkfs.lustre(8) +.BR mkfs.lustre (8) Format a physical disk for use as a Lustre server's backend storage (aka target). .TP -.B tunefs.lustre(8) +.BR tunefs.lustre (8) Modify configuration information on a Lustre target disk. .TP -.B mount.lustre(8) +.BR mount.lustre (8) A helper program for .BR mount (8) -that starts Lustre servers and clients. +that starts Lustre servers and clients mounts the client filesystem. .TP -.B lctl(8) +.BR lctl (8) A low-level interface to control various aspects of Lustre .TP -.B lfs(1) +.BR lfs (1) A user-level interface to control Lustre-specific information for -individual files. +individual files. .B lustre_config.sh Format multiple Lustre targets simultaneously from definitions in a CSV file. .SH BUGS -Please report all bugs to Cluster FileSystems, support@clusterfs.com +Please report all bugs https://jira.whamcloud.com/ .SH AVAILABILITY .B The -.BR Lustre (7) -filesystem package is available from CFS +.BR Lustre (7) +filesystem package is available via .br -http://clusterfs.com +https://downloads.whamcloud.com/ .SH SEE ALSO .BR mkfs.lustre (8), .BR tunefs.lustre (8), .BR mount.lustre (8), .BR lctl (8), -.BR lfs (1) +.BR lfs (1), +.BR lfs_migrate (1), +.BR lustreapi (7), +.BR l_getidentity (8), +.BR llstat (8), +.BR llverdev (8), +.BR lst (8), +.BR llobdstat (8), +.BR ll_decode_filter_fid (8), +.BR llog_reader (8), +.BR lshowmount (8), +.BR lustre_rsync (8)