A Microsoft SCOMのカスタマイズ

この付録では、SCOMマッピングおよびその他の様々な構成のデフォルトについて、次の各項で説明します。

A.1 Microsoft SCOMアラートのXML書式

Microsoft SCOM Webサービス用の作成書式のサンプルは、新しいアラートを作成するためにMicrosoft SCOM Webサービスに必要な書式を示しています。

Microsoft SCOM Webサービス用の作成書式のサンプルは、アラートを更新するためにMicrosoft SCOM Webサービスに必要な書式を示しています。

注意:

アラート履歴情報は、SCOM 2007とSCOM 2012では引渡し方法が異なっています。

SCOM 2012の場合、履歴情報はlogs/log/descriptionフィールドに渡されます。
SCOM 2007の場合、履歴情報は<string-field name="AlertHistory"></string-field>フィールドに渡されます。

A.1.1 Microsoft SCOM Webサービス用の作成書式のサンプル

<iwaveaf:create xmlns:iwaveaf="http://iwavesoftware.com/services/adapter-framework">
  <event>
    <summary></summary>
    <description></description>
    <severity></severity>
    <priority></priority>
    <logs>                <--------For SCOM 2012
      <log>
        <description></description>
      </log>
    </logs>
    <extended-fields>
      <string-field name="CustomField1"></string-field>
      ...
      <string-field name="CustomField10"></string-field>
    </extended-fields>
  </event>
</iwaveaf:create>

A.1.2 Microsoft SCOM Webサービス用の更新書式のサンプル

<iwaveaf:update xmlns:iwaveaf="http://iwavesoftware.com/services/adapter-framework">
  <event>
    <identifier></identifier>
    <status></status>
    <logs>                <--------For SCOM 2012
      <log>
        <description></description>
      </log>
    </logs>
    <extended-fields>
      <string-field name="AlertHistory"></string-field>        <--------For SCOM 2007
      <string-field name="CustomField1"></string-field>
      …
      <string-field name="CustomField10"></string-field>
    </extended-fields>
  </event>
</iwaveaf:update>

A.1.3 XML書式とアラート・フィールド名とのマッピング

表A-1は、Microsoft SCOMアラート・フィールド名と、SCOMでのアラートの作成時にMicrosoft SCOM Webサービスで使用されるXML書式とのマッピングを示しています。表A-2は、Microsoft SCOMアラート・フィールド名と、SCOMでのアラートの更新時にMicrosoft SCOM Webサービスで使用されるXML書式とのマッピングを示しています。

Microsoft SCOM Webサービスに提示されるXML文書には、対応するフィールドが設定されている必要があります。アスタリスク(*)が付いているフィールドはオプションです。これには、表A-1に示した適切な変換ファイルでの処理が必要です。

表A-1 アラート作成属性とXMLパス・マッピング

Microsoft SCOMフィールド名	XMLパス	属性名	属性値
Name	/create/event/summary
Description	/create/event/description
Severity	/create/event/severity
Priority	/create/event/priority
Alert History	/create/event/logs/log/description
* Owner	/create/event/owner
* Custom Field 1	/create/event/extended-fields/string-field	name	CustomField1
* Custom Field 2	/create/event/extended-fields/string-field	name	CustomField2
* Custom Field 3	/create/event/extended-fields/string-field	name	CustomField3
* Custom Field 4	/create/event/extended-fields/string-field	name	CustomField4
* Custom Field 5	/create/event/extended-fields/string-field	name	CustomField5
* Custom Field 6	/create/event/extended-fields/string-field	name	CustomField6
* Custom Field 7	/create/event/extended-fields/string-field	name	CustomField7
* Custom Field 8	/create/event/extended-fields/string-field	name	CustomField8
* Custom Field 9	/create/event/extended-fields/string-field	name	CustomField9
* Custom Field 10	/create/event/extended-fields/string-field	name	CustomField10
* Alert Parameter 2	/create/event/extended-fields/string-field	name	AlertParameter2
* Alert Parameter 3	/create/event/extended-fields/string-field	name	AlertParameter3
* Alert Parameter 4	/create/event/extended-fields/string-field	name	AlertParameter4
* Alert Parameter 5	/create/event/extended-fields/string-field	name	AlertParameter5
* Alert Parameter 6	/create/event/extended-fields/string-field	name	AlertParameter6
* Alert Parameter 7	/create/event/extended-fields/string-field	name	AlertParameter7
* Alert Parameter 8	/create/event/extended-fields/string-field	name	AlertParameter8
* Alert Parameter 9	/create/event/extended-fields/string-field	name	AlertParameter9
* Alert Parameter 10	/create/event/extended-fields/string-field	name	AlertParameter10

表A-2 アラート更新属性とXMLパス・マッピング

