digna リリース 2026.06 の Linux インストールガイド¶

リリース: 2026.06

最終更新: 2026年9月5日

目次¶

1. はじめに
2. システム要件
3. 事前準備
4. PostgreSQL サーバーのセットアップ
5. Web サーバーの構成
6. 初回インストール
7. バックエンドの設定
8. ダッシュボードの設定
9. digna を systemd サービスとして実行する
10. 新しいリリースへのアップグレード

はじめに¶

digna について¶

digna は、ウェアハウス、データレイク、レイクハウスなど様々なデータ環境におけるデータ品質管理を最適化するために設計された包括的な AI 駆動プラットフォームです。高いスケーラビリティと適応性を備え、自動化、リアルタイム監視、および異常検知を通じて現代のデータ課題に対処します。

digna は主に次の2つのコンポーネントで構成されています:

• dignabackend: データ処理と品質チェックを担当するアプリケーションのコアエンジン
• dignadashboard: Web サーバー上でホストされる、digna プラットフォームとやり取りしデータ品質指標を可視化するための Web ベースのインターフェース

リリース 2026.06 の新機能¶

このリリースでは、データオブザーバビリティ機能をコードの中に直接取り込み、開発者がデータ品質をソースで監視できるようになりました。詳細は release notes を参照してください。

Windows や macOS をお探しですか？¶

本ガイドは Linux 向けです。他のプラットフォームについては、Windows インストールガイド または macOS インストールガイド を参照してください。

本ガイドはどのディストリビューション向けですか？¶

手順は、最も一般的なサーバーファミリ 2 種に対して書かれています。両者で差がある場合は両方のコマンドを記載しています:

• 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 をインストールする前に、次の 2 つの主要な前提条件が整っていることを確認してください:

1. PostgreSQL サーバー – 計算されたメトリクスやパフォーマンスデータを格納するため
2. Web サーバー – 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 は digna_user として TCP 経由で 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

Web サーバーの構成¶

digna はダッシュボードをホストするために Web サーバーを必要とします。次のオプションのいずれかを選択してください:

• nginx — 軽量で推奨
• Apache httpd — 広く採用されている代替

これらのうち いずれか一つ をインストールして構成すれば十分です。

両セクションともダッシュボードが依存する次の 2 つを構成します:

• シングルページアプリケーションのフォールバック — ダッシュボードの URL をリロードしても 404 が返らないようにする
• .md の MIME タイプ — Markdown ファイルを正しく配信するため

nginx のセットアップ¶

概要¶

nginx は静的な digna ダッシュボードの配信に適した軽量で高性能な Web サーバーです。

インストール¶

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

抽出した dashboard フォルダの実際のパスにある /opt/digna/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 であるサーバーブロックは 1 つだけにできます。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 書き換えを必要とします。

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

ドキュメントルートをカバーする <Directory> ブロック（両ファミリとも /var/www/html）を見つけ、次のように変更します:

AllowOverride None

を:

AllowOverride All

必須: Markdown ファイルの MIME タイプ¶

同じファイルに次の行を追加して、Markdown ファイルが正しく配信されるようにします:

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/ — Web ダッシュボードインターフェース
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: ダッシュボードを Web サーバーにデプロイする¶

digna ダッシュボードには dashboard/ ディレクトリ内に別の config.toml ファイルがあり、この構成は既に提供されています。初期セットアップでは変更は不要です。バックエンド接続をカスタマイズする必要がある場合にのみ編集してください。

ダッシュボード構成を変更する必要がある（例: マルチインスタンス展開）場合は、ダッシュボードのドキュメントを参照してください。

利用する Web サーバーを選び、該当するデプロイ手順に従ってください。

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 がデフォルトで enforcing になっており、Web サーバーが想定外の場所にあるファイルを読めないようブロックすることがあります。以下でアクティブか確認してください:

getenforce

結果が Enforcing で、ダッシュボードを /opt/digna/dashboard から配信している場合、Web サーバーが読み取れるようディレクトリにラベルを付けてください:

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