このドキュメントでは、Secure Web Appliance(SWA)でスマートライセンスを設定およびトラブルシューティングする手順について説明します。
次の項目に関する知識があることが推奨されます。
シスコでは次のことを推奨しています。
本書の内容は、特定のソフトウェアやハードウェアのバージョンに限定されるものではありません。
このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、初期(デフォルト)設定の状態から起動しています。本稼働中のネットワークでは、各コマンドによって起こる可能性がある影響を十分確認してください。
スマートライセンスは、次の機能を提供します。
SWAをスマートライセンスに登録するには、アプライアンスの所有者にスマートアカウントが必要です。
シスコが提供するリソースへのリンクには、スマートライセンスに関連するビデオ、ガイド、および説明が含まれています。
Cisco Smart Software Managerサテライトは、Cisco Smart Licensingのコンポーネントです。CSSMサテライトは、CSSMと連携して製品ライセンスを管理し、使用中のシスコライセンスをほぼリアルタイムで可視化してレポートします。
セキュリティ上の理由から、Cisco.comにあるSmart Software Managerでインストールベースを管理したくない場合は、Smart Software Managerサテライトをオンプレミスでインストールすることを選択できます。
Smart Software Managerのサテライトの詳細については、『Cisco Smart Software Manager - Cisco』を参照してください。
ライセンスのタイプ:
ライセンス認証ステータス:アプライアンス内の特定のライセンスのステータス。
特定の機能のステータスが次のいずれかの値で表示されます。
注:無制限キーは、その機能に有効期限がないことを示します。休止キーは、機能に必要な使用許諾契約書(EULA)が含まれていることを示します。EULAに同意しない場合は、機能を構成して有効にする必要があります。完了すると、機能はアクティブに移行し、有効期限タイマーが開始されます。
SWAをスマートライセンスに接続するには、グラフィカルユーザインターフェイス(GUI)とコマンドラインインターフェイス(CLI)の両方を使用します。
注意:ESA/SMA/SWAでスマートライセンス機能を有効にすることは永続的であり、アプライアンスをクラシックライセンスモードに戻すオプションを使用することはできません。
従来のライセンスのCLIでは、4つのコマンドが使用されました。そのため、スマートライセンスの委任状のビルド(15.1以降)では、これらのコマンドは削除されます。
削除されたCLIコマンドのリストを確認します。
ClassicライセンスのGUIでは、「System Administration」タブに2ページが示されています。スマートライセンスの委任状では、これらのページは削除されます。
削除されたGUIページのリスト:
Reset Configuration」では、設定全体が消去されてSWAが工場出荷時の状態に戻る工場出荷時のリセットが実行されます。スマートライセンスの委任状では、ビルドは同じ動作を維持します。
Reloadは、設定データを消去して機能キーを削除するCLI隠しコマンドです。SWAがクラシックライセンスに登録されていて、リロードが実行された場合は、ライセンスを再ロードします。
スマートライセンスを使用してSWAを設定した場合、リロード後にスマートライセンスの登録が解除されて無効になり、SWAの現在の動作は工場出荷時の状態にリセットされます。
SWAの必須ビルドバージョンでは、スマートライセンスがdisable状態に戻ることはないため、reloadコマンドによってすべての設定が消去されます。スマートライセンスはregistered状態のままであるため、すべてのライセンスを再度要求します。
TCPポート443でsmartreceiver.cisco.comにネットワーク通信またはプロキシ通信を行います。SWAからの接続をテストするには、次の手順を使用します。
1. CLIにログインします。
2. telnetと入力してEnterキーを押します。
3. SWAがスマートライセンスサーバーに接続するインターフェイスを選択します。
4. smartreceiver.cisco.comと入力します。
5. ポートセクションに443と入力し、Enterキーを押します。
注:Smart Software Mangerサテライトを設定している場合は、ステップ4でそのサーバに関連付けられているUniform Resource Locator(URL)またはInternet Protocol(IP)アドレスを追加します。
接続が成功した場合の例を次に示します。
> telnet
Please select which interface you want to telnet from.
1. Auto
2. Management (10.48.48.184/24: management.swa1.cisco.com)
3. P1 (192.168.13.184/24: p1.swa1.cisco.com)
4. P2 (192.168.133.184/24: p2.swa1.cisco.com)
[1]> 4
Enter the remote hostname or IP address.
[]> smartreceiver.cisco.com
Enter the remote port.
[23]> 443
Trying 10.112.59.81...
Connected to smartreceiver.cisco.com.
Escape character is '^]'.
失敗した接続の例を次に示します。
SWA_CLI> telnet
Please select which interface you want to telnet from.
1. Auto
2. Management (10.48.48.184/24: management.swa1.cisco.com)
3. P1 (192.168.13.184/24: p1.swa1.cisco.com)
4. P2 (192.168.133.184/24: p2.swa1.cisco.com)
[1]> 2
Enter the remote hostname or IP address.
[]> smartreceiver.cisco.com
Enter the remote port.
[23]> 443
Trying 10.112.59.81...
telnet: connect to address 10.112.59.81: Operation timed out
Trying 2a04:e4c7:fffe::f...
bind: Invalid argument
注:Telnetを終了するには、Ctrl + Cが機能しない場合、Controlキーを押しながら]キーを押し、qと入力してEnterキーを押します。
1. GUIにログインし、System Administrationに移動します。
2. Smart Software Licensingを選択します。
イメージ:Smart Software Licensingの選択
3. Enable Smart Software Licensingを選択します。
イメージ:Enable Smart Software Licensingを選択します
4. 指示をよく読み、OKをクリックします。
イメージ:指示をよく読みます。
注意:アプライアンスでスマートライセンス機能を有効にした後で、スマートライセンスからクラシックライセンスにロールバックすることはできません。
5. 変更を確定します。
6. しばらく待ってから、スマートライセンスページを更新します。
7. Smart License Registrationを選択し、Confirmをクリックします。
イメージ:Smart License Registrationの選択
8. (オプション):ネットワークにSmart Software Managerサテライトがある場合は、トランスポート設定でサーバのURLまたはIPアドレスを追加します。
9. 別のルーティングテーブルがあり、管理インターフェイスからスマートレシーバへのアクセスがない場合は、テストインターフェイスセクションからデータを選択します。
デフォルトでは、管理ルーティングテーブルが選択されています。
図 – ルーティングテーブルの選択
10. Registerを選択して、登録ページに移動します。
11. Smart Software Managerポータル(Cisco Software Central)またはSmart Software Managerサテライトにログインします。
12. Inventoryタブに移動し、トークンがない場合は新しいトークンを生成します。または、青い矢印をクリックしてトークンを表示します。
イメージ:インベントリに移動
13.(オプション):登録トークンを作成するには、New Tokenを選択して必須フィールドに入力します。
14. スマートライセンスポータルからSWAにトークンを貼り付け、Registerを選択します。
イメージ:登録トークンの貼り付け
15. (オプション):デバイスがすでに登録されている場合、チェックボックスをオンにするとデバイスを再登録できます。
16. 数分後、登録ステータスを確認できます。
イメージ – 登録済みアプライアンス
統合は、GUI、CLI、またはスマートライセンスポータルから確認できます。
1. GUIにログインし、System Administrationに移動します。
2. Smart Software Licensingを選択します。
3. 次の項目を確認します。
イメージ:GUIでのスマートライセンスの確認
4. System Administrationメニューから、Licensesを選択します。
5. 必要なライセンスが適合していることを確認します。
イメージ:ライセンスステータス
CLIからスマートライセンスのステータスを確認するには、次の手順を使用します。
1. CLIにログインします。
2. license_smartと入力します。
3. STATUSを選択します。
4. 次の項目を確認します。
Smart Licensing is : Enabled
License Reservation is: Disabled
Evaluation Period: Not In Use
Evaluation Period Remaining: 89 days 22 hours 40 minutes
Registration Status: Registered ( 04 Sep 2023 20:38 ) Registration Expires on: ( 03 Sep 2024 21:03 )
Smart Account: XXXXXXXXXXXX18.cisco.com
Virtual Account: XXXXXXXXX
Last Registration Renewal Attempt Status: SUCCEEDED on 04 Sep 2023 21:07
License Authorization Status: Authorized ( 04 Sep 2023 20:38 ) Authorization Expires on: ( 03 Dec 2023 20:03 )
Last Authorization Renewal Attempt Status: SUCCEEDED on 04 Sep 2023 21:07
Product Instance Name: wsa125to15.amojarra.calo
Transport Settings: Direct (https://smartreceiver.cisco.com/licservice/license)
Device Led Conversion Status: Started
5. license_smartウィザードで、SUMMARYと入力します。
[]> SUMMARY
Feature Name License Authorization Status
----------------------------------------------------------------------------------------------------
Secure Web Appliance Cisco Web Usage Controls In Compliance
Secure Web Appliance Anti-Virus Webroot In Compliance
Secure Web Appliance L4 Traffic Monitor In Compliance
Secure Web Appliance Cisco AnyConnect SM for AnyConnect In Compliance
Secure Web Appliance Secure Endpoint Reputation In Compliance
Secure Web Appliance Anti-Virus Sophos In Compliance
Secure Web Appliance Web Reputation Filters In Compliance
Secure Web Appliance Secure Endpoint In Compliance
Secure Web Appliance Anti-Virus McAfee Not requested
Secure Web Appliance Web Proxy and DVS Engine In Compliance
Secure Web Appliance HTTPs Decryption In Compliance
6. 必要なライセンスが適合していることを確認します。
1. Smart Software Licensing Portal(Cisco Software Central)にログインします。
2. Inventoryタブを選択します。
3. 製品インスタンスを選択します。
4. デバイスがリストされていることを確認し、デバイス名をクリックします。
イメージ:スマートライセンスポータルでのデバイスのステータスの確認
5. Generalタブで、Feature Keysとデバイスステータスを確認します。
イメージ:スマートライセンスポータルの機能キーの確認
CLIからVLNを表示するには、smartaccountinfoコマンドを実行します。仮想アカウントドメインやIDおよび製品インスタンスなどの追加情報を表示できます。
> smartaccountinfo
Smart Account details
---------------------
Product Instance ID : 609XXXXXXXX-fXXXXXXXXX55
Smart Account Domain : XXXXXXXXXXXXXXXXXXX18.cisco.com
Smart Account ID : 111111
Smart Account Name : XXXXXXXXXXXXXXXXXXX18.cisco.com
VLN : VLNWSA1111111
Virtual Account Domain : WSA_XXXXX
Virtual Account ID : 111111
スマートライセンスに関連するすべてのログは、Smartlicenseのログに収集されます。このログはデフォルトで有効になっています。
スマートライセンスログを設定するには、次の手順を実行します。
1. GUIにログインします。
2. System Administrationメニューから、Log Subscriptionsを選択します。
3. Smartlicense Logsを選択します。
4. ログ名をクリックして、構成を編集します。
ヒント:ログをログコレクタサーバにプッシュする場合は、新しいログサブスクリプションを作成して、これらのログを転送し、ログのコピーをSWA上にローカルで保持することをお勧めします
一般的なエラーと、問題を解決する手順を次に示します。
次に、smart_licenseログと正常な応答の例を示します。
Mon Sep 4 20:39:32 2023 Info: The product is registered successfully with Smart Software Manager.
イメージ – 登録に失敗しました
Registration Failedが返された場合は、次の手順を使用してCLIからsmart_licenseログを確認します。
1. CLIにログインします。
2. grepと入力します。
3. smartlicense ログに関連付けられている番号を見つけ、その番号を入力します。
4. ログが表示されるまでEnterキーを押します。
「Communication send error」が表示された場合は、SWAとスマートライセンスサーバの間の接続をポートTCP 443で確認します。
Mon Sep 4 19:57:09 2023 Warning: The registration of the product with Smart Software Manager failed. The response from Smart Software Manager is: Communication send error.
ヒント:Smart Software Manager(SSM)サテライトを設定した場合は、設定したポート番号への接続性を確認します。
接続を確認するには、この記事の「通信の要件」セクションに記載されている手順を使用します。
また、アラートの表示でも、同じエラーメッセージが表示されます。
04 Sep 2023 20:19:29 +0200 The registration of the product with Smart Software Manager failed. The response from Smart Software Manager is: Communication send error.
トークンの有効期限が切れているか、トークンが定義されている最大使用率に達している場合は、警告ログ「Token is not valid」が返されます。
エラーは、displayalertsコマンドまたはsmartlicenseログで確認できます。
次に、CLIでのdisplayalertsのエラー例を示します。
04 Sep 2023 20:26:55 +0200 The registration of the product with Smart Software Manager failed. The response from Smart Software Manager is: Token is not valid
次に、CLIのsmartlicenseログのログ行の例を示します。
Mon Sep 4 20:26:55 2023 Warning: The registration of the product with Smart Software Manager failed. The response from Smart Software Manager is: Token is not valid
トークンの有効性を確認するには、スマートライセンスポータルにログインし、インベントリに移動して、有効期限のステータスと使用回数を確認します。
イメージ – Expierトークン
通信の送信エラーが原因で「failed to renew authorization」を受信した場合は、接続の問題が原因である可能性があります。正しいルーティングテーブルが選択されていることを確認し、SWAとsmartreceiver.cisco.com TCPポート443またはSmart Software Managerサテライトサーバとの間の接続性をテストします。
接続を確認するには、この記事の「通信の要件」セクションに記載されている手順を使用します。
エラーを確認するには、displayalertsコマンドを使用するか、smartlicenseログを使用します
次に、CLIのdisplayalertsに表示されるエラーの例を示します。
04 Sep 2023 22:23:43 +0200 Failed to renew authorization of the product with Smart Software Manager due to Communication send error..
次に、CLIのsmartlicenseログのログ行の例を示します。
Mon Sep 4 22:22:58 2023 Warning: Failed to renew authorization of the product with Smart Software Manager due to Communication send error..
認証を更新する理由が「REVOKED」の場合は、スマートライセンスポータルからデバイスが削除されているかどうかを確認します。この記事の「スマートライセンスポータルでのデバイスステータスの確認」セクションを確認します。
displayalertsコマンドを実行するか、smartlicenseログからエラーを確認します。
次に、CLIでのdisplayalertsのエラーの例を示します。
04 Sep 2023 22:39:10 +0200 Failed to renew authorization of the product with Smart Software Manager due to Could not return the certificate for the given sn (111111111) since it is REVOKED..
次に、CLIのsmartlicenseログのログ行の例を示します。
Mon Sep 4 22:39:10 2023 Warning: Failed to renew authorization of the product with Smart Software Manager due to Could not return the certificate for the given sn (1111111) since it is REVOKED..
この問題を解決するには、デバイスを再登録します。
物理デバイスにはVLNはなく、仮想ライセンス番号は仮想アプライアンスでのみ使用されます。仮想SWAを使用していて、CLIのsmartaccountinfoの出力にVLNが表示されない場合は、CLIでloadlicenseコマンドを使用してXMLライセンスファイルのロードを再試行します。
注意: loadlicenseコマンドは、新しいライセンスファイルとキーをインストールする前に、既存のすべての機能キー(評価キーを含む)とライセンスファイルをシステムから削除します。
このエラーメッセージを受信する場合、SWAの場合はCisco Bug ID CSCwe36665、ESAの場合はCisco Bug ID CSCvo22855が原因です。TACに連絡して、回避策を実装してください。
"Smart license agent service is unavailable. Please visit this page after some time. If you continue to see the same message, please contact Cisco Sales representative."
スマートライセンス認証が失敗し、次のエラーが表示される場合:
Tue Apr 22 09:46:27 2023 Warning: Failed to renew authorization of the product with Smart Software Manager due to Failed to verify signature..
[First Test]:このエラーはCisco Bug ID CSCvx04164が原因で発生する可能性があります。
この不具合の条件は、スマートライセンスポータルの仮想アカウント名に英語以外の文字が含まれていることです。この問題の回避策は次のとおりです。
仮想アカウントの名前を変更し、英語以外の文字を削除します。
1. software.cisco.comにアクセスします。
2. Administration > Manage Smart Account > Virtual Accountsの順に移動します。
3. 問題の仮想アカウントをクリックします。
4. 新しい名前を定義し、英語以外の文字を削除します。
注:仮想アカウントの名前を変更するには、管理者権限が必要です。
[2番目のテスト]仮想アカウント名が正しければ、スマートライセンスポータルのインベントリにデバイスがリストされていることを確認します。
この記事の「スマートライセンスポータルでのデバイスステータスの確認」セクションに記載されている手順を実行します。
[3番目のテスト]デバイスがSmart License Portalインベントリにリストされている場合は、CLIからSWA Smart Licenseサービスを再起動します。
1. CLIにログインします。
2. diagnosticコマンドを実行します。
3. 「サービス」を選択します。
4. SMART_LICENSEを選択します。
5. 「再起動」を選択します。
SWA_CLI> diagnostic
Choose the operation you want to perform:
- NET - Network Diagnostic Utility.
- PROXY - Proxy Debugging Utility.
- REPORTING - Reporting Utilities.
- SERVICES - Service Utilities.
[]> SERVICES
Choose one of the following services:
- AMP - Secure Endpoint
- AVC - AVC
- ADC - ADC
- DCA - DCA
- WBRS - WBRS
- EXTFEED - ExtFeed
- L4TM - L4TM
- ANTIVIRUS - Anti-Virus xiServices
- AUTHENTICATION - Authentication Services
- MANAGEMENT - Appliance Management Services
- REPORTING - Reporting Associated services
- MISCSERVICES - Miscellaneous Service
- OCSP - OSCP
- UPDATER - UPDATER
- SICAP - SICAP
- SNMP - SNMP
- SNTP - SNTP
- VMSERVICE - VM Services
- WEBUI - Web GUI
- SMART_LICENSE - Smart Licensing Agent
- WCCP - WCCP
[]> SMART_LICENSE
Choose the operation you want to perform:
- RESTART - Restart the service
- STATUS - View status of the service
[]> RESTART
smart_agent is restarting.
[4番目のテスト] Smart License Managerポータルで新しいトークンを生成し、デバイスを再登録します。
これらのエラーは、アプライアンス(アップグレード前にスマートライセンスが有効になっていた)をバージョン14.1または14.0にアップグレードした後で、ESAまたはSMAで確認できます。
注:このエラーは、x195またはx395デバイスで発生します。
アプライアンスによって生成されるメッセージの例を次に示します。
08 Apr 2023 10:19:36 -0500 Initialization of smart agent service failed. Reason : Port 65501 is not available for smart agent service to run. Please try changing port for smart agent service through `license_smart setagentport` cli command or free the port from other service.
smart_licenseログには、次のように記録されます。
Mon Apr 8 09:02:36 2021 Warning: Smart License: Failed to change the hostname to esa.local for the product.
このエラーは、ESAの場合はCisco Bug ID CSCvz74874が、SMAの場合はCisco Bug ID CSCvx68947が原因で発生します。この問題を解決するには、シスコサポートに連絡する必要があります。
このエラーの大部分は、予想よりも多くのリソースを使用して設定されている仮想アプライアンスに関連しています。次にログの例を示します。
Thu Jun 23 16:16:07 2022 Critical: Initialization of smart agent service failed. Reason : Port 65501 is not available for smart agent service to run. Please try changing port for smart agent service through `license_smart setagentport` cli command or free the port from other service.
any attempts to swap ports using the defined command will fail.
この問題を解決するには、CLIでversionコマンドの出力をチェックして、CPUの数と割り当てられたメモリがexpectedに設定されていることを確認します。 アプライアンスにサポートされているコア数よりも多いコアがある場合は、割り当てを修正します。
デバイスがSmart License Managerポータルから削除されている場合、古いバージョンでは次のエラーが返されます。
Thu Nov 15 13:50:20 2022 Warning: Failed to renew authorization of the product with Smart Software Manager due to Invalid response from licensing cloud..
この問題を解決するには、アプライアンスを再登録し、Cisco Bug ID CSCvr09743も確認してください。
アプライアンスからこのエラーを受信し、アップデートを取得できない場合は、『Field Notice:FN - 72502』で詳細を参照してください。
21 Aug 2023 14:03:04 +0200 Unable to connect to the Cisco Aggregator Server.
Details: No valid SSL certificate was sent
従来のVLN証明書ファイルには、更新やアップグレードにアクセスするためにTalos Keymasterによって作成された証明書が含まれています。古いキーマスター認証局(CA)の有効期限が2023年1月13日に切れました。
2021年12月15日より前に発行され、有効期間が12ヵ月を超えるVLN証明書ファイルは、2023年1月13日より前に更新および適用される必要があります。
この問題を解決するには、シスコのライセンスサポートに連絡して、新しいVLNファイルを要求します。
一部の機能がコンプライアンス違反に移行されたことを示すログが表示された場合は、次の点を確認します。
1. 有効なライセンスがあること。
2. アプライアンスがスマートライセンスサーバと接続できること(本記事の「通信に関する要件」セクションを参照)。
3. スマートライセンスのログで、問題の詳細を確認します。
4. シスコサポートに連絡してサポートを求めてください。
次にログの例を示します。
Mon Sep 4 20:41:09 2023 Warning: Secure Web Appliance HTTPs Decryption license has been moved to Out of Compliance successfully.
Mon Sep 4 20:41:10 2023 Warning: The Secure Web Appliance HTTPs Decryption is in Out of Compliance (OOC) state. You have 29 days remaining in your grace period.
「Smart Agent is in Authorization Expired state」という重大なエラーが表示された場合は、次の行を確認して、この状態の原因を見つけます。
次にエラーの例を示します。
Fri Aug 18 15:51:11 2023 Critical: Web Security Appliance Cisco Web Usage Controls feature will stop working as Smart Agent is in Authorization Expired state. This can happen if there is no communication between the appliance and the Cisco Smart Software Manager (CSSM) for more than 90 days.
接続を確認し、デバイスがスマートライセンスポータルに登録されていることを確認します。
| 改定 | 発行日 | コメント |
|---|---|---|
2.0 |
26-Oct-2026
|
スペル、文法、間隔、読みやすさを考慮してセクションを区切るために挿入された水平線、代替テキスト、URL、固定CCWアラートが更新されました。 |
1.0 |
08-Sep-2023
|
初版 |