projects / ceph.git / blame
| Commit | Line | Data |
|---|---|---|
| 7c673cae FG |
1 | ============================== |
| 2 | Install Ceph Storage Cluster | |
| 3 | ============================== | |
| 4 | ||
| 5 | This guide describes installing Ceph packages manually. This procedure | |
| 6 | is only for users who are not installing with a deployment tool such as | |
| f67539c2 | 7 | ``cephadm``, ``chef``, ``juju``, etc. |
| 7c673cae FG |
8 | |
| 9 | ||
| 10 | Installing with APT | |
| 11 | =================== | |
| 12 | ||
| 13 | Once you have added either release or development packages to APT, you should | |
| 14 | update APT's database and install Ceph:: | |
| 15 | ||
| 16 | sudo apt-get update && sudo apt-get install ceph ceph-mds | |
| 17 | ||
| 18 | ||
| 19 | Installing with RPM | |
| 20 | =================== | |
| 21 | ||
| 22 | To install Ceph with RPMs, execute the following steps: | |
| 23 | ||
| 24 | ||
| 25 | #. Install ``yum-plugin-priorities``. :: | |
| 26 | ||
| 27 | sudo yum install yum-plugin-priorities | |
| 28 | ||
| 29 | #. Ensure ``/etc/yum/pluginconf.d/priorities.conf`` exists. | |
| 30 | ||
| 31 | #. Ensure ``priorities.conf`` enables the plugin. :: | |
| 32 | ||
| 33 | [main] | |
| 34 | enabled = 1 | |
| 35 | ||
| 36 | #. Ensure your YUM ``ceph.repo`` entry includes ``priority=2``. See | |
| 37 | `Get Packages`_ for details:: | |
| 38 | ||
| 39 | [ceph] | |
| 40 | name=Ceph packages for $basearch | |
| 41 | baseurl=https://download.ceph.com/rpm-{ceph-release}/{distro}/$basearch | |
| 42 | enabled=1 | |
| 43 | priority=2 | |
| 44 | gpgcheck=1 | |
| 45 | gpgkey=https://download.ceph.com/keys/release.asc | |
| 46 | ||
| 47 | [ceph-noarch] | |
| 48 | name=Ceph noarch packages | |
| 49 | baseurl=https://download.ceph.com/rpm-{ceph-release}/{distro}/noarch | |
| 50 | enabled=1 | |
| 51 | priority=2 | |
| 52 | gpgcheck=1 | |
| 53 | gpgkey=https://download.ceph.com/keys/release.asc | |
| 54 | ||
| 55 | [ceph-source] | |
| 56 | name=Ceph source packages | |
| 57 | baseurl=https://download.ceph.com/rpm-{ceph-release}/{distro}/SRPMS | |
| 58 | enabled=0 | |
| 59 | priority=2 | |
| 60 | gpgcheck=1 | |
| 61 | gpgkey=https://download.ceph.com/keys/release.asc | |
| 62 | ||
| 63 | ||
| 64 | #. Install pre-requisite packages:: | |
| 65 | ||
| 66 | sudo yum install snappy leveldb gdisk python-argparse gperftools-libs | |
| 67 | ||
| 68 | ||
| 69 | Once you have added either release or development packages, or added a | |
| 70 | ``ceph.repo`` file to ``/etc/yum.repos.d``, you can install Ceph packages. :: | |
| 71 | ||
| 72 | sudo yum install ceph | |
| 73 | ||
| 74 | ||
| 75 | Installing a Build | |
| 76 | ================== | |
| 77 | ||
| 78 | If you build Ceph from source code, you may install Ceph in user space | |
| 79 | by executing the following:: | |
| 80 | ||
| 20effc67 | 81 | sudo ninja install |
| 7c673cae | 82 | |
| 20effc67 | 83 | If you install Ceph locally, ``ninja`` will place the executables in |
| 7c673cae FG |
84 | ``usr/local/bin``. You may add the Ceph configuration file to the |
| 85 | ``usr/local/bin`` directory to run Ceph from a single directory. | |
| 86 | ||
| 87 | .. _Get Packages: ../get-packages |