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

リリース: 2026.06

最終更新日: 2026年9月5日

目次¶

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.06 の新機能¶

このリリースでは、データ可観測性（data observability）機能をコード内に直接取り込むことで、開発者がソースでデータ品質を監視できるようになりました。完全な詳細は release notes を参照してください。

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.06-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] セクション¶

このセクションは 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 = ["*"]

[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!"

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

[encryption] セクション¶

このセクションには、リポジトリに保存された機密値を暗号化するための鍵が含まれます。必須です。鍵が欠けている場合、config check は [encryption] セクションを FAILED として報告します。

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

[logging] セクション¶

このセクションはログの動作を設定します:

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10

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

Overall: OK

FAILED と報告された箇所をすべて修正し、続行する前にコマンドを再実行してください。オプションの完全な一覧は CLI リファレンスにあります。

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

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

cd /opt/digna
./digna repo check

接続が確立されたことを示す確認メッセージが表示されるはずです（リポジトリ自体はまだ初期化されていません）。

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

ステップ 4: リポジトリスキーマのインストール¶

同じディレクトリで次を実行します:

./digna repo install

このコマンドは PostgreSQL データベースに必要なテーブルとスキーマをインストールします。

ステップ 5: 管理者ユーザーの作成¶

1. 新しい Terminal ウィンドウを開く
2. digna インストールディレクトリに移動
3. 管理者ユーザーを作成するために次のコマンドを実行:

./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 - --port — サーバーのポート

起動に成功すると次のようなメッセージが表示されます:

INFO:     Started server process [1234]
INFO:     Waiting for application startup.
INFO:     Application startup complete
INFO:     Uvicorn running on http://localhost: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 から、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 に切り替え、ダッシュボードからテストしてください。参照: データベース接続の作成 および 接続のテスト。

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

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

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

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

アップグレード手順¶

ステップ 1: digna サービスを停止する¶

digna がバックグラウンドサービスとして動作している場合、まずそれを停止します:

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

digna をフォアグラウンドで実行している場合は、そのターミナルウィンドウで Ctrl + C を押します。

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

digna のインストールディレクトリで、新しいリリースを並べて配置できるよう、現在のインストールのフォルダー名を変更します:

cd /opt/digna
mv dignabackend dignabackend_old

mv dignacli dignacli_old

mv dashboard dashboard_old

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

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

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

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

ステップ 5: Web サーバーをリロードする¶

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

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

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

./digna config check

すべてのセクションが OK と報告される必要があります。FAILED と報告された箇所を修正し、続行する前にコマンドを再実行してください。

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

ライセンスはリリースごとに個別に発行されます。digna チームがこのリリース用に提供した license.toml をインストールディレクトリにコピーし、古いものを置き換えます:

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

./digna license check

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

digna インストールディレクトリに移動して次を実行:

cd /opt/digna
./digna repo upgrade

これにより PostgreSQL スキーマが最新バージョンに更新され、既存のデータは保持されます。

ステップ 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 ダッシュボードにアクセスする
2. インターフェースが正しく読み込まれることを確認する
3. サーバーログにエラーがないか確認する
4. まだ ODBC を使っていなかった接続をすべて ODBC に切り替え、そのうえですべての接続をテストします。参照: 接続のテスト