Cisco Unified Communications ソリューションのコマンドラインインターフェイスリファレンスガイド、リリース 12.5(1)

utils auditd

このコマンドは、システム監査サービスを開始、停止し、そのステータスを提供します。

utils auditd {有効化 | 無効化 | ステータス}

構文の説明


パラメータ	説明
有効化	監査ログの収集を有効にします。有効にすると、システムはユーザーのアクションおよび Linux イベント（ユーザーの作成と削除、ファイルの編集と削除）を監視および記録します。
無効にする	監査ログの収集を無効にします。
ステータス	監査ログ収集のステータスを表示します。監査ログは、リアルタイム監視ツールを使用して取得することをお勧めしますが、CLI を使用して取得することもできます。

コマンドモード

管理者 (admin:)

使用上のガイドライン

サービスが有効になると、システム上のアクティビティが監視され、ログに記録されます。システム監査サービスでは大量の情報が記録されることに注意してください。ディスクをいっぱいにしないように注意する必要があります。

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection。

utils BE6000Mode enable

このコマンドを実行して、Unified Communications Manager で BE6000 モードを有効にします。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 4

アップグレード中の可能: なし

適用対象: Unified Communications Manager

utils BE6000Mode disable

このコマンドを実行して、Unified Communications Manager で BE6000 モードを無効にします。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 4

アップグレード中の可能: なし

適用対象: Unified Communications Manager

utils BE6000Mode status

このコマンドを実行して、Unified Communications Manager 上の BE6000 モードのステータスを確認します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中の可能: なし

適用対象: Unified Communications Manager

utils branding enable

このノードでブランド化を有効にするには、このコマンドを実行します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 4

適用対象: Cisco Unified Communications Manager、IM and Presence Service、または Cisco Unity Connection。

utils branding disable

このノードのブランドを無効にするには、このコマンドを実行します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 4

適用対象: Unified Communications Manager、IM and Presence Service、または Cisco Unity Connection。

utils branding status

このコマンドを実行すると、このノードでブランド化が有効になっているか無効になっているかのステータスを確認できます。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 4

適用対象: Unified Communications Manager、IM and Presence Service、または Cisco Unity Connection。

utils contactsearchauthentication disable

このコマンドは、安全な連絡先検索認証モードを無効にします。このモードを無効にした後、変更を有効にするには電話機をリセットする必要があります。

utils contactsearchauthentication disable

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 4

アップグレード中の可能: なし

Unified Communications Manager、Unified Communications Manager の IM and Presence Service、Cisco Unity Connection

utils contactsearchauthentication enable

このコマンドは、安全な連絡先検索認証モードを有効にします。このモードを有効にした後、変更を有効にするには電話機をリセットしてください。

utils contactsearchauthentication enable

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 4

アップグレード中の可能: なし

Unified Communications Manager、Unified Communications Manager 上の IM およびプレゼンスサービス、Cisco Unity Connection

utils contactsearchauthentication status

このコマンドは、システムが連絡先検索認証有効モードで動作しているか、連絡先検索認証無効モードで動作しているかを表示します。

utils contactsearchauthentication ステータス

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中に許可: はい

Unified Communications Manager、Unified Communications Manager 上の IM およびプレゼンスサービス、Cisco Unity Connection

utils core analyze

このコマンドは、コアファイル、スレッドリスト、およびすべての CPU レジスタの現在の値のバックトレースを生成します。

utils core {アクティブ | 非アクティブ} 分析する [core_filename]

構文の説明


パラメータ	説明
アクティブ	アクティブなバージョンを指定します
非アクティブ	非アクティブなバージョンを指定します
`コアファイル名`	スタックトレースを生成するコアファイルの名前を指定します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

このコマンドは、コアファイルと同じディレクトリに、.txt 拡張子を持つファイルをコアファイルと同じ名前で作成します。 Cimserver によって作成されたコアファイルに対してこのコマンドを実行すると、予期しないメッセージが表示されます。このメッセージはコマンドの既知の制限です。

要件

コマンド権限レベル: 1

アップグレード中の許可: はい

適用対象: Unified Communications Manager、 IM およびプレゼンスサービス Unified Communications Manager、および Cisco Unity Connection。

utils core list

このコマンドは、アクティブまたは非アクティブなコアファイルをすべて表示します。

utils core {アクティブ | 非アクティブ} リスト

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection。

utils capf cert import

utils capf 証明書のインポート

このコマンドを使用して、署名された電話証明書をシステムにアップロードします。

使用上のガイドライン

署名された証明書を FTP または TFTP 経由でインポートすることを選択できます。

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager

utils capf set keep_alive

このコマンドを実行して、証明機関プロキシ機能 (CAPF) サービスとエンドポイント間のすべての接続の keep_alive タイマーを設定します。システムのデフォルトは 15 分です。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中の可能: なし

適用対象: Unified Communications Manager

utils capf stale-lsc

utils capf stale-lsc {delete | list}

このコマンドは、システムの古い LSC 証明書を管理するのに役立ちます。

構文の説明


パラメータ	説明
消去	システムから古い LSC 証明書をすべて削除します。
list	システム上の古い LSC 証明書をすべて一覧表示します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中の可能: なし

適用対象: Unified Communications Manager

utils create report

このコマンドは、platform/log ディレクトリにサーバに関するレポートを作成します。

utils create report {ハードウェア | プラットフォーム | セキュリティ}

構文の説明


パラメータ	説明
ハードウェア	ディスクアレイ、リモートコンソール、診断、環境データを含むシステムレポートを作成します。
プラットフォーム	プラットフォーム構成ファイルを TAR ファイルに収集します。
セキュリティ	診断レポートを収集し、トラブルシューティングのためにダウンロードできる TAR ファイルを作成します。このファイルは、 file get コマンドで取得できます。

コマンドモード

管理者 (admin:)

使用上のガイドライン

コマンドを入力すると、続行するように求められます。

レポートを作成した後、file get activelog platform/log/filename コマンドを使用してレポートを取得します。ここで、filename は、コマンドの完了後に表示されるレポートファイル名を指定します。

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、Unified Communications Manager 上の IM およびプレゼンスサービス、および Cisco Unity Connection。

utils create report database

このコマンドは、データベースのトラブルシューティングに必要なすべてのログファイルを収集します。

utils create report {ハードウェア | プラットフォーム | セキュリティ}

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、Unified Communications Manager の IM およびプレゼンスサービス、Cisco Unity Connection

utils ctl

utils ctl {set-cluster mixed-mode | set-cluster non-secure-mode | update CTLFile}

このコマンドは、クラスターのセキュリティモードを変更したり、各ノードの CTL ファイルを更新したりします。

構文の説明

パラメータ

説明

set-cluster 混合モード

CTL ファイルを更新し、クラスターを混合モードに設定します (db セキュアモードは 1 に設定されます)。

クラスタがすでに混合モードになっている場合、このコマンドは、Unified Communications Manager が混合モードになっていて、自動登録がアクティブになっていることを示します。アクションを確認する必要があります。

（注）

混合モードを有効にするには、Communications Manager が Cisco Smart Software Manager または Cisco Smart Software Manager サテライトに登録されていること、およびスマートアカウントまたはバーチャルアカウントから受信した登録トークンで [輸出規制による機能限定の許可（Allow export-controlled functionality）] が有効になっており、そのトークンがこのクラスタに登録されていることを確認します。

set-cluster non-secure-mode

CTL ファイルを更新し、クラスタをノンセキュアモードに設定します。

クラスターがすでに混合モードになっている場合、このコマンドは、Unified Communications Manager が非セキュアモードであることを示します。

CTLFile を更新

クラスターの各ノードの CTL ファイルを更新します。

（注）

CTLFIle を混合モードで更新するには、Unified Communications Manager が Cisco Smart Software Manager または Cisco Smart Software Manager サテライトに登録されていること、およびスマートアカウントまたはバーチャルアカウントから受信した登録トークンで [輸出規制による機能限定の許可（Allow export-controlled functionality）] が有効になっており、そのトークンがこのクラスタに登録されていることを確認します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

CLI はパブリッシャー上で実行する必要があります。他のすべてのノードでは、この CLI コマンドは無効になっています。

（注）

CTL ファイルの更新を有効にするには、暗号化および認証されたすべての電話機をリセットしてください。

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用対象: Unified Communications Manager。

utils ctl reset localkey

このコマンドは、CTL ファイルを再生成し、セカンダリ SAST ロール (CallManager) で署名するために使用されます。元の CTL ファイルの署名に使用された ITLRecovery 証明書が変更され、エンドポイントがロックアウトされている場合は、このコマンドを使用します。

utils ctl reset {ローカルキー}

構文の説明


ローカルキー	新しい CTL ファイルを生成し、パブリッシャー上の CTL ファイルを更新します。このコマンドは、CallManager キーを使用して CTL ファイルに署名します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

（注）

このコマンドは、 Unified Communications Manager パブリッシャーノードで実行する必要があります。
エンドポイントが、CallManager キーによって署名され、新しい ITLRecovery 証明書を含む新しい CTL ファイルを受け取ったら、CTL 更新コマンド (utils ctl update CTLFile) を再度実行して、ITLRecovery 証明書で署名します。 CTL ファイルは再生成されますが、エンドポイントによって信頼される新しい ITLRecovery 証明書によって署名されます。

要件

コマンド権限レベル: 4

アップグレード中の可能: なし

適用対象: Unified Communications Manager

utils cuc activate CUSRSV

このコマンドは、スタンドアロンの Cisco Unity Connection サーバを Cisco Unity Connection SRSV サーバに変換します。

utils cuc activate CUSRSV

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 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 証明書を自動的にダウンロードする機能を有効にします。デフォルトでは、この機能は有効になっています。
無効化	CallManager 証明書を自動的にダウンロードする機能を無効にします。無効にした場合は、証明書を手動でアップロードする必要があります。
ステータス	機能のステータスを表示します。

（注）

クラスタの場合、CLI コマンドはパブリッシャサーバーでのみ実行されます。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 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

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用対象: Cisco Unity Connection

utils cuc cluster deactivate

このコマンドは、Cisco Unity Connection クラスタ内のこのサーバを非アクティブ化します。

utils cuc cluster deactivate

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用対象: Cisco Unity Connection

utils cuc cluster makeprimary

このコマンドは、指定されたサーバを Cisco Unity Connection クラスタ内のプライマリサーバステータスに強制します。

utils cuc cluster makeprimary

構文の説明


パラメータ	説明
サーバ	Cisco Unity Connection クラスタ内でプライマリサーバステータスを取得するサーバの名前を指定します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の許可: はい

適用対象: Cisco Unity Connection

utils cuc cluster overwritedb

このコマンドは、サーバ上のデータを Cisco Unity Connection クラスタ内の他のサーバ上のデータで上書きします。

utils cuc cluster overwritedb

コマンドモード

管理者 (admin:)

使用上のガイドライン

このコマンドは、このコマンドを実行するサーバーのデータベースを、コネクションクラスタ内の他のサーバーのデータベースで上書きします。データベースが上書きされた後、レプリケーションが再開されます。この方法は、バックアップから 1 つのサーバを復元し、復元されたデータを他のサーバにコピーする必要がある場合に使用されます。

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用対象: Cisco Unity Connection

utils cuc cluster renegotiate

このコマンドは、サーバが交換された後、またはパブリッシャサーバに Connection が再インストールされた後に、Connection クラスタ内のパブリッシャサーバとのクラスタ関係を作成します。このコマンドにより、パブリッシャサーバー上のすべてのデータがサブスクライバサーバーのデータで上書きされ、サーバー間のレプリケーションが初期化されます。

utils cuc cluster renegotiate

コマンドモード

管理者 (admin:)

使用上のガイドライン

置き換えられた、または Connection が再インストールされたパブリッシャサーバとの信頼関係を設定するには、Connection クラスタ内のサブスクライバサーバでこのコマンドを実行します。

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用対象: Cisco Unity Connection

utils cuc create report

このコマンドは、システムのトラブルシューティングを行うテクニカルサポートスタッフに役立つデータを収集します。収集されるデータには、バージョン情報、クラスターのステータス、サービス情報、データベース情報、トレースファイル、ログファイル、ディスク情報、メモリ情報、再起動情報が含まれます。

utils cuc create report

コマンドモード

管理者 (admin:)

使用上のガイドライン

コマンドが完了すると、詳細情報が .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 01_tear_down

このコマンドは、クラスタ内の 2 つの 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

このコマンドは、クラスタ内の 2 つの Unity Connection サーバ間のネットワーク接続を確立します。

utils cuc dbreplication 02_define_servers

コマンドモード

管理者 (admin:)

使用上のガイドライン

このコマンドを使用すると、Unity Connection クラスタ内のあるサーバから別のサーバへの 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 接続でセキュリティ機能を使用できるようになります。
無効化	Unity Connection の暗号化を無効にします。無効にすると、Unity Connection のセキュリティ機能は使用できません。
ステータス	Unity Connection の暗号化ステータスを表示します。

使用上のガイドライン

Unity Connection で暗号化を有効にする場合は、次の点を確認してください。

Cisco Unity Connection は、Cisco Smart Software Manager（CSSM）または Cisco Smart Software Manager サテライトに登録されています。
製品に対して輸出管理機能が有効になっています。

Cisco Unity Connection のエクスポートコントロール機能の登録および有効化の方法についての詳細は、『Cisco Unity Connection リリース 12.x のインストール、アップグレード、およびメンテナンスガイド』の「ライセンスの管理」の章の「Cisco Unity Connection での Cisco スマートソフトウェアライセンスの設定」セクション（https://www.cisco.com/c/en/us/td/docs/voice_ip_comm/connection/12x/install_upgrade/guide/b_12xcuciumg.html で入手可能）を参照してください。

（注）

クラスタの場合、CLI はパブリッシャーサーバ上でのみ実行されます。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 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

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 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

使用上のガイドライン

Jetty サーバで SSL を有効にするときは、次の点を確認してください。

Cisco Unity Connection の制限バージョンを使用しています。
Cisco Unity Connection で暗号化が有効になっています。

（注）

評価モードでは、CLI コマンドを実行することはできません。

詳細については、 https://www.cisco.com/c/en/us/td/docs/voice_ip_comm/connection/12x/security/b_12xcucsecx.html で入手可能な『Cisco Unity Connection リリース 12.x のセキュリティガイド』の「Cisco Unity Connection - 制限付きバージョンと無制限バージョン」の章を参照してください。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 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

コマンドモード

管理者 (admin:)

使用上のガイドライン

このコマンドは、Connection Digital Networking Replication Agent および Connection SMTP サービスを停止し、ドロップ、キュー、およびピックアップのレプリケーションフォルダを削除し、このサーバへの進行中のディレクトリプッシュまたはこのサーバからのプルのステータスをクリアし、Connection Digital Networking Replication Agent および Connection SMTP サービスを再起動します。レプリケーションフォルダーのサイズによっては、この操作に数分かかる場合があります。

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Cisco Unity Connection

utils cuc networking dscp

このコマンドにより、クラスタ内の Connection サーバー間で送信されるパケットに DSCP 値 18 を含め、Connection を開始または停止します。これにより、パケットの DSCP 値に基づいてパケットの優先順位を付けるように設定されたルータは、Connection データと音声メッセージを優先します。

utils cuc networking dscp {on | off}

構文の説明


パラメータ	説明
on	ネットワーク経由で送信されるパケットに DSCP 値 18 を含めるように Connection を開始します。
オフ	ネットワーク経由で送信されるパケットに DSCP 値 18 が含まれないようにします。デフォルト値は 18 です。

コマンドモード

管理者 (admin:)

使用上のガイドライン

このコマンドは、クラスタ内の接続サーバ間で渡されるパケットで DSCP 値を利用できるようにします。情報を使用するには、ルーターを設定する必要があります。このコマンドを使用すると、送信パケットに DSCP 値を含めるかどうかを制御できますが、値を変更することはできません。

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用対象: Cisco Unity Connection のみ

utils cuc reset password

このコマンドは、指定されたユーザアカウントのパスワードをリセットします。サインイン試行の失敗回数が多すぎるために Connection によってアカウントがロックされた場合、このコマンドによりアカウントのロックも解除されます。

utils cuc reset password

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 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 機能を有効にし、条件付き有効期限の警告プロンプトが再生される時間間隔を更新できるようにします。

要件

値が次のように設定されている場合:

0: 無効
1: 有効
- 時間間隔を入力してください

utilscuc set PinExpiry_PromptTime "認証規則名" CLI コマンドの詳細については、『Cisco Unity Connection リリースノート』10.0(1) の「Cisco Unity Connection 電話ユーザーインターフェイス（タッチトーン会話）PIN」セクションを参照してください。

utils dbreplication dropadmindb

このコマンドは、クラスター内の任意のサーバ上の Informix syscdr データベースを削除します。

utils dbreplication dropadmindb

コマンドモード

管理者 (admin:)

使用上のガイドライン

このコマンドは、データベースレプリケーションのリセットまたはクラスターのリセットが失敗し、レプリケーションを再開できない場合にのみ実行する必要があります。

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、 IM and Presence サービス Unified Communications Manager、 Cisco Unity Connection

