Guia de Instalação no macOS para o digna Release 2026.06¶

Release: 2026.06

Última Atualização: 5 de setembro de 2026

Sumário¶

1. Introdução
2. Requisitos do Sistema
3. Pré-instalação
4. Configuração do Servidor PostgreSQL
5. Configuração do Servidor Web
6. Instalação Inicial
7. Configuração do Backend
8. Configuração do Dashboard
9. Executando o digna como um Serviço em Segundo Plano
10. Atualizando para uma Nova Release

Introdução¶

Sobre o digna¶

digna é uma plataforma abrangente guiada por IA, projetada para otimizar o gerenciamento da qualidade de dados em diversos ambientes de dados, como data warehouses, data lakes e lakehouses. Desenvolvida para ser altamente escalável e adaptável, digna resolve desafios modernos de dados por meio de automação, monitoramento em tempo real e detecção de anomalias.

O digna consiste em dois componentes principais:

• digna: o núcleo da aplicação, responsável por processar os dados e executar as verificações de qualidade. Reúne o backend e a interface de linha de comando em um único executável, substituindo os programas separados dignabackend e dignacli das versões anteriores.
• dignadashboard: Uma interface web hospedada em um servidor web, que fornece uma forma amigável de interagir com a plataforma digna e visualizar métricas de qualidade de dados.

Novidades no Release 2026.06¶

Esta release traz capacidades de observabilidade de dados diretamente para o seu código, permitindo que desenvolvedores monitorem a qualidade dos dados na origem. Consulte as notas de versão para detalhes completos.

Procurando Windows ou Linux?¶

Este guia cobre o macOS. Para outras plataformas, veja o Windows Installation Guide ou o Linux Installation Guide.

Requisitos do Sistema¶

Antes de iniciar a instalação, verifique se seu sistema atende aos seguintes requisitos mínimos:

Opções de Instalação do Banco de Dados¶

Se o PostgreSQL já estiver instalado: Você pode adicionar um novo banco de dados para o digna ao seu servidor PostgreSQL existente.

Se for instalar o PostgreSQL na mesma máquina que o digna:

Verificando Sua Arquitetura¶

Vários caminhos neste guia diferem entre Macs Apple Silicon e Intel. Para verificar qual você possui, abra o Terminal e execute:

uname -m

• arm64 — Apple Silicon. O Homebrew instala em /opt/homebrew.
• x86_64 — Intel. O Homebrew instala em /usr/local.

Pré-instalação¶

Antes de instalar o digna, certifique-se de que três pré-requisitos principais estejam em vigor:

1. Homebrew – o gerenciador de pacotes utilizado para instalar os componentes abaixo
2. PostgreSQL Server – para armazenar métricas calculadas e dados de desempenho
3. Servidor Web – para hospedar o digna Dashboard

Se esses componentes ainda não estiverem configurados, siga as seções abaixo para instalá-los e configurá-los.

Instalando o Homebrew¶

O Homebrew é o gerenciador de pacotes padrão para macOS e é usado ao longo deste guia para instalar PostgreSQL e nginx.

Passo 1: Verificar se o Homebrew já está instalado¶

Abra o Terminal (pressione Cmd + Space, digite Terminal, pressione Enter) e execute:

brew --version

Se um número de versão for retornado, pule para a seção Configuração do Servidor PostgreSQL.

Passo 2: Instalar o Homebrew¶

Se o comando não for encontrado, instale o Homebrew seguindo as instruções no site oficial do Homebrew. O instalador também instala as Xcode Command Line Tools se elas não estiverem presentes.

Passo 3: Adicionar o Homebrew ao seu PATH¶

No Apple Silicon, o instalador imprime dois comandos para adicionar o Homebrew ao seu ambiente de shell. Execute-os conforme instruído e depois confirme:

brew --prefix

Isto deve imprimir /opt/homebrew no Apple Silicon ou /usr/local no Intel.

Configuração do Servidor PostgreSQL¶

Se Você Já Tem PostgreSQL¶

