Domino 12.0.x の ワンタッチDominoセットアップで どこまで設定できるの？ Domino 12.0.2 EAP5(ベータ版)を使用 中野晴幸 Haruyuki Nakano @harunakano (twitter) harunakano.blogspot.com (blog)

ワンタッチ 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 ↓環境変数

ワンタッチ Domino セットアップで 何ができるの？ これまで Domino のセットアップで実施できたことに加えて、 • notes.ini パラメータの追加 • ユーザーの追加、メールファイル作成 • IDボールトのセットアップ • サーバーの追加 • 証明書ストアの作成 • ディレクトリアシスタントの設定 • Notesアプリケーションの作成/更新、エージェントの署名/有効化/実行 • Domino の初回起動 など

ワンタッチ Domino セットアップで 何が変わるの？ 通常のセットアップ 1 • インストーラのダウンロード 2 • インストールの実行 3 • セットアップの実行 4 • Dominoの起動、各種設定の実施 5 • Dominoの起動、運用開始 ワンタッチ Domino セットアップ 1 • インストーラのダウンロード 2 • インストールの実行 3 • セットアップを –autoconf 付きで実行 • Dominoが自動起動、運用開始 ※Linuxの場合、リモートサーバーセットアップが不要になり超便利になりました

ワンタッチ Domino セットアップの どんな使い道があるの？ アプリ開発やテストの 環境を開発者の数だけ 作りたい • 永久ループ等による他の 開発者への影響に配慮 環境構築時の 設定ミスを削減したい • 作業手順を簡略化 • 作業工数（作業時間）の 削減 • 作業担当者の負担の削減 まっさらな Domino サーバーに 戻したい • ベータ版など検証環境の 再構築作業の簡略化

セットアップの構成情報 環境変数よりJSONをお勧めする理由

構成情報 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

構成情報に設定可能な項目数 JSON > 環境変数 設定項目 パラメータ JSON 環境変数 ユーザーの追加 serverSetup/registerUsers/ ○ × アプリの設定 appConfiguration/ ○ × 環境変数に実装されていない（ヘルプに記載のない）設定項目がある

比較 JSON • パラメータが単純化されるため読 みやすい • 構造がわかりやすい • フル機能を利用できる • 記述ルールが厳しくカンマ忘れな どのエラーが発生しやすい 環境変数 • 同じ様な名称がパラメータ名に何 度も登場するため読みづらい • パラメータの記述順の自由度が高 い • 一部機能が利用できない

ワンタッチ Domino セットアップを 実行してみた JSONファイルを使い ワンタッチ Domino セットアップで Nomad Server を構築する

{ "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": "[email protected]" }, { "firstName": "Hideki", "middleName": "", "lastName": "Masui", "shortName": "HMasui", "mailFilePath": "mail/HMasui.nsf", "IDFilePath": "HMasui.id", "internetAddress": "[email protected]" } ] } }, 次ページへ続く 使用する構成情報（JSON） 1/2

"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

実行するには (Windowsの場合) nserver.exe サーバープログラム 本体 Dominoプログラム ディレクトリ -autoconf ワンタッチセットアップの オプション setup.json 構成情報を記述した ファイル C:¥Program Files¥HCL¥Domino >nserver.exe –autoconf c:¥temp¥setup.json

実行結果は Dominoデータディレクトリ内の IBM_TECHNICAL_SUPPORT フォルダに作成される autoconfigure.log あるいは console__.log

No content

Domino 12.0.x ワンタッチ Domino セットアップ まとめ • 構成情報にはJSONの使用をお勧めします • 現状は「別名」を設定できない。ユーザーの日本語名を使用するにはセットアッ プ後にもうひと手間必要です ↓別名追加のアイデアにご賛同くださいませ