CouchDB, vyvinutý softvérovou nadáciou Apache, je systém na správu databáz, ktorý ukladá údaje do dokumentov JSON. K našim údajom môžeme získať prístup pomocou protokolu HTTP. Podobne môžeme manipulovať s údajmi pomocou JavaScriptu. Databáza CouchDB má RESTful HTTP API na správu databázových dokumentov
Čo pokryjeme?
V tejto príručke sa budeme zaoberať tým, ako môžeme nainštalovať najnovšiu verziu Apache CouchDB na pracovnú stanicu Fedora 30. Pre túto príručku tiež použijeme zdrojový kód z oficiálnej webovej stránky. Skôr ako začneme, uistite sa, že sú splnené nasledujúce požiadavky.
Predpoklady:
- Používateľský účet s oprávneniami „sudo“
- Pripojenie na internet na stiahnutie rôznych súborov
- Základné znalosti o spúšťaní príkazov v systéme Linux
Inštalácia Apache CouchDB:
Apache CouchDB vyžaduje pred inštaláciou rôzne závislosti. Oficiálna stránka CouchDB uvádza zoznam týchto závislostí a ich presné číslo verzie, ktorá sa má nainštalovať:
Erlang OTP (19.x, 20.x> = 21.3.8.5, 21.x> = 21.2.3, 22.x> = 22.0.5)ICU
OpenSSL
Mozilla SpiderMonkey (1.8.5)
GNU Make
Zbierka prekladačov GNU
libcurl
help2man
Python (> = 2.7) pre doc
Python Sphinx (> = 1.1.3)
Tieto závislosti je možné nainštalovať z oficiálneho úložiska Fedory 30. Nainštalujme si ich:
Nainštalujte vyššie uvedené závislosti z nasledujúceho príkazu nižšie:
$ 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 postrojov libicu-devel libtool perl-Test-Harness
Po nainštalovaní týchto závislostí môžeme pokračovať v procese inštalácie Apache CouchDB, ako je uvedené nižšie:
Krok 1. Stiahnite si súbor tarball pre Apache CouchDB pomocou príkazu 'wget':
$ wget https: // zrkadlá.estointernet.v / apache / couchdb / zdroj / 3.1.1 / apache-couchdb-3.1.1.decht.gz
Krok 2. Extrahujte stiahnutý súbor tarball zadaným príkazom:
$ tar -xf apache-couchdb-3.1.1.decht.gzKrok 3. Presuňte extrahovaný priečinok do priečinka / opt a zmeňte tam adresár:
$ sudo mv apache-couchdb-3.1.1 / zvoliť /$ cd / opt / apache-couchdb-3.1.1 /
Krok 4. Ak chcete nakonfigurovať balík pre svoj systém, použite konfiguračný skript, ako je uvedené nižšie:
$ ./ konfigurovať
Ak chcete vidieť možnosti dostupné v konfiguračnom skripte, použite príkaz:
$ ./ configure - pomocAk sa vám na konci skriptu zobrazí správa:
Nakonfigurovali ste si Apache CouchDB, čas na odpočinok.
Znamená to, že ste správne nakonfigurovali balík.
Krok 5. Teraz vytvoríme zdrojový kód spustením príkazu nižšie:
$ uvoľnenieAlebo použiť gmake ak urobiť nefunguje.
V prípade, že sa zobrazí chyba uvedená nižšie:
CHYBA: Podpora Reltool vyžaduje nainštalovanie aplikácie reltool!CHYBA: generovanie zlyhalo počas spracovania
Znamená to, že si musíte nainštalovať erlang-reltool balíček na zostavenie CouchDB. Použite na to nasledujúci príkaz:
$ sudo dnf nainštalovať erlang-reltool
Teraz znova spustite príkaz „make release“ pomocou nižšie uvedeného príkazu:
$ uvoľnenieAk sa vyššie uvedený príkaz úspešne dokončí, mala by sa zobraziť správa uvedená nižšie:
"… hotový
Teraz môžete skopírovať adresár rel / couchdb kdekoľvek vo vašom systéme.
Začnite CouchDB s ./ bin / couchdb z tohto adresára.“
Krok 6. Registruje sa užívateľ CouchDB
CouchDB navrhuje vytvorenie samostatného používateľa (couchdb) pre prevádzkovanie svojich služieb. Je to z bezpečnostných dôvodov. Vytvorte používateľa pomocou nižšie uvedeného príkazu:
$ sudo adduser --system -m --shell / bin / bash --comment "CouchDB Administrator" couchdb
Vyššie uvedený príkaz vytvorí používateľa s menom „couchdb“ spolu s domovským adresárom a bash shell.
Krok 7. Teraz pomocou príkazu cp skopírujte adresár “rel / couchdb ” do domovského adresára couchdb (/ home / couchdb):
$ sudo cp -R / opt / apache-couchdb-3.1.1 / rel / couchdb / home / couchdbPoznámka: Použite cestu „rel / couchdb“ vo vzťahu k vašej ceste extrakcie pre couchdb.
Krok 8. Teraz musíme zmeniť vlastníctvo adresárov CouchDB pomocou nižšie uvedeného príkazu:
$ sudo chown -R couchdb: couchdb / home / couchdb / couchdbKrok 9. Podobne zmeňte povolenie adresárov CouchDB pomocou príkazu uvedeného nižšie:
$ find / home / couchdb / couchdb -typ d -exec chmod 0770 \;
Krok 10. Úprava povolení pre súbory INI, otvorte nové okno terminálu a spustite nasledujúce príkazy:
$ sudo -i# chmod 0644 / home / couchdb / couchdb / etc / *
Krok 11. Pred spustením couchdb si vytvorte administrátora (vyžaduje sa v CouchDB verzie 3). Za týmto účelom otvorte súbor lokálne.súbor ini v adresári „/ home / couchdb / couchdb / etc / local.ini “.
# vi / home / couchdb / couchdb / etc / local.iniTeraz choďte do administrátorskej časti a odkomentujte administrátorský riadok, potom vložte svoje heslo nasledujúcim spôsobom:
admin = Vaše hesloNamiesto vášho hesla zadajte heslo, ktoré chcete použiť. Môžete pridať ľubovoľného správcovského používateľa vo formáte „používateľské meno = heslo“. Pozri referenčný obrázok nižšie:
Teraz sa vráťte na normálny používateľský terminál zadaním príkazu exit:
# východ
Krok 12. Server CouchDB spustíme nasledujúcim príkazom:
$ sudo -i -u couchdb / home / couchdb / couchdb / bin / couchdbVyššie uvedený príkaz spustí CouchDB ako používateľa couchdb, ako je to znázornené na nasledujúcom obrázku:
Krok 13. Otvorte webový prehliadač a prejdite na nižšie uvedenú adresu, aby ste sa dostali do panela správcu:
http: // 127.0.0.1: 5984 / _utils / index.html
Inštaláciu overíte na adrese:
http: // localhost: 5984 / _utils / verify_install.html
CouchDB je možné nakonfigurovať ako jeden uzol alebo zoskupený. Pozrime sa na nastavenie pre jeden uzol:
Krok 1. Prejdite na adresu http: // 127.0.0.1: 5984 / _utils # nastavenie
Krok 2. Prihláste sa pomocou účtu správcu
Krok 3. Pri prvom nastavení kliknite na ikonu nastavenia a vyberte možnosť „Konfigurovať jeden uzol“.
Krok 4. Vytvorte nového správcu pre toto nastavenie. Môžeme tiež pokračovať s predchádzajúcim používateľom typu „admin“. V našom prípade sme vytvorili nového používateľa: admin2 a heslo: 123. Teraz kliknite na tlačidlo konfigurovať uzol:
Krok 5. Po kliknutí na ikonu databázy sa vám zobrazia dve systémové databázy:
Poznámka: Po vytvorení účtu správcu couchdb vždy reštartujte
Krok 6. Po reštartovaní couchdb vytvorte novú databázu v účte admin2 nasledovne:
Mala by sa zobraziť správa „databáza bola úspešne vytvorená“, ako je to znázornené na obrázku nižšie:
Záver:
V tejto príručke sa naučíme, ako nainštalovať CouchDB pomocou zdrojového kódu na pracovnú stanicu Fedora 30. Podarilo sa nám nakonfigurovať rôzne aspekty procesu inštalácie a vyriešiť niektoré chyby. Naučili sme sa tiež nastavovať konfiguráciu jedného uzla z grafického používateľského rozhrania. Ďalej môžete urobiť:
- Ručná konfigurácia CouchDB pre jeden uzol; a
- Vytvorte zoskupené nastavenie pre CouchDB