src/ceph/doc/install/index.rst

   1 =======================
   2  Installation (Manual)
   3 =======================
   4
   5
   6 Get Software
   7 ============
   8
   9 There are several methods for getting Ceph software. The easiest and most common
  10 method is to `get packages`_ by adding repositories for use with package
  11 management tools such as the Advanced Package Tool (APT) or Yellowdog Updater,
  12 Modified (YUM). You may also retrieve pre-compiled packages from the Ceph
  13 repository. Finally, you can retrieve tarballs or clone the Ceph source code
  14 repository and build Ceph yourself.
  15
  16
  17 .. toctree::
  18    :maxdepth: 1
  19
  20         Get Packages <get-packages>
  21         Get Tarballs <get-tarballs>
  22         Clone Source <clone-source>
  23         Build Ceph <build-ceph>
  24         Ceph Mirrors <mirrors>
  25
  26
  27 Install Software
  28 ================
  29
  30 Once you have the Ceph software (or added repositories), installing the software
  31 is easy. To install packages on each :term:`Ceph Node` in your cluster. You may
  32 use  ``ceph-deploy`` to install Ceph for your storage cluster, or use package
  33 management tools. You should install Yum Priorities for RHEL/CentOS and other
  34 distributions that use Yum if you intend to install the Ceph Object Gateway or
  35 QEMU.
  36
  37 .. toctree::
  38    :maxdepth: 1
  39
  40         Install ceph-deploy <install-ceph-deploy>
  41         Install Ceph Storage Cluster <install-storage-cluster>
  42         Install Ceph Object Gateway <install-ceph-gateway>
  43         Install Virtualization for Block <install-vm-cloud>
  44
  45
  46 Deploy a Cluster Manually
  47 =========================
  48
  49 Once you have Ceph installed on your nodes, you can deploy a cluster manually.
  50 The manual procedure is primarily for exemplary purposes for those developing
  51 deployment scripts with Chef, Juju, Puppet, etc.
  52
  53 .. toctree::
  54
  55         Manual Deployment <manual-deployment>
  56         Manual Deployment on FreeBSD <manual-freebsd-deployment>
  57
  58 Upgrade Software
  59 ================
  60
  61 As new versions of Ceph become available, you may upgrade your cluster to take
  62 advantage of new functionality. Read the upgrade documentation before you
  63 upgrade your cluster. Sometimes upgrading Ceph requires you to follow an upgrade
  64 sequence.
  65
  66 .. toctree::
  67    :maxdepth: 2
  68
  69    Upgrading Ceph <upgrading-ceph>
  70
  71 .. _get packages: ../install/get-packages