Docker

Operations ToolsのReleasesページよりダウンロードした「OperationsTools_x.x.x.zip」を解凍します。

フォルダ「OperationsTools_x.x.x」のフォルダ名を「OperationsTools」に変更してください。下記のフォルダ構成となります。

.
+-- 📁OperationsTools
   +-- 📁ExtendedLibraries
   +-- 📁wwwroot

下記のコマンドを実行してください。稼働中のコンテナが停止します。

docker compose down

「OperationsTools」フォルダをプロジェクトディレクトリ（.envおよびcompose.yamlと同じフォルダ）に配置してください。

下記のフォルダ構成となります。

📁pleasanter
   +-- 📁app_data_parameters
   |   +-- 📄パラメータファイル
   |
   +-- 📁license
   |   +-- 📄Implem.License.dll
   |
   +-- 📁OperationsTools
   |   +-- 📁ExtendedLibraries
   |   +-- 📁wwwroot
   |
   |-- 📄.env
   |-- 📄compose.yaml

下記のファイルを任意のテキストエディタで開いてください。

OperationsTools\ExtendedLibraries\OperationsTools\App_Data\Parameters\General.json

Operations Toolsを利用できるユーザのログインIDを、Login.Usersパラメータに配列形式で指定してください。下記は設定例です。

{
    "SetupPassword": "operations-tools",
    "Login": {
        "Users": [ "Administrator" ]
    },
    "PageSize": 50,
    "SQLCommandTimeout": 240,
    "DefaultParametersDir": "DefaultParameters"
}

{
    "SetupPassword": "operations-tools",
    "Login": {
        "Users": [ "Administrator", "AdminUser1", "AdminUser2" ]
    },
    "PageSize": 50,
    "SQLCommandTimeout": 240,
    "DefaultParametersDir": "DefaultParameters"
}

なお、OperationsToolsのパラメータファイルの詳細は後述の補記「パラメータ：General.jsonについて」および「パラメータ：BackgroundService.jsonについて」を参照してください。

利用中のプリザンターのバージョンにおける既定のパラメータJSONファイル（全てのファイル）を「OperationsTools\ExtendedLibraries\OperationsTools\App_Data\DefaultParameters」フォルダ配下に配置してください。

OperationsTools\ExtendedLibraries\OperationsTools\App_Data\
   └ 📁DefaultParameters\   ← 先ほどとは別のフォルダ
      ├ Api.json             ← 配置
      ├ Authentication.json  ← 配置
      ├     :                ← 以降、全パラメータファイルを配置

compose.yamlのpleasanterサービスのvolumes:に下記の2行を追記します。

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

下記のコマンドを実行してください。OperationsToolsのモジュールを含むプリザンターのコンテナが再作成され、再起動されます。

docker compose up -d pleasanter

ブラウザを起動し、下記URLを開いてください。

http://localhost:50001/operations-tools/admin

パスワードを入力し、セットアップボタンをクリックします。

メッセージ「セットアップの処理中です。しばらくお待ち下さい。」が表示されます。

メッセージ「セットアップが完了しました。」が表示されたらセットアップは完了です。

コンテナを停止します。

docker compose stop

Operations Tools用のパラメータファイル：General.jsonの"SQLCommandTimeout"について値を調整してください。

{
    "SetupPassword": "operations-tools",
    "Login": {
        "Users": [ "Administrator", "AdminUser1", "AdminUser2" ]
    },
    "PageSize": 50,
    "SQLCommandTimeout": 240,  <-- 値を調整する
    "DefaultParametersDir": "DefaultParameters"
}

以下コマンドを実行します。

docker compose up -d pleasanter

Operations Toolsの管理ページ画面から「表示データを最新化」ボタンをクリックします。

[_eot_JobHistory]テーブルのログを確認し、Status, ErrMessage, ErrStackTrace の内容を確認します。

（Statusが'Success'となっており、ErrMessage, ErrStackTraceがブランクとなっていれば成功です。）