Se o PostgreSQL já estiver instalado e em execução na sua máquina local ou se você estiver usando um servidor PostgreSQL gerenciado remoto, você pode pular para a próxima seção.

Opções de Instalação¶

O macOS oferece duas maneiras simples de instalar o PostgreSQL. Escolha uma:

• Homebrew — instalação via linha de comando, recomendada para implantações de servidor
• Postgres.app — instalação gráfica, conveniente para avaliação local

Instalando PostgreSQL com Homebrew¶

Passo 1: Instalar a fórmula do PostgreSQL¶

brew install postgresql@16

Passo 2: Adicionar o PostgreSQL ao seu PATH¶

As fórmulas versionadas do PostgreSQL são keg-only, o que significa que o Homebrew não vincula seus comandos ao seu PATH automaticamente. Adicione-os você mesmo:

echo 'export PATH="'$(brew --prefix)'/opt/postgresql@16/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Passo 3: Iniciar o serviço PostgreSQL¶

brew services start postgresql@16

Isto inicia o PostgreSQL imediatamente e o configura para iniciar automaticamente quando você efetuar login.

Passo 4: Verificar a instalação¶

psql --version

Você deverá ver a versão do PostgreSQL se a instalação foi bem-sucedida.

Passo 5: Conectar-se ao servidor¶

psql postgres

Passo 6: Confirmar a porta¶

A porta padrão do PostgreSQL é 5432. Para confirmar a porta em que seu servidor está escutando:

psql postgres -c "SHOW port;"

Anote o valor — você precisará dele ao configurar o backend do digna.

Instalando PostgreSQL com Postgres.app¶

Se preferir uma instalação gráfica:

1. Baixe o Postgres.app e arraste-o para a sua pasta Applications
2. Abra o app e clique em Initialize para criar um novo servidor
3. Siga as instruções do app para adicionar suas ferramentas de linha de comando ao PATH
4. Verifique a instalação:

psql --version

O Postgres.app também cria um superusuário com o nome da sua conta macOS.

Configuração do Servidor Web¶

O digna requer um servidor web para hospedar o dashboard. Escolha uma das seguintes opções:

• nginx — instalado via Homebrew, recomendado
• Apache httpd — incluído no macOS

Você só precisa instalar e configurar um desses servidores.

Ambas as seções configuram duas coisas das quais o dashboard depende:

• Fallback para single-page application, para que atualizar a URL do dashboard no navegador não retorne 404
• Um tipo MIME para .md, para que arquivos Markdown sejam servidos corretamente

Configuração do nginx¶

Visão Geral¶

O nginx é um servidor web leve e de alto desempenho, adequado para servir o dashboard estático do digna.

Instalação¶

brew install nginx

Iniciando o nginx¶

brew services start nginx

Verificar a Instalação¶

1. Abra seu navegador
2. Navegue para http://localhost:8080
3. Você deverá ver a página de boas-vindas do nginx

Configurando um Site para o Dashboard¶

A configuração do nginx do Homebrew inclui todos os arquivos do diretório servers. Crie um arquivo de configuração dedicado para o digna lá:

nano $(brew --prefix)/etc/nginx/servers/digna.conf

Cole o seguinte, substituindo /path/to/digna/dashboard pelo caminho real da sua pasta dashboard extraída:

server {
    listen       8080;
    server_name  localhost;

    root   /path/to/digna/dashboard;
    index  index.html;

    # Serve Markdown files with the correct MIME type.
    types {
        text/markdown  md;
    }

    # Single-page-application fallback: unknown paths return index.html
    # instead of a 404, so dashboard routes survive a browser refresh.
    location / {
        try_files $uri $uri/ /index.html;
    }
}

Aplicar a Configuração¶

Teste a configuração para erros de sintaxe e então recarregue o nginx:

nginx -t
brew services restart nginx

Configuração do Apache httpd¶

Visão Geral¶

O macOS inclui o Apache httpd, portanto não é necessária instalação. Ele vem desativado por padrão.

Iniciando o Apache¶

sudo apachectl start

Verificar a Instalação¶

