| 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 |
|---|