Microsoft SCOMフィールド名	XMLパス	属性名	属性値
Id	/update/event/identifier
Resolution State	/update/event/status
* Ticket ID	/update/event/externalIncidentIdentifier
* Owner	/update/event/owner
* Custom Field 1	/update/event/extended-fields/string-field	name	CustomField1
* Custom Field 2	/update/event/extended-fields/string-field	name	CustomField2
* Custom Field 3	/update/event/extended-fields/string-field	name	CustomField3
* Custom Field 4	/update/event/extended-fields/string-field	name	CustomField4
* Custom Field 5	/update/event/extended-fields/string-field	name	CustomField5
* Custom Field 6	/update/event/extended-fields/string-field	name	CustomField6
* Custom Field 7	/update/event/extended-fields/string-field	name	CustomField7
* Custom Field 8	/update/event/extended-fields/string-field	name	CustomField8
* Custom Field 9	/update/event/extended-fields/string-field	name	CustomField9
* Custom Field 10	/update/event/extended-fields/string-field	name	CustomField10
* Alert History (2012)	/update/event/logs/log/description
* Alert History (2007)	/update/event/extended-fields/string-field	name	AlertHistory

A.1.4拡張フィールド

拡張フィールドは、特定のフィールドにマップされていないフィールドの情報を渡します。拡張フィールドは、拡張フィールド・ノードの子である<string-field/>要素として定義されます。拡張フィールドの名前はname属性で指定され、フィールドの値は要素の値として指定されます。

A.2 デフォルト・ポート番号の変更

ほとんどの場合、Microsoft SCOM Webサービスで使用されるデフォルト・ポート番号を使用できます。ただし、既存アプリケーションとの競合があれば、ポート番号を変更する必要があります。

8080はHTTP通信のデフォルト・ポート番号で、8443はHTTPS通信のデフォルト・ポート番号です。ポート番号を変更するには、次の適切な項のステップを実行します。

A.2.1 Webサービス・ポート(8080)の変更

SCOM Webサービスは、インストール時にHTTP (SSLなし)を使用するようにWebサービスが構成されている場合、通信のデフォルト・ポートとしてポート8080を使用します。ポート番号を別の値に変更するには、Microsoft SCOM Webサービスがインストールされているシステムで、次のステップを実行します。<SCOM_INSTALL>は、SCOM Webサービスがインストールされているディレクトリに置き換えてください。

コマンド・プロンプト・ウィンドウを開き、作業ディレクトリを次のディレクトリに変更します。
```
<SCOMWS_INSTALL>/adapters/conf
```
framework.propertiesファイルのバックアップ・コピーを作成し、そのファイルをテキスト・エディタで開きます。
古いポート番号へのすべての参照を新しいポート番号に置き換え、ファイルを保存します。
UNIXでのMicrosoft SCOM Webサービスの実行またはWindowsでのMicrosoft SCOM Webサービスの実行の指定に従って、Webサービスを再起動します。
SCOMコネクタで使用しているURLを変更するために、次のステップを実行します。
1. 「設定」メニューで、「拡張性」、「管理コネクタ」の順に選択します。
2. 「管理コネクタ」ページで、SCOMコネクタの名前をクリックします。
  「管理コネクタの構成」ページの「一般」タブが表示されます。
3. 「Webサービス・エンドポイント」セクションに表示されているURLを、新規ポート番号を使用するように変更します。
4. 「OK」をクリックして、変更内容を保存します。

A.2.2Webサービス・ポート(8443)の変更

デフォルトのSSLポート8443を異なるポートに切り替える上でサポートが必要な場合は、Oracleサポートに連絡してください。

A.3 SCOM API接続パラメータの変更

SCOMエージェントをインストールする場合、SCOM APIへのアクセスに使用される接続パラメータを構成する必要があります。インストールには、エージェントの構成パラメータの変更に使用できるSCOMAgentConfigユーティリティが含まれています。

接続パラメータを変更するには、次のステップを実行します。

SCOMエージェントがインストールされているシステムでWindowsエクスプローラを開きます。
SCOMエージェントのインストール・ディレクトリのbinディレクトリにナビゲートします。
SCOMAgentConfig.exeユーティリティを実行します。
このアクションにより、SCOMエージェントの構成ツールが起動します。
「Load」をクリックします。
このアクションにより、ディレクトリのナビゲーション・ウィンドウが開きます。
SCOMエージェントのインストール・ディレクトリにナビゲートして、SCOMAgent.cfgファイルを開きます。
「Management Groups」タブをクリックして、「Edit」をクリックします。
このアクションにより、Edit Management Groupウィンドウが表示されます。
次に示すフィールドで必要な情報を変更して、「Update」をクリックします。
```
Name
Server
Domain
Username
Password
```
「Save」をクリックして、構成ファイルの変更を保存します。
「Exit」をクリックしてユーティリティを終了します。
IISでSCOMエージェントを停止して再起動します。