digna 릴리스 2026.06용 Linux 설치 가이드¶

릴리스: 2026.06

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

목차¶

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

소개¶

digna 소개¶

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

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

• dignabackend: 데이터 처리 및 품질 검사를 수행하는 애플리케이션의 핵심 엔진입니다.
• dignadashboard: 웹 서버에 호스팅되는 웹 기반 인터페이스로, digna 플랫폼과 상호작용하고 데이터 품질 지표를 시각화하는 사용자 친화적인 방법을 제공합니다.

릴리스 2026.06의 새로운 기능¶

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

Windows나 macOS용 가이드를 찾고 계신가요?¶

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

이 가이드는 어떤 배포판을 다루나요?¶

지침은 가장 일반적인 두 서버 계열을 기준으로 작성되었습니다. 두 계열이 다를 때는 두 가지 명령을 모두 제시합니다:

• Debian 계열 — Debian, Ubuntu. 패키지 관리자: apt.
• RHEL 계열 — Red Hat Enterprise Linux, Rocky Linux, AlmaLinux, Fedora. 패키지 관리자: dnf.

systemd를 사용하는 현대적인 배포판이면 모두 동작합니다. 변경되는 것은 패키지 이름과 일부 구성 경로뿐입니다.

시스템 요구사항¶

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

데이터베이스 설치 옵션¶

PostgreSQL이 이미 설치된 경우: 기존 PostgreSQL 서버에 digna용 새 데이터베이스를 추가하면 됩니다.

digna와 같은 머신에 PostgreSQL을 설치하는 경우:

배포판 및 아키텍처 확인¶

이 가이드의 여러 명령은 Debian과 RHEL 계열 간에 다릅니다. 자신의 시스템이 어느 계열인지 확인하려면 다음을 실행하십시오:

cat /etc/os-release
uname -m

• ID=ubuntu 또는 ID=debian — apt 명령을 사용하십시오.
• ID=rhel, rocky, almalinux 또는 fedora — dnf 명령을 사용하십시오.
• x86_64 또는 aarch64 — 설치 패키지에 맞는 아키텍처입니다.

사전 설치 준비¶

digna를 설치하기 전에 두 가지 주요 전제 조건이 준비되어 있는지 확인하십시오:

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

이 구성 요소들이 아직 설정되지 않았다면 아래 섹션을 따라 설치하고 구성하십시오.

패키지 인덱스 갱신¶

설치하기 전에 패키지 목록을 업데이트하십시오:

sudo apt update

sudo dnf check-update

PostgreSQL 서버 설정¶

PostgreSQL이 이미 있는 경우¶

PostgreSQL이 로컬 머신에 이미 설치되어 실행 중이거나 관리되는 원격 PostgreSQL 서버를 사용 중이라면, 다음 섹션으로 건너뛸 수 있습니다.

PostgreSQL 설치¶

1단계: 서버 패키지 설치¶

sudo apt install -y postgresql postgresql-contrib

sudo dnf install -y postgresql-server postgresql-contrib

2단계: 데이터베이스 클러스터 초기화¶

Debian 계열에서는 패키지가 자동으로 클러스터를 생성하고 시작합니다 — 다음 단계로 건너뛰십시오.

RHEL 계열에서는 클러스터를 명시적으로 생성해야 합니다:

sudo postgresql-setup --initdb

3단계: 서비스 시작 및 활성화¶

sudo systemctl enable --now postgresql

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

4단계: 설치 확인¶

psql --version
sudo systemctl status postgresql

PostgreSQL 버전과 active (running) 상태를 확인할 수 있어야 합니다.

5단계: 서버에 접속¶

Linux PostgreSQL 패키지는 클러스터를 소유한 postgres 시스템 계정을 생성합니다. 해당 계정으로 접속하십시오:

sudo -u postgres psql

6단계: 포트 확인¶

기본 PostgreSQL 포트는 5432입니다. 서버가 어떤 포트를 리스닝하는지 확인하려면:

sudo -u postgres psql -c "SHOW port;"

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

7단계: digna 사용자를 위한 비밀번호 인증 활성화¶

digna는 TCP로 digna_user 계정으로 PostgreSQL에 연결하므로 peer 인증이 아닌 비밀번호 인증이 필요합니다. pg_hba.conf가 이를 허용하는지 확인하십시오.

파일 위치 확인:

sudo -u postgres psql -c "SHOW hba_file;"

편집기로 열어 로컬 TCP 라인이 ident 대신 scram-sha-256(또는 오래된 서버에서는 md5)을 사용하도록 확인하십시오:

