macOS용 digna 설치 안내 Release 2026.11¶

릴리스: 2026.11

최종 업데이트: 2026년 11월 7일

목차¶

1. 소개
2. 시스템 요구사항
3. 사전 설치 준비
4. PostgreSQL 서버 설정
5. 웹 서버 구성
6. 초기 설치
7. 백엔드 구성
8. 대시보드 구성
9. digna를 백그라운드 서비스로 실행하기
10. 새 릴리스로 업그레이드하기

소개¶

digna에 관하여¶

digna는 데이터 웨어하우스, 데이터 레이크, 레이크하우스 등 다양한 데이터 환경에서 데이터 품질 관리를 최적화하도록 설계된 AI 기반 플랫폼입니다. 자동화, 실시간 모니터링 및 이상 탐지를 통해 현대 데이터 문제를 해결할 수 있도록 높은 확장성과 적응성을 갖추고 있습니다.

digna는 두 가지 주요 구성 요소로 이루어져 있습니다:

• digna: 애플리케이션의 핵심으로, 데이터 처리와 품질 검사 수행을 담당합니다. 백엔드와 명령줄 인터페이스를 단일 실행 파일로 통합하여 이전 릴리스의 별도 프로그램인 dignabackend와 dignacli를 대체합니다.
• dignadashboard: 웹 서버에 호스팅되는 웹 기반 인터페이스로, digna 플랫폼과 상호작용하고 데이터 품질 지표를 시각화하는 사용자 친화적 수단을 제공합니다.

Release 2026.11의 변경 사항¶

이번 릴리스는 digna Data Reconciliation, digna MCP Server를 포함한 digna Agentic, 그리고 digna Engine을 추가합니다. digna Engine은 digna 내부에서 데이터를 프로파일링하고 서로 다른 데이터베이스 기술 간의 참조 무결성을 검사할 수 있습니다. 전체 내용은 릴리스 노트를 참조하세요.

설치 측면에서 이번 릴리스는 새로운 리포지토리 마이그레이션 메커니즘, digna Engine을 위한 config.toml의 선택적 [duckdb] 섹션, 그리고 새 라이선스 파일을 도입합니다. 각각은 업그레이드 섹션에서 다룹니다.

Windows 또는 Linux용 안내를 찾고 계신가요?¶

이 가이드는 macOS를 다룹니다. 다른 플랫폼은 Windows 설치 안내 또는 Linux 설치 안내를 참조하세요.

시스템 요구사항¶

설치를 시작하기 전에 시스템이 다음 최소 요구사항을 충족하는지 확인하세요:

데이터베이스 설치 옵션¶

PostgreSQL가 이미 설치되어 있는 경우: 기존 PostgreSQL 서버에 digna용 새 데이터베이스를 추가할 수 있습니다.

digna와 동일한 머신에 PostgreSQL을 설치하는 경우:

아키텍처 확인 방법¶

이 가이드의 여러 경로는 Apple Silicon과 Intel Mac 간에 다릅니다. 어느 쪽인지 확인하려면 터미널을 열고 다음을 실행하세요:

uname -m

• arm64 — Apple Silicon. Homebrew는 /opt/homebrew에 설치됩니다.
• x86_64 — Intel. Homebrew는 /usr/local에 설치됩니다.

사전 설치 준비¶

digna를 설치하기 전에 다음 세 가지 주요 필수 요소가 준비되어 있는지 확인하세요:

1. Homebrew – 아래 구성 요소를 설치하는 데 사용되는 패키지 관리자
2. PostgreSQL 서버 – 계산된 메트릭 및 성능 데이터를 저장하기 위한 데이터베이스
3. 웹 서버 – digna 대시보드를 호스팅하기 위한 서버

이들 구성 요소가 아직 설정되어 있지 않다면, 아래 섹션을 따라 설치 및 구성하세요.

Homebrew 설치¶

Homebrew는 macOS의 표준 패키지 관리자이며 이 가이드 전반에서 PostgreSQL과 nginx를 설치하는 데 사용됩니다.

1단계: Homebrew가 이미 설치되어 있는지 확인¶

터미널을 열고(유틸리티에서 또는 Cmd + Space 후 Terminal 입력) 다음을 실행하세요:

brew --version

버전 번호가 반환되면 PostgreSQL 서버 설정 섹션으로 건너뛰세요.

2단계: Homebrew 설치¶

명령을 찾을 수 없는 경우, 공식 Homebrew 사이트의 지침에 따라 Homebrew를 설치하세요. 설치 프로그램은 Xcode Command Line Tools가 없는 경우 이를 함께 설치합니다.

3단계: Homebrew를 PATH에 추가¶

Apple Silicon에서는 설치 프로그램이 Homebrew를 셸 환경에 추가하기 위한 두 명령을 출력합니다. 지시에 따라 해당 명령을 실행한 후 다음을 확인하세요:

brew --prefix

Apple Silicon에서는 /opt/homebrew를, Intel에서는 /usr/local을 출력해야 합니다.

PostgreSQL 서버 설정¶

이미 PostgreSQL이 있는 경우¶

PostgreSQL이 로컬 머신에서 이미 실행 중이거나 관리형 원격 PostgreSQL 서버를 사용하는 경우, 다음 섹션으로 건너뛰세요.

설치 옵션¶

macOS에서는 PostgreSQL을 설치하는 두 가지 간단한 방법이 있습니다. 하나만 선택하세요:

• Homebrew — 명령줄 설치, 서버 배포에 권장
• Postgres.app — 그래픽 설치, 로컬 평가에 편리

Homebrew로 PostgreSQL 설치¶

1단계: PostgreSQL 포뮬러 설치¶

brew install postgresql@16

2단계: PostgreSQL을 PATH에 추가¶

버전 지정 포뮬러는 keg-only이므로 Homebrew가 자동으로 명령을 PATH에 연결하지 않습니다. 직접 추가하세요:

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

3단계: PostgreSQL 서비스 시작¶

brew services start postgresql@16

이 명령은 PostgreSQL을 즉시 시작하고 로그인할 때 자동으로 다시 시작되도록 구성합니다.

4단계: 설치 확인¶

psql --version

설치가 성공했다면 PostgreSQL 버전이 표시됩니다.

5단계: 서버에 연결¶

psql postgres

6단계: 포트 확인¶

기본 PostgreSQL 포트는 5432입니다. 서버가 어느 포트를 수신하는지 확인하려면:

psql postgres -c "SHOW port;"

이 값을 기록해 두세요 — digna 백엔드를 구성할 때 필요합니다.

Postgres.app로 PostgreSQL 설치¶

그래픽 설치를 선호하는 경우:

1. Postgres.app을 다운로드하여 Applications 폴더로 드래그합니다.
2. 앱을 열고 Initialize를 클릭하여 새 서버를 만듭니다.
3. 앱의 지침에 따라 명령줄 도구를 PATH에 추가합니다.
4. 설치 확인:

psql --version

Postgres.app은 macOS 계정 이름으로 된 슈퍼유저도 생성합니다.

웹 서버 구성¶

digna는 대시보드를 호스팅하기 위해 웹 서버가 필요합니다. 다음 옵션 중 하나를 선택하세요:

• nginx — Homebrew로 설치, 권장
• Apache httpd — macOS에 포함

이 중 하나만 설치하고 구성하면 됩니다.

두 섹션 모두 대시보드가 의존하는 두 가지를 구성합니다:

• 단일 페이지 애플리케이션(fallback) — 대시보드 URL을 새로고침해도 404가 반환되지 않도록 함
• .md MIME 타입 — Markdown 파일이 올바르게 제공되도록 함

nginx 설정¶

개요¶

nginx는 정적 digna 대시보드를 제공하는 데 적합한 가볍고 고성능의 웹 서버입니다.

설치¶

brew install nginx

nginx 시작¶

brew services start nginx

설치 확인¶

1. 브라우저를 엽니다.
2. http://localhost:8080로 이동합니다.
3. nginx 환영 페이지가 표시되어야 합니다.

대시보드용 사이트 구성¶

Homebrew의 nginx 구성은 servers 디렉터리의 모든 파일을 포함합니다. digna용 전용 구성 파일을 생성하세요:

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

