Cisco 4000 シリーズ ISR ソフトウェア コンフィギュレーション ガイド

Call Home 機能には次のようなメリットがあります。

• 次のような複数のメッセージ形式オプション：

  • ショート テキスト：ポケットベルまたは印刷形式のレポートに最適。

  • プレーン テキスト：人間が読むのに適した形式に完全整形されたメッセージ情報。

  • XML：XML および Adaptive Markup Language（AML）Document Type Definitions（DTD）を使用するマシンが判読可能な形式です。 XML 形式では、シスコ TAC と通信できます。

• 複数のメッセージ宛先への同時配信が可能。

• 複数のメッセージ カテゴリ（設定、環境条件、インベントリ、syslog、スナップショット、クラッシュ イベントなど）。

• 重大度とパターンマッチによるメッセージのフィルタリング

• 定期的なメッセージ送信のスケジューリング

シスコと直接サービス契約を結んでいる場合は、Smart Call Home サービスに登録できます。 Smart Call Home は、Smart Call Home メッセージを分析し、背景説明と推奨措置を提供します。 既知の問題、特にオンライン診断障害については、TAC に Automatic Service Request が作成されます。

Smart Call Home には、次の機能があります。

• 継続的なデバイス ヘルス モニタリングとリアルタイムの診断アラート。

• Smart Call Home メッセージの分析。必要に応じて、自動サービス要求（詳細な診断情報が含まれる）が作成され、該当する TAC チームにルーティングされるため、問題解決を高速化できます。

• セキュアなメッセージ転送が、ご使用のデバイスから直接、または HTTP プロキシ サーバやダウンロード可能な転送ゲートウェイ（TG）を経由して行われます。 TG 集約ポイントは、複数のデバイスをサポートする場合またはセキュリティ要件によって、デバイスをインターネットに直接接続できない場合に使用できます。

• すべての Smart Call Home デバイスの Smart Call Home メッセージと推奨事項、インベントリ情報、および設定情報に Web アクセスすることにより、関連するフィールド通知、セキュリティ勧告、およびサポート終了日情報にアクセスできます。

Smart Call Home で次の項目を登録する必要があります。

• ルータの SMARTnet 契約番号

• 電子メール アドレス

• Cisco.com のユーザ名

Smart Call Home の詳細については、https:/​/​supportforums.cisco.com/​community/​4816/​smart-call-homeを参照してください。

1.    configure terminal


2.    call-home reporting {anonymous | contact-email-addr email-address} [http-proxy {ipv4-address | ipv6-address | name} port port-number]

Router# configure terminal

Router(config)# call-home reporting contact-email-addr email@company.com

Cisco Smart Call Home サービスのアプリケーションおよび設定に関する情報については、https:/​/​supportforums.cisco.com/​community/​4816/​smart-call-home にある『Smart Call Home User Guide』の「Getting Started」の項を参照してください。 このマニュアルには、デバイスから直接、または転送ゲートウェイ（TG）集約ポイントを介して Smart Call Home メッセージを送信するための設定例が含まれています。

（注）	HTTPS には追加的なペイロード暗号化が含まれているため、セキュリティ上の理由から、HTTPS 転送オプションを使用することをお勧めします。 インターネットへの接続に集約ポイントまたはプロキシが必要な場合は、Cisco.com からダウンロード可能な転送ゲートウェイ ソフトウェアを使用できます。

1.    configure terminal


2.    service call-home


3.    no service call-home

Router# configure terminal

Router(config)# service call-home

Router(config)# no service call-home

1.    configure terminal


2.    call-home


3.    contact-email-addr email-address


4.    phone-number +phone-number


5.    street-address street-address


6.    customer-id text


7.    site-id text


8.    contract-id text

Router# configure terminal

Router(config)# call-home

Router(cfg-call-home)# contact-email-addr username@example.com

Router(cfg-call-home)# phone-number +1-800-555-4567

Router(cfg-call-home)# street-address “1234 Picaboo Street, Any city, Any state, 12345“

Router(cfg-call-home)# customer-id Customer1234

