Web アプリ素人が Domino 12.0.2 の新機能である Domino REST API（Project KEEP）を怖いもの見たさで触ってみた体験レポートです。
こんな有様なので、誤解や不正確な情報などが含まれている可能性がありますので、予めご了承くださいませ。
検証環境
今回の検証は以下の環境で実施しています。
- Windows 10
- Domino 12.0.2 FP1 64 bit
- Domino REST API v1.0.5
また、今回の検証（特にセットアップ）は以下のチュートリアルを参考に実施しています。
Domino Rest API (KEEP) のチュートリアル
インストーラの準備
まず、Domino REST API v1.0.5 のインストーラである Domino_REST_API_V1.0.5_Installer.tar.gz を入手します。gzip の圧縮ファイルを解凍すると以下のファイルが入手できます。restapiInstall.jar がインストーラの本体です。
- README.txt
- restapiInstall.jar
インストールの補足
インストール方法については、チュートリアルの『Domino REST API のインストール (インストーラ 版)』セクションに記載があります。
インストールコマンドの解説や手順、インストールで実施される変更はそちらに記載がありますので、まずはリンクを参照ください。ここでは、いくつか補足します。
まず、インストールはコマンドプロンプトで実行しますが、必ず『管理者として実行』してください。私はうっかり、通常のコマンドプロンプトで実行しました。その結果最後にエラーが発生しました。ただ、変更箇所はすべて反映されていましたし、今のところ正常に動作しているので問題はないようですが、精神衛生上よくありませんね。
続いては、念のための記載です。
インストールコマンドの実行についてですが、Domino 同梱の JRE は Domino のプログラムフォルダの jvm\bin\ にあります。ですので、コマンドを実行する際には、restapiInstall.jar を配置したフォルダにカレントディレクトリを移動して、java コマンドをフルパスで指定するとよいかと思います。
例えば、Domino が C:\Domino にインストールされていて、Rest API を Domino フォルダ内にインストールするなら以下のようになります。
| >C:\Domino\jvm\bin\java -jar restapiInstall.jar -d="C:\Domino\Data" -i="C:\Domino\notes.ini" -p="C:\Domino" -r="C:\Domino\restapi" –a |
インストール
では、インストールコマンドを実行してみましょう。
インストールが成功したら、コマンドプロンプトに次のメッセージが表示され、インストーラが終了します。
| Installation: success (Exit code 0) |
成功したら、変更箇所がすべて更新されているか確認しましょう。
- Notes.ini の ServerTasks に restapi が存在
- プログラムディレクトリに nrestapi.exe が存在
- ライブラリディレクトリにファイルが存在（主に jar ファイル）
すべて OK なら、Domino を起動します。コンソールを見ていると、次のような初期化メッセージが表示されます。
|
2023/06/22 19:12:46 { 2023/06/22 19:12:46 "name" : "HCL Domino REST API core API", 2023/06/22 19:12:46 "desc" : "Next generation APIs for HCL Domino", 2023/06/22 19:12:46 "version" : "v1.0.5 (Build 1.18.3-6)", 2023/06/22 19:12:46 "vendor" : "HCL Labs", 2023/06/22 19:12:46 "image-build" : "2023-05-08T19:58:47Z", 2023/06/22 19:12:46 "Verticles loaded" : 0, 2023/06/22 19:12:46 "Active handler classes" : 0, 2023/06/22 19:12:46 "active requests" : 0, 2023/06/22 19:12:46 "active agents" : 0, 2023/06/22 19:12:46 "apiPlatform" : "server", 2023/06/22 19:12:46 "runtime" : "0 days, 0 hours, 0 minutes, 1 seconds." 2023/06/22 19:12:46 } 2023/06/22 19:12:46 Domino Rest API Initialization complete. |
| Project KEEP 体験 | 次回 |
0 件のコメント:
コメントを投稿