1. Abra seu navegador
2. Navegue para http://localhost
3. Você deverá ver a mensagem "It works!"

Obrigatório: Habilitar mod_rewrite¶

O dashboard requer reescrita de URL. Abra a configuração do Apache:

sudo nano /etc/apache2/httpd.conf

Encontre a seguinte linha e remova o # inicial para descomentá-la:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

Obrigatório: Permitir Overrides via .htaccess¶

No mesmo arquivo, localize o bloco <Directory "/Library/WebServer/Documents"> e altere:

AllowOverride None

para:

AllowOverride All

Obrigatório: Tipo MIME para Arquivos Markdown¶

Ainda em httpd.conf, adicione a linha a seguir para que arquivos Markdown sejam servidos corretamente:

AddType text/markdown .md

Aplicar a Configuração¶

Verifique a configuração por erros de sintaxe e então reinicie o Apache:

sudo apachectl configtest
sudo apachectl restart

Instalação Inicial¶

Passo 1: Configure o Repositório do digna¶

O repositório do digna armazena todas as métricas calculadas pelo digna. Ele atua como o banco de dados central para dados analíticos e de desempenho.

Criar Esquema e Usuário do Repositório¶

Abra seu cliente PostgreSQL (psql, pgAdmin ou similar) e execute os seguintes comandos SQL:

CREATE SCHEMA <digna_repo_schema>;

CREATE USER <digna_repo_user> WITH PASSWORD '<digna_repo_password>';

GRANT ALL PRIVILEGES ON SCHEMA <digna_repo_schema> TO <digna_repo_user>;

Substitua os seguintes placeholders:

• <digna_repo_schema> — O nome do schema desejado (por exemplo, dignarepo)
• <digna_repo_user> — O nome de usuário desejado (por exemplo, digna_user)
• <digna_repo_password> — Uma senha segura para este usuário

Exemplo:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

Para executar isso a partir do Terminal em um único passo:

psql postgres

Em seguida cole as instruções no prompt postgres=# e digite \q para sair.

Passo 2: Extraia o Pacote de Instalação do digna¶

1. Localize o arquivo ZIP de instalação do digna fornecido a você
2. Extraia-o para o local de instalação desejado — por exemplo /opt/digna ou ~/digna
3. Após a extração, você deverá ver os seguintes itens:
4. dashboard/ — Interface web do dashboard
5. digna — Executável principal (backend + CLI combinados)

Para extrair pelo Terminal:

unzip digna-2026.06-macos.zip -d /opt/digna

Tornar o Executável Executável¶

Dependendo de como o arquivo foi transferido, o bit de execução pode não sobreviver à extração. Defina-o explicitamente:

cd /opt/digna
chmod +x digna

Se o macOS Bloquear a Aplicação¶

Arquivos baixados via navegador ou cliente de e-mail são marcados com um atributo de quarentena. Se o macOS relatar que o app "cannot be opened because the developer cannot be verified", remova o atributo da pasta de instalação:

xattr -dr com.apple.quarantine /opt/digna

Alternativamente, abra System Settings → Privacy & Security, encontre o item bloqueado próximo ao final da página e clique em Open Anyway.

Passo 3: Instalar o Arquivo de Licença¶

1. Localize o arquivo license.toml fornecido a você
2. Copie-o para o diretório raiz de instalação do digna (onde estão config.toml e o executável digna)

Por que isso é importante: O arquivo de licença contém suas informações de cliente, data de expiração da licença e assinatura digital. Não modifique este arquivo — quaisquer alterações o invalidarão.

Estrutura de diretórios após a configuração:

/opt/digna/
├── config.toml         (arquivo de configuração)
├── license.toml        (SEU ARQUIVO DE LICENÇA - copie aqui)
├── digna               (executável principal)
├── bin/                (scripts de gerenciamento do serviço)
└── dashboard/          (interface web)
    └── (arquivos do dashboard)

Configuração do Backend¶

Passo 1: Criar e Editar o Arquivo de Configuração¶

