Domino 12.0.x のワンタッチ Domino セットアップでどこまで設定できるの？

Dominoの構成情報をファイルに記述しておくことで、Dominoのセットアップ画面を起動することなしに完了させることが可能になりました。
本資料では 12.0.2 の Domino で設定可能になった内容を含みます。
さらに、実際に Nomad Server を構築したサンプルを示します。

Transcript

1. Domino 12.0.x の ワンタッチDominoセットアップで どこまで設定できるの？ Domino 12.0.2 EAP5(ベータ版)を使用 中野晴幸 Haruyuki Nakano @harunakano (twitter) harunakano.blogspot.com (blog)
2. ワンタッチ Domino セットアップ • これまで複数のステップが必要だった Domino のセットアップ を１つのステップで行うことが可能になる • この機能を呼び出すにはセットアップの構成情報を含む JSON または環境変数のセットが必要 { "serverSetup": { "server": { "type": "first", "name": "Adminserver", "domainName": "Renovations" }, "network": { "hostName": "adminserver.renovations.com" }, "org": { "orgName": "Renovations", "certifierPassword": "passw0rd" }, "admin": { "lastName": "Bill Ranney", "password": "passw0rd", "IDFilePath": "C:¥¥domino¥¥adminserver¥¥data¥¥admin.id" } } } set SERVERSETUP_SERVER_TYPE=first set SERVERSETUP_SERVER_NAME=adminserver set SERVERSETUP_SERVER_DOMAINNAME=ACME set SERVERSETUP_SERVER_TITLE=ACME Administration Server set SERVERSETUP_NETWORK_HOSTNAME=adminserver.acme.com set SERVERSETUP_ORG_ORGNAME=sherlock set SERVERSETUP_ORG_CERTIFIERPASSWORD=passw0rd set SERVERSETUP_ADMIN_LASTNAME=Sherlock Holmes set SERVERSETUP_ADMIN_PASSWORD=passw0rd set SERVERSETUP_ADMIN_IDFILEPATH=C:¥domino¥adminserver¥data¥admin.id ←JSON ↓環境変数
3. ワンタッチ Domino セットアップで 何ができるの？ これまで Domino のセットアップで実施できたことに加えて、 • notes.ini パラメータの追加 • ユーザーの追加、メールファイル作成 • IDボールトのセットアップ • サーバーの追加 • 証明書ストアの作成 • ディレクトリアシスタントの設定 • Notesアプリケーションの作成/更新、エージェントの署名/有効化/実行 • Domino の初回起動 など
4. ワンタッチ Domino セットアップで 何が変わるの？ 通常のセットアップ 1 • インストーラのダウンロード 2 • インストールの実行 3 • セットアップの実行 4 • Dominoの起動、各種設定の実施 5 • Dominoの起動、運用開始 ワンタッチ Domino セットアップ 1 • インストーラのダウンロード 2 • インストールの実行 3 • セットアップを –autoconf 付きで実行 • Dominoが自動起動、運用開始 ※Linuxの場合、リモートサーバーセットアップが不要になり超便利になりました
5. ワンタッチ Domino セットアップの どんな使い道があるの？ アプリ開発やテストの 環境を開発者の数だけ 作りたい • 永久ループ等による他の 開発者への影響に配慮 環境構築時の 設定ミスを削減したい • 作業手順を簡略化 • 作業工数（作業時間）の 削減 • 作業担当者の負担の削減 まっさらな Domino サーバーに 戻したい • ベータ版など検証環境の 再構築作業の簡略化
6. セットアップの構成情報 環境変数よりJSONをお勧めする理由
7. 構成情報 JSON vs 環境変数 JSON { "serverSetup": { "server": { "type": "first", "name": "Adminserver", "domainName": "Renovations" }, "network": { "hostName": "adminserver.renovations.com" }, "org": { "orgName": "Renovations", "certifierPassword": "passw0rd" }, "admin": { "lastName": "Bill Ranney", "password": "passw0rd", "IDFilePath": "C:¥¥domino¥¥adminserver¥¥data¥¥admin.id" } } } 環境変数 set SERVERSETUP_SERVER_TYPE=first set SERVERSETUP_SERVER_NAME=adminserver set SERVERSETUP_SERVER_DOMAINNAME=ACME set SERVERSETUP_SERVER_TITLE=ACME Administration Server set SERVERSETUP_NETWORK_HOSTNAME=adminserver.acme.com set SERVERSETUP_ORG_ORGNAME=sherlock set SERVERSETUP_ORG_CERTIFIERPASSWORD=passw0rd set SERVERSETUP_ADMIN_LASTNAME=Sherlock Holmes set SERVERSETUP_ADMIN_PASSWORD=passw0rd set SERVERSETUP_ADMIN_IDFILEPATH=C:¥domino¥adminserver¥data¥admin.id
8. 構成情報に設定可能な項目数 JSON > 環境変数 設定項目 パラメータ JSON 環境変数 ユーザーの追加 serverSetup/registerUsers/ ◦ × アプリの設定 appConfiguration/ ◦ × 環境変数に実装されていない（ヘルプに記載のない）設定項目がある
9. 比較 JSON • パラメータが単純化されるため読 みやすい • 構造がわかりやすい • フル機能を利用できる • 記述ルールが厳しくカンマ忘れな どのエラーが発生しやすい 環境変数 • 同じ様な名称がパラメータ名に何 度も登場するため読みづらい • パラメータの記述順の自由度が高 い • 一部機能が利用できない
10. ワンタッチ Domino セットアップを 実行してみた JSONファイルを使い ワンタッチ Domino セットアップで Nomad Server を構築する
11. { "serverSetup": { "server": { "type": "first", "name": "himawari", "domainName": "noteslab", "title": "testing nomad server" }, "network": { "hostName": "himawari.dominov12beta.work" }, "org": { "orgName": "noteslab", "certifierPassword": "password" }, "admin": { "lastName": "Administrator", "password": "password", "IDFilePath": "noteslab.admin.id" }, "notesINI": { "ServerTasks": "Update,Replica,Router,AMgr,Adminp,HTTP,nomad", "LOG_REPLICATION": "1", "LOG_SESSIONS": "1", "CREATE_R12_DATABASES": "1", "DisableLDAPOnAdmin": "1", "NOMAD_WEB_HOST": "himawari.dominov12beta.work" }, "security": { "ACL": { "prohibitAnonymousAccess": true, "addLocalDomainAdmins": true }, "TLSSetup": { "method": "dominoMicroCA", "CAKeyType": "ECDSA", "CAExpirationDays": 365, "TLSKeyType": "RSA2048", "certExpirationDays": 90 } }, "registerUsers": { "defaults" : { "saveIDToPersonDocument": true, "password": "password", "mailTemplatePath": "mail12.ntf", "enableFullTextIndex": true, "certificateExpirationMonths": 36 }, "users": [ { "firstName": "Ichiro", "middleName": "", "lastName": "Suzui", "shortName": "ISuzui", "mailFilePath": "mail/Isuzui.nsf", "IDFilePath": "ISuzui.id", "internetAddress": "ichiro.suzui@dominov12beta.work" }, { "firstName": "Hideki", "middleName": "", "lastName": "Masui", "shortName": "HMasui", "mailFilePath": "mail/HMasui.nsf", "IDFilePath": "HMasui.id", "internetAddress": "hideki.masui@dominov12beta.work" } ] } }, 次ページへ続く 使用する構成情報（JSON） 1/2
12. "IDVault": { "name": "O=noteslabVault", "description": "noteslab Vault", "IDFile": "noteslabVault.id", "IDPassword": "noteslabPassword", "passwordReset": { "helpText": "sample help text" }, "securitySettingsPolicy": { "name": "noteslab Vault Security Settings Policy", "description": "noteslab Vault Security Settings" }, "masterPolicy": { "description": "noteslab Vault Master Policy Description" } }, "appConfiguration": { "databases": [ { "filePath": "names.nsf", "action": "update", "documents": [ { "action": "update", "findDocument": { "Type": "Server", "ServerName": "CN=himawari/O=noteslab" }, "computeWithForm": true, "items": { "HTTP_SSLKeyFile": "himawari.dominov12beta.work", "HTTP_SSLMode": "1" } } ] } ] } } 使用する構成情報（JSON） 2/2 本構成情報についての詳細→ https://harunakano.blogspot.com/2022/08/nomad-web-105.html
13. 実行するには (Windowsの場合) nserver.exe サーバープログラム 本体 Dominoプログラム ディレクトリ -autoconf ワンタッチセットアップの オプション setup.json 構成情報を記述した ファイル C:¥Program Files¥HCL¥Domino >nserver.exe –autoconf c:¥temp¥setup.json
14. 実行結果は Dominoデータディレクトリ内の IBM_TECHNICAL_SUPPORT フォルダに作成される autoconfigure.log あるいは console_<servername>_<date@time>.log
16. Domino 12.0.x ワンタッチ Domino セットアップ まとめ • 構成情報にはJSONの使用をお勧めします • 現状は「別名」を設定できない。ユーザーの日本語名を使用するにはセットアッ プ後にもうひと手間必要です ↓別名追加のアイデアにご賛同くださいませ