Router(cfg-call-home)# site-id Site1ManhattanNY

Router(cfg-call-home)# contract-id Company1234

Router# configure terminal 
Enter configuration commands, one per line.  End with CNTL/Z.
Router(config)# call-home
Router(cfg-call-home)# contact-email-addr username@example.com
Router(cfg-call-home)# phone-number +1-800-555-4567
Router(cfg-call-home)# street-address “1234 Picaboo Street, Any city, Any state, 12345”
Router(cfg-call-home)# customer-id Customer1234
Router(cfg-call-home)# site-id Site1ManhattanNY
Router(cfg-call-home)# contract-id Company1234 
Router(cfg-call-home)# exit

宛先プロファイルには、アラート通知に必要な送信情報が含まれています。 少なくとも 1 つの宛先プロファイルが必要です。 1 つまたは複数のタイプの複数の宛先プロファイルを設定できます。

新しい宛先プロファイルを作成して定義することも、定義済みの宛先プロファイルをコピーして使用することもできます。 新しい宛先プロファイルを定義する場合は、プロファイル名を割り当てる必要があります。

（注）	Cisco Smart Call Home サービスを使用する場合、宛先プロファイルは XML メッセージ形式を使用する必要があります。

宛先プロファイルには、次の属性を設定できます。

• プロファイル名：ユーザ定義の宛先プロファイルを一意に識別する文字列。 プロファイル名は 31 文字までで大文字と小文字は区別されません。

  （注）	プロファイル名として all は使用できません。

• 転送方法：アラートを送信するための転送メカニズム（電子メールまたは HTTP（HTTPS を含む））。

  • ユーザ定義の宛先プロファイルの場合、E メールがデフォルトで、どちらかまたは両方の転送メカニズムをイネーブルにできます。 両方の方法をディセーブルにすると、E メールがイネーブルになります。

  • あらかじめ定義された Cisco TAC プロファイルの場合、いずれかの転送メカニズムをイネーブルにできますが、同時にはイネーブルにできません。

• 宛先アドレス：アラートを送信する転送方法に関連した実際のアドレス。

• メッセージ形式：アラートの送信に使用するメッセージ形式。 ユーザ定義宛先プロファイルの形式オプションは、ロング テキスト、ショート テキスト、または XML です。 デフォルトは XML です。 定義済みのシスコ TAC プロファイルの場合、XML しか使用できません。

• メッセージ サイズ：宛先メッセージの最大サイズ。 有効範囲は 50 ～ 3,145,728 バイトです。 デフォルト値は 3,145,728 バイトです。

  Anonymous Reporting：顧客 ID を匿名のままにするよう選択できます。これにより、識別情報が送信されません。

• 関心のあるアラート グループへの登録：各自の関心事項を示すアラート グループに登録することができます。

ここでは、次の内容について説明します。

• 新しい宛先プロファイルの作成

• 宛先プロファイルのコピー

• プロファイルの匿名モードの設定

アラート グループは、すべてのルータでサポートされている Call Home アラートをあらかじめ定義したサブセットです。 Call Home アラートはタイプごとに別のアラート グループにグループ化されます。 次のアラート グループが使用可能です。

• Crash

• Configuration

• Environment

• Inventory

• Snapshot

• Syslog

ここでは、次の内容について説明します。

• 定期通知

• メッセージ重大度しきい値

• スナップショット コマンド リストの設定

各アラート グループの起動イベントを アラート グループの起動イベントとコマンドに示します。アラート グループ メッセージの内容を メッセージの内容に示します。

宛先プロファイルごとに受信するアラート グループを 1 つまたは複数選択できます。

（注）	Call Home アラートは、その Call Home アラートが含まれているアラート グループに登録されている宛先プロファイルにしか送信されません。 さらに、アラート グループをイネーブルにする必要があります。

宛先プロファイルを 1 つまたは複数のアラート グループに加入させる場合、次の手順に従います。

1.    configure terminal


2.    call-home


3.    alert-group {all | configuration | environment | inventory | syslog | crash | snapshot}


4.    profile name