utils dbreplication forcedatasyncsub

このコマンドは、サブスクライバサーバのデータをパブリッシャサーバ上のデータから強制的に復元します。

utils dbreplication forcedatasyncsub ノード名 [offloadpub] [タイムアウト値]

構文の説明

パラメータ

説明

ノード名

パブリッシャーサーバ上のデータからデータを復元する特定のサブスクライバーサーバを指定します。すべてのサブスクライバーサーバのデータを復元するには、 all と入力します。

offloadpub

Forcedatasyncsub プロセス中のパブリッシャーサーバの使用を最小限に抑えます。

（注）

このオプションを追加すると、forcedatasyncsub が完了するまでにかかる時間が長くなります。

タイムアウト値

各ノードの回復タイムアウト値を分単位で指定します (デフォルトのタイムアウトよりも大きい必要があります)。

デフォルト: 40 分。

コマンドモード

管理者 (admin:)

使用上のガイドライン

utils dbreplication repair コマンドを複数回実行する前にこのコマンドを使用します。ただし、utils dbreplication status コマンドでは、同期されていない非動的テーブルが依然として表示されます。

（注）

動的テーブルのみが同期していない場合はこのコマンドを実行しないでください。通常のシステム操作中に動的テーブルが同期していない可能性があります。

このコマンドはパブリッシャーサーバからのみ実行できます。クラスタ内のすべてのサブスクライバサーバで同期を強制するには、 all と入力します。同期していないサブスクライバーサーバが 1 台だけの場合は、 nodename パラメーターを使用します。

（注）

このコマンドでは、サブスクライバサーバー上にある既存のデータはすべて消去され、パブリッシャサーバー上のデータベースに置き換えられます。この消去により、サブスクライバサーバーテーブルが同期しなくなる根本原因を特定できなくなります。

utils dbreplication forcedatasyncsub コマンドを実行した後、サブスクライバノードを再起動します。

（注）

utils dbreplication forcedatasyncsub コマンドが実行されたサブスクライバノードでは、サブスクライバの再起動が実行されない限り、Cisco DB サービスは停止状態になります。

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service、Cisco Unity Connection

utils dbreplication quickaudit

このコマンドは、動的テーブル上の選択されたコンテンツに対して簡単なデータベースチェックを実行します。

utils dbreplication quickaudit {ノード名 | すべて}

構文の説明


パラメータ	説明
`ノード名`	クイック監査を実行するノードを指定します。
all	すべてのノードで監査を実行します

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、 IM and Presence サービス Unified Communications Manager、 Cisco Unity Connection

utils dbreplication rebuild

このコマンドは、クラスター全体でデータベースのレプリケーションを設定するために使用され、指定されたノードで次のコマンドを実行します。

utils dbreplication stop
utils dbreplication dropadmindb または dropadmindbforce
utils dbreplication reset

utils dbreplication rebuild { [ノード名] | | すべて}

構文の説明


パラメータ	説明
`ノード名`	データベースレプリケーションを再構築するノードを指定します。
全て	クラスター内のすべてのノードでデータベースレプリケーションが再構築されることを指定します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

注意	このコマンドは、クラスター内の他のノードのパフォーマンスに影響を与える可能性があります。このコマンドはシステムメンテナンス期間中に実行することをお勧めします。

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service、Cisco Unity Connection

utils dbreplication repair

このコマンドはデータベースのレプリケーションを修復します。

utils dbreplication repair {ノード名 | すべて}

構文の説明


パラメータ	説明
`ノード名`	データ修復の対象となる特定のサブスクライバーサーバを指定します。
all	すべてのサブスクライバーサーバでデータ修復が行われます。

コマンドモード

管理者 (admin:)

使用上のガイドライン

コマンド utils dbreplication status によって、サーバーが接続されているが、1 つ以上のテーブルに同期されていないデータがあることを示している場合、utils dbreplication repair はサブスクライバサーバーのデータを修復し、パブリッシャサーバーのデータと同期させます。

クラスタ内のすべてのノードを修復するには all を指定します。1 つのサブスクライバサーバのみが同期していない場合は、 nodename パラメータを指定します。

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用対象: Unified Communications Manager、 IM およびプレゼンスサービス Unified Communications Manager、 Cisco Unity Connection

utils dbreplication repairreplicate

このコマンドは、クラスタノード間で一致しないデータを修復し、パブリッシャデータと一致するようにノードデータを変更します。

utils dbreplication repairreplicate replicatename [ノード名 | すべて]

構文の説明


パラメータ	説明
`replicatename`	修復する複製を指定します。
`ノード名`	レプリケーションを修復するノードを指定します。
全て	すべてのノードでレプリケーションを修正することを指定します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

パラメータ nodename ではパブリッシャーを指定できません。任意のサブスクライバーノード名が許容されます。

（注）

このコマンドはパブリッシャー上で実行できます。

（注）

このコマンドはレプリケーション設定を修復しません

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用対象: Unified Communications Manager、 IM およびプレゼンスサービス Unified Communications Manager、 Cisco Unity Connection

utils dbreplication repairtable

このコマンドは、クラスターノード間の不一致なデータを修復し、パブリッシャーデータと一致するようにノードを変更します。

utils dbreplication repairtable テーブル名 [ノード名 | すべて]

構文の説明


パラメータ	説明
`テーブル名`	修復するテーブルを指定します
`ノード名`	レプリケーションを修復するノードを指定します。
全て	すべてのノードでレプリケーションを修正することを指定します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

（注）

このコマンドはレプリケーション設定を修復しません。

要件

コマンド権限レベル: 1

アップグレード中の許可: はい

適用対象: Unified Communications Manager、 IM およびプレゼンスサービス Unified Communications Manager、 Cisco Unity Connection

utils dbreplication reset

このコマンドによって、データベースのレプリケーションをリセットして再起動します。システムがレプリケーションを適切に設定していない場合は、このコマンドを使用してレプリケーションを再構築できます。

utils dbreplication reset {ノード名 | すべて}

構文の説明


パラメータ	説明
`ノード名`	レプリケーションを再構築する特定のサブスクライバサーバーを指定します。
all	クラスタ内のすべてのサブスクライバサーバのレプリケーションが再構築されることを指定します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

このコマンドは、サーバの RTMT 状態が 4 の場合に使用する最適なオプションです。1 つのサブスクライバサーバのみが RTMT 状態 4 を示している場合は、 hostname パラメータを指定してそのサーバをリセットできます。クラスター全体をリセットするには、 all パラメータを使用します。

ヒント

このコマンドを実行する前に、まずリセットするすべてのサブスクライバサーバでコマンド utils dbreplication stop を実行し、次にパブリッシャサーバでコマンドを実行します。

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、 IM およびプレゼンスサービス Unified Communications Manager、 Cisco Unity Connection

utils dbreplication runtimestate

このコマンドは、データベースレプリケーションプロセスの進行状況を監視し、クラスター内のレプリケーション状態を提供します。

utils dbreplication runtimestate ノード名

構文の説明


パラメータ	説明
`ノード名`	監視するノードを指定します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

ノード名を指定すると、システムは選択したノードのコンテキストからレプリケーション状態を提供します。

要件

コマンド権限レベル: 0

アップグレード中の許可: はい

適用対象: Unified Communications Manager、 IM およびプレゼンスサービス Unified Communications Manager、 Cisco Unity Connection

utils dbreplication setprocess

このコマンドは、遅延のある WAN によって分離されたノードを持つクラスターのレプリケーションパフォーマンスを向上させます (WAN 経由のクラスタリング構成)。

utils dbreplication setprocess [プロセス]

構文の説明


パラメータ	説明
process	新しいデータベースレプリケーション。値が 1 から 40 の間であることを確認してください。デフォルト値: 1

コマンドモード

管理者 (admin:)

使用上のガイドライン

注意	PROCESS オプションを最大値近くに設定すると、より多くのシステムリソースが消費されます。アップグレード後、新しいバージョンに切り替える前にこの設定に加えられた変更は、手動で再適用する必要があります。

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

utils dbreplication setrepltimeout

このコマンドは、大規模なクラスター上のデータベースレプリケーションのタイムアウトを設定します。

utils dbreplication setrepltimeout タイムアウト

構文の説明


パラメータ	説明
`タイムアウト`	新しいデータベースレプリケーションのタイムアウト (秒単位)。値が 300 から 3600 の間であることを確認してください。デフォルト値: 300 (5 分)

コマンドモード

管理者 (admin:)

使用上のガイドライン

最初のサブスクライバサーバがパブリッシャサーバとのレプリケーションを要求すると、システムはこのタイマーを設定します。タイマーが期限切れになると、最初のサブスクライバサーバと、その期間内にレプリケーションを要求した他のすべてのサブスクライバサーバが、パブリッシャーサーバとのデータレプリケーションを一括して開始します。複数のサブスクライバーサーバが存在する場合、個別のサーバレプリケーションよりもバッチレプリケーションの方が効率的です。大規模なクラスターの場合、コマンドを使用してデフォルトのタイムアウト値を増やすことで、より多くのサブスクライバーサーバをバッチに含めることができます。

ヒント

クラスタ全体のアップグレードが完了し、サブスクライバサーバーの複製が適切に設定されたら、この値をデフォルトの 300（5 分）に戻すことをお勧めします。

（注）

パブリッシャサーバをアップグレードし、アップグレードしたパーティションで再起動した後、最初のサブスクライバサーバを新しいリリースに切り替える前に、このタイマー値を設定する必要があります。最初のサブスクライバサーバがレプリケーションを要求すると、パブリッシャサーバは新しい値に基づいてレプリケーションタイマーを設定します。

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、 IM およびプレゼンスサービス Unified Communications Manager、 Cisco Unity Connection

utils dbreplication status

このコマンドは、データベースレプリケーションのステータスを表示し、クラスター内のサーバが接続され、データが同期されているかどうかを示します。

utils dbreplication status {すべての | ノード | を複製する}

構文の説明


パラメータ	説明
all	すべてのサーバのステータスを表示するように指定します。
ノード	ステータスを表示するノードを指定します。
複製する	ステータスを表示する複製を指定します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

（注）

このコマンドは、クラスタの最初のノード (パブリッシャーサーバ) でのみ実行する必要があります。

要件

コマンド権限レベル: 0

アップグレード中の可能: なし

適用対象: Unified Communications Manager、 IM およびプレゼンスサービス Unified Communications Manager、 Cisco Unity Connection

utils dbreplication stop

このコマンドは、データベースレプリケーションの自動セットアップを停止します。 CLI コマンド utils dbreplication reset を実行する前に、サブスクライバサーバとパブリッシャサーバでこのコマンドを実行します。このコマンドは、パブリッシャサーバーで実行する前に、サブスクライバサーバーで同時に実行できます。

utils dbreplication stop {ノード名 | すべて}

構文の説明


パラメータ	説明
`ノード名`	データベースレプリケーションの自動セットアップを停止するノードの名前を指定します。
all	すべてのノード上のデータベースのレプリケーションを停止します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、 IM およびプレゼンスサービス Unified Communications Manager、 Cisco Unity Connection

utils imdb_replication replication status

このコマンドは、デプロイメントの各サブクラスター内のノードペア間のメモリ内データベース (IMDB) レプリケーションが正しく実行されたことを検証します。

このコマンドは、呼び出し元の IM and Presence Service ノードからのユーティリティを使用して、関連する各データストア内の IMDB テーブルに対して書き込みと読み取りを実行します。

utils imdb_replication ステータス

コマンドモード

管理者 (admin:)

使用上のガイドライン

ユーティリティを正常に実行するには、IM and Presence サービスクラスタのノード間に設定されているすべてのファイアウォールでポート 6603、6604、および 6605 が開かれている必要があります。

これは、IMDB の通常の操作には必要ありません。

要件

コマンド権限レベル: 0

アップグレード中に許可: はい

適用対象: IM およびプレゼンスサービス

utils diagnose

このコマンドを使用すると、システムの問題を診断し、自動的に修復することができます。

utils diagnose {fix | list | test | version} [モジュール名]

構文の説明


パラメータ	説明
fix	すべての診断コマンドを実行し、問題の修正を試みます。
hcs	HCS サービスで使用できるすべての診断コマンドを一覧表示します。
list	使用可能なすべての診断コマンドを一覧表示します。
module	単一の診断コマンドまたはコマンドのグループを実行し、問題の修正を試みます。
テスト	すべての診断コマンドを実行しますが、問題の修正は試行しません。
バージョン	診断フレームワークのバージョンを表示します。
`モジュール名`	診断モジュールの名前を指定します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: バージョン（version）の場合は 0、その他のパラメータの場合は 1

適用対象: Unified Communications Manager、 Unified Communications Manager の IM およびプレゼンスサービス、および Cisco Unity Connection

utils disaster_recovery backup network

リモートサーバに保存されているバックアップファイルに関する情報を表示します。

utils disaster_recovery backup network [機能リスト] [パス] [サーバ名] [ユーザ名（username）]

構文の説明


パラメータ	説明
`[機能リスト]`	バックアップする機能のリストをコンマで区切って指定します。
`[パス]`	リモートサーバ上のバックアップファイルの場所を表します。
`[サーバ名]`	バックアップファイルを保存したサーバの IP アドレスまたはホスト名を表します。
`[ユーザ名]`	リモートサーバにログインするために必要なユーザ名を表します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

システムは、リモートサーバのアカウントのパスワードを入力するように要求します。

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils disaster_recovery cancel_backup

このコマンドは進行中のバックアップをキャンセルします。

utils disaster_recovery cancel_backup [確定]

コマンドモード

管理者 (admin:)

使用上のガイドライン

コマンドを入力した後、バックアップをキャンセルすることを確認する必要があります。バックアップをキャンセルするには Y と入力し、バックアップを続行するには他のキーを入力します。

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および 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 デバイス名 パス サーバ名/IP アドレス ユーザ名（username） [バックアップ数]

構文の説明


パラメータ	説明
`デバイス名`	追加するバックアップデバイスの名前を指定します (必須)。
`パス`	バックアップデバイスを取得するためのパスを指定します (必須)。
`サーバ名/IP アドレス`	バックアップファイルが保存されているサーバのホスト名または IP アドレスを指定します (必須)。
`ユーザ名`	リモートマシンに接続するために必要なユーザ ID を指定します (必須)。
`[バックアップ数]`	ネットワークディレクトリに保存するバックアップの数を指定します (デフォルトは 2)。このパラメータはオプションです。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および 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 デバイス名 | *

構文の説明


パラメータ	説明
`デバイス名`	削除するデバイスの名前。
`*`	スケジュールに関連付けられているデバイスを除く、既存のデバイスをすべて削除します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils disaster_recovery device list

すべてのバックアップデバイスのデバイス名、デバイスタイプ、およびデバイスパスを表示します。

utils disaster_recovery device list

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils disaster_recovery estimate_tar_size

このコマンドは、SFTP またはローカルデバイスからの最後の成功したバックアップの推定サイズを提供します。

utils disaster_recovery estimate_tar_size utils disaster_recovery device list

構文の説明


パラメータ	説明
機能リスト	バックアップする機能のリストをコンマで区切って指定します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils disaster_recovery history

このコマンドは、以前のバックアップと復元の履歴を表示します。

utils disaster_recovery history [operation]

構文の説明


パラメータ	説明
`operation`	バックアップまたは復元を指定します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル:

