Apache CouchDB auf CentOS 7 installieren und konfigurieren
Apache CouchDB ist ein quelloffener NoSQL-Datenbankserver, der kostenlos nutzbar ist. Die Daten werden in Datenbanken als JSON-Dokumente gespeichert. Zudem stellt CouchDB eine REST-konforme HTTP-Schnittstelle bereit, mit der sich Dokumente einfach erstellen, ändern, abrufen und löschen lassen.
Schritt-für-Schritt-Anleitung zur Einrichtung von Apache CouchDB auf CentOS 7
Diese Anleitung zeigt dir, wie du Apache CouchDB auf einem Server mit CentOS 7 installierst und einrichtest.
Voraussetzungen
- Eine CentOS-7-Instanz bereitstellen.
- Mit dem bereitgestellten Server verbinden.
- Das System auf den neuesten Stand bringen.
Einrichten des CouchDB-Software-Repositorys
1. EPEL-Repository installieren
Installiere zunächst das EPEL-Repository, das für CouchDB nötig ist:
$ sudo yum install epel-release
2. CouchDB-Repository-Datei erstellen
Erstelle eine neue Repository-Datei für CouchDB mit folgendem Befehl:
$ sudo nano /etc/yum.repos.d/apache-couchdb.repo
Füge folgenden Inhalt in die Datei ein:
[Apache-Couchdb]
name=couchdb
baseurl=https://apache.jfrog.io/artifactory/couchdb-rpm/el$releasever/$basearch/
gpgkey=https://couchdb.apache.org/repo/keys.asc https://couchdb.apache.org/repo/rpm-package-key.asc
gpgcheck=1
repo_gpgcheck=1
enabled=1
CouchDB installieren
Installiere CouchDB mit folgendem Befehl, nachdem das Repository eingerichtet ist:
$ sudo yum install couchdb
CouchDB-Dienst aktivieren und starten
1. CouchDB beim Systemstart aktivieren
Damit CouchDB automatisch beim Start des Systems ausgeführt wird, verwende diesen Befehl:
$ sudo systemctl enable couchdb
2. CouchDB-Dienst starten
Starte CouchDB mit folgendem Befehl:
$ sudo systemctl start couchdb
CouchDB-Konfiguration auf CentOS 7 anpassen
Alle CouchDB-Daten und Konfigurationsdateien befinden sich im Verzeichnis /opt/couchdb. Die zentrale Konfigurationsdatei ist local.ini und liegt im Unterverzeichnis /opt/couchdb/etc/. Im ersten Schritt bindest du CouchDB an eine Netzwerkschnittstelle und legst anschließend ein Administratorkonto an.
1. CouchDB an Netzwerkadresse binden
Öffne die Konfigurationsdatei local.ini mit folgendem Befehl:
$ sudo nano /opt/couchdb/local.ini
Suche die Zeile mit bind_address =. Standardmäßig ist sie auf 127.0.0.1 gesetzt. Ändere sie auf 0.0.0.0, um CouchDB über alle Netzwerkschnittstellen zugänglich zu machen – oder auf deine öffentliche IP-Adresse, wenn du nur globalen Zugriff erlauben möchtest.
[chttpd]
;port = 5984
bind_address = 127.0.0.1
2. Administrativen Benutzer anlegen
Blättere bis zum Abschnitt [admins] oder suche danach. Dort kannst du einen neuen Eintrag im Format benutzername = passwort ergänzen. Es wird empfohlen, „admin“ durch einen sicheren Benutzernamen zu ersetzen.
[admins]
admin = YOUR-PASSWORD
3. Einzelknoten-Modus aktivieren
Füge unter dem Abschnitt [couchdb] die folgende Zeile hinzu, um den Einzelknotenmodus zu aktivieren. Damit erstellt CouchDB beim Neustart automatisch die erforderlichen Systemdatenbanken.
[couchdb]
single_node=true
Speichere die Datei anschließend und schließe sie.
4. Systemdatenbanken manuell anlegen (optional)
Alternativ kannst du die folgenden Befehle verwenden, um die Systemdatenbanken _users, _replicator und _global_changes manuell zu erstellen:
$ curl -u Username:Password -X PUT http://127.0.0.1:5984/_users
$ curl -u Username:Password -X PUT http://127.0.0.1:5984/_replicator
$ curl -u Username:Password -X PUT http://127.0.0.1:5984/_global_changes
5. Konfigurationsänderungen übernehmen
Starte den CouchDB-Dienst neu, damit die vorgenommenen Änderungen wirksam werden:
$ sudo systemctl restart couchdb
Firewall für CouchDB-Zugriff konfigurieren
1. HTTP-Verkehr freigeben
Erlaube HTTP-Datenverkehr auf dem Server mit diesem Befehl:
$ sudo firewall-cmd --permanent --zone=public --add-service=http
2. HTTPS-Verkehr freigeben (optional)
Wenn dein Server ein SSL-Zertifikat nutzt, kannst du auch HTTPS freischalten:
$ sudo firewall-cmd --permanent --zone=public --add-service=https
3. Port 5984 öffnen
Aktiviere den TCP-Port 5984, der von CouchDB verwendet wird:
$ sudo firewall-cmd --permanent --zone=public --add-port=5984/tcp
4. Firewall-Regeln neu laden
Damit die aktualisierten Firewall-Einstellungen übernommen werden, starte den Firewall-Dienst neu:
$ sudo systemctl reload firewalld
Installation von CouchDB überprüfen
Um sicherzustellen, dass CouchDB korrekt installiert wurde, führe folgenden curl-Befehl im Terminal aus:
$ curl 127.0.0.1:5984
Die Ausgabe sollte in etwa so aussehen:
{"couchdb":"Welcome","version":"3.2.1","git_sha":"244d428af","uuid":"99b896bf19b5b076970e12574b9b9ff8","features":["access-ready","partitioned","pluggable-storage-engines","reshard","scheduler"],"vendor":{"name":"The Apache Software Foundation"}}
Fazit
Die Installation und Konfiguration von Apache CouchDB auf einem CentOS-7-Server ist nun abgeschlossen. Weitere Informationen zur Nutzung findest du in der offiziellen CouchDB-Dokumentation.
