7 This **Preflight Checklist** will help you prepare an admin node for use with
8 ``ceph-deploy``, and server nodes for use with passwordless ``ssh`` and
11 Before you can deploy Ceph using ``ceph-deploy``, you need to ensure that you
12 have a few things set up first on your admin node and on nodes running Ceph
16 Install an Operating System
17 ===========================
19 Install a recent release of Debian or Ubuntu (e.g., 12.04 LTS, 14.04 LTS) on
20 your nodes. For additional details on operating systems or to use other
21 operating systems other than Debian or Ubuntu, see `OS Recommendations`_.
27 The ``ceph-deploy`` utility requires ``ssh``, so your server node(s) require an
30 sudo apt-get install openssh-server
36 Create a user on nodes running Ceph daemons.
38 .. tip:: We recommend a username that brute force attackers won't
39 guess easily (e.g., something other than ``root``, ``ceph``, etc).
44 sudo useradd -d /home/ceph -m ceph
48 ``ceph-deploy`` installs packages onto your nodes. This means that
49 the user you create requires passwordless ``sudo`` privileges.
51 .. note:: We **DO NOT** recommend enabling the ``root`` password
54 To provide full privileges to the user, add the following to
55 ``/etc/sudoers.d/ceph``. ::
57 echo "ceph ALL = (root) NOPASSWD:ALL" | sudo tee /etc/sudoers.d/ceph
58 sudo chmod 0440 /etc/sudoers.d/ceph
64 Configure your admin machine with password-less SSH access to each node
65 running Ceph daemons (leave the passphrase empty). ::
68 Generating public/private key pair.
69 Enter file in which to save the key (/ceph-client/.ssh/id_rsa):
70 Enter passphrase (empty for no passphrase):
71 Enter same passphrase again:
72 Your identification has been saved in /ceph-client/.ssh/id_rsa.
73 Your public key has been saved in /ceph-client/.ssh/id_rsa.pub.
75 Copy the key to each node running Ceph daemons::
77 ssh-copy-id ceph@ceph-server
79 Modify your ~/.ssh/config file of your admin node so that it defaults
80 to logging in as the user you created when no username is specified. ::
83 Hostname ceph-server.fqdn-or-ip-address.com
90 To install ``ceph-deploy``, execute the following::
92 wget -q -O- 'https://download.ceph.com/keys/release.asc' | sudo apt-key add -
93 echo deb http://ceph.com/debian-dumpling/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list
95 sudo apt-get install ceph-deploy
101 Ensure that your Admin node has connectivity to the network and to your Server
102 node (e.g., ensure ``iptables``, ``ufw`` or other tools that may prevent
103 connections, traffic forwarding, etc. to allow what you need).
106 Once you have completed this pre-flight checklist, you are ready to begin using
109 .. _OS Recommendations: ../../../start/os-recommendations