以下は、[Docker Hubで公開されているプリザンターの公式Dockerイメージ](https://hub.docker.com/r/implem/pleasanter)を利用する手順です。 ## 概要 [Operations Tools](/ja/manual/operations-tools-overview)のセットアップおよび起動手順を説明します。 ## 制限事項 1. Operations ToolsはMySQLではご利用いただけません。 ## 前提条件 1. 本手順はプリザンターをEnterprise Editionにアップグレードしていることを前提とします。 2. プリザンターのパラメータ[SysLog.json](/ja/manual/sys-log-json)の「EnableLoggingToDatabase」をtrueにする必要があります。なお、Docker版でパラメータファイルを設定する手順は「[Dockerイメージを使用しパラメータを既定値から変更して起動する](change-parameters-at-docker-image)」を参照ください。 1. 本手順は、DockerでEnterprise Editionを起動できていることを前提とします。[Rds.json](/ja/manual/rds-json)などのパラメータファイルや、.env、compose.yamlは、以下のマニュアルに記載されたものをベースに編集してください。コピー元のファイルは利用するDB毎に異なるため注意してください。 [Community EditionからEnterprise Editionへのアップグレード手順（Docker利用）](/ja/manual/enterprise-edition-upgrade-docker) https://pleasanter.org/ja/manual/enterprise-edition-upgrade-docker ## 操作手順 1. 資源の配置 2. コンテナの起動 ### 1. 資源の配置 1. [Operations ToolsのReleasesページ](https://github.com/Implem/Implem.OperationsTools/releases)よりダウンロードした「OperationsTools_x.x.x.zip」を解凍します。 2. フォルダ「OperationsTools_x.x.x」のフォルダ名を「OperationsTools」に変更してください。以下のフォルダ構成となります。 ```text . +-- 📁OperationsTools +-- 📁ExtendedLibraries +-- 📁wwwroot ``` 3. 以下のコマンドを実行してください。稼働中のコンテナが停止します。 ```bash docker compose down ``` 4. 「OperationsTools」フォルダをプロジェクトディレクトリ（.envおよびcompose.yamlと同じフォルダ）に配置してください。 以下のフォルダ構成となります。 ```text 📁pleasanter +-- 📁app_data_parameters | +-- 📄パラメータファイル | +-- 📁license | +-- 📄Implem.License.dll | +-- 📁OperationsTools | +-- 📁ExtendedLibraries | +-- 📁wwwroot | |-- 📄.env |-- 📄compose.yaml ``` 5. 以下のファイルを任意のテキストエディタで開いてください。 ```text OperationsTools\ExtendedLibraries\OperationsTools\App_Data\Parameters\General.json ``` 6. Operations Toolsを利用できるユーザのログインIDを、Login.Usersパラメータに配列形式で指定してください。以下は設定例です。 ##### General.json：変更前 ```json { "SetupPassword": "operations-tools", "Login": { "Users": [ "Administrator" ] }, "PageSize": 50, "SQLCommandTimeout": 240, "DefaultParametersDir": "DefaultParameters" } ``` ##### General.json：変更後（上から4行目を変更） ```json { "SetupPassword": "operations-tools", "Login": { "Users": [ "Administrator", "AdminUser1", "AdminUser2" ] }, "PageSize": 50, "SQLCommandTimeout": 240, "DefaultParametersDir": "DefaultParameters" } ``` なお、OperationsToolsのパラメータファイルの詳細は後述の補記「パラメータ：General.jsonについて」および「パラメータ：BackgroundService.jsonについて」を参照してください。 7. 利用中のプリザンターのバージョンにおける**既定のパラメータJSONファイル（全てのファイル）**を「OperationsTools\ExtendedLibraries\OperationsTools\App_Data\DefaultParameters」フォルダ配下に配置してください。 ```text OperationsTools\ExtendedLibraries\OperationsTools\App_Data\ └ 📁DefaultParameters\ ← 先ほどとは別のフォルダ ├ Api.json ← 配置 ├ Authentication.json ← 配置 ├ : ← 以降、全パラメータファイルを配置 ``` **Note** DefaultParametersフォルダ配下に既定のパラメータJSONファイルを配置することで、後述の「パラメータ一覧画面」で差分を比較できます。 変更前のパラメータJSONファイルが手元にない場合は、[GitHubのリリース用ページ](https://github.com/Implem/Implem.Pleasanter/releases)からダウンロードして取得してください。 https://github.com/Implem/Implem.Pleasanter/releases 8. compose.yamlのpleasanterサービスのvolumes:に以下の2行を追記します。 ##### compose.yaml（一部抜粋：以下の6～7行目を追記） ```yaml pleasanter: # : 中略 volumes: - pleasanter_params:/app/App_Data/Parameters - ./license/Implem.License.dll:/app/Implem.License.dll:ro - ./OperationsTools/ExtendedLibraries:/app/ExtendedLibraries:ro - ./OperationsTools/wwwroot/operations-tools:/app/wwwroot/operations-tools:ro ``` **Note** Operations Toolsのバージョンアップをする際は、コンテナ停止後に「OperationsTools」フォルダを削除してから上記1.～8.の手順を実施してください。 #### パラメータ：General.jsonについて 共通設定に関するパラメータです。各パラメータの説明は以下のとおりです。 | パラメータ名 | 値 | 説明 | | -------------------- | ------------------- | ------------------------------------------------------------------ | | SetupPassword | operations-tools | セットアップ時に入力するパスワードを指定。 | | Login.Users | [ "Administrator" ] | Operations Toolsを利用できるユーザのログインIDを配列形式で指定。 | | PageSize | 50 | ページ送りの既定値を指定。 | | SQLCommandTimeout | 240 | SQLコマンドのタイムアウト時間を秒単位で指定。 | | DefaultParametersDir | DefaultParameters | 変更前のパラメータ配置ディレクトリを指定。（パラメータ一覧画面用） | #### パラメータ：BackgroundService.jsonについて データ表示用の中間テーブルをバックグラウンドで同期する処理に関するパラメータです。各パラメータの説明は以下のとおりです。 | パラメータ名 | 値 | 説明 | | ------------------------------------ | -------------------- | ------------------------------------------------------------- | | IntermediateTableSynchronize.Enable | true | バックグラウンド処理の有効化/無効化をtrue/falseで指定します。 | | IntermediateTableSynchronize.RunTime | [ "00:00", "12:00" ] | バックグラウンド処理を実行する時間を配列形式で指定します。 | ### 2. コンテナの起動 1. 以下のコマンドを実行してください。OperationsToolsの資源を含むプリザンターのコンテナを再作成・再起動します。 ```bash docker compose up -d pleasanter ``` 2. ブラウザを起動し、下記URLを開いてください。 ```text http://localhost:50001/operations-tools/admin ```  3. パスワードを入力し、セットアップボタンをクリックします。 **Note** ここで入力するパスワードはOperations Tools用のパラメータファイル：General.jsonで設定したSetupPasswordの値（初期値は「operations-tools」）です。 4. メッセージ「セットアップの処理中です。しばらくお待ち下さい。」が表示されます。  5. メッセージ「セットアップが完了しました。」が表示されたらセットアップは完了です。  **Note** 上記操作によりOperations Tools用のテーブル一式（プレフィックスが「_eot」のテーブル）が作成されます。 **Note** 一部の画面の表示データはセットアップを実施したタイミングで中間テーブルに作成され、Operations ToolsのパラメータBackgroundService.jsonのIntermediateTableSynchronize.RunTimeで指定した時間にバックグラウンドで同期されます。直近のデータを見たい場合などは「表示データを最新化」ボタンを押下してデータを手動で同期してください。 ### トラブルシューティング Q. 管理ページの画面にアクセスした際、以下のように「ライセンスファイルが正しく設定されていないか、またはライセンスファイルが無効です。」のメッセージが表示される。  A. プリザンター本体に有効なライセンスファイルが配置されていることを確認してください。 --- Q. 一部の画面について明細情報などの結果が表示されない。 A. 対象環境のデータ量によってはセットアップ処理がタイムアウトで中断されることにより、一部画面の結果が表示されないことがあります。その場合は、以下の手順をお試しください。 ＜手順＞ 1. コンテナを停止します。 ```bash docker compose stop ``` 2. Operations Tools用のパラメータファイル：General.jsonの"SQLCommandTimeout"について値を調整してください。 ```json { "SetupPassword": "operations-tools", "Login": { "Users": [ "Administrator", "AdminUser1", "AdminUser2" ] }, "PageSize": 50, "SQLCommandTimeout": 240, <-- 値を調整する "DefaultParametersDir": "DefaultParameters" } ``` 3. 以下コマンドを実行します。 ```bash docker compose up -d pleasanter ``` 4. Operations Toolsの管理ページ画面から「表示データを最新化」ボタンをクリックします。 5. [_eot_JobHistory]テーブルのログを確認し、Status, ErrMessage, ErrStackTrace の内容を確認します。 （Statusが'Success'となっており、ErrMessage, ErrStackTraceがブランクとなっていれば成功です。） ## 関連情報 <div id="ManualList"><ul><li><a href="/ja/manual/rds-json">パラメータ設定：Rds.json</a><span>2025/07/08 up</span></li> <li><a href="/ja/manual/sys-log-json">パラメータ設定：SysLog.json</a><span>2025/05/13 up</span></li></ul></article> <ul><li><a href="/ja/manual/enterprise-edition-upgrade-docker">Community EditionからEnterprise Editionへのアップグレード手順（Docker利用）</a><span>2026/07/17 up</span></li></ul></article> <ul><li><a href="/ja/manual/operations-tools-overview">Operations Tools：機能概要</a><span>2026/01/14 up</span></li> <li><a href="/ja/manual/operations-tools-setup">Operations Tools：セットアップ</a><span>2025/09/22 up</span></li> <li><a href="/ja/manual/operations-tools-operation-general">Operations Tools：運用レポート：全体（利用状況／性能状況）</a><span>2025/02/14 up</span></li> <li><a href="/ja/manual/operations-tools-operation-performance-by-day">Operations Tools：運用レポート：性能状況：日別</a><span>2025/02/14 up</span></li> <li><a href="/ja/manual/operations-tools-operation-performance-by-time">Operations Tools：運用レポート：性能状況：時間別</a><span>2025/02/14 up</span></li> <li><a href="/ja/manual/operations-tools-usage-by-day">Operations Tools：利用状況詳細：日別</a><span>2025/02/14 up</span></li> <li><a href="/ja/manual/operations-tools-usage-by-month">Operations Tools：利用状況詳細：月別</a><span>2025/02/14 up</span></li> <li><a href="/ja/manual/operations-tools-usage-login">Operations Tools：利用状況詳細：詳細：ログイン履歴</a><span>2025/02/14 up</span></li> <li><a href="/ja/manual/operations-tools-usage-outgoingmails">Operations Tools：利用状況詳細：詳細：メール送信履歴</a><span>2025/02/14 up</span></li> <li><a href="/ja/manual/operations-tools-usage-api-requests">Operations Tools：利用状況詳細：詳細：APIリクエスト履歴</a><span>2025/02/14 up</span></li> <li><a href="/ja/manual/operations-tools-monitoring-alert-setting">Operations Tools：監視アラート：アラート設定</a><span>2025/02/14 up</span></li> <li><a href="/ja/manual/operations-tools-monitoring-system-talbes">Operations Tools：監視アラート：システムテーブル</a><span>2025/02/14 up</span></li> <li><a href="/ja/manual/operations-tools-monitoring-sites">Operations Tools：監視アラート：サイト</a><span>2025/02/14 up</span></li> <li><a href="/ja/manual/opetaions-tools-sites">Operations Tools：サイト情報一覧</a><span>2025/02/14 up</span></li> <li><a href="/ja/manual/operations-tools-permissions">Operations Tools：アクセス権一覧</a><span>2025/02/14 up</span></li> <li><a href="/ja/manual/operations-tools-parameters">Operations Tools：パラメータ一覧</a><span>2025/02/14 up</span></li> <li><a href="/ja/manual/operations-tools-common-site-menu">Operations Tools：共通機能：サイドメニュー</a><span>2025/04/04 up</span></li> <li><a href="/ja/manual/operations-tools-common-export">Operations Tools：共通機能：エクスポート</a><span>2025/02/14 up</span></li></ul></article></div><input id="SearchTextHidden" type="hidden" value="" />