Server_Restricted
かなり古い話題ですが、皆さんご存知のように、移行の際には、UserからのAccessを制限する為に、Server_RestrictedというNotes.iniを使って、UserのAccessを制限します。
Server_Restricted=1を設定すると、新規のUser Sessionは禁止されます。
この場合、Serverを再起動するとこのNotes.iniは無効になり、UserはAccess出来るようになりますので、一時的な処置です。
例えば、Serverに変更を加えたい場合に、UserのAccessを禁止したい場合に、
set config Server_Restricted=1
drop all
のように利用すると、UserのSessionを切断して、2度とUser Sessionを張らせないように制御できます。
Server_Restricted=2の場合も同じですが、ServerをRestartをしても効果は持続しますので、移行作業の際にUserからのSessionを禁止したい場合に利用されて来ました。
所が、このパラメーターでは、Replica Sessionが禁止できません。
勿論、Server管理者は自由にAccessすることが可能です。
後者は仕方ないにしても、前者は問題になります。
システム変更作業中にDBが更新されてしまうと、Fall Backに影響するからです。
そこで、Domino 8.5.2FP3以降では、Server_Restricted=3やServer_Restricted=4というパラメーターが追加されています。
Server_Restricted=3に設定すると、UserからのReplica Sessionも禁止されます。
Server_Restricted=4の場合は、Serverを再起動してもその効果は持続するという訳です。
完全に、他のServerやUserからのSessionを禁止したい場合には、
set config Server_Restricted=4
drop all
を発行してから、作業を始めると、Sessionが禁止され、単独テストが出来るようになるのです。
詳しくは、IBM Technote に記載がありますので、参照してください。
Domino AdministratorでのMail監視 -12-
<話題の履歴>
Domino AdministratorでのMail監視 -1-
Domino AdministratorでのMail監視 -2-
Domino AdministratorでのMail監視 -3-
Domino AdministratorでのMail監視 -4-
Domino AdministratorでのMail監視 -5-
Domino AdministratorでのMail監視 -6-
Domino AdministratorでのMail監視 -7-
Domino AdministratorでのMail監視 -8-
Domino AdministratorでのMail監視 -9-
Domino AdministratorでのMail監視 -10-
Domino AdministratorでのMail監視 -11-
前回は、Notes/DominoのAgentだけでMail滞留監視を実現してみました。
今回は、設計を触ることなく、通常の運用Operatorが容易に閾値の設定変更を出来るように改造してみます。
前回までのCodeでは、Constantとして定義していた以下の部分をFormでの設定に移します。
Const Max_Wait = 0
Const Max_Hold = 0
Const Max_Dead = 0
まず、Thresholdを設定するFormを作成します。
通常使うことがありませんので、Formは隠しFormとします。
以下のようにFormにFieldを作成します。
Srv_Nameは計算結果Fieldとして、設定を作成するServer名を自動的に取得するようにしています。
No_MBはMail.boxの数を取得する予定でFieldだけ確保しておきました。
それ以外は、閾値を設定する編集可能な数値Fieldです。
次に、Default Viewを変更して、Configuration文書作成のAction Buttonを作成し、以下のように単純なViewを作成し、Configuration文書を登録します。
1列目はSrv_Nameを完全階層形式で表示していますが、LotusScriptからLookupしなければなりませんのでSortを指定していて、非表示列となっています。それ以外は単にFieldの値を表示するだけです。
準備ができましたので、LotusScriptでConstantで指定していた部分をConfiguration文書から取得するように変更します。
以下のようなCodeです。
Dim Max_Wait As Long
Dim Max_Hold As Long
Dim Max_Dead As Long
'Get server name and warning threshold.
Set db = ss.Currentdatabase
sv_name = db.Server
Set vw = db.Getview("Config")
Set doc = vw.Getdocumentbykey(sv_name, True)
If doc Is Nothing Then
Print "Configuration document for " & sv_name & " is not exist."
Exit Sub
Else
Max_Wait = CLng(doc.Max_Wait(0))
Max_Hold = CLng(doc.Max_Hold(0))
Max_Dead = CLng(doc.Max_Dead(0))
End If
ここでは、Configuration文書はServer名で一意に決まることを前提としていますので、誤って複数登録されていることを考慮する場合はError Handlingを追加する必要があります。
このCodeを実行すると以下のようになります。
> tell amgr run "Test\MBCheck.nsf" 'ChkMailboxDoc'
[0990:0008-080C] 2015/05/10 12:57:29 AMgr: Start executing agent 'ChkMailboxDoc' in 'Test\MBCheck.nsf'
[0990:0008-080C] 2015/05/10 12:57:29 Agent Manager: Agent printing: Mail box ( 1 ) All : 2
[0990:0008-080C] 2015/05/10 12:57:29 Agent Manager: Agent printing: Wait: 0
[0990:0008-080C] 2015/05/10 12:57:29 Agent Manager: Agent printing: Hold: 2
[0990:0008-080C] 2015/05/10 12:57:29 Agent Manager: Agent printing: Dead: 0
[0990:0008-080C] 2015/05/10 12:57:29 Agent Manager: Agent printing: Mail box ( 2 ) All : 2
[0990:0008-080C] 2015/05/10 12:57:29 Agent Manager: Agent printing: Wait: 0
[0990:0008-080C] 2015/05/10 12:57:29 Agent Manager: Agent printing: Hold: 2
[0990:0008-080C] 2015/05/10 12:57:29 Agent Manager: Agent printing: Dead: 0
[0990:0008-080C] 2015/05/10 12:57:29 Agent Manager: Agent printing: All mail boxes ( Mail boxes : 2 ) :4
[0990:0008-080C] 2015/05/10 12:57:29 Agent Manager: Agent printing: Wait: 0
[0990:0008-080C] 2015/05/10 12:57:29 Agent Manager: Agent printing: Hold: 4
[0990:0008-080C] 2015/05/10 12:57:29 Agent Manager: Agent printing: Dead: 0
[0990:0008-080C] 2015/05/10 12:57:29 Agent Manager: Agent printing: Hold over: 4 ( Threshold : 0 )
[0990:0008-080C] 2015/05/10 12:57:29 Agent Manager: Agent printing: Dead over: 0 ( Threshold : 0 )
[0990:0008-080C] 2015/05/10 12:57:29 AMgr: Agent 'ChkMailboxDoc' in 'Test\MBCheck.nsf' completed execution
正常に実行されていることが確認できました。
これで、OperatorがConfiguration文書のThresholdを変更するだけで、Mail.boxのCheckの閾値を変更できるようになりました。
しかし、Operatorが誤って同じServerのConfiguration文書を複数登録してしまったりすることもあるでしょうし、Mail.boxのCheck AgentをOperatorが開始/停止したいという要望もあるかも知れません。
今回は、Mail.boxのCheckの閾値をFormでの設定から変更できるようにしてみました。
次回は、もう少し改善を行いたいと思います。
Domino AdministratorでのMail監視 -11-
<話題の履歴>
Domino AdministratorでのMail監視 -1-
Domino AdministratorでのMail監視 -2-
Domino AdministratorでのMail監視 -3-
Domino AdministratorでのMail監視 -4-
Domino AdministratorでのMail監視 -5-
Domino AdministratorでのMail監視 -6-
Domino AdministratorでのMail監視 -7-
Domino AdministratorでのMail監視 -8-
Domino AdministratorでのMail監視 -9-
Domino AdministratorでのMail監視 -10-
前回は、単純なSample ProgramでRemote Console CommandのResponseが正常に判断出来ることを確認しました。
今回は、この結果から、以前作成したAgentを修正してOSに頼らないRecovery処理を実現してみます。
前回の実験でSendConsoleCommandによる値が正常に取れていることは確認できています。
最初からちゃんと実験してWindows Batchなど使わないで実装する方法を試せという言葉が聞こえて来そうですが、色々な方法を試すのも良い事ですのでお許しください。
では、早速SendConsoleCommandを使った方法を実装して行きますが、修正部分はCode全体からすると最後の部分のみとなります。
前回記述した以下の部分を修正して行きます。
'Print error message and reload router when over the threshold.
If wait_cnt_all => Max_Wait Then
Print "Wait over : " & CStr(wait_cnt_all) & " ( Threshold : " & CStr(Max_Wait) & " )"
Print "Maybe router has some problem, router is restarted in a few minuttes."
os_ret = Shell("reloadrouter.bat")
End If
今回のLogicは以下のようになります。
[Wait MailがThresholdを超えた場合]
Router Taskの存在を確認("show tasks only"の結果でRouterの有無を確認)
>> 存在する場合
Router Taskの応答を確認("tell router status"の結果でRouterのCommand受入を確認)
>> 応答する場合
Router Taskの問題ではないと判断し、Message表示
>> 応答しない場合
Router Taskの問題と判断し、"restart task router"でRouter再起動
>> 存在しない場合
"load router"でRouter起動
前回も書きましたが、このLogicはRouter Taskが存在しない場合は問題ないと思いますが、Router Taskが存在し何らかの原因でRouterに異常がある場合は"tell router status"が応答しないことを前提としています。
Routerの起動時にMail.boxのConsistency CheckでRouter起動の待ち時間がTimeoutしてしまいRouterが自動終了してしまった場合は、SMTP Taskや他のServerが書き込んだMailがMail.boxに滞留し始め、Thresholdを超えた段階でRouterがLoadされることになります。
この場合、Thresholdの設定は、ServerのMail流量を把握して適切な値を設定することが重要になります。
Router Taskが動作している場合であれば、RouterのLoadは行われませんので、低い値に設定するのも手だと思います。
Routerの起動時にConsistency Checkが原因でMail.boxのFile TableにAccessできない場合は、Router Taskは稼働している状態のままMail.boxが参照できない状態に陥ると考えられますが、この場合には、"tell router status"がどのような状態を返すかによります。
もし、Tell CommandをAcceptしてしまうようであれば、上記のLogicは通用しないということに注意してください。
ただ、このような状態でもMessageだけは表示しますので、自動修復は行えませんが、Operatorが監視しているような環境であれば対処することは可能でしょう。
こういう注意点があるということを前提にCodeを書くと以下のようになります。
'Print error message and reload router when over the threshold.
If wait_cnt_all => Max_Wait Then
Print "Wait over : " & CStr(wait_cnt_all) & " ( Threshold : " & CStr(Max_Wait) & " )"
'Check router task status.
cons_ret = ss.Sendconsolecommand("", "show tasks only")
If InStr(cons_ret, "Router") > 0 Then 'Router task exist
'Check router task response.
cons_ret = ss.Sendconsolecommand("", "tell router status")
If InStr(cons_ret, "The ROUTER task either does not exist") > 0 Then 'Router not responding
cons_ret = ss.Sendconsolecommand("", "restart task router")
Print "Restarting router task is executed by agent."
Else
Print "Maybe router/network/other server(s) have some problem, please check server status."
End If
Else 'Router task does not exist
cons_ret = ss.Sendconsolecommand("", "load router")
Print "Loading router task is executed by agent."
End If
End If
Routerが正常稼働している場合に影響が無いかを確認す意味も含め、Mail Waitの閾値を0に設定して実行すると以下のようになります。
> tell amgr run "Test\MBCheck.nsf" 'ChkMailboxDoc'
[0EA4:0027-078C] 2015/05/09 22:04:42 AMgr: Start executing agent 'ChkMailboxDoc' in 'Test\MBCheck.nsf'
[0EA4:0027-078C] 2015/05/09 22:04:42 Agent Manager: Agent printing: Mail box ( 1 ) All : 2
[0EA4:0027-078C] 2015/05/09 22:04:42 Agent Manager: Agent printing: Wait: 0
[0EA4:0027-078C] 2015/05/09 22:04:42 Agent Manager: Agent printing: Hold: 2
[0EA4:0027-078C] 2015/05/09 22:04:42 Agent Manager: Agent printing: Dead: 0
[0EA4:0027-078C] 2015/05/09 22:04:42 Agent Manager: Agent printing: Mail box ( 2 ) All : 2
[0EA4:0027-078C] 2015/05/09 22:04:42 Agent Manager: Agent printing: Wait: 0
[0EA4:0027-078C] 2015/05/09 22:04:42 Agent Manager: Agent printing: Hold: 2
[0EA4:0027-078C] 2015/05/09 22:04:42 Agent Manager: Agent printing: Dead: 0
[0EA4:0027-078C] 2015/05/09 22:04:42 Agent Manager: Agent printing: All mail boxes ( Mail boxes : 2 ) :4
[0EA4:0027-078C] 2015/05/09 22:04:42 Agent Manager: Agent printing: Wait: 0
[0EA4:0027-078C] 2015/05/09 22:04:42 Agent Manager: Agent printing: Hold: 4
[0EA4:0027-078C] 2015/05/09 22:04:42 Agent Manager: Agent printing: Dead: 0
[0EA4:0027-078C] 2015/05/09 22:04:42 Agent Manager: Agent printing: Wait over: 0 ( Threshold : 0 )
> show tasks only >C:\Users\ADMINI~1\AppData\Local\Temp\notes048967\rem83932.con
> tell router status >C:\Users\ADMINI~1\AppData\Local\Temp\notes048967\rem98186.con
>
[057C:0002-0090] Msgs State Via Destination
[057C:0002-0090] Transfer Threads: Max = 25; Total = 0; Inactive = 0; Max Concurrent = 12
[057C:0002-0090] Delivery Threads: Max = 25; Total = 1; Inactive = 0
[057C:0002-0090] Dispatch Threads: Max = 4; Total = 2; Inactive = 2
[057C:0002-0090] Sweep Threads: Max = 4; Total = 2; Inactive = 2
[0EA4:0027-078C] 2015/05/09 22:04:43 Agent Manager: Agent printing: Maybe router/network/other server(s) have some problem, please check server status.
[0EA4:0027-078C] 2015/05/09 22:04:43 Agent Manager: Agent printing: Hold over: 4 ( Threshold : 0 )
[0EA4:0027-078C] 2015/05/09 22:04:43 Agent Manager: Agent printing: Dead over: 0 ( Threshold : 0 )
[0EA4:0027-078C] 2015/05/09 22:04:43 AMgr: Agent 'ChkMailboxDoc' in 'Test\MBCheck.nsf' completed execution
Messageが表示されますが、Router TaskのLoadやRestartは行われていません。
次にRouter Taskを停止した状態で実行すると以下のようになります。
> tell amgr run "Test\MBCheck.nsf" 'ChkMailboxDoc'
[0EA4:0028-0F5C] 2015/05/09 22:14:16 AMgr: Start executing agent 'ChkMailboxDoc' in 'Test\MBCheck.nsf'
[0EA4:0028-0F5C] 2015/05/09 22:14:16 Agent Manager: Agent printing: Mail box ( 1 ) All : 2
[0EA4:0028-0F5C] 2015/05/09 22:14:16 Agent Manager: Agent printing: Wait: 0
[0EA4:0028-0F5C] 2015/05/09 22:14:16 Agent Manager: Agent printing: Hold: 2
[0EA4:0028-0F5C] 2015/05/09 22:14:16 Agent Manager: Agent printing: Dead: 0
[0EA4:0028-0F5C] 2015/05/09 22:14:16 Agent Manager: Agent printing: Mail box ( 2 ) All : 2
[0EA4:0028-0F5C] 2015/05/09 22:14:16 Agent Manager: Agent printing: Wait: 0
[0EA4:0028-0F5C] 2015/05/09 22:14:16 Agent Manager: Agent printing: Hold: 2
[0EA4:0028-0F5C] 2015/05/09 22:14:16 Agent Manager: Agent printing: Dead: 0
[0EA4:0028-0F5C] 2015/05/09 22:14:16 Agent Manager: Agent printing: All mail boxes ( Mail boxes : 2 ) :4
[0EA4:0028-0F5C] 2015/05/09 22:14:16 Agent Manager: Agent printing: Wait: 0
[0EA4:0028-0F5C] 2015/05/09 22:14:16 Agent Manager: Agent printing: Hold: 4
[0EA4:0028-0F5C] 2015/05/09 22:14:16 Agent Manager: Agent printing: Dead: 0
[0EA4:0028-0F5C] 2015/05/09 22:14:16 Agent Manager: Agent printing: Wait over: 0 ( Threshold : 0 )
> show tasks only >C:\Users\ADMINI~1\AppData\Local\Temp\notes048967\rem75867.con
> load router >C:\Users\ADMINI~1\AppData\Local\Temp\notes048967\rem03092.con
[0470:0002-0C24] 2015/05/09 22:14:17 Router: Mail Router started for domain LOTUS
[0470:0002-0C24] 2015/05/09 22:14:17 Router: Internet SMTP host domsvr in domain lotus.com
[0EA4:0028-0F5C] 2015/05/09 22:14:17 Agent Manager: Agent printing: Loading router task is executed by agent.
[0EA4:0028-0F5C] 2015/05/09 22:14:17 Agent Manager: Agent printing: Hold over: 4 ( Threshold : 0 )
[0EA4:0028-0F5C] 2015/05/09 22:14:17 Agent Manager: Agent printing: Dead over: 0 ( Threshold : 0 )
[0EA4:0028-0F5C] 2015/05/09 22:14:17 AMgr: Agent 'ChkMailboxDoc' in 'Test\MBCheck.nsf' completed execution
Router Taskの停止が検知され、RouterがLoadされたことが分かります。
ここまでは期待通りの動きになっています。
本当にCheckしなかればならないのは、Router Taskが存在し、かつ、返答が無い場合なのですが、簡単にはそのような状況は作れませんので、実際にそのような状態になった場合に動作を確認するしかなさそうです。
もし、そのような状態になった場合は、AgentがPrintしているMessageをEvent HandlerでSyslogやEvent MonitorにMessageを記録するようにしておけば、他の方法を使って通知することが出来るでしょう。
また、Routerが正常である場合にMail滞留が起こっていることが検知された場合は、AgentがPrintしているMessageをEvent HandlerでSyslogやEvent MonitorにMessageを記録すると同時にEvent HandlerでNotes Mailとe-Mailを送付し注意を促すことが考えられます。
以前作成したOS側での検知に比べるとRemote Console Commandで作成されたFileの削除は不要ですし、MaintenanceもNotesの知識だけで行えるため、こちらの方がNotes/Domino Userの皆さんにとっては親しみやすいかも知れません。
以前作成したOS側での検知に関しても、"tell router status"の戻り値を判断するようにすれば、同様の監視が行えます。
今回は、Notes/DominoのAgentだけでMail滞留監視を実現してみました。
次回は、設計を触ることなく、通常の運用Operatorが容易に閾値の設定変更を出来るように改造してみます。