アップグレード中に許可されるもの:

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および 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`	操作の名前（有効または無効）を指定します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils disaster_recovery prepare restore pub_from_sub

このコマンドは、サブスクライバーノードからパブリッシャーノードを復元するための準備タスクを処理します。

（注）

このコマンドは、パブリッシャーノードが再構築され、サブスクライバーノードデータベースから復元される場合にのみ適用できます。リモートバックアップソースからデータを復元するのではなく、復元には特定の手順が使用されます。パブリッシャーノードが再構築された後、プロセスノード情報を挿入する前にこのコマンドを使用する必要があります。

utils disaster_recovery prepare restore pub_from_sub

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils disaster_recovery restore network

このコマンドはリモートサーバを復元します。同じクラスタ内のサブスクライバノードを復元する前に、 Unified Communications Manager パブリッシャノードを復元する必要があります。 IM and Presence Service ノードを復元する場合は、同じクラスタ内のサブスクライバノードを復元する前に、データベースパブリッシャノードを復元する必要があります。

utils disaster_recovery restore network restore_server tarfilename デバイス名

構文の説明


パラメータ	説明
`復元サーバ`	復元するリモートサーバのホスト名を指定します。
`tarfilename`	復元するファイルの名前を指定します。
`デバイス名`	ファイルを復元するデバイスの名前を指定します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の許可: はい

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils disaster_recovery schedule add

このコマンドは、構成されたスケジュールを追加します。

utils disaster_recovery schedule add スケジュール名 デバイス名 機能リスト datetime 頻度

構文の説明


パラメータ	説明
`スケジュール名`	スケジューラの名前を表します (必須)。
`デバイス名`	スケジュールが実行されるデバイスの名前を表します (必須)。
`機能リスト`	バックアップする機能のコンマ区切りリストを表します (必須)。
`datetime`	スケジューラが設定された日付を表します (必須)。（yyyy/mm/dd-hh:mm）24 時間で指定された形式。
`頻度`	バックアップを実行するスケジュールが設定されている頻度を表します。例: 1 回、毎日、毎週、毎月。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils disaster_recovery schedule

このコマンドは、指定されたスケジュールを有効または無効にします。

utils disaster_recovery schedule {有効にする | 無効にする} [スケジュール名]

構文の説明


パラメータ	説明
有効化	指定されたスケジュールを有効にします。
無効にする	指定されたスケジュールを無効にします。
`スケジュール名`	スケジューラの名前を表します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

例

admin: utils disaster_recovery schedule enable schedule1
Schedule enabled successfully.

utils disaster_recovery schedule delete

このコマンドは、設定されたスケジュールを削除します。

utils disaster_recovery schedule delete スケジュール名

構文の説明


パラメータ	説明
`スケジュール名`	削除するスケジュールの名前を表します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils disaster_recovery schedule disable

このコマンドは、設定されたスケジュールを無効にします。

utils disaster_recovery schedule disable スケジュール名

構文の説明


パラメータ	説明
`スケジュール名`	無効にするスケジュールの名前を表します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils disaster_recovery schedule list

設定されているスケジュールを表示します。

utils disaster_recovery schedule list

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および 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 デバイス名

構文の説明


パラメータ	説明
`デバイス名`	保存場所にあるバックアップファイルを表示するデバイスの名前を表します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中に許可: はい

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils disaster_recovery show_registration

このコマンドは、指定されたサーバに登録されている機能とコンポーネントを表示します。

utils disaster_recovery show_registration hostname

構文の説明


パラメータ	説明
`ホスト名`	登録情報を表示するサーバを指定します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils disaster_recovery status

このコマンドは、現在のバックアップまたは復元ジョブのステータスを表示します。

utils disaster_recovery status operation

構文の説明


パラメータ	説明
`operation`	進行中の操作の名前（バックアップまたは復元）を指定します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils EnhancedSecurityMode disable

このコマンドは、システムの EnhancedSecurityMode モードを無効にします。このモードを無効にすると、システムが再起動します。

utils EnhancedSecurityMode を無効にする

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 4

アップグレード中の可能: なし

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils EnhancedSecurityMode enable

このコマンドは、システム上で EnhancedSecurityMode モードを有効にします。このモードを有効にするとシステムが再起動します。

utils EnhancedSecurityMode を有効にする

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 4

アップグレード中の可能: なし

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils EnhancedSecurityMode status

このコマンドは、システムが EnhancedSecurityMode モードで動作しているか、非 EnhancedSecurityMode モードで動作しているかを表示します。

utils EnhancedSecurityMode status

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中に許可: はい

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils filebeat config

このコマンドは、情報をダウンロードするための Logstash サーバの詳細を構成します。

utils filebeat configIP アドレス(IP address) ポート番号ログタイプ

構文の説明


パラメータ	説明
IP アドレス(IP address)	Logstash サーバの IP アドレスを入力します。
ポート番号	Logstash サーバのポート番号を入力します。
ログタイプ	Logstash サーバーにアップロードする必要があるログの種類を入力します。

TLS を有効にして FileBeat サービスをセキュリティ保護することもできます。パラメータを設定すると次のプロンプトが表示されます。

TLS を有効にして Filebeat サービスを保護しますか?

入力（はい/いいえ）しますか?

TLS を有効にするには、 「はい」 と入力します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 4

アップグレード中の可能: なし

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils filebeat disable

このコマンドは、システム上で filebeat 構成を無効化します。

utils filebeat を無効にする

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 4

アップグレード中の可能: なし

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils filebeat enable

このコマンドは、システム上で filebeat 構成を有効化します。

utils filebeat disable

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 4

アップグレード中の可能: なし

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils filebeat status

このコマンドは、Filebeat が実行中かどうか、およびその構成値を表示します。

utils filebeat status

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 4

アップグレード中の可能: なし

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils filebeat tls

このコマンドは、FileBeat クライアントと logstash サーバ間の通信プロトコルとしてトランスポート層セキュリティ (TLS) を設定します。これにより、FileBeat クライアントと logstash サーバ間の安全な接続が可能になり、Common Criteria ガイドラインに準拠するための要件が満たされます。

コモンクライテリアモードでは、厳密なホスト名検証が使用されます。そのため、証明書と一致する完全修飾ドメイン名（FQDN）でサーバーを設定する必要があります。

utils filebeat tls {有効化 | 無効化 | ステータス}

構文の説明


パラメータ	説明
有効化	FileBeat クライアントと logstash サーバ間の安全な接続を有効にします。
無効にする	FileBeat クライアントの TLS を無効にします。
ステータス	TLS のステータスを表示します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 4

適用対象: Unified Communications Manager および Unified Communications Manager 上の IM およびプレゼンスサービス

セキュリティ証明書を、logstash サーバから Unified Communications Manager および IM and Presence Service 上の tomcat 信頼ストアにアップロードする必要があります。

utils fior

このコマンドを使用すると、サーバの I/O を監視できます。ファイル I/O レポートサービスは、プロセスごとにファイル I/O を収集するためのカーネルベースのデーモンを提供します。

utils fior

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils fior disable

このコマンドは、I/O 統計監視を無効にし、システムで収集されたすべての監視データを削除します。このコマンドを使用して監視を無効にし、監視データによって使用されるディスク領域を解放します。

utils fior disable

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils fior enable

このコマンドは、I/O 統計の監視を有効にします。

（注）

監視を開始する前にこのコマンドを使用します。

utils fior enable

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils fior list

このコマンドは、すべてのプロセスの I/O イベントのリストを表示します。

utils fior list

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils fior start

このコマンドは、I/O 統計ユーティリティの監視とデータ収集を開始します。監視が開始されると、I/O 統計データがプラットフォームログに収集されます。このデータは 1 日あたり最大 25 MB の範囲になります。データは、データ収集から 7 日後にローテーションされます。 I/O 統計ユーティリティの監視を無効にすると、このデータは削除されます。

（注）

監視を開始する前に、I/O 統計ユーティリティの監視を有効化します。

utils fior start

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils fior status

このコマンドは、I/O 統計監視ユーティリティのステータスを提供します。

utils fior status

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils fior stop

このコマンドは、I/O 統計の監視とデータ収集を停止します。ただし、このコマンドでは収集されたデータは削除されません。

（注）

I/O 統計が不要になった場合は、プラットフォームログからの監視データのクリーンアップを無効化します。

utils fior stop

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の許可: はい

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils fior top

このコマンドは、このコマンドを実行した時点での I/O バウンドプロセスの I/O 統計のリストを表示します。

utils fior top

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

ユーティリティ FIPS

注意

FIPS モードは FIPS 準拠のリリースでのみサポートされます。警告: 非 FIPS 準拠バージョンにアップグレードする前に、FIPS モードを無効にする必要があることに注意してください Unified Communications Manager。

どのリリースが FIPS に準拠しているか、およびそれぞれの認証を確認するには、 FIPS 140 のドキュメント ( https://www.cisco.com/c/en/us/solutions/industries/government/global-government-certifications/fips-140.html) を参照してください。

このコマンドは FIPS 140-2 モードを有効または無効にするか、ステータスを表示します。 FIPS 140-2 モードはデフォルトで無効になっています。管理者だけが FIPS を有効にできます。

utils fips {有効化 | 無効化 | ステータス}

構文の説明


パラメータ	説明
有効化	FIPS 140-2 モードを有効にします。
無効にする	FIPS 140-2 モードを無効にします。
ステータス	FIPS 140-2 モードのステータスを表示します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

FIPS モードを有効にする前に、システムのバックアップを実行することを推奨します。起動時に FIPS チェックが失敗すると、システムが停止し、リカバリ CD が必要になります。

FIPS 140-2 モードを有効にする前に、以下の情報を考慮してください。

非 FIPS モードから FIPS モードに切り替えると、MD5 および DES プロトコルは機能しなくなります。
サーバで FIPS モードを有効にしたら、サーバが再起動して電話が正常に再登録されるまで待ってから、次のサーバで FIPS を有効にしてください。
FIPS モードでは、 IM and Presence Service は、Racoon (FIPS 未検証)の代わりに Red Hat OpensWAN (FIPS 検証済み)を使用します。ラクーンのセキュリティポリシーに FIPS 承認されていない機能が含まれている場合、CLI コマンドはFIPS 承認された機能を含むセキュリティポリシーを再定義し、中止するように要求します。

（注）

証明書と SSH キーは、FIPS 要件に従って、自動的に再生成されます。

FIPS 140-2 モードを無効にする前に、以下の情報を考慮してください。複数のサーバクラスタでは、各サーバは個別に無効にする必要があります。FIPS モードはクラスター全体では無効になりませんが、サーバごとに無効になります。

FIPS 140-2 モードを有効にした後、以下の情報を考慮します。シングルサーバクラスターがあり、FIPS モードを有効にする前に「Prepare Cluster for Rolback to pre 8.0」エンタープライズパラメータを適用する場合、すべての電話がサーバに成功裏に登録されたことを確認した後、このパラメータを無効にします。

IM and Presence Service の FIPS 140-2 モードを有効または無効にする前に、次の情報を考慮してください: IM and Presence Serviceの FIPS 140-2 モードを有効または無効にした後、Tomcat 証明書が再生成され、ノードが再起動されます。クラスター間同期エージェントはクラスター全体で新しい Tomcat 証明書を同期します。これには最大で 30 分かかります。新しい Tomcat 証明書がクラスタ全体で同期されるまで、 IM and Presence Service サブスクライバノードは IM and Presence Service データベース公開者ノードから情報にアクセスできません。例えば、サブスクライバノードで Cisco Unified Serviceability GUI にログインしているユーザは、 IM and Presence Service データベースパブリッシャノード上のサービスを表示することはできません。同期が完了するまで、ユーザには次のエラーメッセージが表示されます: サーバへの接続を確立できません (証明書例外)

要件

コマンド権限レベル: 0

アップグレード中の可能: なし

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils fips_common_criteria

このコマンドは、システム内の Common Criteria モードを設定します。

utils fips_common_criteria {有効化 | 無効化 | ステータス}

構文の説明


パラメータ	説明
有効化	システムで Common Criteria モードを有効にする
無効にする	システムの Common Criteria モードを無効化する共通基準モードが無効になっている場合、最小の TLS バージョンを設定するためのプロンプトが表示されます。
ステータス	システムの Common Criteria モードのステータスを表示する

コマンドモード

管理者 (admin:)

使用上のガイドライン

Common Criteria モードを有効にすると、TLS バージョン 1.0 を使用した安全な接続は許可されなくなります。 Common Criteria モードを有効にすると、FIPS モードも有効になります。 Common Criteria モードを有効または無効にする場合、証明書を再生成する必要はありません。ただし、FIPS を有効または無効にするには、証明書の再生成とともにシステムの再起動が必要になります。

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用対象: Unified Communications Manager および IM and Presence Service

（注）

この CLI コマンドは Cisco Unity Connection には適用されません。

utils firewall ipv4 debug

このコマンドは、IPv4 ファイアウォールのデバッグをオンまたはオフに切り替えます。時間パラメータを入力しない場合、このコマンドは 5 分間デバッグをオンにします。

utils firewall ipv4 debug {オフ | | [時刻] }

構文の説明


パラメータ	説明
オフ	IPv4 ファイアウォールのデバッグをオフにします。時間パラメータを入力しない場合、このコマンドはファイアウォールを 5 分間無効にします。
`時間`	(オプション) ファイアウォールのデバッグを有効にする期間を次の形式で設定します。分: 0～1440m 時間: 0 ～ 23 時間時間および分: 0 ～ 23 時間、0 ～ 60 分

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection。

utils firewall ipv4

このコマンドは、IPv4 ファイアウォールを有効または無効にします。

utils firewall ipv4 {有効にする | 無効にする | [時間]}

構文の説明


パラメータ	説明
有効化	IPv4 ファイアウォールをオンにします。
無効にする	IPv4 ファイアウォールをオフにします。時間パラメータを入力しない場合、このコマンドはファイアウォールを 5 分間無効にします。
`時間`	(オプション) ファイアウォールを無効にする期間を次の形式で設定します。分: 0～1440m 時間: 0 ～ 23 時間時間および分: 0 ～ 23 時間、0 ～ 60 分

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection。

utils ファイアウォール ipv4 リスト

このコマンドは、IPv4 ファイアウォールの現在の構成を表示します。

utils ファイアウォール ipv4 リスト

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中に許可: はい

適用先: Unified Communications Manager、Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection。

utils firewall ipv4 status

このコマンドは、IPv4 ファイアウォールの現在のステータスを表示します。

utils firewall ipv4 status

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中に許可: はい

適用先: Unified Communications Manager、Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection。

utils firewall ipv6 debug

このコマンドは、設定された期間、IPv6 ファイアウォールのデバッグをオンにします。期間のデフォルト値は 5 分です。

utils ipv6 ファイアウォールデバッグ {オフ | | [時刻] }

構文の説明


パラメータ	説明
オフ	(オプション) IPv6 ファイアウォールのデバッグをオフにします。時間パラメータを入力しない場合、このコマンドはデフォルトの期間値に従ってファイアウォールを無効にします。
`時間`	(オプション) ファイアウォールのデバッグを有効にする期間を次の形式で設定します。分: 0 ～ 1,440 分時間: 0 ～ 23 時間時間および分: 0 ～ 23 時間、0 ～ 60 分

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用対象: Unified Communications Manager、Unified Communications Manager 上の IM およびプレゼンスサービス、および Cisco Unity Connection。

utils firewall ipv6

このコマンドは、IPv6 ファイアウォールを有効または無効にします。

utils firewall ipv6 {有効にする | 無効にする | [時間]}

構文の説明


パラメータ	説明
有効化	IPv6 ファイアウォールをオンにします。
無効にする	IPv6 ファイアウォールをオフにします。時間パラメータを入力しない場合、このコマンドはファイアウォールを 5 分間無効にします。
`時間`	(オプション) ファイアウォールを無効にする期間を次の形式で設定します。分: 0～1440m 時間: 0 ～ 23 時間時と分: 0～23 時間 0～60 分

コマンドモード

管理者 (admin:)

使用上のガイドライン

このコマンドを使用して、ファイアウォールテーブルを有効または無効にすることができます。 USGv6 プロファイルへの準拠について Unified Communications Manager をテストする場合は、テストを開始する前に 23 時間、IPv6 ファイアウォールテーブルを無効にする必要があります。

要件

コマンド権限レベル: 0

アップグレード中に許可: はい

適用対象: Unified Communications Manager、Unified Communications Manager 上の IM およびプレゼンスサービス、および Cisco Unity Connection。

utils ファイアウォール ipv6 リスト

このコマンドは、現在の IPv6 ファイアウォールの構成を表示します。

utils ファイアウォール ipv6 リスト

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中の許可: はい

適用対象: Unified Communications Manager、Unified Communications Manager 上の IM およびプレゼンスサービス、および Cisco Unity Connection。

utils firewall ipv6 status

このコマンドは、IPv6 ファイアウォールの現在のステータスを表示します。

utils firewall ipv6 status

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中に許可: はい

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service、Cisco Unity Connection。

utils ha failover

このコマンドは、指定されたノードの手動フェールオーバーを開始します。Cisco Server Recovery Manager は、障害が発生したノード上の重要なサービスを停止し、すべてのユーザをバックアップノードに移動します。

IM およびプレゼンスサービスノードの場合、バックアップノードは別の IM およびプレゼンスサービスである必要があります。バックアップサーバを指定する前に、2 台のサーバを同じプレゼンス冗長グループに割り当てる必要があります。指定するバックアップサーバは、プレゼンス冗長グループに割り当てられている他のサーバです。

utils ha failover {ノード名}

構文の説明


パラメータ	説明
ノード名	手動フェイルオーバーを実行するノードを指定します。

コマンドモード

管理者 (admin:)

要件

適用先: Unified Communications Manager、IM and Presence Service Unified Communications Manager

フェイルオーバーの例

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 ノード名

構文の説明


パラメータ	説明
`ノード名`	手動フォールバックを実行するノードを指定します。

コマンドモード

管理者 (admin:)

要件

適用先: Unified Communications Manager、IM and Presence Service Unified Communications Manager

フォールバックの例

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

このコマンドは、指定されたポートのクライアント認証の値を設定します。認証でサポートされる値は、必須、オプション、または無効です。

次の表はポートのデフォルト値を示しています。

表 1. ポートのデフォルト値
ポート	デフォルト値
6971	オプション
6972	オプション
9443	Required

警告	クライアント認証をデフォルト値以外の値に設定すると、重大な影響が生じる可能性があります。これらの値は、Cisco TAC チームのアドバイスに従ってのみ変更してください。

utils haproxy セット {required | optional | disable}クライアント認証 portnum

構文の説明

パラメータ

説明

portnum

HAProxy クライアント認証を設定するためのポート番号を入力します。

（注）

サポートされているポート番号は 6971、6972、9443 です。

必須

指定されたポートでクライアント認証の値を "必須" に設定します。

オプション

指定されたポートでクライアント認証の値を "オプション" に設定します。

無効にする

指定されたポートでクライアント認証の値を "無効" に設定します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

ユーザが 6971、6972、または 9443 以外の portnum 値を入力すると、有効なポート番号を入力するように求めるエラーメッセージが表示されます。
管理者は、 help utils haproxy set optional client-auth コマンドを実行してヘルプコンテンツを表示できます。
ポート番号 に設定されたクライアント認証値は、アップグレード中および災害復旧システム (DRS) を使用したバックアップと復元の実行中に保持されます。
クライアント認証を "必須"に設定すると、サーバはクライアントに証明書を要求します。クライアントは要求された証明書をサーバに提示する必要があります。したがって、リクエストをさらに別のサービスに転送できます。
クライアント認証を "オプション"に設定すると、サーバはクライアントに証明書を要求します。ただし、クライアントが要求された証明書をサーバに提示しない場合でも、要求はさらなるサービスに転送できます。
クライアント認証を "無効"に設定すると、サーバはクライアントからの証明書を要求しません。
このコマンドを実行すると、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 ハプロキシ set スレッド数 スレッド数

構文の説明

パラメータ

説明

スレッド数

設定する HAProxy スレッドの数を入力します。

（注）

デフォルト値は 1 です。

スレッド数としてサポートされる値は 1、2、3、4 です。

コマンドモード

管理者 (admin:)

使用上のガイドライン

ユーザが 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 プレゼンス冗長グループ名

構文の説明


パラメータ	説明
`プレゼンス冗長グループ名`	HA ステータスを監視するプレゼンス冗長グループを指定します。プレゼンス冗長グループ名が指定されていない場合は、すべてのクラスタ情報が提供されます。

コマンドモード

管理者 (admin:)

要件

適用先: Unified Communications Manager、IM and Presence Service Unified Communications Manager

リカバリ例

admin: ha recover Defaultcluster
Stopping services... Stopped
Starting services... Started
admin:

utils ha status

このコマンドは、指定されたプレゼンス冗長グループの HA ステータスを表示します。

utils ha status プレゼンス冗長グループ名

構文の説明


パラメータ	説明
`presence redundancy group name`	HA ステータスを監視するプレゼンス冗長グループを指定します。プレゼンス冗長グループ名が指定されていない場合は、すべてのクラスタ情報が表示されます。

コマンドモード

管理者 (admin:)

要件

適用先: Unified Communications Manager、IM and Presence Service Unified Communications Manager

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 クラスター名

構文の説明


パラメータ	説明
`クラスター名`	ILS ネットワーク内の Unified Communications Manager クラスタのパブリッシャノードの完全修飾ドメイン名を指定します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

ピア情報ベクトルには、ILS ネットワーク内のクラスターに関する情報が含まれています。利用可能な情報には、クラスタ名、クラスタ ID、クラスタノードの IP アドレスなどがあります。 ILS ネットワークの特定のクラスタに関する情報が必要な場合は、 clustername パラメータを入力します。ネットワーク内のすべてのクラスタの情報が必要な場合は、clustername パラメータを空のままにします

要件

コマンド権限レベル: 0

アップグレード中の可能: なし

適用対象: Unified Communications Manager

utils import config

このコマンドは、仮想フロッピードライブ上の platformConfig.xml ファイルからデータを取得し、構成ファイルと一致するようにシステムを変更します。コマンドが正常に完了すると、システムが再起動します。

utils import config

コマンドモード

管理者 (admin:)

使用上のガイドライン

このコマンドは、どの VMware デプロイメントでも実行できます。

VMware の電源をオンにします。
応答ファイルジェネレーター (AFG) ツール ( http://www.cisco.com/web/cuc_afg/index.html ) を使用して、platformConfig.xml ファイルを作成します。
Config.xml ファイルを仮想フロッピーインスタンスに挿入します (手順については http://kb.vmware.com/selfservice/microsites/search.do?language=en_US&cmd=displayKC&externalId=1739 を参照してください)。
新しい VMware のフロッピードライブに .flp ファイルをマウントします。
VM の CLI (コンソールまたは SSH を使用) にログインし、 utils import config コマンドを実行します。

このコマンドは、xml ファイル内にあるすべてのデータを循環処理し、VM に現在設定されているデータと異なるデータが見つかった場合は、新しいデータに合わせて VM を変更します。
システムは新しい ID で再起動します。

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service、Cisco Unity Connection

Vmware Deployment で utils import config を実行する

手順

utils iostat

このコマンドは、指定された反復回数と間隔の iostat 出力を表示します。

utils iostat {間隔 | 反復 | ファイル名}

構文の説明


パラメータ	説明
間隔	2 つの iostat 読み取り間の秒数を設定します。反復パラメータを使用している場合は、この値を設定する必要があります
反復	Iostat の反復回数を設定します。間隔パラメータを使用している場合は、この値を設定する必要があります。
ファイル名	出力をファイルにリダイレクトします。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils iothrottle

このコマンドを使用すると、サーバーの IO スロットリングを管理および監視できます。

utils iothrottle {有効化 | 無効化 | ステータス}

構文の説明


パラメータ	説明
有効にする	I/O スロットリング拡張機能を有効化すると、アクティブシステムでのアップグレードの影響が軽減されます。
無効にする	I/O スロットリング拡張機能を無効化します。
状態	I/O スロットリング拡張機能のステータスを表示します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

I/0 スロットル拡張機能を無効にすると、アップグレード中にシステムに悪影響を与える可能性があります。

要件

コマンド権限レベル: 1 で有効および無効、0 でステータス

utils itl reset

このコマンドは、エンドポイントが構成ファイルを検証できない場合に使用されます。

utils itl reset {ローカルキー | リモートキー}

構文の説明


ローカルキー	パブリッシャー上の既存の ITL ファイルを取得して、新しい ITL ファイルを生成します。このコマンドは、その ITL ファイルの署名を置き換え、CallManager 証明書キーを使用して新しい ITL ファイルに署名します。
リモートキー	リモートロケーションから回復証明書のキーペアを含む PKCS 12 バッグを取り込んだ後、新しい ITL ファイルを生成します。次に、新しく生成された ITL ファイルに回復秘密キーを使用して署名します。 remotekey には次のパラメータがあります。 IP アドレスまたはホスト名ユーザー ID（User ID） ITL リカバリ.p12

コマンドモード

管理者 (admin:)

使用上のガイドライン

（注）

このコマンドは、パブリッシャーノードで実行する必要があります。

要件

コマンド権限レベル: 4

アップグレード中の可能: なし

適用対象:

例

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 アドレスを使用するようにシステムを設定します

コマンドモード

管理者 (admin:)

使用上のガイドライン

utils ldap config fqdn：このコマンドは LDAP 認証に適していますが、システムに DNS が設定されている場合にのみこのコマンドを使用できます。システムが DNS を使用するように設定されていない場合は、 utils ldap config ipaddr を使用します。
utils ldap config ipaddr：このコマンドは推奨されません。システムが DNS を使用するように設定されていない、または設定できない場合にのみ使用してください。システムが DNS を使用するように設定されている場合は、 utils ldap config fqdn を使用してください。

要件

コマンド権限レベル: 1

適用対象: Unified Communications Manager および Cisco Unity Connection

utils ldap config status

このコマンドは、utils ldap 構成ステータスを表示します。

utils ldap config ステータス

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中に許可: はい

utils managementAgent alarms minpushLevel

プッシュ通知が有効になっている場合は、このコマンドを実行して、Unified Communications Manager が Cisco クラウドにプッシュ通知アラームを送信する最小アラーム重大度を設定します。

utils managementAgent alarms minpushLevel重大度

構文の説明


パラメータ	説明
`重大度`	この値は、Unified Communications Manager が Cisco クラウドにプッシュ通知アラームを送信する最小のアラーム重大度を表します。可能なオプションは次のとおりです。クリティカル（Critical）エラー（これがデフォルトです）警告通知（Notice）情報

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager および IM and Presence Service

utils managementAgent alarms pushfrequency

プッシュ通知が有効になっている場合は、このコマンドを実行して、Unified Communications Manager が Cisco クラウドにプッシュ通知アラームを送信する間隔を設定します。

utils managementAgent alarms pushfrequency分

構文の説明


パラメータ	説明
`分`	アップロード頻度（分単位）。この値は 5 ～ 90 の整数で、デフォルトは 30 分です。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager および IM and Presence Service

utils managementAgent alarms pushnow

プッシュ通知が有効になっている場合は、このコマンドを実行すると、次回のスケジュールされたアップロードを待たずに、プッシュ通知アラームがすぐに Cisco クラウドに送信されます。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager および IM and Presence Service

utils network arp delete

このコマンドは、アドレス解決プロトコルテーブル内のエントリを削除します。

utils network arp delete ホスト

構文の説明


パラメータ	説明
`ホスト`	(オプション) テーブルから削除するホストのホスト名または IP アドレスを表します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中の許可: はい

適用先: Unified Communications Manager、Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection。

削除例

admin:utils network arp delete myhost

utils network arp set

このコマンドは、アドレス解決プロトコルテーブルにエントリを設定します。

utils network arp set {ホスト} {addr}

構文の説明


パラメータ	説明
`ホスト`	テーブルに追加するホストのホスト名または IP アドレスを表します。
`addr`	追加するホストのハードウェアアドレス (MAC) を次の形式で表します: XX:XX:XX:XX:XX:XX

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中の許可: はい

適用先: Unified Communications Manager、Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection。

設定例

admin:utils network arp set myhost 11:22:33:44:55:66

utils network arp list

このコマンドは、アドレス解決プロトコルテーブルの内容を一覧表示します。

utils network arp list ホスト hostname [オプション]

構文の説明


パラメータ	説明
ホスト
`ホスト名`
`オプション`	（オプション）ページ、数値ページ: 出力を 1 ページずつ表示するために一時停止します。数値: ホストをドット区切りの IP アドレスとして表示します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

フラグ列では、C = キャッシュ済み、M = 永続的、P = 公開済みです。

要件

コマンド権限レベル: 0

アップグレード中に許可: はい

適用先: Unified Communications Manager、Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection。

リストの例

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 パケットをキャプチャします。

構文の説明


パラメータ	説明
eth0	イーサネットインターフェイス 0 を指定します。
`page`	(オプション)出力を一度に 1 ページずつ表示します。ページまたはファイルのオプションを使用する場合、コマンドが完了する前に、要求されたすべてのパケットの完全なキャプチャが行われる必要があります。
`数値`	（任意）ホストをドット付き IP アドレスとして表示します。
ファイル `fname`	(オプション)情報をファイルに出力します。ファイルオプションでは、情報を platform/cli/fname.cap に保存します。ファイル名に "."（ピリオド）を含めることはできません。
count`num`	(オプション)キャプチャするパケットの数を設定します。画面出力の場合、最大カウントは 1000 に等しく、ファイル出力の場合、最大カウントは 10,000 に等しくなります。
size`bytes`	(オプション)キャプチャするパケットのバイト数を設定します。画面出力の場合、最大バイト数は 128 に等しく、ファイル出力の場合、最大バイト数は 262144 バイトまたは ALL のいずれかです。
src`addr`	(オプション)パケットの送信元アドレスをホスト名または IPV4 アドレスとして指定します。
dest`addr`	(オプション)パケットの宛先アドレスをホスト名または IPV4 アドレスとして指定します。
port`num`	(オプション)パケットのポート番号 (送信元または宛先) を指定します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中の許可: はい

適用先: Unified Communications Manager、Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection。

utils network capture-rotate

このコマンドは、utils network capture で制限されている 100,000 パケットを超える IP パケットをキャプチャします。

utils network capture-rotate {ファイル | fname} [サイズ | バイト] [ファイルあたりのサイズ| メガバイト] {最大ファイル数 | | num} [ソース | addr] [目的地 | addr] [port | 番号] [ホストプロトコル | addr]

構文の説明

パラメータ

説明

filefname

情報をファイルに出力します。

（注）

ファイルは platform/cli/fname に保存されます。fname には「.」文字を含めることはできません。

サイズバイト

キャプチャするパケットのバイト数。有効な値には、最大 65535 までの任意の数値または ALL が含まれます。既定は ALL です。

sizePerFilemegabytes

sizePerFile はログファイルのサイズの値を設定します。（単位は百万バイトです。） sizePerFile のデフォルト値は 25 MB です。

maxFilesnum

maxFiles は作成されるログファイルの最大数を示します。 maxFiles のデフォルト値は 10 です。

srcaddr

(オプション) パケットの送信元アドレスをホスト名または IPV4 アドレスとして指定します。

宛先アドレス

(オプション) パケットの宛先アドレスをホスト名または IPV4 アドレスとして指定します。

ポート番号

(オプション) パケットの送信元または宛先のポート番号を指定します。

ホスト プロトコルアドレス

(オプション) キャプチャを特定のホストとの間のトラフィックに制限します。 protocol のオプションは IP、arp、rarp、all で、 addr は IPv4 またはホスト名の形式である必要があります。 host が使用される場合は、 src または destを指定しないでください。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection。

utils network connectivity

このコマンドは、クラスター内の最初のノード (この接続は後続のノードでのみ有効) およびリモートノードへのノードネットワーク接続を確認します。

utils network connectivity [リセット] [ホスト名/IP アドレス]

utils network connectivity [ホスト名/IP アドレス] [ポート番号] [タイムアウト]

構文の説明


パラメータ	説明
接続性	このコマンドは、クラスターの最初のノードへのノードネットワーク接続を確認します。また、リモートノードへの接続を確認するためにも使用されます。この場合、必須パラメータが 2 つあります。ホスト名/IP アドレスとポート番号。
リセット	(オプション) 以前の戻りコードをクリアします。
`ホスト名/IP アドレス`	(オプション) パブリッシャーまたは最初のノードとのネットワーク接続を確認するためのクラスターノードのホスト名または IP アドレス。 (必須) リモートサーバのネットワーク接続を確認するために、TCP 接続をテストする必要があるホストのホスト名または IP アドレス。
ポート番号	(必須) 接続テストを必要とするホストのポート番号。
`タイムアウト`	(オプション) ポート接続メッセージが表示されるまでの時間を秒単位で指定します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

utils network connectivity [ reset] [hostname/ip address] コマンドは、パブリッシャーまたは最初のノードへのネットワーク接続を確認するために使用されます。
utils network connectivity [ ホスト名/IP アドレス] [ ポート番号] [タイムアウト] コマンドは、リモートサーバへのネットワーク接続を確認するために使用されます。

要件

コマンド権限レベル: 0

アップグレード中に許可: はい

適用先: Unified Communications Manager、Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection。

utils network host

このコマンドは、ホスト名をアドレスに、またはアドレスをホスト名に解決します。

utils network host name [server | serv] [ページ] [詳細] [srv]

構文の説明


パラメータ	説明
`名前`	解決するホスト名または IP アドレスを表します。
`serv`	（任意）代替のドメインネームサーバーを指定します。
[ページ]	（オプション）出力を 1 画面ずつ表示します。
[詳細]	(オプション) 詳細なリストを表示します。
[srv]	(オプション) DNS SRV レコードを表示します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中に許可: はい

適用先: Unified Communications Manager、Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection。

utils network ipv6 host

このコマンドは、指定されたホスト名または IPv6 アドレスの IPv6 ホストルックアップ (または IPv6 アドレスルックアップ) を実行します。

utils network ipv6 host {ホスト名 | ipv6_アドレス}

構文の説明


パラメータ	説明
`ホスト名`	サーバの名前を指定します。
`ipv6_address`	サーバの IPv6 アドレスを指定します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中の許可: はい

適用対象: Unified Communications Manager および Cisco Unity Connection。

utils network ipv6 traceroute

このコマンドは、IPv6 アドレスまたはホスト名をトレースします。

utils network ipv6 traceroute [ipv6-address | hostname]

構文の説明


パラメータ	説明
`ipv6-address`	トレースする IPv6 アドレスを指定します。
`ホスト名`	トレースするホスト名を指定します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中に許可: はい

適用対象: Unified Communications Manager および Cisco Unity Connection。

utils network ipv6 ping

このコマンドを使用すると、IPv6 アドレスまたはホスト名を ping できます。

utils network ipv6 ping destination [カウント]

構文の説明


パラメータ	説明
`destination`	Ping する有効な IPv6 アドレスまたはホスト名を指定します。
`[カウント]`	外部サーバに ping を実行する回数を指定します。デフォルトのカウントは 4 です。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中に許可: はい

適用対象: Unified Communications Manager および Cisco Unity Connection。

utils network ping

このコマンドを使用すると、別のサーバに ping を実行できます。

utils network ping destination [カウント] [サイズ]

構文の説明


パラメータ	説明
`destination`	Ping するサーバの IP アドレスまたはホスト名を表します。
`[カウント]`	外部サーバに ping を実行する回数を指定します。デフォルトの回数は 4 です。
`[サイズ]`	PING パケットのサイズをバイト単位で指定します。デフォルト値は 56 です。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中に許可: はい

適用先: Unified Communications Manager、Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection。

utils network traceroute

このコマンドは、リモートの宛先に送信される IP パケットをトレースします。

utils network traceroute [destination]

構文の説明


パラメータ	説明
`destination`	トレースを送信するサーバのホスト名または IP アドレスを表します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中の許可: はい

適用先: Unified Communications Manager、Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection。

utils network name-service {hosts|services} cache invalidate

このコマンドは、ネームサービスキャッシュをクリアします。

utils network name-service {ホスト\サービス} [cache invalidate]

構文の説明


パラメータ	説明
ホスト	ホストサービスキャッシュ
サービス	サービスのサービスキャッシュ

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

キャッシュをフラッシュ/クリアするための次の例を検討してください。

admin:utils network name-service hosts cache invalidate 
admin:
Successful

utils ntp auth symmetric-key

utils ntp auth 対称鍵 {有効化 | 無効化 | ステータス}

このコマンドは、選択した NTP サーバの認証を有効または無効にするのに役立ちます。認証は対称キー ID とキーに基づいています。対称キーは、Unified Communications Manager に暗号化された形式で保存されます。

（注）

このコマンドを実行する前に、NTP サーバのキー ID とそれに対応するキーがわかっていることを確認してください。

構文の説明


パラメータ	説明
有効化	利用可能なサーバのリストから NTP サーバの 1 つを選択し、認証を有効にします。
無効にする	利用可能なサーバのリストから NTP サーバの 1 つを選択し、認証を無効にします。
ステータス	リストされているすべての NTP サーバの認証ステータスを表示します。

使用上のガイドライン

NTP サーバの認証用に KeyID または対称キーを入力するよう求められます。

（注）

Unified Communications Manager は、NTP サーバの認証ステータスが変更されると、Syslog アラートメッセージを送信します。 TLS を使用して Syslog サーバへの接続を保護できます。
Unified Communications Manager をインストールした後、NTP サーバ認証を設定できます。

要件

コマンド権限レベル: レベル 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 自動キー {有効化 | 無効化 | ステータス}

このコマンドは、選択した 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 以上が必要です。

構文の説明


パラメータ	説明
有効化	利用可能なサーバのリストから NTP サーバの 1 つを選択し、認証を有効にします。
無効にする	PKI 認証が有効な NTP サーバのリストから NTP サーバの 1 つを選択し、認証を無効にします。
ステータス	リストされているすべての NTP サーバの認証ステータスを表示します。

使用上のガイドライン

NTP 認証を有効にすると、NTP サーバの認証用に IFF クライアントキーを入力するように求められます。クライアントキーが正常にアップロードされると、Unified Communications Manager パブリッシャノード上の NTP サービスが再起動されます。 Unified Communications Manager と NTP サーバー間の認証が有効化されていることを示します。

（注）

Unified Communications Manager をインストールまたはアップグレードした後、NTP サーバ認証を設定できます。
CLI 実行中に "Ctrl-C" キーを押して実行を終了しないでください。

要件

コマンド権限レベル: レベル 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 サービスが再起動されなくなります。

コマンドモード

管理者 (admin:)

使用上のガイドライン

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 サーバを削除します。

utils ntp server delete

コマンドモード

管理者 (admin:)

使用上のガイドライン

このコマンドを使用すると、構成されたネットワークタイムプロトコル (NTP) サーバまたは複数の NTP サーバを削除できます。削除するサーバを選択すると、NTP サービスを再起動するかどうかを指定するように求められます。いいえを選択した場合、サーバの削除後に NTP サービスは再起動されません。

（注）

少なくとも 1 つの NTP サーバを設定する必要があります。したがって、NTP サーバが 1 つしか設定されていない場合は、その NTP サーバを削除することはできません。すべての 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) にする必要があります。

utils ntp config

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中に許可: はい

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service、Cisco Unity Connection

utils ntp restart

このコマンドは NTP サービスを再起動します。

utils ntp 再起動

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中に許可: はい

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils ntp server list

このコマンドはすべての NTP サーバを一覧表示します。

utils ntp server list

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中に許可: はい

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service

utils ntp start

このコマンドは、NTP サービスがまだ実行されていない場合に NTP サービスを開始します。

（注）

コマンドラインインターフェイスから NTP サービスを停止することはできません。 utils ntp status コマンドが停止（stopped）を返す場合は、このコマンドを使用します。

utils ntp start

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中に許可: はい

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils ntp status

このコマンドは、NTP の現在のステータスを表示します。

utils ntp status

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル:

アップグレード中に許可されるもの:

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service。

utils os kerneldump

このコマンドは、カーネルクラッシュダンプメカニズムを提供するように kerneldump を構成します。カーネルは、カーネルクラッシュが発生した場合にダンプをローカルディスクにキャプチャします。

（注）

netdump コマンドは、リリース 8.6(1) から削除され、kerneldump コマンドに置き換えられました。

utils os kerneldump {有効にする | 無効にする}

コマンドモード

管理者 (admin:)

使用上のガイドライン

カーネルクラッシュが発生した場合、キャプチャカーネルはサーバのローカルディスクにコアをダンプします。プライマリカーネルは、キャプチャカーネルが起動に使用する 128 MB の物理メモリを予約します。カーネルダンプは、カーネルがクラッシュするたびに、 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 サーバを有効化、無効化、またはステータスを表示します。

utils os kerneldump ssh {有効化 | 無効化 | ステータス}

構文の説明


パラメータ	説明
有効化	外部 SSH サーバーをカーネルダンプサーバーとして設定し、カーネルダンプを処理します。
無効にする	カーネルダンプを収集するように構成された外部 SSH サーバのサポートを削除します。
ステータス	カーネルダンプを収集するために外部 SSH サーバが構成されているかどうかを示します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

外部 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

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中の可能: なし

適用対象: Unified Communications Manager、Unified Communications Manager の IM およびプレゼンスサービス、および Cisco Unity Connection

utils os secure

このコマンドは、selinux によって提供されるセキュリティレベルを指定するために使用されます。

utils os secure {enforce | permissive | status}

構文の説明


パラメータ	説明
enforce
permissive
ステータス

コマンドモード

管理者 (admin:)

使用上のガイドライン

Selinux はレート制限を処理しないことに注意してください。レート制限は、ipprefs と IP テーブルによって処理されます。

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service

utils os secure dynamic-policies compile

このコマンドは、動的ポリシーの下で記録された拒否を解決する selinux ポリシーモジュールと型強制を生成します。

utils os secure dynamic-policies compile ポリシー名

構文の説明


パラメータ	説明
`ポリシー名`	selinux ポリシーモジュールのコンパイルと型強制が行われる動的ポリシー名を入力します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用対象: Unified Communications Manager および Unified Communications Manager 上の IM およびプレゼンスサービス

utils os secure dynamic-policies list

このコマンドは、すべてのオペレーティングシステムの動的ポリシーとそのステータスを一覧表示します。

utils os secure dynamic-policies list

コマンドモード

管理者 (admin:)

使用上のガイドライン

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager および Unified Communications Manager の IM and Presence Service

utils os secure dynamic-policies load

このコマンドは、動的ポリシーの selinux ポリシーモジュールを selinux にロードします。このコマンドは、動的ポリシーで記録された拒否が再発するのを防ぐ新しいルールを selinux に適用します。

utils os secure dynamic-policies load ポリシー名

構文の説明


パラメータ	説明
`ポリシー名`	selinux にロードされていない、生成された selinux ポリシーモジュールを持つ動的ポリシー名を入力します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用対象: Unified Communications Manager および Unified Communications Manager 上の IM およびプレゼンスサービス

utils os secure dynamic-policies remove

このコマンドは、オペレーティングシステムから動的ポリシーのすべてのデータを削除します。データには、selinux からのポリシーモジュールのアンロード、生成されたポリシーモジュール、型強制、記録された拒否、およびデルタログの削除が含まれます。

utils os secure dynamic-policies remove ポリシー名

構文の説明


パラメータ	説明
`ポリシー名`	不要または完全に不要になった動的ポリシー名を入力します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用対象: Unified Communications Manager および Unified Communications Manager 上の IM およびプレゼンスサービス

utils os secure dynamic-policies show

このコマンドは、動的ポリシーの生成された selinux ポリシーモジュールをロードすることによって導入されるルールを表示します。コンパイルが成功したらこのコマンドを実行して、ロードされるルールが安全であることを確認します。

utils os secure dynamic-policies show ポリシー名

構文の説明


パラメータ	説明
`ポリシー名`	ルールを表示する動的ポリシー名を入力します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

要件

コマンド権限レベル: 1

アップグレード中の許可: はい

適用対象: Unified Communications Manager および Unified Communications Manager 上の IM およびプレゼンスサービス

utils os secure dynamic-policies start-recording

このコマンドは、selinux 拒否の記録を開始し、それらを新しい動的ポリシーの下に整理します。

（注）

このコマンドは、システムを許可モードに設定します。
動的ポリシーはノードごとに生成されます。制限として、これらのポリシーはエクスポートまたはインポートできません。この制限には次の利点があります。
- セキュリティ上の脆弱性を引き起こす可能性のある外部および署名されていないポリシーモジュールが selinux に読み込まれるのを防ぎます。
- 異なる設定を持つ Unified Communications Manager クラスタ間でのポリシーモジュールの転送を防止します。

utils os secure dynamic-policies start-recording ポリシー名

構文の説明


パラメータ	説明
`policy name`	selinux 拒否と将来のポリシーデータが整理される動的ポリシー名を入力します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager および Unified Communications Manager の IM and Presence Service

utils os secure dynamic-policies stop-recording

このコマンドは、動的ポリシーの selinux 拒否の記録を停止します。このコマンドは、システムを元の強制モード（許可モードまたは強制モード）に戻します。このログは、記録の開始から終了までの間に発生したすべての selinux 拒否のデルタログを生成します。

（注）

デルタログに新しい拒否がない場合、このコマンドは失敗します。その後、動的ポリシーは消去され、このコマンドを再度使用する必要があります。

utils os secure dynamic-policies stop-recording ポリシー名

構文の説明


パラメータ	説明
`ポリシー名`	記録を停止する動的ポリシー名を入力します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用対象: Unified Communications Manager および Unified Communications Manager 上の IM およびプレゼンスサービス

utils PlatformWebAccess disable

SSO が有効な場合に、Cisco OS 管理およびディザスタリカバリシステムアプリケーションへのユーザサインインを制限するには、このコマンドを使用します。

utils PlatformWebAccess disable

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 4

アップグレード中の許可: はい

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service、Cisco Unity Connection

Utils PlatformWebAccess を有効にする

このコマンドを使用して、Cisco OS 管理およびディザスタリカバリシステムアプリケーションへのユーザサインインを有効にします。

utils PlatformWebAccess を有効にする

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 4

アップグレード中に許可: はい

適用対象: Unified Communications Manager、 Unified Communications Manager の IM およびプレゼンスサービス、および Cisco Unity Connection

utils PlatformWebAccess status

このコマンドを使用して、システムの Web アクセスのステータス（Cisco OS 管理およびディザスタリカバリシステムアプリケーションに対してプラットフォームの Web アクセスが有効になっているか無効になっているか）を表示します。

utils PlatformWebAccess ステータス

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 4

アップグレード中に許可: はい

適用対象: Unified Communications Manager、 Unified Communications Manager の IM およびプレゼンスサービス、および Cisco Unity Connection

utils processCoreDumps disable

このコマンドは、プロセスのコアダンプを無効にします。

utils processCoreDumps を無効にする

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、Unified Communications Manager の IM およびプレゼンスサービス、Cisco Unity Connection

utils processCoreDumps enable

このコマンドは、プロセスのコアダンプを有効にします。

utils processCoreDumps enable

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service、Cisco Unity Connection

utils processCoreDumps status

このコマンドは、kdump サービスのステータスを表示します。

utils processCoreDumps status

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中の可能: なし

適用対象: Unified Communications Manager、Unified Communications Manager の IM およびプレゼンスサービス、Cisco Unity Connection

utils remote_account create

このコマンドはリモートアカウントを作成します。

utils remote_account create

コマンドモード

管理者 (admin:)

使用上のガイドライン

リモートアカウントは、指定されたアカウントの有効期間中、Cisco Systems のサポート担当者がシステムにアクセスできるようにするパスフレーズを生成します。

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service、Cisco Unity Connection

utils remote_account disable

このコマンドを使用すると、リモートアカウントを無効にすることができます。

utils remote_account を無効にする

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils remote_account enable

このコマンドを使用すると、リモートアカウントを有効にすることができます。

utils リモートアカウントを有効にする

コマンドモード

管理者 (admin:)

使用上のガイドライン

一度に有効にできるリモートアカウントは 1 つだけです。

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils remote_account status

このコマンドを使用すると、リモートアカウントのステータスを確認できます。

utils remote_account status

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中に許可: はい

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils remotesyslog set protocol tcp

このコマンドは、システム上のリモート syslog サーバとの通信プロトコルを TCP に設定します。変更を有効にするには、ノードを再起動します。

utils remotesyslog set protocol tcp

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 4

アップグレード中の可能: なし

適用対象: Unified Communications Manager、Unified Communications Manager の IM およびプレゼンスサービス、Cisco Unity Connection

utils remotesyslog set protocol udp

このコマンドは、システム上のリモート syslog サーバとの通信プロトコルを UDP として設定します。変更を有効にするには、ノードを再起動します。

utils remotesyslog set protocol udp

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 4

アップグレード中の可能: なし

適用対象: Unified Communications Manager、Unified Communications Manager の IM およびプレゼンスサービス、Cisco Unity Connection

utils remotesyslog set protocol tls

このコマンドは、システム上でリモート syslog サーバとの通信プロトコルをトランスポート層セキュリティ (TLS) 1.2 に設定します。 TLS により、Unified Communications Manager と IM and Presence Service は syslog サーバとの安全な接続を確立できるようになります。これにより、Unified Communications Manager と IM and Presence Service は Common Criteria ガイドラインに準拠できます。

（注）

syslog サーバーが最低限の TLS バージョン（1.2 ）をサポートしていることを確認します。
コモンクライテリアモードでは、厳密なホスト名検証が使用されます。そのため、証明書と一致する完全修飾ドメイン名（FQDN）でサーバーを設定する必要があります。

変更を有効にするには、ノードを再起動します。

utils remotesyslog set protocol tls

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 4

アップグレード中の可能: なし

適用対象: Unified Communications Manager および Unified Communications Manager 上の IM およびプレゼンスサービス

セキュリティ証明書を syslog サーバーから Unified Communications Manager と IM and Presence Service の tomcat 信頼ストアにアップロードする必要があります。

utils remotesyslog show protocol

このコマンドは、システム上のリモート syslog サーバとの通信プロトコルが TCP か UDP かを表示します。

utils remotesyslog show protocol

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中の可能: なし

適用対象: Unified Communications Manager、Unified Communications Manager の IM およびプレゼンスサービス、Cisco Unity Connection

utils reset_application_ui_administrator_name

このコマンドは、アプリケーションユーザインターフェイスの管理者名をリセットします。

utils reset_application_ui_administrator_name

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

Utils reset_application_ui_administrator_password

このコマンドは、アプリケーションユーザインターフェイスの管理者パスワードをリセットします。

（注）

IM and Presence ノードのパスワードを変更する場合は、管理者パスワードをリセットする前に、すべての IM and Presence ノードの Cisco Presence Engine サービスを停止します。パスワードをリセットした後、すべてのノードで Cisco Presence Engine サービスを再起動します。 PE が停止されるとプレゼンスの問題が発生する可能性があるため、このタスクはメンテナンス中に実行してください。 IM およびプレゼンスノードからパスワードを変更する場合は、新しいパスワードが Unified Communication Manager の現在の管理者パスワードと同じであることを確認してください。

utils reset_application_ui_administrator_password

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils restore_application_ui_administrator_account

このコマンドは、アプリケーションユーザインターフェイス管理者アカウントを復元します。

utils restore_application_ui_administrator_account

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、Unified Communications Manager の IM およびプレゼンスサービス、Cisco Unity Connection

utils rosters list limited

無効なウォッチャーと無効なコンタクトの数を取得するには、データベースパブリッシャーノードでこのコマンドを実行します。合計数は CLI に表示されます。

コマンドモード

管理者 (admin:)

使用上のガイドライン

このコマンドはメンテナンス期間中にのみ実行することをお勧めします。このコマンドは無効なレコードの数のみをリストし、詳細はリストしません。無効なレコードの詳細については、 utils rosters list [ watchers | contacts | full ] を試してください。

要件

コマンド権限レベル: 4

アップグレード中の可能: なし

適用対象: IM およびプレゼンスサービス

utils rosters list full

このコマンドをデータベースパブリッシャーノードで実行すると、すべての無効なウォッチャーと無効な連絡先の詳細がファイルに書き込まれます。このコマンドは、CLI で合計数も表示します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

このコマンドはメンテナンス期間中にのみ実行することをお勧めします。

要件

コマンド権限レベル: 4

アップグレード中の可能: なし

適用対象: IM およびプレゼンスサービス

utils rosters list watchers

データベースパブリッシャーノードでこのコマンドを実行すると、クラスター内のすべての無効なウォッチャーの詳細がファイルに書き込まれます。無効な連絡先の合計数も CLI に表示されます。

コマンドモード

管理者 (admin:)

使用上のガイドライン

このコマンドは、メンテナンスウィンドウ中にのみ実行することをお勧めします。実行中は、進行状況が CLI とログファイルに表示されます。

要件

コマンド権限レベル: 4

アップグレード中の可能: なし

適用対象: IM およびプレゼンスサービス

utils rosters list contacts

データベースパブリッシャーノードでこのコマンドを実行すると、クラスター内のすべての無効な連絡先の詳細がファイルに書き込まれます。無効な連絡先の合計数も CLI に表示されます。

コマンドモード

管理者 (admin:)

使用上のガイドライン

このコマンドはメンテナンス期間中にのみ実行することをお勧めします。

要件

コマンド権限レベル: 4

アップグレード中の可能: なし

適用対象: IM およびプレゼンスサービス

utils rosters delete

IM and Presence クラスタ内のすべての無効なウォッチャと無効な連絡先を削除するには、データベースパブリッシャノードでこのコマンドを実行します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

このコマンドは、メンテナンスウィンドウ中にのみ実行することをお勧めします。実行中は、進行状況が CLI とログファイルに表示されます。

要件

コマンド権限レベル: 4

アップグレード中の可能: なし

適用対象: IM およびプレゼンスサービス

utils sipOAuth-mode

このコマンドは、クラスター内の SIP OAuth モードを有効/無効にするために使用されます。有効にすると、Unified Communications Manager は、SIP OAuth 登録モードを使用するように設定された安全なデバイスからの OAuth トークンを使用した SIP 登録を受け入れます。

utils sipOAuth-mode {有効にする | 無効にする}

コマンドモード

管理者 (admin:)

使用上のガイドライン

（注）

このコマンドは、Unified Communication Manager パブリッシャーノードでのみ実行する必要があります。

SIPOauth モードを有効化/無効化した後、Cisco CallManager サービスが実行されているクラスタ内のすべてのノードで Cisco CallManager サービスを再起動する必要があります。

要件

コマンド権限レベル: 4

アップグレード中に許可: はい

適用対象: Unified Communications Manager

例

admin:utils sipOAuth-mode enable
SIP OAuth mode enabled.
Please restart the Cisco CallManager service on all nodes in the cluster where it is running.

例

admin:utils sipOAuth-mode disable
SIP OAuth mode disabled.
Please restart the Cisco CallManager service on all nodes in the cluster where it is running.

utils scheduled-task disable

このコマンドは、スケジュールされたタスクを無効にします。

utils scheduled-task disable スケジュールされたタスク

構文の説明


パラメータ	説明
スケジュールされたタスク	無効にする必要があるタスクの名前を入力します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service、Cisco Unity Connection

utils scheduled-task enable

このコマンドは、スケジュールされたタスクを有効にします。

utils scheduled-task enable スケジュールされたタスク

構文の説明


パラメータ	説明
スケジュールされたタスク	有効にする必要があるタスクの名前を入力します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service、Cisco Unity Connection

utils scheduled-task list

このコマンドは、スケジュールされたすべてのタスクを一覧表示します。

utils scheduled-task list

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中の可能: なし

適用対象: Unified Communications Manager、Unified Communications Manager の IM およびプレゼンスサービス、Cisco Unity Connection

utils set urlpattern disable

このコマンドは、URL パターンを無効にし、 zzz20_product_profile.sh ファイルを変更します。 URL パターンが無効にされた後、このコマンドは次の行を追加します。

export TOMCAT_EXCLUDE_URLPATTERNS="/ucmuser"

utils set urlpattern disable

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、Unified Communications Manager の IM およびプレゼンスサービス、Cisco Unity Connection

utils set urlpattern enable

このコマンドは、URL パターンを有効にし、 zzz20_product_profile.sh ファイルを変更します。 URL パターンが有効になると、このコマンドは次の行を追加します。

export TOMCAT_EXCLUDE_URLPATTERNS=""

utils set urlpattern enable

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service、Cisco Unity Connection

utils service

このコマンドは、サービスをアクティブ化、非アクティブ化、開始、停止、または再起動します。

utils service {アクティブ化 | 非アクティブ化 | 開始 | 停止 | 再起動} サービス名

構文の説明

パラメータ

説明

サービス名

影響を与えるサービスの名前を表します。例:

システム NTP
システム SSH
サービスマネージャー
Cisco DB
Cisco Database Layer Monitor
Cisco Unified Serviceability

このリストは網羅的なものではありません。ノードのサービスの完全なリストを表示するには、次のコマンドを入力します: utils service list

（注）

スタンドアロン Cisco Prime License Manager の Cisco Tomcat サービスを再起動する場合は、次のコマンドを実行するか、サーバを再起動します: utils service restart Cisco Prime LM Server。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils service list

このコマンドは、すべてのサービスのリストを取得します。

utils service list [ページ]

構文の説明


パラメータ	説明
[ページ]	出力を一度に 1 ページずつ表示します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中の可能: なし

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service

utils service auto-restart

このコマンドは、指定されたサービスを開始または停止します。

utils service auto-restart {有効にする | 無効にする | 表示} サービス名

構文の説明


パラメータ	説明
有効化	自動再起動を開始します。
無効にする	自動再起動を停止します。
show	サービスのステータスを表示します。
`サービス名`	開始、停止、または表示するサービスの名前を表します。システム NTP システム SSH サービスマネージャー Cisco DB Cisco Tomcat Cisco Database Layer Monitor Cisco Unified Serviceability

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

utils service start

このコマンドはサービスを開始します。

utils サービス 開始

構文の説明


パラメータ	説明
`サービス`	複数の単語で構成できるサービスの名前を入力します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service、Cisco Unity Connection

utils service stop

このコマンドはサービスを停止します。

utils サービス 停止

構文の説明


パラメータ	説明
`サービス`	複数の単語で構成できるサービスの名前を入力します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、Unified Communications Manager 上の IM およびプレゼンスサービス、および Cisco Unity Connection

utils snmp config 1/2c community-string

この対話型コマンドは、コミュニティ文字列を追加、削除、一覧表示、または更新します。

utils snmp config 1/2c コミュニティ文字列 {追加 | | delete | | list | | 更新}

構文の説明


パラメータ	説明
追加	新しいコミュニティ文字列を追加します。
delete	コミュニティ文字列を削除します。
list	すべてのコミュニティ文字列を一覧表示します。
更新	コミュニティ文字列を更新します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

システムはパラメータの入力を要求します。

構成の変更を有効にするために、SNMP マスターエージェントサービスが再起動されます。実行後、再起動が完了するまでコマンドを中止しないでください。サービスの再起動中にコマンドが中止された場合は、 utils service list を使用して「SNMP マスターエージェント」のサービスステータスを確認してください。サービスがダウンしている場合は、 utils service start SNMP Master Agent を使用して起動します。

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service、Cisco Unity Connection

utils snmp config 1/2c inform

この対話型コマンドは、インフォーム通知の宛先を追加、削除、リスト、または更新します。

utils snmp config 1/2c inform {追加 | | 消去 | | リスト | | 更新}

構文の説明


パラメータ	説明
追加	通知先を追加します。
delete	通知先を削除します。
リスト	すべての通知先を一覧表示します。
更新	通知先を更新します。

コマンドモード

管理者 (admin:)

要件

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service、Cisco Unity Connection

utils snmp config 1/2c trap

この対話型コマンドはトラップ通知に影響します。

utils snmp config 1/2c trap {追加 | 削除 | リスト | 更新}

構文の説明


パラメータ	説明
追加	設定された v1/2c コミュニティ文字列に関連付けられた新しい v1/2c トラップ通知の宛先を追加します。
delete	既存の v1/2c トラップ通知先の構成情報を削除します。
list	現在設定されている v1/2c トラップ通知を一覧表示します。
更新	既存の v1/2c トラップ通知先の構成情報を更新します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の許可: はい

適用対象: Unified Communications Manager および Cisco Unity Connection

utils snmp config 3 inform

この対話型コマンドは、v3 インフォーム通知に影響します。

utils snmp config 3 inform {追加 | | 消去 | | list | | 更新}

構文の説明


パラメータ	説明
追加	設定された v3 ユーザ名に関連付けられた新しい v3 インフォーム通知の宛先を追加します。
消去	既存の v3 インフォーム通知先の構成情報を削除します。
list	現在設定されている v3 インフォーム通知を一覧表示します。
更新	既存の v3 インフォーム通知先の構成情報を更新します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

システムはパラメータの入力を要求します。

構成の変更を有効にするために、SNMP マスターエージェントサービスが再起動されます。実行後、再起動が完了するまでコマンドを中止しないでください。サービスの再起動中にコマンドが中止された場合は、 utils service list を使用して「SNMP マスターエージェント」のサービスステータスを確認してください。サービスがダウンしている場合は、 utils service start SNMP Master Agent を使用して起動します。

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service、Cisco Unity Connection

utils snmp config mib2

この対話型コマンドは、Mib2 構成情報に影響します。

utils snmp config mib2 {追加 | | 消去 | | list | | 更新}

構文の説明


パラメータ	説明
追加	Mib2 構成情報を追加します。
delete	Mib2 構成情報を削除します。
list	Mib2 構成情報を一覧表示します。
更新	Mib2 構成情報を更新します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

システムはパラメータの入力を要求します。

要件

コマンド権限レベル: 0

アップグレード中の許可: はい

適用対象: Unified Communications Manager、IM およびプレゼンスサービス Unified Communications Manager、Cisco Unity Connection

utils snmp config 3 trap

この対話型コマンドはトラップ通知に影響します。

utils snmp config 3 トラップ {追加 | | 消去 | | list | | 更新}

構文の説明


パラメータ	説明
追加	設定された v3 ユーザ名に関連付けられた新しい v3 トラップ通知の宛先を追加します。
消去	既存の v 3 トラップ通知先の構成情報を削除します。
list	現在設定されている v3 トラップ通知を一覧表示します。
更新	既存の v3 トラップ通知先の構成情報を更新します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

システムはパラメータの入力を要求します。

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service、Cisco Unity Connection

utils snmp config 3 user

この対話型コマンドは、v3 ユーザ構成に影響します。

utils snmp config 3 user {追加 | | 消去 | | リスト | | 更新}

構文の説明


パラメータ	説明
追加	v3 認証とプライバシーパスワードを持つ新しい v3 ユーザを追加します。
delete	既存の v3 ユーザの構成情報を削除します。
リスト	現在設定されている v3 ユーザを一覧表示します。
更新	既存の v3 ユーザの構成情報を更新します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

システムはパラメータの入力を要求します。

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service、Cisco Unity Connection

utils snmp get

この対話型コマンドは、指定された MIB OID の指定されたバージョンを使用して SNMP データを取得します。

utils snmp get バージョン

構文の説明


パラメータ	説明
`バージョン`	SNMP バージョンを指定します。可能な値は 1、2c、または 3 です。
`コミュニティ`	SNMP コミュニティ文字列を指定します。
`IP アドレス`	サーバの IPv4/IPv6 アドレスを指定します。ローカルホストを指定するには、127.0.0.0 と入力します。クラスター内の別のノードの IPv4/IPv6 アドレスを入力して、そのノードでコマンドを実行できます。
`object`	取得する SNMP オブジェクト ID (OID) を指定します。
`ファイル`	コマンド出力を保存するファイルを指定します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

MIB 内の特定の OID (リーフ) に対してコマンドを実行すると、MIB の値が取得されます。たとえば、システムの稼働時間を取得するには、次のようにします。 iso.3.6.1.2.1.25.1.1.0 = タイムティック: (19836825) 2 日、7:06:08.25

指定した IPv4/IPv6 アドレスリモートホストの IP アドレスを指定すると、コマンドはリモートホスト上で実行されます。

その IPv4/IPv6 アドレスが必要です。ドメイン名は使用できません。

要件

コマンド権限レベル: 1

アップグレード中の許可: はい

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service、Cisco Unity Connection

utils snmp get 1

このコマンドは、指定された MIB OID のバージョン 1 を使用して SNMP データを取得します。

utils snmp get 1 バージョン

構文の説明


パラメータ	説明
`バージョン`	SNMP バージョンを指定します。可能な値は 1、2c、または 3 です。
`コミュニティ`	SNMP コミュニティ文字列を指定します。
`IP アドレス`	サーバの IPv4/IPv6 アドレスを指定します。ローカルホストを指定するには、127.0.0.0 と入力します。クラスター内の別のノードの IPv4/IPv6 アドレスを入力して、そのノードでコマンドを実行できます。
`object`	取得する SNMP オブジェクト ID (OID) を指定します。
`ファイル`	コマンド出力を保存するファイルを指定します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用対象: Unified Communications Manager、Unified Communications Manager の IM およびプレゼンスサービス、Cisco Unity Connection

utils snmp get 2c

このコマンドは、指定された MIB OID のバージョン 2c を使用して SNMP データを取得します。

utils snmp get 2c バージョン

構文の説明


パラメータ	説明
`バージョン`	SNMP バージョンを指定します。可能な値は 1、2c、または 3 です。
`コミュニティ`	SNMP コミュニティ文字列を指定します。
`IP アドレス`	サーバの IPv4/IPv6 アドレスを指定します。ローカルホストを指定するには、127.0.0.0 と入力します。クラスター内の別のノードの IPv4/IPv6 アドレスを入力して、そのノードでコマンドを実行できます。
`object`	取得する SNMP オブジェクト ID (OID) を指定します。
`ファイル`	コマンド出力を保存するファイルを指定します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service、Cisco Unity Connection

utils snmp get 3

このコマンドは、指定された MIB OID の SNMP データを取得します。

utils snmp get 3 バージョン

構文の説明


パラメータ	説明
`バージョン`	SNMP バージョンを指定します。可能な値は 1、2c、または 3 です。
`コミュニティ`	SNMP コミュニティ文字列を指定します。
`IP アドレス`	サーバの IPv4/IPv6 アドレスを指定します。ローカルホストを指定するには、127.0.0.0 と入力します。クラスター内の別のノードの IPv4/IPv6 アドレスを入力して、そのノードでコマンドを実行できます。
`object`	取得する SNMP オブジェクト ID (OID) を指定します。
`ファイル`	コマンド出力を保存するファイルを指定します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service、Cisco Unity Connection

utils snmp hardware-agents

このコマンドは、サーバ上の SNMP エージェントに影響します。

utils snmp hardware-agents {ステータス | | 開始 | | 停止 | | 再起動}

構文の説明

パラメータ

説明

ステータス

ハードウェアのベンダーによって提供される SNMP エージェントのステータスを表示します。

（注）

このコマンドでは、ステータスを提供するエージェントのみが表示されます。すべてのハードウェアエージェントがステータスを提供するわけではありません。

停止

ハードウェアベンダーによって提供されるすべての SNMP エージェントを停止します。

再起動

ハードウェアのベンダーによって提供されたすべての SNMP エージェントを再起動します。

始める

ハードウェアのベンダーによって提供されるすべての SNMP エージェントを起動します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中の許可: はい

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service、Cisco Unity Connection

utils snmp test

このコマンドは、サンプルアラームをローカル syslog とリモート syslog に送信します。

utils snmp test

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service、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

この対話型コマンドは、指定された OID から始まります。指定されたバージョンを使用して SNMP MIB を調査します。

utils snmp walk バージョン

構文の説明


パラメータ	説明
`バージョン`	SNMP バージョンを指定します。可能な値は 1、2c、または 3 です。
`コミュニティ`	SNMP コミュニティ文字列を指定します。
`IP アドレス`	サーバの IPv4/IPv6 アドレスを指定します。ローカルホストを指定するには、127.0.0.0 と入力します。クラスター内の別のノードの IPv4/IPv6 アドレスを入力して、そのノードでコマンドを実行できます。
`object`	ウォークする SNMP オブジェクト ID（OID）を指定します
`ファイル`	コマンド出力を保存するファイルを指定します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service、Cisco Unity Connection

例

以下の例では、 utils snmp config 1/2c community-string コマンドを使用してコミュニティ文字列が作成されます。

admin:utils snmp walk 1

ctrl-c: To quit the input.


Enter the community string:: public
Enter the ip address of the Server, use 127.0.0.1 for localhost.
Note that you need to provide the IP address, not the hostname.:: <enter the IP address of your server>
The Object ID (OID):: iso.3.6.1.2.1.1.1.0
Enter parameter as "file" to log the output to a file. [nofile]::
This command may temporarily impact CPU performance.
Continue (y/n)?y
SNMPv2-MIB::sysDescr.0 = STRING: Linux release:3.10.0-1062.18.1.el7.x86_64 machine:x86_64
#####################################################################################################
utils snmp walk 2c -> same as utils snmp walk 1
#####################################################################################################
For the below example, user is created using
utils snmp config 3 user add

utils snmp walk 3
admin:utils snmp walk 3

ctrl-c: To quit the input.


Enter the user name:: test
Enter the authentication protocol [SHA]:: SHA
Enter the authentication protocol pass phrase:: ********
Enter the privacy protocol [AES128]:: AES128
Enter the privacy protocol pass phrase:: ********
Enter the ip address of the Server, use 127.0.0.1 for localhost.
Note that you need to provide the IP address, not the hostname.:: <enter the IP address of your server>
The Object ID (OID):: iso.3.6.1.2.1.1.1.0
Enter parameter as "file" to log the output to a file. [nofile]::
This command may temporarily impact CPU performance.
Continue (y/n)?y
SNMPv2-MIB::sysDescr.0 = STRING: Linux release:3.10.0-1062.18.1.el7.x86_64 machine:x86_64

utils snmp walk 1

この対話型コマンドは、指定された OID から始まる SNMP バージョン 1 を使用して SNMP MIB を走査します。

utils snmp walk 1 バージョン

構文の説明


パラメータ	説明
`バージョン`	SNMP バージョンを指定します。可能な値は 1、2c、または 3 です。
`コミュニティ`	SNMP コミュニティ文字列を指定します。
`IP アドレス`	サーバの IPv4/IPv6 アドレスを指定します。ローカルホストを指定するには、127.0.0.0 と入力します。クラスター内の別のノードの IPv4/IPv6 アドレスを入力して、そのノードでコマンドを実行できます。
`object`	ウォークする SNMP オブジェクト ID（OID）を指定します
`ファイル`	コマンド出力を保存するファイルを指定します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の許可: はい

適用対象: Unified Communications Manager、Unified Communications Manager の IM およびプレゼンスサービス、Cisco Unity Connection

utils snmp walk 2c

この対話型コマンドは、指定された OID から始まる SNMP バージョン 2c を使用して SNMP MIB を調べます。

utils snmp walk 2c バージョン

構文の説明


パラメータ	説明
`バージョン`	SNMP バージョンを指定します。可能な値は 1、2c、または 3 です。
`コミュニティ`	SNMP コミュニティ文字列を指定します。
`IP アドレス`	サーバの IPv4/IPv6 アドレスを指定します。ローカルホストを指定するには、127.0.0.0 と入力します。クラスター内の別のノードの IPv4/IPv6 アドレスを入力して、そのノードでコマンドを実行できます。
`object`	ウォークする SNMP オブジェクト ID（OID）を指定します
`ファイル`	コマンド出力を保存するファイルを指定します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の許可: はい

適用対象: Unified Communications Manager、Unified Communications Manager の IM およびプレゼンスサービス、Cisco Unity Connection

utils snmp walk 3

この対話型コマンドは、指定された OID から始まる SNMP MIB を調べます。

utils snmp walk 3 バージョン

構文の説明


パラメータ	説明
`バージョン`	SNMP バージョンを指定します。可能な値は 1、2c、または 3 です。
`コミュニティ`	SNMP コミュニティ文字列を指定します。
`object`	ウォークする SNMP オブジェクト ID（OID）を指定します
`IP アドレス`	サーバの IPv4/IPv6 アドレスを指定します。ローカルホストを指定するには、127.0.0.0 と入力します。クラスター内の別のノードの IPv4/IPv6 アドレスを入力して、そのノードでコマンドを実行できます。
`ファイル`	コマンド出力を保存するファイルを指定します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、Unified Communications Manager の IM およびプレゼンスサービス、Cisco Unity Connection

utils soap realtimeservice test

このコマンドは、リモートサーバ上でいくつかのテストケースを実行します。

utils soap realtimeservice test [リモート IP] リモート httpsリモート https パスワード

構文の説明


パラメータ	説明
`リモート IP`	テスト対象サーバの IP アドレスを指定します。
`remote-https-user`	SOAP API にアクセスできるユーザ名を指定します。
`remote-https-password`	SOAP API アクセス権を持つアカウントのパスワードを指定します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中の可能: なし

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service、および Cisco Unity Connection。

utils sso

このコマンドは、SAML SSO 認証に関する情報を提供します。

utils sso {有効化 | 無効化 | ステータス}

構文の説明


パラメータ	説明
有効化	Cisco Unified CM 管理内で SAML SSO を有効にできる場所を提供します。
無効にする	SAML SSO ベースの認証を無効にします。
ステータス	SAML SSO のステータスを提供します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用先: Unified Communications Manager、 Unified Communications Manager 上の IM and Presence Service、および Cisco Unity Connection

例

Admin: utils sso enable
*** W A R N I N G ***
SSO cannot be enabled using CLI command 
=======================================================
To enable Cluster wide SAML SSO please access 
Cisco Unified CM Administration Page->System->SAML Single Sign On 

=======================================================

utils sso recovery-url

このコマンドは、SAML SSO ベースの認証のリカバリ URL を有効または無効にします。

utils sso recovery-url {有効にする | 無効にする}

構文の説明


パラメータ	説明
有効化	SAML SSO ベースの認証のリカバリ URL を有効にします。
無効にする	SAML SSO ベースの認証のリカバリ URL を無効にします。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中に許可: はい

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service、Cisco Unity Connection

utils system restart

このコマンドを使用すると、同じパーティション上のシステムを再起動できます。

utils system restart

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service、Cisco Unity Connection

utils system shutdown

このコマンドを使用すると、システムをシャットダウンできます。

utils system shutdown

コマンドモード

管理者 (admin:)

使用上のガイドライン

このコマンドには 5 分間のタイムアウトがあります。システムが 5 分以内にシャットダウンしない場合は、コマンドによって強制シャットダウンを実行するオプションが提供されます。

注意	仮想マシンからサーバのシャットダウンおよび再起動が強制されると、ファイルシステムが破損する可能性があります。

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service 、Cisco Unity Connection

utils system switch-version

このコマンドを使用すると、非アクティブなパーティションでシステムを再起動できます。

utils system switch-version

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、 IM およびプレゼンスサービス、 Unified Communications Manager、 Cisco Unity Connection

utils system boot

このコマンドは、システムブート出力の送信先をリダイレクトします。

utils system boot {コンソール | シリアル}

構文の説明


パラメータ	説明
`コンソール`	システムブート出力をコンソールにリダイレクトします。
`シリアル`	システムブート出力を COM1 (シリアルポート 1) にリダイレクトします。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中に許可: はい

適用対象: Unified Communications Manager および Cisco Unity Connection

utils system upgrade

このコマンドを使用すると、ローカルディレクトリとリモートディレクトリの両方からアップグレードおよび Cisco オプション (COP) ファイルをインストールできます。

utils system upgrade {開始 | キャンセル | ステータス}

構文の説明


パラメータ	説明
cancel	アクティブなアップグレードをキャンセルします。
開始する	新しいアップグレードウィザードを開始するか、既存のアップグレードウィザードの制御を引き継ぎます。ウィザードでは、ソースからのアップグレードファイルの場所を指定するよう求められます。
ステータス	アップグレードのステータスを表示します。

コマンドモード

管理者 (admin:)

使用上のガイドライン

ウィザードでは、アップグレードに関する情報を入力するように求められます。

資格情報 - アップグレードイメージが保存されているサーバの資格情報があることを確認します。 Unified Communications Manager パブリッシャノードをアップグレードせず、このノードを以前にアップグレードした場合は、パブリッシャノードからのダウンロード資格情報を使用できます。 Publisher からのダウンロード資格情報の使用の既定値は [はい] です。

（注）

個々のクラスターノードをアップグレードする場合にのみ、パブリッシャノードからのダウンロード資格情報を使用できます。このオプションはクラスタ全体のアップグレードには適用されません。

アップグレードファイルソース - アップグレードファイルが保存されているサーバの場所を入力します。ローカルソース（CD または DVD）からアップグレードできます。また、FTP または SFTP を使用してリモートアップグレードファイルをダウンロードできます。また、キャンセル操作後にアップグレードを再開する場合は、ローカルイメージソースオプションを通じて以前にダウンロードしたアップグレードファイルを使用できます。
ダウンロード後にアップグレードを続行する - アップグレードファイルのダウンロード後にアップグレードを自動的に続行するかどうかを指定する必要があります (デフォルト値は [はい])。自動的にアップグレードすることを選択した場合、チェックサムまたは SHA の詳細は表示されません。値を [はい（Yes）] または [いいえ（No）] に設定した場合、その設定はシステムに残ります。
バージョンの切り替え - アップグレードが完了したら、新しいバージョンに自動的に切り替えるかどうかを指定する必要があります (デフォルト値は「いいえ」)。「yes」を入力した場合、システムは新しいバージョンに切り替わり、アップグレードの完了後に自動的に再起動します。値を [はい（Yes）] または [いいえ（No）] に設定した場合、その設定はシステムに残ります。

要件

コマンド権限レベル: 0

適用対象: Unified Communications Manager、 Unified Communications Manager の IM およびプレゼンスサービス、Cisco Unity Connection。

例:

（注）

クラスターのアップグレードが進行中で、CLI を使用して別のアップグレードが開始されると、次のメッセージが表示されます。

A cluster upgrade is in progress. You can check the status of the cluster upgrade using the CLI or GUI of the CUCM Publisher.


admin:utils system upgrade initiate
 
Warning: Do not close this window without first canceling the upgrade.
Warning: A cluster upgrade is in progress. You can check the status of the cluster upgrade using the CLI or GUI of the CUCM Publisher.

Use download credentials from Publisher(yes/no)[yes]:no
 
Source:
 
1) Remote Filesystem via SFTP
2) Remote Filesystem via FTP
3) Local DVD/CD
4) Local Image<UCSInstall_UCOS_12.5.0.98000-889.iso>
q) quit
Please select an option (1 - 4 or "q" ): 4

Please enter SMTP Host Server (optional):
Checking for valid upgrades.
Please wait...
Available options and upgrades in "upgrade" directory:
1) UCSInstall_UCOS_12.5.0.98000-338.iso
q) quit
Please select an option (1 - 1 or "q" ): 1
Accessing the file.
Please wait...
Validating the file...
A system reboot is required when the upgrade process completes or is canceled.
This will ensure services affected by the upgrade process are functioning properly.
Downloaded: UCSInstall_UCOS_12.5.0.98000-338.iso
File version: 12.5.0.98000-338
File checksum : (MD5): 8f:ce:0b:12:6b:d5:6f:d5:fd:25:d9:aa:12:d0:d5:30
(SHA512): 84ac0fd21723173ae89f1c01926a0852f46941c1785ae8e55dc8eb426dd9fb42fdc1ce07e0c9e3ac7bb01a4f7812f239fc38390dc2bc44d5161ebf13617c3050
Automatically switch versions if the upgrade is successful (yes/no): yes
Start installation (yes/no):  yes

例:


admin:utils system upgrade initiate
 
Warning: Do not close this window without first canceling the upgrade.
 
Use download credentials from Publisher (yes/no) [yes]:yes
Using publisher setting
Checking for valid upgrades. Please wait...
Available options and upgrades in "10.65.104.39:/var/sftp/uploads":
1.dp-ffr.3-1-7.NL.k3.cop q) quit
Please select an option (1 - 1 or "q" ):

例:


admin:utils system upgrade initiate
 
Warning: Do not close this window without first canceling the upgrade.
Use download credentials from Publisher(yes/no)[yes]:no
 
Source:
 
1) Remote Filesystem via SFTP
2) Remote Filesystem via FTP
3) Local DVD/CD
4) Local Image<UCSInstall_UCOS_12.5.0.98000-889.iso>
q) quit
Please select an option (1 - 4 or "q" ): 4

Please enter SMTP Host Server (optional):
Continue with upgrade after download (yes/no) [yes]:
switch-version server after upgrade (yes/no) [no]
Checking for valid upgrades.
Please wait...
Available options and upgrades in "upgrade" directory:
1) UCSInstall_UCOS_12.5.0.98000-338.iso
q) quit
Please select an option (1 - 1 or "q" ): 1
Accessing the file.
Please wait...
Validating the file...
A system reboot is required when the upgrade process completes or is canceled.
This will ensure services affected by the upgrade process are functioning properly.
Downloaded: UCSInstall_UCOS_12.5.0.98000-338.iso
File version: 12.5.0.98000-338
Automatically switch versions if the upgrade is successful (yes/no): yes
Start installation (yes/no):  yes

utils system upgrade cluster

このコマンドを使用すると、ローカルディレクトリとリモートディレクトリの両方から、クラスタノード (Unified Communications Manager および IM and Presence) のアップグレードと Cisco Option Package (COP) ファイルをインストールできます。

utils system upgrade cluster {initiate | cancel | status}

構文の説明


パラメータ	説明
cancel	アクティブなアップグレードをキャンセルします。
開始する	新しいアップグレードウィザードを開始するか、既存のクラスターアップグレードウィザードの制御を引き継ぎます。このオプションを使用すると、Unified Communications Manager パブリッシャーからクラスタ全体のアップグレードを実行できます。このオプションは、Unified Communications Manager パブリッシャに対してのみ使用でき、Unified Communications Manager サブスクライバまたは IM and Presence ノードに対しては使用できません。
ステータス	次のフィールドを使用して、クラスター内の各ノードのアップグレードのステータスを表示します。ノード - ノードのホスト名。役割 - ノードの役割。ステップ - 現在のステップ番号、またはアップグレード完了のために実行されるステップの合計数。説明 - 特定のノードに対してアップグレード中の現在のコンポーネント。履歴時間 - 以前のクラスタ全体のアップグレード実行に基づいて、各ノードの現在のコンポーネント/ステップを完了するのにかかった時間。経過時間 - それぞれのノードの現在のコンポーネント/ステップの開始から終了までの経過時間。

コマンドモード

管理者 (admin:)

使用上のガイドライン

ウィザードでは、アップグレードに関する情報を入力するように求められます。

資格情報 - アップグレードイメージが保存されているサーバの資格情報があることを確認します。
アップグレードファイルソース - アップグレードファイルが保存されているサーバの場所を入力します。ローカルソース（CD または DVD）からアップグレードできます。また、FTP または SFTP を使用してリモートアップグレードファイルをダウンロードできます。また、キャンセル操作後にアップグレードを再開する場合は、ローカルイメージソースオプションを通じて以前にダウンロードしたアップグレードファイルを使用できます。
ダウンロード後にアップグレードを続行する - アップグレードファイルのダウンロード後にアップグレードを自動的に続行するかどうかを指定する必要があります (デフォルト値は [はい])。自動的にアップグレードすることを選択した場合、チェックサムまたは SHA の詳細は表示されません。値を [はい（Yes）] または [いいえ（No）] に設定した場合、その設定はシステムに残ります。
バージョンの切り替え - アップグレードが完了したら、新しいバージョンに自動的に切り替えるかどうかを指定する必要があります (デフォルト値は「いいえ」)。「yes」を入力した場合、システムは新しいバージョンに切り替わり、アップグレードの完了後に自動的に再起動します。値を [はい（Yes）] または [いいえ（No）] に設定した場合、その設定はシステムに残ります。

要件

コマンド権限レベル: 0

適用対象: Unified Communications Manager の Unified Communications Manager。

例:

（注）

単一ノードのアップグレードが進行中で、クラスターのアップグレードが開始されると、次のメッセージが表示されます。

failed (Local upgrade is in progress.)

CLI またはユーザインターフェイスを使用して、Unified Communication Manager パブリッシャーで単一ノードのアップグレードが進行中の場合、CLI を使用してクラスタアップグレードを開始すると、次のメッセージが表示されます。

A Single-node upgrade is in progress. You can cancel the upgrade to initiate Cluster upgrade.

ユーザインターフェイスまたは CLI を使用して Unified Communication Manager パブリッシャーでクラスタアップグレードセッションが進行中の場合、CLI を使用して別のクラスタセッションを開始すると、次のメッセージが表示されます。

Another user session is currently configuring a cluster upgrade. Assume control (yes/no): yes


admin:utils system upgrade cluster initiate
 
Warning: Do not close this window without first canceling the upgrade.


Source:
 
1) Remote Filesystem via SFTP
2) Remote Filesystem via FTP
3) Local DVD/CD
4) Local Image<None>
q) quit
Please select an option (1 - 4 or "q" ): 1Directory [/home/image/BOTH]:
Server [10.65.104.19]:
User Name [image]:
Password [******]:
Please enter SMTP Host Server (optional):
Continue with upgrade after download (yes/no) [no]:
Switch-version cluster after upgrade [valid only for ISO] (yes/no) [no]:

Checking for valid upgrades.  Please wait...

Available CUCM options and upgrades in "10.65.104.19:/home/image/BOTH":

 1) UCSInstall_UCOS_12.5.0.98000-541.iso
 2) UCSInstall_UCOS_UNRST_12.5.0.98000-541.iso
 3) ciscocm.free_common_space_v1.1.cop
 4) ciscocm.migrate-export-v1.20.cop.sgn
 q) quit
Please select an option (1 - 4 or "q" ): 1


Available IMP options and upgrades in "10.65.104.19:/home/image/BOTH":

 1) UCSInstall_CUP_12.5.0.98000-661.iso
 2) UCSInstall_CUP_UNRST_12.5.0.98000-661.iso
 3) ciscocm.free_common_space_v1.1.cop
 4) ciscocm.migrate-export-v1.20.cop.sgn
 q) quit

Please select an option (1 - 4 or "q" ): 1
Processing the cluster wide download ...
UCM1-PUB.ciscoctg.com                     Downloading..287mb
UCM1-SUB-1B.ciscoctg.com                  Downloading..115mb
UCM1-SUB-1A.ciscoctg.com                  Downloading..347mb
IMP1-SUB-1B.ciscoctg.com                  failed (Local upgrade is in progress.)
UCM1-SUB-2B.ciscoctg.com                  Downloading..490mb
IMP1-PUB.ciscoctg.com                     Downloading..55mb
UCM1-SUB-2A.ciscoctg.com                  failed
Exiting upgrade command.  Please wait...

例:


admin:utils system upgrade cluster initiate
 
Warning: Do not close this window without first canceling the upgrade.
Cluster upgrade is in progress. You may not take over the installation.
Source:
 1) Remote Filesystem via SFTP
 2) Remote Filesystem via FTP
 3) Local DVD/CD
 4) Local Image <UCSInstall_UCOS_12.5.0.98000-569.iso>
 q) quit

Please select an option (1 - 4 or "q" ): 4
Please enter SMTP Host Server (optional):
Continue with upgrade after download (yes/no) [no]: no
Switch-version cluster after upgrade [valid only for ISO] (yes/no) [no]: no
Checking for valid upgrades.  Please wait...
Available CUCM options and upgrades in "upgrade" directory:
 1) UCSInstall_UCOS_12.5.0.98000-569.iso
 q) quit
Please select an option (1 - 1 or "q" ): 1
Available IMP options and upgrades in "upgrade" directory:
 1) UCSInstall_CUP_12.5.0.98000-695.iso
 q) quit
Please select an option (1 - 1 or "q" ): 1
Processing the cluster wide download ...
UCM1-SUB-1B.ciscoctg.com                  Download complete
UCM1-SUB-2A.ciscoctg.com                  Download complete
IMP1-SUB-1B.ciscoctg.com                  Download complete
UCM1-SUB-1A.ciscoctg.com                  Download complete
UCM1-PUB.ciscoctg.com                     Download complete
UCM1-SUB-2B.ciscoctg.com                  Download complete
IMP1-PUB.ciscoctg.com                     Download complete
Cluster wide Download complete
A system reboot is required when the upgrade process is complete or cancelled.
This will ensure the services affected by the upgrade process are functioning properly
  Downloaded UCM Image: UCSInstall_UCOS_12.5.0.98000-569.iso
  File version: 12.5.0.98000-569
  File checksum : (MD5): 66:93:bc:4d:c5:ae:19:34:72:77:96:5a:be:1a:28:3d
                  (SHA512): fdaab4a67072528927a2a6c9600b761e086af4894ac0b
                            85221e731fea864567674f6ac2c806fb2a8a05d
                            fe31485ef92ca63f8f4d37448d30715c79bf2738dfd2
  Downloaded IMP Image: UCSInstall_CUP_12.5.0.98000-695.iso
  File version: 12.5.0.98000-695
  File checksum : (MD5): 9e:f3:4e:e0:49:e3:c5:44:16:a5:f9:0e:8d:d5:a7:36
                  (SHA512): 57393dd5e70d43137d5ffb906fd815097f66a5a33e1fc
                            24bf4b6ed86894a6e0794f5f2165bc8395d2217
                            e24ae0b05b4d168b52ae480e5c9f7a29b7170f2ed92a
The IMP servers in the cluster must be rebooted after Unified CM publisher is switched
to the new version,even IF IMP servers are not being being upgraded 
Automatically switch versions if the upgrade is successful (yes/no): no
Start installation (yes/no):  yes
Cluster-wide upgrade has been initiated...

Node        Role                Step        Description        Historical time    Elapsed 
                                                               to complete        Time
                                                               
Ucm_Pub1    CUCM Publisher      1/15        Installing         1:37:13            00:07:14
IM&P_Pub1   IM&P Publisher      0/15        Waiting on Pub     1:20:13
Ucm_Sub1    CUCM Subscriber     0/15        Waiting on Pub     1:37:13
Cluster     None                overall     Overall upgrade    4:34:26            00:07:14

utils system enableAdministration

アップグレード中は構成の変更は許可されませんが、このコマンドを使用して、アップグレード中に緊急プロビジョニングを有効にすることができます。

注意

アップグレードプロセスを開始すると、アップグレードが完了し、アップグレード後のタスクがすべて実行されるまで、構成の変更は許可されません。構成の変更には以下が含まれます。

Unified Communications Manager または IM and Presence Service のグラフィカルユーザインターフェイス (GUI)、コマンドラインインターフェイス (CLI)、または AXL API を通じて行われた変更
LDAP 同期（Oracle LDAP から Unified Communications Manager にプッシュされる増分同期を含む）
自動ジョブ
自動登録を試みているデバイス

アップグレード中に行った構成の変更は失われる可能性があり、一部の構成の変更によってアップグレードが失敗する可能性があります。

utils system enableAdministration

コマンドモード

管理者 (admin:)

要件

コマンド特権レベル: 1 および 4

utils update dst

このコマンドは、現在の年の夏時間 (DST) ルールを更新します。

utils update dst

コマンドモード

管理者 (admin:)

使用上のガイドライン

このコマンドは、既存の DST ルールファイルのバックアップを取り、現在の年用の新しい DST ルールファイルを作成します。

注意	コマンドを実行した後、電話機を再起動します。電話機を再起動しないと、DST の開始日と終了日が間違ってしまいます。

要件

コマンド権限レベル: 0

アップグレード中の可能: なし

適用先: Unified Communications Manager および IM and Presence Service。

utils users validate

このコマンドは、展開内のすべてのノードとクラスタにわたってユーザレコードをチェックし、重複または無効なユーザ ID またはディレクトリ URI 値を識別します。

utils users validate {all | userid | uri}

構文の説明


パラメータ	説明
all	ノードおよびクラスタ内のすべてのユーザのユーザ ID とディレクトリ URI 値を検証します。
ユーザ ID	ノードおよびクラスター内のすべてのユーザのユーザ ID 値を検証します。
uri	ノードおよびクラスタ内のすべてのユーザのディレクトリ URI 値を検証します。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用先: Unified Communications Manager の IM and Presence Service

utils vmtools refresh

このコマンドは、現在インストールされている VMware Tools を、その VM の ESXi ホストによって規定されている最新バージョンに更新します。

（注）

最初の再起動後、VMware Tools は 実行中 の状態になります。 VMware Tools の新しいバージョンにアップグレードすると、最初は selinux によってインストールがブロックされる場合があります。この場合、システムは引き続き VMware Tools のインストールを許可しますが、追加の selinux ブロックを抑制するために新しい動的ポリシーが生成されます。 utils os secure dynamic-policies list コマンドを使用して、新しい動的ポリシーを表示できます。詳細については、 utils os secure dynamic-policies CLI コマンドを参照してください。

（注）

これは、ネイティブ VMtools に適用されます。

utils vmtools refresh

コマンドモード

管理者 (admin:)

使用上のガイドライン

VMware Tools の現在のバージョンを更新するには、[ゲスト] > [VMWare Tools のインストール/アップグレード] > [対話型ツールのアップグレード] の順に選択します。

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、 Unified Communications Manager 上の IM およびプレゼンスサービス、および Cisco Unity Connection。

例

admin:utils vmtools refresh
VMware Tools match host. Upgrade allowed, though not required.

***   W A R N I N G   ***
Running this command will update your current version of VMware Tools
to the latest version prescribed by the ESXi host on which this VM is
running. The tools install will cause your system to reboot twice.

utils vmtools status

このコマンドは、現在インストールされている VMware Tools の種類とバージョンを表示します。

utils vmtools status

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、 IM およびプレゼンスサービス、 Unified Communications Manager、 Cisco Unity Connection

utils vmtools switch open

このコマンドは、現在インストールされているネイティブ VMware Tools をアンインストールし、オープン VMware Tools をインストールします。

utils vmtools switch open

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、 IM およびプレゼンスサービス、 Unified Communications Manager、 Cisco Unity Connection

utils vmtools switch native

このコマンドは、現在インストールされているオープン VMware Tools をアンインストールし、ネイティブ VMware Tools をインストールします。

utils vmtools switch native

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、 IM およびプレゼンスサービス、 Unified Communications Manager、 Cisco Unity Connection

utils system boot status

このコマンドは、システムブートメッセージが送信される場所を表示します。場所はコンソールまたはシリアルポート 1 のいずれかです。

utils system boot status

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 0

アップグレード中に許可: はい

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service、Cisco Unity Connection

utils ucmgmt agent disable

このコマンドはエージェントを無効にし、実行を停止し、再起動しないようにします。

utils ucmgmt agent disable

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、Unified Communications Manager の IM およびプレゼンスサービス、および Unity Connection

例

admin:utils ucmgmt agent disable 
Stopping cloud_agent (via systemctl):  [  OK  ]

utils ucmgmt agent enable

このコマンドはエージェントを起動し、ウォッチドッグプロセスを有効にして、エージェントが実行されていることを確認します。

utils ucmgmt agent enable

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、Unified Communications Manager の IM およびプレゼンスサービス、および Cisco Unity Connection

例

admin:utils ucmgmt agent enable
Agent watchdog activated. 
Agent will start up shortly(~ 5 minutes).

utils ucmgmt agent remove

このコマンドは、エージェントとそのすべての構成を削除します。これは、アンインストール COP ファイルを実行するのと同じです。

utils ucmgmt agent remove

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、Unified Communications Manager の IM およびプレゼンスサービス、および Unity Connection

例

admin:utils ucmgmt agent remove 
Removing agent..
Starting removal of UC Management Agent
Agent removal complete.

utils ucmgmt agent restart

このコマンドは、実行中のエージェントを直ちに再起動し、エージェントをクラウドサービスに強制的に登録します。

utils ucmgmt エージェントの再起動

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、Unified Communications Manager の IM およびプレゼンスサービス、および Unity Connection

例

admin:utils ucmgmt agent restart
Stopping agent..
Agent is restarting. Check agent status with 'utils ucmgmt agent status'.

utils ucmgmt agent status

このコマンドは、エージェントのステータス情報を表示します。

utils ucmgmt agent status

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用先: Unified Communications Manager、Unified Communications Manager の IM and Presence Service、Unity Connection

例

admin:utils ucmgmt agent status
Agent Config Information:
   Verification Code: ZUSXXXP9
   Installed UCMGMT Agent version: 20210831-VOS
   Agent's organization id: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX                                                        

Agent Runtime Information:
   Agent process is not running.
   To start up the agent, run 'utils ucmgmt agent restart'.
   Agent process is enabled.
   Agent watchdog is enabled.
   Agent is not verified in Webex Control Hub.

utils ucmgmt agent verification

このコマンドは、正常にインストールされたエージェントの検証コードを表示します。

utils ucmgmt agent verification

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、Unified Communications Manager の IM およびプレゼンスサービス、および Unity Connection

例

admin:utils ucmgmt agent verification

Verification Code: XXXXXXXX

Utils ucmgmt 設定エクスポート

このコマンドは、未構成のエージェントノードにインポートするためのエージェント構成文字列を作成します。

utils ucmgmt 設定エクスポート

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、Unified Communications Manager の IM およびプレゼンスサービス、および Unity Connection

例

admin:utils ucmgmt config export

Organization and proxy configuration processing complete.

This config can be imported into an unconfigured destination node by running (if available):
'utils ucmgmt config import [[2SedFCjFJiXYUuzwYrxf9mlY9FdH_....==]]'

utils ucmgmt config import

このコマンドは、構成されたエージェントをインポートし、このエージェントを有効にします。エージェントは Control Hub で検証される必要があります。

utils ucmgmt config import

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、Unified Communications Manager の IM およびプレゼンスサービス、および Unity Connection

例

admin:utils ucmgmt config import 
[[2SedFCjFJiXYUuzwYrxf9mlY9FdH_U2FsdGVkX18QtlFwVd4dYKIQqnlLLuvilAGRhTapcaKxWdEFPmhsWIzApSmrymrkYHJq4.....
HE0AUZBfkjBvDpnq5incYdS8SOPTfVilxcKk7x/BIzuSYAIpcRKu+uP6XNQ318z/KigrDClCN03Z+bjrCrxg6ySzrPzA=]]
Found compatible org in config (XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX).

Configuration import is complete.  
Agent service will auto-start in the next 5 minutes.
To start the UCMGMT agent immediately run 'utils ucmgmt agent restart'

utils ucmgmt organization

このコマンドは、エージェントの Control Hub 組織 ID がまだ設定されていない場合はそれを設定します。

utils ucmgmt 組織

構文の説明


パラメータ	説明
組織 ID	組織 ID は、コントロールハブで確認できます。これは必須フィールドです。

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、Unified Communications Manager の IM およびプレゼンスサービス、および Unity Connection

例

min:utils ucmgmt organization  
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

utils ucmgmt proxy add

このコマンドは、提供されたプロキシ情報を使用してクラウドコントローラーのアクセスを検証します。成功した場合、プロキシは ucmgmt プロキシリストに追加されます。

utils ucmgmt proxy add

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、Unified Communications Manager の IM およびプレゼンスサービス、および Unity Connection

例

admin:utils ucmgmt proxy add http://proxy.proxy-example.com:8080 test
(Optional) Validating Proxy Password (won't display):
Re-enter Proxy Password (won't display):

Attempting to contact UCMGMT Cloud Controller... please wait (upto 30 seconds).
Successfully contacted controller.
{"serviceName": "Lookup Service", "serviceType": 
"REQUIRED", "serviceState": "online", "message": "Healthy", 
"lastUpdated": "2022-10-04T22:49:53", "upstreamServices": []}

Adding proxy.proxy-example.com:8080 to proxy list.

例

admin:utils ucmgmt proxy add http://proxy.proxy-example.com:80

Attempting to contact UCMGMT Cloud Controller... please wait (upto 30 seconds).
Successfully contacted controller.
{"serviceName": "Lookup Service", "serviceType": "REQUIRED", 
"serviceState": "online", "message": "Healthy", 
"lastUpdated": "2022-10-06T17:10:30", "upstreamServices": []}

Adding http://proxy.proxy-example.com:80 to proxy list.

utils ucmgmt proxy clear

このコマンドは、このノードに保存されているすべてのプロキシをクリアします。

utils ucmgmt proxy clear

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、Unified Communications Manager の IM およびプレゼンスサービス、および Unity Connection

例

admin:utils ucmgmt proxy clear

utils ucmgmt proxy force add

このコマンドは、構成されたエージェントに検証されていないプロキシを追加します。プロキシはアクセス検証なしで ucmgmt プロキシリストに追加されます。

utils ucmgmt プロキシ強制追加

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、Unified Communications Manager の IM およびプレゼンスサービス、および Unity Connection

例

admin:utils ucmgmt proxy force add http://staged.proxy.example.com:8080 user1
(Optional) Validating Proxy Password (won't display):
Re-enter Proxy Password (won't display):

Adding http://staged.proxy.example.com:8080 to proxy list.

例

admin:utils ucmgmt proxy force add http://proxy.proxy-example.com:80

Adding http://proxy.proxy-example.com:80 to proxy list.

utils ucmgmt proxy list

このコマンドは、このノードに保存されているすべてのプロキシを一覧表示します。プロキシ資格情報リストを認証すると、パスワードがマスクされます。

utils ucmgmt proxy list

コマンドモード

管理者 (admin:)

要件

コマンド権限レベル: 1

アップグレード中の可能: なし

適用対象: Unified Communications Manager、Unified Communications Manager の IM およびプレゼンスサービス、および Unity Connection

例

admin:utils ucmgmt proxy list
    "http://proxy.example.com:80"
    "http://user1:<REDACTED>@staged.proxy.example.com:8080"

Cisco Unified Communications ソリューションのコマンドライン インターフェイス リファレンス ガイド、リリース 12.5(1)

偏向のない言語

翻訳について

検索結果

章のタイトル： ユーティリティコマンド

ユーティリティコマンド

utils auditd

構文の説明

コマンド モード

使用上のガイドライン

要件

utils BE6000Mode enable

コマンド モード

要件

utils BE6000Mode disable

コマンド モード

要件

utils BE6000Mode status

コマンド モード

要件

utils branding enable

コマンド モード

要件

utils branding disable

コマンド モード

要件

utils branding status

コマンド モード

要件

utils contactsearchauthentication disable

コマンド モード

要件

utils contactsearchauthentication enable

コマンド モード

要件

utils contactsearchauthentication status

コマンド モード

要件

utils core analyze

構文の説明

コマンド モード

使用上のガイドライン

要件

utils core list

コマンド モード

要件

utils capf cert import

使用上のガイドライン

要件

utils capf set keep_alive

コマンド モード

要件

utils capf stale-lsc

構文の説明

コマンド モード

要件

utils create report

構文の説明

コマンド モード

使用上のガイドライン

要件

utils create report database

コマンド モード

要件

utils ctl

構文の説明

コマンド モード

使用上のガイドライン

要件

utils ctl reset localkey

構文の説明

コマンド モード

使用上のガイドライン

要件

utils cuc activate CUSRSV

コマンド モード

要件

utils cuc auto ITL download

構文の説明

コマンド モード

章のタイトル：ユーティリティコマンド

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード

コマンドモード