O arquivo config_template.toml é fornecido no diretório de instalação do digna. Você só precisa renomeá-lo para config.toml.

cd /opt/digna
mv config_template.toml config.toml

Localização: /opt/digna/config.toml

Abra config.toml em um editor de texto e configure cada seção abaixo.

Seção [app]¶

Esta seção configura as definições da aplicação backend do digna:

[app]
digna_APP_CORS_ALLOW_ORIGINS = ["http://localhost:5173"]
digna_APP_CORS_ALLOW_CREDENTIALS = true
digna_APP_CORS_ALLOW_METHODS = ["*"]
digna_APP_CORS_ALLOW_HEADERS = ["*"]

Seção [repo]¶

Esta seção configura a conexão com o banco de dados PostgreSQL:

[repo]
digna_REPO_HOST = "localhost"
digna_REPO_PORT = 5432
digna_REPO_DB = "postgres"
digna_REPO_SCHEMA = "dignarepo"
digna_REPO_USER = "digna_user"
digna_REPO_PASSWORD = "YourSecurePassword123!"

Seção [base]¶

Esta seção contém configurações de segurança e cookies:

[base]
DIGNA_FERNET_KEY = "DU4a0yJ-OqvbKCL4hNQn_CsknH-V1vWmHZqBUl-AY44="
digna_COOKIE_DOMAIN = "localhost"
digna_COOKIE_PATH = "/"
digna_COOKIE_SECURE = false
digna_COOKIE_HTTPONLY = true
digna_COOKIE_SAME_SITE = "lax"
digna_TOKEN_EXPIRES_IN = 86400
digna_MAX_WORKERS = 4
DIGNA_SCHEDULER_MAX_DELAY = 100
DIGNA_CLEANUP_TIME = "12:00"

Seção [encryption]¶

Esta seção contém a chave usada para criptografar os valores sensíveis armazenados no repositório. Ela é obrigatória — config check informa a seção [encryption] como FAILED se a chave estiver ausente.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

Seção [logging]¶

Esta seção configura o comportamento de logging:

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10

Passo 2: Validar a Configuração¶

Antes de inicializar o repositório, verifique se o config.toml está completo e bem formado. No diretório de instalação do digna, execute:

digna config check

Cada seção é validada separadamente, de modo que um único erro não esconde o estado das demais:

Configuration validation report (source: config.toml):
 - App config: OK
 - Repository config: OK
 - Base config: OK
 - Logging config: OK
 - Encryption config: OK
 - OIDC config(s): OK

Overall: OK

Corrija tudo o que for informado como FAILED e execute o comando novamente antes de continuar. A lista completa de opções está na referência da CLI.

Passo 3: Inicializar o Repositório¶

1. Abra o Terminal
2. Navegue até o diretório de instalação do digna (onde config.toml e o executável digna estão localizados)
3. Execute o teste de conexão:

cd /opt/digna
./digna repo check

Você deverá ver uma confirmação de que a conexão foi estabelecida (o repositório em si ainda não foi inicializado).

echo 'export PATH="/opt/digna:$PATH"' >> ~/.zshrc
source ~/.zshrc

Passo 4: Instalar o Schema do Repositório¶

No mesmo diretório, execute:

./digna repo install

Este comando instala as tabelas e o schema necessários no seu banco de dados PostgreSQL.

Passo 5: Criar um Usuário Admin¶

1. Abra uma nova janela do Terminal
2. Navegue até o diretório de instalação do digna
3. Execute o seguinte comando para criar um usuário admin:

./digna user add <email> <password> "<display_name>" --admin

Exemplo:

./digna user add admin@example.com 'AdminPassword123!' "Admin User" --admin

Isto cria um utilizador com o endereço de e-mail admin@example.com e privilégios administrativos completos.

Passo 6: Iniciar o Servidor digna¶

No diretório de instalação do digna, inicie o servidor com:

./digna serve --address <host> --port <port>

Parâmetros: - --address — Hostname/IP do servidor - --port — Porta do servidor

Você deverá ver mensagens de inicialização confirmando que o servidor está em execução:

INFO:     Started server process [1234]
INFO:     Waiting for application startup.
INFO:     Application startup complete
INFO:     Uvicorn running on http://localhost:8082

Configuração do Dashboard¶

Passo 1: Fazer o Deploy do Dashboard no Servidor Web¶

O dashboard do digna lê sua própria configuração do arquivo dashboard/dashboard_config.toml. Esse arquivo não acompanha a instalação — você o cria no diretório dashboard/, junto com os arquivos do dashboard.

O conteúdo dele está descrito em Single Sign-On, que é também onde o arquivo é necessário: ele contém as opções de login que o dashboard oferece e, em implantações com múltiplas instâncias, a conexão com o backend.

Escolha seu servidor web e siga as etapas de implantação correspondentes.

Implantando no nginx¶

Se você seguiu a seção de Configuração do nginx, o server block já aponta para sua pasta dashboard e nenhuma cópia é necessária.

1. Confirme o caminho
2. Abra $(brew --prefix)/etc/nginx/servers/digna.conf

3. Verifique se root aponta para a sua pasta dashboard extraída

4. Garanta que a pasta seja legível

   chmod -R a+rX /opt/digna/dashboard
   

5. Recarregue o nginx

   nginx -t
   brew services restart nginx
   

6. Teste a Instalação

7. Abra seu navegador
8. Navegue para http://localhost:8080 (ou sua URL configurada)
9. Você deverá ver a página de login do digna dashboard

Implantando no Apache httpd¶

1. Copie o Dashboard para o Document Root

   sudo cp -R /opt/digna/dashboard /Library/WebServer/Documents/digna
   

2. Adicione as Regras de Rewrite

Crie um arquivo .htaccess dentro da pasta implantada para que as rotas do dashboard sobrevivam a um refresh do navegador:

sudo nano /Library/WebServer/Documents/digna/.htaccess

Cole o seguinte:

RewriteEngine On
RewriteBase /digna/

# Serve existing files and directories as-is.
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]

# Everything else falls back to the single-page application entry point.
RewriteRule ^ index.html [L]

1. Reinicie o Apache

   sudo apachectl restart
   

2. Acesse o Dashboard

3. Abra seu navegador
4. Navegue para http://localhost/digna
5. Você deverá ver a página de login do digna dashboard

Executando o digna como um Serviço em Segundo Plano¶

Por que executar o digna como um serviço?¶

Executar o backend do digna como serviço em segundo plano garante que ele:

• Inicie automaticamente quando a máquina for ligada
• Execute em segundo plano sem uma janela do Terminal aberta
• Reinicie automaticamente se travar
• Possa ser gerenciado através do launchctl, o gerenciador de serviços do macOS

Arquivos de Gerenciamento do Serviço¶

Todos os arquivos necessários estão localizados no diretório de instalação do digna em: bin/

Os seguintes scripts shell estão disponíveis:

• install_service.sh — Registra o digna no launchd
• uninstall_service.sh — Remove o registro do serviço
• start_service.sh — Inicia o serviço registrado
• stop_service.sh — Para o serviço em execução

Tornando os Scripts Executáveis¶

A extração pode não preservar o bit executável. Antes do primeiro uso:

cd /opt/digna/bin
chmod +x *.sh

Instalando o Serviço¶

1. Abra o Terminal

2. Navegue até a pasta bin

   cd /opt/digna/bin
   

3. Execute o script de instalação

   sudo ./install_service.sh
   

O servidor digna agora está registrado no launchd com inicialização automática habilitada. O serviço não inicia imediatamente — veja a seção a seguir para iniciá-lo.

Iniciando e Parando o Serviço¶

Para Iniciar o Serviço¶

1. Abra o Terminal
2. Navegue para /opt/digna/bin
3. Execute:

   sudo ./start_service.sh
   

Para Parar o Serviço¶

1. Abra o Terminal
2. Navegue para /opt/digna/bin
3. Execute:

   sudo ./stop_service.sh
   

Verificando o Serviço¶

