|
|
# CouchDB 3.x.x unter »Ubuntu« und »Linux Mint«
|
|
# CouchDB 3.x.x unter »Ubuntu« und »Linux Mint«
|
|
|
|
|
|
|
|
Zum jetzigen Zeitpunkt (März 2025) gibt es offizielle Installationspakete für »Ubuntu 24.04« bzw. darauf basierende Linux-Distributionen wie »Linux Mint 22«. Im Folgenden werden die Schritte zur Installation von CouchDB unter »Linux Mint 22« gezeigt.
|
|
Zum jetzigen Zeitpunkt (März 2025) gibt es offizielle Installationspakete für »Ubuntu 24.04« bzw. darauf basierende Linux-Distributionen wie »Linux Mint 22«. Im Folgenden werden die Schritte zur Installation von CouchDB unter »Linux Mint 22« gezeigt.
|
|
|
|
|
|
|
|
## Deinstallation einer selbst kompilierten Version
|
|
## Deinstallation einer selbst kompilierten Version
|
|
|
|
|
|
|
|
Siehe auch [hier](./couchdb-ubuntu-24.04.md)
|
|
Siehe auch [hier](./couchdb-ubuntu-24.04.md)
|
|
|
|
|
|
|
|
```
|
|
```
|
|
|
sudo systemctl stop couchdb.service
|
|
sudo systemctl stop couchdb.service
|
|
|
sudo systemctl disable couchdb.service
|
|
sudo systemctl disable couchdb.service
|
|
|
sudo rm /usr/lib/systemd/system/couchdb.service
|
|
sudo rm /usr/lib/systemd/system/couchdb.service
|
|
|
sudo rm -r /opt/couchdb
|
|
sudo rm -r /opt/couchdb
|
|
|
sudo deluser --remove-home couchdb
|
|
sudo deluser --remove-home couchdb
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
## Anmelden des offiziellen CouchDB-Repositoriums
|
|
## Anmelden des offiziellen CouchDB-Repositoriums
|
|
|
|
|
|
|
|
In der Dokumentation zu CouchDB wird bei der Installation davon ausgegangen, dass unter einer reinen Ubuntu-Distribution installiert wird (siehe [hier](https://docs.couchdb.org/en/stable/install/unix.html#enabling-the-apache-couchdb-package-repository)). Zur Bestimmung deren Version wird die in `/etc/os-release` definierte Variable `VERSION_CODENAME` analysiert. Unter »Linux Mint« muss abweichend `UBUNTU_CODENAME` verwendet werden. Folgende Aufrufe zur Installation führen dann zum Erfolg:
|
|
In der Dokumentation zu CouchDB wird bei der Installation davon ausgegangen, dass unter einer reinen Ubuntu-Distribution installiert wird (siehe [hier](https://docs.couchdb.org/en/stable/install/unix.html#enabling-the-apache-couchdb-package-repository)). Zur Bestimmung deren Version wird die in `/etc/os-release` definierte Variable `VERSION_CODENAME` analysiert. Unter »Linux Mint« muss abweichend `UBUNTU_CODENAME` verwendet werden. Folgende Aufrufe zur Installation führen dann zum Erfolg:
|
|
|
|
|
|
|
|
```
|
|
```
|
|
|
sudo apt update && sudo apt install -y curl apt-transport-https gnupg
|
|
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
|
|
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
|
|
source /etc/os-release
|
|
|
echo "deb [signed-by=/usr/share/keyrings/couchdb-archive-keyring.gpg] https://apache.jfrog.io/artifactory/couchdb-deb/ ${UBUNTU_CODENAME} main" \
|
|
echo "deb [signed-by=/usr/share/keyrings/couchdb-archive-keyring.gpg] https://apache.jfrog.io/artifactory/couchdb-deb/ ${UBUNTU_CODENAME} main" \
|
|
|
| sudo tee /etc/apt/sources.list.d/couchdb.list >/dev/null
|
|
| sudo tee /etc/apt/sources.list.d/couchdb.list >/dev/null
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
Wichtig: Unter
|
|
Wichtig: Unter
|
|
|
|
|
|
|
|
```
|
|
```
|
|
|
/etc/apt/sources.list.d/
|
|
/etc/apt/sources.list.d/
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
muss eine Datei `couchdb.list` entstanden sein, die den Begriff »noble« (Alias für »Ubuntu 24.xx«) enthält.
|
|
muss eine Datei `couchdb.list` entstanden sein, die den Begriff »noble« (Alias für »Ubuntu 24.xx«) enthält.
|
|
|
|
|
|
|
|
## Installation von CouchDB 3.x.x
|
|
## Installation von CouchDB 3.x.x
|
|
|
|
|
|
|
|
```
|
|
```
|
|
|
sudo apt update
|
|
sudo apt update
|
|
|
sudo apt install couchdb
|
|
sudo apt install couchdb
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
Während der Installation werden Fragen zu »single/cluster« und »token« gestellt ...
|
|
Während der Installation erscheint ein interaktiver Dialog. Die Fragen sind wie folgt zu beantworten:
|
|
|
|
|
|
|
|
**TODO** (@Martin): Wie muss das genau beantwortet werden? Bitte ergänzen.
|
|
- Installation type --> standalone (Einzelinstallation, kein Cluster)
|
|
|
|
|
- Bind address --> 0.0.0.0 (ermöglicht externen Zugriff, z. B. aus dem Netz oder via Fauxton)
|
|
|
## Notwendige Einträge in Konfigurationsdateien
|
|
- Admin-Benutzername --> admin
|
|
|
|
|
- Admin-Passwort --> va**um
|
|
|
In `/opt/couchdb/etc/local.ini` (dort oder woanders?)
|
|
- Erlang cookie (»magic token«) --> beliebiger Wert, z.B. vakuum123, bei Einzelinstallation ohne Bedeutung
|
|
|
|
|
|
|
|
```
|
|
Nach Abschluss der Installation sollte CouchDB als Service laufen und über Port 5984 erreichbar sein. Prüfen mit:
|
|
|
???
|
|
|
|
|
```
|
|
```
|
|
|
|
|
systemctl status couchdb
|
|
|
**TODO** (@Martin): Bitte ergänzen.
|
|
curl http://127.0.0.1:5984/
|
|
|
|
|
```
|
|
|
## Anlegen des Admin-Accounts
|
|
|
|
|
|
|
**TODO** (@Martin): Bitte ergänzen.
|
|
|
**TODO** (@Martin): Bitte ergänzen.
|
|
|
|
|
|
|
## Anlegen des Admin-Accounts
|
|
|
## Anlegen eines Nutzer-Accounts
|
|
|
|
|
|
|
**TODO** (@Martin): Bitte ergänzen.
|
|
|
**TODO** (@Martin): Bitte ergänzen.
|
|
|
|
|
|
|
## Anlegen eines Nutzer-Accounts
|
|
|
## Einbeziehen oder Ausschließen vom Replikationsprozess
|
|
|
|
|
|
|
**TODO** (@Martin): Bitte ergänzen.
|
|
|
**TODO** (@Martin): Bitte ergänzen.
|
|
|
|
|
|
|
## Einbeziehen oder Ausschließen vom Replikationsprozess
|
|
|
|
|
|
|
|
|
|
**TODO** (@Martin): Bitte ergänzen.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
