Domino Document Managerを導入しよう ! -4-
<話題の履歴>
Domino Document Managerを導入しよう ! -3-
Domino Document Managerを導入しよう ! -2-
Domino Document Managerを導入しよう ! -1-
前回は、Domino Document Manager(Domino.Doc)のModule導入を行いました。
今回からは、Domino Document ManagerのSetupを行っていきます。
まず、Domino Document Managerの導入により、Notes.iniにどのような指定がされたかを見ることにします。
というのも、Domino Document ManagerをUninstallする際には、指定されたNotes.iniを消さなければなりませんので、どういった内容が指定されているかを見ておくことは重要なのです。
まず、ServerTasksに以下のようにddmTranという新しいAddin Taskが指定されています。
ServerTasks=Update,Replica,Router,AMgr,AdminP,CalConn,Sched,Statlog,HTTP,Stats,RnRMgr,ddmTran
これは、Domino Document ManagerがMaster/Replica構成された際に全てのServerの文書をLockするために使われるDomino Document ManagerのTransaction ManagerのTaskとなっています。
今回は、Master Serverのみの導入ですので、このTaskは稼動しなくても問題はありませんので、この部分は削除してください。
削除しないと、Serverを立ち上げると、DDMTrans関係のErrorが出ます。
Replica Serverを導入した場合は、再度指定する必要があります。
また、その他のNotes.iniとしては以下が指定されます。
DDMSetup=700010
DDMTransDB=domdoc\ddmtrans.nsf
DDMTransPollingInterval=60
DDMTransRetryInterval=60
DDMTransRetryFailCount=24
DDMTransSendMail=NO
DDMSiteAdminDB=domdoc\ddadmin.nsf
DDSMTimeOut=60
DDSMDailySchedule=3
DominoDisableFileUploadChecks=1
JavaUserClasses=C:\Lotus\DomDoc\Data\domino\java\NCSO.jar
ddapiLogLevel=3
ddapiLogSeparateFiles=0
ddapiLogDir=C:\Lotus\DomDoc\Data\IBM_TECHNICAL_SUPPORT
ddapiTempDir=C:\Lotus\DomDoc\Data\domdoc
ddapiXMLOutput=1
ここでは、これらのパラメーターの個々の意味については省略させていただきますが、Uninstall時にはこれらのパラメーターを削除しなければならないということだけ覚えておいてください。
では、ServerとNotes Clientを起動して、設定のために必要な情報を参照することにしましょう。
Serverのdomdoc Folderを空けると、以下のように6つのDBがあります。
Help DBが5個とサイト管理DBが生成されていますので、今回は全てを選択して、Bookmark登録します。
登録を行うと、途中でAccess権限がないというErrorになりますが、無視して進めてください。
実は、このDBの中でサイト管理DBについては、後ほど行う管理者Groupの設定がないとAccess不可能なDBになっているのです。
これで、Help関係の5つのDBがBookmarkに登録されたと思いますので、Installation Guideを参照して設定を行っていきます。
Notes DBで提供される導入マニュアルは英語しか提供されていませんので、ご注意ください。
また、以下に記述する導入方法はInstallation Guideの順序とは少し異なっています。
まず、Domino Administrator Clientを起動して、"Domino.Doc Site Administrators" GroupをServerのDomino Directoryに登録する必要があります。
このGroupに指定されたMemberがDomino Document Managerのサイト管理DBにAccessできるようになり、ライブラリーなどの作成ができるようになるのです。
Domino Administratorの「People & Groups」タブを開き、Groups Viewから「Add Group」 Actionボタンで新規にGroupを登録します。
以下のように、Group名は"Domino.Doc Site Administrators"とし、Typeはアクセス制御リストのみとし、Categoryや説明を分かりやすく付けます。
MemberにはDomino Serverの管理者と管理者Groupを指定します。
もし、Domino Serverの管理者以外がDomino Document Managerを管理される場合は、そのUserIDも指定してください。
Groupの作成が完了したら、Group文書を保存します。
Groupを作成しても直ぐに有効にはなりませんので、急ぐ場合は、Serverを再起動するかDomino Directoryを開いてShift+F9を押してDomino DirectoryのViewを更新するか、Server Consoleからload updall -r names.nsfを発行してViewの更新を行ってください。
また、Domino Document ManagerはDefaultでは以下の名前で始まるGroupを自動生成しますので、Domino Directoryにこれらの名前のGroupが登録されていないかを事前に確認しておいてください。
今回は評価環境に導入していますので、これらのGroup名は存在しませんので問題ありません。
Domino.Doc Administrators
Domino.Doc File Cabinet Creators
Domino.Doc Address Book Editors
Domino.Doc Servers
Domino.Doc Users
設定が終わったら、Document Manager サイト管理DBを開きます。
ECLの確認画面が出ますので、信頼するように設定します。
以下の画面が開いたら、基本的に設定は完了です。
また、このDBもBookmarkに追加しておいてください。
Demo/評価環境の場合は以上で設定が完了なのですが、Domino Document Managerを導入すると、Domino Document Managerが利用するTemplateとDocument Manager サイト管理DBは導入したServer IDで署名が行われるようになっています。
皆さんが本番の環境に導入される場合は、このままですとUserがDBを開いた際にECLの確認画面が出てしまうことになります。
Server IDを会社で利用されるECL Listに追加されている場合は少ないのではないでしょうか?
このような場合は事前にDomino Document Managerが利用するTemplateとDocument Manager サイト管理DBをECLに設定されている管理者IDで署名しておいた方がいいでしょう。
署名は、Domino Administrator Clientから行います。
まずはTemplateの署名ですが、File一覧で、Templateのみ表示にして署名します。
署名の対象となるのは上図の6個のTemplateが対象となりますが、念のために以下に示します。
Document Manager ライブラリ (domdoc.ntf)
Document Manager ログ (dmlog.ntf)
Document Manager 設定 (ddmconfg.ntf)
Document Manager サイト管理 (ddadmin.ntf)
Document Manager Transactions (ddmtrans.ntf)
キャビネット (filecab.ntf)
名前順でSortすると「キャビネット」だけが離れて表示されますのでご注意ください。
最後にFixupが行われた日でSortすると、並んで表示されますので、署名のし忘れがなくなります。
署名は以下のように現在のUser IDで署名を行います。
署名を行うと、以下のように/Lotustwの認証の追加が要求されますが、「Yes」で答え、認証を追加します。
認証を追加しなくても署名はできますが、毎回聞かれることになるため、とりあえず追加して後で消しておけば問題はありません。
6つのDBを署名しますので、署名には暫く時間がかかります。
Message Areaを見て完全に6つのDBへの署名がErrorせずに完了したことを確認してください。
同様に、domdoc Folderの中にある、Document Manager サイト管理DBを署名してください。
今回は、Domino Document Managerの導入と設定について解説しました。
次回は、Domino Document Managerを実際に使って簡単な稼動検証を行っていきます。
Notes/Domino関連Blog
Notes/Domino関連のBlogで「Notes/Dominoでちょっとコネタ」 というBlogがあります。
このBlogは日本IBMシステムズエンジニアリングでNotes/Domino関係の技術を担当されている村上雄介さんが書かれているBlogです。
村上さんといえば、以前、Notes/Domino Managineが健在だったころ、時々記事を書かれていた方です。
このBlogもBookmark登録させて頂きました。
皆さんも参照してみてください。
Notes/Dominoの未読文書管理の仕組 -15-
<話題の履歴>
前回は、Technoteの内容をまとめて解説しました。
今回は、前回のまとめの中で幾つか検証していない点についてもう少し検証してみます。
例えば、TechnoteではUnread Activity Logは最新の物だけ相手に送信されることになっています。
これを試すためには、一つの文書を何度か未既読を変更し、前回と同様にNRPC TraceをServer間のReplicaで取得してやることで確認ができます。
取得されるTraceは以下のようになります。
[1文書を未読に変更した場合]
((6-6378 [278]) DB_REPLINFO_GET: 10 ms. [14+32=46]
(7-6378 [279]) SEARCH: 0 ms. [60+46=106]
(8-6378 [280]) START_FOLDER_REPL_SOURCE: 0 ms. [34+50=84] (Folders in database are up to date)
(9-6378 [281]) GET_UNREAD_REPL_ENTRIES: 10 ms. [354+56=410] (Cache entry not found)
(10-6378 [282]) WRITE REPLICATION HISTORY: 0 ms. [110+12=122]
(11-6378 [283]) GET_SPECIAL_NOTE_ID: 10 ms. [16+16=32]
(12-6378 [284]) READ_OBJECT(REP49257118:001FE135-RRV00000122,0xFFFFFFFF at 0x0): 0 ms. [26+344=370]
(13-6378 [285]) READ REPLICATION HISTORY: 30 ms. [66+512=578]
(14-6378 [286]) DB_REPLINFO_GET: 0 ms. [14+32=46]
(15-6378 [287]) START_FOLDER_REPL_DEST: 10 ms. [28+26=54]
(16-6378 [288]) APPLY_UNREAD_REPL_ENTRIES: 0 ms. [138+36=174]
(17-6378 [289]) WRITE REPLICATION HISTORY: 0 ms. [110+12=122]
(18-6378 [290]) DB_REPLINFO_GET: 10 ms. [14+32=46]
[同じ文書を既読/未読変更した場合(2回変更)]
(6-1034 [168]) DB_REPLINFO_GET: 0 ms. [14+32=46]
(7-1034 [169]) SEARCH: 0 ms. [60+46=106]
(8-1034 [170]) START_FOLDER_REPL_SOURCE: 0 ms. [34+50=84] (Folders in database are up to date)
(9-1034 [171]) GET_UNREAD_REPL_ENTRIES: 10 ms. [354+56=410] (Cache entry not found)
(10-1034 [172]) WRITE REPLICATION HISTORY: 0 ms. [110+12=122]
(11-1034 [173]) GET_SPECIAL_NOTE_ID: 0 ms. [16+16=32]
(12-1034 [174]) READ_OBJECT(REP49257118:001FE135-RRV00000122,0xFFFFFFFF at 0x0): 10 ms. [26+344=370]
(13-1034 [175]) READ REPLICATION HISTORY:
2006/05/07 15:14:52 Starting replication with server DDSrv/LotusSW
2006/05/07 15:14:52 Pulling DDSrv/LotusSW Test\UnreadTest.nsf from Test\UnreadTest.nsf
61 ms. [66+512=578]
(14-1034 [176]) DB_REPLINFO_GET: 0 ms. [14+32=46]
(15-1034 [177]) START_FOLDER_REPL_DEST: 10 ms. [28+26=54]
(16-1034 [178]) APPLY_UNREAD_REPL_ENTRIES: 0 ms. [174+36=210]
(17-1034 [179]) WRITE REPLICATION HISTORY: 0 ms. [110+12=122]
(18-1034 [180]) DB_REPLINFO_GET: 0 ms. [14+32=46]
[同じ文書を既読/未読変更した場合(3回変更)]
(6-1527 [188]) DB_REPLINFO_GET: 0 ms. [14+32=46]
(7-1527 [189]) SEARCH: 10 ms. [60+46=106]
(8-1527 [190]) START_FOLDER_REPL_SOURCE: 0 ms. [34+50=84] (Folders in database are up to date)
(9-1527 [191]) GET_UNREAD_REPL_ENTRIES: 0 ms. [354+56=410] (Cache entry not found)
(10-1527 [192]) WRITE REPLICATION HISTORY: 10 ms. [110+12=122]
(11-1527 [193]) GET_SPECIAL_NOTE_ID: 0 ms. [16+16=32]
(12-1527 [194]) READ_OBJECT(REP49257118:001FE135-RRV00000122,0xFFFFFFFF at 0x0): 0 ms. [26+344=370]
(13-1527 [195]) READ REPLICATION HISTORY: 10 ms. [66+512=578]
(14-1527 [196]) DB_REPLINFO_GET: 0 ms. [14+32=46]
(15-1527 [197]) START_FOLDER_REPL_DEST: 0 ms. [28+26=54]
(16-1527 [198]) APPLY_UNREAD_REPL_ENTRIES: 20 ms. [210+36=246]
(17-1527 [199]) WRITE REPLICATION HISTORY: 10 ms. [110+12=122]
(18-1527 [200]) DB_REPLINFO_GET: 0 ms. [14+32=46]
ここで、見ていただくと分かるのは、同一文書に対するUnread Log情報は実際にはReplicaで送信されているということです。
差を見ていただくと分かる通り、一つの未既読Transactionに対して、36 BytesのDataが増えていくことがわかります。
36 Bytesというのは以前も調べたように一つの未既読Transactionで送信されるDataとなっています。
ということは、この部分に関してはTechnoteの記述は間違っているということになりますが、実は今回はLocal Replicaもある状態でTestしている関係から、こういうことになってしまっているのかも知れません。
これを確かめるために、新規にDBをCopyして作成して試してみておくことにしましょう。
最初のReplicaでは多くの情報がやり取りされてしまうために、一度Replicaしてから行うことにします。
この状態でTestして取得したNRPC Traceは以下になります。
[1文書を未読に変更した場合]
(6-8065 [431]) DB_REPLINFO_GET: 10 ms. [14+32=46]
(7-8065 [432]) SEARCH: 2006/05/07 17:12:03 Starting replication with server DDSrv/LotusSW
2006/05/07 17:12:03 Pulling DDSrv/LotusSW Test\UnreadTest2.nsf from Test\UnreadTest2.nsf
1161 ms. [60+1336364=1336424]
(8-8067 [433]) START_FOLDER_REPL_SOURCE: 0 ms. [34+50=84]
(9-8067 [434]) GET_FOLDER_REPL_OPS: 0 ms. [56+54=110]
(10-8067 [435]) END_FOLDER_REPL_SOURCE: 10 ms. [56+12=68]
(11-8067 [436]) GET_UNREAD_REPL_ENTRIES: 0 ms. [354+148=502]
(12-8067 [437]) WRITE REPLICATION HISTORY: 0 ms. [112+12=124]
(13-8067 [438]) GET_SPECIAL_NOTE_ID: 0 ms. [16+16=32]
(14-8067 [439]) READ_OBJECT(REP49257167:002B682D-RRV0000014A,0xFFFFFFFF at 0x0): 0 ms. [26+250=276]
(15-8067 [440]) READ REPLICATION HISTORY: 10 ms. [68+512=580]
(16-8067 [441]) DB_REPLINFO_GET: 0 ms. [14+32=46]
(17-8067 [442]) START_FOLDER_REPL_DEST: 0 ms. [28+26=54]
(18-8067 [443]) APPLY_UNREAD_REPL_ENTRIES: 0 ms. [138+36=174]
(19-8067 [444]) WRITE REPLICATION HISTORY: 10 ms. [112+12=124]
(20-8067 [445]) DB_REPLINFO_GET: 0 ms. [14+32=46]
[同じ文書を既読/未読変更した場合(2回変更)]
(6-8115 [453]) DB_REPLINFO_GET: 0 ms. [14+32=46]
(7-8115 [454]) SEARCH: 10 ms. [60+46=106]
(8-8115 [455]) START_FOLDER_REPL_SOURCE: 0 ms. [34+50=84] (Folders in database are up to date)
(9-8115 [456]) GET_UNREAD_REPL_ENTRIES: 0 ms. [354+56=410] (Cache entry not found)
(10-8115 [457]) WRITE REPLICATION HISTORY: 0 ms. [112+12=124]
(11-8115 [458]) GET_SPECIAL_NOTE_ID: 10 ms. [16+16=32]
(12-8115 [459]) READ_OBJECT(REP49257167:002B682D-RRV0000014A,0xFFFFFFFF at 0x0): 0 ms. [26+250=276]
(13-8115 [460]) READ REPLICATION HISTORY: 10 ms. [68+512=580]
(14-8115 [461]) DB_REPLINFO_GET: 0 ms. [14+32=46]
(15-8115 [462]) START_FOLDER_REPL_DEST: 0 ms. [28+26=54]
(16-8115 [463]) APPLY_UNREAD_REPL_ENTRIES: 10 ms. [174+36=210]
(17-8115 [464]) WRITE REPLICATION HISTORY: 0 ms. [112+12=124]
(18-8115 [465]) DB_REPLINFO_GET: 0 ms. [14+32=46]
やはり、新規に作成したDBでも状況は変わりません。
ここで、言える事は、Replicator自身は、同一文書への変更であっても、相手に対して全てのUnread Activity Logを送るということです。
今回のTestではReplicatorが全てのTransactionを送付するというところまでは分かりましたが、実際にUnread Activity Logがこのまま情報を収めているかどうかは見ることができません。
もしかしたら、Technoteが書いているように、相手先のUnread Activity LogではReplica Server間の時間補正が行われた上で、最新の未既読情報のみを持っているかも知れませんが、今回はこれ以上は解析は困難ですので、行わないことにします。
しかし、このTestから言える事は、Unread Activity LogもAccess頻度が高いDBではReplicationで交換されるDataが多くなることも考えられるということです。
Unread Activity LogのReplicationを行う際にはこういったことも考慮しておくことも重要なのです。
今回は、Unread Activity LogのTransaction DataのReplicationについて調べてみました。
次回は、Technoteに書かれている内容で、まだ検証していない部分を検証していきます。
<続く>