Para confirmar que o serviço está registrado e em execução:

sudo launchctl list | grep digna

Uma linha começando com um ID de processo indica que o serviço está em execução. Um - na primeira coluna significa que está registrado mas parado.

Movendo o Serviço para um Novo Diretório¶

O launchd armazena o caminho absoluto para o executável, portanto mover a instalação exige re-registrar o serviço:

1. Desinstalar o serviço atual

   cd /old/path/digna/bin
   sudo ./uninstall_service.sh
   

2. Mover os arquivos da aplicação

   sudo mv /old/path/digna /new/path/digna
   

3. Reinstalar o serviço

   cd /new/path/digna/bin
   sudo ./install_service.sh
   

4. Iniciar o serviço

   sudo ./start_service.sh
   

Desinstalando o Serviço¶

1. Parar o serviço em execução

   cd /opt/digna/bin
   sudo ./stop_service.sh
   

2. Desinstalar o serviço

   sudo ./uninstall_service.sh
   

O servidor digna agora está desregistrado do launchd.

Atualizando para uma Nova Release¶

Antes de Atualizar¶

Verifique Primeiro Todas as Conexões de Banco de Dados

A partir da Release 2026.06, o digna acessa cada tecnologia de origem por ODBC. As versões anteriores ofereciam a escolha entre um driver próprio por tecnologia e ODBC, selecionada pelo botão Use ODBC. A equipe do digna decidiu se apoiar apenas em ODBC, porque uma interface única e padronizada oferece mais do que um conjunto de drivers sob medida:

• Autenticação — a autenticação faz parte do ODBC, então uma conexão pode usar tudo o que o seu driver suportar: senhas, tokens e PATs, Kerberos e Active Directory, MFA e logon único pelo navegador, identidades na nuvem, certificados de cliente e TLS. Novos métodos chegam com uma atualização do driver, em vez de esperar por uma versão do digna.
• Drivers mantidos pelos fabricantes dos bancos de dados — o driver do próprio fabricante acompanha as novas versões do servidor e as correções de segurança, e você pode atualizá-lo no seu próprio ritmo, independentemente do digna.
• Uma única forma de configurar tudo — cada tecnologia é uma lista de propriedades chave/valor, com a mesma interface, a mesma criptografia de valores sensíveis e a mesma solução de problemas, em vez de um conjunto de campos diferente por origem.
• Ajuste e alcance — opções do driver como tempos limite, configurações de TLS, proxies e tamanhos de leitura estão disponíveis para todas as origens, e qualquer tecnologia com um driver ODBC compatível pode ser conectada, inclusive aquelas para as quais o digna não publica um guia dedicado.

Na prática, isso significa que o botão Use ODBC e os campos separados de host, porta, banco de dados, usuário e senha não existem mais. Toda conexão que ainda não usa ODBC precisa ser convertida para ODBC — não há conversão automática, portanto planeje isso antes de atualizar:

1. Revise cada conexão de banco de dados definida na sua instalação e anote as que ainda não usam ODBC — cada uma precisará ser reconfigurada.
2. Instale o driver ODBC correspondente no host do digna — as conexões são abertas pelo servidor que executa o backend do digna, não pelo navegador. Consulte Instalar o Driver ODBC no Host do digna.
3. Tenha as propriedades ODBC prontas para cada conexão afetada. Os guias por tecnologia trazem, para cada origem, um conjunto de propriedades comprovado.

Após a atualização, converta cada conexão afetada para ODBC e teste-a pelo dashboard — consulte Criar uma Conexão de Banco de Dados e Testar uma Conexão.

É obrigatório criar um backup do repositório digna

Antes de atualizar o digna, faça backup do seu repositório (PostgreSQL) para proteger contra perda de dados. Um backup garante que você possa recuperar caso a atualização encontre problemas inesperados.

Para criar um backup a partir do Terminal:

pg_dump -h localhost -p 5432 -U digna_user -n dignarepo postgres > digna_repo_backup.sql

Processo de Atualização¶

Passo 1: Parar o Serviço digna¶