다음 내용을 붙여넣고 /path/to/digna/dashboard를 압축을 푼 dashboard 폴더의 실제 경로로 바꾸세요:

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;
    }
}

구성 적용¶

구성 문법 오류가 없는지 테스트한 다음 nginx를 다시 로드하세요:

nginx -t
brew services restart nginx

Apache httpd 설정¶

개요¶

macOS에는 Apache httpd가 포함되어 있어 별도 설치가 필요 없습니다. 기본적으로 비활성화되어 있습니다.

Apache 시작¶

sudo apachectl start

설치 확인¶

1. 브라우저를 엽니다.
2. http://localhost로 이동합니다.
3. "It works!" 메시지가 표시되어야 합니다.

필수: mod_rewrite 활성화¶

대시보드는 URL 재작성 기능이 필요합니다. Apache 구성 파일을 엽니다:

sudo nano /etc/apache2/httpd.conf

다음 줄을 찾아 앞의 #를 제거하여 주석을 해제하세요:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

필수: .htaccess 재정의 허용¶

같은 파일에서 <Directory "/Library/WebServer/Documents"> 블록을 찾아 다음을 변경하세요:

AllowOverride None

다음으로:

AllowOverride All

필수: Markdown 파일용 MIME 타입¶

여전히 httpd.conf에서 Markdown 파일이 올바르게 제공되도록 다음 줄을 추가하세요:

AddType text/markdown .md

구성 적용¶

구성 문법 오류를 검사한 다음 Apache를 다시 시작하세요:

sudo apachectl configtest
sudo apachectl restart

초기 설치¶

1단계: digna 리포지토리 설정¶

digna 리포지토리는 digna가 계산한 모든 메트릭을 저장합니다. 분석 및 성능 데이터의 중앙 데이터베이스 역할을 합니다.

리포지토리 스키마 및 사용자 생성¶

PostgreSQL 클라이언트(psql, pgAdmin 등)를 열고 다음 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>;

다음 플레이스홀더를 교체하세요:

• <digna_repo_schema> — 원하는 스키마 이름(예: dignarepo)
• <digna_repo_user> — 원하는 사용자 이름(예: digna_user)
• <digna_repo_password> — 이 사용자의 안전한 비밀번호

예시:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

터미널에서 한 번에 실행하려면:

psql postgres

그런 다음 postgres=# 프롬프트에 위 명령들을 붙여넣고 \q를 입력하여 종료하세요.

2단계: digna 설치 패키지 압축 해제¶

1. 제공된 digna 설치 ZIP 파일을 찾습니다.
2. 예를 들어 /opt/digna 또는 ~/digna와 같은 원하는 설치 위치에 압축을 풉니다.
3. 압축을 풀면 다음 항목이 보여야 합니다:
4. dashboard/ — 웹 대시보드 인터페이스
5. digna — 메인 실행 파일(백엔드 + CLI 통합)

터미널에서 압축을 풀려면:

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

실행 파일에 실행 권한 부여¶

아카이브 전송 방법에 따라 실행 비트가 유지되지 않을 수 있습니다. 명시적으로 설정하세요:

cd /opt/digna
chmod +x digna

macOS가 애플리케이션을 차단하는 경우¶

브라우저나 메일 클라이언트를 통해 다운로드된 파일에는 격리(quarantine) 속성이 추가됩니다. macOS에서 앱을 "개발자를 확인할 수 없어 열 수 없습니다"라고 보고하면 설치 디렉터리에서 해당 속성을 제거하세요:

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

또는 시스템 설정 → 개인정보 및 보안을 열어 페이지 하단 근처에서 차단된 항목을 찾아 열기 허용(Open Anyway) 을 클릭하세요.

3단계: 라이선스 파일 설치¶

1. 제공된 license.toml 파일을 찾습니다.
2. config.toml 및 digna 실행 파일이 있는 digna 설치 루트 디렉터리에 복사합니다.

이유: 라이선스 파일에는 고객 정보, 라이선스 만료일 및 디지털 서명이 포함되어 있습니다. 이 파일을 수정하지 마세요 — 변경하면 무효화됩니다.

설치 후 디렉터리 구조 예시:

/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)

백엔드 구성¶

