リモートデバッグを使ってみた

このスライドは、2026年10月8日開催の「第91回 のの会」で使用しました。
リモートデバッガ機能を有効にしたり、プログラムへステートメントを追加する等の準備がありますので、多少面倒ではありますが、サーバーでスケジュール実行するエージェントをユーザーが操作しながら変数やオブジェクトを確認しながらステップ実行できる唯一の機能です。サーバーIDの権限で実行することでわかる不具合もありますので、この機能が欲しくなる場面があるように思います。

Transcript

1. リモートデバッグ機能 を使ってみた 2026年10月8日 第91回 のの会
2. リモートデバッグ機能とは • HCL Domino サーバー上で稼働するスケジュールエージェント をクライアント側でステップ操作しながら調査・デバッグする ための機能です。 • リモートデバッグ機能は、サーバー上でエージェントが実行さ れたタイミングで一時停止させ、クライアント側からそのエー ジェントのプロセスに接続することができます。
3. 準備 リモートデバッグ機能を使うための設定があります
4. 準備： • サーバー側 • リモートデバッグの許可 • エージェント開始時の待機時間設定 • サーバーでデバッグ用タスクの起動 • エージェント側 • プロパティの変更 • stop ステートメントの挿入
5. リモートデバッグの許可 • サーバー文書でリモートデバッグを有効にする
6. 【参考】サーバー文書 (1) • 「サーバータスク – Remote Debug Manager」タブ 項目 初期値 概要 このサーバー上でリモー 無効 トデバッグを許可する 有効/無効のどちらかを選択する。 サーバーデバッグ終了 サーバー上でrdebugタスクを実行す る時間を制限する。-1は無制限 24 時間後 待ちエージェントの開始 0 秒 時間 エージェントの実行前に一時停止させリモートデバッガ を対象のエージェントに接続する時間を確保したい場合 に設定する。
7. 【参考】サーバー文書 (2) • 「ポート – インターネットポート - リモート・デバッグ・マ ネージャー」タブ 今回はデフォルトのままです
8. サーバーでデバッグ用タスクの起動 • コマンド「load rdebug」を投入 • コマンド「show tasks」でタスクの実行を確認 サーバー文書で指定したポート番号
9. 【参考】notes.ini • リモートデバッグをDominoサーバー起動時に有効にするには、 notes.ini の ServerTasks= へ「Rdebug」を追加します。
10. プロパティの変更 • エージェントのプロパティで「リモートデバッグを許可」を有 効化する 注意：トリガーの値によりグレーアウトされることあり トリガーが「イベント」のとき グレーアウトされる
11. Stop ステートメントの挿入 • LotusScript コード内に stop ステートメントを追加 Initialize の先頭へ追加 コードの途中に追加すれば ブレークポイント的な使い方ができる
12. 実行 リモートデバッグ機能を使います
13. 実行： 1. エージェントの起動 2. 待機状態の確認 3. リモートデバッガの起動 4. サーバーへ接続してデバッグ開始
14. 1. エージェントの起動 コンソールからコマンドを投入、またはスケジュール実行する コマンド「tell amgr run “ファイル名” ‘エージェント名’」
15. 2.待機状態の確認 コンソールに「Agents delayed 60 seconds to provide an opportunity for the remote debugger to attach.（リモートデバッガが接続できるよう、エージェントは60秒間処 理を遅らせました。）」と表示される。 ※秒数はサーバー文書で設定、変更後は再 起動が必要
16. 3.リモートデバッガの起動 Notes クライアントや Domino Designer のメニューから 「ツール – リモート LotusScript デバッガ」を選択する
17. 4.サーバーへ接続してデバッグ開始 1. 「デバッグ対象の選択」アイコンを押す →「デバッグ対象の選択」画面が開く 2. サーバー名を選択 →「開く」を押す →「データベース」のリストが表示 3. データベースを選択 →「開く」を押す →「デバッグ対象」のリストが表示 4. エージェントを選択 →「開く」を押す →デバッガが開く 実行中で接続を待機して いるエージェントを表示
18. リモート LotusScript デバッガ 見た目や操作は、リモートじゃない LotusScript デバッガと ほぼ同じ ※使い方は省略
19. エージェントを最後まで実行すると、「デバッ グセッションは終了しました。」と表示される コンソールにもエージェントの終了を 示すメッセージがありました
20. 注意点
21. 注意点 • リモートデバッグができるのは LotusScript エージェントのみ • デバッグ終了時は stop ステートメントと「リモートデバッグ を許可」のチェックを解除する • 指定したポート番号を事前にファイアウォールで許可する
22. 気になったこと
23. ヘルプが嘘を教える エージェント側で「リモートデバッ グを許可」を選択するプロパティ上 のタブは「セキュリティ」ではなく 「基本」です
24. 「Debugger」以外は統一感が無い HCL Notes Server Agent Debugger HCL Domino Designer Debugger Remote Debugger (サーバータスクの名前）
25. RDEBUG タスクは、サーバー文書でリモート デバッグを「許可」しても自動実行されない デバッグの許可とタスクの実行は それぞれに行う必要がある リモートデバッグを許可するだけで 次のサーバー起動時から RDEBUG タスクが自動実行されるといいのに…
26. エージェントが実行待ちしていない場合、デ バッグ対象（エージェント）が表示されない 実行待ちのエージェントが無い ことを示すメッセージが欲しいかも…
27. 要求してないのにデバッガが停止する ※原因不明… リモート LotusScript デバッガを終了し クライアントを再起動して リモート LotusScript デバッガを起動す ると前回終了時の状態から再開できた 上のメッセージが表示された後もリモー ト LotusScript デバッガは起動したまま で、次の行へ進めようとすると「そのよ うなセッションはありません。または セッションが閉じています。」と表示さ れた
28. デバッグ中に突然エラーが発生 ※原因不明 Notesクライアントとリモートデバッガ の再起動で、前回の続きからデバッグを 再開できた
29. 接続待ちの同名のエージェントが増える リモートデバッグ中に突然切断 されて、同じエージェントを再 実行すると、同じエージェント の名前が複数表示された
30. 操作開始と同時にエージェント終了 エージェントの起動後からリモート LotusScript デバッガで接続するまでの待 ち時間を十分に取りましょう。
31. 「変数」タブ内の展開/省略の表示に違和 感あり 手動で展開しても処理を進める と自動で省略される 処理を進めても展開した状態を 維持してほしい 空のオブジェクトに+マークが表 示されるので空じゃないように 見える
32. リモートデバッグを許可しなくても Rdebug タスクを実行可能（なんで？） サーバー文書で「このサーバー上でリモートデ バッグを許可する」を“無効”にしても、 RDEBUG タスクを実行可能 この状態でエージェントを実行しても、エー ジェント内の STOP ステートメントは無視され る クライアントでリモートデバッガを実行して データベースを開くと「デバッグセッションが 有効にできません」と表示される
33. クライアント実行でもStopが機能した クライアント側で LotusScript デバッグを有 効にして、リモートデバッグを有効にした エージェントを実行したところ Stop ステー トメントの場所で実行を止めてくれた
34. Notes/Domino 14.5.1 FP1 では使えない？ みなさんは使えてますか？ Notes/Domino とも14.5 FP1 の環境で 「デバッグ対象の選択」から サーバー名を選択して「開く」を押しても データベースのリストもエラーメッセージも 表示されない… 新規インストール+セットアップしたスタンド アロンの Notes/Domino でも同様だった エージェント実行時に表示される警告メッ セージが影響してる？
35. Rdebug タスクのコマンド・オプション を充実してほしい 欲しいオプション • リモートデバッグ実行待ちのエージェントの一覧 • 実行待ち状態の解除
36. スライドの終わり