X-Git-Url: https://git.whamcloud.com/?a=blobdiff_plain;f=debian%2FREADME.Debian;h=670fa4b2f1b27d0cb499a04a3ae9490c43cdd766;hb=0c60662b3a389790b19736a60063a1208e06bf70;hp=c464a2076d3fff67dc41dbaf4c8f7ab48ea99f03;hpb=53eb13326140d4780adf532188487be38ceb34d8;p=fs%2Flustre-release.git diff --git a/debian/README.Debian b/debian/README.Debian index c464a20..670fa4b 100644 --- a/debian/README.Debian +++ b/debian/README.Debian @@ -1,29 +1,28 @@ -Here is an short explanation what to install on your Servers to set up lustre quickly. -Be aware that this doesn't replace the Documentation and Installation Howtos from Lustre. +Here is an short explanation what to install on your Servers to set up +Lustre quickly. Be aware that this doesn't replace the Documentation +and Installation Howtos from Lustre. #1. Building the kernel and the modules - You've to download the linux-source-2.6.18|21|22 package and the linux-patch-lustre package. + You've to download the linux-source package for your kernel and + the linux-patch-lustre package. - Then patch your kernel with the correct patch file. Build and install it. (Use make-kpkg) - To patch the kernel automatically use --added-patches=lustre as build option. + Then patch your kernel with the correct patch file. Build and install + it. (Use make-kpkg) To patch the kernel automatically use + --added-patches=lustre as build option. - Here is the full line how I build my kernel (for those who are not familiar with make-kpkg) - make-kpkg --added-patches=lustre --initrd --append-to-version "-quota-enabled-lustre-1.6.4.1" --revision credativ.1 kernel_image + Here is the full line how I build my kernel (for those who are not + familiar with make-kpkg): + make-kpkg --added-patches=lustre --initrd --append-to-version "-my-version" --revision 1 kernel_image - Now reboot into this new kernel and install the lustre modules with: + Now reboot into this new kernel and install the Lustre modules with: - m-a auto-install lustre Then the kernel and the modules should be there. #2. Preparing the system In the next step install: - - lustre-utils - - Then load the kernel modules with: - - modprobe lnet - - modprobe lustre - - modprobe ldiskfs + - lustre-server-utils or lustre-client-utils This have to be done on every server system. @@ -36,8 +35,8 @@ Be aware that this doesn't replace the Documentation and Installation Howtos fro - OST: mkfs.lustre --fsname spfs --ost --mgsnode=$mgsnode@tcp0 $device Additional options are: - --reformat - this partition was previously formated with lustre, reformat it - --param="failover.mode=failout" - don't hang the complete fs if a ost isn't available. + --reformat - this partition was previously formatted with lustre, reformat it + --param="failover.mode=failout" - don't hang the entire fs if an ost isn't available. - Now mount the partitons on the servers: - first the MDT/MGS Server: @@ -47,31 +46,36 @@ Be aware that this doesn't replace the Documentation and Installation Howtos fro #4. Using the filesystem - In order to use the FS, you'll have to mount it on a client. Please note that this client also - needs the lustre-modules to be installed. (You can install lustre-source and build the module - as described in 1.) + In order to use the FS, you'll have to mount it on a client. Please note + that this client also needs the lustre-modules to be installed. (You can + install lustre-source and build the module as described in 1.) - mount -t lustre mgsnode@tcp0:/spfs /mnt -#4.1 Using Quota: +#5. Building client modules with DKMS - The binaries and drivers for lustre in debian are compiled with enabled-quota. - So if you like to use quota this is quite simple: - - lfs quotacheck -ug $path/to/mounted/lustre/fs - - lfs setquota -u $user 1000 2000 10000 20000 $path/to/mounted/lustre/fs - - lfs quota -u $user $path/to/mounted/lustre/fs + Lustre client-only kernel modules can built against non-patched, vanilla + kernels. This may be more convenient than installing the patched kernel + and server modules. - If you want to reset this quota informations for a given user, you'll have first to - set every value to zero, and then give the new informations: - - lfs setquota -u $user 0 0 0 0 $path/to/mounted/lustre/fs - - lfs setquota -u $user 2000 3000 3000 4000 $path/to/mounted/lustre/fs + Installing the lustre-client-modules-dkms package will automatically + build modules for all currently installed kernels using DKMS + (http://linux.dell.com/dkms/) for which you will need to have the relevant + linux-headers packages installed. When a new kernel is installed on the + machine, DKMS will automatically build a new set of Lustre client modules. - This behaviour is reported as lustre bug: https://bugzilla.lustre.org/show_bug.cgi?id=14513 + You can also use DKMS to create a new deb containing the pre-built kernel + modules, suitable for installing on other machines which may not have a + full build environment. + - dkms build -m lustre-client-modules -v -k + (repeat the above step for all required kernel versions) + - dkms mkdeb -m lustre-client-modules -v + - dkms mkdsc -m lustre-client-modules -v ########### -Please have also a look into the official documentation for lustre available at: +Please have also a look into the official documentation for Lustre available at: -http://manual.lustre.org/index.php?title=Main_Page +https://wiki.whamcloud.com/display/PUB/Documentation -- Patrick Winnertz Thu, 28 Dec 2007 14:53:25 +0200