콘텐츠로 이동

digna 릴리스 2026.06용 Windows 설치 안내

릴리스: 2026.06

최종 업데이트: 2026년 8월 30일


목차

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

소개

digna에 대하여

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

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

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

릴리스 2026.06의 주요 변경 사항

이번 릴리스는 코드 상에서 직접 데이터 관찰성(data observability) 기능을 제공하여 개발자가 소스에서 데이터 품질을 모니터링할 수 있도록 합니다. 자세한 내용은 release notes를 참조하세요.

macOS 또는 Linux용 안내서를 찾으시나요?

이 안내서는 Windows를 다룹니다. 다른 플랫폼은 macOS 설치 안내 또는 Linux 설치 안내를 참조하십시오.


시스템 요구사항

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

요구사항 사양
운영체제 Windows Server 또는 Windows 10/11
메모리 (최소 구성) 16 GB RAM
디스크 공간 10 GB 사용 가능 저장공간
데이터베이스 PostgreSQL Server 12 이상
웹 서버 IIS, Apache Tomcat 또는 동등한 서버

데이터베이스 설치 옵션

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

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

권장 사양

  • 메모리: 32 GB RAM (기본 16 GB 대신)
  • 디스크 공간: 50 GB 사용 가능 저장공간 (기본 10 GB 대신)

이 사양 증가는 digna와 PostgreSQL 데이터베이스가 동시에 실행될 때를 고려한 권장사항입니다.


사전 설치 준비

digna를 설치하기 전에 다음 두 가지 핵심 전제 조건이 준비되어 있는지 확인하세요:

  1. PostgreSQL 서버 – 계산된 메트릭 및 성능 데이터를 저장하기 위함
  2. 웹 서버 – digna Dashboard를 호스팅하기 위함

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


PostgreSQL 서버 설정

이미 PostgreSQL이 설치되어 있는 경우

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

PostgreSQL 설치

Windows에 PostgreSQL을 설치하려면 다음 단계를 따르세요:

1단계: PostgreSQL 다운로드

  1. PostgreSQL Downloads 페이지로 이동
  2. Windows 선택
  3. 최신 설치 프로그램 다운로드

2단계: 설치 프로그램 실행

  1. 다운로드한 설치 프로그램 파일을 더블클릭
  2. 설치 마법사의 안내를 따름

3단계: 설치 디렉터리 선택

PostgreSQL이 설치될 디렉터리를 선택합니다. 기본 위치가 일반적으로 적합합니다.

4단계: 구성요소 선택

표준 설정의 경우 기본 구성요소 옵션을 유지합니다.

5단계: PostgreSQL 슈퍼유저 암호 설정

PostgreSQL 슈퍼유저(postgres)의 암호를 입력하고 확인합니다. 이 암호를 안전하게 보관하세요 — 나중에 필요합니다.

6단계: 포트 번호 구성

기본 PostgreSQL 포트는 5432입니다. 필요에 따라 기본값을 사용하거나 다른 포트를 지정할 수 있습니다.

팁

포트 5432가 이미 사용 중인 경우, 다른 포트를 선택하고 추후 구성 시 해당 포트를 기록해 두세요.

7단계: 로케일 선택

데이터베이스의 로케일을 선택합니다. 기본값은 대부분의 설치에 적합합니다.

8단계: 설치 완료

나머지 단계에서 다음을 클릭한 후 마침을 클릭합니다.

9단계: 설치 확인

명령 프롬프트를 열고 PostgreSQL이 설치되었는지 확인합니다:

psql --version

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


웹 서버 구성

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

이 중 하나의 서버만 설치 및 구성하면 됩니다.

IIS 설정

개요

Internet Information Services(IIS)는 웹사이트와 웹 애플리케이션을 호스팅하기 위한 Microsoft의 웹 서버입니다.