1단계: 구성 파일 생성 및 편집¶

config_template.toml 파일이 digna 설치 디렉터리에 제공됩니다. 이를 config.toml로 이름만 변경하면 됩니다.

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

위치: /opt/digna/config.toml

텍스트 편집기에서 config.toml을 열고 아래 각 섹션을 구성하세요.

[app] 섹션¶

이 섹션은 대시보드와 백엔드 간의 교차 출처 리소스 공유(CORS)를 구성합니다:

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

[repo] 섹션¶

이 섹션은 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

[base] 섹션¶

이 섹션은 보안, 쿠키 및 검사 설정을 포함합니다:

[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

[encryption] 섹션¶

이 섹션에는 리포지터리에 저장된 민감한 값을 암호화하는 데 사용되는 키가 들어 있습니다. 필수입니다 — 키가 없으면 config check는 [encryption] 섹션을 FAILED로 보고합니다.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

[logging] 섹션¶

이 섹션은 로깅 동작을 구성합니다:

[logging]
DIGNA_LOGGING_MODE = "INFO"
DIGNA_LOGGING_DIR = "logs"
DIGNA_LOGGING_MAX_FILES = 30

[duckdb] 섹션 (선택 사항)¶

릴리스 2026.11의 새 기능입니다. 이 섹션은 digna Engine의 리소스를 설정합니다. digna Engine은 프로파일링 위치가 digna Engine인 데이터베이스 연결에 대해 digna 내부에서 데이터를 프로파일링하고, 서로 다른 데이터베이스 연결에 있는 데이터 소스 간의 참조 무결성 검사를 실행합니다. 참조: 프로파일링 위치.

이 섹션은 선택 사항입니다. 이 섹션이 없으면 아래의 기본값이 적용됩니다.

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

mkdir -p /opt/digna/tmp

2단계: 구성 검증¶

리포지터리를 초기화하기 전에 config.toml이 완전하고 올바르게 구성되었는지 확인하십시오. digna 설치 디렉터리에서 다음을 실행합니다:

./digna config check

각 섹션은 개별적으로 검증되므로 하나의 오류가 나머지 상태를 가리지 않습니다:

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

FAILED로 보고된 모든 항목을 수정한 뒤, 계속하기 전에 명령을 다시 실행하십시오. Unknown keys 아래의 WARNING은 config.toml에 있지만 digna가 읽지 않는 키를 나열합니다. 이 키들은 아무 효과가 없으므로 제거하거나 철자를 바로잡으십시오. 전체 옵션 목록은 CLI 참조에 있습니다.

3단계: 리포지토리 초기화¶

1. 터미널을 엽니다.
2. digna 설치 디렉터리(예: config.toml과 digna 실행 파일이 있는 위치)로 이동합니다.
3. 연결 테스트를 실행하세요:

cd /opt/digna
./digna repo check

새 스키마에서는 명령이 연결한 다음, 아직 리포지토리가 설치되지 않았다고 보고합니다:

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

이 시점에서는 이것이 예상된 결과이며, digna가 PostgreSQL과 스키마에 도달할 수 있음을 확인해 줍니다. 대신 연결 오류나 인증 오류가 나타나면 [repo] 섹션 또는 PostgreSQL 설정을 확인하세요.

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

4단계: 리포지토리 스키마 설치¶

같은 디렉터리에서 다음을 실행하세요:

./digna repo upgrade

이 명령은 리포지토리 스키마에 필요한 테이블을 설치하고 다음 메시지로 완료됩니다:

✅ Repo schema 'dignarepo' is up to date.

5단계: 관리자 사용자 생성¶

관리자 사용자는 리포지토리 스키마에 직접 생성되므로 아직 서버를 실행할 필요가 없습니다. digna 설치 디렉터리에서 다음을 실행하세요:

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

예시:

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

이렇게 하면 이메일 주소가 admin@example.com이고 전체 관리자 권한을 가진 사용자가 생성됩니다.

6단계: digna 서버 시작¶

digna 설치 디렉터리에서 서버를 시작하세요:

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

매개변수: - --address — 서버 호스트명/IP (기본값 127.0.0.1) - --port — 서버 포트 (기본값 8000)

서버가 시작되면 수신 대기 중인 주소를 출력합니다:

Server running on http://127.0.0.1:8082

대시보드 구성¶

1단계: 대시보드를 웹 서버에 배포¶

digna 대시보드는 자체 구성을 dashboard/dashboard_config.toml에서 읽습니다. 이 파일은 설치 패키지에 포함되어 있지 않으므로, 대시보드 파일과 함께 dashboard/ 디렉터리에 직접 생성해야 합니다.

파일의 내용은 Single Sign-On에서 설명하며, 이 파일이 필요한 곳도 바로 그곳입니다. 이 파일에는 대시보드가 제공하는 로그인 옵션과, 다중 인스턴스 배포의 경우 백엔드 연결 정보가 담깁니다.

웹 서버를 선택한 다음 해당 배포 단계를 따르세요.

nginx에 배포¶

nginx 설정 섹션을 따랐다면 서버 블록이 이미 dashboard 폴더를 가리키므로 복사할 필요가 없습니다.

1. 경로 확인
2. $(brew --prefix)/etc/nginx/servers/digna.conf 파일을 엽니다.

3. root가 압축을 푼 dashboard 폴더를 가리키는지 확인합니다.

4. 폴더가 읽기 가능하도록 설정

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

5. nginx 재로드

   nginx -t
   brew services restart nginx
   

6. 설치 테스트

7. 브라우저를 엽니다.
8. http://localhost:8080(또는 구성한 URL)로 이동합니다.
9. digna 대시보드 로그인 페이지가 표시되어야 합니다.

Apache httpd에 배포¶

1. 대시보드를 문서 루트로 복사

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

2. 재작성 규칙 추가

대시보드 경로가 새로고침 시 유지되도록 배포된 폴더 안에 .htaccess 파일을 만듭니다:

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

다음 내용을 붙여넣으세요:

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. Apache 재시작

   sudo apachectl restart
   

2. 대시보드 접속

3. 브라우저를 엽니다.
4. http://localhost/digna로 이동합니다.
5. digna 대시보드 로그인 페이지가 표시되어야 합니다.

digna를 백그라운드 서비스로 실행하기¶

왜 digna를 서비스로 실행해야 하나요?¶

digna 백엔드를 백그라운드 서비스로 실행하면 다음과 같은 이점이 있습니다:

• 머신 부팅 시 자동으로 시작됩니다.
• 열린 터미널 창 없이 백그라운드에서 실행됩니다.
• 충돌 시 자동으로 재시작됩니다.
• macOS의 서비스 관리자 launchctl을 통해 관리할 수 있습니다.

서비스 관리 파일¶

필요한 모든 파일은 digna 설치 디렉터리의 bin/ 아래에 있습니다.

다음 셸 스크립트들이 제공됩니다:

• install_service.sh — digna를 launchd에 등록
• uninstall_service.sh — 서비스 등록 해제
• start_service.sh — 등록된 서비스 시작
• stop_service.sh — 실행 중인 서비스 중지

스크립트에 실행 권한 부여¶

추출 과정에서 실행 비트가 유지되지 않을 수 있습니다. 처음 사용하기 전에:

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

서비스 설치¶

1. 터미널을 엽니다.

2. bin 폴더로 이동

   cd /opt/digna/bin
   

3. 설치 스크립트 실행

   sudo ./install_service.sh
   

이제 digna 서버가 자동 시작이 활성화된 상태로 launchd에 등록됩니다. 서비스는 즉시 시작되지 않으니, 다음 섹션을 참조하여 시작하세요.

서비스 시작 및 중지¶

서비스를 시작하려면¶

1. 터미널을 엽니다.
2. /opt/digna/bin으로 이동합니다.
3. 다음을 실행하세요:

   sudo ./start_service.sh
   

서비스를 중지하려면¶

1. 터미널을 엽니다.
2. /opt/digna/bin으로 이동합니다.
3. 다음을 실행하세요:

   sudo ./stop_service.sh
   

서비스 확인¶

서비스가 등록되고 실행 중인지 확인하려면:

sudo launchctl list | grep digna

프로세스 ID로 시작하는 줄이 있으면 서비스가 실행 중입니다. 첫 번째 열에 -가 있으면 등록은 되어 있으나 중지된 상태입니다.

설치 위치를 변경하는 경우¶

launchd는 실행 파일의 절대 경로를 저장하므로 설치 위치를 옮기면 서비스를 다시 등록해야 합니다:

1. 현재 서비스 제거

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

2. 애플리케이션 파일 이동

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

3. 서비스 재설치

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

4. 서비스 시작

   sudo ./start_service.sh
   

서비스 제거¶

1. 실행 중인 서비스 중지

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

2. 서비스 등록 해제

   sudo ./uninstall_service.sh
   

이제 digna 서버가 launchd에서 등록 해제되었습니다.

새 릴리스로 업그레이드하기¶

이 섹션에서는 릴리스 2026.06 설치를 릴리스 2026.11로 업그레이드합니다. 설치가 그보다 오래된 경우 먼저 릴리스 2026.06 이전 릴리스에서 업그레이드를 읽으십시오.

업그레이드 전에¶

digna 저장소 백업 생성은 필수입니다

digna를 업그레이드하기 전에 저장소(PostgreSQL)를 백업하여 데이터 손실에 대비하십시오. 백업이 있으면 업그레이드 중 예기치 않은 문제가 발생해도 복구할 수 있습니다.

터미널에서 백업을 생성하려면:

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

릴리스 2026.11용 라이선스 파일 요청

릴리스 2026.11에는 새 license.toml이 필요합니다. 시작하기 전에 digna 팀에 요청하고, 7단계에서 사용할 수 있도록 준비해 두십시오.

릴리스 2026.06 이전 릴리스에서 업그레이드¶

릴리스 2026.06에서는 세 가지 변경 사항이 도입되었으며, 이전 설치를 2026.11로 바로 업그레이드할 때에도 여전히 적용됩니다:

• ODBC 전용. digna는 모든 소스 기술에 ODBC로 접근합니다. 아직 ODBC를 사용하지 않는 모든 데이터베이스 연결은 업그레이드 후 ODBC로 변경해야 하며, 자동 변환은 없습니다. 미리 digna 호스트에 ODBC 드라이버를 설치하고(참조: digna 호스트에 ODBC 드라이버 설치), 기술별 안내서를 참고해 각 연결의 속성을 준비해 두십시오. Databricks Legacy 커넥터는 더 이상 존재하지 않습니다. 해당 연결은 Databricks 커넥터로 이전하십시오.
• 단일 실행 파일. dignabackend와 dignacli는 백엔드와 CLI를 통합한 단일 실행 파일 digna로 대체되었습니다.
• config.toml. [encryption] 섹션이 필수이며, DIGNA_APP_HOST와 DIGNA_APP_PORT는 더 이상 읽지 않습니다. 서버는 주소와 포트를 digna serve에서 받습니다. 사용 중인 파일을 백엔드 구성과 비교하십시오.

아래 단계에서는 이전 설치에서 다른 작업이 필요한 부분을 알려 줍니다. 8단계의 저장소 업그레이드는 이전 어느 릴리스의 저장소든 바로 2026.11로 업그레이드합니다.

업그레이드 절차¶

1단계: digna 서비스 중지¶

digna가 백그라운드 서비스로 실행 중이면 먼저 중지하십시오:

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

digna가 포그라운드에서 실행 중이면 해당 터미널 창에서 Ctrl+C를 누르십시오.

2단계: 현재 설치 백업¶

digna 설치 디렉터리에서 현재 설치의 실행 파일과 대시보드 폴더 이름을 변경하여, 새 릴리스를 나란히 배포할 수 있도록 하십시오:

cd /opt/digna
mv digna digna_old
mv dashboard dashboard_old

digna_old는 업그레이드를 확인할 때까지, dashboard_old는 거기에서 구성 파일을 복원할 때까지 보관하십시오 (4단계 참조). 그 후에는 둘 다 삭제해도 됩니다.

3단계: 새 버전 압축 해제 및 배포¶

1. 새 digna 설치 ZIP 파일을 압축 해제합니다.
2. 새 digna 실행 파일과 dashboard 폴더를 설치 디렉터리에 복사합니다.
3. 실행 권한 비트를 복원하고, 필요한 경우 격리(quarantine) 속성을 제거합니다:

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

4단계: 구성 파일 복원¶

cp dashboard_old/dashboard_config.toml dashboard/dashboard_config.toml

릴리스 2026.11에서는 config.toml을 변경할 필요가 없습니다. 릴리스 2026.06에서 동작하는 파일은 계속 동작합니다. 다음 두 가지 변경은 선택 사항입니다:

• 데이터베이스 연결에서 digna Engine을 사용하고 그 기본값이 호스트에 맞지 않는 경우 [duckdb] 섹션을 추가합니다.
• 리버스 프록시가 대시보드와 백엔드를 하나의 오리진으로 제공하는 경우 [app] 섹션을 생략합니다.

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

5단계: 웹 서버 다시 로드¶

대시보드는 정적 파일의 집합이므로, 웹 서버와 브라우저가 여전히 이전 버전을 제공하고 있을 수 있습니다. dashboard 폴더를 호스팅하는 웹 서버를 다시 로드하거나 재시작한 다음, 강력 새로 고침(Cmd+Shift+R)으로 페이지를 다시 로드하십시오.

6단계: 구성 검증¶

리포지터리를 건드리기 전에 config.toml이 완전한지 확인하십시오:

./digna config check

모든 섹션이 OK로 보고되어야 합니다. FAILED로 보고된 항목을 모두 수정하고 Unknown keys 아래에 나열된 키를 제거한 다음, 계속하기 전에 명령을 다시 실행하십시오.

7단계: 라이선스 파일 교체¶

라이선스 파일은 보통 한 릴리스에서 다음 릴리스로 그대로 이어집니다. 릴리스 2026.11은 예외입니다. 이 릴리스는 라이선스가 필요한 두 모듈, digna Data Reconciliation과 digna Agentic을 추가하며, 2026.11 이전에 발급된 라이선스에는 이 모듈들이 포함되어 있지 않습니다. digna 팀이 릴리스 2026.11용으로 제공한 license.toml을 설치 디렉터리에 복사하여 기존 파일을 교체하십시오:

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

./digna license check

8단계: 저장소 스키마 업그레이드¶

digna 설치 디렉터리에서 다음을 실행하십시오:

cd /opt/digna
./digna repo upgrade

릴리스 2026.11은 버전이 지정된 마이그레이션으로 저장소 스키마를 관리합니다. 이전 릴리스에서 처음 업그레이드할 때는 스키마를 이전 방식의 마지막 버전으로 올리고, 이를 시작점으로 기록한 다음, 릴리스 2026.11의 마이그레이션을 적용합니다. 다음 메시지로 완료됩니다:

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

기존 데이터는 모두 보존됩니다. 언제든지 ./digna repo check를 실행하면 저장소 상태를 확인할 수 있으며, 마지막으로 적용된 마이그레이션과 대기 중인 마이그레이션이 나열됩니다.

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

9단계: 서비스 재시작¶

백그라운드 서비스로 실행 중인 경우:

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

수동으로 실행 중인 경우 서버를 재시작하십시오:

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

nginx 또는 Apache를 사용하는 경우 해당 웹 서버를 재시작하십시오:

brew services restart nginx

sudo apachectl restart

10단계: 업그레이드 확인¶

1. 새 실행 파일의 릴리스를 확인합니다:

   ./digna version
   

   첫 번째 줄이 Release: 2026.11이어야 합니다.

2. digna 대시보드에 접속하여 인터페이스가 올바르게 로드되는지 확인합니다.

3. 서버 출력과 logs 디렉터리의 파일에 오류가 있는지 확인합니다.
4. 데이터베이스 연결을 테스트합니다. 참조: 연결 테스트. 릴리스 2026.06 이전 릴리스에서 업그레이드한 경우 먼저 아직 ODBC를 사용하지 않던 모든 연결을 ODBC로 전환하십시오.

새 모듈을 시작하려면 digna Data Reconciliation, digna MCP Server에 대해서는 AI 에이전트 연결, digna Engine에 대해서는 프로파일링 위치를 참조하십시오.