Whamcloud - gitweb
LU-5654 osd-ldiskfs: Handle holes in osd_ldiskfs_read()
[fs/lustre-release.git] / debian / README.Debian
1 Here is an short explanation what to install on your Servers to set up lustre quickly.
2 Be aware that this doesn't replace the Documentation and Installation Howtos from Lustre.
3
4
5 #1. Building the kernel and the modules
6     You've to download the linux-source-2.6.18|21|22 package and the linux-patch-lustre package.
7
8     Then patch your kernel with the correct patch file. Build and install it. (Use make-kpkg)
9     To patch the kernel automatically use --added-patches=lustre as build option.
10
11     Here is the full line how I build my kernel (for those who are not familiar with make-kpkg)
12     make-kpkg --added-patches=lustre --initrd --append-to-version "-quota-enabled-lustre-1.6.4.1" --revision credativ.1 kernel_image
13
14     Now reboot into this new kernel and install the lustre modules with:
15      - m-a auto-install lustre
16
17     Then the kernel and the modules should be there.
18
19 #2. Preparing the system
20     In the next step install:
21      - lustre-utils
22
23     Then load the kernel modules with:
24      - modprobe lnet
25      - modprobe lustre
26      - modprobe ldiskfs
27
28     This have to be done on every server system.
29
30 #3. Creating partitions on the OST/MDT/MGS Servers
31     Now you'll have to differentiate between the OST and MDT and MGS Systems
32     We'll assume here that MDT and MGS are on the same system:
33
34      - Create partitions:
35         - MGS/MDT: mkfs.lustre --fsname spfs --mdt --mgs $device
36         - OST: mkfs.lustre --fsname spfs --ost --mgsnode=$mgsnode@tcp0 $device
37
38         Additional options are:
39             --reformat                       - this partition was previously formated with lustre, reformat it
40             --param="failover.mode=failout"  - don't hang the complete fs if a ost isn't available.
41
42      - Now mount the partitons on the servers:
43         - first the MDT/MGS Server:
44           - mount -t lustre /dev/sda /srv/mdt
45         - now the OST's
46           - mount -t lustre /dev/sda /srv/ost
47
48
49 #4. Using the filesystem
50     In order to use the FS, you'll have to mount it on a client. Please note that this client also
51     needs the lustre-modules to be installed. (You can install lustre-source and build the module
52     as described in 1.)
53      - mount -t lustre mgsnode@tcp0:/spfs /mnt
54
55 #4.1 Using Quota:
56
57     The binaries and drivers for lustre in debian are compiled with enabled-quota.
58     So if you like to use quota this is quite simple:
59         - lfs quotacheck -ug $path/to/mounted/lustre/fs
60         - lfs setquota -u $user 1000 2000 10000 20000 $path/to/mounted/lustre/fs
61         - lfs quota -u $user $path/to/mounted/lustre/fs
62
63     If you want to reset this quota informations for a given user, you'll have first to
64     set every value to zero, and then give the new informations:
65         - lfs setquota -u $user 0 0 0 0  $path/to/mounted/lustre/fs
66         - lfs setquota -u $user 2000 3000 3000 4000 $path/to/mounted/lustre/fs
67
68     This behaviour is reported as lustre bug: https://bugzilla.lustre.org/show_bug.cgi?id=14513
69
70
71
72 ###########
73 Please have also a look into the official documentation for lustre available at:
74
75 http://manual.lustre.org/index.php?title=Main_Page
76
77  -- Patrick Winnertz <winnie@debian.org>  Thu, 28 Dec 2007 14:53:25 +0200