# TYPE  DATABASE  USER  ADDRESS         METHOD
host    all       all   127.0.0.1/32    scram-sha-256
host    all       all   ::1/128         scram-sha-256

변경 후 PostgreSQL을 다시 로드하십시오:

sudo systemctl reload postgresql

8단계: PostgreSQL이 다른 머신에서 실행되는 경우¶

다른 호스트의 연결을 허용하려면 postgresql.conf에서 listen_addresses를 설정하고 pg_hba.conf에 해당 네트워크에 맞는 host 라인을 추가하십시오:

listen_addresses = '*'

그런 다음 방화벽에서 포트를 열고 서비스를 재시작하십시오:

sudo ufw allow 5432/tcp

sudo firewall-cmd --permanent --add-port=5432/tcp && sudo firewall-cmd --reload

sudo systemctl restart postgresql

웹 서버 구성¶

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

• nginx — 경량이며 권장
• Apache httpd — 널리 배포된 대안

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

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

• 단일 페이지 애플리케이션 폴백 — 대시보드 URL을 새로고침해도 404가 발생하지 않도록 함
• .md MIME 타입 — 마크다운 파일을 올바르게 제공하기 위함

nginx 설정¶

개요¶

nginx는 정적 digna 대시보드를 제공하기에 적합한 경량 고성능 웹 서버입니다.

설치¶

sudo apt install -y nginx

sudo dnf install -y nginx

nginx 시작¶

sudo systemctl enable --now nginx

설치 확인¶

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

방화벽 열기¶

서버가 다른 머신에서 접근된다면 HTTP 트래픽을 허용하십시오:

sudo ufw allow 'Nginx Full'

sudo firewall-cmd --permanent --add-service=http && sudo firewall-cmd --reload

대시보드용 사이트 구성¶

nginx는 두 배포판 계열 모두에서 conf.d 디렉토리의 모든 파일을 포함합니다. digna 전용 구성 파일을 생성하십시오:

sudo nano /etc/nginx/conf.d/digna.conf

다음 내용을 붙여넣고 /opt/digna/dashboard를 추출한 실제 dashboard 폴더 경로로 바꾸십시오:

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

기본 사이트 비활성화¶

포트의 default_server가 될 수 있는 서버 블록은 하나뿐입니다. Debian 계열에서는 패키지로 제공된 기본 페이지를 제거하여 충돌을 방지하십시오:

sudo rm /etc/nginx/sites-enabled/default

RHEL 계열에서는 /etc/nginx/nginx.conf 내부의 server { ... } 블록을 주석 처리하거나 삭제하십시오.

구성 적용¶

구문 오류가 있는지 구성 테스트를 실행한 후 nginx를 다시 로드하십시오:

sudo nginx -t
sudo systemctl reload nginx

Apache httpd 설정¶

개요¶

Apache httpd는 지원되는 모든 배포판의 기본 저장소에서 사용할 수 있습니다. 패키지 이름은 Debian 계열에서는 apache2이고 RHEL 계열에서는 httpd입니다.

설치¶

sudo apt install -y apache2

sudo dnf install -y httpd

Apache 시작¶

sudo systemctl enable --now apache2

sudo systemctl enable --now httpd

설치 확인¶

1. 브라우저를 엽니다.
2. http://localhost로 접속합니다.
3. 배포판의 기본 Apache 페이지가 표시되어야 합니다.

필수: mod_rewrite 활성화¶

대시보드는 URL 재작성(rewrite)을 필요로 합니다.

Debian 계열에서는 모듈을 활성화하고 재시작하십시오:

sudo a2enmod rewrite
sudo systemctl restart apache2

RHEL 계열에서는 mod_rewrite가 기본으로 로드됩니다. 확인하려면:

httpd -M | grep rewrite

필수: .htaccess 재정의 허용¶

문서 루트에 대한 구성 파일을 엽니다:

sudo nano /etc/apache2/apache2.conf

sudo nano /etc/httpd/conf/httpd.conf

문서 루트(/var/www/html — 두 계열 모두 해당)를 포함하는 <Directory> 블록을 찾아 다음을 변경하십시오:

AllowOverride None

다음과 같이 변경:

AllowOverride All

필수: 마크다운 파일용 MIME 타입¶

같은 파일에 마크다운 파일이 제대로 제공되도록 다음 줄을 추가하십시오:

AddType text/markdown .md

구성 적용¶

구문 오류를 검사한 후 Apache를 재시작하십시오:

sudo apachectl configtest
sudo systemctl restart apache2

sudo apachectl configtest
sudo systemctl restart httpd

초기 설치¶

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;

쉘에서 한 번에 실행하려면:

sudo -u postgres psql

그런 다음 postgres=# 프롬프트에 위 명령들을 붙여넣고 \q로 종료하십시오.

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

1. 제공된 digna 설치 ZIP 파일을 찾습니다.
2. 원하는 설치 위치(예: /opt/digna)에 압축을 풉니다.
3. 압축을 풀면 다음 항목들이 보여야 합니다:
4. dashboard/ — 웹 대시보드 인터페이스
5. digna — 메인 실행 파일(백엔드 + CLI 결합)
6. config.toml — 구성 파일
7. license.toml — 라이선스 파일(제공된 파일을 복사)

셸에서 압축을 풀려면:

sudo mkdir -p /opt/digna
sudo unzip digna-2026.06-linux-x86_64.zip -d /opt/digna

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

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

cd /opt/digna
sudo chmod +x digna

서비스 계정 생성¶

백엔드를 전용 비권한 사용자로 실행하는 것이 프로덕션 배포에 권장됩니다:

sudo useradd --system --no-create-home --shell /usr/sbin/nologin digna
sudo chown -R digna:digna /opt/digna

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

