$30 off During Our Annual Pro Sale. View Details »

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

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

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

Haruyuki Nakano

October 15, 2022
Tweet

More Decks by Haruyuki Nakano

Other Decks in How-to & DIY

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 のセットアップ
    を1つのステップで行うことが可能になる
    • この機能を呼び出すにはセットアップの構成情報を含む 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": "[email protected]"
    },
    {
    "firstName": "Hideki",
    "middleName": "",
    "lastName": "Masui",
    "shortName": "HMasui",
    "mailFilePath": "mail/HMasui.nsf",
    "IDFilePath": "HMasui.id",
    "internetAddress": "[email protected]"
    }
    ]
    }
    },
    次ページへ続く
    使用する構成情報(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