Guia de Instalação no Linux 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 systemd
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 macOS?¶

Este guia cobre o Linux. Para outras plataformas, veja o Guia de Instalação no Windows ou o Guia de Instalação no macOS.

Quais Distribuições Este Guia Cobre?¶

As instruções foram escritas para as duas famílias de servidores mais comuns. Onde as duas diferem, os dois comandos são apresentados:

• Família Debian — Debian, Ubuntu. Gerenciador de pacotes: apt.
• Família RHEL — Red Hat Enterprise Linux, Rocky Linux, AlmaLinux, Fedora. Gerenciador de pacotes: dnf.

Qualquer distribuição moderna com systemd funciona; apenas os nomes dos pacotes e alguns caminhos de configuração mudam.

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 Distribuição e Arquitetura¶

Vários comandos neste guia diferem entre as famílias Debian e RHEL. Para verificar qual você usa, execute:

cat /etc/os-release
uname -m

• ID=ubuntu ou ID=debian — use os comandos apt.
• ID=rhel, rocky, almalinux ou fedora — use os comandos dnf.
• x86_64 ou aarch64 — a arquitetura do pacote de instalação de que você precisa.

Pré-instalação¶

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

1. PostgreSQL Server – para armazenar métricas calculadas e dados de desempenho
2. 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.

Atualizando o Índice de Pacotes¶

Atualize suas listas de pacotes antes de instalar qualquer coisa:

sudo apt update

sudo dnf check-update

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.

Instalando o PostgreSQL¶

Passo 1: Instalar o Pacote do Servidor¶

sudo apt install -y postgresql postgresql-contrib

sudo dnf install -y postgresql-server postgresql-contrib

Passo 2: Inicializar o Cluster de Banco de Dados¶

Na família Debian, o pacote cria e inicia um cluster automaticamente — pule para o próximo passo.

Na família RHEL, o cluster precisa ser criado explicitamente:

sudo postgresql-setup --initdb

Passo 3: Iniciar e Habilitar o Serviço¶

sudo systemctl enable --now postgresql

Isto inicia o PostgreSQL imediatamente e o configura para iniciar novamente de forma automática na inicialização do sistema.

Passo 4: Verificar a Instalação¶

psql --version
sudo systemctl status postgresql

Você deverá ver a versão do PostgreSQL e um serviço active (running).

Passo 5: Conectar-se ao Servidor¶

Um pacote PostgreSQL para Linux cria uma conta de sistema postgres, que é dona do cluster. Conecte-se por meio dela:

sudo -u postgres psql

Passo 6: Confirmar a Porta¶

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

sudo -u postgres psql -c "SHOW port;"

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

Passo 7: Habilitar a Autenticação por Senha para o Usuário do digna¶

O digna se conecta ao PostgreSQL via TCP como digna_user, o que exige autenticação por senha em vez de peer authentication. Verifique se o seu pg_hba.conf permite isso.

Localize o arquivo:

sudo -u postgres psql -c "SHOW hba_file;"

Abra-o em um editor e confirme que as linhas TCP locais usam scram-sha-256 (ou md5 em servidores mais antigos) em vez de ident:

# TYPE  DATABASE  USER  ADDRESS         METHOD
host    all       all   127.0.0.1/32    scram-sha-256
host    all       all   ::1/128         scram-sha-256

Recarregue o PostgreSQL após qualquer alteração:

sudo systemctl reload postgresql

Passo 8: Se o PostgreSQL Rodar em Outra Máquina¶

Para aceitar conexões de outro host, defina listen_addresses em postgresql.conf e adicione uma linha host correspondente à sua rede em pg_hba.conf:

listen_addresses = '*'

Em seguida, abra a porta no firewall e reinicie o serviço:

sudo ufw allow 5432/tcp

sudo firewall-cmd --permanent --add-port=5432/tcp && sudo firewall-cmd --reload

sudo systemctl restart postgresql

Configuração do Servidor Web¶

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

• nginx — leve e recomendado
• Apache httpd — alternativa amplamente utilizada

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¶

sudo apt install -y nginx

sudo dnf install -y nginx

Iniciando o nginx¶

sudo systemctl enable --now nginx

Verificar a Instalação¶

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

Abrindo o Firewall¶

Se o servidor for acessado a partir de outras máquinas, permita o tráfego HTTP:

sudo ufw allow 'Nginx Full'

sudo firewall-cmd --permanent --add-service=http && sudo firewall-cmd --reload

Configurando um Site para o Dashboard¶

O nginx inclui todos os arquivos do seu diretório conf.d em ambas as famílias de distribuição. Crie ali um arquivo de configuração dedicado para o digna:

sudo nano /etc/nginx/conf.d/digna.conf

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

server {
    listen       80 default_server;
    listen       [::]:80 default_server;
    server_name  _;

    root   /opt/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;
    }
}

Desativar o Site Padrão¶

Apenas um server block pode ser o default_server de uma porta. Na família Debian, remova o site padrão do pacote para que ele não entre em conflito:

sudo rm /etc/nginx/sites-enabled/default

Na família RHEL, comente ou exclua o bloco server { ... } dentro de /etc/nginx/nginx.conf.

Aplicar a Configuração¶

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

sudo nginx -t
sudo systemctl reload nginx

Configuração do Apache httpd¶

Visão Geral¶

O Apache httpd está disponível nos repositórios padrão de todas as distribuições suportadas. O pacote se chama apache2 na família Debian e httpd na família RHEL.

Instalação¶

sudo apt install -y apache2

sudo dnf install -y httpd

