1. コマンドライン・インタフェース
  2. Verbリファレンス
  3. EM CLI Verb
  4. manage_agent_partnership

manage_agent_partnership

パートナ・エージェントをエージェントに自動的に割り当てるEnterprise Managerのデフォルト動作を上書きします。パートナ・エージェントは、他の機能に加え、別のエージェントにパートナとして割り当てられるエージェントです。そのエージェントとホストの可用性をリモートで監視します。通常、パートナ・エージェントは、リモート監視対象のエージェントと近いネットワーク近接度(同じサブネットなど)に存在します。1つのエージェントを複数のエージェントのパートナ(リモート・モニター)にすることができます。1つのエージェントに割り当てることができるのは1つのパートナ・エージェントのみです。

このVerbは一般的に使用されるものではありません。これは、特殊な状況に対応するために提供されています。管理者がエージェントのパートナシップを明示的に割り当てる場合や、エージェントをパートナとして除外する場合、エージェントが他のエージェントのリモート監視対象から除外する場合などです。

書式

標準モード

emcli manage_storage_access
          [-add_agent_partnership]
          [-remove_agent_partnership]
          [-enable_agent_partnership]
          [-disable_agent_partnership]
          [-partner_agent="partneragent"]
          [-monitored_agent="monitoredagent"]

インタラクティブまたはスクリプト・モード

manage_agent_partnership(
          [add_agent_partnership=True/False]
          [,remove_agent_partnership=True/False]
          [,enable_agent_partnership=True/False]
          [,disable_agent_partnership=True/False]
          [,partner_agent="partneragent"]
          [,monitored_agent="monitoredagent"]
          )

[ ]  indicates that the parameter is optional.

パラメータ

  • add_agent_partnership

    パートナ・エージェントをエージェントに割り当てます。monitored_agentおよびpartner_agentパラメータも指定する必要があります。

  • remove_agent_partnership

    パートナ・エージェントと監視対象エージェントのパートナシップを削除します。リモートで監視されるエージェントの場合は、そのエージェントとパートナ・エージェントの関係を削除するために、monitored_agentパラメータを指定する必要があります。必要に応じてpartner_agentを指定することもできます。パートナ・エージェントの場合、そのエージェントとリモート監視対象のすべてのエージェントの関係を削除するには、partner_agentパラメータを指定する必要があります。monitored_agentパラメータを指定しないと、パートナ・エージェントの現在のすべてのパートナシップが削除されます。

  • disable_agent_partnership

    エージェントがパートナ・エージェントにならないようにするか、監視対象エージェントにならないようにします。これは、使用する他のパラメータによって決まります。partner_agentパラメータを使用すると、指定のエージェントがパートナ・エージェント(他のエージェントをリモート監視する)にならないようにします。monitored_agentパラメータを使用すると、指定のエージェントが他のエージェントからリモート監視されないようにします。

  • enable_agent_partnership

    エージェントをパートナ・エージェントまたは監視対象エージェントにすることができます。これは、使用する他のパラメータによって決まります。partner_agentパラメータを使用すると、指定のエージェントがパートナ・エージェント(他のエージェントをリモート監視する)になることができます。monitored_agentパラメータを使用すると、指定のエージェントを他のエージェントからリモート監視できるようになります。これらのアクションのうち1つのみ指定できます。

  • monitored_agent

    別のエージェントによってリモート監視されるエージェントの名前。通常は、次のようなフォームです 
    host:port
    、たとえば 
    myhost.example.com:1830
    です。

  • partner_agent

    別のエージェントとそのホストの可用性をリモートで監視するエージェントの名前。通常は、次のようなフォームです 
    host:port
    、たとえばm
    yhost.example.com:1830
    です。

終了コード

正常終了した場合は0。0以外の値は、verb処理が正常終了しなかったことを示します。

出力

例1

この例では、agent2をagent1のパートナ・エージェントとして割り当てます。

emcli manage_agent_partnership
          -add_agent_partnership
          -monitored_agent=agent1.example.com:1830 
          -partner_agent=agent2.example.com:1833

例2

この例では、agent2のagent1のパートナ・エージェントとしての割当てを解除します。agent1にパートナ・エージェントがない場合は例外がスローされます。

emcli manage_agent_partnership
          -remove_agent_partnership
          -monitored_agent=agent1.example.com:1830
          -partner_agent=agent2.example.com:1833

例3

この例では、agent2がリモート監視するすべてのエージェントで、agent2のパートナ・エージェントとしての割当てを解除します。agent1がどのエージェントに対してもパートナ・エージェントでない場合は、例外がスローされます。

emcli manage_agent_partnership
          -remove_agent_partnership
          -partner_agent=agent2.example.com:1833

例4

この例では、agent3にパートナ・エージェントを割り当てないようにします。つまり、agent3を別のエージェントでリモート監視することはできません。

emcli manage_agent_partnership
          -disable_agent_partnership
          -monitored_agent=agent3.example.com:1830

例5

この例では、agent4が任意のエージェントのパートナ・エージェントにならないようにします。つまり、別のエージェントをリモート監視するためにagent4を使用できません。

emcli manage_agent_partnership
          -disable_agent_partnership
          -partner_agent=agent4.example.com:1833

例6

この例では、agent3をリモート監視するためにagent3にパートナ・エージェントを割り当てられるようにします。

emcli manage_agent_partnership
          -enable_agent_partnership
          -monitored_agent= agent3.example.com:1830

例7

この例では、agent4が他のエージェントのパートナになれるようにします。つまり、別のエージェントをリモート監視するためにagent4を使用できます。

emcli manage_agent_partnership
          -enable_agent_partnership
          -partner_agent= agent4.example.com:1833