IIS 활성화

  1. 제어판 열기
  2. Win + R 누름
  3. control 입력 후 Enter

  4. Windows 기능으로 이동

  5. 프로그램 클릭
  6. Windows 기능 켜기/끄기 선택

  7. Internet Information Services 활성화

  8. 아래로 스크롤하여 Internet Information Services (IIS) 찾기
  9. 체크박스를 체크하여 활성화
  10. +를 클릭하여 아래 하위 구성요소가 선택되었는지 확인:

    • Web Management Tools
    • World Wide Web Services
  11. 확인(OK) 클릭하여 변경 사항 적용

  12. IIS 설치 확인

  13. 브라우저 열기
  14. http://localhost로 이동
  15. IIS 환영 페이지가 표시되어야 함

필수: URL Rewrite 모듈

IIS에는 URL Rewrite 구성요소가 필요합니다. 공식 Microsoft 페이지에서 다운로드하여 설치하세요.

필수: Markdown 파일용 MIME 타입

IIS가 Markdown 파일(.md)을 올바르게 제공하려면:

  1. IIS 관리자 열기 (Win + R, inetmgr 입력 후 Enter)
  2. 사이트 > MIME Types로 이동
  3. 추가(Add...) 클릭
  4. 구성:
  5. 파일 이름 확장자: .md
  6. MIME 타입: text/markdown

중요

이 설정이 없으면 .md 파일이 올바르게 서빙되지 않을 수 있습니다.


Apache Tomcat 설정

개요

Apache Tomcat은 오픈소스 Java 서블릿 컨테이너이자 웹 서버입니다.

설치

  1. Apache Tomcat 다운로드
  2. Apache Tomcat Downloads 방문
  3. Windows ZIP 배포판 다운로드

  4. 압축 해제

  5. ZIP 파일을 시스템의 디렉터리에 압축 해제
  6. 예: C:\Program Files\Apache Tomcat

  7. Tomcat 실행 확인

  8. 브라우저 열기
  9. http://localhost:8080로 이동
  10. Apache Tomcat 환영 페이지가 표시되어야 함

팁

Apache Tomcat은 일반적으로 설치 후 자동으로 시작됩니다. 시작되지 않으면 bin 폴더로 이동하여 startup.bat을 실행하세요.


초기 설치

1단계: digna 저장소 설정

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

저장소 스키마 및 사용자 생성

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

권장사항

데이터베이스 사용자에는 강력하고 복잡한 암호를 사용하세요. 쉽게 추측 가능한 자격증명은 피하십시오.


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

  1. 제공받은 digna 설치 ZIP 파일을 찾습니다
  2. 원하는 설치 위치로 압축을 풉니다
  3. 압축 해제 후 다음 항목들이 표시되어야 합니다:
  4. dashboard/ — 웹 대시보드 인터페이스
  5. digna — 메인 실행 파일(백엔드 + CLI 포함)

구성 파일과 라이선스 파일은 패키지에 포함되어 있지 않습니다

config.toml과 dashboard/dashboard_config.toml은 모두 설치 패키지에 포함되어 있지 않습니다. 두 파일은 백엔드 구성 및 대시보드 구성에서 직접 생성합니다. license.toml도 포함되어 있지 않으며, 3단계에서 설명하는 것처럼 digna가 별도로 제공합니다.

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

중요

라이선스 파일은 설치 패키지에 포함되어 있지 않으며 digna에서 별도로 제공됩니다.

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

이유: 라이선스 파일은 고객 정보, 라이선스 만료일 및 디지털 서명을 포함합니다. 이 파일을 수정하지 마세요 — 변경 시 라이선스가 무효화됩니다.

설정 후 디렉터리 구조:

digna_installation/
├── config.toml         (configuration file)
├── license.toml        (YOUR LICENSE FILE - copy here)
├── digna               (main executable)
└── dashboard/          (web interface)
    └── (dashboard files)

백엔드 구성

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

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

위치: digna_installation/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 = ["*"]
매개변수 값 비고
digna_APP_CORS_ALLOW_ORIGINS 프론트엔드 URL 대시보드가 다른 서버에 있는 경우 해당 URL 포함
digna_APP_CORS_ALLOW_CREDENTIALS true 자격증명 포함 CORS에 필요
digna_APP_CORS_ALLOW_METHODS ["*"] 모든 HTTP 메서드 허용
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!"
매개변수 값 비고
digna_REPO_HOST localhost 또는 IP PostgreSQL 서버 호스트명/IP
digna_REPO_PORT 5432 (기본) PostgreSQL 포트
digna_REPO_DB postgres 데이터베이스 이름
digna_REPO_SCHEMA dignarepo 앞서 생성한 스키마
digna_REPO_USER digna_user PostgreSQL 설정에서 생성한 사용자
digna_REPO_PASSWORD 비밀번호 스키마 생성 시 설정한 비밀번호

