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)
   

   View Slide

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
   ↓環境変数
   

   View Slide

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

   View Slide

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

   View Slide

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

   View Slide

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

   View Slide

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
   

   View Slide

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

   View Slide

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

   View Slide

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

    View Slide

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
    

    View Slide

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
    

    View Slide

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

    View Slide

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

    View Slide

15. View Slide

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

    View Slide