1. 제공된 license.toml 파일을 찾으십시오.
2. 이를 digna 설치 루트 디렉터리( config.toml과 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
sudo mv config_template.toml config.toml

위치: /opt/digna/config.toml

텍스트 편집기로 config.toml을 열고 아래 각 섹션을 구성하십시오.

[app] 섹션¶

이 섹션은 digna 백엔드 애플리케이션 설정을 구성합니다:

[app]
digna_APP_HOST = "localhost"
digna_APP_PORT = 8082
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!"

sudo chown digna:digna /opt/digna/config.toml
sudo chmod 600 /opt/digna/config.toml

[base] 섹션¶

이 섹션에는 보안 및 쿠키 설정이 포함됩니다:

[base]
digna_FERNET_KEY = "your-fernet-key"
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

[logging] 섹션¶

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

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10

2단계: 저장소 초기화¶

1. 터미널을 엽니다.
2. digna 설치 디렉터리( config.toml 및 digna 실행 파일이 있는 곳)로 이동합니다.
3. 연결 테스트를 실행하십시오:

cd /opt/digna
./digna repo check

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

sudo ln -s /opt/digna/digna /usr/local/bin/digna

3단계: 저장소 스키마 설치¶

같은 디렉터리에서 다음을 실행하십시오:

./digna repo install

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

4단계: 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

sudo ufw allow 8082/tcp

sudo firewall-cmd --permanent --add-port=8082/tcp && sudo firewall-cmd --reload

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

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

./digna user add <username> "<full_name>" <password> --su

예시:

./digna user add admin "Admin User" 'AdminPassword123!' --su

이 명령은 admin 사용자 이름의 전체 관리자 권한을 가진 사용자를 생성합니다.

대시보드 구성¶

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

digna 대시보드는 dashboard/ 디렉터리에 별도의 config.toml 파일을 가지고 있습니다. 초기 설정에서는 이미 제공되어 있으므로 변경할 필요는 없습니다. 백엔드 연결을 사용자 지정해야 하는 경우에만 구성하십시오.

대시보드 구성이 필요하다면 대시보드 문서를 참조하십시오.

웹 서버를 선택하고 해당 배포 단계를 따르십시오.

nginx에 배포¶

nginx 설정을 따른 경우 서버 블록이 이미 dashboard 폴더를 가리키므로 복사가 필요 없습니다.

1. 경로 확인
2. /etc/nginx/conf.d/digna.conf를 엽니다.

3. root가 추출된 dashboard 폴더를 가리키는지 확인합니다.

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

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

5. nginx 다시 로드

   sudo nginx -t
   sudo systemctl reload nginx
   

6. 설치 테스트

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

Apache httpd에 배포¶

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

   sudo cp -R /opt/digna/dashboard /var/www/html/digna
   

2. 리라이트 규칙 추가

대시보드 경로가 브라우저 새로고침 시 유지되도록 배포된 폴더 안에 .htaccess 파일을 생성합니다:

sudo nano /var/www/html/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 systemctl restart apache2
   

   sudo systemctl restart httpd
   

2. 대시보드 접속

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

2단계: SELinux (RHEL 계열 전용)¶

RHEL, Rocky, AlmaLinux 및 Fedora에서는 기본적으로 SELinux가 활성화되어 웹 서버가 예상 위치 외부의 파일을 읽지 못하도록 차단할 수 있습니다. SELinux가 활성화되어 있는지 확인하십시오:

getenforce

결과가 Enforcing이고 /opt/digna/dashboard에서 대시보드를 제공하는 경우, 웹 서버가 해당 디렉터리를 읽을 수 있도록 라벨을 지정하십시오:

sudo semanage fcontext -a -t httpd_sys_content_t "/opt/digna/dashboard(/.*)?"
sudo restorecon -Rv /opt/digna/dashboard

digna를 systemd 서비스로 실행하기¶

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

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

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

서비스 관리 파일¶

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

사용 가능한 셸 스크립트는 다음과 같습니다:

• install_service.sh — digna를 systemd에 등록합니다.
• uninstall_service.sh — 서비스를 등록 취소합니다.
• start_service.sh — 등록된 서비스를 시작합니다.
• stop_service.sh — 실행 중인 서비스를 중지합니다.

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

압축 해제 시 실행 권한이 보존되지 않을 수 있습니다. 처음 사용 전에 다음을 실행하십시오:

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

서비스 설치¶

1. 터미널을 엽니다.

2. bin 폴더로 이동

   cd /opt/digna/bin
   

3. 설치 스크립트 실행

   sudo ./install_service.sh
   

이제 digna 서버가 systemd에 자동 시작으로 등록됩니다. 서비스는 즉시 시작되지 않습니다 — 다음 섹션을 참조하여 시작하십시오.

서비스 시작 및 중지¶

서비스를 시작하려면¶

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

   sudo ./start_service.sh
   

서비스를 중지하려면¶

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

   sudo ./stop_service.sh
   

systemctl로 서비스 관리¶

등록된 후에는 어느 디렉터리에서나 표준 systemd 명령으로 서비스를 제어할 수 있습니다:

sudo systemctl start digna
sudo systemctl stop digna
sudo systemctl restart digna
sudo systemctl status digna

서비스 확인¶

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

systemctl is-enabled digna
systemctl is-active digna

enabled이면 부팅 시 시작되며; active이면 현재 실행 중임을 의미합니다.

서비스 로그 보기¶

systemd는 백엔드가 콘솔에 출력하는 모든 내용을 캡처합니다. 로그를 확인하려면:

sudo journalctl -u digna -n 100

문제를 재현하면서 실시간으로 로그를 따라가려면:

sudo journalctl -u digna -f

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

유닛 파일은 실행 파일의 절대 경로를 저장하므로 설치를 이동하면 서비스를 재등록해야 합니다:

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 서버가 systemd에서 등록 해제됩니다.

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

업그레이드 전에¶

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

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

쉘에서 백업을 생성하려면:

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

업그레이드 절차¶

1단계: digna 서비스 중지¶

digna가 systemd 서비스로 실행 중이면 먼저 중지하십시오:

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

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

2단계: 현재 백엔드 설치 백업¶

digna 설치 디렉터리에서:

cd /opt/digna
sudo mv digna digna_old

sudo mv dashboard dashboard_old

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

1. 새 digna 설치 ZIP 파일을 압축 해제합니다.
2. 새 digna 실행 파일과 dashboard 폴더를 설치 디렉터리에 복사합니다.
3. 실행 권한 비트와 서비스 계정 소유권을 복원합니다:

sudo chmod +x /opt/digna/digna
sudo chown -R digna:digna /opt/digna

4단계: 구성 파일 복원¶

sudo cp dashboard_old/dashboard_config.toml dashboard/dashboard_config.toml

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

digna 설치 디렉터리로 이동하여 다음을 실행하십시오:

cd /opt/digna
./digna repo upgrade

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

6단계: 서비스 재시작¶

systemd 서비스로 실행 중이라면:

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

수동으로 실행 중이었다면 서버를 다시 시작하십시오:

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

nginx 또는 Apache를 사용하는 경우 해당 웹 서버를 다시 로드하십시오:

sudo systemctl reload nginx

sudo systemctl restart apache2

RHEL 계열에서는 dashboard 디렉터리를 교체한 경우 SELinux 라벨을 다시 적용하십시오:

sudo restorecon -Rv /opt/digna/dashboard

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

1. digna 대시보드에 접속합니다.
2. 인터페이스가 올바르게 로드되는지 확인합니다.
3. 서버 로그에 오류가 없는지 확인합니다:

sudo journalctl -u digna -n 100