5.    subscribe-to-alert-group all


6.    subscribe-to-alert-group configuration [periodic {daily hh:mm | monthly date hh:mm | weekly day hh:mm}]


7.    subscribe-to-alert-group environment [severity {catastrophic | disaster | fatal | critical | major | minor | warning | notification | normal | debugging}]


8.    subscribe-to-alert-group inventory [periodic {daily hh:mm | monthly date hh:mm | weekly day hh:mm}]


9.    subscribe-to-alert-group syslog [severity {catastrophic | disaster | fatal | critical | major | minor | warning | notification | normal | debugging}]


10.    subscribe-to-alert-group crash


11.    subscribe-to-alert-group snapshot periodic {daily hh:mm | hourly mm | interval mm | monthly date hh:mm | weekly day hh:mm}


12.    exit

Router# configure terminal

Router(config)# call-home

Router(cfg-call-home)# alert-group all

Router(cfg-call-home)# profile profile1

Router(cfg-call-home-profile)# subscribe-to-alert-group all

Router(cfg-call-home-profile)# subscribe-to-alert-group configuration
periodic daily 12:00

Router(cfg-call-home-profile)# subscribe-to-alert-group environment severity major

Router(cfg-call-home-profile)# subscribe-to-alert-group inventory periodic monthly 1 12:00 

Router(cfg-call-home-profile)# subscribe-to-alert-group environment severity major

Router(cfg-call-home-profile)# [no | default]
subscribe-to-alert-group crash

Router(cfg-call-home-profile)# subscribe-to-alert-group snapshot periodic daily 12:00

Router(cfg-call-home-profile)# exit

1.    configure terminal


2.    call-home


3.    mail-server [{ipv4-address | ipv6-address} | name] priority number


4.    sender from email-address


5.    sender reply-to email-address


6.    source-interface interface-name


7.    vrf vrf-name

Router# configure terminal

Router(config)# call-home

Router(cfg-call-home)# mail-server stmp.example.com priority 1

Router(cfg-call-home)# sender from username@example.com

Router(cfg-call-home)# sender reply-to username@example.com

Router(cfg-call-home)# source-interface loopback1

Router(cfg-call-home)# vrf vpn1

Router# configure terminal 
Enter configuration commands, one per line. End with CNTL/Z.
Router(config)# call-home
Router(cfg-call-home)# mail-server smtp.example.com priority 1
Router(cfg-call-home)# mail-server 192.168.0.1 priority 2
Router(cfg-call-home)# sender from username@example.com
Router(cfg-call-home)# sender reply-to username@example.com
Router(cfg-call-home)# source-interface loopback1
Router(cfg-call-home)# vrf vpn1
Router(cfg-call-home)# exit
Router(config)#

1.    configure terminal


2.    call-home


3.    rate-limit number

Router# configure terminal

Router(config)# call-home

Router(cfg-call-home)# rate-limit 40

1.    configure terminal


2.    call-home


3.    http-proxy {ipv4-address | ipv6-address | name} port port-number

Router# configure terminal

Router(config)# call-home

Router(cfg-call-home)# http-proxy 1.1.1.1 port 1

1.    configure terminal


2.    call-home


3.    aaa-authorization


4.    aaa-authorization [username username]

Router# configure terminal

Router(config)# call-home

Router(cfg-call-home)# aaa-authorization

Router(cfg-call-home)# aaa-authorization username user

1.    configure terminal


2.    call-home


3.    [no] syslog-throttling

Router# configure terminal

Router(config)# call-home

Router(cfg-call-home)# syslog-throttling

1.    configure terminal


2.    call-home


3.    data-privacy {level {normal | high} | hostname}

Router# configure terminal

Router(config)# call-home

Router(cfg-call-home)# data-privacy level high

数種類の Call Home 通信を手動で送信できます。 Call Home 通信を送信するには、この項の作業を実行します。 ここでは、次の内容について説明します。

• Call Home テスト メッセージの手動送信

• Call Home アラート グループ メッセージの手動送信

• Call Home 分析およびレポート要求の送信