Se o digna estiver em execução como serviço em segundo plano, pare-o primeiro:

cd /opt/digna/bin
sudo ./stop_service.sh

Se o digna estiver em execução em primeiro plano, pressione Ctrl + C na janela do Terminal onde ele está rodando.

Passo 2: Fazer Backup da Instalação Atual¶

No diretório de instalação do digna, renomeie as pastas da instalação atual para que a nova release possa ser implantada ao lado delas:

cd /opt/digna
mv dignabackend dignabackend_old

mv dignacli dignacli_old

mv dashboard dashboard_old

Passo 3: Extrair e Implantar a Nova Versão¶

1. Extraia o novo arquivo ZIP de instalação do digna
2. Copie o novo executável digna e a pasta dashboard para seu diretório de instalação
3. Restaure o bit de execução e, se necessário, limpe o atributo de quarentena:

chmod +x /opt/digna/digna
xattr -dr com.apple.quarantine /opt/digna

Passo 4: Restaurar Seus Arquivos de Configuração¶

cp dashboard_old/dashboard_config.toml dashboard/dashboard_config.toml

[base]
DIGNA_SCHEDULER_MAX_DELAY = 100
DIGNA_CLEANUP_TIME = "12:00"

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

[[oidc_clients]]
DIGNA_OIDC_KEY = 'microsoft'
DIGNA_OIDC_CLIENT_ID = '<client_id>'
DIGNA_OIDC_CLIENT_SECRET = '<client_secret>'
DIGNA_OIDC_REDIRECT_URI = 'http://localhost:3000/oidc/callback'
DIGNA_OIDC_CONFIGURATION_URL = 'https://login.microsoftonline.com/<tenant_id>/v2.0/.well-known/openid-configuration'

[oidc_clients.microsoft]
DIGNA_OIDC_CLIENT_ID = '<client_id>'
DIGNA_OIDC_CLIENT_SECRET = '<client_secret>'
DIGNA_OIDC_REDIRECT_URI = 'http://localhost:3000/oidc/callback'
DIGNA_OIDC_CONFIGURATION_URL = 'https://login.microsoftonline.com/<tenant_id>/v2.0/.well-known/openid-configuration'

Passo 5: Recarregar o Servidor Web¶

O dashboard é um conjunto de arquivos estáticos, então seu servidor web — e o navegador — podem ainda estar servindo a versão anterior. Recarregue ou reinicie o servidor web que hospeda a pasta dashboard e, em seguida, recarregue a página com uma atualização forçada (Cmd+Shift+R).

Passo 6: Validar a Configuração¶

Confirme que o config.toml atualizado está completo antes de mexer no repositório:

./digna config check

Todas as seções devem informar OK. Corrija tudo o que for informado como FAILED e execute o comando novamente antes de continuar.

Passo 7: Substituir o Arquivo de Licença¶

Cada release é licenciada separadamente. Copie o license.toml que a equipe do digna forneceu para esta release para o diretório de instalação, substituindo o antigo:

cp /path/to/new/license.toml /opt/digna/license.toml

./digna license check

Passo 8: Atualizar o Schema do Repositório¶

Navegue até o diretório de instalação do digna e execute:

cd /opt/digna
./digna repo upgrade

Isto atualiza o schema do PostgreSQL para a versão mais recente preservando todos os dados existentes.

Passo 9: Reiniciar Serviços¶

Se estiver rodando como serviço em segundo plano:

cd /opt/digna/bin
sudo ./start_service.sh

Se estiver executando manualmente, reinicie o servidor:

cd /opt/digna
./digna serve --address <address> --port <port>

Se estiver usando nginx ou Apache, reinicie o respectivo servidor web:

brew services restart nginx

sudo apachectl restart

Passo 10: Verificar a Atualização¶

1. Acesse o digna dashboard
2. Verifique se a interface carrega corretamente
3. Cheque os logs do servidor em busca de erros
4. Converta para ODBC todas as conexões que ainda não o usavam e depois teste todas as conexões — consulte Testar uma Conexão