summaryrefslogtreecommitdiffstats
path: root/src/ceph/doc/install/install-storage-cluster.rst
blob: 5da2c685c4bebf267b6ef15c49afa57a9739670a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
==============================
 Install Ceph Storage Cluster
==============================

This guide describes installing Ceph packages manually. This procedure
is only for users who are not installing with a deployment tool such as
``ceph-deploy``, ``chef``, ``juju``, etc. 

.. tip:: You can also use ``ceph-deploy`` to install Ceph packages, which may
   be more convenient since you can install ``ceph`` on multiple hosts with
   a single command.


Installing with APT
===================

Once you have added either release or development packages to APT, you should
update APT's database and install Ceph::

	sudo apt-get update && sudo apt-get install ceph ceph-mds


Installing with RPM
===================

To install Ceph with RPMs, execute the following steps:


#. Install ``yum-plugin-priorities``. ::

	sudo yum install yum-plugin-priorities

#. Ensure ``/etc/yum/pluginconf.d/priorities.conf`` exists.

#. Ensure ``priorities.conf`` enables the plugin. :: 

	[main]
	enabled = 1

#. Ensure your YUM ``ceph.repo`` entry includes ``priority=2``. See
   `Get Packages`_ for details::

	[ceph]
	name=Ceph packages for $basearch
	baseurl=https://download.ceph.com/rpm-{ceph-release}/{distro}/$basearch
	enabled=1
	priority=2
	gpgcheck=1
	gpgkey=https://download.ceph.com/keys/release.asc

	[ceph-noarch]
	name=Ceph noarch packages
	baseurl=https://download.ceph.com/rpm-{ceph-release}/{distro}/noarch
	enabled=1
	priority=2
	gpgcheck=1
	gpgkey=https://download.ceph.com/keys/release.asc

	[ceph-source]
	name=Ceph source packages
	baseurl=https://download.ceph.com/rpm-{ceph-release}/{distro}/SRPMS
	enabled=0
	priority=2
	gpgcheck=1
	gpgkey=https://download.ceph.com/keys/release.asc


#. Install pre-requisite packages::  

	sudo yum install snappy leveldb gdisk python-argparse gperftools-libs


Once you have added either release or development packages, or added a
``ceph.repo`` file to ``/etc/yum.repos.d``, you can install Ceph packages. :: 

	sudo yum install ceph


Installing a Build
==================

If you build Ceph from source code, you may install Ceph in user space
by executing the following:: 

	sudo make install

If you install Ceph locally, ``make`` will place the executables in
``usr/local/bin``. You may add the Ceph configuration file to the
``usr/local/bin`` directory to run Ceph from a single directory.

.. _Get Packages: ../get-packages