.NET

Installazione

OmniDB offre 2 tipi di pacchetti per soddisfare le esigenze di ogni utente:

Sia l’applicazione che il server possono essere installati sulla stessa macchina.

OmniDB Application

Importante: Il repository originale https://github.com/OmniDB/OmniDB/releases contiene solo versioni vecchie (fino al ~2020) e non è più mantenuto — vedi Funzionalità legacy e cronologia per cosa è cambiato da allora.

Per le versioni attuali usa la pagina delle release del progetto. Dalla riscrittura in Go,ogni release è un singolo archivio auto-contenuto per piattaforma (più un installer facoltativo per Windows) — nessun runtime separato da installare prima:

Decomprimi l’archivio per la tua piattaforma ed esegui l’app/binario OmniDB — questa è l’intera installazione.

Installazione tramite Homebrew (solo macOS – consigliato)

Per gli utenti macOS che preferiscono un gestore di pacchetti, OmniDB è disponibile tramite un tap Homebrew personalizzato:

# Installa l'ultima versione:
brew install --cask heptau/tap/omnidb
# Per aggiornare in seguito:
brew upgrade heptau/tap/omnidb

Homebrew scaricherà automaticamente lo ZIP corretto per la tua architettura (Apple Silicon o Intel), lo decomprimerà e posizionerà OmniDB.app nella cartella Applicazioni.

La definizione del cask è mantenuta qui: heptau/homebrew-tap – omnidb.rb

Installazione tramite winget (solo Windows)

Per gli utenti Windows che preferiscono un gestore di pacchetti, OmniDB è disponibile tramite il Windows Package Manager, incluso in Windows 10 e 11:

# Installa l'ultima versione:
winget install heptau.OmniDB
# Per aggiornare in seguito:
winget upgrade heptau.OmniDB

Il manifest è gestito qui: microsoft/winget-pkgs.

Download diretto (tutte le piattaforme)

Questi link puntano sempre all'ultima versione. Per le versioni precedenti, i checksum e le note di rilascio, consulta la pagina delle release.

Decomprimi l’archivio per la tua piattaforma e avvia l’app nel modo normale: su macOS, trascina OmniDB.app in Applicazioni e aprilo da Launchpad/Spotlight o con open -a OmniDB; su Linux, esegui il binario OmniDB direttamente; su Windows, esegui OmniDB.exe (o l’installer).

Vedi App desktop per sapere dove l’app conserva i propri dati, la barra dei menu e le scorciatoie da tastiera, e le particolarità di macOS come l’importazione dei dati da un’installazione precedente.

OmniDB Server

Lo stesso archivio della release contiene anche omnidb-server — un binario headless separato insieme all’app desktop (l’app desktop in realtà avvia internamente questo stesso binario come processo figlio, forzando la modalità app). Eseguito direttamente per la modalità server accessibile dal browser, senza shell desktop:

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

Di default OmniDB ascolta solo su 127.0.0.1 e sceglie una porta libera automaticamente. Puoi specificare entrambi esplicitamente:

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

Vedi Distribuzione di omnidb-server per l’insieme completo di opzioni e le configurazioni di deployment consigliate (in particolare, perché esporre -H 0.0.0.0 direttamente su internet senza un reverse proxy è sconsigliato — non c’è supporto TLS integrato).

OmniDB con Oracle

Né l’app OmniDB né il server richiedono software aggiuntivo per connettersi a Oracle — a differenza delle versioni precedenti, non è necessaria l’installazione separata di Oracle Instant Client. La connettività Oracle è implementata nativamente (un driver Go puro), quindi funziona allo stesso modo, immediatamente, come ogni altro database supportato. Lo stesso vale per MS SQL Server e Firebird: anche questi usano driver Go puri, quindi non è necessario alcun driver ODBC, libreria client nativa o altro passaggio di installazione aggiuntivo per nessuno dei due.

Database Utente OmniDB

Al primo avvio, sia il server che l’app creano un file ~/.omnidb/omnidb-app/omnidb.db (per OmniDB app) o ~/.omnidb/omnidb-server/omnidb.db (per OmniDB server) nella home directory dell’utente, se non esiste già — insieme a un account superutente admin. L’app desktop accede automaticamente con questo utente; in modalità server la sua password viene generata casualmente e stampata una sola volta nell’output di log del server (la riga che contiene initial login: admin / …). Questo file è anche chiamato database utente e contiene tutti gli utenti, le connessioni e altri dati dell’applicazione. Se esiste già (ad esempio dopo un aggiornamento), OmniDB lo utilizza così com’è — non viene mai sovrascritto o resettato automaticamente.

OmniDB nel browser

Una volta avviato omnidb-server, apri nel tuo browser preferito l’indirizzo che ha stampato all’avvio (ad esempio http://127.0.0.1:52149/omnidb_login/). Vedrai la pagina di accesso di OmniDB; accedi come admin con la password monouso riportata nel log. Nei prossimi capitoli vedremo come creare utenti e connessioni e come lavorare con OmniDB. L’app desktop salta completamente questo passaggio — apre direttamente lo spazio di lavoro.