.NET

Instalace

OmniDB nabízí 2 druhy balíčků, aby vyhověla potřebám každého uživatele:

Aplikaci i server lze nainstalovat na stejný počítač.

Aplikace OmniDB

Důležité: Původní repozitář https://github.com/OmniDB/OmniDB/releases obsahuje pouze staré verze (přibližně do roku 2020) a už se dále neudržuje — co se od té doby změnilo, najdete v části Starší funkce a historie.

Pro aktuální verze použijte stránku s vydáními projektu. Od přepsání do Go je každé vydání jediným samostatným archivem pro danou platformu (pro Windows navíc volitelně s instalátorem) — bez nutnosti nejprve instalovat samostatný runtime:

Rozbalte archiv pro vaši platformu a spusťte aplikaci/binárku OmniDB uvnitř — to je celá instalace.

Instalace přes Homebrew (pouze macOS – doporučeno)

Pro uživatele macOS, kteří dávají přednost správci balíčků, je OmniDB k dispozici přes vlastní Homebrew tap:

# Instalace nejnovější verze:
brew install --cask heptau/tap/omnidb
# Pozdější aktualizace:
brew upgrade heptau/tap/omnidb

Homebrew automaticky stáhne správný ZIP pro vaši architekturu (Apple Silicon nebo Intel), rozbalí ho a umístí OmniDB.app do vaší složky Aplikace.

Definice casku je udržována zde: heptau/homebrew-tap – omnidb.rb

Instalace přes winget (pouze Windows)

Pro uživatele Windows, kteří dávají přednost správci balíčků, je OmniDB k dispozici přes Windows Package Manager, součást Windows 10 a 11:

# Instalace nejnovější verze:
winget install heptau.OmniDB
# Pozdější aktualizace:
winget upgrade heptau.OmniDB

Manifest je spravovaný zde: microsoft/winget-pkgs.

Přímé stažení (všechny platformy)

Tyto odkazy vždy vedou na nejnovější vydání. Starší verze, kontrolní součty a poznámky k vydání najdete na stránce se všemi vydáními.

Rozbalte archiv pro vaši platformu a spusťte aplikaci obvyklým způsobem: na macOS přetáhněte OmniDB.app do složky Aplikace a otevřete ji z Launchpadu/Spotlightu nebo příkazem open -a OmniDB; na Linuxu spusťte binárku OmniDB přímo; na Windows spusťte OmniDB.exe (nebo instalátor).

Kde aplikace uchovává svá data, její panel nabídek a klávesové zkratky a specifika macOS, jako je import dat z dřívější instalace, popisuje kapitola Desktopová aplikace.

Server OmniDB

Stejný archiv s vydáním obsahuje také omnidb-server — samostatnou binárku bez grafického rozhraní vedle desktopové aplikace (desktopová aplikace ve skutečnosti tuto stejnou binárku interně spouští jako podřízený proces a vynucuje režim aplikace). Spusťte ji přímo pro serverový režim dostupný z prohlížeče, bez jakéhokoli desktopového obalu:

user@machine:~$ ./omnidb-server
omnidb-server: listening on 127.0.0.1:52149 — open http://127.0.0.1:52149/omnidb_login/ in your browser

OmniDB standardně naslouchá pouze na 127.0.0.1 a automaticky si vybere volný port. Obojí můžete zadat explicitně:

user@machine:~$ ./omnidb-server -p 8080 -H 0.0.0.0
omnidb-server: listening on 0.0.0.0:8080 — open http://0.0.0.0:8080/omnidb_login/ in your browser

Kompletní přehled možností a doporučená nasazení najdete v části Nasazení omnidb-server (mimo jiné proč se nedoporučuje vystavovat -H 0.0.0.0 přímo internetu bez reverzní proxy před ním — chybí zabudovaná podpora TLS).

OmniDB s Oracle

Ani aplikace, ani server OmniDB nevyžadují k připojení k Oracle žádný další software — na rozdíl od předchozích vydání není potřeba samostatná instalace Oracle Instant Client. Konektivita k Oracle je implementována nativně (čistě v Go), takže funguje po vybalení stejným způsobem jako u každé jiné podporované databáze. Totéž platí pro MS SQL Server a Firebird: oba rovněž používají čisté ovladače v Go, takže ani u jednoho z nich není potřeba žádný ODBC ovladač, nativní klientská knihovna ani jiný instalační krok navíc.

Uživatelská databáze OmniDB

Při prvním spuštění server i aplikace vytvoří soubor ~/.omnidb/omnidb-app/omnidb.db (pro aplikaci OmniDB) nebo ~/.omnidb/omnidb-server/omnidb.db (pro server OmniDB) v domovském adresáři uživatele, pokud ještě neexistuje — spolu se superuživatelským účtem admin. Desktopová aplikace se pod ním přihlašuje automaticky; v serverovém režimu se jeho heslo náhodně vygeneruje a jednou vypíše do logu serveru (řádek obsahující initial login: admin / …). Tento soubor se také nazývá uživatelská databáze a obsahuje všechny uživatele, připojení a další data aplikace. Pokud už existuje (např. po aktualizaci), OmniDB ho použije tak, jak je — nikdy ho automaticky nepřepíše ani neresetuje.

OmniDB v prohlížeči

Jakmile omnidb-server běží, otevřete ve svém oblíbeném prohlížeči adresu, kterou vypsal při spuštění (například http://127.0.0.1:52149/omnidb_login/). Zobrazí se přihlašovací stránka OmniDB; přihlaste se jako admin jednorázovým heslem z logu. V dalších kapitolách se podíváme na to, jak vytvářet uživatele a připojení a jak s OmniDB pracovat. Desktopová aplikace tento krok úplně vynechává — otevře rovnou pracovní prostředí.