• 1 つのコマンドまたはコマンド リスト用のコマンド出力メッセージの手動送信

• 診断シグニチャの概要

• 診断シグニチャの前提条件

• 診断シグニチャのダウンロード

• 診断シグニチャのワークフロー

• 診断シグニチャのイベントとアクション

• 診断シグニチャのイベント検出

• 診断シグニチャのアクション

• 診断シグニチャの変数

• 診断シグニチャの Call Home サービスの設定

• 診断シグニチャの設定

次に、long-text 形式での Syslog アラート通知の例を示します。

TimeStamp : 2014-08-13 21:41 GMT+00:00
Message Name : syslog
Message Type : Call Home
Message Group : reactive
Severity Level : 2
Source ID : ISR 4400
Device ID : ISR4451-X/K9@C@FTX1830AKF9
Customer ID :
Contract ID :
Site ID :
Server ID : ISR4451-X/K9@C@FTX1830AKF9
Event Description : *Aug 13 21:41:35.835: %CLEAR-5-COUNTERS: Clear counter on all interfaces by console
System Name : Router
Contact Email : admin@yourdomain.com
Contact Phone :
Street Address :
Affected Chassis : ISR4451-X/K9
Affected Chassis Serial Number : FTX1830AKF9
Affected Chassis Part No : 800-36894-03
Affected Chassis Hardware Version : 1.0
Supervisor Software Version : 15.4(20140812:034256)
Command Output Name : show logging
Attachment Type : command output
MIME Type : text/plain
Command Output Text : show logging
Syslog logging: enabled (0 messages dropped, 4 messages rate-limited, 0 flushes, 0 overruns, xml disabled, filtering disabled)

No Active Message Discriminator.



No Inactive Message Discriminator.


    Console logging: level debugging, 71 messages logged, xml disabled,
                     filtering disabled
    Monitor logging: level debugging, 0 messages logged, xml disabled,
                     filtering disabled
    Buffer logging:  level debugging, 73 messages logged, xml disabled,
                    filtering disabled
    Exception Logging: size (4096 bytes)
    Count and timestamp logging messages: disabled
    Persistent logging: disabled

No active filter modules.

    Trap logging: level informational, 70 message lines logged
        Logging Source-Interface:       VRF Name:

Log Buffer (4096 bytes):

*Aug 13 21:38:04.994: %CLEAR-5-COUNTERS: Clear counter on all interfaces by console
*Aug 13 21:40:55.706: %CLEAR-5-COUNTERS: Clear counter on all interfaces by console
*Aug 13 21:41:27.042: %SYS-5-CONFIG_I: Configured from console by console
Router#
Command Output Name : show inventory
Attachment Type : command output
MIME Type : text/plain
Command Output Text : show inventory
NAME: "Chassis", DESCR: "Cisco ISR4451 Chassis"
PID: ISR4451-X/K9      , VID: V03, SN: FTX1830AKF9

NAME: "Power Supply Module 0", DESCR: "450W AC Power Supply for Cisco ISR4450, ISR4350"
PID: PWR-4450-AC       , VID: V01, SN: DCA1822X0G4

NAME: "Fan Tray", DESCR: "Cisco ISR4450, ISR4350 Fan Assembly"
PID: ACS-4450-FANASSY  , VID:    , SN:            

NAME: "module 0", DESCR: "Cisco ISR4451 Built-In NIM controller"
PID: ISR4451-X/K9      , VID:    , SN:            

NAME: "NIM subslot 0/0", DESCR: "Front Panel 4 ports Gigabitethernet Module"
PID: ISR4451-X-4x1GE   , VID: V01, SN: JAB092709EL

NAME: "module 1", DESCR: "Cisco ISR4451 Built-In SM controller"
PID: ISR4451-X/K9      , VID:    , SN:            

NAME: "module 2", DESCR: "Cisco ISR4451 Built-In SM controller"
PID: ISR4451-X/K9      , VID:    , SN:            

NAME: "module R0", DESCR: "Cisco ISR4451 Route Processor"
PID: ISR4451-X/K9      , VID: V03, SN: FOC18271QLX

