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.80.11~33^2 X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=f71a6ebf1b371f9389865a0a33652841726ff77b;p=ceph.git doc: correct links to download.ceph.com Signed-off-by: Alfredo Deza (cherry picked from commit 387d7800359154950431d0984c756f43f21dd9b4) Conflicts: doc/install/get-packages.rst preferred the new version in all cases --- diff --git a/doc/install/get-packages.rst b/doc/install/get-packages.rst index d091cd67227f7..418696980acbf 100644 --- a/doc/install/get-packages.rst +++ b/doc/install/get-packages.rst @@ -3,18 +3,18 @@ ============== 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:** Retrieving packages to install Ceph provides @@ -28,39 +28,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. @@ -82,13 +82,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 @@ -96,67 +96,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. :: - - 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 ------------- - -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 +(QA and developers only):: - [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 @@ -166,20 +111,34 @@ 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: +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 + production environment. Critical bug fixes are backported and point releases + are made as necessary. + +- **Giant:** Giant is the seventh major release 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. + +- **Firefly:** Firefly is the sixth major release of Ceph. These packages + 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. -- **Emperor:** Emperor is the most recent major release 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. - - **Dumpling:** Dumpling is the fourth major release of Ceph. These packages are recommended for anyone deploying Ceph in a production environment. Critical bug fixes are backported as necessary. @@ -197,46 +156,46 @@ The major releases of Ceph include: and are not yet ready to upgrade. .. 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-emperor/ {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-emperor/ $(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 @@ -246,32 +205,34 @@ 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 -see which distributions Ceph supports. :: +``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 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 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 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 @@ -279,27 +240,27 @@ 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 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 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 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 @@ -309,14 +270,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 @@ -328,7 +289,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 @@ -358,10 +319,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. @@ -377,7 +338,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 @@ -400,7 +361,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 @@ -409,7 +370,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. :: @@ -421,7 +382,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 @@ -430,7 +391,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 @@ -439,20 +400,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 @@ -470,14 +431,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' @@ -496,26 +457,26 @@ 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-emperor/{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-emperor/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-emperor + 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' .. _Install Ceph Object Storage: ../install-storage-cluster .. _the testing Debian repository: http://ceph.com/debian-testing/dists -.. _the gitbuilder page: http://gitbuilder.ceph.com \ No newline at end of file +.. _the gitbuilder page: http://gitbuilder.ceph.com