Iniciando o Apache¶

sudo systemctl enable --now apache2

sudo systemctl enable --now httpd

Verificar a Instalação¶

1. Abra seu navegador
2. Navegue para http://localhost
3. Você deverá ver a página padrão do Apache da sua distribuição

Obrigatório: Habilitar mod_rewrite¶

O dashboard requer reescrita de URL.

Na família Debian, habilite o módulo e reinicie:

sudo a2enmod rewrite
sudo systemctl restart apache2

Na família RHEL, o mod_rewrite é carregado por padrão. Confirme:

httpd -M | grep rewrite

Obrigatório: Permitir Overrides via .htaccess¶

Abra o arquivo de configuração do seu document root:

sudo nano /etc/apache2/apache2.conf

sudo nano /etc/httpd/conf/httpd.conf

Localize o bloco <Directory> que cobre o seu document root (/var/www/html em ambas as famílias) e altere:

AllowOverride None

para:

AllowOverride All

Obrigatório: Tipo MIME para Arquivos Markdown¶

No mesmo arquivo, 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 systemctl restart apache2

sudo apachectl configtest
sudo systemctl restart httpd

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 shell em um único passo:

sudo -u postgres psql

Em seguida, cole os comandos 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
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 shell:

sudo mkdir -p /opt/digna
sudo unzip digna-2026.06-linux-x86_64.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
sudo chmod +x digna

Criar uma Conta de Serviço¶

Executar o backend como um usuário dedicado sem privilégios é recomendado para implantações em produção:

sudo useradd --system --no-create-home --shell /usr/sbin/nologin digna
sudo chown -R digna:digna /opt/digna

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         (configuration file)
├── license.toml        (YOUR LICENSE FILE - copy here)
├── digna               (main executable)
├── bin/                (service management scripts)
└── dashboard/          (web interface)
    └── (dashboard files)

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
sudo 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!"

sudo chown digna:digna /opt/digna/config.toml
sudo chmod 600 /opt/digna/config.toml

Seção [base]¶

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

[base]
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 um 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).

sudo ln -s /opt/digna/digna /usr/local/bin/digna

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¶

O usuário admin é criado diretamente no schema do repositório, portanto o servidor ainda não precisa estar em execução. No diretório de instalação do digna, execute:

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

Exemplo:

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

Isto cria um usuário com o 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

sudo ufw allow 8082/tcp

sudo firewall-cmd --permanent --add-port=8082/tcp && sudo firewall-cmd --reload

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 /etc/nginx/conf.d/digna.conf

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

4. Garanta que a pasta seja legível

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

5. Recarregue o nginx

   sudo nginx -t
   sudo systemctl reload nginx
   

6. Teste a Instalação

7. Abra seu navegador
8. Navegue para http://localhost (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 /var/www/html/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 /var/www/html/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 systemctl restart apache2
   

   sudo systemctl restart httpd
   

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

Passo 2: SELinux (Apenas Família RHEL)¶

No RHEL, Rocky, AlmaLinux e Fedora, o SELinux fica no modo enforcing por padrão e impede que o servidor web leia arquivos fora dos locais esperados. Verifique se ele está ativo:

getenforce

Se o resultado for Enforcing e você estiver servindo o dashboard a partir de /opt/digna/dashboard, rotule o diretório para que o servidor web possa lê-lo:

sudo semanage fcontext -a -t httpd_sys_content_t "/opt/digna/dashboard(/.*)?"
sudo restorecon -Rv /opt/digna/dashboard

Executando o digna como um Serviço systemd¶

Por que Executar o digna como um Serviço?¶

Executar o backend do digna como um serviço systemd garante que ele:

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

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 systemd
• 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
sudo chmod +x *.sh

Instalando o Serviço¶

1. Abra um 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 systemd 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 um terminal
2. Navegue para /opt/digna/bin
3. Execute:

   sudo ./start_service.sh
   

Para Parar o Serviço¶

1. Abra um terminal
2. Navegue para /opt/digna/bin
3. Execute:

   sudo ./stop_service.sh
   

Gerenciando o Serviço com systemctl¶

Depois de registrado, o serviço também pode ser controlado com os comandos padrão do systemd, a partir de qualquer diretório:

sudo systemctl start digna
sudo systemctl stop digna
sudo systemctl restart digna
sudo systemctl status digna

Verificando o Serviço¶

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

systemctl is-enabled digna
systemctl is-active digna

enabled significa que o serviço inicia com o sistema; active significa que ele está em execução agora.

Visualizando os Logs do Serviço¶

O systemd captura tudo o que o backend escreve no console. Para ler:

sudo journalctl -u digna -n 100

Para acompanhar o log ao vivo enquanto reproduz um problema:

sudo journalctl -u digna -f

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

O arquivo de unidade armazena o caminho absoluto do executável, portanto mover a instalação exige registrar o serviço novamente:

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 systemd.

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 do 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 shell:

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 systemd, 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
sudo mv dignabackend dignabackend_old

sudo mv dignacli dignacli_old

sudo 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 a propriedade da conta de serviço:

sudo chmod +x /opt/digna/digna
sudo chown -R digna:digna /opt/digna

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

sudo 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 (Ctrl+F5).

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:

sudo 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 systemd:

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, recarregue o respectivo servidor web:

sudo systemctl reload nginx

sudo systemctl restart apache2

Na família RHEL, reaplique a rotulagem do SELinux se o diretório dashboard tiver sido substituído:

sudo restorecon -Rv /opt/digna/dashboard

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:

sudo journalctl -u digna -n 100