NAME: "module F0", DESCR: "Cisco ISR4451 Forwarding Processor"
PID: ISR4451-X/K9      , VID:    , SN:            


Router#

次に、XML 形式での Syslog アラート通知の例を示します。

<?xml version="1.0" encoding="UTF-8"?>
<soap-env:Envelope xmlns:soap-env="http://www.w3.org/2003/05/soap-envelope">
<soap-env:Header>
<aml-session:Session xmlns:aml-session="http://www.cisco.com/2004/01/aml-session" soap-env:mustUnderstand="true" soap-env:role="http://www.w3.org/2003/05/soap-envelope/role/next">
<aml-session:To>http://tools.cisco.com/neddce/services/DDCEService</aml-session:To>
<aml-session:Path>
<aml-session:Via>http://www.cisco.com/appliance/uri</aml-session:Via>
</aml-session:Path>
<aml-session:From>http://www.cisco.com/appliance/uri</aml-session:From>
<aml-session:MessageId>M4:FTX1830AKF9:53EBDBDA</aml-session:MessageId>
</aml-session:Session>
</soap-env:Header>
<soap-env:Body>
<aml-block:Block xmlns:aml-block="http://www.cisco.com/2004/01/aml-block">
<aml-block:Header>
<aml-block:Type>http://www.cisco.com/2005/05/callhome/syslog</aml-block:Type>
<aml-block:CreationDate>2014-08-13 21:42:50 GMT+00:00</aml-block:CreationDate>
<aml-block:Builder>
<aml-block:Name>ISR 4400</aml-block:Name>
<aml-block:Version>2.0</aml-block:Version>
</aml-block:Builder>
<aml-block:BlockGroup>
<aml-block:GroupId>G5:FTX1830AKF9:53EBDBDA</aml-block:GroupId>
<aml-block:Number>0</aml-block:Number>
<aml-block:IsLast>true</aml-block:IsLast>
<aml-block:IsPrimary>true</aml-block:IsPrimary>
<aml-block:WaitForPrimary>false</aml-block:WaitForPrimary>
</aml-block:BlockGroup>
<aml-block:Severity>2</aml-block:Severity>
</aml-block:Header>
<aml-block:Content>
<ch:CallHome xmlns:ch="http://www.cisco.com/2005/05/callhome" version="1.0">
<ch:EventTime>2014-08-13 21:42:49 GMT+00:00</ch:EventTime>
<ch:MessageDescription>*Aug 13 21:42:49.406: %CLEAR-5-COUNTERS: Clear counter on all interfaces by console</ch:MessageDescription>
<ch:Event>
<ch:Type>syslog</ch:Type>
<ch:SubType></ch:SubType>
<ch:Brand>Cisco Systems</ch:Brand>
<ch:Series>ISR XE Series Routers</ch:Series>
</ch:Event>
<ch:CustomerData>
<ch:UserData>
<ch:Email>admin@yourdomain.com</ch:Email>
</ch:UserData>
<ch:ContractData>
<ch:CustomerId></ch:CustomerId>
<ch:SiteId></ch:SiteId>
<ch:ContractId></ch:ContractId>
<ch:DeviceId>ISR4451-X/K9@C@FTX1830AKF9</ch:DeviceId>
</ch:ContractData>
<ch:SystemInfo>
<ch:Name>Router</ch:Name>
<ch:Contact></ch:Contact>
<ch:ContactEmail>admin@yourdomain.com</ch:ContactEmail>
<ch:ContactPhoneNumber></ch:ContactPhoneNumber>
<ch:StreetAddress></ch:StreetAddress>
</ch:SystemInfo>
<ch:CCOID></ch:CCOID>
</ch:CustomerData>
<ch:Device>
<rme:Chassis xmlns:rme="http://www.cisco.com/rme/4.0">
<rme:Model>ISR4451-X/K9</rme:Model>
<rme:HardwareVersion>1.0</rme:HardwareVersion>
<rme:SerialNumber>FTX1830AKF9</rme:SerialNumber>
<rme:AdditionalInformation>
<rme:AD name="PartNumber" value="800-36894-03" />
<rme:AD name="SoftwareVersion" value="15.4(20140812:034256)" />
<rme:AD name="SystemObjectId" value="1.3.6.1.4.1.9.1.1707" />
<rme:AD name="SystemDescription" value="Cisco IOS Software, ISR Software (X86_64_LINUX_IOSD-UNIVERSALK9-M), Experimental Version 15.4(20140812:034256) [v154_3_s_xe313_throttle-BLD-BLD_V154_3_S_XE313_THROTTLE_LATEST_20140812_020034-ios 150]
Copyright (c) 1986-2014 by Cisco Systems, Inc.
Compiled Tue 12-Aug-14 00:13 by mcpre" />
<rme:AD name="ServiceNumber" value="" />
<rme:AD name="ForwardAddress" value="" />
</rme:AdditionalInformation>
</rme:Chassis>
</ch:Device>
</ch:CallHome>
</aml-block:Content>
<aml-block:Attachments>
<aml-block:Attachment type="inline">
<aml-block:Name>show logging</aml-block:Name>
<aml-block:Data encoding="plain">
<![CDATA[show logging
Syslog logging: enabled (0 messages dropped, 4 messages rate-limited, 0 flushes, 0 overruns, xml disabled, filtering disabled)

No Active Message Discriminator.

No Inactive Message Discriminator.

    Console logging: level debugging, 75 messages logged, xml disabled,
                     filtering disabled
    Monitor logging: level debugging, 0 messages logged, xml disabled,
                     filtering disabled
    Buffer logging:  level debugging, 77 messages logged, xml disabled,
                    filtering disabled
    Exception Logging: size (4096 bytes)
    Count and timestamp logging messages: disabled
    Persistent logging: disabled

No active filter modules.

    Trap logging: level informational, 74 message lines logged
        Logging Source-Interface:       VRF Name:

Log Buffer (4096 bytes):

*Aug 13 21:42:20.187: %CLEAR-5-COUNTERS: Clear counter on all interfaces by console
*Aug 13 21:42:23.364: %SYS-5-CONFIG_I: Configured from console by console
Router#]]></aml-block:Data>
</aml-block:Attachment>
<aml-block:Attachment type="inline">
<aml-block:Name>show inventory</aml-block:Name>
<aml-block:Data encoding="plain">
<![CDATA[show inventory
NAME: "Chassis", DESCR: "Cisco ISR4451 Chassis"
PID: ISR4451-X/K9      , VID: V03, SN: FTX1830AKF9

NAME: "Power Supply Module 0", DESCR: "450W AC Power Supply for Cisco ISR4450, ISR4350"
PID: PWR-4450-AC       , VID: V01, SN: DCA1822X0G4

NAME: "Fan Tray", DESCR: "Cisco ISR4450, ISR4350 Fan Assembly"
PID: ACS-4450-FANASSY  , VID:    , SN:            

NAME: "module 0", DESCR: "Cisco ISR4451 Built-In NIM controller"
PID: ISR4451-X/K9      , VID:    , SN:            

NAME: "NIM subslot 0/0", DESCR: "Front Panel 4 ports Gigabitethernet Module"
PID: ISR4451-X-4x1GE   , VID: V01, SN: JAB092709EL

NAME: "module 1", DESCR: "Cisco ISR4451 Built-In SM controller"
PID: ISR4451-X/K9      , VID:    , SN:            

NAME: "module 2", DESCR: "Cisco ISR4451 Built-In SM controller"
PID: ISR4451-X/K9      , VID:    , SN:            

NAME: "module R0", DESCR: "Cisco ISR4451 Route Processor"
PID: ISR4451-X/K9      , VID: V03, SN: FOC18271QLX

NAME: "module F0", DESCR: "Cisco ISR4451 Forwarding Processor"
PID: ISR4451-X/K9      , VID:    , SN:            

Router#]]></aml-block:Data>
</aml-block:Attachment>
</aml-block:Attachments>
</aml-block:Block>
</soap-env:Body>
</soap-env:Envelope>