From: Alfredo Deza Date: Fri, 18 Sep 2015 18:13:02 +0000 (-0400) Subject: doc: correct links to download.ceph.com X-Git-Tag: v0.94.4~18^2~2 X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=faccdce79e003318c751dd9203773af7ed31d052;p=ceph.git doc: correct links to download.ceph.com Signed-off-by: Alfredo Deza (cherry picked from commit 387d7800359154950431d0984c756f43f21dd9b4) --- diff --git a/doc/install/get-packages.rst b/doc/install/get-packages.rst index 64ba5f9b1beb..8491b40a01e1 100644 --- a/doc/install/get-packages.rst +++ b/doc/install/get-packages.rst @@ -3,20 +3,20 @@ ============== To install Ceph and other enabling software, you need to retrieve packages from -the Ceph repository. Follow this guide to get packages; then, proceed to the +the Ceph repository. Follow this guide to get packages; then, proceed to the `Install Ceph Object Storage`_. Getting Packages ================ -There are two ways to get packages: +There are two ways to get packages: -- **Add Repositories:** Adding repositories is the easiest way to get packages, +- **Add Repositories:** Adding repositories is the easiest way to get packages, because package management tools will retrieve the packages and all enabling - software for you in most cases. However, to use this approach, each + software for you in most cases. However, to use this approach, each :term:`Ceph Node` in your cluster must have internet access. - + - **Download Packages Manually:** Downloading packages manually is a convenient way to install Ceph if your environment does not allow a :term:`Ceph Node` to access the internet. @@ -25,39 +25,39 @@ There are two ways to get packages: Requirements ============ -All Ceph deployments require Ceph packages (except for development). You should -also add keys and recommended packages. +All Ceph deployments require Ceph packages (except for development). You should +also add keys and recommended packages. -- **Keys: (Recommended)** Whether you add repositories or download packages +- **Keys: (Recommended)** Whether you add repositories or download packages manually, you should download keys to verify the packages. If you do not get - the keys, you may encounter security warnings. There are two keys: one for - releases (common) and one for development (programmers and QA only). Choose + the keys, you may encounter security warnings. There are two keys: one for + releases (common) and one for development (programmers and QA only). Choose the key that suits your needs. See `Add Keys`_ for details. -- **Ceph Extras: (Required)** The Ceph Extras repository provides newer - Ceph-enabled versions of packages which are already provided in your Linux - distribution, but where newer versions are required to support Ceph. Examples - of newer versions of available packages include QEMU for CentOS/RHEL - distribution and iSCSI among others. If you intend to use any of the - foregoing packages, you must add the Ceph Extras repository or download the +- **Ceph Extras: (Required)** The Ceph Extras repository provides newer + Ceph-enabled versions of packages which are already provided in your Linux + distribution, but where newer versions are required to support Ceph. Examples + of newer versions of available packages include QEMU for CentOS/RHEL + distribution and iSCSI among others. If you intend to use any of the + foregoing packages, you must add the Ceph Extras repository or download the packages manually. This repository also contains Ceph dependencies for those who intend to install Ceph manually. See `Add Ceph Extras`_ for details. -- **Ceph: (Required)** All Ceph deployments require Ceph release packages, - except for deployments that use development packages (development, QA, and +- **Ceph: (Required)** All Ceph deployments require Ceph release packages, + except for deployments that use development packages (development, QA, and bleeding edge deployments only). See `Add Ceph`_ for details. -- **Ceph Development: (Optional)** If you are developing for Ceph, testing Ceph - development builds, or if you want features from the bleeding edge of Ceph - development, you may get Ceph development packages. See +- **Ceph Development: (Optional)** If you are developing for Ceph, testing Ceph + development builds, or if you want features from the bleeding edge of Ceph + development, you may get Ceph development packages. See `Add Ceph Development`_ for details. -- **Apache/FastCGI: (Optional)** If you are deploying a - :term:`Ceph Object Storage` service, you must install Apache and FastCGI. - Ceph provides Apache and FastCGI builds that are identical to those available - from Apache, but with 100-continue support. If you want to enable - :term:`Ceph Object Gateway` daemons with 100-continue support, you must - retrieve Apache/FastCGI packages from the Ceph repository. +- **Apache/FastCGI: (Optional)** If you are deploying a + :term:`Ceph Object Storage` service, you must install Apache and FastCGI. + Ceph provides Apache and FastCGI builds that are identical to those available + from Apache, but with 100-continue support. If you want to enable + :term:`Ceph Object Gateway` daemons with 100-continue support, you must + retrieve Apache/FastCGI packages from the Ceph repository. See `Add Apache/FastCGI`_ for details. @@ -79,13 +79,13 @@ APT To install the ``release.asc`` key, execute the following:: - wget -q -O- 'https://ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/release.asc' | sudo apt-key add - + wget -q -O- 'https://git.ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/release.asc' | sudo apt-key add - -To install the ``autobuild.asc`` key, execute the following -(QA and developers only):: +To install the ``autobuild.asc`` key, execute the following +(QA and developers only):: - wget -q -O- 'https://ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/autobuild.asc' | sudo apt-key add - + wget -q -O- 'https://git.ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/autobuild.asc' | sudo apt-key add - RPM @@ -93,71 +93,12 @@ RPM To install the ``release.asc`` key, execute the following:: - sudo rpm --import 'https://ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/release.asc' + sudo rpm --import 'https://git.ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/release.asc' To install the ``autobuild.asc`` key, execute the following -(QA and developers only):: - - sudo rpm --import 'https://ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/autobuild.asc' - - - -Add Ceph Extras -=============== - -Some Ceph deployments require newer Ceph-enabled versions of packages that are -already available in your Linux distribution. For example, Ceph Extras contains -newer Ceph-enabled packages for the SCSI target framework and QEMU packages for -RPMs. The repository also contains ``curl``, ``leveldb`` and other Ceph -dependencies. Add the Ceph Extras repository to ensure you obtain these -additional packages from the Ceph repository. - - -Debian Packages ---------------- - -Add our Ceph Extras package repository to your system's list of APT sources. :: +(QA and developers only):: - echo deb http://ceph.com/packages/ceph-extras/debian $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph-extras.list - - -RPM Packages ------------- - -.. note:: ceph-extras on RPM-based systems is only needed on EL6-based - distributions (RHEL 6, CentOS 6, Scientific Linux 6). It is not needed - for Fedora or RHEL 7+. - -For RPM packages, add our package repository to your ``/etc/yum.repos.d`` repos (e.g., -``ceph-extras.repo``). Some Ceph packages (e.g., QEMU) must take priority over standard -packages, so you must ensure that you set ``priority=2``. :: - - [ceph-extras] - name=Ceph Extras Packages - baseurl=http://ceph.com/packages/ceph-extras/rpm/{distro}/$basearch - enabled=1 - priority=2 - gpgcheck=1 - type=rpm-md - gpgkey=https://ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/release.asc - - [ceph-extras-noarch] - name=Ceph Extras noarch - baseurl=http://ceph.com/packages/ceph-extras/rpm/{distro}/noarch - enabled=1 - priority=2 - gpgcheck=1 - type=rpm-md - gpgkey=https://ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/release.asc - - [ceph-extras-source] - name=Ceph Extras Sources - baseurl=http://ceph.com/packages/ceph-extras/rpm/{distro}/SRPMS - enabled=1 - priority=2 - gpgcheck=1 - type=rpm-md - gpgkey=https://ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/release.asc + sudo rpm --import 'https://git.ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/autobuild.asc' Add Ceph @@ -167,18 +108,18 @@ Release repositories use the ``release.asc`` key to verify packages. To install Ceph packages with the Advanced Package Tool (APT) or Yellowdog Updater, Modified (YUM), you must add Ceph repositories. -You may find releases for Debian/Ubuntu (installed with APT) at:: +You may find releases for Debian/Ubuntu (installed with APT) at:: - http://ceph.com/debian-{release-name} + http://download.ceph.com/debian-{release-name} -You may find releases for CentOS/RHEL and others (installed with YUM) at:: +You may find releases for CentOS/RHEL and others (installed with YUM) at:: - http://ceph.com/rpm-{release-name} + http://download.ceph.com/rpm-{release-name} The major releases of Ceph include: - **Hammer:** Hammer is the most recent, and is also the eighth major release - of Ceph. These packages are recommended for anyone deploying Ceph in a + of Ceph. These packages are recommended for anyone deploying Ceph in a production environment. Critical bug fixes are backported and point releases are made as necessary. @@ -187,14 +128,14 @@ The major releases of Ceph include: bug fixes are backported and point releases are made as necessary. - **Firefly:** Firefly is the sixth major release of Ceph. These packages - are recommended for anyone deploying Ceph in a production environment. + are recommended for anyone deploying Ceph in a production environment. Firefly is a long-term stable release, so critical bug fixes are backported and point releases are made as necessary. - **Emperor:** Emperor is the fifth major release of Ceph. These packages are are old and no longer supported, so we recommend that users upgrade to Firefly immediately. - + - **Dumpling:** Dumpling is the fourth major release of Ceph. These packages are older and not recommended for new users, but critical bug fixes are still backported as necessary. We encourage all Dumpling users to update to @@ -205,46 +146,46 @@ The major releases of Ceph include: users upgrade to a supported version. .. tip:: For European users, there is also a mirror in the Netherlands at: - http://eu.ceph.com/ + http://eu.ceph.com/ Debian Packages --------------- Add a Ceph package repository to your system's list of APT sources. For newer -versions of Debian/Ubuntu, call ``lsb_release -sc`` on the command line to -get the short codename, and replace ``{codename}`` in the following command. :: +versions of Debian/Ubuntu, call ``lsb_release -sc`` on the command line to +get the short codename, and replace ``{codename}`` in the following command. :: - sudo apt-add-repository 'deb http://ceph.com/debian-firefly/ {codename} main' + sudo apt-add-repository 'deb http://download.ceph.com/debian-firefly/ {codename} main' -For early Linux distributions, you may execute the following command:: +For early Linux distributions, you may execute the following command:: - 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 For earlier Ceph releases, replace ``{release-name}`` with the name with the name of the Ceph release. You may call ``lsb_release -sc`` on the command line to get the short codename, and replace ``{codename}`` in the following command. :: - sudo apt-add-repository 'deb http://ceph.com/debian-{release-name}/ {codename} main' + sudo apt-add-repository 'deb http://download.ceph.com/debian-{release-name}/ {codename} main' For older Linux distributions, replace ``{release-name}`` with the name of the -release:: +release:: - echo deb http://ceph.com/debian-{release-name}/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list + echo deb http://download.ceph.com/debian-{release-name}/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list Ceph on ARM processors requires Google's memory profiling tools (``google-perftools``). The Ceph repository should have a copy at -http://ceph.com/packages/google-perftools/debian. :: +http://download.ceph.com/packages/google-perftools/debian. :: - echo deb http://ceph.com/packages/google-perftools/debian $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/google-perftools.list + echo deb http://download.ceph.com/packages/google-perftools/debian $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/google-perftools.list For development release packages, add our package repository to your system's list of APT sources. See `the testing Debian repository`_ for a complete list of Debian and Ubuntu releases supported. :: - echo deb http://ceph.com/debian-testing/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list + echo deb http://download.ceph.com/debian-testing/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list RPM Packages @@ -254,37 +195,37 @@ For major releases, you may add a Ceph entry to the ``/etc/yum.repos.d`` directory. Create a ``ceph.repo`` file. In the example below, replace ``{ceph-release}`` with a major release of Ceph (e.g., ``dumpling``, ``emperor``, etc.) and ``{distro}`` with your Linux distribution (e.g., ``el6``, -``rhel6``, etc.). You may view http://ceph.com/rpm-{ceph-release}/ directory to +``rhel6``, etc.). You may view http://download.ceph.com/rpm-{ceph-release}/ directory to see which distributions Ceph supports. Some Ceph packages (e.g., EPEL) must take priority over standard packages, so you must ensure that you set ``priority=2``. :: [ceph] name=Ceph packages for $basearch - baseurl=http://ceph.com/rpm-{ceph-release}/{distro}/$basearch + baseurl=http://download.ceph.com/rpm-{ceph-release}/{distro}/$basearch enabled=1 priority=2 gpgcheck=1 type=rpm-md - gpgkey=https://ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/release.asc + gpgkey=https://git.ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/release.asc [ceph-noarch] name=Ceph noarch packages - baseurl=http://ceph.com/rpm-{ceph-release}/{distro}/noarch + baseurl=http://download.ceph.com/rpm-{ceph-release}/{distro}/noarch enabled=1 priority=2 gpgcheck=1 type=rpm-md - gpgkey=https://ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/release.asc + gpgkey=https://git.ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/release.asc [ceph-source] name=Ceph source packages - baseurl=http://ceph.com/rpm-{ceph-release}/{distro}/SRPMS + baseurl=http://download.ceph.com/rpm-{ceph-release}/{distro}/SRPMS enabled=0 priority=2 gpgcheck=1 type=rpm-md - gpgkey=https://ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/release.asc + gpgkey=https://git.ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/release.asc For development release packages, you may specify the repository @@ -292,30 +233,30 @@ for development releases instead. :: [ceph] name=Ceph packages for $basearch/$releasever - baseurl=http://ceph.com/rpm-testing/{distro}/$basearch + baseurl=http://download.ceph.com/rpm-testing/{distro}/$basearch enabled=1 priority=2 gpgcheck=1 type=rpm-md - gpgkey=https://ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/release.asc + gpgkey=https://git.ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/release.asc [ceph-noarch] name=Ceph noarch packages - baseurl=http://ceph.com/rpm-testing/{distro}/noarch + baseurl=http://download.ceph.com/rpm-testing/{distro}/noarch enabled=1 priority=2 gpgcheck=1 type=rpm-md - gpgkey=https://ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/release.asc + gpgkey=https://git.ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/release.asc [ceph-source] name=Ceph source packages - baseurl=http://ceph.com/rpm-testing/{distro}/SRPMS + baseurl=http://download.ceph.com/rpm-testing/{distro}/SRPMS enabled=0 priority=2 gpgcheck=1 type=rpm-md - gpgkey=https://ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/release.asc + gpgkey=https://git.ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/release.asc For specific packages, you may retrieve them by specifically downloading the @@ -325,14 +266,14 @@ Development packages have new features integrated quickly, while still undergoing several weeks of QA prior to release. The repository package installs the repository details on your local system for -use with ``yum`` or ``up2date``. Replace ``{distro}`` with your Linux distribution, +use with ``yum`` or ``up2date``. Replace ``{distro}`` with your Linux distribution, and ``{release}`` with the specific release of Ceph:: - su -c 'rpm -Uvh http://ceph.com/rpms/{distro}/x86_64/ceph-{release}.el6.noarch.rpm' + su -c 'rpm -Uvh http://download.ceph.com/rpms/{distro}/x86_64/ceph-{release}.el6.noarch.rpm' You can download the RPMs directly from:: - http://ceph.com/rpm-testing + http://download.ceph.com/rpm-testing Add Ceph Development @@ -344,7 +285,7 @@ ensure that you remove repository entries for major releases first. Debian Packages ---------------- +--------------- We automatically build Debian and Ubuntu packages for current development branches in the Ceph source code repository. These @@ -374,10 +315,10 @@ install. :: enabled=0 gpgcheck=1 type=rpm-md - gpgkey=https://ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/autobuild.asc + gpgkey=https://git.ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/autobuild.asc -You may view http://gitbuilder.ceph.com directory to see which distributions +You may view http://gitbuilder.ceph.com directory to see which distributions Ceph supports. @@ -393,7 +334,7 @@ Debian Packages --------------- Add our Apache and FastCGI packages to your system's list of APT sources if you intend to -use 100-continue. :: +use 100-continue. :: echo deb http://gitbuilder.ceph.com/apache2-deb-$(lsb_release -sc)-x86_64-basic/ref/master $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph-apache.list echo deb http://gitbuilder.ceph.com/libapache-mod-fastcgi-deb-$(lsb_release -sc)-x86_64-basic/ref/master $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph-fastcgi.list @@ -416,7 +357,7 @@ http://gitbuilder.ceph.com directory to see which distributions Ceph supports. priority=2 gpgcheck=1 type=rpm-md - gpgkey=https://ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/autobuild.asc + gpgkey=https://git.ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/autobuild.asc [apache2-ceph-source] name=Apache source packages for Ceph @@ -425,7 +366,7 @@ http://gitbuilder.ceph.com directory to see which distributions Ceph supports. priority=2 gpgcheck=1 type=rpm-md - gpgkey=https://ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/autobuild.asc + gpgkey=https://git.ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/autobuild.asc Repeat the forgoing process by creating a ``ceph-fastcgi.repo`` file. :: @@ -437,7 +378,7 @@ Repeat the forgoing process by creating a ``ceph-fastcgi.repo`` file. :: priority=2 gpgcheck=1 type=rpm-md - gpgkey=https://ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/autobuild.asc + gpgkey=https://git.ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/autobuild.asc [fastcgi-ceph-noarch] name=FastCGI noarch packages for Ceph @@ -446,7 +387,7 @@ Repeat the forgoing process by creating a ``ceph-fastcgi.repo`` file. :: priority=2 gpgcheck=1 type=rpm-md - gpgkey=https://ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/autobuild.asc + gpgkey=https://git.ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/autobuild.asc [fastcgi-ceph-source] name=FastCGI source packages for Ceph @@ -455,20 +396,20 @@ Repeat the forgoing process by creating a ``ceph-fastcgi.repo`` file. :: priority=2 gpgcheck=1 type=rpm-md - gpgkey=https://ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/autobuild.asc + gpgkey=https://git.ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/autobuild.asc Download Packages ================= -If you are attempting to install behind a firewall in an environment without internet -access, you must retrieve the packages (mirrored with all the necessary dependencies) +If you are attempting to install behind a firewall in an environment without internet +access, you must retrieve the packages (mirrored with all the necessary dependencies) before attempting an install. Debian Packages --------------- -Ceph requires additional additional third party libraries. +Ceph requires additional additional third party libraries. - libaio1 - libsnappy1 @@ -486,14 +427,14 @@ your Linux distribution codename. Replace ``{arch}`` with the CPU architecture. :: - wget -q http://ceph.com/debian-{release}/pool/main/c/ceph/ceph_{version}{distro}_{arch}.deb + wget -q http://download.ceph.com/debian-{release}/pool/main/c/ceph/ceph_{version}{distro}_{arch}.deb RPM Packages ------------ -Ceph requires additional additional third party libraries. -To add the EPEL repository, execute the following:: +Ceph requires additional additional third party libraries. +To add the EPEL repository, execute the following:: su -c 'rpm -Uvh http://dl.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm' @@ -512,22 +453,22 @@ platforms. The repository package installs the repository details on your local system for use with ``yum`` or ``up2date``. Replace ``{distro}`` with your distribution. :: - su -c 'rpm -Uvh http://ceph.com/rpm-firefly/{distro}/noarch/ceph-{version}.{distro}.noarch.rpm' + su -c 'rpm -Uvh http://download.ceph.com/rpm-firefly/{distro}/noarch/ceph-{version}.{distro}.noarch.rpm' For example, for CentOS 6 (``el6``):: - su -c 'rpm -Uvh http://ceph.com/rpm-firefly/el6/noarch/ceph-release-1-0.el6.noarch.rpm' + su -c 'rpm -Uvh http://download.ceph.com/rpm-firefly/el6/noarch/ceph-release-1-0.el6.noarch.rpm' You can download the RPMs directly from:: - http://ceph.com/rpm-firefly + http://download.ceph.com/rpm-firefly -For earlier Ceph releases, replace ``{release-name}`` with the name -with the name of the Ceph release. You may call ``lsb_release -sc`` on the command +For earlier Ceph releases, replace ``{release-name}`` with the name +with the name of the Ceph release. You may call ``lsb_release -sc`` on the command line to get the short codename. :: - su -c 'rpm -Uvh http://ceph.com/rpm-{release-name}/{distro}/noarch/ceph-{version}.{distro}.noarch.rpm' + su -c 'rpm -Uvh http://download.ceph.com/rpm-{release-name}/{distro}/noarch/ceph-{version}.{distro}.noarch.rpm'