[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"
매개변수 값 비고
DIGNA_FERNET_KEY 암호화 키 토큰 및 쿠키 암호화에 사용 (기본값 제공)
digna_COOKIE_DOMAIN localhost 프론트엔드 도메인과 일치시킬 것
digna_COOKIE_SECURE false (로컬) / true (프로덕션) HTTPS 연결에서는 true 사용
digna_COOKIE_HTTPONLY true 보안을 위해 항상 활성화
digna_COOKIE_SAME_SITE lax CSRF 공격 방지
digna_TOKEN_EXPIRES_IN 86400 (24시간) 세션 타임아웃(초)
digna_MAX_WORKERS CPU 코어 수 - 1 병렬 검사 작업 수
DIGNA_SCHEDULER_MAX_DELAY 100 스케줄러가 예정된 작업을 시작하기 전에 추가할 수 있는 최대 지연 시간(초)
DIGNA_CLEANUP_TIME "12:00" 일일 정리가 시작되는 시각(24시간 형식 HH:MM)

[encryption] 섹션

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

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='
매개변수 값 메모
DIGNA_ENCRYPTION_KEY Base64로 인코딩된 키 digna 리포지터리에 저장된 민감한 값을 암호화합니다

config.toml 보호

이 키는 고정된 값으로 모든 digna 설치에서 동일하며, 리포지터리의 민감한 값을 복호화하는 것이 바로 이 키입니다. config.toml 접근을 digna를 실행하는 계정으로 제한하고, 버전 관리와 공유 드라이브에서 제외하며, 리포지터리 자체보다 덜 안전하게 보관되는 백업에서는 반드시 빼십시오.

[logging] 섹션

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

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10
매개변수 값 비고
digna_LOGGING_MODE INFO 또는 DEBUG 프로덕션에는 INFO, 문제 해결 시 DEBUG
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. config.toml 및 digna 실행 파일이 있는 digna 설치 디렉터리로 이동
  3. 연결 테스트 실행:
digna repo check

연결이 설정되었음을 확인하는 메시지가 표시되어야 합니다(아직 저장소 자체가 초기화되지는 않았습니다).

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

이렇게 하면 전체 관리자 권한을 가진 사용자가 생성됩니다.

권장사항

대문자, 소문자, 숫자 및 특수문자가 조합된 강력한 비밀번호를 사용하세요.


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

서버가 터미널을 점유합니다

serve는 포그라운드에서 실행되며 Ctrl+C로 중지할 때까지 계속 동작합니다. 설정을 마칠 때까지 실행 상태로 두십시오. 대신 부팅 시 자동으로 시작하려면 다음을 참조하십시오: digna를 Windows 서비스로 실행.

대시보드 구성

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

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

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

대시보드를 배포할 웹 서버를 선택하고 해당 배포 절차를 따르세요.

IIS에 배포

  1. IIS 관리자 열기
  2. Win + R 누름, inetmgr 입력 후 Enter

  3. 새 웹사이트 생성

  4. 왼쪽 패널에서 사이트(Sites) 우클릭
  5. 웹 사이트 추가(Add Website...) 선택

  6. 웹사이트 구성

  7. 사이트 이름: 이름 입력(예: "dignaDashboard")
  8. 물리적 경로(Physical Path): Browse를 클릭하고 dashboard 폴더 선택
  9. 바인딩(Binding): IP 주소 및 포트 설정(기본 HTTP 포트 80, HTTPS는 443)

  10. 웹사이트 시작

  11. 확인(OK) 클릭하여 사이트 생성
  12. 새로 생성된 사이트 우클릭 후 시작(Start) 선택

  13. 설치 테스트

  14. 브라우저 열기
  15. http://localhost(또는 구성한 URL)로 이동
  16. digna 대시보드 로그인 페이지가 표시되어야 함

Apache Tomcat에 배포

  1. 대시보드를 Tomcat에 복사
  2. dashboard 폴더를 Tomcat의 webapps 디렉터리에 복사
  3. 필요 시 이름 변경(예: digna)
  4. 예: C:\Program Files\Apache Tomcat\webapps\digna

  5. 배포 확인

  6. Tomcat 관리 페이지( http://localhost:8080 )를 새로고침하거나 다시 로드
  7. 배포된 애플리케이션 목록에 "digna"(또는 선택한 이름)가 표시되어야 함

  8. 대시보드 접근

  9. 브라우저 열기
  10. http://localhost:8080/digna로 이동
  11. digna 대시보드 로그인 페이지가 표시되어야 함

digna를 Windows 서비스로 실행하기

Windows 서비스를 사용하는 이유

digna 백엔드를 Windows 서비스로 실행하면 다음과 같은 이점이 있습니다: - 서버 부팅 시 자동으로 시작됨 - 열린 명령 프롬프트 없이 백그라운드에서 실행됨 - 충돌 시 자동으로 재시작 가능 - Windows 서비스 관리 도구를 통해 관리 가능

windows 명령

서비스는 digna 실행 파일 자체가 digna windows 하위 명령을 통해 관리합니다. 실행할 배치 파일은 없습니다.

명령 용도
digna windows install digna를 Windows 서비스로 등록
digna windows start 등록된 서비스를 시작
digna windows stop 실행 중인 서비스를 중지
digna windows uninstall 서비스 등록 해제

관리자 권한 필요

네 가지 명령은 모두 관리자 권한으로 연 명령 프롬프트에서 실행해야 합니다.

모든 명령은 --name을 받으므로 기본값이 아닌 이름으로 등록된 서비스도 지정할 수 있습니다. 전체 옵션 목록은 CLI 참조에 있습니다.

서비스 설치

  1. 관리자 권한으로 명령 프롬프트 열기
  2. 명령 프롬프트 오른쪽 클릭
  3. "관리자 권한으로 실행(Run as Administrator)" 선택

  4. digna 설치 디렉터리로 이동

    cd C:\path\to\digna
    

  5. 서비스 등록

    digna windows install
    

기본값이 적합하지 않다면 주소와 포트를 지정하십시오

install은 주소와 포트를 서비스 등록 정보에 기록하며, 서비스는 기록된 값에 정확히 바인딩합니다. 기본값은 127.0.0.1과 8000으로, 해당 머신 자체에서 오는 연결만 허용합니다. 다른 호스트에 있는 대시보드는 여기에 접근할 수 없으므로, 백엔드가 수신 대기할 주소를 지정하십시오:

digna windows install --address 0.0.0.0 --port 8082

이 값은 config.toml에서 읽지 않습니다. 나중에 변경하려면 서비스를 제거한 후 새 값으로 다시 설치하십시오.

서비스는 자동 시작으로 등록되므로 Windows와 함께 시작됩니다. 서비스는 즉시 시작되지 않습니다 — 다음 섹션을 참조하세요.

설치 옵션

옵션 기본값 용도
--name digna 서비스를 등록할 이름
--display-name digna services.msc에 표시되는 이름
--description digna data quality backend services.msc에 표시되는 설명
--address 127.0.0.1 서비스가 API를 바인딩할 주소
--port 8000 서비스가 API를 바인딩할 포트
--working-dir digna 실행 파일이 있는 디렉터리 config.toml과 license.toml이 있는 디렉터리로, 서비스는 이를 작업 디렉터리로 사용합니다
--start-type auto auto는 Windows와 함께 시작, manual은 요청할 때만 시작, disabled는 서비스를 등록하지만 시작을 거부합니다
--account LocalSystem 서비스를 실행할 계정, 예: DOMAIN\user 또는 .\user
--password --account의 암호

도메인 계정으로 실행하기

LocalSystem에는 네트워크 ID가 없으므로 SQL Server에 대한 Windows 인증과 네트워크 공유에 대한 모든 접근이 실패합니다. 서비스가 특정 사용자로 리소스에 접근해야 하는 경우 --account와 --password를 지정하여 설치하십시오.

서비스 시작 및 중지

서비스를 시작하려면

digna windows start

서비스를 중지하려면

digna windows stop

팁

애플리케이션 파일을 업데이트하기 전에 항상 서비스를 중지하세요.

서비스를 새 디렉터리로 이동하기

digna 설치 위치를 이동해야 하는 경우:

  1. 현재 서비스 중지 및 등록 해제

    cd C:\old\path\digna
    digna windows stop
    digna windows uninstall
    

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

  3. 전체 digna 설치 폴더를 새 위치로 이동

  4. 새 위치에서 서비스 다시 등록

    cd C:\new\path\digna
    digna windows install
    

처음에 사용한 --address, --port 또는 --account 값을 다시 지정하십시오 — 이전 등록 정보는 삭제되었습니다.

  1. 서비스 시작
    digna windows start
    

서비스 제거

  1. 실행 중인 서비스 중지

    cd C:\path\to\digna
    digna windows stop
    

  2. 서비스 등록 해제

    digna windows uninstall
    

이제 digna 서버는 Windows 서비스에서 등록 해제됩니다.


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

업그레이드 전

먼저 모든 데이터베이스 연결을 확인하십시오

릴리스 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로 전환하고 대시보드에서 테스트하십시오. 참조: 데이터베이스 연결 만들기 및 연결 테스트.

Databricks Legacy 연결

Databricks Legacy 커넥터는 이번 릴리스에서 제거되었습니다. 해당 연결은 Databricks 커넥터로 이전하십시오.

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

digna를 업그레이드하기 전에 저장소(PostgreSQL)를 백업하여 데이터 손실을 방지하세요. 백업이 있으면 업그레이드 중 문제가 발생했을 때 복구할 수 있습니다.

업그레이드 절차

1단계: 이전 서비스 중지 및 등록 해제

digna가 Windows 서비스로 실행 중인 경우 현재 설치의 배치 파일로 중지하십시오. digna windows 명령은 새 릴리스에 속하므로 아직 사용할 수 없습니다:

cd C:\path\to\digna\bin
stop_service.bat

그런 다음 역시 이전 배치 파일로 서비스 등록을 해제하십시오. 등록 정보는 이전 실행 파일과 그 스크립트를 가리키며, 이번 업그레이드에서 둘 다 교체되므로 재사용할 수 없습니다:

uninstall_service.bat

이름을 변경하기 전에 등록을 해제하십시오

uninstall_service.bat은 곧 이름을 변경할 bin 폴더에 있으며, 자신이 생성한 등록 정보를 제거할 수 있는 유일한 수단입니다. 이전 설치가 그대로 있는 동안 실행하십시오. 폴더의 이름을 이미 변경했다면 원래 이름으로 되돌리고 등록을 해제한 다음 계속하십시오.

서비스가 실행되던 계정과 서비스가 사용하던 주소 및 포트를 기록해 두십시오 — 9단계에서 필요합니다.

2단계: 현재 설치 백업

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

# Rename the folder containing dignabackend
ren dignabackend dignabackend_old
# Rename the folder containing dignacli
ren dignacli dignacli_old
# Rename dashboard
ren dashboard dashboard_old

dignabackend와 dignacli는 더 이상 사용되지 않습니다

릴리스 2026.06부터 dignabackend와 dignacli는 백엔드와 CLI를 통합한 단일 실행 파일 digna로 대체됩니다. dignabackend_old와 dignacli_old는 업그레이드를 확인할 때까지만 보관하고, 그 후에는 두 폴더 모두 삭제해도 됩니다. dashboard_old는 거기에서 구성 파일을 복원할 때까지 보관하십시오(4단계 참조). bin 폴더도 필요 없어집니다. 그 안의 배치 파일은 이전 서비스를 구동하던 것으로 2026.06에는 포함되지 않으므로, 1단계에서 서비스 등록을 해제한 뒤에는 혼란만 줄 뿐입니다.

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

  1. 새 digna 설치 ZIP 파일을 압축 해제
  2. 새 digna 실행 파일, dashboard 폴더를 설치 디렉터리에 복사

중요

config.toml과 dashboard/dashboard_config.toml은 모두 설치 ZIP에 절대 포함되지 않습니다. digna 팀은 두 파일 중 어느 것도 제공하지 않습니다. 따라서 기존 구성은 업그레이드의 영향을 받지 않으며, 이름이 변경된 *_old 폴더에 있는 사본이 유일한 사본입니다.

4단계: 구성 파일 복원

copy dashboard_old\dashboard_config.toml dashboard\dashboard_config.toml

릴리스 2026.06은 config.toml을 변경합니다

세 가지 설정이 새로 추가되어 필수가 되었고, 두 개는 더 이상 사용되지 않습니다. 이전 릴리스에서 가져온 config.toml에는 새 설정이 없으며, 이들이 없는 한 digna는 시작되지 않습니다. 기존 config.toml에 다음을 추가하십시오:

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

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

두 개의 [base] 키를 기존 [base] 섹션에 추가하고 [encryption]을 새 섹션으로 추가하십시오. 그런 다음 더 이상 사용되지 않는 두 설정 digna_APP_HOST와 digna_APP_PORT를 [app]에서 제거하십시오. 서버는 이제 주소와 포트를 digna serve에서 받습니다.

각 설정의 역할은 다음을 참조하십시오: 백엔드 구성.

Single Sign-On: [oidc_clients] 형식이 변경되었습니다

릴리스 2026.06은 테이블 배열을 공급자별 테이블 하나로 대체하며, 테이블 이름은 공급자 키를 따릅니다. DIGNA_OIDC_KEY는 없어졌습니다 — 키는 이제 섹션 헤더의 일부입니다.

이전:

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

공급자마다 이 섹션을 반복하고, 각 키를 dashboard_config.toml의 key와 동일하게 유지하십시오. 이전 형식이 남아 있는 동안 digna config check는 oidc_clients를 FAILED로 보고합니다. Single Sign-On을 사용하는 설치에만 해당됩니다.

5단계: 웹 서버 다시 로드

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

6단계: 구성 검증

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

digna config check

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

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

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

copy /Y C:\path\to\new\license.toml license.toml

이전 라이선스를 유지하지 마십시오

이전 릴리스용으로 발급된 license.toml은 이 릴리스에 적용되지 않으며, 라이선스를 검사하는 모든 명령(user, inspection, repo)은 검사에 실패하면 저장소에 접근하기 전에 중단됩니다. 계속하기 전에 라이선스를 확인하십시오:

digna license check

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

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

digna repo upgrade

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

9단계: 서비스 등록 및 시작

이전 등록 정보는 1단계에서 제거되었으므로 서비스를 다시 등록합니다. 이번에는 배치 파일이 없는 digna 실행 파일로 등록합니다:

cd C:\path\to\digna
digna windows install --address <address> --port <port>
digna windows start

새 기본값인 127.0.0.1과 8000을 사용하려는 경우가 아니라면 --address와 --port에 이전 서비스가 사용하던 값을 지정하십시오. 이 값은 등록 정보에 기록되며 더 이상 config.toml에서 읽지 않습니다. 이전 서비스가 도메인 계정으로 실행되었다면 --account와 --password를 추가하십시오. 전체 옵션 목록은 digna를 Windows 서비스로 실행하기를 참조하십시오.

수동으로 실행 중인 경우, 서버를 다시 시작하세요:

cd C:\path\to\digna
digna serve --address <address> --port <port>

IIS 또는 Tomcat을 사용하는 경우 해당 웹 서버를 재시작하세요.

10단계: 업그레이드 확인

  1. digna 대시보드에 접속
  2. 인터페이스가 올바르게 로드되는지 확인
  3. 서버 로그에서 오류가 있는지 확인
  4. 아직 ODBC를 사용하지 않던 모든 연결을 ODBC로 전환한 다음 모든 연결을 테스트하십시오. 참조: 연결 테스트