root/trunk/INSTALL.txt

Revision 1199, 1.8 kB (checked in by nickandrew, 4 months ago)

Add complete install script/instructions

1. Add a script to build all debian packages and move them into a
'packages' directory.

2. Add a script to build/install on this system without packaging,
using perl make/test/install.

3. Add INSTALL.txt which tells how to build debian packages or
how to build/install without packaging.

Signed-off-by: Nick Andrew <nick@nick-andrew.net>

Line 
1 Building and Installing instructions for MogileFS
2 =================================================
3
4 MogileFS can be built as several packages for later installation or
5 installation on several machines. It can also be built and installed
6 directly on this machine without packaging. Instructions are given
7 for both techniques.
8
9 0. Prerequisites
10 ================
11
12 Before continuing, make sure you have the following prerequisite
13 packages installed:
14
15 -  perl
16 -  libcompress-zlib-perl
17 -  libio-stringy-perl
18 -  libstring-crc32-perl
19 -  libwww-perl
20 -  debhelper  (for building debian packages)
21 -  dpkg-dev   (for building debian packages)
22 -  fakeroot   (for building debian packages)
23
24 1. Building Debian packages
25 ===========================
26
27 A script 'bin/build-all-debian.sh' will build all debian packages
28 and place them into the newly created 'packages' directory. The
29 packages are:
30
31 -  libmogilefs-perl
32 -  mogilefs-utils
33 -  mogilefsd
34 -  mogstored
35
36 The mogilefs-utils package can't be built unless libmogilefs-perl is
37 already installed. So the bin/build-all-debian.sh script needs to be
38 run twice, as follows:
39
40 $  bin/build-all-debian.sh
41 $  sudo dpkg -i packages/libmogilefs-perl*.deb
42 $  bin/build-all-debian.sh
43
44
45 2. Building and installing without packaging
46 ============================================
47
48 This technique uses the standard Perl make/install process.
49 You can use the PREFIX= argument to set the directory into which
50 MogileFS will be installed. The default is $HOME/local.
51
52 **
53 ** Note that some tests might fail; this doesn't necessarily mean
54 ** that MogileFS won't work.
55 **
56
57 A script 'bin/build-all.sh' automates the build and install process.
58 Run it as follows:
59
60 $  PREFIX=$HOME/local bin/build-all.sh
61
62 If you want to install as root, say, do something like this instead:
63
64 $  sudo PREFIX=/usr/local bin/build-all.sh
Note: See TracBrowser for help on using the browser.