内容

概要

前提条件

要件

使用するコンポーネント

バージョン要件

概要

セットアップおよび設定手順

ステップ 1：Artifactory APIキーの生成

ステップ 2：Cloud ConnectでのArtifactory URLおよびAPIキーの設定

ステップ 3：オーケストレーションコントロールノードへのオンボードVOSノード

手順4：オーケストレーションコントロールノードへのWindowsノードのオンボード

ステップ5:inventory.confファイルを更新します。

手順6：オンボーディングされたノードのオーケストレーションの検証

概要

このドキュメントでは、コンタクトセンターエンタープライズオーケストレーションを設定する手順について説明します。

前提条件

要件

次の項目に関する知識があることが推奨されます。

- Unified Contact Center Enterprise(UCCE)12.x

- Packaged Contact Center Enterprise(PCCE)12.x

- Cisco Voice Portal(CVP)12.x

- Finesse 12.x

- Cisco Unified Intelligence Center(CUIC)12.x

- Virtual Voice Browser(VVB)12.x

使用するコンポーネント

このドキュメントの情報は、次のソフトウェアのバージョンに基づいています。

- Cloud Connect 12.6(1) ES3

- UCCE 12.5(1)

- Finesse 12.5(1)

- CUIC 12.5(1)

- CVP 12.5(1)

- VVB 12.5(1)

注：このドキュメントでは、CUICは共存インストールと、CUIC、ライブデータ(LD)、およびアイデンティティサーバ(IDS)のスタンドアロンインストールの両方を指します。命令がサブコンポーネントに固有である場合にのみ、そのコンポーネントが参照されます。

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、クリアな（デフォルト）設定で作業を開始しています。本稼働中のネットワークでは、各コマンドによって起こる可能性がある影響を十分確認してください。

バージョン要件

UCCE/PCCE 12.5(1)（いずれか）

- ES66（ES55はES66のインストール前に必須インストールです）

- UCCE 12.5(2) MR

UCCE/PCCE 12.6(1)

- 追加要件なし

Cloud Connectバージョン：12.6(1)

- ES3

Finesse、CUIC、VVB:12.5(1)

- ucos.orchestration.enable-12.5.1.cop.sgn

- ucos.keymanagement.cop.sgn（ダウンロード）

Finesse、CUIC、VVB:12.6(1)

- ucos.keymanagement.cop.sgn（ダウンロード）

CVP 12.5(1)

- ES23

CVP 12.6(1)

- 追加要件なし

Cloud Connectアップグレードに関する特記事項

注:Cloud Connectを12.5から12.6にアップグレードする場合、最初にucos.keymanagement.cop.sgnをインストールする必要があります。アップグレードを実行しないと失敗します。

注:Cloud Connectを12.5から12.6にアップグレードする場合、ディスクを146 GBから246 GBに増やす必要があります。アップグレードの前にこの手順を実行しなかった場合は、次の手順を実行します。

ステップ1:Cloud Connectサーバを停止します。

手順2:vSphereでディスクを246 GBまで拡張します。

ステップ3:Cloud Connectサーバを起動します。

VOSはパーティションを自動的に拡張します。これにより、ダウンロードされたアップデートによって共通パーティションの容量不足状態が発生しないことが保証されます。

概要

CCEオーケストレーションは、Cloud Connect 12.6(1)以降でサポートされています。

Cloud Connectサーババージョン12.6(1)は、次のシナリオでオーケストレーションをサポートします。

- CCE 12.5 ES/COPおよびWindows Updatesは12.6 Cloud Connectサーバからオーケストレーション可能

- CCE 12.5から12.6へのソフトウェアアップグレードは12.6 Cloud Connectサーバからオーケストレーション可能

セットアップおよび設定手順

ステップ 1：Artifactory APIキーの生成

1. CCOユーザ名とパスワードを使用してhttps://devhub-download.cisco.com/console/にログインします。

2. 図に示すように、コンソールページでManage Download Keyを選択します。

3. Generate Keyオプションをクリックして、APIキーを生成します。Manage Download KeyページでView and Revoke Keyオプションを使用できます。

4. 「コピー」ボタンを選択して、APIキーをクリップボードにコピーします。

注:APIキーの生成に使用するCCO IDには、必要なソフトウェアアップグレード権限が必要です。必要な権限を取得するには、使用するCCO IDに有効なSWSS（サービス契約）またはFlexサブスクリプションが必要です。

