macOS용 digna 설치 안내 Release 2026.06¶

릴리스: 2026.06

최종 업데이트: 2026년 9월 5일

목차¶

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

소개¶

digna에 관하여¶

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

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

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

Release 2026.06의 변경 사항¶

이번 릴리스는 데이터 관찰 가능성(data observability) 기능을 코드 안으로 직접 제공하여 개발자가 소스에서 데이터 품질을 모니터링할 수 있게 합니다. 전체 내용은 릴리스 노트를 참조하세요.

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.06-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] 섹션¶

이 섹션은 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 = ["*"]

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

[base] 섹션¶

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

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

[encryption] 섹션¶

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

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

[logging] 섹션¶

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

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10

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

Overall: OK

FAILED로 보고된 모든 항목을 수정한 뒤, 계속하기 전에 명령을 다시 실행하십시오. 전체 옵션 목록은 CLI 참조에 있습니다.

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

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

cd /opt/digna
./digna repo check

연결이 설정되었다는 확인 메시지가 표시되어야 합니다(리포지토리 자체는 아직 초기화되지 않았습니다).

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

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

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

./digna repo install

이 명령은 PostgreSQL 데이터베이스에 필요한 테이블과 스키마를 설치합니다.

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

1. 새로운 터미널 창을 엽니다.
2. digna 설치 디렉터리로 이동합니다.
3. 관리자 사용자를 생성하려면 다음 명령을 실행하세요:

./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 - --port — 서버 포트

다음과 같은 시작 메시지가 표시되어 서버가 실행 중임을 확인할 수 있습니다:

INFO:     Started server process [1234]
INFO:     Waiting for application startup.
INFO:     Application startup complete
INFO:     Uvicorn running on http://localhost: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부터 digna는 모든 소스 기술에 ODBC로 접근합니다. 이전 릴리스에서는 기술별 전용 드라이버와 ODBC 중에서 Use ODBC 스위치로 선택할 수 있었습니다. digna 팀은 오직 ODBC만을 기반으로 삼기로 결정했습니다. 단일 표준 인터페이스가 맞춤 제작된 드라이버 모음보다 더 많은 것을 제공하기 때문입니다:

• 인증 — 인증은 ODBC의 일부이므로 연결은 해당 드라이버가 지원하는 모든 방식을 사용할 수 있습니다. 암호, 토큰과 PAT, Kerberos와 Active Directory, MFA와 브라우저 기반 싱글 사인온, 클라우드 ID, 클라이언트 인증서, TLS 등입니다. 새로운 방식은 digna 릴리스를 기다릴 필요 없이 드라이버 업데이트와 함께 제공됩니다.
• 데이터베이스 공급업체가 관리하는 드라이버 — 공급업체의 드라이버가 새 서버 버전과 보안 수정 사항을 따라가며, digna와 무관하게 원하는 일정에 맞춰 업데이트할 수 있습니다.
• 모든 것을 구성하는 단일한 방식 — 모든 기술이 키/값 속성 목록이며, 동일한 인터페이스, 동일한 민감 값 암호화, 동일한 문제 해결 방식을 사용합니다. 소스마다 다른 입력 필드 묶음이 필요하지 않습니다.
• 조정과 적용 범위 — 타임아웃, TLS 설정, 프록시, 페치 크기 같은 드라이버 수준 옵션을 모든 소스에서 사용할 수 있으며, 호환되는 ODBC 드라이버가 있는 기술이라면 digna가 전용 안내서를 제공하지 않는 것까지 포함해 연결할 수 있습니다.

실제로 이는 Use ODBC 스위치와 호스트, 포트, 데이터베이스, 사용자, 암호의 개별 필드가 더 이상 존재하지 않는다는 뜻입니다. 아직 ODBC를 사용하지 않는 모든 연결은 ODBC로 전환해야 합니다 — 자동 변환은 없으므로 업그레이드 전에 계획하십시오:

1. 설치에 정의된 각 데이터베이스 연결을 검토하고 아직 ODBC를 사용하지 않는 것을 적어 두십시오. 각각 다시 구성해야 합니다.
2. 해당 ODBC 드라이버를 digna 호스트에 설치하십시오. 연결은 브라우저가 아니라 digna 백엔드를 실행하는 서버에서 열립니다. 참조: digna 호스트에 ODBC 드라이버 설치.
3. 영향을 받는 각 연결의 ODBC 속성을 준비해 두십시오. 기술별 안내서에는 소스마다 검증된 속성 모음이 실려 있습니다.

업그레이드 후 영향을 받은 각 연결을 ODBC로 전환하고 대시보드에서 테스트하십시오. 참조: 데이터베이스 연결 만들기 및 연결 테스트.

digna 리포지토리 백업은 필수입니다

업그레이드하기 전에 데이터 손실을 방지하기 위해 리포지토리(PostgreSQL)를 백업하세요. 백업은 업그레이드 중 문제가 발생할 경우 복구할 수 있게 해줍니다.

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

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

업그레이드 절차¶

1단계: digna 서비스 중지¶

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

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

포그라운드에서 실행 중이면 해당 터미널 창에서 Ctrl + C를 누르세요.

2단계: 현재 설치 백업¶

digna 설치 디렉터리에서 새 릴리스를 나란히 배포할 수 있도록 현재 설치의 폴더 이름을 변경하십시오:

cd /opt/digna
mv dignabackend dignabackend_old

mv dignacli dignacli_old

mv dashboard dashboard_old

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

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

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

4단계: 구성 파일 복원¶

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'

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

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

6단계: 구성 검증¶

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

./digna config check

모든 섹션이 OK로 보고되어야 합니다. FAILED로 보고된 모든 항목을 수정하고, 계속하기 전에 명령을 다시 실행하십시오.

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

각 릴리스는 별도로 라이선스가 부여됩니다. digna 팀이 이 릴리스용으로 제공한 license.toml을 설치 디렉터리에 복사하여 기존 파일을 교체하십시오:

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

./digna license check

8단계: 리포지토리 스키마 업그레이드¶

digna 설치 디렉터리로 이동하여 다음을 실행하세요:

cd /opt/digna
./digna repo upgrade

이 명령은 기존 데이터를 보존하면서 PostgreSQL 스키마를 최신 버전으로 업데이트합니다.

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 대시보드에 접속합니다.
2. 인터페이스가 정상적으로 로드되는지 확인합니다.
3. 서버 로그에서 오류가 있는지 확인합니다.
4. 아직 ODBC를 사용하지 않던 모든 연결을 ODBC로 전환한 다음 모든 연결을 테스트하십시오. 참조: 연결 테스트