From caa4780b3ce78c456498f6bc26b57fe698878b33 Mon Sep 17 00:00:00 2001 From: Alfredo Deza <adeza@redhat.com> Date: Fri, 30 Oct 2015 17:46:12 -0400 Subject: [PATCH] doc: update debian links to download.ceph.com Signed-off-by: Alfredo Deza <adeza@redhat.com> --- doc/install/get-packages.rst | 2 +- doc/install/upgrading-ceph.rst | 16 ++++++------ doc/start/quick-start-preflight.rst | 38 ++++++++++++++--------------- 3 files changed, 28 insertions(+), 28 deletions(-) diff --git a/doc/install/get-packages.rst b/doc/install/get-packages.rst index aaab772fe16..537494f4cdb 100644 --- a/doc/install/get-packages.rst +++ b/doc/install/get-packages.rst @@ -483,5 +483,5 @@ line to get the short codename. :: .. _Install Ceph Object Storage: ../install-storage-cluster -.. _the testing Debian repository: http://ceph.com/debian-testing/dists +.. _the testing Debian repository: http://download.ceph.com/debian-testing/dists .. _the gitbuilder page: http://gitbuilder.ceph.com diff --git a/doc/install/upgrading-ceph.rst b/doc/install/upgrading-ceph.rst index ec0b5518e36..9c542459d07 100644 --- a/doc/install/upgrading-ceph.rst +++ b/doc/install/upgrading-ceph.rst @@ -80,7 +80,7 @@ When upgrading from Argonaut to Bobtail, you need to be aware of several things: Ensure that you update package repository paths. For example:: sudo rm /etc/apt/sources.list.d/ceph.list - echo deb http://ceph.com/debian-bobtail/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list + echo deb http://download.ceph.com/debian-bobtail/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list See the following sections for additional details. @@ -162,7 +162,7 @@ Argonaut to Cuttlefish without the intermediate upgrade to Bobtail. For example:: sudo rm /etc/apt/sources.list.d/ceph.list - echo deb http://ceph.com/debian-bobtail/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list + echo deb http://download.ceph.com/debian-bobtail/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list We recommend upgrading all monitors to Bobtail before proceeding with the upgrade of the monitors to Cuttlefish. A mixture of Bobtail and Argonaut @@ -186,7 +186,7 @@ replace the reference to the Bobtail repository with a reference to the Cuttlefish repository. For example:: sudo rm /etc/apt/sources.list.d/ceph.list - echo deb http://ceph.com/debian-cuttlefish/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list + echo deb http://download.ceph.com/debian-cuttlefish/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list See `Upgrading Monitors`_ for details. @@ -210,7 +210,7 @@ Replace any ``apt`` reference to older repositories with a reference to the Cuttlefish repository. For example:: sudo rm /etc/apt/sources.list.d/ceph.list - echo deb http://ceph.com/debian-cuttlefish/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list + echo deb http://download.ceph.com/debian-cuttlefish/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list Monitor @@ -259,7 +259,7 @@ Replace any reference to older repositories with a reference to the Dumpling repository. For example, with ``apt`` perform the following:: sudo rm /etc/apt/sources.list.d/ceph.list - echo deb http://ceph.com/debian-dumpling/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list + echo deb http://download.ceph.com/debian-dumpling/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list With CentOS/Red Hat distributions, remove the old repository. :: @@ -296,7 +296,7 @@ Replace any reference to older repositories with a reference to the Emperor repository. For example, with ``apt`` perform the following:: sudo rm /etc/apt/sources.list.d/ceph.list - echo deb http://ceph.com/debian-emperor/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list + echo deb http://download.ceph.com/debian-emperor/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list With CentOS/Red Hat distributions, remove the old repository. :: @@ -421,7 +421,7 @@ Replace any reference to older repositories with a reference to the Firely repository. For example, with ``apt`` perform the following:: sudo rm /etc/apt/sources.list.d/ceph.list - echo deb http://ceph.com/debian-firefly/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list + echo deb http://download.ceph.com/debian-firefly/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list With CentOS/Red Hat distributions, remove the old repository. :: @@ -494,7 +494,7 @@ Replace any reference to older repositories with a reference to the Firefly repository. For example, with ``apt`` perform the following:: sudo rm /etc/apt/sources.list.d/ceph.list - echo deb http://ceph.com/debian-firefly/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list + echo deb http://download.ceph.com/debian-firefly/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list With CentOS/Red Hat distributions, remove the old repository. :: diff --git a/doc/start/quick-start-preflight.rst b/doc/start/quick-start-preflight.rst index a590d99497f..63608228fa9 100644 --- a/doc/start/quick-start-preflight.rst +++ b/doc/start/quick-start-preflight.rst @@ -6,12 +6,12 @@ Thank you for trying Ceph! We recommend setting up a ``ceph-deploy`` admin :term:`node` and a 3-node :term:`Ceph Storage Cluster` to explore the basics of -Ceph. This **Preflight Checklist** will help you prepare a ``ceph-deploy`` -admin node and three Ceph Nodes (or virtual machines) that will host your Ceph -Storage Cluster. Before proceeding any further, see `OS Recommendations`_ to -verify that you have a supported distribution and version of Linux. When -you use a single Linux distribution and version across the cluster, it will -make it easier for you to troubleshoot issues that arise in production. +Ceph. This **Preflight Checklist** will help you prepare a ``ceph-deploy`` +admin node and three Ceph Nodes (or virtual machines) that will host your Ceph +Storage Cluster. Before proceeding any further, see `OS Recommendations`_ to +verify that you have a supported distribution and version of Linux. When +you use a single Linux distribution and version across the cluster, it will +make it easier for you to troubleshoot issues that arise in production. In the descriptions below, :term:`Node` refers to a single machine. @@ -38,7 +38,7 @@ For Debian and Ubuntu distributions, perform the following steps: ``emperor``, ``firefly``, etc.). For example:: - echo deb http://ceph.com/debian-{ceph-stable-release}/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list + echo deb http://download.ceph.com/debian-{ceph-stable-release}/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list #. Update your repository and install ``ceph-deploy``:: @@ -62,10 +62,10 @@ following steps: Paste the following example code. Replace ``{ceph-release}`` with the recent major release of Ceph (e.g., ``firefly``). Replace ``{distro}`` - with your Linux distribution (e.g., ``el6`` for CentOS 6, + with your Linux distribution (e.g., ``el6`` for CentOS 6, ``el7`` for CentOS 7, ``rhel6`` for Red Hat 6.5, ``rhel7`` for Red Hat 7, and ``fc19`` or ``fc20`` for Fedora 19 - or Fedora 20. Finally, save the contents to the + or Fedora 20. Finally, save the contents to the ``/etc/yum.repos.d/ceph.repo`` file. :: [ceph-noarch] @@ -89,7 +89,7 @@ following steps: Ceph Node Setup =============== -The admin node must be have password-less SSH access to Ceph nodes. +The admin node must be have password-less SSH access to Ceph nodes. When ceph-deploy logs in to a Ceph node as a user, that particular user must have passwordless ``sudo`` privileges. @@ -100,7 +100,7 @@ Install NTP We recommend installing NTP on Ceph nodes (especially on Ceph Monitor nodes) to prevent issues arising from clock drift. See `Clock`_ for details. -On CentOS / RHEL, execute:: +On CentOS / RHEL, execute:: sudo yum install ntp ntpdate ntp-doc @@ -108,7 +108,7 @@ On Debian / Ubuntu, execute:: sudo apt-get install ntp -Ensure that you enable the NTP service. Ensure that each Ceph Node uses the +Ensure that you enable the NTP service. Ensure that each Ceph Node uses the same NTP time server. See `NTP`_ for details. @@ -134,7 +134,7 @@ Create a Ceph Deploy User The ``ceph-deploy`` utility must login to a Ceph node as a user that has passwordless ``sudo`` privileges, because it needs to install -software and configuration files without prompting for passwords. +software and configuration files without prompting for passwords. Recent versions of ``ceph-deploy`` support a ``--username`` option so you can specify any user that has password-less ``sudo`` (including ``root``, although @@ -179,7 +179,7 @@ monitors. ``root`` user. Leave the passphrase empty:: ssh-keygen - + Generating public/private key pair. Enter file in which to save the key (/ceph-admin/.ssh/id_rsa): Enter passphrase (empty for no passphrase): @@ -194,9 +194,9 @@ monitors. ssh-copy-id {username}@node2 ssh-copy-id {username}@node3 -#. (Recommended) Modify the ``~/.ssh/config`` file of your ``ceph-deploy`` - admin node so that ``ceph-deploy`` can log in to Ceph nodes as the user you - created without requiring you to specify ``--username {username}`` each +#. (Recommended) Modify the ``~/.ssh/config`` file of your ``ceph-deploy`` + admin node so that ``ceph-deploy`` can log in to Ceph nodes as the user you + created without requiring you to specify ``--username {username}`` each time you execute ``ceph-deploy``. This has the added benefit of streamlining ``ssh`` and ``scp`` usage. Replace ``{username}`` with the user name you created:: @@ -232,10 +232,10 @@ Ensure Connectivity Ensure connectivity using ``ping`` with short hostnames (``hostname -s``). Address hostname resolution issues as necessary. - + .. note:: Hostnames should resolve to a network IP address, not to the loopback IP address (e.g., hostnames should resolve to an IP address other - than ``127.0.0.1``). If you use your admin node as a Ceph node, you + than ``127.0.0.1``). If you use your admin node as a Ceph node, you should also ensure that it resolves to its hostname and IP address (i.e., not its loopback IP address).