注:APIキーの有効期間を延長するには、6ヵ月に1回https://devhub-download.cisco.com/consoleにログインする必要があります。

ステップ 2：Cloud ConnectでのArtifactory URLおよびAPIキーの設定

- シスコは、Cloud Connectサーバが新しいアップデートをダウンロードして通知するために使用するクラウドベースのアーティファクトにすべてのソフトウェアアーティファクトをホストします。

- Cloud Connectサーバは、シスコがホストするソフトウェアのアーティファクトURL、リポジトリ名、およびAPIキーで設定する必要があります。

1.コマンドutils image-repository setを実行し、図に示すようにartifactory downloadを設定します。

a.アーティファクトのURL(https://devhub-download.cisco.com/binaries)を入力します。

b.アーティファクトリリポジトリ名ent-platform-release-externalを指定します。

c.生成したAPIキーを貼り付けます。セキュリティ上の理由から、APIキーはアスタリスクで表示されます。

2.コマンドutils image-repository showを実行し、図に示すように、Cloud Connectサーバに設定されているArtifactory URL、リポジトリ名、およびAPIキーを表示します。

注:CLIでutils image-repository setコマンドを実行する前に、EULA URL(https://software.cisco.com/download/eula)に移動し、EULAに同意してください。 これを行わないと、utils image-repository setコマンドがエラー「APIキーの生成に使用されるCCO IDがエンドユーザライセンス契約に準拠していません」で失敗します。有効なCCO IDを使用してください。

詳細については、Cisco Bug ID CSCvy78680を参照してください。

注：これらのコマンドはどちらも、Cloud Connectサーバのパブリッシャノードからのみ実行できます。

パブリッシャノードでutils image-repository setコマンドが正常な結果で実行されると、イメージリポジトリ設定の複製がパブリッシャノードからサブスクライバノードに自動的に行われます。

注:utils image-repository set CLIを使用すると、導入環境内で輸出規制対象ソフトウェアと規制対象外ソフトウェアのオプションをいつでも変更できます。

Cloud Connectサーバを再起動して、制限されているソフトウェアと制限されていないソフトウェアのクリーンアップとダウンロードを実行します。ダウンロードは、再起動後10分経過すると開始されます。

備考：工場操業に関する注記

アーティファクトの詳細を正常に設定すると、アーティファクトはCloud Connectサーバの午前2時（サーバ時刻）にローカルにダウンロードされます。

パッチのインストール、ロールバック、アップグレードなどのオーケストレーション操作は、アーティファクトのダウンロード後にのみ実行できます。

設定手順の直後にアーティファクトをダウンロードする必要がある場合は、Cloud Connectサーバを再起動できます。再起動の10分後にダウンロードが開始されます。

オーケストレーション関連のCLIコマンドの使用は、ダウンロードの開始時にブロックされます。この期間は、ダウンロードするアーティファクトの数によって異なります。

注:Cloud Connectサーバでインターネットへのアクセスにプロキシが必要な場合は、ES3以降をインストールする必要があります。プロキシ設定の詳細については、『UCCE Installation and Upgrade Guide』を参照してください。

ステップ 3：オーケストレーションコントロールノードへのオンボードVOSノード

前提条件

- すべてのシステムバージョンの要件が満たされていることを確認します。

- Cloud Connectクラスタ（PubおよびSub）から、すべてのターゲットVOSサーバのtomcat-trustに証明書をインポートします（自己署名の場合はtomcat、CA署名の場合はルート/中間）。

各Finesse、CUIC、VVB、IDS、LDシステムをCloud Connectサーバにオンボーディングするには、図に示すように、各VOSクラスタのパブリッシャノードからコマンドutils system onboard initiateを実行します。

1. Cloud ConnectパブリッシャノードのFQDNを入力します。

2. Cloud Connectサーバーのアプリケーションユーザー名を入力します。

3. Cloud Connectサーバのアプリケーションユーザパスワードを入力します。

- オンボード初期化がVOSノードから実行される場合、Cloud Connectサーバのパブリッシャノードはオンラインである必要があります。

- オンボード初期化をVOSノードから実行する場合は、Cloud ConnectパブリッシャサーバのFQDNを使用する必要があります。

- utils system onboard initiateコマンドは、すべてのVOSパブリッシャ（Finesse、CUIC、LD、IdS、すべてのVVB）で実行する必要があります

注：システム（クラスタ）が部分的なエラーでCloud Connectサーバにオンボードする場合は、エラーの原因を確認して修正します。次に、utils system onboard initiateコマンドの代わりにutils system onboard updateコマンドを実行します。

注：オンボードは、Cloud Connectサーバのパブリッシャノードとサブスクライバノードの両方が到達可能な場合にのみ許可されます。

注:Cloud Connectサーバが破損していて、新規インストールで再導入された場合、管理者はVOSノードからutils system onboard remove を実行してからutils system onboard initiateを実行し、再度VOSノードをオンボードする必要があります。

注:Cloud Connectサーバのアプリケーションユーザ名を確認または検索するには、Cloud ConnectサーバのCLIでコマンドrun sql select * from applicationuserを実行します。

手順4：オーケストレーションコントロールノードへのWindowsノードのオンボード

オンボードプロセスは、Cloud ConnectノードとWindowsノードの間でパスワードなしの接続を確立するのに役立ちます。Windowsベースのノードをオーケストレーションコントロールノードにオンボーディングするには、次の手順を実行します。

WindowsノードでSSH公開キーを設定します。

a. %Users%\<logonUser>\.ssh\ に移動し、authorized_keysファイルが存在しない場合は作成します。（authorized_keys拡張タイプはFileであり、変更できません）

注：ユーザはシステムから削除しないでください。また、ドメイン管理者権限またはローカル管理者権限を持つドメインユーザである必要があります。

b.ブラウザを開き、Cloud ConnectパブリッシャのURL(https://<CloudConnectIP>:8445/inventory/controlnode/key)を入力します。

c. Cloud Connectアプリケーションユーザクレデンシャルを入力します。認証が成功すると、REST API応答はCloud ConnectパブリックSSHキーを取得します。

d.この公開キーの値を%Users%\<logonUser>\.ssh\のauthorized_keysファイルにコピーします。

URLからの出力例を示します。出力では、ssh-rsaで始まりroot@localhostで終わる部分だけをauthorized_keysファイルにコピーします。

{"category":"PUBLISHER","hostName":"cc125clouda.uclabservices.com","publicKey":"ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDfJDl7RUZ/Umdflp5r3IqMaoV8WSrr7iLBOWindC0lGeGPYkprVW2xq6H6I8FuEjnBkrfEe8DUahVDVe783lFTb9nGdgRxAF7LR1MpKFOqOV9WRY8btYwRb0ZViO/GDupB2jBNaAj4M2EPPkKoC5OhcZrZ+4Zry/GEMd9uVwziyOh/nBxGuqg28euMiU2+G7m3qE3wo4zoJlvyOHkoM4tKzpiqqn0VdIRQ5xPhOl771AW6Rsiq4naG0f/hmVF347goavmF0O0lf1CbF4RfMoO1zxxlj+zi7RE1jl9aRMtzRmZC4uyIIQFtrZBbBbkzbk8dJo1u9A7Ds1rUcdEuc0Vv root@localhost"}

この例のauthorized_keysファイルを次に示します。

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDfJDl7RUZ/Umdflp5r3IqMaoV8WSrr7iLBOWindC0lGeGPYkprVW2xq6H6I8FuEjnBkrfEe8DUahVDVe783lFTb9nGdgRxAF7LR1MpKFOqOV9WRY8btYwRb0ZViO/GDupB2jBNaAj4M2EPPkKoC5OhcZrZ+4Zry/GEMd9uVwziyOh/nBxGuqg28euMiU2+G7m3qE3wo4zoJlvyOHkoM4tKzpiqqn0VdIRQ5xPhOl771AW6Rsiq4naG0f/hmVF347goavmF0O0lf1CbF4RfMoO1zxxlj+zi7RE1jl9aRMtzRmZC4uyIIQFtrZBbBbkzbk8dJo1u9A7Ds1rUcdEuc0Vv root@localhost

e.手順b、c、およびdを繰り返して、Cloud Connectサブスクライバの公開キーを取得します（Cloud ConnectがHAセットアップの場合）。

注:Cloud Connectパブリッシャおよびサブスクライバの公開キーは、単一のauthorized_keysファイルにコピーする必要があります。パブリッシャとサブスクライバのエントリは別々の行にする必要があり、行の最後に余分なスペース、カンマ、または特殊文字を使用することはできません。

f. OpenSSHサービスを再起動します。

- OpenSSH SSHサーバ

- OpenSSH認証エージェント

次の手順でSSHログインのトラブルシューティングを行います。

a. C:\ProgramData\sshに移動し、テキストエディタでファイルsshd_configを開きます。

b.このファイルで# Loggingで始まるセクションを探します。

c. SyslogFacilityとLogLevelの両方の行のコメントを解除します。

d.例に示すように、SyslogFacilityをLOCAL0に、LogLevelをDEBUGに変更します

# Logging

SyslogFacility LOCAL0

LogLevel DEBUG

e. sshd_configファイルを保存し、OpenSSH SSH Serverサービスを再起動します。

f.ログファイルはC:\ProgramData\ssh\logs\sshd.logに書き込まれます。

ステップ5:inventory.confファイルを更新します。

1.コマンドutils system inventory exportを実行して、図に示すようにインベントリをSFTPサーバにアップロードします。

a. SFTPサーバのIPアドレスまたはFQDNを指定します。

b. SFTPサーバへの読み取り/書き込みアクセス権を持つユーザ名を指定します。

c.ユーザのパスワードを入力します。

d.インベントリファイルをUNIX/Linux形式で書き込むためのディレクトリを指定します。

例： /voice/ipcc/Enterprise/Orchestration

2. VOSおよびWindowsコンポーネントを含めるようにインベントリを編集します。

- 構文、位置合わせ、およびインデントは、インベントリファイルと完全に同じである必要があります。

- CRLF行末はUNIXスタイルである必要があります。したがって、LinuxベースまたはMac OSベースのエディタを使用して、Windowsインベントリファイルを作成できます。メモ帳++などのプログラムも使用できます。

- CVPREPORTING、ROGGER、PGなどのコンポーネント名は大文字にする必要があります。

注:inventory.confファイルはインデントの影響を受けやすいため、イメージとコンフィギュレーションファイルの例を参照または使用してください。

適切な形式のサンプルファイルは、https://github.com/CXCCSummit/Repositoryからダウンロードできます。

VOSサーバの例を次の図に示します。

Windows Serverの例を次の図に示します。

3.必要に応じて、インベントリファイルの文字列を編集します。

deploymentName:展開の一意の名前を指定します。

- この名前は、電子メール通知の件名行に表示されます。設定されていない場合、電子メール通知の件名行には、プロシージャのタイプと全体的なステータスのみが含まれます。

deploymentType:このフィールドは、アップグレード、ロールバック、またはスイッチフォワードの手順での互換性チェックに使用されます。

サポートされる導入タイプは次のとおりです。

- UCCE-2000 – エージェント

- UCCE-4000 – エージェント

- PCCE-2000 – エージェント

- PCCE-4000 – エージェント

- HCS-CC-2000 – エージェント

- HCS-CC-4000 – エージェント

注：サポートされている導入タイプに関する次の注意事項を確認してください。

オーケストレーションは、12000、24000、および26000エージェントの導入モデルではサポートされていません。

HCS-SCC(Small Contact Center)展開モデルは、現在オーケストレーションではサポートされていません。

このフィールドに入力する値が、サポートされている導入タイプのリスト形式に準拠していることを確認してください。展開の種類では、大文字と小文字が区別されます。

注：管理者は、必要に応じて、展開の種類と希望する展開名に基づいて既定値を更新または編集できます。

4.図に示すように、Cloud Connectパブリッシャノードでコマンドutils system inventory importを実行し、SFTPサーバから更新されたインベントリをインポートします。

a. SFTPサーバのIPアドレスまたはFQDNを指定します。

b. SFTPサーバへの読み取り/書き込みアクセス権を持つユーザ名を指定します。

c.ユーザのパスワードを入力します。

d.インベントリファイルをUNIX/Linux形式で書き込むためのディレクトリを指定します。

例： /voice/ipcc/Enterprise/Orchestration

e.現在のインベントリを新しいインベントリファイルで置き換えるには、「yes」と答えます。

手順6：オンボーディングされたノードのオーケストレーションの検証

VOSノードとWindowsノードが正常にオンボーディングされたことを検証し、オーケストレーション機能を使用する準備ができているかどうかを確認するには、図に示すようにutils deployment test-connectionコマンドを実行します。