CouchDB wurde von der Apache Software Foundation entwickelt und ist ein Datenbankverwaltungssystem, das Daten in JSON-Dokumenten speichert. Wir können auf unsere Daten über das HTTP-Protokoll zugreifen. Ebenso können wir die Daten mit JavaScript manipulieren. Die CouchDB-Datenbank verfügt über eine RESTful-HTTP-API zur Verwaltung von Datenbankdokumenten
Was werden wir abdecken??
In diesem Handbuch werden wir uns damit befassen, wie wir die neueste Version von Apache CouchDB auf der Fedora 30-Workstation installieren können. Wir werden auch den Quellcode von der offiziellen Website für dieses Handbuch verwenden. Bevor wir beginnen können, stellen Sie sicher, dass die folgenden Anforderungen erfüllt sind.
Voraussetzungen:
- Benutzerkonto mit „sudo“-Berechtigungen
- Internetverbindung zum Herunterladen verschiedener Dateien
- Grundkenntnisse zum Ausführen von Befehlen unter Linux
Apache CouchDB installieren:
Apache CouchDB benötigt verschiedene Abhängigkeiten, bevor es installiert werden kann. Die offizielle Seite von CouchDB listet diese Abhängigkeiten und ihre genaue zu installierende Versionsnummer auf:
Erlanger OTP (19 .).x, 20.x >= 21.3.8.5, 21.x >= 21.2.3, 22.x >= 22.0.5)Intensivstation
OpenSSL
Mozilla SpiderMonkey (1 .).8.5)
GNU-Make
GNU-Compiler-Sammlung
libcurl
help2man
Python (>=2.7) für Dokumente
Python-Sphinx (>=1.1.3)
Diese Abhängigkeiten können aus dem offiziellen Repository von Fedora 30 installiert werden. Lassen Sie uns sie installieren:
Installieren Sie die oben genannten Abhängigkeiten über den folgenden Befehl:
$ sudo dnf install autoconf autoconf-archive automake curl-devel erlang-asn1 erlang-erts erlang-eunit gcc-c++ erlang-os_mon erlang-xmerl erlang-erl_interface help2man js-devel-1.8.5 libicu-devel libtool perl-Test-Harness
Sobald diese Abhängigkeiten installiert sind, können wir mit der Installation von Apache CouchDB fortfahren, wie unten gezeigt:
Schritt 1. Laden Sie die Tarball-Datei für Apache CouchDB mit dem Befehl 'wget' herunter:
$ wget https://mirrors.estointernet.in/apache/couchdb/source/3.1.1/apache-couchdb-3.1.1.Teer.gz
Schritt 2. Extrahieren Sie die heruntergeladene Tarball-Datei mit dem angegebenen Befehl:
$ tar -xf apache-couchdb-3.1.1.Teer.gzSchritt 3. Verschieben Sie den extrahierten Ordner in den /opt-Ordner und ändern Sie das Verzeichnis dort:
$ sudo mv apache-couchdb-3.1.1 /opt/$ cd /opt/apache-couchdb-3.1.1/
Schritt 4. Um das Paket für Ihr System zu konfigurieren, verwenden Sie das Konfigurationsskript wie unten gezeigt:
$ ./konfigurieren
Wenn Sie die mit dem Konfigurationsskript verfügbaren Optionen anzeigen möchten, verwenden Sie den Befehl:
$ ./configure --helpWenn Sie am Ende des Skripts die Meldung sehen:
Sie haben Apache CouchDB konfiguriert, Zeit zum Entspannen.
Das bedeutet, dass Sie das Paket richtig konfiguriert haben.
Schritt 5. Jetzt erstellen wir den Quellcode, indem wir den folgenden Befehl ausführen:
$ Freigabe machenOder verwenden Sie gmake wenn machen funktioniert nicht.
Falls Sie den folgenden Fehler erhalten:
FEHLER: Die Reltool-Unterstützung erfordert die Installation der reltool-Anwendung!FEHLER: Generieren während der Verarbeitung fehlgeschlagen
IT bedeutet, dass Sie die erlang-reltool Paket zum Erstellen der CouchDB. Verwenden Sie dazu den folgenden Befehl:
$ sudo dnf install erlang-reltool
Führen Sie nun 'make release' mit dem folgenden Befehl erneut aus:
$ Freigabe machenWenn der obige Befehl erfolgreich abgeschlossen wurde, sollten Sie die unten angezeigte Meldung sehen:
"… getan
Sie können das rel/couchdb-Verzeichnis jetzt überall auf Ihrem System kopieren.
Starte CouchDB mit ./bin/couchdb aus diesem Verzeichnis.”
Schritt 6. CouchDB-Benutzer registrieren
CouchDB schlägt vor, einen separaten Benutzer (couchdb) zum Ausführen seiner Dienste zu erstellen. Dies liegt an Sicherheitsüberlegungen. Erstellen Sie den Benutzer mit dem folgenden Befehl:
$ sudo adduser --system -m --shell /bin/bash --comment "CouchDB Administrator" couchdb
Der obige Befehl erstellt einen Benutzer mit dem Namen „couchdb“, zusammen mit einem Home-Verzeichnis und einer Bash-Shell.
Schritt 7. Verwenden Sie nun den Befehl cp, um das Verzeichnis „rel/couchdb” in das Home-Verzeichnis der couchdb (/home/couchdb):
$ sudo cp -R /opt/apache-couchdb-3.1.1/rel/couchdb /home/couchdbHinweis: Verwenden Sie den Pfad „rel/couchdb“ relativ zu Ihrem Extraktionspfad für couchdb.
Schritt 8. Wir müssen nun den Besitz der CouchDB-Verzeichnisse mit dem folgenden Befehl ändern:
$ sudo chown -R couchdb:couchdb /home/couchdb/couchdbSchritt 9. Ändere auf ähnliche Weise die Berechtigung der CouchDB-Verzeichnisse mit dem folgenden Befehl:
$ find /home/couchdb/couchdb -type d -exec chmod 0770 \;
Schritt 10. So ändern Sie die Berechtigungen für die ini-Dateien, öffne ein neues Terminalfenster und führen Sie die folgenden Befehle aus:
$ sudo -i# chmod 0644 /home/couchdb/couchdb/etc/*
Schritt 11. Erstellen Sie einen Admin-Benutzer, bevor Sie couchdb starten (erforderlich in CouchDB Version 3). Öffnen Sie dazu die Datei local.ini-Datei im Verzeichnis „/home/couchdb/couchdb/etc/local.ini“.
# vi /home/couchdb/couchdb/etc/local.iniGehen Sie nun zum Admin-Bereich und entkommentieren Sie die Admin-Zeile, dann geben Sie Ihr Passwort wie folgt ein:
admin = IhrPasswortGeben Sie anstelle von YourPassword das Passwort ein, das Sie verwenden möchten. Sie können jeden Admin-Benutzer im Format „Benutzername = Passwort“ hinzufügen. Siehe das Referenzbild unten:
Kehren Sie nun zum normalen Benutzerterminal zurück, indem Sie exit eingeben:
# Ausfahrt
Schritt 12. Wir starten den CouchDB-Server mit dem folgenden Befehl:
$ sudo -i -u couchdb /home/couchdb/couchdb/bin/couchdbDer obige Befehl startet die CouchDB als couchdb-Benutzer, wie im folgenden Bild gezeigt:
Schritt 13. Öffnen Sie einen Webbrowser und durchsuchen Sie die folgende Adresse, um auf das Admin-Panel zuzugreifen:
http://127.0.0.1:5984/_utils/index.html
Um die Installation zu überprüfen, gehen Sie zu:
http://localhost:5984/_utils/verify_install.html
CouchDB kann als einzelner Knoten oder geclustert konfiguriert werden. Sehen wir uns das Setup für einen einzelnen Knoten an:
Schritt 1. Gehe zu http://127.0.0.1:5984/_utils#setup
Schritt 2. Melden Sie sich mit Ihrem Admin-Konto an
Schritt 3. Klicken Sie bei der erstmaligen Einrichtung auf das Setup-Symbol und wählen Sie die Option „Einen einzelnen Knoten konfigurieren“.
Schritt 4. Erstellen Sie einen neuen Admin-Benutzer für dieses Setup. Wir können auch mit dem vorherigen Benutzer „admin“ fortfahren. In unserem Fall haben wir einen neuen Benutzer angelegt: admin2 und Passwort: 123. Klicken Sie nun auf die Schaltfläche Knoten konfigurieren:
Schritt 5. Wenn Sie auf das Datenbanksymbol klicken, werden Ihnen zwei Systemdatenbanken angezeigt:
Hinweis: Starten Sie die couchdb immer neu, nachdem Sie ein Adminkonto erstellt haben
Schritt 6. Erstellen Sie nach dem Neustart der couchdb eine neue Datenbank im admin2-Konto wie folgt:
Sie sollten die Meldung „Datenbank erfolgreich erstellt“ sehen, wie in der Abbildung unten gezeigt:
Fazit:
In dieser Anleitung erfahren wir, wie Sie CouchDB mithilfe des Quellcodes auf der Fedora 30-Workstation installieren. Wir haben es geschafft, verschiedene Aspekte des Installationsprozesses zu konfigurieren und einige der Fehler zu beheben. Wir haben auch gelernt, die Single-Node-Konfiguration von der GUI aus einzurichten. Was Sie als nächstes tun können, ist:
- Um CouchDB manuell für einen einzelnen Knoten zu konfigurieren; und
- Erstellen Sie ein Cluster-Setup für CouchDB