CouchDB, vyvinutý softwarovou nadací Apache, je systém správy databáze, který ukládá data v dokumentech JSON. K našim datům můžeme přistupovat pomocí protokolu HTTP. Podobně můžeme manipulovat s daty pomocí JavaScriptu. CouchDB databáze má RESTful HTTP API pro správu databázových dokumentů
Co pokryjeme?
V této příručce se budeme zabývat tím, jak můžeme nainstalovat nejnovější verzi Apache CouchDB na pracovní stanici Fedora 30. Pro tuto příručku také použijeme zdrojový kód z oficiálního webu. Než začneme, ujistěte se, že jsou splněny následující požadavky.
Předpoklady:
- Uživatelský účet s oprávněními „sudo“
- Připojení k internetu ke stažení různých souborů
- Základní znalost spouštění příkazů v systému Linux
Instalace Apache CouchDB:
Apache CouchDB vyžaduje před instalací různé závislosti. Oficiální stránka CouchDB uvádí tyto závislosti a jejich přesné číslo verze, která se má nainstalovat:
Erlang OTP (19.x, 20.x> = 21.3.8.5, 21.x> = 21.2.3, 22.x> = 22.0.5)JIP
OpenSSL
Mozilla SpiderMonkey (1.8.5)
GNU Make
Sbírka překladačů GNU
libcurl
help2man
Python (> = 2.7) pro dokumenty
Python Sphinx (> = 1.1.3)
Tyto závislosti lze nainstalovat z oficiálního úložiště Fedory 30. Nainstalujeme si je:
Nainstalujte výše uvedené závislosti z následujícího příkazu níže:
$ 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
Jakmile jsou tyto závislosti nainstalovány, můžeme pokračovat v procesu instalace Apache CouchDB, jak je znázorněno níže:
Krok 1. Stáhněte si soubor tarball pro Apache CouchDB pomocí příkazu 'wget':
$ wget https: // zrcadla.estointernet.v / apache / couchdb / source / 3.1.1 / apache-couchdb-3.1.1.dehet.gz
Krok 2. Extrahujte stažený soubor tarball zadaným příkazem:
$ tar -xf apache-couchdb-3.1.1.dehet.gzKrok 3. Přesuňte extrahovanou složku do složky / opt a změňte tam adresář:
$ sudo mv apache-couchdb-3.1.1 / zvolit /$ cd / opt / apache-couchdb-3.1.1 /
Krok 4. Chcete-li nakonfigurovat balíček pro váš systém, použijte konfigurační skript, jak je znázorněno níže:
$ ./ konfigurovat
Pokud chcete vidět možnosti dostupné ve skriptu konfigurace, použijte příkaz:
$ ./ configure --helpPokud se na konci skriptu zobrazí zpráva:
Nakonfigurovali jste Apache CouchDB, čas na odpočinek.
To znamená, že jste balíček správně nakonfigurovali.
Krok 5. Nyní vytvoříme zdrojový kód spuštěním následujícího příkazu:
$ uvolněníNebo použijte gmake -li udělat nefunguje.
V případě, že se zobrazí níže uvedená chyba:
CHYBA: Podpora Reltool vyžaduje instalaci aplikace reltool!CHYBA: generování se nezdařilo při zpracování
IT znamená, že musíte nainstalovat erlang-reltool balíček pro sestavení CouchDB. K tomu použijte následující příkaz:
$ sudo dnf install erlang-reltool
Nyní znovu spusťte příkaz „make release“ pomocí níže uvedeného příkazu:
$ uvolněníPokud se výše uvedený příkaz úspěšně dokončí, měla by se zobrazit zpráva uvedená níže:
"… Hotovo
Nyní můžete zkopírovat adresář rel / couchdb kdekoli ve vašem systému.
Začněte CouchDB s ./ bin / couchdb z daného adresáře.“
Krok 6. Registrace uživatele CouchDB
CouchDB navrhuje vytvoření samostatného uživatele (couchdb) pro provozování jeho služeb. Je to z bezpečnostních důvodů. Vytvořte uživatele pomocí níže uvedeného příkazu:
$ sudo adduser --system -m --shell / bin / bash --comment "CouchDB Administrator" couchdb
Výše uvedený příkaz vytvoří uživatele s názvem „couchdb“ společně s domovským adresářem a bash shellem.
Krok 7. Nyní použijte příkaz cp ke zkopírování adresáře “rel / couchdb ” do domovského adresáře couchdb (/ home / couchdb):
$ sudo cp -R / opt / apache-couchdb-3.1.1 / rel / couchdb / home / couchdbPoznámka: Použijte cestu „rel / couchdb“ vzhledem k vaší cestě extrakce pro couchdb.
Krok 8. Nyní musíme změnit vlastnictví adresářů CouchDB pomocí níže uvedeného příkazu:
$ sudo chown -R couchdb: couchdb / home / couchdb / couchdbKrok 9. Podobně změňte oprávnění adresářů CouchDB pomocí níže uvedeného příkazu:
$ find / home / couchdb / couchdb -typ d -exec chmod 0770 \;
Krok 10. Chcete-li upravit oprávnění pro soubory INI, otevřete nové okno terminálu a spusťte níže uvedené příkazy:
$ sudo -i# chmod 0644 / home / couchdb / couchdb / etc / *
Krok 11. Před spuštěním couchdb vytvořte uživatele správce (vyžadováno v CouchDB verze 3). Za tímto účelem otevřete soubor místní.soubor ini v adresáři „/ home / couchdb / couchdb / etc / local.ini “.
# vi / home / couchdb / couchdb / etc / local.iniNyní přejděte do administrátorské sekce a odkomentujte administrátorskou linku, pak vložte své heslo následujícím způsobem:
admin = Vaše hesloMísto YourPassword zadejte heslo, které chcete použít. Můžete přidat libovolného uživatele správce ve formátu „uživatelské jméno = heslo“. Viz referenční obrázek níže:
Nyní se vraťte do normálního uživatelského terminálu zadáním exit:
# výstup
Krok 12. Server CouchDB spustíme příkazem uvedeným níže:
$ sudo -i -u couchdb / home / couchdb / couchdb / bin / couchdbVýše uvedený příkaz spustí CouchDB jako uživatele couchdb, jak je znázorněno na následujícím obrázku:
Krok 13. Otevřete webový prohlížeč a procházením níže uvedené adresy přejděte do administrátorského panelu:
http: // 127.0.0.1: 5984 / _utils / index.html
Chcete-li ověřit instalaci, přejděte na:
http: // localhost: 5984 / _utils / verify_install.html
CouchDB lze konfigurovat jako jeden uzel nebo seskupený. Podívejme se na nastavení pro jeden uzel:
Krok 1. Přejděte na http: // 127.0.0.1: 5984 / _utils # nastavení
Krok 2. Přihlaste se pomocí účtu správce
Krok 3. Při prvním nastavení klikněte na ikonu nastavení a vyberte možnost „Konfigurovat jeden uzel“.
Krok 4. Vytvořit nového uživatele správce pro toto nastavení. Můžeme také pokračovat s předchozím uživatelem „admin“. V našem případě jsme vytvořili nového uživatele: admin2 a heslo: 123. Nyní klikněte na tlačítko konfigurovat uzel:
Krok 5. Když kliknete na ikonu databáze, zobrazí se vám dvě systémové databáze:
Poznámka: Po vytvoření účtu správce vždy restartujte couchdb
Krok 6. Po restartování couchdb vytvořte novou databázi v účtu admin2 následujícím způsobem:
Měla by se zobrazit zpráva „databáze byla úspěšně vytvořena“, jak je znázorněno na obrázku níže:
Závěr:
V této příručce se naučíme, jak nainstalovat CouchDB pomocí zdrojového kódu na pracovní stanici Fedora 30. Podařilo se nám nakonfigurovat různé aspekty instalačního procesu a vyřešit některé chyby. Naučili jsme se také nastavit konfiguraci jednoho uzlu z grafického uživatelského rozhraní. Dále můžete:
- Ruční konfigurace CouchDB pro jeden uzel; a
- Vytvořte seskupené nastavení pro CouchDB