This is an automated email from the ASF dual-hosted git repository.
wohali pushed a commit to branch 3.1.1-maint
in repository https://gitbox.apache.org/repos/asf/couchdb-documentation.git
commit 46e22cd5fbde3a7006c33b0ae2746b91a2ab8476
Author: Joan Touzet <woh...@users.noreply.github.com>
AuthorDate: Sun Apr 25 23:05:07 2021 -0400
Update docs for new binary location (#654)
---
src/install/unix.rst | 112 ++++++++++++++++-----------------------------------
1 file changed, 34 insertions(+), 78 deletions(-)
diff --git a/src/install/unix.rst b/src/install/unix.rst
index 64a0333..24ea880 100644
--- a/src/install/unix.rst
+++ b/src/install/unix.rst
@@ -29,7 +29,6 @@ Installation using the Apache CouchDB convenience binary
packages
If you are running one of the following operating systems, the easiest way
to install CouchDB is to use the convenience binary packages:
-* CentOS/RHEL 6
* CentOS/RHEL 7
* Debian 9 (stretch)
* Debian 10 (buster)
@@ -48,97 +47,36 @@ details are in the `README.Debian`_ file.
.. _README.Debian:
https://github.com/apache/couchdb-pkg/blob/master/debian/README.Debian
-Apache CouchDB also provides packages for the SpiderMonkey 1.8.5 JavaScript
-dependency, as the upstream packages for this shared library are starting to
-disappear or become unreliable.
+For distributions lacking a compatible SpiderMonkey library, Apache CouchDB
+also provides packages for the 1.8.5 version.
Enabling the Apache CouchDB package repository
----------------------------------------------
.. highlight:: sh
-**Debian 9 (stretch)**: Run the following commands::
+**Debian or Ubuntu**: Run the following commands::
- $ sudo apt-get install -y apt-transport-https gnupg ca-certificates
- $ echo "deb https://apache.bintray.com/couchdb-deb stretch main" \
- | sudo tee /etc/apt/sources.list.d/couchdb.list
+ sudo apt update && sudo apt install -y curl apt-transport-https gnupg
+ curl https://couchdb.apache.org/repo/keys.asc | gpg --dearmor | sudo tee
/usr/share/keyrings/couchdb-archive-keyring.gpg >/dev/null 2>&1
+ source /etc/os-release
+ echo "deb [signed-by=/usr/share/keyrings/couchdb-archive-keyring.gpg]
https://apache.jfrog.io/artifactory/couchdb-deb/ ${VERSION_CODENAME} main" \
+ | sudo tee /etc/apt/sources.list.d/couchdb.list >/dev/null
-**Debian 10 (buster)**: Run the following commands::
+**RedHat or CentOS**: Run the following commands::
- $ sudo apt-get install -y gnupg ca-certificates
- $ echo "deb https://apache.bintray.com/couchdb-deb buster main" \
- | sudo tee /etc/apt/sources.list.d/couchdb.list
-
-**Ubuntu 16.04 (Xenial)**: Run the following commands::
-
- $ sudo apt-get install -y apt-transport-https gnupg ca-certificates
- $ echo "deb https://apache.bintray.com/couchdb-deb xenial main" \
- | sudo tee /etc/apt/sources.list.d/couchdb.list
-
-**Ubuntu 18.04 (Bionic)**: Run the following commands::
-
- $ sudo apt-get install -y gnupg ca-certificates
- $ echo "deb https://apache.bintray.com/couchdb-deb bionic main" \
- | sudo tee /etc/apt/sources.list.d/couchdb.list
-
-**Ubuntu 20.04 (Focal)**: Run the following commands::
-
- $ sudo apt-get install -y gnupg ca-certificates
- $ echo "deb https://apache.bintray.com/couchdb-deb focal main" \
- | sudo tee /etc/apt/sources.list.d/couchdb.list
-
-.. highlight:: ini
-
-**CentOS**: Place the following text into
``/etc/yum.repos.d/bintray-apache-couchdb-rpm.repo``::
-
- [bintray--apache-couchdb-rpm]
- name=bintray--apache-couchdb-rpm
- baseurl=http://apache.bintray.com/couchdb-rpm/el$releasever/$basearch/
- gpgcheck=0
- repo_gpgcheck=0
- enabled=1
-
-**RedHat 6**: Place the following text into
``/etc/yum.repos.d/bintray-apache-couchdb-rpm.repo``::
-
- [bintray--apache-couchdb-rpm]
- name=bintray--apache-couchdb-rpm
- baseurl=http://apache.bintray.com/couchdb-rpm/el6/$basearch/
- gpgcheck=0
- repo_gpgcheck=0
- enabled=1
-
-**RedHat 7**: Place the following text into
``/etc/yum.repos.d/bintray-apache-couchdb-rpm.repo``::
-
- [bintray--apache-couchdb-rpm]
- name=bintray--apache-couchdb-rpm
- baseurl=http://apache.bintray.com/couchdb-rpm/el7/$basearch/
- gpgcheck=0
- repo_gpgcheck=0
- enabled=1
-
-**RedHat 8**: Place the following text into
``/etc/yum.repos.d/bintray-apache-couchdb-rpm.repo``::
-
- [bintray--apache-couchdb-rpm]
- name=bintray--apache-couchdb-rpm
- baseurl=http://apache.bintray.com/couchdb-rpm/el8/$basearch/
- gpgcheck=0
- repo_gpgcheck=0
- enabled=1
+ sudo yum install -y yum-utils
+ sudo yum-config-manager --add-repo
https://couchdb.apache.org/repo/couchdb.repo
Installing the Apache CouchDB packages
--------------------------------------
.. highlight:: sh
-**Debian/Ubuntu**: First, install the CouchDB repository key::
+**Debian or Ubuntu**: Run the following commands::
- $ sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys \
- 8756C4F765C9AC3CB6B85D62379CE192D401AB61
-
-Then update the repository cache and install the package::
-
- $ sudo apt update
- $ sudo apt install -y couchdb
+ sudo apt update
+ sudo apt install -y couchdb
Debian/Ubuntu installs from binaries can be pre-configured for single node or
clustered installations. For clusters, multiple nodes will still need to be
@@ -147,7 +85,7 @@ joined together and configured consistently across all
machines; **follow the**
**RedHat/CentOS**: Run the command::
- $ sudo yum -y install epel-release && sudo yum -y install couchdb
+ sudo yum install -y couchdb
Once installed, :ref:`create an admin user<config/admins>` by hand before
starting CouchDB, if your installer didn't do this for you already.
@@ -157,7 +95,25 @@ You can now start the service.
**Your installation is not complete. Be sure to complete the**
:ref:`Setup <setup>` **steps for a single node or clustered installation.**
-Relax! CouchDB is installed and running.
+**Relax!** CouchDB is installed and running.
+
+GPG keys used for signing the CouchDB repositories
+--------------------------------------------------
+
+As of 2021.04.25, the *repository* signing key for both types of supported
packages
+is::
+
+ pub rsa8192 2015-01-19 [SC]
+ 390EF70BB1EA12B2773962950EE62FB37A00258D
+ uid The Apache Software Foundation (Package repository signing
key) <r...@apache.org>
+
+As of 2021.04.25, the *package* signing key (only used for ``rpm`` packages)
is::
+
+ pub rsa4096 2017-07-28 [SC] [expires: 2022-07-27]
+ 2EC788AE3F239FA13E82D215CDE711289384AE37
+ uid Joan Touzet (Apache Code Signing Key) <woh...@apache.org>
+
+Both are available from most popular GPG key servers.
Installation from source
========================
