You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@couchdb.apache.org by wo...@apache.org on 2021/04/26 01:53:24 UTC
[couchdb-documentation] branch new-binaries created (now 5da6a06)
This is an automated email from the ASF dual-hosted git repository.
wohali pushed a change to branch new-binaries
in repository https://gitbox.apache.org/repos/asf/couchdb-documentation.git.
at 5da6a06 Update docs for new binary location
This branch includes the following new commits:
new 5da6a06 Update docs for new binary location
The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
[couchdb-documentation] 01/01: Update docs for new binary location
Posted by wo...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
wohali pushed a commit to branch new-binaries
in repository https://gitbox.apache.org/repos/asf/couchdb-documentation.git
commit 5da6a06d6831c2b40aa12274489f150edf6696dc
Author: Joan Touzet <jo...@atypical.net>
AuthorDate: Sun Apr 25 21:53:12 2021 -0400
Update docs for new binary location
---
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 3e22a2b..ff7d3f4 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
* CentOS/RHEL 8
* Debian 9 (stretch)
@@ -49,97 +48,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
@@ -148,7 +86,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.
@@ -158,7 +96,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) <ro...@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) <wo...@apache.org>
+
+Both are available from most popular GPG key servers.
Installation from source
========================