Update Debian package installation documentation (#22405)

#9261 added a warning about the use of `add-apt-repository` which is becoming obsolete over time as new distribution releases include later versions of `add-apt-repository` which don't automatically add the `deb-src` line. This change updates the documentation to make the block a note rather than a warning and adds two other reasons for avoiding `add-apt-repository` which are still relevant: avoiding edits to a system shared file and not requiring a large number of non-default packages to add one line of text to a file.
This commit is contained in:
Chris Adams 2017-01-10 13:49:57 -05:00 committed by Clinton Gormley
parent 93367fb4a8
commit 61213f7917
1 changed files with 11 additions and 6 deletions

View File

@ -62,18 +62,23 @@ echo "deb https://artifacts.elastic.co/packages/{major-version}/apt stable main"
endif::[]
[WARNING]
[NOTE]
==================================================
Do not use `add-apt-repository` as it will add a `deb-src` entry as well, but
we do not provide a source package. If you have added the `deb-src` entry, you
will see an error like the following:
These instructions do not use `add-apt-repository` for several reasons:
. `add-apt-repository` adds entries to the system `/etc/apt/sources.list` file
rather than a clean per-repository file in `/etc/apt/sources.list.d`
. `add-apt-repository` is not part of the default install on many distributions
and requires a number of non-default dependencies.
. Older versions of `add-apt-repository` always add a `deb-src` entry which
will cause errors because we do not provide a source package. If you have added
the `deb-src` entry, you will see an error like the following until you delete
the `deb-src` line:
Unable to find expected entry 'main/source/Sources' in Release file
(Wrong sources.list entry or malformed file)
Delete the `deb-src` entry from the `/etc/apt/sources.list` file and the
installation should work as expected.
==================================================
You can install the Elasticsearch Debian package with: