diff --git a/doc/source/admin/install/index.rst b/doc/source/admin/install/index.rst index c6d3f134..ec16f4f4 100644 --- a/doc/source/admin/install/index.rst +++ b/doc/source/admin/install/index.rst @@ -6,6 +6,7 @@ Installation Guide :glob: install-source + install-debian install-ubuntu install-rdo mod_wsgi diff --git a/doc/source/admin/install/install-debian.rst b/doc/source/admin/install/install-debian.rst new file mode 100644 index 00000000..cd4443bd --- /dev/null +++ b/doc/source/admin/install/install-debian.rst @@ -0,0 +1,45 @@ +Install from packages for Debian +================================ + +Packages for Debian are available since CloudKitty 6.0.0 (OpenStack Pike) in +2018. + +Optional: enable the OpenStack repository for a specific release +---------------------------------------------------------------- + +If using Debian Stable, and do not wish to install unofficial backports from +osbpo.debian.net, skip this step. Otherwise, here is how to enable the +repository: + +.. code-block:: console + + apt-get install extrepo + extrepo search openstack + extrepo enable openstack_epoxy + apt-get update + +Note that it is possible to use a local mirror, and avoid internet access, by +using the extrepo-offline-data package: + +.. code-block:: console + + apt-get install extrepo-offline-data + extrepo search openstack --offlinedata + extrepo enable openstack_epoxy --offlinedata --mirror YOUR_MIRROR + +Note that extrepo-offline-data may be lagging behind the online data and it may +not contain the latest OpenStack repositories. + +Upgrade the packages on your host +--------------------------------- + +.. code-block:: console + + apt update && apt dist-upgrade + +Install the packages +-------------------- + +.. code-block:: console + + apt-get install cloudkitty-api cloudkitty-processor cloudkitty-dashboard diff --git a/doc/source/admin/install/install-ubuntu.rst b/doc/source/admin/install/install-ubuntu.rst index fb4ef3c0..10dde61f 100644 --- a/doc/source/admin/install/install-ubuntu.rst +++ b/doc/source/admin/install/install-ubuntu.rst @@ -1,13 +1,9 @@ -Install from packages for Ubuntu (16.04) -======================================== +Install from packages for Ubuntu +================================ -Packages for Ubuntu 16.04 are available starting from the Newton release. - -#. Enable the OpenStack repository for the Newton or Ocata release:: - - apt install software-properties-common - add-apt-repository ppa:objectif-libre/cloudkitty # Newton - add-apt-repository ppa:objectif-libre/cloudkitty-ocata # Ocata +Note that Canonical doesn't maintain CloudKitty packages. These are only +maintained in Debian, and then imported from Debian Unstable to the +Ubuntu Universe repository. #. Upgrade the packages on your host::