macOS インストールガイド（digna Release 2026.11）¶

リリース: 2026.11

最終更新日: 2026年11月7日

目次¶

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

導入¶

digna について¶

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

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

• digna: アプリケーションの中核であり、データの処理と品質チェックの実行を担います。バックエンドとコマンドラインインターフェイスを単一の実行ファイルに統合し、以前のリリースで別々だった dignabackend と dignacli を置き換えます。
• dignadashboard: Web サーバー上でホストされるウェブベースのインターフェースで、digna プラットフォームと対話し、データ品質指標を可視化するためのユーザーフレンドリーな画面を提供します

Release 2026.11 の新機能¶

このリリースでは、digna Data Reconciliation、digna MCP Server を備えた digna Agentic、そして digna Engine が追加されました。digna Engine は digna の内部でデータをプロファイリングし、異なるデータベース技術間の参照整合性をチェックできます。詳細はリリースノートを参照してください。

インストールに関しては、本リリースで新しいリポジトリのマイグレーション機構、digna Engine 用の config.toml のオプションの [duckdb] セクション、そして新しいライセンスファイルが導入されます。それぞれについてはアップグレードのセクションで説明します。

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

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

システム要件¶

インストールを開始する前に、システムが以下の最小要件を満たしていることを確認してください。

データベースのインストールオプション¶

PostgreSQL が既にインストールされている場合: 既存の PostgreSQL サーバーに digna 用の新しいデータベース（スキーマ）を追加できます。

digna と同じマシンに PostgreSQL をインストールする場合:

アーキテクチャの確認¶

このガイドのいくつかのパスは Apple Silicon と Intel の Mac で異なります。どちらのマシンかを確認するには、Terminal を開いて次を実行してください:

uname -m

• arm64 — Apple Silicon。Homebrew は /opt/homebrew にインストールされます。
• x86_64 — Intel。Homebrew は /usr/local にインストールされます。

事前準備¶

digna をインストールする前に、次の 3 つの主要な前提条件が整っていることを確認してください:

1. Homebrew – 本ガイドで以下のコンポーネントをインストールするためのパッケージマネージャ
2. PostgreSQL Server – 計算されたメトリクスやパフォーマンスデータを格納するため
3. Web サーバー – digna ダッシュボードをホストするため

これらのコンポーネントがまだセットアップされていない場合は、以下のセクションに従ってインストールおよび構成してください。

Homebrew のインストール¶

Homebrew は macOS の標準パッケージマネージャで、本ガイド全体で PostgreSQL や nginx をインストールするために使用します。

ステップ 1: Homebrew が既にインストールされているか確認する¶

Terminal を開き（Cmd + Space を押して Terminal を入力し、Enter）、次を実行します:

brew --version

バージョン番号が返ってきたら、PostgreSQL サーバーのセットアップ セクションへ進んでください。

ステップ 2: Homebrew をインストールする¶

コマンドが見つからない場合は、公式 Homebrew サイト の指示に従って Homebrew をインストールしてください。インストーラーは Xcode Command Line Tools をまだインストールしていない場合、それもインストールします。

ステップ 3: Homebrew を PATH に追加する¶

Apple Silicon では、インストーラーがシェル環境に Homebrew を追加するための 2 つのコマンドを表示します。指示に従ってそれらを実行し、次で確認してください:

brew --prefix

Apple Silicon では /opt/homebrew、Intel では /usr/local が表示されるはずです。

PostgreSQL サーバーのセットアップ¶

既に PostgreSQL をお使いの場合¶

ローカルマシンで PostgreSQL が既にインストールおよび稼働している、または管理されたリモート PostgreSQL サーバーを使用している場合は、次のセクションへ進んでください。

インストールの選択肢¶

macOS では PostgreSQL のインストール方法が二通りあります。どちらか一方を選んでください:

• Homebrew — コマンドラインでのインストール、サーバー展開に推奨
• Postgres.app — GUI ベースのインストール、ローカル評価に便利

Homebrew で PostgreSQL をインストールする¶

ステップ 1: PostgreSQL フォーミュラをインストール¶

brew install postgresql@16

ステップ 2: PostgreSQL を PATH に追加¶

バージョン付きの PostgreSQL フォーミュラは 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 をインストールする¶

GUI によるインストールを好む場合:

1. Postgres.app をダウンロードして Applications フォルダにドラッグします
2. アプリを開き Initialize をクリックして新しいサーバーを作成します
3. アプリの指示に従い、コマンドラインツールを PATH に追加します
4. インストールを確認します:

psql --version

Postgres.app も macOS のアカウント名を持つスーパーユーザーを作成します。

Web サーバーの設定¶

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

• nginx — Homebrew 経由でインストール、推奨
• Apache httpd — macOS に同梱

いずれか一方のサーバーだけをインストールして構成すれば十分です。

両方のセクションではダッシュボードが依存する以下の 2 点を設定します:

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

nginx のセットアップ¶

概要¶

nginx は軽量で高性能の Web サーバーで、静的な 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;

Terminal から一度に実行するには:

psql postgres

その後 postgres=# プロンプトに上記のステートメントを貼り付け、終了するには \q を入力してください。

ステップ 2: digna インストールパッケージの展開¶

1. 提供された digna インストール ZIP ファイルを見つけます
2. 希望するインストール場所（例: /opt/digna または ~/digna）に展開します
3. 展開後、以下のアイテムがあるはずです:
4. dashboard/ — Web ダッシュボードインターフェース
5. digna — メイン実行ファイル（バックエンド + CLI 統合）

Terminal から展開するには:

unzip digna-2026.11-macos.zip -d /opt/digna

実行可能ファイルに実行権を付与する¶

アーカイブの転送方法によっては、実行ビットが失われることがあります。明示的に設定してください:

cd /opt/digna
chmod +x digna

macOS がアプリケーションをブロックする場合¶

ブラウザやメールクライアント経由でダウンロードされたファイルには検疫属性が付けられます。macOS が「開発元を確認できないため開けません」と報告する場合は、インストールディレクトリから属性を削除してください:

xattr -dr com.apple.quarantine /opt/digna

または、System Settings → Privacy & Security を開き、ページ下部にあるブロックされた項目を見つけて Open Anyway をクリックしてください。

ステップ 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
mv config_template.toml config.toml

場所: /opt/digna/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 = "/opt/digna/tmp"

mkdir -p /opt/digna/tmp

ステップ 2: 構成を検証する¶

リポジトリを初期化する前に、config.toml が完全で正しく構成されていることを確認します。digna のインストールディレクトリで次を実行します:

./digna config check

各セクションは個別に検証されるため、1 つの誤りが他のセクションの状態を隠すことはありません:

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 は、digna が読み取らない config.toml 内のキーを示します。これらは効果がないため、削除するかスペルを修正してください。オプションの完全な一覧は CLI リファレンスにあります。

ステップ 3: リポジトリの初期化¶

1. Terminal を開く
2. digna インストールディレクトリ（config.toml と digna 実行ファイルがある場所）に移動する
3. 接続テストを実行:

cd /opt/digna
./digna repo check

新しいスキーマでは、コマンドは接続したうえで、リポジトリがまだインストールされていないことを報告します:

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

この時点ではこれが想定どおりの結果で、digna が PostgreSQL とスキーマに到達できることを示しています。代わりに接続エラーや認証エラーが表示される場合は、[repo] セクションまたは PostgreSQL のセットアップに原因があります。

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

ステップ 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

これにより、メールアドレス admin@example.com の管理者権限を持つユーザーが作成されます。

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

digna ダッシュボードは独自の設定を dashboard/dashboard_config.toml から読み込みます。このファイルはインストールパッケージに含まれていないため、dashboard/ ディレクトリ内にダッシュボードのファイルと並べて作成します。

その内容は シングルサインオン で説明しています。このファイルが必要になるのもそこです。このファイルには、ダッシュボードが提供するログイン方法と、マルチインスタンス構成の場合はバックエンドへの接続先が記述されます。

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

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 バックエンドをバックグラウンドサービスとして実行することで、以下が可能になります:

• マシン起動時に自動で開始する
• ターミナルウィンドウを開かずにバックグラウンドで実行される
• クラッシュした場合に自動で再起動される
• 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. Terminal を開く

2. bin フォルダに移動

   cd /opt/digna/bin
   

3. インストールスクリプトを実行

   sudo ./install_service.sh
   

これで digna サーバーは launchd に自動起動有効で登録されます。サービスはすぐには開始されません — 次のセクションで起動方法を説明します。

サービスの起動と停止¶

サービスを開始するには¶

