Guia de Instalação no Linux para o digna Release 2026.11¶

Release: 2026.11

Última Atualização: 7 de novembro 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.11¶

Esta release adiciona o digna Data Reconciliation, o digna Agentic com o digna MCP Server e o digna Engine, que pode fazer o profiling dos dados dentro do digna e verificar a integridade referencial entre diferentes tecnologias de banco de dados. Consulte as notas de versão para detalhes completos.

Para uma instalação, a release traz um novo mecanismo de migração do repositório, uma seção [duckdb] opcional no config.toml para o digna Engine e um novo arquivo de licença. A seção de atualização aborda cada um deles.

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.11-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 o compartilhamento de recursos entre origens (CORS) entre o dashboard e o backend:

[app]
DIGNA_APP_CORS_ALLOW_ORIGINS = ["http://localhost:5173"]
DIGNA_APP_CORS_ALLOW_CREDENTIALS = true

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!"
DIGNA_REPO_SSLMODE = "prefer"
DIGNA_REPO_NUM_CONNS = 16

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, cookies e inspeção:

[base]
DIGNA_FERNET_KEY = "DU4a0yJ-OqvbKCL4hNQn_CsknH-V1vWmHZqBUl-AY44="
DIGNA_COOKIE_DOMAIN = "localhost"
DIGNA_COOKIE_SECURE = false
DIGNA_COOKIE_HTTPONLY = true
DIGNA_TOKEN_EXPIRES_IN = 86400
DIGNA_MAX_WORKERS = 4
DIGNA_FRONTEND_BASEURL = "http://localhost/"
DIGNA_SOURCE_QUERY_TIMEOUT_SEC = 3600
DIGNA_SOURCE_LOGIN_TIMEOUT_SEC = 30

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_DIR = "logs"
DIGNA_LOGGING_MAX_FILES = 30

Seção [duckdb] (Opcional)¶

Novidade da Release 2026.11. Esta seção define os recursos do digna Engine, que faz o profiling dos dados dentro do digna para as conexões de banco de dados cujo local de profiling é digna Engine, e executa verificações de integridade referencial entre fontes de dados em conexões de banco de dados diferentes. Consulte Profiling Location.

A seção é opcional. Sem ela, valem os padrões abaixo.

[duckdb]
DIGNA_DUCKDB_MEMORY_LIMIT_MB = 1024
DIGNA_DUCKDB_TEMP_DIRECTORY = "/opt/digna/tmp"

sudo mkdir -p /opt/digna/tmp
sudo chown digna:digna /opt/digna/tmp

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
 - Template overrides: OK
 - Unknown keys: OK

Overall: OK

Corrija tudo o que for informado como FAILED e execute o comando novamente antes de continuar. Um WARNING em Unknown keys lista chaves do config.toml que o digna não lê; elas não têm efeito, então remova-as ou corrija a grafia. 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

Em um schema novo, o comando se conecta e então informa que ainda não há nenhum repositório instalado:

Error: No repo installed. Use the 'digna repo upgrade' command to install it.

Neste ponto, esse é o resultado esperado: ele confirma que o digna alcança o PostgreSQL e o schema. Já um erro de conexão ou de autenticação aponta para a seção [repo] ou para a configuração do PostgreSQL.

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 upgrade

Este comando instala as tabelas necessárias no schema do repositório e termina com:

✅ Repo schema 'dignarepo' is up to date.

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 (padrão 127.0.0.1) - --port — Porta do servidor (padrão 8000)

Quando o servidor estiver no ar, ele exibe o endereço em que está escutando:

Server running on http://127.0.0.1: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¶

Esta seção atualiza uma instalação da Release 2026.06 para a Release 2026.11. Se a sua instalação for mais antiga, leia primeiro Atualizando a Partir de uma Release Anterior à 2026.06.

Antes de Atualizar¶

É 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

Solicitando o Arquivo de Licença para a Release 2026.11

A Release 2026.11 precisa de um novo license.toml. Solicite-o à equipe do digna antes de começar e deixe-o pronto para o Passo 7.

