Konfigurační nástroj OmniDB

Poznámka: samostatný nástroj příkazové řádky omnidb-config/ omnidb-config-app/omnidb-config-server popsaný na této stránce patřil k předchozí sestavě založené na Pythonu/Django a není součástí aktuálního vydání. Jediný binární soubor omnidb-server přijímá jen několik přepínačů příkazové řádky: -A/--app (režim desktopové aplikace), -H/--host (adresa, na které server naslouchá), -p/--port (port, na kterém naslouchá), -d/--homedir (výběr domovského adresáře) a --set-password (nastavení hesla uživatele, viz níže) — všechny jsou popsány v části Přepínače příkazové řádky kapitoly Nasazení omnidb-server. Žádný konfigurační soubor neexistuje. Údržbové úkony, které starý nástroj nabízel, lze i nadále provést ručně, jak je popsáno níže.

Domovský adresář

OmniDB ukládá úplně vše — databázi omnidb.db (uživatelé, připojení a další data aplikace) a složku temp pro exportované soubory — do jediného domovského adresáře. Ve výchozím nastavení je jím ~/.omnidb/omnidb-app (desktopový režim) nebo ~/.omnidb/omnidb-server (serverový režim); pomocí přepínače -d /nejaka/cesta můžete zvolit jiný (adresář už musí existovat). Pokud operační systém nenabízí žádné úložiště tajných údajů pro šifrovací klíč uložených hesel, obsahuje stejný adresář i tento klíč, v souboru .connection_secret_key — viz Zabezpečení a víceuživatelský server. Když omnidb.db zálohujete nebo přesouváte, vezměte tento soubor s sebou.

Vytvoření uživatele

V současnosti neexistuje možnost příkazové řádky pro vytvoření uživatele bez otevření OmniDB. Při prvním spuštění proti prázdnému domovskému adresáři OmniDB automaticky vytvoří výchozího superuživatele admin — v serverovém režimu s náhodným heslem, které se jednou vypíše do logu serveru (řádek obsahující initial login: admin / …). Přihlaste se s ním a další uživatele vytvořte v Nastavení > Účet > Spravovat uživatele, případně změňte heslo v Nastavení > Heslo.

Nastavení nebo obnovení hesla

Pokud se jednorázové počáteční heslo uživatele admin ztratilo (nebo chcete ještě před prvním přihlášením nastavit vlastní), můžete heslo kteréhokoli existujícího uživatele nastavit přímo v databázi aplikace, aniž byste spouštěli server:

user@machine:~$ omnidb-server --set-password admin
user@machine:~$ omnidb-server --set-password admin -d /path/to/homedir

Bez přepínače -d se použije výchozí domovský adresář serveru (~/.omnidb/omnidb-server). V terminálu se nové heslo zadává dvakrát a nezobrazuje se; jinak se načte z prvního řádku standardního vstupu, což se hodí ve skriptech:

user@machine:~$ printf '%s\n' "$PW" | omnidb-server --set-password admin

Heslo se nikdy nepředává jako argument příkazové řádky, takže se neobjeví ve výpisu ps ani v historii shellu. Musí mít alespoň 8 znaků a uživatel už musí existovat. Spolu s -A je přepínač odmítnut — desktopová aplikace se přihlašuje automaticky a žádné heslo ke správě nemá. Příkaz lze spustit i za běhu serveru: nové heslo platí okamžitě pro nová přihlášení, uživatelé, kteří už jsou přihlášení, zůstanou přihlášení, dokud jim nevyprší relace nebo se server nerestartuje.

Vacuum (vyčištění)

OmniDB má jedinou databázi SQLite, omnidb.db, ve které ukládá všechny uživatele, připojení a další data související s OmniDB. Protože jde o obyčejný soubor SQLite, můžete jej vyčistit (vacuum) libovolným klientem SQLite, když OmniDB neběží, například takto:

user@machine:~$ sqlite3 ~/.omnidb/omnidb-app/omnidb.db 'VACUUM;'

Reset databáze

Pokud chcete vymazat všechny informace OmniDB a získat čistou databázi, jako byla hned po instalaci, ukončete OmniDB a smažte (nebo přesuňte jinam) soubor omnidb.db z domovského adresáře. Nový, prázdný soubor — s čerstvým výchozím uživatelem admin (v serverovém režimu s nově vygenerovaným jednorázovým heslem vypsaným do logu) — se automaticky vytvoří při příštím spuštění OmniDB. Postupujte s rozvahou: tento krok nelze vrátit zpět.

Mazání dočasných souborů

Exportované výsledky dotazů (CSV/XLSX apod.) se zapisují do složky temp uvnitř domovského adresáře. Její obsah je bezpečné kdykoli ručně smazat, pokud OmniDB neběží; OmniDB ji podle potřeby znovu vytvoří.