1. Terminal を開く
2. /opt/digna/bin に移動
3. 実行:

   sudo ./start_service.sh
   

サービスを停止するには¶

1. Terminal を開く
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 のインストールをリリース 2026.11 にアップグレードします。それより古いインストールの場合は、先に リリース 2026.06 より前のリリースからのアップグレードをお読みください。

アップグレード前に¶

digna リポジトリのバックアップ作成は必須です

digna をアップグレードする前にリポジトリ（PostgreSQL）のバックアップを作成し、データ損失に備えてください。バックアップがあれば、アップグレード中に予期しない問題が発生しても復旧できます。

Terminal からバックアップを作成するには:

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

リリース 2026.11 用のライセンスファイルを依頼する

リリース 2026.11 には新しい license.toml が必要です。作業を始める前に digna チームに依頼し、ステップ 7 で使えるよう準備しておいてください。

リリース 2026.06 より前のリリースからのアップグレード¶

リリース 2026.06 では 3 つの変更が導入されました。古いインストールを 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 /opt/digna/bin
sudo ./stop_service.sh

digna がフォアグラウンドで動作している場合は、その Terminal ウィンドウで Ctrl+C を押してください。

ステップ 2: 現在のインストールをバックアップする¶

digna のインストールディレクトリで、現在のインストールの実行ファイルとダッシュボードフォルダーの名前を変更し、新しいリリースを並べて配置できるようにします:

cd /opt/digna
mv digna digna_old
mv dashboard dashboard_old

digna_old はアップグレードを確認するまで、dashboard_old はそこから設定ファイルを復元するまで残してください（ステップ 4 を参照）。その後は両方とも削除してかまいません。

ステップ 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

リリース 2026.11 では config.toml の変更は不要です。リリース 2026.06 で動作するファイルはそのまま動作し続けます。次の 2 つの変更は任意です:

• データベース接続で digna Engine を使用し、そのデフォルトがホストに合わない場合は、[duckdb] セクション を追加します。
• リバースプロキシがダッシュボードとバックエンドを 1 つのオリジンで配信する場合は、[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: Web サーバーをリロードする¶

ダッシュボードは静的ファイルの集まりであるため、Web サーバー（およびブラウザー）が以前のバージョンを配信し続けている可能性があります。dashboard フォルダーをホストしている Web サーバーをリロードまたは再起動し、ページをハードリフレッシュ（Cmd+Shift+R）で再読み込みしてください。

ステップ 6: 構成を検証する¶

リポジトリに手を加える前に、config.toml が完全であることを確認します:

./digna config check

すべてのセクションが OK と報告される必要があります。FAILED と報告された箇所を修正し、Unknown keys の下に一覧表示されたキーを削除してから、続行する前にコマンドを再実行してください。

ステップ 7: ライセンスファイルを置き換える¶

通常、ライセンスファイルはリリースをまたいでそのまま使用できます。リリース 2026.11 は例外です。このリリースでは digna Data Reconciliation と digna Agentic という 2 つのライセンス対象モジュールが追加され、2026.11 より前に発行されたライセンスにはこれらが含まれていません。digna チームがリリース 2026.11 用に提供した license.toml をインストールディレクトリにコピーし、古いものを置き換えてください:

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

./digna license check

ステップ 8: リポジトリスキーマのアップグレード¶

digna のインストールディレクトリで次を実行します:

cd /opt/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: サービスの再起動¶

バックグラウンドサービスとして実行している場合:

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

手動で実行している場合はサーバーを再起動します:

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

nginx または Apache を使用している場合は、それぞれの Web サーバーを再起動してください:

brew services restart nginx

sudo apachectl restart

ステップ 10: アップグレードの確認¶

1. 新しい実行ファイルのリリースを確認します:

   ./digna version
   

   1 行目が Release: 2026.11 となっている必要があります。

2. digna ダッシュボードにアクセスし、インターフェースが正しく読み込まれることを確認します。

3. サーバーの出力と logs ディレクトリ内のファイルにエラーがないか確認します。
4. データベース接続をテストします。参照: 接続のテスト。リリース 2026.06 より前のリリースからアップグレードした場合は、まだ ODBC を使用していなかった接続をすべて先に ODBC に切り替えてください。

新しいモジュールを使い始めるには、digna Data Reconciliation、digna MCP Server については AI エージェントの接続、digna Engine については プロファイリングの場所 を参照してください。