Windows インストールガイド — digna リリース 2026.06¶

リリース: 2026.06

最終更新日: 2026年8月30日

目次¶

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

導入¶

digna について¶

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

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

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

リリース 2026.06 の新機能¶

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

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

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

システム要件¶

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

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

既に PostgreSQL がインストール済みの場合: 既存の PostgreSQL サーバーに digna 用の新しいデータベースを追加できます。

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

事前準備¶

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

1. PostgreSQL サーバー — 計算済みメトリクスとパフォーマンスデータの保存用
2. Web サーバー — digna Dashboard のホスティング用

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

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

既に PostgreSQL をお持ちの場合¶

PostgreSQL がローカルで動作しているか、リモートで管理された PostgreSQL サーバーを使用している場合は、次のセクションに進んでください。

PostgreSQL のインストール¶

Windows に PostgreSQL をインストールする手順は次の通りです。

ステップ 1: PostgreSQL をダウンロード¶

1. PostgreSQL Downloads page にアクセス
2. Windows を選択
3. 最新のインストーラーをダウンロード

ステップ 2: インストーラーを実行¶

1. ダウンロードしたインストーラーをダブルクリック
2. セットアップウィザードの指示に従う

ステップ 3: インストール先ディレクトリを選択¶

PostgreSQL をインストールするディレクトリを選択します。デフォルトの場所で問題ないことが多いです。

ステップ 4: コンポーネントの選択¶

標準的なセットアップでは、デフォルトのコンポーネントオプションのままで問題ありません。

ステップ 5: PostgreSQL スーパーユーザーのパスワード設定¶

PostgreSQL のスーパーユーザー（postgres）のパスワードを入力して確認します。このパスワードは安全な場所に保管してください — 後で必要になります。

ステップ 6: ポート番号の設定¶

デフォルトの PostgreSQL ポートは 5432 です。必要に応じてデフォルトのままか別のポートを指定できます。

ステップ 7: ロケールの選択¶

データベースのロケールを選択します。ほとんどのインストールではデフォルトで問題ありません。

ステップ 8: インストールの完了¶

残りのステップで Next をクリックし、完了したら Finish をクリックします。

ステップ 9: インストールの確認¶

コマンドプロンプトを開き、PostgreSQL がインストールされていることを確認します:

psql --version

インストールが成功していれば PostgreSQL のバージョンが表示されます。

Web サーバーの設定¶

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

• Internet Information Services (IIS)
• Apache Tomcat

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

IIS のセットアップ¶

概要¶

Internet Information Services (IIS) は、Web サイトや Web アプリケーションをホストするための Microsoft の Web サーバーです。

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 ページからダウンロードしてインストールしてください: URL Rewrite モジュール

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

IIS で Markdown ファイル（.md）を正しく配信するための設定:

1. IIS マネージャー を開く（Win + R を押して inetmgr と入力して Enter）
2. 該当サイト > MIME Types に移動
3. Add... をクリック
4. 設定を行う:
5. File name extension: .md
6. MIME type: text/markdown

Apache Tomcat のセットアップ¶

概要¶

Apache Tomcat はオープンソースの Java サーブレットコンテナ兼 Web サーバーです。

インストール¶

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/ — Web ダッシュボードインターフェース
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] セクション¶

このセクションは 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. コマンドプロンプトを開く
2. digna のインストールディレクトリ（config.toml と digna 実行ファイルがある場所）に移動
3. 接続テストを実行:

digna repo check

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

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

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

digna repo install

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

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

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

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 - --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 サーバーを選択し、該当するデプロイ手順に従ってください。

IIS へデプロイする場合¶

1. IIS マネージャーを開く

2. Win + R を押して inetmgr と入力して Enter

3. 新しいサイトを作成

4. 左側パネルで Sites を右クリック

5. Add Website... を選択

6. サイトを構成

7. Site Name: 名前を入力（例: "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. 「管理者として実行」を選択

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 から、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）を必ずバックアップしてください。バックアップは、アップグレード中に予期しない問題が発生した場合の復旧に必要です。

アップグレード手順¶

ステップ 1: 古いサービスを停止して登録を解除する¶

digna を Windows サービスとして実行している場合は、現在のインストールのバッチファイルで停止します。digna windows コマンドは新しいリリースに含まれるもので、この時点ではまだ使用できません:

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

続いて、同じく古いバッチファイルでサービスの登録を解除します。登録情報は古い実行ファイルとそのスクリプトを指しており、どちらもこのアップグレードで置き換えられるため、再利用できません:

uninstall_service.bat

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

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

# Rename the folder containing dignabackend
ren dignabackend dignabackend_old

# Rename the folder containing dignacli
ren dignacli dignacli_old

# Rename dashboard
ren dashboard dashboard_old

ステップ 3: 新バージョンを展開してデプロイ¶

1. 新しい digna インストール ZIP ファイルを展開
2. 新しい digna 実行ファイルと dashboard フォルダをインストールディレクトリにコピー

ステップ 4: 設定ファイルの復元¶

copy 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 サーバーをリロードまたは再起動し、ページをハードリフレッシュ（Ctrl+F5）で再読み込みしてください。

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

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

digna config check

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

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

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

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

digna license check

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

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

digna repo upgrade

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

ステップ 9: サービスを登録して開始する¶

古い登録情報はステップ 1 で削除されたため、サービスを再度登録します。今回はバッチファイルを持たない digna 実行ファイルを使います:

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

新しい既定値の 127.0.0.1 と 8000 を使う場合を除き、--address と --port には古いサービスが使用していた値を指定してください。これらは登録情報に記録され、config.toml からは読み込まれなくなりました。古いサービスがドメインアカウントで実行されていた場合は、--account と --password を追加してください。オプションの完全な一覧は digna を Windows サービスとして実行する を参照してください。

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

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

IIS や Tomcat を使用している場合は、それぞれの Web サーバーを再起動してください。

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

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