Atualizando a Partir de uma Release Anterior à 2026.06¶

A Release 2026.06 trouxe três mudanças que continuam valendo quando você atualiza uma instalação mais antiga diretamente para a 2026.11:

• Somente ODBC. O digna acessa cada tecnologia de origem por ODBC. Toda conexão de banco de dados que ainda não usa ODBC precisa ser convertida para ODBC após a atualização; não há conversão automática. Instale antes os drivers ODBC no host do digna, consulte Instalar o Driver ODBC no Host do digna, e tenha prontas as propriedades de cada conexão a partir dos guias por tecnologia. O conector Databricks Legacy não existe mais; mova essas conexões para o conector Databricks.
• Um único executável. dignabackend e dignacli são substituídos pelo executável único digna, que reúne o backend e a CLI.
• config.toml. A seção [encryption] é obrigatória, e DIGNA_APP_HOST e DIGNA_APP_PORT não são mais lidos: o servidor obtém seu endereço e sua porta de digna serve. Compare seu arquivo com a Configuração do Backend.

Os passos abaixo indicam onde uma instalação mais antiga precisa de algo diferente. A atualização do repositório no Passo 8 leva um repositório de qualquer release anterior diretamente para a 2026.11.

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 o executável e a pasta do dashboard da sua instalação atual, para que a nova release possa ser implantada ao lado deles:

cd /opt/digna
sudo mv digna digna_old
sudo mv dashboard dashboard_old

Mantenha digna_old até verificar a atualização, e dashboard_old até restaurar dele os seus arquivos de configuração (veja o Passo 4). Depois, você pode excluir ambos.

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

A Release 2026.11 não exige nenhuma alteração no config.toml: um arquivo que funciona com a Release 2026.06 continua funcionando. Duas alterações são opcionais:

• Adicione uma seção [duckdb] se as conexões de banco de dados forem usar o digna Engine e os padrões dele não forem adequados ao seu host.
• Omita a seção [app] se um proxy reverso servir o dashboard e o backend sob uma única origem.

[[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'

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 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, remova as chaves listadas em Unknown keys e execute o comando novamente antes de continuar.

Passo 7: Substituir o Arquivo de Licença¶

Normalmente, um arquivo de licença continua valendo de uma release para a seguinte. A Release 2026.11 é uma exceção: ela adiciona dois módulos licenciados, o digna Data Reconciliation e o digna Agentic, e uma licença emitida antes da 2026.11 não os contém. Copie o license.toml que a equipe do digna forneceu para a Release 2026.11 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¶

No diretório de instalação do digna, execute:

cd /opt/digna
./digna repo upgrade

A Release 2026.11 gerencia o schema do repositório com migrações versionadas. A primeira atualização a partir de uma release anterior leva o schema à última versão do mecanismo anterior, registra isso como ponto de partida e, em seguida, aplica as migrações da Release 2026.11. Ela termina com:

✅ Baseline migration recorded as applied.
✅ Repo schema 'dignarepo' is up to date.

Todos os dados existentes são preservados. Para ver o estado do repositório a qualquer momento, execute ./digna repo check: ele lista a última migração aplicada e as migrações pendentes.

Error: Legacy repo version 3.0.2 installed. Use the 'digna repo upgrade' command to upgrade it.

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. Confirme a release do novo executável:

   ./digna version
   

   A primeira linha deve ser Release: 2026.11.

2. Acesse o digna dashboard e verifique se a interface carrega corretamente.

3. Verifique os logs do servidor em busca de erros:

   sudo journalctl -u digna -n 100
   

4. Teste suas conexões de banco de dados — consulte Testar uma Conexão. Após uma atualização a partir de uma release anterior à 2026.06, converta primeiro para ODBC todas as conexões que ainda não o usavam.

Para começar a usar os novos módulos, consulte digna Data Reconciliation, Conectar um Agente de IA para o digna MCP Server e Profiling Location para o digna Engine.