utils コマンド
utils auditd
このコマンドは、システム監査サービスを開始および停止します。また、システム監査サービスのステータスを表示します。
utils auditd {enable | disable | status }
構文の説明
パラメータ
説明
enable
監査ログの収集をイネーブルにします。イネーブルにすると、システムはユーザのアクションを監視および記録します。また、ユーザの作成や削除などの Linux イベントや、ファイルの編集および削除も監視および記録します。
disable
監査ログの収集をディセーブルにします。
status
監査ログの収集のステータスを表示します。監査ログの取得には Real-Time Monitoring Tool の使用をお勧めします。ただし、CLI を使用して監査ログを取得することもできます。
使用上のガイドライン
サービスがイネーブルになっていると、システム アクティビティをモニタし、ログに記録します。システム監査サービスは、多くの情報をログに記録することに注意してください。ディスクが一杯にならないように注意してください
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection。
utils BE6000Mode*
utils BE6000Mode enable
このコマンドを実行して、Unified Communications Manager の BE6000 モードを有効にします。
要件
コマンド特権レベル:4
アップグレード時の使用:不可
適用対象:Unified Communications Manager 。
utils BE6000Mode disable
このコマンドを実行して、Unified Communications Manager の BE6000 モードを無効にします。
要件
コマンド特権レベル:4
アップグレード時の使用:不可
適用対象:Unified Communications Manager 。
utils BE6000Mode status
このコマンドを実行して、CUCM の BE6000 モードのステータスを確認します。
要件
コマンド特権レベル:0
アップグレード時の使用:不可
適用対象:Unified Communications Manager 。
utils branding*
utils branding enable
このノードでブランディングを有効にするには、このコマンドを実行します。
要件
コマンド特権レベル:4
適用対象:Cisco Unified Communications Manager、IM and Presence サービス、Cisco Unity Connection
utils branding disable
このノードでブランディングを無効にするには、このコマンドを実行します。
要件
コマンド特権レベル:4
適用対象:Cisco Unified Communications Manager、IM and Presence サービス、Cisco Unity Connection
utils branding status
このコマンドを実行すると、このノードでブランディングが有効か無効かを確認できます。
要件
コマンド特権レベル:4
適用対象:Cisco Unified Communications Manager、IM and Presence サービス、Cisco Unity Connection
utils contactsearchauthentication*
utils contactsearchauthentication disable
このコマンドは、安全な連絡先検索認証モードを無効にします。このモードを無効にしたら、変更を有効にする電話をリセットする必要があります。
utils contactsearchauthentication disable
要件
コマンド特権レベル:4
アップグレード時の使用:不可
Unified Communications Manager、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils contactsearchauthentication enable
このコマンドは、安全な連絡先検索認証モードを有効にします。このモードを有効にしたら、変更を有効にする電話をリセットします。
utils contactsearchauthentication enable
要件
コマンド特権レベル:4
アップグレード時の使用:不可
Unified Communications Manager、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils contactsearchauthentication status
このコマンドは、システムが連絡先検索認証モードが有効または無効のいずれの状態で動作しているかを表示します。
utils contactsearchauthentication status
要件
コマンド特権レベル:0
アップグレード時の使用:可能
Unified Communications Manager、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils core*
utils core analyze
このコマンドは、コア ファイルのバックトレース、スレッド リスト、すべての CPU レジスタの現在の値を生成します。
utils core {active | inactive } analyze [core_filename]
構文の説明
パラメータ
説明
active
アクティブなバージョンを指定します。
inactive
非アクティブなバージョンを指定します。
core_filename
スタック トレースが生成されるコア ファイルの名前を指定します。
使用上のガイドライン
このコマンドにより、コア ファイルと同じ名前で、拡張子が .txt のファイルが、コア ファイルと同じディレクトリに作成されます。cimserver によって作成されたコア ファイルでこのコマンドを実行すると、予期しないメッセージが表示されます。このメッセージは既知の制限です。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection。
utils core list
このコマンドは、すべてのアクティブまたは非アクティブなコア ファイルを表示します。
utils core {active | inactive } list
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス および Cisco Unity Connection。
utils capf*
utils capf cert import
システムにサインインした電話の証明書をアップロードするには、このコマンドを使用します。
使用上のガイドライン
FTP または TFTP を使用して署名付き証明書をインポートすることを選択することもできます。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager
utils capf set keep_alive
このコマンドを実行して、認証局プロキシ機能(CAPF)サービスとエンドポイント間のすべての接続に対して、keep_alive タイマーを設定します。システムのデフォルトは 15 分です
要件
コマンド特権レベル:0
アップグレード時の使用:不可
適用対象:Unified Communications Manager
utils capf stale-lsc
utils capf stale-lsc {delete | list }
このコマンドは、システムの古い LSC 証明書の管理に役立ちます。
構文の説明
パラメータ
説明
delete
すべての古い LSC 証明書をシステムから削除します。
list
システム上のすべての古い LSC 証明書を一覧表示します。
要件
コマンド特権レベル:0
アップグレード時の使用:不可
適用対象:Unified Communications Manager
utils capf csr
utils capf csr {dump | count | delete | list }
このコマンドは、システムでサードパーティの CA 署名付き証明書を管理するのに役立ちます。
構文の説明
パラメータ
説明
count
システムに使用可能な証明書と CSR の数を表示します。
delete
システムのすべての証明書と CSR を削除します。
dump
すべての CSR が CA によってサインインされると、このパラメータでローカル サーバにダウンロードします。
list
このコマンドは、システムで保留になっている CSR ファイルのタイムスタンプのリストを提供します。リストは CSR 生成の時間の降順で表示されます。
要件
コマンド特権レベル:count パラメータの場合は 0、delete および dump パラメータの場合は 1。
アップグレード時の使用:不可
適用対象:Unified Communications Manager
utils create report
このコマンドは、サーバに関するレポートを platform/log ディレクトリ内に作成します。
utils create report {hardware | platform | security }
構文の説明
パラメータ
説明
hardware
ディスク アレイ、リモート コンソール、診断、および環境のデータを含むシステム レポートを作成します。
platform
プラットフォーム コンフィギュレーション ファイルが TAR ファイルに収集されます。
security
診断レポートを収集し、TAR ファイルを作成します。TAR ファイルは、トラブルシューティングを行う場合にダウンロードできます。このファイルは、file get コマンドを使用して取得できます。
使用上のガイドライン
コマンドを入力すると、続行を求めるプロンプトが表示されます。
レポートを作成した後、file get activelog platform/log/ filename コマンドを使用してレポートを取得します。filename は、コマンドが完了した後で表示されるレポートのファイル名を指定します。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager、Unified Communications Manager の IM and Presence サービス 、および Cisco Unity Connection。
utils create report database
このコマンドは、データベースのトラブルシューティングに必要なすべてのログ ファイルを収集します。
utils create report {hardware | platform | security }
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils ctl
utils ctl {set-cluster mixed-mode | set-cluster non-secure-mode | update CTLFile }
このコマンドは、クラスタ セキュリティ モードを変更するか、各ノードで CTL ファイルを更新します。
構文の説明
パラメータ
説明
set-cluster mixed-mode
CTL ファイルを更新し、クラスタを混合モードに設定します(DB セキュア モードが 1 に設定されます)。
クラスタですでに混合モードが有効になっている場合、このコマンドは、Unified Communications Manager が混合モードであり、自動登録がアクティブであることを示します。操作を確認する必要があります。
(注)
混合モードを有効にするには、Communications Manager が Cisco Smart Software Manager または Cisco Smart Software Manager サテライトに登録されていること、およびスマート アカウントまたはバーチャル アカウントから受信した登録トークンでエクスポート制御機能の許可が有効になっており、そのトークンがこのクラスタに登録されていることを確認します。
set-cluster non-secure-mode
CTL ファイルを更新し、クラスタを非セキュア モードに設定します。
クラスタですでに混合モードが有効になっている場合、このコマンドは、Unified Communications Manager が非セキュア モードであることを示します。
update CTLFile
クラスタの各ノードで、CTL ファイルを更新します。
(注)
混合モードで CTLFile を更新するには、Unified Communications Manager が Cisco Smart Software Manager または Cisco Smart Software Manager サテライトに登録されていること、およびスマート アカウントまたはバーチャル アカウントから受信した登録トークンでエクスポート制御機能の許可が有効になっており、そのトークンがこのクラスタに登録されていることを確認します。
使用上のガイドライン
この CLI は、パブリッシャで実行する必要があります。他のすべてのノードでは、この CLI コマンドがディセーブルにされています。
(注)
CTL ファイルの再生成後、クラスタ全体で CallManager および TFTP サービスを再起動する必要があります。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 。
utils ctl reset localkey
このコマンドは CTL ファイルの再生成に使用され、セカンダリ SAST ロール(CallManager)でそれを署名します。元の CTL ファイルに署名するために使用された ITLRecovery 証明書が変更され、エンドポイントがロック アウトされた場合にこのコマンドを使用します。
utils ctl reset {localkey }
構文の説明
localkey
パブリッシャの CTL ファイルを更新して、新しい CTL ファイルを生成します。コマンドは CallManager キーで CTLfile に署名します。
使用上のガイドライン
(注)
このコマンドは、Unified Communications Manager パブリッシャ ノードで実行する必要があります。
エンドポイントが、CallManager キーで署名されて新しい ITLRecovery 証明書が含まれている新しい CTL ファイルを受信した後、CTL 更新コマンド(ユーティリティ ctl update CTLFile)を実行して、ITLRecovery
証明書で署名します。CTL ファイルは再生成されますが、エンドポイントによって信頼されている新しい ITLRecovery 証明書によって署名されます。
要件
コマンド特権レベル:4
アップグレード時の使用:不可
適用対象:Unified Communications Manager
utils cuc*
utils cuc activate CUSRSV
このコマンドは、スタンドアロン Cisco Unity Connection サーバを Cisco Unity Connection SRSV サーバに変換します。
utils cuc activate CUSRSV
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Cisco Unity Connection
utils cuc auto ITL download
このコマンドでは、Unity Connection が Cisco Unity Connection の CallManager 証明書を自動ダウンロードする機能を無効にすることができます。
utils cuc auto ITL download { enable | disable | status }
シンテックス説明
パラメータ
説明
enable
ポートグループのリセットでの CallManager 証明書の自動ダウンロード機能を有効にします。
この機能はデフォルトでは有効になっています。
disable
CallManager 証明書を自動的にダウンロードする機能を無効にします。無効にした場合は、証明書を手動でアップロードする必要があります。
status
機能のステータスを表示します。
(注)
クラスタの場合、CLI コマンドはパブリッシャ サーバ上でのみ実行されます。
要件
コマンド特権レベル:4
アップグレード時の使用:不可
適用対象:Cisco Unity Connection
例
admin:utils cuc auto ITL download enable
After successful execution,Unity Connection will download trust list from the TFTP server automatically.
For this, you must do the following:
1.Configure TFTP server for Next Generation enabled port groups through Cisco Unity Connection Administration
2. Restart the Connection Conversation Manager on all nodes in the cluster
Auto downloading of ITL enabled successfully
utils cuc cluster activate
このコマンドは、このサーバを Cisco Unity Connection クラスタ内でアクティブにします。
utils cuc cluster activate
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Cisco Unity Connection
utils cuc cluster deactivate
このコマンドは、このサーバを Cisco Unity Connection クラスタ内で非アクティブにします。
utils cuc cluster deactivate
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Cisco Unity Connection
utils cuc cluster makeprimary
このコマンドを実行すると、指定されたサーバは Cisco Unity Connection クラスタ内でプライマリ サーバ ステータスを取得するようになります。
utils cuc cluster makeprimary
構文の説明
パラメータ
説明
server
Cisco Unity Connection クラスタ内でプライマリ サーバ ステータスを取得するサーバの名前を指定します。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Cisco Unity Connection
utils cuc cluster overwritedb
このコマンドは、サーバ上のデータを Cisco Unity Connection クラスタ内の他のサーバにあるデータで上書きします。
utils cuc cluster overwritedb
使用上のガイドライン
このコマンドは、このコマンドを実行するサーバ上のデータベースを、Connection クラスタ内の他のサーバにあるデータベースで上書きします。データベースが上書きされると、複製が再起動されます。この方法は、バックアップからあるサーバを復元し、その復元したデータを他のサーバにコピーする必要があるときに使用されます。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Cisco Unity Connection
utils cuc cluster renegotiate
このコマンドは、Connection クラスタ内のパブリッシャ サーバを交換した後またはパブリッシャ サーバに Connection を再インストールした後、パブリッシャ サーバとの間にクラスタ関係を構築します。このコマンドにより、パブリッシャ
サーバ上のすべてのデータがサブスクライバ サーバのデータで上書きされ、サーバ間の複製が初期化されます。
utils cuc cluster renegotiate
使用上のガイドライン
このコマンドは、Connection クラスタ内のサブスクライバ サーバで実行して、交換したパブリッシャ サーバまたは Connection を再インストールしたパブリッシャ サーバとの間に信頼関係を設定します。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Cisco Unity Connection
utils cuc create report
このコマンドは、テクニカル サポートのスタッフがシステムをトラブルシューティングするのに役立つデータを収集します。収集されるデータには、バージョン情報、クラスタ ステータス、サービス情報、データベース情報、トレース ファイル、ログ ファイル、ディスク情報、メモリ情報、および再起動情報が含まれます。
使用上のガイドライン
コマンドが完了すると、詳細情報が .zip ファイルに保存され、その .zip ファイルの場所が表示されます。file get コマンドを使用して、ファイルを圧縮解除して内容を表示できるコンピュータに移動します。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Cisco Unity Connection のみ
例
admin: utils cuc create report
Getting unity connection version. Please wait...Done
Getting cluster status. Please wait...Done
Getting service information. Please wait...Done
Getting installed locales. Please wait...Done
Getting database schema version. Please wait...Done
Getting database integrity. Please wait...Done
Getting database diagnostic log. Please wait...Done
Getting database message log. Please wait...Done
Getting trace files. Please wait...Done
Getting log files. Please wait...Done
Getting platform status. Please wait...Done
Compressing 75 files. Please wait...Done
Output is in file: cuc/cli/systeminfo_080318-140843.zip
To free disk space, delete the file after copying it to another computer
utils cuc dbreplication*
utils cuc dbreplication 01_tear_down
このコマンドは、クラスタ内の Unity Connection サーバ間の複製および接続を切断します。両方のサーバでこのコマンドを実行すると、サーバ間で優れた複製を確立する前に理想的なクリーンアップを確認します。
utils cuc dbreplication 01_tear_down
コマンド モード
管理者(admin:)
使用上のガイドライン
長い Unity Connection データベース CDR キューが蓄積される場合、クラスタ内の 2 台のサーバ間でサーバ接続および複製を確立するクリーンな基盤を提供するため、このコマンドがその蓄積をクリーンアップします。
(注)
次の処理が推奨されます。
コマンドを実行する前にシステムをバックアップします。
コマンドが失敗した場合、コマンド ライン ログとともに画面ログ情報を収集し、Cisco TAC にエスカレートします。
必ず Cisco TAC のみがコマンドを実行するようにします。
別のサーバ上の情報と対立するデータを削除する同期プロセスとして、サーバ上で古いデータとともにコマンドを実行します。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Cisco Unity Connection
utils cuc dbreplication 02_define_servers
このコマンドは、クラスタ内の Unity Connection サーバ間のネットワーク接続を確立します。
utils cuc dbreplication 02_define_servers
コマンド モード
管理者(admin:)
使用上のガイドライン
このコマンドを使用して、Unity Connection クラスタ内で 1 台のサーバから別のサーバに CDR トラフィックを追跡およびレポートできます。SBR プロセスにおいて、このコマンドはクラスタの 2 台のサーバのロールを定義するのに役立ちます。
(注)
次の処理が推奨されます。
コマンドを実行する前にシステムをバックアップします。
コマンドが失敗した場合、コマンド ライン ログとともに画面ログ情報を収集し、Cisco TAC にエスカレートします。
必ず Cisco TAC のみがコマンドを実行するようにします。
別のサーバ上の情報と対立するデータを削除する同期プロセスとして、サーバ上で古いデータとともにコマンドを実行します。
(注)
このコマンドは、Unity Connection クラスタに古いデータがあるサーバで実行する必要があります。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Cisco Unity Connection
utils cuc dbreplication 03_define_db_template
このコマンドは、同期レプリケーションのため、Unity Connection データベースでテーブルの設定のレプリケーション レコードを作成します。また、このコマンドは、レプリケーション スキーマを確立する必要がある Unity Connection
データベースのテーブル テンプレートをネゴシエートします。
utils cuc dbreplication 03_define_db_template
コマンド モード
管理者(admin:)
使用上のガイドライン
このコマンドは、すべてのテーブルをリスト表示し、Unity Connection クラスタの 2 台のサーバ間でどのデータがネゴシエートおよび同期されるかに基づいてテンプレートを定義します。
(注)
次の処理が推奨されます。
コマンドを実行する前にシステムをバックアップします。
コマンドが失敗した場合、コマンド ライン ログとともに画面ログ情報を収集し、Cisco TAC にエスカレートします。
必ず Cisco TAC のみがコマンドを実行するようにします。
別のサーバ上の情報と対立するデータを削除する同期プロセスとして、サーバ上で古いデータとともにコマンドを実行します。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Cisco Unity Connection
utils cuc dbreplication 04_sync_database
このコマンドは、リモート サーバからコマンドが実行されるサーバにデータベースを同期させます。
utils cuc dbreplication 04_sync_database
コマンド モード
管理者(admin:)
使用上のガイドライン
このコマンドは、現在のサーバ上のリモート サーバから最新データをコピーするため、Unity Connection クラスタに古いデータがあるサーバで実行する必要があります。
(注)
次の処理が推奨されます。
コマンドを実行する前にシステムをバックアップします。
コマンドが失敗した場合、コマンド ライン ログとともに画面ログ情報を収集し、Cisco TAC にエスカレートします。
必ず Cisco TAC のみがコマンドを実行するようにします。
別のサーバ上の情報と対立するデータを削除する同期プロセスとして、サーバ上で古いデータとともにコマンドを実行します。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Cisco Unity Connection
utils cuc dbreplication reset_all
このコマンドは、Unity Connection クラスタの 2 台のサーバ間のデータベース レプリケーションをリセットするために必要な、サーバの破棄や定義などのすべてのタスクを実行します。
utils cuc dbreplication reset_all
コマンド モード
管理者(admin:)
使用上のガイドライン
このコマンドは、以下のコマンドを順番に実行し、Unity Connection クラスタの 2 台のサーバ間のデータベース レプリケーションを確実にリセットします。
utils cuc dbreplication01_tear_down
utils cuc dbreplication 02_define_servers
utils cuc dbreplication 03_define_db_template
utils cuc dbreplication 04_sync_database
(注)
次の処理が推奨されます。
コマンドを実行する前にシステムをバックアップします。
コマンドが失敗した場合、コマンド ライン ログとともに画面ログ情報を収集し、Cisco TAC にエスカレートします。
必ず Cisco TAC のみがコマンドを実行するようにします。
別のサーバ上の情報と対立するデータを削除する同期プロセスとして、サーバ上で古いデータとともにコマンドを実行します。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Cisco Unity Connection
utils cuc encryption
このコマンドは、Cisco Unity Connection で暗号化のステータスを有効化、無効化、および指定します。
utils cuc encryption { enable | disable | status }
シンテックス説明
パラメータ
説明
enable
Unity Connection で暗号化を有効にします。有効にすると、Unity Connection でセキュリティ機能を使用できます。
disable
Unity Connection で暗号化を無効にします。無効にすると、Unity Connection でセキュリティ機能を使用できません。
status
Unity Connection の暗号化ステータスを表示します。
使用上のガイドライン
Unity Connection で暗号化を有効にするときは、次の点を確認してください。
Cisco Unity Connection が、Cisco Smart Software Manager(CSSM)または Cisco Smart Software Manager サテライトに登録されている。
エクスポート制御機能が対象製品で有効になっている。
Cisco Unity Connection のエクスポート制御機能を登録および有効にする方法の詳細については、https://www.cisco.com/c/en/us/td/docs/voice_ip_comm/connection/12x/install_upgrade/guide/b_12xcuciumg.html で入手可能な『Install, Upgrade and Maintenance Guide for Cisco Unity Connection Release 12.x 』の「Managing Licenses」の章の「Configuring Cisco Smart Software Licensing in Unity Connection」の項を参照してください。
(注)
クラスタの場合、CLI はパブリッシャ サーバ上でのみ実行されます。
要件
コマンド特権レベル:4
アップグレード時の使用:不可
適用対象:Cisco Unity Connection
例
admin:utils cuc encryption enable
After successful execution, restart the following services on all nodes in the cluster
1.Connection Conversation Manager
2.Connection IMAP Server
Do you want to proceed (yes/no)? yes
Encryption enabled successfully
utils cuc jetty ssl disable
このコマンドは、通知のためにJetty サーバで SSL のステータス(無効)を設定することができます。
utils cuc jetty ssl disable
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Cisco Unity Connection
例
admin: utils cuc jetty ssl disable
After successful execution of this command restart of Jetty server is required, which will result in loss of current event subscriptions. Are you sure?
Enter (yes/no)? yes
Command completed successfully.
Please restart Connection Jetty Service.
In case of cluster, run this command on the other node also.
utils cuc jetty ssl enable
このコマンドを使用すると、通知用に Jetty サーバで SSL を有効にできます。
utils cuc jetty ssl enable
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Cisco Unity Connection
例
admin: utils cuc jetty ssl enable
After successful execution of this command restart of Jetty server is required, which will result in loss of current event subscriptions. Are you sure?
Enter (yes/no)? yes
Command completed successfully.
Please restart Connection Jetty Service.
In case of cluster, run this command on the other node also.
utils cuc networking clear_replication
このコマンドは、サーバ上のすべての Digital Networking 複製アクティビティを停止します。
utils cuc networking clear_replication
使用上のガイドライン
このコマンドは、Connection Digital Networking Replication Agent および Connection SMTP サービスを停止した後、drop、queue、および pickup replication フォルダを削除し、このサーバに対して進行中のディレクトリのプッシュまたはプルのステータスをクリアしてから、Connection
Digital Networking Replication Agent および Connection SMTP サービスを再起動します。複製フォルダのサイズによって、この操作には数分かかることがあります。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Cisco Unity Connection
utils cuc networking dscp
このコマンドでは、クラスタ内の Connection サーバ間で送信されるパケットの DSCP 値を 18 に設定する処理を開始または停止できます。このため、DSCP 値に基づいてパケットの優先順位を決定するルータでは、Connection データおよびボイス
メッセージを優先させることができます。
utils cuc networking dscp {on | off }
構文の説明
パラメータ
説明
on
ネットワークで送信されるパケットの DSCP 値を 18 に設定する処理を開始します。
off
ネットワークで送信されるパケットの DSCP 値を 18 に設定する処理を停止します。18 はデフォルト値です。
使用上のガイドライン
このコマンドは、クラスタ内の Connection サーバ間で渡されるパケットで DSCP 値を使用できるようにします。実際に DSCP 値を使用するには、ルータを設定する必要があります。このコマンドでは、発信パケットに DSCP 値を含めるかどうかは制御できますが、DSCP
値自体は変更できません。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Cisco Unity Connection のみ
utils cuc reset password
このコマンドは、指定されたユーザ アカウントのパスワードをリセットします。サインインを試行して失敗した回数が多すぎるために Connection がアカウントをロックした場合は、このコマンドもアカウントのロックを解除します。
要件
コマンド特権レベル:4
アップグレード時の使用:可能
適用対象:Cisco Unity Connection のみ
例
admin: utils cuc reset password jdoe
Enter password:
Re-enter password:
jdoe
07/29/2008 12:41:14.704 : Update SUCCESSED
utils cuc set PinExpiry_PromptTime “Authentication Rule Name”
このコマンドは、Cisco Unity Connection 電話ユーザ インターフェイス(タッチトーン カンバセーション)PIN 機能をイネーブルにし、条件付き期限切れの警告プロンプトが再生されている間、時間間隔を更新できるようにします。
要件
utilscuc set PinExpiry_PromptTime "Authentication Rule Name" CLI コマンドの詳細については、『Release Notes for Cisco Unity Connection 10.0(1)』の「Cisco
Unity Connection telephone user interface (touchtone conversation) PIN」の項を参照してください。
utils dbreplication*
utils dbreplication dropadmindb
このコマンドは、クラスタ内のすべてのサーバにある Informix の syscdr データベースをドロップします。
utils dbreplication dropadmindb
使用上のガイドライン
このコマンドは、データベース レプリケーションのリセットまたはクラスタのリセットが失敗し、複製を再起動できない場合にのみ使用します。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils dbreplication forcedatasyncsub
このコマンドを実行すると、サブスクライバ サーバのデータがパブリッシャ サーバ上のデータから復元されます。
utils dbreplication forcedatasyncsub nodename [offloadpub ] [timeoutvalue]
構文の説明
パラメータ
説明
nodename
特定のサブスクライバ サーバのデータをパブリッシャ サーバ上のデータから復元するように指定します。すべてのサブスクライバ サーバでデータを復元するには、all を入力します。
offloadpub
forcedatasyncsub プロセス中のパブリッシャ サーバの使用量を最小限に抑えます。
(注)
このオプションを追加すると、forcedatasyncsub が完了するまでの時間が増加します。
timeoutvalue
各ノードに対してリカバリ タイムアウトの値を分単位で指定します(デフォルトのタイムアウトより大きくする必要があります)。
デフォルトは 40 分です。
使用上のガイドライン
このコマンドは、utils dbreplication repair コマンドを数回実行してから utils dbreplication status コマンドを実行しても、非動的テーブルが同期しない場合にのみ使用します。
(注)
動的テーブルが同期しないだけの場合には使用しないでください。動的テーブルは、通常のシステム動作中でも同期しないことがあります。
このコマンドは、パブリッシャ サーバからのみ実行できます。クラスタ内のすべてのサブスクライバーサーバ上で同期を強行するには、all を入力します。1 つのサブスクライバ サーバだけが同期しない場合は、nodename パラメータを使用します。
(注)
このコマンドでは、サブスクライバ サーバ上にある既存のデータはすべて消去され、パブリッシャ サーバ上のデータに置き換えられます。そのため、サブスクライバ サーバのテーブルが同期しなくなった原因を調べることはできなくなります。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils dbreplication quickaudit
このコマンドは、動的テーブル上の選択された内容に対して、短時間のデータベース チェックを実行します。
utils dbreplication quickaudit {nodename | all }
構文の説明
パラメータ
説明
nodename
短時間の監査を実行するノードを指定します。
all
すべてのノードで監査が実行されます。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils dbreplication rebuild
このコマンドは、クラスタ間でデータベースのレプリケーションを設定し、指定されたノードで次のコマンドを実行するために使用します。
utils dbreplication rebuild { [nodename] | | all }
構文の説明
パラメータ
説明
nodename
データベース レプリケーションを再構築するノードを指定します。
all
クラスタ内のすべてのノードで再構築されるデータベース レプリケーションを指定します。
使用上のガイドライン
注意
このコマンドは、クラスタ内の他のノードのパフォーマンスに影響する場合があります。システム メンテナンス ウィンドウでこのコマンドを実行することを推奨します。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils dbreplication repair
utils dbreplication repair {nodename | all }
構文の説明
パラメータ
説明
nodename
データ修復を行う特定のサブスクライバ サーバを指定します。
all
すべてのサブスクライバ サーバでデータ修復が行われます。
使用上のガイドライン
サーバが接続されていることが utils dbreplication status コマンドによって示されているにもかかわらず、1 つまたは複数のテーブルのデータが同期しない場合に、utils dbreplication repair コマンドはサブスクライバ サーバ上のデータがパブリッシャ サーバ上のデータと同期するように修復します。
クラスタ内のすべてのノードを修復するには、all パラメータを指定します。1 つのサブスクライバ サーバだけが同期していない場合は、nodename パラメータを指定します。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils dbreplication repairreplicate
このコマンドは、クラスタ ノード間で一致していないデータを修復し、パブリッシャ データと一致するようにノード データを変更します。
utils dbreplication repairreplicate replicatename [nodename | all ]
構文の説明
パラメータ
説明
replicatename
修復する複製を指定します。
nodename
複製を修復するノードを指定します。
all
すべてのノードで複製を修復することを指定します。
使用上のガイドライン
パラメータ nodename は、パブリッシャを指定するとは限りません。サブスクライバのノード名も指定できます。
(注)
(注)
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils dbreplication repairtable
このコマンドは、クラスタ ノード間で一致していないデータを修復し、パブリッシャ データと一致するようにノードを変更します。
utils dbreplication repairtable tablename [nodename | all ]
構文の説明
パラメータ
説明
tablename
修復するテーブルを指定します。
nodename
複製を修復するノードを指定します。
all
すべてのノードで複製を修復することを指定します。
使用上のガイドライン
(注)
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils dbreplication reset
このコマンドは、データベース複製をリセットして再起動します。システムで複製が適切に設定されていないときは、このコマンドを使用して複製を再構築できます。
utils dbreplication reset {nodename | all }
構文の説明
パラメータ
説明
nodename
特定のサブスクライバ サーバの複製が再構築されるように指定します。
all
クラスタ内のすべてのサブスクライバ サーバの複製が再構築されるように指定します。
使用上のガイドライン
このコマンドは、サーバで RTMT 状態 4 が示されたときに使用するのに最適なオプションです。1 つのサブスクライバ サーバだけが RTMT 状態 4 を示している場合は、hostname パラメータを指定することにより、そのサーバをリセットできます。クラスタ全体をリセットするには、all パラメータを使用します。
ヒント
このコマンドを実行する前に、リセットするすべてのサブスクライバ サーバで utils dbreplication stop コマンドを実行し、その後、パブリッシャ サーバでも実行します。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils dbreplication runtimestate
このコマンドは、データベース複製プロセスの進捗を監視し、クラスタ内の複製状態を出力します。
utils dbreplication runtimestate nodename
構文の説明
パラメータ
説明
nodename
モニタするノードを指定します。
使用上のガイドライン
ノード名を指定すると、選択されたノードのコンテキストから複製状態が出力されます。
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils dbreplication setprocess
このコマンドは、WAN によって分離されて遅延を伴うノードを持つクラスタ(WAN でのクラスタ設定)の複製パフォーマンスを向上させます。
utils dbreplication setprocess [process]
構文の説明
パラメータ
説明
process
新規のデータベース複製。この値は、1 から 40 までです。
デフォルト値:1
使用上のガイドライン
注意
process オプションを最大値に近い値に設定すると、システム リソースの消費量が増加します。
アップグレードの後、新しいバージョンに切り替える前に行った変更は、手動で再適用する必要があります。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
utils dbreplication setrepltimeout
このコマンドは、大きなクラスタでデータベース複製のタイムアウトを設定します。
utils dbreplication setrepltimeout タイムアウト
構文の説明
パラメータ
説明
timeout
新しいデータベース複製のタイムアウト時間(秒)。この値は、300 から 3600 までです。
デフォルト値:300(5 分)
使用上のガイドライン
最初のサブスクライバ サーバがパブリッシャ サーバに複製を要求すると、このタイマーが設定されます。タイマーの期限が切れると、最初のサブスクライバ サーバ、およびその期間内に複製を要求した他のすべてのサブスクライバ サーバが、パブリッシャ サーバとの間でバッチによるデータ複製を開始します。複数のサブスクライバ
サーバがある場合は、個別のサーバ複製よりもバッチ複製が効率的です。大きなクラスタでは、このコマンドを使用してデフォルトのタイムアウト値よりも大きくすることで、バッチに含めるサブスクライバ サーバの数を増やすことができます。
ヒント
クラスタ全体のアップグレードが完了し、サブスクライバ サーバの複製が適切に設定されたら、この値をデフォルトの 300(5 分)に戻すことをお勧めします。
(注)
パブリッシャ サーバをアップグレードし、アップグレード後のパーティションで再起動する場合は、最初のサブスクライバ サーバを新しいリリースに切り替える前に、このタイマー値を設定する必要があります。最初のサブスクライバ サーバが複製を要求すると、パブリッシャ
サーバはこの新しい値に基づいて複製タイマーを設定します。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils dbreplication status
このコマンドは、データベース複製のステータスを表示し、クラスタ内のサーバが接続されてデータが同期しているかどうかを示します。
utils dbreplication status {all | node | replicate }
構文の説明
パラメータ
説明
all
すべてのサーバのステータスを表示するように指定します。
node
ステータスを表示するノードを指定します。
replicate
ステータスを表示する複製を指定します。
使用上のガイドライン
(注)
このコマンドは、クラスタの最初のノード(パブリッシャ サーバ)でのみ実行してください。
要件
コマンド特権レベル:0
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils dbreplication stop
このコマンドは、データベース複製の自動設定を停止します。サブスクライバーおよびパブリッシャーサーバでこのコマンドを実行する前に、CLI コマンド utils dbreplication reset または utils dbreblication clusterreset を実行してください。このコマンドは、パブリッシャ サーバで実行する前に複数のサブスクライバ サーバで同時に実行できます。
utils dbreplication stop {nodename | all }
構文の説明
パラメータ
説明
nodename
データベース複製の自動設定を停止するノードの名前を指定します。
all
すべてのノードでデータベース複製を停止します。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils imdb_replication replication status
このコマンドは、導入における各サブクラスタのノード ペア間のイン メモリ データベース(IMDB)レプリケーションが正しく動作することを検証します。
このコマンドは、IM and Presence サービス ノードの発信からのユーティリティを使用して、それぞれの関連するデータストアの IMDB テーブルで読み取りおよび書き込みを実行します。
utils imdb_replication status
使用上のガイドライン
ユーティリティを正常に実行するには、IM and Presence サービス クラスタのノード間で設定されたすべてのファイアウォールでポート 6603、6604、6605 が開いている必要があります。
これは IMDB の正常な動作には不要です。
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:IM and Presence サービス
utils diagnose
このコマンドを使用すると、システムの問題を診断し、自動修復を試行できます。
utils diagnose {fix | list | module | test | version } [module_name]
構文の説明
パラメータ
説明
fix
すべての診断コマンドを実行し、問題の修復を試行します。
hcs
HCS サービスで使用可能なすべての診断コマンドをリスト表示します。
list
使用可能なすべての診断コマンドをリスト表示します。
module
単独の診断コマンドまたはコマンドのグループを実行し、問題の修復を試行します。
test
すべての診断コマンドを実行しますが、問題の修復は試行しません。
version
診断フレームワークのバージョンを表示します。
module_name
診断モジュールの名前を指定します。
要件
コマンド特権レベル:version の場合は 0、その他すべてのパラメータの場合は 1
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection。
utils disaster_recovery*
utils disaster_recovery backup network
リモート サーバに格納されるバックアップ ファイルに関する情報を表示します。
utils disaster_recovery backup network [featurelist] [path] [servername] [username]
構文の説明
パラメータ
説明
[featurelist]
バックアップする機能のリストを、カンマ区切りで指定します。
[path]
リモート サーバ上のバックアップ ファイルの場所を表します。
[servername]
バックアップ ファイルを格納するサーバの IP アドレスまたはホスト名を表します。
[username]
リモート サーバにログインするときに必要なユーザ名を表します。
使用上のガイドライン
リモート サーバ上のアカウントのパスワードを入力するように要求するプロンプトが表示されます。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils disaster_recovery cancel_backup
このコマンドは、進行中のバックアップ ジョブをキャンセルします。
utils disaster_recovery cancel_backup [confirm]
使用上のガイドライン
コマンドの入力後、バックアップのキャンセルについて確認する必要があります。Y を押すとバックアップがキャンセルされ、それ以外のキーを押すとバックアップが続行します。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
例
admin: utils disaster_recovery cancel_backup yes
Cancelling backup...
Backup cancelled successfully.
utils disaster_recovery device add network
このコマンドは、バックアップ ネットワーク デバイスを追加します。
utils disaster_recovery device add network devicename path server_namei/ip_address username [Number_of_backups]
構文の説明
パラメータ
説明
devicename
追加するバックアップ デバイスの名前を指定します(必須)。
path
バックアップ デバイスを取得するパスを指定します(必須)。
server_name/ip_address
バックアップ ファイルが格納されているサーバのホスト名または IP アドレスを指定します(必須)。
username
リモート マシンに接続するために必要なユーザ ID を指定します(必須)。
[Number_of_backups]
ネットワーク ディレクトリに格納するバックアップの数を指定します(デフォルトは 2)。このパラメータはオプションです。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
例
admin: utils disaster_recovery device add network networkDevice /root 10.77.31.116 root 3
utils disaster_recovery device delete
utils disaster_recovery device delete device_name | *
構文の説明
パラメータ
説明
device_name
削除するデバイスの名前です。
*
スケジュールに関連付けられているデバイスを除き、既存のすべてのデバイスを削除します。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils disaster_recovery device list
すべてのバックアップ デバイスのデバイス名、デバイス タイプ、およびデバイス パスを表示します。
utils disaster_recovery device list
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils disaster_recovery estimate_tar_size
このコマンドは、SFTP またはローカル デバイスから最後に成功したバックアップの推定サイズを示します。
utils disaster_recovery estimate_tar_size utils disaster_recovery device list
構文の説明
パラメータ
説明
featurelist
バックアップする機能のリストを、カンマ区切りで指定します。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils disaster_recovery history
このコマンドは、以前のバックアップと復元の履歴を表示します。
utils disaster_recovery history [operation]
構文の説明
パラメータ
説明
operation
バックアップまたは復元を指定します。
要件
コマンド特権レベル:
アップグレード時の使用:
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
例
admin: utils disaster_recovery history backup
Tar Filename: Backup Device: Completed On: Result: Backup Type: Features Backed Up:
2009-10-30-14-53-32.tar TAPE Fri Oct 30 14:55:31 CDT 2009 ERROR MANUAL
2009-12-10-10-30-17.tar TAPE Thu Dec 10 10:35:22 CST 2009 SUCCESS MANUAL CDR_CAR,CCM
utils disaster_recovery jschLogs operation
このコマンドは、JSch の詳細ロギングを有効および無効にします。
utils disaster_recovery jschLogs operation [operation]
構文の説明
パラメータ
説明
operation
操作の名前(enable または disable)を指定します。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils disaster_recovery prepare restore pub_from_sub
このコマンドは、サブスクライバ ノードからパブリッシャ ノードを復元する準備をするためのタスクを処理します。
(注)
このコマンドは、パブリッシャ ノードを再構築し、サブスクライバ ノード データベースから復元する場合にのみ使用できます。リモート バックアップ ソースからデータを復元する代わりに、特定の復元手順が使用されます。パブリッシャ ノードが再構築されたら、プロセス
ノード情報の挿入前にこのコマンドを使用する必要があります。
utils disaster_recovery prepare restore pub_from_sub
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils disaster_recovery restore network
このコマンドは、リモート サーバを復元します。同じクラスタのサブスクライバ ノードを復元する前に、Unified Communications Manager パブリッシャ ノードを復元する必要があります。IM and Presence Service ノードを復元すると、同じクラスタ内のサブスクライバ ノードを復元する前にデータベース パブリッシャ ノードを復元する必要があります。
utils disaster_recovery restore network restore_server tarfilename devicename
構文の説明
パラメータ
説明
restore_server
復元するリモート サーバのホスト名を指定します。
tarfilename
復元するファイルの名前を指定します。
devicename
ファイルを復元するデバイスの名前を指定します。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils disaster_recovery schedule add
このコマンドは、設定されているスケジュールを追加します。
utils disaster_recovery schedule add schedulename devicename featurelist datetime frequency
構文の説明
パラメータ
説明
schedulename
スケジューラの名前を表します(必須)。
devicename
スケジューリングが行われているデバイスの名前を表します(必須)。
featurelist
バックアップするカンマ区切り機能リストを表します(必須)。
datetime
スケジューラを設定する日付を表します(必須)。yyyy/mm/dd-hh:mm という形式で 24 時間制で指定します。
frequency
バックアップを作成するようにスケジュールを設定する頻度を表します。例:1 回、日次、週次、月次。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils disaster_recovery schedule
このコマンドは、指定されたスケジュールをイネーブルまたはディセーブルにします。
utils disaster_recovery schedule {enable | disable } [schedulename]
構文の説明
パラメータ
説明
enable
指定されたスケジュールをイネーブルにします。
disable
指定されたスケジュールをディセーブルにします。
schedulename
スケジューラの名前を表します。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
例
admin: utils disaster_recovery schedule enable schedule1
Schedule enabled successfully.
utils disaster_recovery schedule delete
このコマンドは、設定されているスケジュールを削除します。
utils disaster_recovery schedule delete schedulename
構文の説明
パラメータ
説明
schedulename
削除するスケジュールの名前を表します。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils disaster_recovery schedule disable
このコマンドは、設定されているスケジュールを無効にします。
utils disaster_recovery schedule disable schedulename
構文の説明
パラメータ
説明
schedulename
無効にするスケジュールの名前を表します。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils disaster_recovery schedule list
utils disaster_recovery schedule list
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
例
admin: utils disaster_recovery schedule list
schedule name device name Schedule Status
-----------------------------------------
schedule1 device 1 enabled
schedule2 device 2 disabled
utils disaster_recovery show_backupfiles
このコマンドは、ストレージの場所で入手できるバックアップ ファイルの情報を取得します。
utils disaster_recovery show_backupfiles devicename
構文の説明
パラメータ
説明
devicename
ストレージの場所でバックアップ ファイルを表示するデバイスの名前を表します。
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils disaster_recovery show_registration
このコマンドは、指定されたサーバに登録されているフィーチャおよびコンポーネントを表示します。
utils disaster_recovery show_registration hostname
構文の説明
パラメータ
説明
hostname
登録情報を表示するサーバを指定します。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils disaster_recovery status
このコマンドは、現在のバックアップまたは復元ジョブのステータスを表示します。
utils disaster_recovery status operation
構文の説明
パラメータ
説明
operation
進行中の操作の名前(backup または restore)を指定します。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils EnhancedSecurityMode*
utils EnhancedSecurityMode disable
このコマンドは、システムで EnhancedSecurityMode モードを無効にします。このモードを無効にした後、システムのリブートが必要です。
utils EnhancedSecurityMode disable
要件
コマンド特権レベル:4
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils EnhancedSecurityMode enable
このコマンドは、システムで EnhancedSecurityMode モードを有効にします。このモードを有効にした後、システムのリブートが必要です。
utils EnhancedSecurityMode enable
要件
コマンド特権レベル:4
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils EnhancedSecurityMode status
このコマンドは、システムが EnhancedSecurityMode モードまたは非 EnhancedSecurityMode モードのいずれで動作しているかを表示します。
utils EnhancedSecurityMode status
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils filebeat*
utils filebeat config
このコマンドは、情報をダウンロードするための Logstash サーバの詳細を構成します。
utils filebeat config IP address port number log type
構文の説明
パラメータ
説明
IP address
Logstash サーバの IP アドレスを入力します。
port number
Logstash サーバのポート番号を入力します。
log type
Logstash サーバにアップロードする必要があるログ タイプを入力します。
TLS を有効にして、Filebeat サービスをセキュリティで保護することもできます。パラメータを設定すると、次のプロンプトが表示されます。
Do you wish to secure the filebeat service by enabling TLS?
Enter (yes/no) ?
TLS を有効にする場合は、Yes と入力します。
要件
コマンド特権レベル:4
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils filebeat disable
このコマンドは、システムで Filebeat 構成を無効にします。
要件
コマンド特権レベル:4
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils filebeat enable
このコマンドは、システムで Filebeat 構成を有効にします。
要件
コマンド特権レベル:4
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils filebeat status
このコマンドは、Filebeat が実行されているかどうか、およびその構成値を表示します。
要件
コマンド特権レベル:4
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils filebeat tls
このコマンドは、Filebeat クライアントと Logstash サーバ間の通信用のプロトコルとして、Transport Layer Security(TLS)1.2 を設定します。これにより、Filebeat クライアントと Logstash
サーバ間のセキュアな接続が可能になります。これは、コモン クライテリア ガイドラインに準拠するための要件です。
コモン クライテリア モードでは、厳密なホスト名検証が使用されます。そのため、証明書と一致する完全修飾ドメイン名(FQDN)でサーバを設定する必要があります。
utils filebeat tls {enable | disable | status }
構文の説明
パラメータ
説明
enable
Filebeat クライアントと Logstash サーバ間のセキュアな接続を有効にします。
disable
Filebeat クライアントの TLS を無効にします。
status
TLS のステータスを表示します。
要件
コマンド特権レベル:4
適用対象:Unified Communications Manager、Unified Communications Manager の IM and Presence サービス
セキュリティ証明書を、Logstash サーバから Unified Communications Manager および IM and Presence サービス上の tomcat 信頼ストアにアップロードする必要があります。
utils fior*
utils fior
このコマンドを使用すると、サーバの I/O をモニタリングできます。ファイル I/O レポーティング サービスは、プロセスごとにファイル I/O を収集するカーネル ベースのデーモンを提供します。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils fior disable
このコマンドは、I/O 統計モニタリングを無効にして、システムで収集されたすべてのモニタリング データを削除します。このコマンドは、モニタリングを無効にし、データのモニタリングにより使用されるディスク領域を解放するために使用します。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils fior enable
このコマンドは、I/O 統計モニタリングを有効にします。
(注)
このコマンドは、モニタリングが開始される前に使用します。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils fior list
このコマンドは、すべてのプロセスの I/O イベントをリスト表示します。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils fior start
このコマンドは、I/O 統計ユーティリティのモニタリングとデータ収集を開始します。モニタリングの開始後、I/O 統計データはプラットフォーム ログに収集されます。このデータは、1 日あたり最大 25 MB 格納できます。データは、データ収集から
7 日後に新しいデータにローテーションされます。このデータは、I/O 統計ユーティリティ モニタリングを無効にすると削除されます。
(注)
モニタリングを開始する前に I/O 統計ユーティリティ モニタリングを有効にしてください。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils fior status
このコマンドは、I/O 統計モニタリング ユーティリティのステータスを示します。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils fior stop
このコマンドは、I/O 統計モニタリングとデータ収集を停止します。ただし、このコマンドでは収集されたデータは削除されません。
(注)
I/O 統計が不要になった場合は、プラットフォーム ログからのモニタリング データのクリーンアップを無効にします。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils fior top
このコマンドは、コマンド実行時の I/O バウンド型プロセスの I/O 統計情報のリストを表示します。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils fips
このコマンドは、FIPS 140-2 モードをイネーブルまたはディセーブルにします。また、FIPS 140-2 モードのステータスを表示します。FIPS 140-2 モードはデフォルトでディセーブルです。FIPS をイネーブルにできるのは管理者のみです。
utils fips {enable | disable | status }
構文の説明
パラメータ
説明
enable
FIPS 140-2 モードをアクティブにします。
disable
FIPS 140-2 モードを非アクティブにします。
status
FIPS 140-2 モードのステータスを表示します。
使用上のガイドライン
FIPS モードを有効にする前に、システム バックアップを実行することを推奨します。FIPS のチェックが起動時に失敗した場合は、システムが停止し、復元するにはリカバリ CD が必要になります。
FIPS 140-2 モードをイネーブルにする前に、次の点を考慮してください。
非 FIPS モードから FIPS モードに切り替えた場合は、MD5 および DES プロトコルは機能しません。
FIPS モードをサーバでイネーブルにした後は、サーバがリブートし、電話機が正常に再登録されるまで待機してから、次のサーバで FIPS をイネーブルにしてください。
FIPS モードでは、IM and Presence サービスは Racoon(FIPS 未検証)の代わりに Red Hat Openswan(FIPS 検証済み)を使用します。Raccoon のセキュリティ ポリシーに、FIPS で承認されていない機能が含まれている場合、CLI コマンドは、FIPS
で承認された機能を使用してセキュリティ ポリシーを定義し直すよう表示して終了します。
(注)
証明書および SSH キーは、FIPS 要件に応じて、自動的に再生成されます。
FIPS 140-2 モードをディセーブルにする前に、次の点を考慮します。複数サーバのクラスタでは、各サーバは個別にディセーブルにする必要があります。FIPS モードはクラスタ全体でディセーブルにできないため、サーバ単位でディセーブルにしてください。
FIPS 140-2 にモードをイネーブルにした後、次の点を考慮します。シングル サーバ クラスタを使用していて、FIPS モードをイネーブルにする前に「Prepare Cluster for Rolback to pre 8.0」エンタープライズ
パラメータの適用を選択した場合は、すべての電話機がサーバに正常に登録されたことを確認してから、このパラメータをディセーブルにしてください。
IM and Presence サービス の FIPS 140-2 モードを有効または無効にする前に、次のことを考慮してください。IM and Presence サービス の FIPS 140-2 モードを有効または無効にすると、Tomcat 証明書が再生成され、ノードが再起動します。Intercluster Sync Agent は、新しい Tomcat 証明書をクラスタ全体で同期します。この同期が完了するまでには最大
30 分かかります。新しい Tomcat 証明書がクラスタ全体で同期されるまで、IM and Presence サービス サブスクライバ ノードは IM and Presence サービス データベース パブリッシャ ノードの情報にアクセスできません。たとえば、サブスクライバ ノードで Cisco Unified Serviceability GUI にログインしたユーザは、IM and Presence サービス データベース パブリッシャ ノードのサービスを表示できません。同期が完了するまで、ユーザには、証明書例外によるサーバへの接続を確立できないことを通知する、Connection to server cannot be established (certificate exception) というメッセージが表示されます。
要件
コマンド特権レベル:0
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils fips_common_criteria
このコマンドは、システムのコモン クライテリア モードを設定します。
utils fips_common_criteria {enable | disable | status }
構文の説明
パラメータ
説明
enable
システムでコモン クライテリア モードを有効にします。
disable
システムでコモン クライテリア モードを無効にします。
コモン クライテリア モードが無効化されると、最小 TLS バージョンを設定するよう求めるプロンプトが表示されます。
status
システムのコモン クライテリア モードのステータスを表示します。
使用上のガイドライン
コモン クライテリア モードを有効化した後では、TLS バージョン 1.0 を使用したセキュア接続は許可されません。コモン クライテリア モードを有効にしている間は、FIPS モードが有効になります。コモン クライテリア モードを有効化または無効化しても、証明書を再生成する必要はありません。ただし、FIPS を有効にしたり無効にしたりするには、証明書の再生性と同時にシステムの再起動が必要です。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager および IM and Presence サービス
(注)
この CLI コマンドは、Cisco Unity Connection には適用されません。
utils firewall*
utils firewall ipv4 debug
このコマンドは、IPv4 ファイアウォールのデバッグをオンまたはオフにします。time パラメータを入力しない場合、デバッグは 5 分間オンになります。
utils firewall ipv4 debug {off | | [時刻] }
構文の説明
パラメータ
説明
off
IPv4 ファイアウォールのデバッグをオフにします。time パラメータを入力しない場合、ファイアウォールは 5 分間ディセーブルになります。
time
(任意)ファイアウォールのデバッグをイネーブルにする期間を次の形式で設定します。
分:0~1440m
時間:0~23h
時間および分:0~23h 0~60m
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス および Cisco Unity Connection。
utils firewall ipv4
このコマンドは、IPv4 ファイアウォールをイネーブル/ディセーブルにします。
utils firewall ipv4 {enable | disable | [time] }
構文の説明
パラメータ
説明
enable
IPv4 ファイアウォールをオンにします。
disable
IPv4 ファイアウォールをオフにします。time パラメータを入力しない場合、ファイアウォールは 5 分間ディセーブルになります。
time
(任意)ファイアウォールをディセーブルにする期間を次の形式で設定します。
分:0~1440m
時間:0~23h
時間および分:0~23h 0~60m
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス および Cisco Unity Connection。
utils firewall ipv4 list
このコマンドは、IPv4 ファイアウォールの現在の設定を表示します。
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス および Cisco Unity Connection。
utils firewall ipv4 status
このコマンドは、IPv4 ファイアウォールの現在のステータスを表示します。
utils firewall ipv4 status
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス および Cisco Unity Connection。
utils firewall ipv6 debug
このコマンドは、設定された時間、IPv6 ファイアウォール デバッグをオンにします。時間のデフォルト値は 5 分です。
utils ipv6 firewall debug {off | | [時刻] }
構文の説明
パラメータ
説明
off
(任意)IPv6 ファイアウォールのデバッグをオフにします。time パラメータを入力しない場合、このコマンドは、デフォルトの時間の値に従ってファイアウォールを無効にします。
time
(任意)ファイアウォールのデバッグをイネーブルにする期間を次の形式で設定します。
分:0~1440m
時間:0~23h
時間および分:0~23h 0~60m
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager および Cisco Unity Connection。
utils firewall ipv6
このコマンドは、IPv6 ファイアウォールをイネーブル/ディセーブルにします。
utils firewall ipv6 {enable | disable | [time] }
構文の説明
パラメータ
説明
enable
IPv6 ファイアウォールをオンにします。
disable
IPv6 ファイアウォールをオフにします。time パラメータを入力しない場合、ファイアウォールは 5 分間ディセーブルになります。
time
(任意)ファイアウォールをディセーブルにする期間を次の形式で設定します。
分:0~1440m
時間:0~23h
時間および分:0~23h 0~60m
使用上のガイドライン
このコマンドは、ファイアウォール テーブルをイネーブルまたはディセーブルにするために使用できます。USGv6 プロファイルとのコンプライアンスのために Unified Communications Manager をテストする場合は、テストを開始する前に
23 時間にわたり IPv6 ファイアウォール テーブルをディセーブルにする必要があります。
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager および Cisco Unity Connection。
utils firewall ipv6 list
このコマンドは、IPv6 ファイアウォールの現在の設定を表示します。
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager および Cisco Unity Connection。
utils firewall ipv6 status
このコマンドは、IPv6 ファイアウォールの現在のステータスを表示します。
utils firewall ipv6 status
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager および Cisco Unity Connection。
utils ha*
utils ha failover
このコマンドは、特定のノードの手動フェールオーバーを開始します。このとき、Cisco Server Recovery Manager により、障害が発生したノードのクリティカル サービスが停止され、すべてのユーザがバックアップ ノードに移行されます。
IM and Presence ノードの場合、バックアップ ノードは別の IM and Presence サーバである必要があります。バックアップ サーバを指定する前に、2 つのサーバが同じ既存の冗長グループに割り当てられている必要があります。既存の冗長グループに割り当てられた他のサーバをバックアップ
サーバに指定します。
utils ha failover {node name }
構文の説明
パラメータ
説明
node name
手動フェールオーバーを実行するノードを指定します。
要件
適用対象:Unified Communications Manager および Unified Communications Manager の IM and Presence サービス
failover の例
admin: ha failover shorty-cups
Initiate Manual Failover for Node > shorty-cups
Request SUCCESSFUL.
Subcluster Name: DefaultCluster
Node 1 Name : kal-cup1 State: Taking Over Reason: On Admin Request
Node 2 Name : shorty-cups State: Failover Reason: On Admin Request
utils ha fallback
このコマンドは、特定のノードの手動フォールバックを開始します。このとき、Cisco Server Recovery Manager によりアクティブなノードでクリティカル サービスが再起動され、ユーザはアクティブなノードに戻されます。
utils ha fallback node name
構文の説明
パラメータ
説明
node name
手動フォールバックを実行するノードを指定します。
要件
適用対象:Unified Communications Manager および Unified Communications Manager の IM and Presence サービス
fallback の例
admin: ha fallback shorty-cups
Initiate Manual fallback for Node >shorty-cups<
Request SUCCESSFUL.
Subcluster Name: DefaultCluster
Node 1 Name : kal-cup1 State: Falling Back Reason: On Admin Request
Node 2 Name : shorty-cups State: Taking Back Reason: On Admin Request
utils haproxy set {required|optional|disable} client-auth
このコマンドは、指定されたポートでのクライアント認証の値を設定します。認証でサポートされている値は、Required、Optional、または Disable です。
次の表に、ポートのデフォルト値を示します。
表 1. ポートのデフォルト値
[Port]
デフォルト値
6971
任意
6972
任意
9443
必須
警告
クライアント認証をデフォルト値以外に設定すると、重大な影響を引き起こす可能性があります。これらの値は、Cisco TAC チームのアドバイスに従っている場合にのみ変更してください。
utils haproxy set {required | optional | disable }client-auth portnum
構文の説明
パラメータ
説明
portnum
ポート番号を入力して、HAProxy クライアント認証を設定します。
(注)
サポートされているポート番号は、6971、6972、9443 です。
required
指定されたポートでクライアント認証の値を "required" に設定します。
optional
指定されたポートでクライアント認証の値を "optional" に設定します。
disable
指定されたポートでクライアント認証の値を "disable" に設定します。
使用上のガイドライン
ユーザが 6971、6972、または 9443 以外の portnum 値を入力すると、有効なポート番号を入力するようエラーメッセージが表示されます。
管理者は help utils haproxy set optional client-auth コマンドを実行して、ヘルプ コンテンツを表示できます。
portnum の設定されているクライアント認証値は、アップグレード中も、ディザスタ リカバリ システム(DRS)を使用してバックアップを実行している場合も保持され、復元できます。
クライアント認証が "required" に設定されている場合、サーバはクライアントからの証明書を要求します。クライアントは、要求された証明書をサーバに提示する必要があります。そのため、要求はそれ以降のサービスに転送できます。
クライアント認証が "optional" に設定されている場合、サーバはクライアントからの証明書を要求します。クライアントが要求された証明書をサーバに提示しない場合でも、要求はそれ以降のサービスに転送できます。
クライアント認証を "disable" に設定した場合、サーバはクライアントからの証明書を要求しません。
このコマンドを実行すると、HAProxy プロセスが再起動します。
要件
コマンド特権レベル:1
適用対象:Unified Communications Manager
例
admin:utils haproxy set required client-auth 6971
This command will result in the HA Proxy service set the client
authentication as per your specification and restart the
HAProxy process. Restarting of the HAProxy process might
result in momentary disconnection of all Phones and Jabber
clients that are accessing this service for secure
configuration file downloads. It is recommended this
operation be performed during off-busy hours and ensure
there are no TFTP operations in progress.
Warning: Setting the client authentication to anything other
than default value could have serious implications.
Please change these values only as per Cisco TAC team's advise
Do you want to continue (yes/no) ? yes
Successfully set client authentication to required
HAProxy Process already running .. restarting
admin:
admin:utils haproxy set disable client-auth 6972
HAProxy client authentication is already set to
disable on port 6972 . No action will be taken.
admin:utils haproxy client-auth set 1234 disable
Please enter valid values for the port.
Supported values are 6971, 6972 and 9443
admin:help utils haproxy set required client-auth 6971
utils haproxy set required client-auth
This command updates the value of client authentication
as required on specified port.
Example:
admin:utils haproxy set required client-auth 6971
HAProxy client authentication is already set to
required on port 6971. No action will be taken.
admin:
utils haproxy set num-threads
このコマンドは、HAProxy サービスによって生成されるスレッドの数を設定します。
警告
このパラメータをデフォルト値以外の値に設定すると、重大な影響をもたらす場合があります。これらの値は、Cisco TAC チームのアドバイスに従っている場合にのみ変更してください。
utils haproxy set num-threads numThreads
構文の説明
パラメータ
説明
numThreads
設定する HAProxy スレッドの数を入力します。
(注)
デフォルト値は 1 です。
スレッド数のサポートされている値は 1、2、3、4 です。
使用上のガイドライン
ユーザが 1、2、3、4 以外の numThreads 値を入力すると、有効な数の haproxy スレッドを入力するようエラーメッセージが表示されます。
管理者は help utils haproxy set num-threads コマンドを実行して、ヘルプ コンテンツを表示できます。
設定された numThreads 値は、アップグレードの間だけでなく、ディザスタ リカバリ システム(DRS)とリストアを使用してバックアップを実行している場合も保持されます。
このコマンドを実行すると、HAProxy プロセスが再起動します。
要件
コマンド特権レベル:1
適用対象:Unified Communications Manager
例
admin:utils haproxy set num-threads 3
This command will result in the HAProxy service spawn as many threads
as you have specified and restart the HAProxy process. Restarting of
the HAProxy process might result in momentary disconnection of all
Phones and Jabber clients that are accessing this service for
secure configuration file downloads and authenticated users data
access. It is recommended this operation be performed during
off-busy hours and ensure there are no TFTP operations in progress.
Warning: Setting this parameter to anything other than default
value could have serious implications. Please change these values
only as per Cisco TAC team's advise
Do you want to continue (yes/no) ? yes
Successfully set number of HAProxy threads to 3
Restarting HAProxy process
admin:
admin:utils haproxy set num-threads 5
Please enter a valid number of HAProxy threads.
Supported values are 1, 2, 3 and 4
utils ha recover
このコマンドは、(ノードが障害状態の場合に)既存の冗長グループの手動リカバリを開始します。このとき、IM and Presence により、その既存の冗長グループで Cisco Server Recovery Manager サービスが再起動されます。
utils ha recover presence redundancy group name
構文の説明
パラメータ
説明
presence redundancy group name
HA ステータスをモニタする既存の冗長グループを指定します。既存の冗長グループ名を指定しないと、すべてのクラスタ情報が提供されます。
要件
適用対象:Unified Communications Manager および Unified Communications Manager の IM and Presence サービス
recover の例
admin: ha recover Defaultcluster
Stopping services... Stopped
Starting services... Started
admin:
utils ha status
このコマンドは、指定されたプレゼンス冗長グループの HA ステータスを表示します。
utils ha status presence redundancy group name
構文の説明
パラメータ
説明
presence redundancy group name
HA ステータスをモニタするプレゼンス冗長グループを指定します。プレゼンス冗長グループ名を指定しないと、すべてのクラスタ情報が表示されます。
要件
適用対象:Unified Communications Manager および Unified Communications Manager の IM and Presence サービス
HA がイネーブルでない場合のステータスの例
admin: ha status
Subcluster Name: DefaultCluster
Node 1 Name : kal-cup1 State: Unknown Reason: High Availability Not Enabled
Node 2 Name : shorty-cups State: Unknown Reason: High Availability Not Enabled
HA がイネーブルの場合のステータスの例
admin: ha status
Subcluster Name: DefaultCluster
Node 1 Name : kal-cup1 State: Normal
Node 2 Name : shorty-cups State: Normal
クリティカル サービスがダウンした場合のステータスの例
admin: ha status
Subcluster Name: DefaultCluster
Node 1 Name : kal-cup1 State: Failed Over with Critical Services not Running Reason:
Critical Service Down
Node 2 Name : shorty-cups State: Running in Backup Mode Reason: Critical Service Down
障害が発生した場合のステータスの例
admin: ha status
Subcluster Name: DefaultCluster
Node 1 Name : kal-cup1 State: Failed Reason: Critical Service Down
Node 2 Name : shorty-cups State: Failed Reason: Critical Service Down
utils ils showpeerinfo
このコマンドは、ILS ネットワーク内のシングル クラスタ、または ILS ネットワーク内のすべてのクラスタのピア情報ベクトルを返します。
utils ils showpeerinfo clustername
構文の説明
パラメータ
説明
clustername
ILS ネットワーク内の Unified Communications Manager クラスタのパブリッシャ ノードの完全修飾ドメイン名を指定します。
使用上のガイドライン
ピア情報ベクトルには、ILS ネットワーク内のクラスタに関する情報が含まれます。取得できる情報には、クラスタ ノードのクラスタ名、クラスタ ID、IP アドレスが含まれます。ILS ネットワークの特定のクラスタに関する情報が必要な場合は、clustername パラメータを入力します。ネットワーク内のすべてのクラスタ情報が必要な場合は、clustername パラメータをブランクにします。
要件
コマンド特権レベル:0
アップグレード時の使用:不可
適用対象:Unified Communications Manager
utils import config
このコマンドは、仮想フロッピー ドライブ上の platformConfig.xml ファイルからデータを取得し、設定ファイルに一致するようにシステムを変更します。コマンドの完了後、システムがリブートします。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
VMware 展開での utils import config の実行
utils iostat
このコマンドは、指定された回数と間隔で iostat 出力を表示します。
utils iostat {interval | iterations | filename }
構文の説明
パラメータ
説明
interval
iostat 読み取り間隔を秒数で設定します。iteration パラメータを使用する場合は、この値を設定する必要があります。
iterations
iostat の繰り返し回数を設定します。interval パラメータを使用する場合は、この値を設定する必要があります。
filename
出力をファイルにリダイレクトします。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils iothrottle
このコマンドを使用すると、サーバ上の I/O スロットリングを管理およびモニタリングできます。
utils iothrottle {enable | disable | status }
構文の説明
パラメータ
説明
Enable
I/O スロットリング拡張をイネーブルにし、アクティブなシステムにアップグレードが与える影響を低減します。
Disable
I/O スロットリング拡張をディセーブルにします。
Status
I/O スロットリング拡張のステータスを表示します。
使用上のガイドライン
I/O スロットリング拡張をディセーブルにすると、アップグレード時にシステムが影響を受ける可能性があります。
要件
コマンド特権レベル:Enable および Disable の場合は 1、Status の場合は 0
utils itl reset
このコマンドは、エンドポイントが自己の構成ファイルを検証できない場合に使用します。
utils itl reset {localkey | remotekey }
構文の説明
localkey
パブリッシャの既存の ITL ファイルを取得して、新しい ITL ファイルを生成します。このコマンドは、その ITL ファイルの署名を置き換え、ITL 復元キーを使用して新しい ITL ファイルに署名します。
remotekey
リモート ロケーションからの復元証明書キー ペアを格納する PKCS 12 バッグをインポートした後、新しい ITL ファイルを生成します。その新しく生成した ITL ファイルに、復元秘密鍵を使用して署名します。
remotekey 次のパラメータを持ちます。
IPアドレス/ホスト名
ユーザ ID
ITLRecovery.p12
使用上のガイドライン
(注)
このコマンドは、Unified Communications Manager パブリッシャ ノードで実行する必要があります。
要件
コマンド特権レベル:4
アップグレード時の使用:不可
適用対象:Unified Communications Manager
例
admin:utils itl reset
Name is None
Generating the reset ITL file.....
The reset ITL file was generated successfully
Locating active Tftp servers in the cluster.....
Following is the list of Active tftp servers in the cluster
====================
se032c-94-42
=====================
Number of Active TFTP servers in the cluster : 1
Transferring new reset ITL file to the TFTP server nodes in the cluster.........
Successfully transferred reset ITL to node se032c-94-42
utils ldap config
このコマンドは、システムの LDAP 認証を設定します。
utils ldap config {fqdn | ipaddr }
構文の説明
パラメータ
説明
fqdn
システムの LDAP 認証に FQDN を使用するように設定します。
ipaddr
システムの LDAP 認証に IP アドレスを使用するように設定します
使用上のガイドライン
utils ldap config fqdn :LDAP 認証にはこのコマンドを使用することをお勧めしますが、このコマンドを使用できるのはシステムに DNS が設定されている場合だけです。システムが DNS を使用するように設定されていない場合は、utils ldap config ipaddr を使用してください。
utils ldap config ipaddr :このコマンドの使用はお勧めしません。システムで DNS を使用していないか、または DNS を使用するように設定できない場合にだけ、このコマンドを使用してください。システムが DNS を使用するように設定されている場合は utils ldap config fqdn を使用してください。
要件
コマンド特権レベル:1
適用対象:Unified Communications Manager および Cisco Unity Connection
utils ldap config status
このコマンドは、utils ldap 設定ステータスを表示します。
要件
コマンド特権レベル:0
アップグレード時の使用:可能
utils managementAgent alarms*
utils managementAgent alarms minpushLevel
プッシュ通知が有効になっている場合は、このコマンドを実行して、Unified Communications Manager がプッシュ通知アラームをシスコ クラウドに送信する最小アラーム重大度を設定します。
utils managementAgent alarms minpushLevel severity
構文の説明
パラメータ
説明
severity
この値は、Unified Communications Manager がプッシュ通知アラームをシスコ クラウドに送信する最小アラーム重大度を表します。オプションは次のいずれかです。
クリティカル(Critical)
エラー(Error)(これがデフォルトです)
Warning
[Notice]
情報
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager および IM and Presence サービス
utils managementAgent alarms pushfrequency
プッシュ通知が有効になっている場合は、このコマンドを実行して、Unified Communications Manager がプッシュ通知アラームをシスコ クラウドに送信する間隔を設定します。
utils managementAgent alarms pushfrequency minutes
構文の説明
パラメータ
説明
minutes
アップロード頻度(分単位)。この値は 5 ~ 90 の整数にする必要があります。デフォルトは 30 分です。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager および IM and Presence サービス
utils managementAgent alarms pushnow
プッシュ通知が有効になっている場合は、このコマンドを実行して、次回のスケジュールされたアップロードを待たずに、プッシュ通知アラームをシスコ クラウドにただちに送信します。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager および IM and Presence サービス
utils network*
utils network arp delete
このコマンドは、アドレス解決プロトコル テーブルのエントリを削除します。
utils network arp delete ホスト
構文の説明
パラメータ
説明
host
(任意)テーブルから削除するホストのホスト名または IP アドレスを表します。
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス および Cisco Unity Connection。
delete の例
admin:utils network arp delete myhost
utils network arp set
このコマンドは、アドレス解決プロトコル テーブルにエントリを設定します。
utils network arp set {ホスト } {addr }
構文の説明
パラメータ
説明
host
テーブルに追加するホストのホスト名または IP アドレスを表します。
addr
追加するホストのハードウェア アドレス(MAC)を表します。形式は XX:XX:XX:XX:XX:XX です。
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス および Cisco Unity Connection。
set の例
admin:utils network arp set myhost 11:22:33:44:55:66
utils network arp list
このコマンドは、アドレス解決プロトコル テーブルの内容を一覧表示します。
utils network arp list host hostname [options]
構文の説明
パラメータ
説明
host
hostname
オプション
使用上のガイドライン
Flags 列の C はキャッシュ、M は相手先固定、P はパブリッシュの意味です。
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス および Cisco Unity Connection。
list の例
admin:admin: utils network arp listAddress HWtype HWaddress
Flags Mask Iface
sjc21-3f-hsrp.cisco.com ether 00:00:0C:07:AC:71 C
eth0
philly.cisco.com ether 00:D0:B7:85:98:8E C
eth0
Entries: 2 Skipped: 0 Found: 2
utils network capture
このコマンドは、指定されたイーサネット インターフェイス上の IP パケットを取得します。
utils network capture eth0 [page] [numeric] [file | fname ] [count | num ] [size | bytes:バイト数 ] [src | addr ] [dest | addr ] [port | num ]
構文の説明
パラメータ
説明
eth0
イーサネット インターフェイス 0 を指定します。
page
(任意)出力を一度に 1 ページずつ表示します。
page オプションまたは file オプションを使用した場合、コマンドが完了する前に、要求されたすべてのパケットの完全なキャプチャが完了する必要があります。
numeric
(任意)ホストをドット付き IP アドレスとして表示します。
file fname
(任意)情報をファイルに出力します。
file オプションは、情報を platform/cli/fname.cap に保存します。ファイル名には「"." 」文字を使用できません。
count num
(任意)キャプチャするパケット数を設定します。
画面出力の場合、上限は 1000 です。ファイル出力の場合、上限は 10,000 です。
size bytes
(任意)キャプチャするパケットのバイト数を設定します。
画面出力の場合の最大バイト数は 128 です。ファイル出力の場合の最大バイト数は任意の数または ALL です。
src addr
(任意)パケットの送信元アドレスをホスト名または IPV4 アドレスで指定します。
dest addr
(任意)パケットの宛先アドレスをホスト名または IPV4 アドレスで指定します。
port num
(任意)パケットの送信元または宛先のポート番号を指定します。
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス および Cisco Unity Connection。
utils network capture-rotate
このコマンドは、utils network capture の 100,000 のパケット制限を超えて IP パケットを収集します。
utils network capture-rotate {file | fname } [size | bytes:バイト数 ] [sizePerFile | megabytes ] {maxFiles | | num } [src | addr ] [dest | addr ] [port | num ] [host protocol | addr ]
構文の説明
パラメータ
説明
file fname
情報をファイルに出力します。
(注)
ファイルは platform/cli/fname に保存されます。fname に「.」文字を含めることはできません。
size bytes
キャプチャするパケットのバイト数。有効な値は、最大 65535 の任意の数または ALL です。デフォルトは ALL です。
sizePerFile megabytes
sizePerFile は、ログ ファイルのサイズの値を設定します(単位は 100 万バイトです)。sizePerFile のデフォルト値は 25 MB です。
maxFiles num
maxFiles は、作成されるログ ファイルの最大数を指定します。maxFiles のデフォルト値は 10 です。
src addr
(任意)パケットの発信元アドレスをホスト名または IPv4 アドレスとして指定します。
dest addr
(任意)パケットの宛先アドレスをホスト名または IPV4 アドレスで指定します。
port num
(任意)パケットの送信元または宛先のポート番号を指定します。
host protocol addr
(任意)特定のホストと送受信されるトラフィックのみをキャプチャするように制限します。protocol のオプションは IP、arp、rarp、all で、addr は IPv4 またはホスト名形式である必要があります。host を使用する場合は、src または dest は指定しないでください。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス および Cisco Unity Connection。
utils network connectivity
このコマンドは、クラスタ内の最初のノード(この接続は後続のノードでのみ有効)とリモート ノードとのノード ネットワーク接続を確認します。
utils network connectivity [reset ] [hostname/ip address]
utils network connectivity [hostname/ip address] [port-number] [timeout]
構文の説明
パラメータ
説明
connectivity
このコマンドは、クラスタの最初のノードに対するノード ネットワーク接続を確認します。
また、2 つの必須パラメータ hostname/ip address および port-number があるリモート ノードへの接続をチェックするためにも使用されます。
reset
(任意)前の戻りコードをクリアします。
hostname/ip address
port-number
(必須)接続テストが必要なホストのポート番号。
timeout
(オプション)ポート接続メッセージが表示されるまでの時間を秒単位で指定します。
使用上のガイドライン
utils network connectivity [ reset ] [hostname/ip address] コマンドは、パブリッシャまたは最初のノードへのネットワーク接続をチェックするために使用されます。
utils network connectivity [ hostname/ip address ] [ port-number ] [timeout] コマンドは、リモート サーバへのネットワーク接続を確認するために使用されます。
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス および Cisco Unity Connection。
utils network host
このコマンドは、ホスト名をアドレスに、またはアドレスをホスト名に解決します。
utils network host name [server | serv ] [page ] [detail ] [srv ]
構文の説明
パラメータ
説明
name
解決するホスト名または IP アドレスを表します。
serv
(任意)代替のドメイン ネーム サーバを指定します。
[page ]
(任意)出力を一度に 1 画面ずつ表示します。
[detail ]
(任意)詳細なリストを表示します。
[srv ]
(任意)DNS SRV レコードを表示します。
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス および Cisco Unity Connection。
utils network ipv6 host
このコマンドは、指定されたホスト名または IPv6 アドレスに基づいて、IPv6 ホスト ルックアップ(または IPv6 アドレス ルックアップ)を実行します。
utils network ipv6 host {host_name | ipv6_address }
構文の説明
パラメータ
説明
host_name
サーバの名前を指定します。
ipv6_address
サーバの IPv6 アドレスを指定します。
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager および Cisco Unity Connection。
utils network ipv6 traceroute
このコマンドを使用すると、IPv6 アドレスまたはホスト名をトレースできます。
utils network ipv6 traceroute [ipv6-address | hostname ]
構文の説明
パラメータ
説明
ipv6-address
トレースする IPv6 アドレスを指定します。
hostname
トレースするホスト名を指定します。
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager および Cisco Unity Connection。
utils network ipv6 ping
このコマンドを使用すると、IPv6 アドレスまたはホスト名に対して ping を実行できます。
utils network ipv6 ping destination [count]
構文の説明
パラメータ
説明
destination
ping の実行対象として有効な IPv6 アドレスまたはホスト名を指定します。
[count]
外部のサーバに対する ping の回数を指定します。デフォルトの回数は 4 です。
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager および Cisco Unity Connection。
utils network ping
このコマンドは、別のサーバに ping を実行します。
utils network ping destination [count] [size]
構文の説明
パラメータ
説明
destination
ping を行うサーバの IP アドレスまたはホスト名を表します。
[count]
外部のサーバに対する ping の回数を指定します。デフォルト数は 4 です。
[size]
ping パケットのサイズをバイト単位で指定します。デフォルト値は 56 です。
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス および Cisco Unity Connection。
utils network traceroute
このコマンドは、リモートの宛先に送信される IP パケットをトレースします。
utils network traceroute [destination]
構文の説明
パラメータ
説明
destination
トレースの送信先のサーバのホスト名または IP アドレスを表します。
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス および Cisco Unity Connection。
utils network name-service {hosts|services} cache invalidate
このコマンドは、ネーム サービスのキャッシュをクリアします。
utils network name-service {hosts \ services} [cache invalidate]
構文の説明
パラメータ
説明
Hosts
ホストのサービス キャッシュ
Services
サービスのサービス キャッシュ
要件
コマンド特権レベル:1
アップグレード時の使用:不可
キャッシュのフラッシュまたはクリアについては、次の例を参考にしてください。 admin:utils network name-service hosts cache invalidate
admin:
Successful
utils ntp*
utils ntp auth symmetric-key
utils ntp auth symmetric-key {enable | disable | status }
このコマンドを使用して、選択した NTP サーバの認証を有効または無効にできます。認証は対称キー ID およびキーに基づいています。対称キーは、Unified Communications Manager で暗号化された形式で保存されます。
(注)
このコマンドを実行する前に、NTP サーバのキー ID とそれに対応するキーを把握していることを確認してください。
構文の説明
パラメータ
説明
enable
使用可能なサーバのリストから NTP サーバの 1 つを選択し、認証を有効にします。
disable
使用可能なサーバのリストから NTP サーバの 1 つを選択し、認証を無効にします。
status
リストされているすべての NTP サーバの認証ステータスを表示します。
使用上のガイドライン
NTP サーバの認証用のキー ID または対称キーを入力するように求められます。
(注)
要件
コマンド特権レベル:レベル 1 はすべてのコマンドを実行でき、レベル 0 はステータス コマンドのみを実行できます。
アップグレード時の使用:不可
適用対象:Unified Communications Manager
例:utils ntp auth symmetric-key status:NTP 認証が有効でない場合にステータスを表示します
admin:utils ntp auth symmetric-key status
10.77.32.92 : NTP Authentication is disabled.
10.77.46.203 : NTP Authentication is disabled.
ind assid status conf reach auth condition last_event cnt
==========================================================
1 8468 963a yes yes none sys.peer sys_peer 3
2 8469 9024 yes yes none reject reachable 2
例:utils ntp auth symmetric-key enable:NTP 認証を有効にします
admin:utils ntp auth symmetric-key enable
The List of NTP servers Configured:
1. 10.77.32.92
2. 10.77.46.203
q. press q to exit
Enter the selection for which to configure NTP authentication: 1
Please enter the Key ID [1-65534]:
2
Please enter the Symmetric Key of the NTP Server (SHA1):
Restarting NTP
please run the utils ntp auth symmetric-key status to check the status of NTP Authentication
例:utils ntp auth symmetric-key status:NTP 認証が有効になった後のステータスを表示します
admin:utils ntp auth symmetric-key status
10.77.46.203 : NTP Authentication is disabled.
10.77.32.92 : NTP Authentication is enabled.
ind assid status conf reach auth condition last_event cnt
=========================================================
1 57733 9044 yes yes none reject reachable 4
2 57734 f014 yes yes ok reject reachable 1
例:utils ntp auth symmetric-key disable:NTP 認証を無効にします
admin:utils ntp auth symmetric-key disable
The List of NTP servers Configured:
0. All
1. 10.77.46.203
2. 10.77.32.92
q. press q to exit
Enter the selection for which to disable NTP authentication: 2
NTP authentication has been disabled on the particular server.
Restarting NTP
例:utils ntp auth symmetric-key status:NTP 認証が無効になった後のステータスを表示します
10.77.46.203 : NTP Authentication is disabled.
10.77.32.92 : NTP Authentication is disabled.
ind assid status conf reach auth condition last_event cnt
===========================================================
1 42767 9144 yes yes none falsetick reachable 4
2 42768 912a yes yes none falsetick sys_peer 2
例:utils ntp auth symmetric-key status:NTP 認証のステータスを表示します
admin:utils ntp auth symmetric-key status
10.77.32.92 : NTP authentication is failed. Please check the NTP authentication Key ID and Symmetric Key entered is correct. To update, disable and reenable authentication for this NTP server.
10.77.32.78 : NTP Authentication is disabled.
ind assid status conf reach auth condition last_event cnt
===========================================================
1 31609 c02c yes no bad reject 2
2 31610 803a yes no none reject sys_peer 3
utils ntp auth auto-key
utils ntp auth auto-key {enable | disable | status }
このコマンドを使用して、選択した NTP サーバの認証を有効または無効にできます。認証はクライアント キーに基づいています。また、ntp サーバの認証ステータスを確認することもできます。
(注)
Unified Communication Manager でコモン クライテリア モードを有効にしている場合にのみ、NTP サーバで IFF ID スキームによる PKI ベースの認証を設定できます。
Unified Communications Manager で、対称キーまたは PKI ベースの NTP 認証を有効にできます。
PKI 対応サーバで対称キーを有効にしようとすると、次の警告メッセージが表示されます。
警告
Autokeyを使用したNTP認証が現在有効になっており、対称キーを有効にする前に無効にする必要があります。(NTP authentication using Autokey is currently enabled and must be disabled
before the symmetric key is enabled.)コマンド「utils ntp auth auto-key disable」を使用してNTP認証を無効にしてから、このコマンドを再試行してください。(Use the command
'utils ntp auth auto-key disable' to disable NTP authentication, then retry this command.)
対称キー対応サーバで Autokey を有効にしようとすると、次の警告メッセージが表示されます。
警告
対称キーを使用するNTP認証が現在有効になっており、Autokeyを有効にする前に無効にする必要があります。(NTP authentication using symmetric key is currently enabled and must
be disabled before Autokey is enabled.)コマンド「utils ntp auth symmetric-key disable」を使用してNTP認証を無効にしてから、このコマンドを再試行してください。(Use
the command 'utils ntp auth symmetric-key disable' to disable NTP authentication, then retry this command.)
(注)
NTP サーバには ntp バージョン 4 と rpm バージョン ntp-4.2.6p5-1.el6.x86_64.rpm 以上が必要です。
構文の説明
パラメータ
説明
enable
使用可能なサーバのリストから NTP サーバの 1 つを選択し、認証を有効にします。
disable
PKI 認証対応 NTP サーバのリストから NTP サーバの 1 つを選択し、認証を無効にします。
status
リストされているすべての NTP サーバの認証ステータスを表示します。
使用上のガイドライン
NTP 認証を有効にすると、NTP サーバの認証用の IFF クライアント キーを入力するように要求されます。クライアント キーが正常にアップロードされると、Unified Communications Manager のパブリッシャ ノードで
NTP サービスが再開されます。Unified Communications Manager と NTP サーバの間で認証が有効になっていることをポストします。
(注)
要件
コマンド特権レベル::レベル 1 はすべてのコマンドを実行でき、レベル 0 はステータス コマンドのみを実行できます。
アップグレード時の使用:不可
適用対象::Unified Communications Manager
admin:utils ntp auth auto-key enable:NTP 認証を有効にします
1: 10.78.83.146
2: 10.77.46.203
3: 10.77.32.92
Select the server for which auto-key based NTP authentication is to be enabled (Enter q to exit):2
Enter the IFF client key for the 10.77.46.203:
# ntpkey_iffpar_ccm203.3705887848
# Thu Jun 8 10:47:28 2017
-----BEGIN PRIVATE KEY-----
MIGzAgEAMIGoBgcqhkjOOAQBMIGcAkEA4r3EkDFdP05QSpzVpGHnZN3JgOkW0Ch9
erxLB7zSxrwNdnDIlWg5bUhZZWKZceQd/nyD6FLpZNFrpHnylkBUgQIVAJEjgjZM
r2aaMGSN5x2yUmhT4MqNAkBp2gkQNi8sluLre0YKyc+kdICiRkEK2jKwBETXs7Mh
aEd/c4DQnZkd5U9gco4v9zPpsfPOqftvymVyVmRyKX0NBAMCAQE=
-----END PRIVATE KEY-----
The Client key does not match the hostname of the selected NTP server. This could be because a DNS server is not configured or the DNS entry for this host is not present.
Please verify the client key uploaded corresponds to the selected NTP server and that the DNS configuration is correct.
Do you want to continue with this operation?<yes/no>:
Client key uploaded succesfully
Restarting NTP service.
Please run 'utils ntp auth auto-key status' to check the status of NTP authentication.
(注)
上記のユーザ警告プロンプトは、DNS サーバが選択された NTP サーバのホスト名を解決でき、提供されたクライアント キーのホスト名と一致する場合は表示されません。
1.10.78.83.146 : NTP Authentication is disabled.
2.10.77.46.203 : NTP Authentication is enabled.
3.10.77.32.92 : NTP Authentication is disabled.
Select the server for which auto-key based NTP authentication details is to be displayed (Enter q to exit):
2
NTP public certificate:
# ntpkey_RSA-SHA1cert_ccm-90.3708840303
# Wed Jul 12 14:55:03 2017
-----BEGIN CERTIFICATE-----
MIICwTCCAamgAwIBAgIFAN0QaW8wDQYJKoZIhvcNAQEFBQAwETEPMA0GA1UEAxMG
Y2NtLTkwMB4XDTE3MDcxMjA5MjUwM1oXDTE4MDcxMjA5MjUwM1owETEPMA0GA1UE
AxMGY2NtLTkwMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAv0no6hNu
C88VXyCkMCJ6w6hny7eG6JU8LzEjMIN5aqD0FDjnRzIKK/DL5DMReRy4j/4YQTR7
nT9ThudFwyUu0y86OpPWBgfKeII6kjtkElo4mp8RyMLJDp4e0jOh63wCP0cJsdZ1
dXfvx0/OjK6ZdX7OeHtcZn2ycLkSZP6hkos6Un//5zfu1IG47QEliIh3bpPWq647
JiHELeuigcNm2plLSorXgmA3LFBI99pamwFl9Lmqb49y0Ie/QchXhudOOsG0zuaL
PaEnkPdyNtxvQbCQ24cVBmHup7UBkdZYA+5unpbczMzzE3tQsl/CvizmUbfA+/gi
/DWSBC4Hfc011QIDAQABoyAwHjAPBgNVHRMBAf8EBTADAQH/MAsGA1UdDwQEAwIC
hDANBgkqhkiG9w0BAQUFAAOCAQEAttJbav0+qVPk9abAWlWcmhQUbjW58qrLE9A0
2ZvIvHKq2TyBAIxYcUSQQ3GXSwBDHKZUNSAzrFrTQ+vLFqFvoSH0o5EFruIdrwyn
zCD1OqNJXsCPsxyofSDuT/+pxvVxGXlcIpmDa2tieEUcdSvaGxol+ABhOO8YI6uf
bHNUCdjNSYbF6W0LMs643VSlNEUmBE4Tp+YWpLgbmXDXGa1wHlog5fZfnywk161J
n34asWwWmR467WADnPBfMJDWzU1GMceh1lXQ/gbYYX3+rpileAZF6x9Z/goexhNc
L4WyzBrlR7iueJ1wYdFZ5THXOat3bxWMWU4fDzqTWA7G9hpP6w==
-----END CERTIFICATE-----
Client Key:
# ntpkey_iffpar_ccm203.3705887848
# Thu Jun 8 10:47:28 2017
-----BEGIN PRIVATE KEY-----
MIGzAgEAMIGoBgcqhkjOOAQBMIGcAkEA4r3EkDFdP05QSpzVpGHnZN3JgOkW0Ch9
erxLB7zSxrwNdnDIlWg5bUhZZWKZceQd/nyD6FLpZNFrpHnylkBUgQIVAJEjgjZM
r2aaMGSN5x2yUmhT4MqNAkBp2gkQNi8sluLre0YKyc+kdICiRkEK2jKwBETXs7Mh
aEd/c4DQnZkd5U9gco4v9zPpsfPOqftvymVyVmRyKX0NBAMCAQE=
-----END PRIVATE KEY-----
admin:
The List of NTP servers Configured:
1. 10.77.46.203
Enter the NTP server in which the authentication needs to be disabled(Enter q to exit): 1
NTP authentication has been disabled on 10.77.46.203
Restarting NTP
admin:
utils ntp server add
このコマンドは、指定した NTP サーバを最大 5 台まで追加します。
utils ntp server add s1 [s1 | s2 | s3 | s4 | s5 ] [norestart ]
構文の説明
パラメータ
説明
s1...
NTP サーバを指定します。
norestart
サーバを追加した後に NTP サービスが再起動しないようにします。
使用上のガイドライン
norestart を使用した場合、変更を有効にするには NTP サービスを明示的に再起動する必要があります。
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager
例:誤ったコマンド ライン パラメータを使用してサーバを追加しようとした場合
admin: admin:utils ntp server add s1 s2 s3 s4 s5 s6 s7 s8
Incorrect number of parameters entered for add
usage: utils ntp server add s1 [s2 s3 s4 s5] [norestart]
admin: utils ntp server add s1 s2 s3 s4 s5 s6 s7 s8
Incorrect number of parameters entered for add
usage: utils ntp server add s1 [s2 s3 s4 s5] [norestart]
admin: utils ntp server add clock1.cisco.com clock2.cisco.com
clock1.cisco.com : added successfully.
clock2.cisco.com : added successfully.
Restarting NTP on the server.
admin: utils ntp server add clock1.cisco.com clock2.cisco.com
clock1.cisco.com : [The host has already been added as an NTP server.]
clock2.cisco.com : [The host has already been added as an NTP server.]
admin: utils ntp server add bglr-ccm26
bglr-ccm26 : [This server cannot be added as an NTP server.]
admin: utils ntp server add clock3.cisco.com
clock3.cisco.com : [ Inaccessible NTP server. Not added. ]
admin: utils ntp server add ntp01-syd.cisco.com ntp02-syd.cisco.com clock.cisco.com norestart
ntp01-syd.cisco.com : added successfully.
ntp02-syd.cisco.com : added successfully.
clock.cisco.com : added successfully.
The NTP service will need to be restarted for the changes to take effect.
admin:utils ntp server add clock3.cisco.com
The maximum permissible limit of 5 NTP servers is already configured.
utils ntp server delete
このコマンドは、設定されている NTP サーバを削除します。
使用上のガイドライン
このコマンドでは、設定されている Network Time Protocol(NTP)サーバまたは複数の NTP サーバを削除できます。削除するサーバを選択すると、NTP サービスを再開するかどうか指定するように求めるプロンプトが表示されます。no
を選択した場合、サーバが削除された後に NTP サービスは再起動しません。
(注)
少なくとも1つの NTP サーバが設定されている必要があります。したがって、NTP サーバが1つだけ設定されている場合は削除できません。すべての NTP サーバをすべて削除するオプションを選択した場合、NTP サーバは上から順に削除され、リストの最後の
NTP サーバは削除されません。このプロセスは、utils ntp config
または utils ntp status
の間のトップダウン方式の順序に似ています。
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager
例:誤ったコマンド ライン パラメータを使用したサーバの削除
admin: utils ntp server delete clock1.cisco.com clock2.cisco.com
Incorrect number of optional parameters entered for delete
usage: utils ntp server delete
admin: utils ntp server delete
1: clock1.cisco.com
2: clock2.cisco.com
3: ntp01-syd.cisco.com
4: ntp02-syd.cisco.com
5: clock.cisco.com
a: all
q: quit
Choice: 1
Restart NTP (y/n): y
clock1.cisco.com will be deleted from the list of configured NTP servers.
Continue (y/n)?y
clock1.cisco.com : deleted successfully.
Restarting NTP on the server.
admin: utils ntp server delete
1: clock1.cisco.com
2: clock2.cisco.com
3: ntp01-syd.cisco.com
4: ntp02-syd.cisco.com
5: clock.cisco.com
a: all
q: quit
Choice: a
Restart NTP (y/n): n
This will result in all the configured NTP servers being deleted.
Continue (y/n)?y
clock1.cisco.com : deleted successfully.
clock2.cisco.com : deleted successfully.
ntp01-syd.cisco.com : deleted successfully.
ntp02-syd.cisco.com : deleted successfully.
clock.cisco.com : [The NTP server was not deleted. At least one NTP server is required.]
The NTP service will need to be restarted for the changes to take effect.
admin: utils ntp server delete
There are no NTP servers configured to delete.
utils ntp config
このコマンドは、NTP クライアントおよびサーバの現在の設定を表示します。
(注)
発生する可能性のある互換性の問題、精度の問題、およびネットワーク ジッターの問題を回避するには、プライマリ ノードに指定する外部 NTP サーバが NTP v4(バージョン 4)である必要があります。
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サーバ、Cisco Unity Connection
utils ntp restart
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils ntp server list
このコマンドは、すべての NTP サーバをリスト表示します。
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager の IM and Presence サーバ
utils ntp start
このコマンドは、NTP サービスが実行中でない場合に、NTP サービスを開始します。
(注)
コマンドライン インターフェイスからは NTP サービスを停止できません。このコマンドは、utils ntp status コマンドで stopped が返される場合に使用します。
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サーバ、および Cisco Unity Connection
utils ntp status
このコマンドは、NTP の現在のステータスを表示します。
要件
コマンド特権レベル:
アップグレード時の使用:
適用対象:Unified Communications Manager の IM and Presence サービス。
utils os*
utils os kerneldump
このコマンドは、カーネル クラッシュ ダンピング メカニズムを提供するカーネルダンプを設定します。カーネルは、カーネル クラッシュが発生すると、ローカル ディスクにダンプをキャプチャします。
(注)
netdump コマンドはリリース 8.6(1) から削除され、kerneldump コマンドに置き換えられました。
utils os kerneldump {enable | disable }
使用上のガイドライン
カーネル クラッシュが発生すると、キャプチャ カーネルはサーバのローカル ディスクにコアをダンプします。プライマリ カーネルは、物理メモリに 128MB を予約します。これは、キャプチャ カーネルがブートに使用します。カーネル クラッシュが発生するごとに、カーネルダンプは
kexec コマンドを使用してキャプチャ カーネルを起動します。
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager および Cisco Unity Connection
例
admin: utils os kerneldump enable
***************WARNING*******************
Enabling kerneldump requires system reboot
Would you like to boot the machine (y/n):y
kerneldump enable operation succeeded
System going for a reboot
utils os kerneldump ssh
このコマンドは、外部 SSH サーバをイネーブルまたはディセーブルにします。また、外部 SSH サーバのステータスを表示します。
utils os kerneldump ssh {enable | disable | status }
構文の説明
パラメータ
説明
enable
外部 SSH サーバを、カーネルダンプ用のカーネルダンプ サーバに設定します。
disable
カーネルダンプを収集するように設定された外部 SSH サーバのサポートを削除します。
status
カーネルダンプを収集するために外部 SSH サーバが設定されているかどうかを示します。
使用上のガイドライン
外部 SSH サーバでカーネルダンプ サービスがイネーブルになっていて、カーネル クラッシュが発生した場合は、キャプチャ カーネルが、ダンプを収集するように設定された外部サーバにコアをダンプします。カーネルダンプをイネーブルまたはディセーブルにした場合は、変更を有効にするためにシステムをリブートする必要があります。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager および Cisco Unity Connection
例
admin: utils os kerneldump ssh disable 10.77.31.60
Disabling kerneldump requires system reboot
Would you like to continue (y/n): y
kerneldump disable operation succeeded
System going for a reboot
utils os kerneldump status
このコマンドは、kdump サービスのステータスを示します。
utils os kerneldump status
要件
コマンド特権レベル:0
アップグレード時の使用:不可
適用対象:Unified Communications Manager、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils os secure
このコマンドは、SELinux が提供するセキュリティ レベルを指定するために使用します。
utils os secure {enforce | permissive | status }
構文の説明
パラメータ
説明
enforce
permissive
status
使用上のガイドライン
SELinux がレート制限を処理しないことに注意してください。レート制限は ipprefs および IP テーブルによって処理されます。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager の IM and Presence サービス
utils os secure dynamic-policies*
utils os secure dynamic-policies compile
このコマンドは、ダイナミック ポリシー下で記録された拒否を解決する、SELinux ポリシー モジュールとタイプ強制を生成します。
utils os secure dynamic-policies compile policy name
構文の説明
パラメータ
説明
policy name
SELinux ポリシー モジュールおよびタイプ強制のコンパイルが行われるダイナミック ポリシー名を入力します。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager、Unified Communications Manager の IM and Presence サービス
utils os secure dynamic-policies list
このコマンドは、すべてのオペレーティング システムのダイナミック ポリシーとそのステータスのリストを表示します。
utils os secure dynamic-policies list
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager、Unified Communications Manager の IM and Presence サービス
utils os secure dynamic-policies load
このコマンドは、ダイナミック ポリシーの SELinux ポリシー モジュールを SELinux にロードします。このコマンドは、新規ルールを SELinux に適用して、ダイナミック ポリシー下で記録された拒否が再発しないようにします。
utils os secure dynamic-policies load policy name
構文の説明
パラメータ
説明
policy name
SELinux ポリシー モジュールを生成したダイナミック ポリシー名を入力します。これは、SELinux にロードされません。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager、Unified Communications Manager の IM and Presence サービス
utils os secure dynamic-policies remove
このコマンドは、オペレーティング システムからダイナミック ポリシーのすべてのデータを削除します。これには、SELinux からのポリシー モジュールのアンロード、および生成されたポリシー モジュール、タイプ強制、記録された拒否、およびデルタ
ログの削除が含まれます。
utils os secure dynamic-policies remove policy name
構文の説明
パラメータ
説明
policy name
必要でない、または不要になったダイナミック ポリシー名を入力します。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager、Unified Communications Manager の IM and Presence サービス
utils os secure dynamic-policies show
このコマンドは、生成されたダイナミック ポリシーの SELinux ポリシー モジュールをロードすることで導入するルールを表示します。このコマンドは、ロードされるルールが安全であることを確認するため、コンパイルが成功した後で実行します。
utils os secure dynamic-policies show policy name
構文の説明
パラメータ
説明
policy name
ルールを表示するダイナミック ポリシー名を入力します。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager、Unified Communications Manager の IM and Presence サービス
utils os secure dynamic-policies start-recording
このコマンドは、SELinux の拒否の記録を開始し、これらを新しいダイナミック ポリシー下に分類します。
(注)
utils os secure dynamic-policies start-recording policy name
構文の説明
パラメータ
説明
policy name
SELinux の拒否と将来のポリシー データが分類されるダイナミック ポリシー名を入力します。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager、Unified Communications Manager の IM and Presence サービス
utils os secure dynamic-policies stop-recording
このコマンドは、ダイナミック ポリシーの SELinux の拒否の記録を停止します。このコマンドは、システムを元の強制モード(permissive モードまたは enforcing モード)に戻します。このログは、記録の開始から終了までの間に発生したすべての
SELinux の拒否のデルタ ログを生成します。
(注)
デルタ ログに新しい拒否がない場合、このコマンドは失敗します。その後、ダイナミック ポリシーが消去され、このコマンドを再度使用する必要があります。
utils os secure dynamic-policies stop-recording policy name
構文の説明
パラメータ
説明
policy name
記録を停止するダイナミック ポリシー名を入力します。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager、Unified Communications Manager の IM and Presence サービス
utils PlatformWebAccess*
utils PlatformWebAccess disable
このコマンドは、SSO が有効なときに、Cisco OS 管理アプリケーションおよびディザスタ リカバリ システム アプリケーションへのユーザのサインインを制限するために使用します。
utils PlatformWebAccess disable
要件
コマンド特権レベル:4
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection。
utils PlatformWebAccess enable
このコマンドは、Cisco OS 管理アプリケーションおよびディザスタ リカバリ システム アプリケーションへのユーザのサインインを有効にするために使用します。
utils PlatformWebAccess enable
要件
コマンド特権レベル:4
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection。
utils PlatformWebAccess status
このコマンドは、システムの Web アクセスのステータス(Cisco OS 管理アプリケーションおよびディザスタ リカバリ システム アプリケーションでプラットフォーム Web アクセスが有効または無効のいずれになっているか)を表示するために使用します。
utils PlatformWebAccess status
要件
コマンド特権レベル:4
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection。
utils processCoreDumps*
utils processCoreDumps disable
このコマンドは、プロセス コア ダンプを無効にします。
utils processCoreDumps disable
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils processCoreDumps enable
このコマンドは、プロセス コア ダンプを有効にします。
utils processCoreDumps enable
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils processCoreDumps status
このコマンドは、kdump サービスのステータスを示します。
utils processCoreDumps status
要件
コマンド特権レベル:0
アップグレード時の使用:不可
適用対象:Unified Communications Manager、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils remote_account*
utils remote_account create
このコマンドは、リモート アカウントを作成します。
utils remote_account create
使用上のガイドライン
リモート アカウントは、パス フレーズを生成します。シスコのサポート担当者はこれを使用することにより、アカウントの指定有効期間の間、システムにアクセスできます。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils remote_account disable
このコマンドは、リモート アカウントをディセーブルにすることができます。
utils remote_account disable
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils remote_account enable
このコマンドは、リモート アカウントをイネーブルにすることができます。
utils remote_account enable
使用上のガイドライン
同時に有効にできるリモート アカウントは 1 つだけです。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils remote_account status
このコマンドは、リモート アカウントのステータスを確認することができます。
utils remote_account status
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils remotesyslog set protocol*
utils remotesyslog set protocol tcp
このコマンドは、システムで、リモート syslog サーバとの通信用のプロトコルを TCP に設定します。ノードを再起動して、変更を有効にします。
utils remotesyslog set protocol tcp
要件
コマンド特権レベル:4
アップグレード時の使用:不可
適用対象:Unified Communications Manager、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils remotesyslog set protocol udp
このコマンドは、システムで、リモート syslog サーバとの通信用のプロトコルを UDP に設定します。ノードを再起動して、変更を有効にします。
utils remotesyslog set protocol udp
要件
コマンド特権レベル:4
アップグレード時の使用:不可
適用対象:Unified Communications Manager、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils remotesyslog set protocol tls
このコマンドは、システムで、リモート syslog サーバとの通信用のプロトコルを Transport Layer Security(TLS)1.2 に設定します。TLS 1.2 を使用すると、Unified Communications Manager
および IM and Presence サービスが、syslog サーバとのセキュアな接続を確立できるようになります。これにより、Unified Communications Manager と IM and Presence サービスがコモン
クライテリアのガイドラインに準拠できます。
(注)
ノードを再起動して、変更を有効にします。
utils remotesyslog set protocol tls
要件
コマンド特権レベル:4
アップグレード時の使用:不可
適用対象:Unified Communications Manager、Unified Communications Manager の IM and Presence サービス
セキュリティ証明書を、syslog サーバから Unified Communications Manager および IM and Presence サービス上の tomcat 信頼ストアにアップロードする必要があります。
utils remotesyslog show protocol
このコマンドは、システムでのリモート syslog サーバとの通信用のプロトコルが TCP または UDP のいずれであるかを表示します。
utils remotesyslog show protocol
要件
コマンド特権レベル:0
アップグレード時の使用:不可
適用対象:Unified Communications Manager、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils reset_application_ui_administrator_name
このコマンドは、アプリケーション ユーザ インターフェイスの管理者名をリセットします。
utils reset_application_ui_administrator_name
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils reset_application_ui_administrator_password
このコマンドは、アプリケーション ユーザ インターフェイスの管理者パスワードをリセットします。
(注)
IM and Presence ノードのパスワードを変更する場合は、管理者パスワードをリセットする前に、すべての IM and Presence ノードの Cisco Presence Engine サービスを停止します。パスワードをリセットした後に、すべてのノードの
Cisco Presence Engine サービスを再起動します。PE が停止されるとプレゼンスの問題が発生する可能性があるため、このタスクはメンテナンス中に実行してください。
utils reset_application_ui_administrator_password
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils restore_application_ui_administrator_account
このコマンドは、アプリケーション ユーザ インターフェイスの管理者アカウントを復元します。
utils restore_application_ui_administrator_account
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils rosters*
utils rosters list limited
データベース パブリッシャ ノードでこのコマンドを実行すると、無効なウォッチャと無効な連絡先の数を取得できます。合計数は CLI に表示されます。
使用上のガイドライン
このコマンドはメンテナンス期間中にのみ実行することを推奨します。このコマンドでは数だけが表示され、無効なレコードの詳細は表示されません。無効なレコードの詳細については、utils rosters list [ watchers | contacts | full を試行してください。
要件
コマンド特権レベル:4
アップグレード時の使用:不可
適用対象:IM and Presence サービス
utils rosters list full
データベース パブリッシャ ノードでこのコマンドを実行すると、すべての無効なウォッチャおよび無効な連絡先の詳細をファイルに書き込むことができます。また、CLI に合計数が表示されます。
使用上のガイドライン
このコマンドはメンテナンス期間中にのみ実行することを推奨します。
要件
コマンド特権レベル:4
アップグレード時の使用:不可
適用対象:IM and Presence サービス
utils rosters list watchers
データベース パブリッシャ ノードでこのコマンドを実行すると、クラスタ内のすべての無効なウォッチャの詳細をファイルに書き込むことができます。無効な連絡先の合計数も CLI に表示されます。
使用上のガイドライン
このコマンドはメンテナンス期間中にのみ実行することを推奨します。実行中は、進行状況が CLI およびログ ファイルに表示されます。
要件
コマンド特権レベル:4
アップグレード時の使用:不可
適用対象:IM and Presence サービス
utils rosters list contacts
データベース パブリッシャ ノードでこのコマンドを実行すると、クラスタ内のすべての無効な連絡先の詳細をファイルに書き込むことができます。無効な連絡先の合計数も CLI に表示されます。
使用上のガイドライン
このコマンドはメンテナンス期間中にのみ実行することを推奨します。
要件
コマンド特権レベル:4
アップグレード時の使用:不可
適用対象:IM and Presence サービス
utils rosters delete
このコマンドをデータベース パブリッシャ ノードで実行すると、IM and Presence クラスタ内の無効なウォッチャおよび無効な連絡先をすべて削除できます。
使用上のガイドライン
このコマンドはメンテナンス期間中にのみ実行することを推奨します。実行中は、進行状況が CLI およびログ ファイルに表示されます。
要件
コマンド特権レベル:4
アップグレード時の使用:不可
適用対象:IM and Presence サービス
utils scheduled-task*
utils scheduled-task disable
このコマンドは、スケジュールされたタスクを無効にします。
utils scheduled-task disable scheduled-task
構文の説明
パラメータ
説明
scheduled-task
無効にする必要があるタスクの名前を入力します。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils scheduled-task enable
このコマンドは、スケジュールされたタスクを有効にします。
utils scheduled-task enable scheduled-task
構文の説明
パラメータ
説明
scheduled-task
有効にする必要があるタスクの名前を入力します。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils scheduled-task list
このコマンドは、スケジュールされたすべてのタスクを一覧表示します。
utils scheduled-task list
要件
コマンド特権レベル:0
アップグレード時の使用:不可
適用対象:Unified Communications Manager、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils set urlpattern*
utils set urlpattern disable
このコマンドは、URL パターンを無効にして、zzz20_product_profile.sh ファイルを変更します。URL パターンを無効化した後、このコマンドは次の行を追加します。
export TOMCAT_EXCLUDE_URLPATTERNS="/ucmuser"
utils set urlpattern disable
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils set urlpattern enable
このコマンドは、URL パターンを有効にして、zzz20_product_profile.sh ファイルを変更します。URL パターンを有効化した後、このコマンドは次の行を追加します。
export TOMCAT_EXCLUDE_URLPATTERNS=""
utils set urlpattern enable
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils service*
utils service
このコマンドは、サービスをアクティブ化、非アクティブ化、開始、停止、または再起動します。
utils service {activate | deactivate | start | stop | restart } service_name
構文の説明
パラメータ
説明
service_name
対象にするサービスの名前を表します。以下に例を示します。
この一覧はすべてを網羅しているわけではありません。ノードのすべてのサービスをリストするには、utils service list コマンドを入力します。
(注)
スタンドアロン Cisco Prime License Manager の Cisco Tomcat サービスを再起動するには、utils service restart Cisco Prime LM Server コマンドを実行するか、サーバを再起動します。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils service list
このコマンドは、すべてのサービスのリストを取得します。
utils service list [page ]
構文の説明
パラメータ
説明
[page ]
出力を一度に 1 ページずつ表示します。
要件
コマンド特権レベル:0
アップグレード時の使用:不可
適用対象:Unified Communications Manager の IM and Presence サービス
utils service auto-restart
このコマンドは、指定したサービスを開始または停止します。
utils service auto-restart {enable | disable | show } service-name
構文の説明
パラメータ
説明
enable
自動再起動を開始します。
disable
自動再起動を停止します。
show
サービスのステータスを表示します。
service-name
開始、停止、または表示するサービスの名前を表します。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection
utils service start
構文の説明
パラメータ
説明
service
サービスの名前を入力します。これは、複数の単語を組み合わせることができます。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection。
utils service stop
構文の説明
パラメータ
説明
service
サービスの名前を入力します。これは、複数の単語を組み合わせることができます。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、および Cisco Unity Connection。
utils snmp*
utils snmp config 1/2c community-string
このインタラクティブ コマンドは、コミュニティ ストリングを追加、削除、リスト表示または更新します。
utils snmp config 1/2c community-string {add | | delete | | list | | update }
構文の説明
パラメータ
説明
add
新しいコミュニティ ストリングを追加します。
delete
コミュニティ ストリングを削除します。
list
すべてのコミュニティ ストリングをリスト表示します。
update
コミュニティ ストリングを更新します。
使用上のガイドライン
システムによりパラメータの入力が求められます。
設定の変更を有効にするために、SNMP Master Agent サービスが再起動されます。コマンドの実行後は、再起動が完了するまで中止しないでください。サービスの再起動中にコマンドを中止した場合は、utils service list
を使用して「SNMP Master Agent」のサービス ステータスを確認します。サービスがダウンしている場合は、utils service start SNMP Master Agent
を使用してサービスを開始します。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils snmp config 1/2c inform
このインタラクティブ コマンドは、インフォーム通知の宛先を追加、削除、リスト表示または更新します。
utils snmp config 1/2c inform {add | | delete | | list | | update }
構文の説明
パラメータ
説明
add
通知の宛先を追加します。
delete
通知の宛先を削除します。
list
通知の宛先をすべてリスト表示します。
update
通知の宛先を更新します。
要件
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils snmp config 1/2c trap
このインタラクティブ コマンドは、トラップ通知に影響を与えます。
utils snmp config 1/2c trap {add | delete | list | update }
構文の説明
パラメータ
説明
add
設定された v1/2c のコミュニティ ストリングに関連付けられた新しい v1/2c トラップ通知の宛先を追加します。
delete
既存の v1/2c トラップ通知の宛先の設定情報を削除します。
list
現在設定されている v1/2c トラップ通知をリスト表示します。
update
既存の v1/2c トラップ通知の宛先の設定情報を更新します。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager および Cisco Unity Connection
utils snmp config 3 inform
このインタラクティブ コマンドは、v3 インフォーム通知に影響を与えます。
utils snmp config 3 inform {add | | delete | | list | | update }
構文の説明
パラメータ
説明
add
設定された v3 ユーザ名に関連付けられた新しい v3 インフォーム通知の宛先を追加します。
delete
既存の v3 インフォーム通知の宛先の設定情報を削除します。
list
現在設定されている v3 インフォーム通知をリスト表示します。
update
既存の v3 インフォーム通知の宛先の設定情報を更新します。
使用上のガイドライン
システムによりパラメータの入力が求められます。
設定の変更を有効にするために、SNMP Master Agent サービスが再起動されます。コマンドの実行後は、再起動が完了するまで中止しないでください。サービスの再起動中にコマンドを中止した場合は、utils service list
を使用して「SNMP Master Agent」のサービス ステータスを確認します。サービスがダウンしている場合は、utils service start SNMP Master Agent
を使用してサービスを開始します。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils snmp config mib2
このインタラクティブ コマンドは、Mib2 設定情報に影響を与えます。
utils snmp config mib2 {add | | delete | | list | | update }
構文の説明
パラメータ
説明
add
Mib2 設定情報を追加します。
delete
Mib2 設定情報を削除します。
list
Mib2 設定情報をリスト表示します。
update
Mib2 設定情報を更新します。
使用上のガイドライン
システムによりパラメータの入力が求められます。
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils snmp config 3 trap
このインタラクティブ コマンドは、トラップ通知に影響を与えます。
utils snmp config 3 trap {add | | delete | | list | | update }
構文の説明
パラメータ
説明
add
設定された v3 ユーザ名に関連付けられた新しい v3 トラップ通知の宛先を追加します。
delete
既存の v 3 トラップ通知の宛先の設定情報を削除します。
list
現在設定されている v3 トラップ通知をリスト表示します。
update
既存の v3 トラップ通知の宛先の設定情報を更新します。
使用上のガイドライン
システムによりパラメータの入力が求められます。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils snmp config 3 user
このインタラクティブ コマンドは、v3 ユーザ設定に影響を与えます。
utils snmp config 3 user {add | | delete | | list | | update }
構文の説明
パラメータ
説明
add
v3 認証とプライバシー パスワードを使用して新しい v3 ユーザを追加します。
delete
既存の v3 ユーザの設定情報を削除します。
list
現在設定されている v3 ユーザをリスト表示します。
update
既存の v3 ユーザの設定情報を更新します。
使用上のガイドライン
システムによりパラメータの入力が求められます。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils snmp get
このインタラクティブ コマンドは、指定した MIB OID の指定したバージョンを使用して SNMP データを取得します。
構文の説明
パラメータ
説明
version
SNMP バージョンを指定します。指定できる値は、1、2c または 3 です。
community
SNMP コミュニティ ストリングを指定します。
ip-address
サーバの IPv4 または IPv6 アドレスを指定します。ローカル ホストを指定する場合は、127.0.0.0 を入力します。クラスタ内の別のノードの IPv4/IPv6 アドレスを入力し、そのノード上でコマンドを実行できます。
object
取得する SNMP オブジェクト ID(OID)を指定します。
file
コマンド出力を保存するファイルを指定します。
使用上のガイドライン
MIB 内の特定の OID(リーフ)に対してこのコマンドを実行した場合、その MIB の値が得られます。たとえば、システム稼働時間を取得する場合は、iso.3.6.1.2.1.25.1.1.0 = Timeticks: (19836825) 2 days, 7:06:08.25
となります。
リモート ホストの IPv4/IPv6 アドレス を指定すると、コマンドはリモート ホストで実行されます。
IPv4/IPv6 アドレス は必須です。ドメイン名は使用できません。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils snmp get 1
このコマンドは、指定した MIB OID のバージョン 1 を使用して、SNMP データを取得します。
構文の説明
パラメータ
説明
version
SNMP バージョンを指定します。指定できる値は、1、2c または 3 です。
community
SNMP コミュニティ ストリングを指定します。
ip-address
サーバの IPv4 または IPv6 アドレスを指定します。ローカル ホストを指定する場合は、127.0.0.0 を入力します。クラスタ内の別のノードの IPv4/IPv6 アドレスを入力し、そのノード上でコマンドを実行できます。
object
取得する SNMP オブジェクト ID(OID)を指定します。
file
コマンド出力を保存するファイルを指定します。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils snmp get 2c
このコマンドは、指定した MIB OID のバージョン 2c を使用して、SNMP データを取得します。
utils snmp get 2c version
構文の説明
パラメータ
説明
version
SNMP バージョンを指定します。指定できる値は、1、2c または 3 です。
community
SNMP コミュニティ ストリングを指定します。
ip-address
サーバの IPv4 または IPv6 アドレスを指定します。ローカル ホストを指定する場合は、127.0.0.0 を入力します。クラスタ内の別のノードの IPv4/IPv6 アドレスを入力し、そのノード上でコマンドを実行できます。
object
取得する SNMP オブジェクト ID(OID)を指定します。
file
コマンド出力を保存するファイルを指定します。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils snmp get 3
このコマンドは、指定した MIB OID の SNMP データを取得します。
構文の説明
パラメータ
説明
version
SNMP バージョンを指定します。指定できる値は、1、2c または 3 です。
community
SNMP コミュニティ ストリングを指定します。
ip-address
サーバの IPv4 または IPv6 アドレスを指定します。ローカル ホストを指定する場合は、127.0.0.0 を入力します。クラスタ内の別のノードの IPv4/IPv6 アドレスを入力し、そのノード上でコマンドを実行できます。
object
取得する SNMP オブジェクト ID(OID)を指定します。
file
コマンド出力を保存するファイルを指定します。
要件
コマンド特権レベル:1
アップグレード時の使用:不可
適用対象:Unified Communications Manager、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils snmp hardware-agents
このコマンドは、サーバ上の SNMP エージェントに影響を与えます。
utils snmp hardware-agents {status | | start | | stop | | restart }
構文の説明
パラメータ
説明
status
ハードウェア ベンダーによって提供されている SNMP エージェントのステータスを表示します。
(注)
このコマンドでは、ステータスを示すエージェントだけが表示されます。すべてのハードウェア エージェントがステータスを示すわけではありません。
stop
ハードウェア ベンダーによって提供されているすべての SNMP エージェントを停止します。
restart
ハードウェア ベンダーによって提供されているすべての SNMP エージェントを再起動します。
start
ハードウェア ベンダーによって提供されているすべての SNMP エージェントを開始します。
要件
コマンド特権レベル:0
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils snmp test
このコマンドは、ローカル syslog、リモート syslog にサンプル アラームを送信します。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
例
admin: admin:utils snmp test
Service Manager is running
Test SNMP Trap starts with Local Host Name, Specify a Remote Sever Name to test Remote Syslog
TestAlarmInformational sent [Returncode=0]
TestAlarmEmergency sent [Returncode=0]
TestAlarmAlert sent [returncode=0]
TestAlarmCritical sent [Returncode=0]
TestAlarmDebug sent [Returncode=0]
TestAlarmNotice sent [Returncode=0]
TestAlarmWarning sent [Returncode=0]
TestAlarmError sent [Returncode=0]
TestAlarmWindows sent [Returncode=0]
Message from syslogd@ipcbu-plat44 at Sat Jul 17 03:56:11 2010 ...
ipcbu-plat44 local7 0 : 1: ipcbu-plat44.blr.eng: Jul 16 2010 22:26:11.53 UTC :
%UC_-0-TestAlarmEmergency: %[AppID=Cisco CallManager][ClusterID=][NodeID=ipcbu-plat44]:
Testing EMERGENCY_ALARM
utils snmp walk
このインタラクティブ コマンドは、指定したバージョンを使用して SNMP MIB をウォークし、指定した OID で開始します。
構文の説明
パラメータ
説明
version
SNMP バージョンを指定します。指定できる値は、1、2c または 3 です。
community
SNMP コミュニティ ストリングを指定します。
ip-address
サーバの IPv4 または IPv6 アドレスを指定します。ローカル ホストを指定する場合は、127.0.0.0 を入力します。クラスタ内の別のノードの IPv4/IPv6 アドレスを入力し、そのノード上でコマンドを実行できます。
object
ウォークする SNMP オブジェクト ID(OID)を指定します
file
コマンド出力を保存するファイルを指定します。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager 、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
例
MIB のリーフに対して snmp walk
を実行すると、基本的に「utils snmp get ...
」コマンドで得られるのと同じ内容が得られます。例では、ここでシステム稼働時間を取得しています。 iso.3.6.1.2.1.1.1.0 = STRING: "Hardware:7825H, 1 Intel(R) Pentium(R) 4 CPU 3.40GHz, 2048 MB Memory: Software:UCOS 2.0.1.0-62"
iso.3.6.1.2.1.1.2.0 = OID: iso.3.6.1.4.1.9.1.583
iso.3.6.1.2.1.1.3.0 = Timeticks: (15878339) 1 day, 20:06:23.39
iso.3.6.1.2.1.1.4.0 = ""
iso.3.6.1.2.1.1.5.0 = STRING: "bldr-ccm34.cisco.com"
iso.3.6.1.2.1.1.6.0 = ""
iso.3.6.1.2.1.1.7.0 = INTEGER: 72
iso.3.6.1.2.1.2.1.0 = INTEGER: 3
iso.3.6.1.2.1.2.2.1.1.1 = INTEGER: 1
iso.3.6.1.2.1.2.2.1.1.2 = INTEGER: 2
iso.3.6.1.2.1.2.2.1.1.3 = INTEGER: 3
iso.3.6.1.2.1.2.2.1.2.1 = STRING: "lo"
Press <enter> for 1 line, <space> for one page, or <q> to quit
utils snmp walk 1
このインタラクティブ コマンドは、指定した OID から、SNMP バージョン 1 を使用して SNMP MIB をウォークします。
utils snmp walk 1 version
構文の説明
パラメータ
説明
version
SNMP バージョンを指定します。指定できる値は、1、2c または 3 です。
community
SNMP コミュニティ ストリングを指定します。
ip-address
サーバの IPv4 または IPv6 アドレスを指定します。ローカル ホストを指定する場合は、127.0.0.0 を入力します。クラスタ内の別のノードの IPv4/IPv6 アドレスを入力し、そのノード上でコマンドを実行できます。
object
ウォークする SNMP オブジェクト ID(OID)を指定します
file
コマンド出力を保存するファイルを指定します。
要件
コマンド特権レベル:1
アップグレード時の使用:可能
適用対象:Unified Communications Manager、Unified Communications Manager の IM and Presence サービス、Cisco Unity Connection
utils snmp walk 2c
このインタラクティブ コマンドは、指定した OID から、SNMP バージョン 2c を使用して SNMP MIB をウォークします。
utils snmp walk 2c version
構文の説明
パラメータ
説明
version
SNMP バージョンを指定します。指定できる値は、1、2c または 3 です。
community
SNMP コミュニティ ストリングを指定します。
ip-address
サーバの IPv4 または IPv6 アドレスを指定します。ローカル ホストを指定する場合は、127.0.0.0 を入力します。クラスタ内の別のノードの IPv4/IPv6 アドレスを入力し、そのノード上でコマンドを実行できます。
object
ウォークする SNMP オブジェクト ID(OID)を指定します
file