.NET

Instalação

O OmniDB disponibiliza 2 tipos de pacotes para se adaptar às necessidades de cada utilizador:

Tanto a aplicação como o servidor podem ser instalados na mesma máquina.

OmniDB Application

Importante: O repositório original https://github.com/OmniDB/OmniDB/releases contém apenas versões antigas (até cerca de 2020) e já não é mantido — consulte Funcionalidades Legadas e Histórico para saber o que mudou desde então.

Para as versões atuais, use a página de releases do projeto. Desde a reescrita em Go, cada release é um único arquivo autocontido por plataforma (mais um instalador opcional para Windows) — sem runtime separado a instalar primeiro:

Descompacte o arquivo (zip ou tar) para a sua plataforma e execute a aplicação/binário OmniDB lá dentro — é toda a instalação.

Instalação via Homebrew (apenas macOS – recomendado)

Para utilizadores de macOS que preferem usar um gestor de pacotes, o OmniDB está disponível através de um tap Homebrew personalizado:

# Instalar a versão mais recente:
brew install --cask heptau/tap/omnidb
# Para atualizar mais tarde:
brew upgrade heptau/tap/omnidb

O Homebrew irá transferir automaticamente o ZIP correto para a sua arquitetura (Apple Silicon ou Intel), descompactá-lo e colocar OmniDB.app na sua pasta Applications.

A definição do cask é mantida aqui: heptau/homebrew-tap – omnidb.rb

Instalação via winget (apenas Windows)

Para utilizadores de Windows que preferem usar um gestor de pacotes, o OmniDB está disponível através do Windows Package Manager, incluído no Windows 10 e 11:

# Instalar a versão mais recente:
winget install heptau.OmniDB
# Para atualizar mais tarde:
winget upgrade heptau.OmniDB

O manifesto é mantido aqui: microsoft/winget-pkgs.

Transferência direta (todas as plataformas)

Estes links apontam sempre para a versão mais recente. Para versões anteriores, somas de verificação e notas de lançamento, consulte a página de releases.

Descompacte o arquivo para a sua plataforma e abra a aplicação da forma habitual: no macOS, arraste OmniDB.app para Applications e abra-o a partir do Launchpad/Spotlight ou com open -a OmniDB; no Linux, execute o binário OmniDB diretamente; no Windows, execute OmniDB.exe (ou o instalador).

Consulte Aplicação de Ambiente de Trabalho para saber onde a aplicação guarda os seus dados, a sua barra de menus e atalhos de teclado, e particularidades do macOS, como a importação de dados de uma instalação anterior.

OmniDB Server

O mesmo arquivo de release também contém o omnidb-server — um binário separado, sem interface gráfica, ao lado da aplicação de ambiente de trabalho (a aplicação de ambiente de trabalho na verdade inicia este mesmo binário internamente, como processo filho, forçando o modo aplicação). Execute-o diretamente para o modo servidor acessível pelo browser, sem qualquer camada de ambiente de trabalho envolvida:

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

Por predefinição, o OmniDB escuta apenas em 127.0.0.1 e escolhe automaticamente uma porta livre. Pode especificar ambos explicitamente:

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

Consulte Implementar o omnidb-server para o conjunto completo de opções e configurações de implementação recomendadas (em particular, por que razão expor -H 0.0.0.0 diretamente à internet sem um proxy inverso à frente é desaconselhado — não existe suporte de TLS incorporado).

OmniDB com Oracle

Nem a aplicação nem o servidor OmniDB requerem qualquer software adicional para se ligar ao Oracle — ao contrário de versões anteriores, não é necessária qualquer instalação separada do Oracle Instant Client. A conectividade Oracle está implementada nativamente (um driver Go puro), pelo que funciona da mesma forma imediatamente, tal como qualquer outra base de dados suportada. O mesmo se aplica ao MS SQL Server e ao Firebird: ambos também usam drivers Go puros, pelo que não é necessário qualquer driver ODBC, biblioteca de cliente nativa ou outro passo de instalação adicional para nenhum dos dois.

Base de Dados de Utilizador do OmniDB

Na primeira execução, tanto o servidor como a aplicação criam um ficheiro ~/.omnidb/omnidb-app/omnidb.db (para a aplicação OmniDB) ou ~/.omnidb/omnidb-server/omnidb.db (para o servidor OmniDB) na pasta pessoal do utilizador, caso ainda não exista — juntamente com uma conta de superutilizador admin. A aplicação de ambiente de trabalho inicia sessão com ela automaticamente; no modo servidor, a sua palavra-passe é gerada aleatoriamente e mostrada uma única vez na saída de registo do servidor (a linha que contém initial login: admin / …). Este ficheiro também é chamado a base de dados de utilizador e contém todos os utilizadores, ligações e outros dados da aplicação. Se já existir (por exemplo, após uma atualização), o OmniDB usa-o tal como está — nunca é substituído ou reposto automaticamente.

O OmniDB no browser

Assim que o omnidb-server estiver em execução, abra no seu browser preferido o endereço que ele mostrou ao arrancar (por exemplo http://127.0.0.1:52149/omnidb_login/). Verá a página de início de sessão do OmniDB; inicie sessão como admin com a palavra-passe de utilização única do registo. Nos próximos capítulos, veremos como criar utilizadores e ligações e como trabalhar com o OmniDB. A aplicação de ambiente de trabalho salta este passo por completo — abre o espaço de trabalho diretamente.