digna 릴리스 2026.11용 Windows 설치 안내¶

릴리스: 2026.11

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

목차¶

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

소개¶

digna에 대하여¶

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

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

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

릴리스 2026.11의 주요 변경 사항¶

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

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

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

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

시스템 요구사항¶

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

데이터베이스 설치 옵션¶

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

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입니다. 필요에 따라 기본값을 사용하거나 다른 포트를 지정할 수 있습니다.

7단계: 로케일 선택¶

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

8단계: 설치 완료¶

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

9단계: 설치 확인¶

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

psql --version

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

웹 서버 구성¶

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

• Internet Information Services (IIS)
• Apache Tomcat

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

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

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 환영 페이지가 표시되어야 함

초기 설치¶

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 포함)

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

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

이 섹션은 대시보드와 백엔드 간의 교차 출처 리소스 공유(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 = "C:\\path\\to\\digna\\tmp"

mkdir C:\path\to\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. config.toml 및 digna 실행 파일이 있는 digna 설치 디렉터리로 이동
3. 연결 테스트 실행:

digna repo check

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

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

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

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

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

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에서 설명하며, 이 파일이 필요한 곳도 바로 그곳입니다. 이 파일에는 대시보드가 제공하는 로그인 옵션과, 다중 인스턴스 배포의 경우 백엔드 연결 정보가 담깁니다.

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

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 하위 명령을 통해 관리합니다. 실행할 배치 파일은 없습니다.

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

서비스 설치¶

1. 관리자 권한으로 명령 프롬프트 열기
2. 명령 프롬프트 오른쪽 클릭

3. "관리자 권한으로 실행(Run as Administrator)" 선택

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

   cd C:\path\to\digna
   

5. 서비스 등록

   digna windows install
   

digna windows install --address 0.0.0.0 --port 8082

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

설치 옵션¶

서비스 시작 및 중지¶

서비스를 시작하려면¶

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 설치를 릴리스 2026.11로 업그레이드합니다. 설치가 그보다 오래된 경우 먼저 릴리스 2026.06 이전 릴리스에서 업그레이드를 읽으십시오.

업그레이드 전에¶

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

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

릴리스 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 C:\path\to\digna
digna windows stop

서비스 등록은 그대로 유지됩니다. 새 실행 파일이 같은 디렉터리에서 이전 실행 파일을 대체하므로 등록은 계속 올바른 파일을 가리킵니다.

digna가 포그라운드에서 실행 중이면 해당 명령 프롬프트 창에서 Ctrl+C를 누르십시오.

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

2단계: 현재 설치 백업¶

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

cd C:\path\to\digna
ren digna.exe digna_old.exe
ren dashboard dashboard_old

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

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

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

4단계: 구성 파일 복원¶

copy 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 폴더를 호스팅하는 웹 서버를 다시 로드하거나 재시작한 다음, 강력 새로 고침(Ctrl+F5)으로 페이지를 다시 로드하십시오.

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을 설치 디렉터리에 복사하여 기존 파일을 교체하십시오:

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

digna license check

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

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단계: 서비스 재시작¶

digna가 Windows 서비스로 실행되는 경우 다시 시작하십시오:

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

릴리스 2026.06 이전 릴리스에서 업그레이드하면서 1단계에서 서비스 등록을 해제했다면, 먼저 digna 실행 파일로 서비스를 다시 등록하십시오:

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

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

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

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

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

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에 대해서는 프로파일링 위치를 참조하십시오.