ステップ 1

Crosswork サーバーとして使用する予定のマシンに、VMware ESXi のサポートされているバージョンをインストールします。

ステップ 2

Cisco Software Central から、Cisco Crosswork プラットフォームの最新バージョンのイメージファイル cnc-workflowmanager-single-node-deployment-7.2.0-45.ova を、同じシステム上のストレージの場所にダウンロードします。

ステップ 3

VMware ESXi を実行して VMware vSphere Web クライアントにログインします。左側のナビゲーションウィンドウで、VM を展開する ESXi ホストを選択します。

ステップ 4

vSphere UI で、[ホスト（Host）] > [設定（Configure）] > [ネットワーキング（Networking）] > [仮想スイッチ（Virtual Switches）] に移動し、VM の UI にアクセスするために使用する管理ネットワークの仮想スイッチを選択します。仮想スイッチで、[編集（Edit）] > [セキュリティ（Security）]を選択し、次の DVS ポートグループプロパティを構成します。

ステップ 5

ネットワーク設定が要件を満たしていることを確認します。

ステップ 6

[アクション（Actions）] > [OVFテンプレートの展開（Deploy OVF Template）] を選択します。

ステップ 7

VMware の [OVFテンプレートの展開（Deploy OVF Template）] ウィンドウが表示され、最初の手順の [1 - OVFテンプレートを選択（1 - Select an OVF template）] が強調表示されます。[ファイルの選択（Choose Files）] をクリックし、OVA イメージファイルをダウンロードした場所に移動してファイルを選択します。選択すると、ファイル名がウィンドウに表示されます。

ステップ 8

[次へ（Next）] をクリックします。[OVFテンプレートの展開（Deploy OVF Template）] ウィンドウが更新され、[2 - 名前とフォルダの選択（2 - Select a name and folder）] が強調表示されます。名前を入力し、作成する Cisco Crosswork VM のそれぞれのデータセンターを選択します。

ステップ 9

[次へ（Next）] をクリックします。[OVFテンプレートの展開（Deploy OVF Template）]ウィンドウが更新され、[3-コンピューティングリソースの選択（3 - Select a compute resource）]が強調表示されます。Cisco Crosswork VM のホストを選択します。

ステップ 10

[次へ（Next）] をクリックします。VMware vCenter Server が OVA を検証します。検証にかかる時間はネットワーク速度によって決まります。検証が完了すると、[OVFテンプレートの展開（Deploy OVF Template）] ウィンドウが更新され、[4 - レビューの詳細（4 - Review details）] が強調表示されます。

ステップ 11

展開する OVF テンプレートを確認します。この情報は OVF から収集され、変更はできません。

ステップ 12

[次へ（Next）] をクリックします。[OVFテンプレートの展開（Deploy OVF Template）] ウィンドウが更新され、[5 - ライセンス契約（5 - License agreements）] が強調表示されます。エンドユーザーライセンス契約を確認し、同意する場合は [すべてのライセンス契約に同意する（I accept all license agreements）] チェックボックスをオンにします。同意しない場合は、シスコ エクスペリエンス チームに連絡してサポートを受けてください。

ステップ 13

[次へ（Next）] をクリックします。[OVFテンプレートの展開（Deploy OVF Template）] ウィンドウが更新され、[6 - 設定（6 - Configuration）] が強調表示されます。目的の展開設定を選択します。

ステップ 14

[次へ（Next）] をクリックします。[OVFテンプレートの展開（Deploy OVF Template）] ウィンドウが更新され、[7 - ストレージの選択（7 - Select Storage）] が強調表示されます。[仮想ディスク形式の選択（Select virtual disk format）] ドロップダウン リストから、該当するオプションを選択します。テーブルから、使用するデータストアを選択し、そのプロパティを確認して、使用可能なストレージが十分にあることを確認します。

（注）	実稼働展開の場合は、[シックプロビジョニング（Eager Zeroed）（Thick Provision Eager Zeroed）] オプションを選択します。これにより、ディスク容量が事前に割り当てられ、最高のパフォーマンスが得られます。ラボで使用する場合は、ディスク容量を節約するため、[シンプロビジョニング（Thin Provision）] オプションを推奨します。 Crosswork は、単一 VM のインストールで 2TB のオプションをサポートしていません。

ステップ 15

[次へ（Next）] をクリックします。[OVFテンプレートの展開（Deploy OVF Template）] ウィンドウが更新され、[8 - ネットワークの選択（8 - Select networks）] が強調表示されます。[接続先ネットワーク（Destination Network）] ドロップダウンリストから、管理ネットワークとデータネットワークに対する適切なネットワークを選択します。

ステップ 16

[次へ（Next）] をクリックします。[OVFテンプレートの展開（Deploy OVF Template）] ウィンドウが更新され、[9 - テンプレートのカスタマイズ（9 - Customize template）] が強調表示されます。

1. [管理ネットワーク（Management Network）] の設定を展開します。IP アドレス、 IP ネットマスク、 IP ゲートウェイ、仮想 IP アドレス、仮想 IP DNS 名など、IPv4 または IPv6 の展開に関する情報を（選択に従って）入力します。

2. [データネットワーク（Data Network）] 設定を展開します。IP アドレス、 IP ネットマスク、 IP ゲートウェイ、仮想 IP アドレス、仮想 IP DNS 名など、IPv4 または IPv6 の展開に関する情報を（選択に従って）入力します。

3. [ログイン情報の展開（Deployment Credentials）] の設定を展開します。[VM ユーザー名（VM Username）] と [パスワード（Password）] に該当する値を入力します。

   （注）	辞書にある単語に似たパスワード（「Pa55w0rd!」など）や簡単に推測できるパターンは使用しないでください。このようなパスワードは、最初の基準を満たしている場合もありますが、脆弱であると見なされ、VM のセットアップが明確な説明なしに失敗する可能性があります。インストールを正常に完了させるために、大文字と小文字、数字、特殊文字を予測不可能な順序で組み合わせた 8 文字以上の複雑なパスワードを使用してください。

4. [DNS サーバーと NTP サーバー（DNS and NTP Servers）] の設定を展開します。展開の設定（IPv4 または IPv6）に応じて、表示されるフィールドは異なります。次の 3 つのフィールドに情報を入力します。

   • [DNS IP アドレス（DNS IP Address）]：Cisco Crosswork サーバーで使用する DNS サーバーの IP アドレス。IP アドレスが複数ある場合はスペースで区切ります。

   • [NTP サーバー（NTP Servers）]：使用する NTP サーバーの IP アドレスまたはホスト名。IP またはホスト名が複数ある場合はスペースで区切ります。

   • [DNS 検索ドメイン（DNS Search Domain）]：DNS 検索ドメインの名前。

   • [タイムゾーン（Timezone）]：タイムゾーンの詳細を入力します。デフォルト値は UTC です。

   （注）	DNS サーバーと NTP サーバーは、ホストにマッピングしたネットワーク インターフェイスを使用して到達可能である必要があります。そうしないと、VM の設定が失敗します。

5. [ディスク構成（Disk Configuration）] の設定を展開します。次のフィールドに該当する値を入力します。

   • Logfs ディスクサイズ

   • Datafs ディスクサイズ

   • Corefs パーティションサイズ

   • 高速ディスクサイズ

   • バックアップパーティションの最小サイズ

   ディスク構成のデフォルト設定は、ほとんどの環境で機能します。シスコ カスタマー エクスペリエンス チームから指示された場合にのみ、設定を変更してください。

6. [Crosswork の設定（Crosswork Configuration）] を展開し、免責事項のテキストを入力します（ユーザーが CLI にログインすると、このテキストが表示されます）。

7. [Crosswork クラスタの設定（Crosswork Cluster Configuration）] を展開します。次のフィールドに該当する値を入力します。

   • [VMタイプ（VM Type）]： [ハイブリッド（Hybrid）] を選択します。

   • [クラスタシードノード（Cluster Seed Node）]：[True] を選択します。

   • [Crosswork管理クラスタ仮想IP（Crosswork Management Cluster Virtual IP]）：管理ネットワークの仮想 IP を入力します。

   • [Crosswork管理クラスタ仮想IP名（Crosswork Management Cluster Virtual IP Name）]：管理ネットワークの仮想 IP インターフェイスの DNS ホスト名を入力します。

   • [Crosswork管理クラスタ仮想IP（Crosswork Data Cluster Virtual IP）]：データネットワークの仮想 IP を入力します。

   • [Crossworkデータクラスタ仮想IP名（Crosswork Data Cluster Virtual IP Name）]：データネットワークの仮想 IP インターフェイスの DNS ホスト名を入力します。

   • [ハイブリッドノードの初期数（Initial hybrid node count）]： 1 に設定します。

   • [ノードの初期総数（Initial total node count）]： 1 に設定します。

   • [VM の場所（Location of VM）]：VM の地理的な場所を入力します。

   • [免責事項（Disclaimer）]：免責事項のテキストを入力します（ユーザーが CLI にログインすると、このテキストが表示されます）。

   • [インストールタイプ（Installation Type）]：単一の VM 展開には適用されません。いずれのチェックボックスもオンにしないでください。

   • [自動インストールのスキップ機能の有効化（Enable Skip Auto Install Feature）]：[True] に設定します。

   • [自動アクションマニフェスト定義（Auto Action Manifest Definition）]：デフォルト値（空）を使用します。

   • [製品固有の定義（Product specific definitio）]: 製品固有の定義を入力します。

   • [失敗の診断を無視しますか?（Ignore Diagnose Failure?）]：デフォルト値（False）を使用します。

ステップ 17

[次へ（Next）] をクリックします。[OVFテンプレートの展開（Deploy OVF Template）] ウィンドウが更新され、[10 - 完了の準備（10 - Ready to Complete）] が強調表示されます。

ステップ 18

設定を確認し、展開を開始する準備ができたら [終了（Finish）] をクリックします。展開が完了するまで待ってから続行します。展開ステータスを確認するには、次の手順を実行します。

1. VMware vCenter クライアントを開きます。

2. ホスト VM の [最近のタスク（Recent Tasks）] タブに、[OVFテンプレートの展開（Deploy OVF template）] ジョブと [OVFパッケージのインポート（Import OVF package）] ジョブのステータスを表示します。

ステップ 19

展開が完了したら、VM を右クリックし、 [設定の編集（Edit Settings）] を選択します。[設定の編集（Edit Settings）] ダイアログボックスが表示されます。[仮想ハードウェア（Virtual Hardware）] タブで、次の属性を更新します。

ステップ 20

Crosswork VM の電源を入れます。電源をオンにするには、ホストのエントリを展開し、[Cisco Crosswork VM] をクリックして、[アクション（Actions）] > [電源（Power）] > [電源オン（Power On）] を選択します。

ステップ 1

Docker 対応マシンで、このインストール時に使用するすべてのものを保存するディレクトリを作成します。

ステップ 2

https://software.cisco.com/download/home から、Crosswork プラットフォームインストーラバンドル（.tar.gz）および OVA イメージファイルを、以前に作成したディレクトリ（CW-CWM-Solutions-Advantage-2.0.0-14-SVM-7.1.0-48-ova）にダウンロードします。

ステップ 3

次のコマンドを使用して、インストーラバンドルを抽出します。

tar -xvf cnc-advantage-single-node-docker-deployment-7.1.0-48.tar.gz

ステップ 4

README ファイルの内容を確認して、パッケージの内容、および次の手順による検証方法を理解します。

ステップ 5

ワークステーションにインストールされている Python のバージョンが不明の場合は、python --version コマンドを使用して検出します。

ステップ 6

次のコマンドを使用して、インストーライメージの署名を確認します。

python cisco_x509_verify_release.py -e filename.cer -i filename.tar.gz -s Signaturefilename.tar.gz
-v dgst -sha512

python3 cisco_x509_verify_release.py3 -e filename.cer -i filename.tar.gz -s Signaturefilename.tar.gz
-v dgst -sha512

ステップ 7

次のコマンドを使用して、インストーライメージファイルを Docker 環境にロードします。

docker load -i filename.tar.gz

docker load -i cw-na-cnc-advantage-svm-installer-7.1.0-48-releasecnc710-250606.tar.gz

ステップ 8

Docker image list コマンドまたは Docker images コマンドを実行して、「イメージ ID」を取得します（次の手順で必要になります）。

docker images

My Machine% docker images
REPOSITORY                        TAG                                                     IMAGE ID       CREATED        SIZE
dockerhub.cisco.com/cw-installer  cw-na-cnc-advantage-svm-7.1.0-48-releasecnc710-250606   a4570324fad30  7 days ago     276MB

ステップ 9

次のコマンドを使用して Docker コンテナを起動します。

docker run --rm -it -v `pwd`:/data image id of the installer container

docker run --rm -it -v `pwd`:/data a4570324fad30

% docker run --rm -it -v `pwd`:/data a45
docker: invalid reference format: repository name must be lowercase.
See 'docker run --help'

docker: Error response from daemon: Mounts denied: approving /Users/Desktop: file does not exist
ERRO[0000] error waiting for container: context canceled

ステップ 10

VMware テンプレートを含むディレクトリに移動します。

ステップ 11

/opt/installer/deployments/7.1.0/vcentre/deployment_template_tfvars にあるテンプレートファイルを、別の名前を使用して /data フォルダにコピーします。

ステップ 12

任意のテキストエディタを使用して、/data ディレクトリにコピーしたテンプレートファイルを開き、計画した展開のプロパティと一致するように編集します。

Cw_VM_Image = ""    # Line added automatically by installer.
ClusterIPStack        = "IPv4"
ManagementVIP         = "10.78.103.198"
ManagementIPNetmask   = "255.255.255.0"
ManagementIPGateway   = "10.78.103.1"
DataVIP               = "192.168.100.198"
DataIPNetmask         = "255.255.255.0"
DataIPGateway         = "0.0.0.0"
DNS                   = "72.163.128.140"
DomainName            = "cisco.com"
CWPassword            = "*****!"
VMSize                = "XLarge"
NTP                   = "ntp.esl.cisco.com"
Timezone              = "America/Los_Angeles"
EnableSkipAutoInstallFeature = "True"
CwVMs = {
    "0" = {
      VMName              = "SVM198",
      ManagementIPAddress = "10.78.103.197",
      DataIPAddress       = "192.168.100.197",
      NodeType            = "Hybrid"
    }
}
VCenterDC = {
  VCenterAddress = "10.64.80.220",
  VCenterUser = "vcenterUsername",
  VCenterPassword = "vCenterPassword",
  DCname = "Crosswork-Single-VM",
  MgmtNetworkName = "VM Network",
  DataNetworkName = "CW-7.1-VLAN21",
  VMs = [
      {
        HostedCwVMs = ["0"],
        Host = "10.78.103.62",
        Datastore = "5.2TB-SSD-62-2",
        HSDatastore="5.2TB-SSD-62-2"
      }
  ]
}
SchemaVersion = "7.1.0"

ステップ 13

/opt/installer ディレクトリから、インストーラを実行します。

./cw-installer.sh install -m /data/template file name -o /data/filename.ova

./cw-installer.sh install -m /data/deployment.tfvars -o /data/cnc-advantage-single-node-deployment-7.1.0-48.ova

ステップ 14

インストーラは、エンドユーザーライセンス契約（EULA）を表示します。内容を読み、EULA に同意したら「yes」と入力します。同意しない場合は、インストーラを終了して、シスコの担当者にお問い合わせください。

ステップ 15

プロンプトが表示されたら、「yes」と入力してインストール操作を開始します。

ステップ 16

VM の作成とインストールの成功を追跡するには、Crosswork サーバーのアクティベーションの監視の手順に従います。

ステップ 17

インストール操作が終了したら、次のように正常にインストールされたことを確認するか、失敗したインストールを再実行します。

Warning: Line 119: No space left for device '8' on parent controller '3'.
Warning: Line 114: Unable to parse 'enableMPTSupport' for attribute 'key' on element 'Config'.

cw_vms = .......
INFO: Copying day 0 state inventory to CW
INFO: Waiting for deployment status server to startup on ip address. Elapsed time 0s, retrying in 30s
Crosswork deployment status available at http://ipaddress:30602/d/NK1bwVxGk/crosswork-deployment-readiness?orgId=1&refresh=10s&theme=dark 
Once deployment is complete login to Crosswork via: https://ipaddress:30603/#/logincontroller 
INFO: Cw Installer operation complete.

ステップ 1

Crosswork VM のインストール時に使用する構成 IOS ファイル（ovf-env.xml）を準備します。

<Environment
     xmlns="http://schemas.dmtf.org/ovf/environment/1"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xmlns:oe="http://schemas.dmtf.org/ovf/environment/1"
     xmlns:ve="http://www.vmware.com/schema/ovfenv"
     oe:id=""
   <PlatformSection>
      <Kind>KVM</Kind>
      <Version>7.2.0</Version>
      <Vendor>KVM</Vendor>
      <Locale>en</Locale>
   </PlatformSection>
    <PropertySection>
         <Property oe:key="CWPassword" oe:value="**********"/>
         <Property oe:key="CWUsername" oe:value="cw-admin"/>
         <Property oe:key="ClusterCaKey" oe:value=""/>
         <Property oe:key="ClusterCaPubKey" oe:value=""/>
         <Property oe:key="CwInstaller" oe:value="False"/>
         <Property oe:key="DNSv4" oe:value="171.70.168.183"/>
         <Property oe:key="DNSv6" oe:value="::0"/>
         <Property oe:key="DataIPv4Address" oe:value="192.168.5.48"/>
         <Property oe:key="DataIPv4Gateway" oe:value="192.168.5.1"/>
         <Property oe:key="DataIPv4Netmask" oe:value="255.255.255.0"/>
         <Property oe:key="DataIPv6Address" oe:value="::0"/>
         <Property oe:key="DataIPv6Gateway" oe:value="::1"/>
         <Property oe:key="DataIPv6Netmask" oe:value="64"/>
         <Property oe:key="DataPeerIPs" oe:value=""/>
         <Property oe:key="DataVIP" oe:value="192.168.5.51"/>
         <Property oe:key="DataVIPName" oe:value=""/>
         <Property oe:key="Deployment" oe:value="cw_ipv4"/>
         <Property oe:key="Disclaimer" oe:value="Cisco Crosswork"/>
         <Property oe:key="Domain" oe:value="cisco.com"/>
         <Property oe:key="EnableSkipAutoInstallFeature" oe:value="True"/>
         <Property oe:key="EnforcePodReservations" oe:value="True"/>
         <Property oe:key="IgnoreDiagnosticsCheckFailure" oe:value="True"/> 
         <Property oe:key="InitMasterCount" oe:value="1"/>
         <Property oe:key="InitNodeCount" oe:value="1"/>
         <Property oe:key="IsSeed" oe:value="True"/>
         <Property oe:key="K8Orch" oe:value=""/>
         <Property oe:key="K8sPodNetworkV4" oe:value="10.244.0.0"/>
         <Property oe:key="K8sServiceNetworkV4" oe:value="10.96.0.0"/>
         <Property oe:key="ManagementIPv4Address" oe:value="10.19.70.148"/>
         <Property oe:key="ManagementIPv4Gateway" oe:value="10.19.70.1"/>
         <Property oe:key="ManagementIPv4Netmask" oe:value="255.255.255.0"/>
         <Property oe:key="ManagementIPv6Address" oe:value="::0"/>
         <Property oe:key="ManagementIPv6Gateway" oe:value="::1"/>
         <Property oe:key="ManagementIPv6Netmask" oe:value="112"/>
         <Property oe:key="ManagementVIP" oe:value="10.19.70.151"/>
         <Property oe:key="ManagementVIPName" oe:value=""/>
         <Property oe:key="ManagerPeerIPs" oe:value=""/>
         <Property oe:key="NTP" oe:value="ntp.esl.cisco.com"/>
         <Property oe:key="Timezone" oe:value="US/Pacific"/>
         <Property oe:key="VMLocation" oe:value="default"/>
         <Property oe:key="VMType" oe:value="Hybrid"/>
         <Property oe:key="bckup_min_percent" oe:value="35"/>
         <Property oe:key="corefs" oe:value="18"/>
         <Property oe:key="ddatafs" oe:value="485"/>
         <Property oe:key="logfs" oe:value="20"/>
         <Property oe:key="ramdisk" oe:value="0"/>
         <Property oe:key="ssd" oe:value="15"/>
         <Property oe:key="VMSize" oe:value="XLarge"/>
         <Property oe:key="ThinProvisioned" oe:value="False"/>
         <Property oe:key="UseNonDefaultCalicoBgpPort" oe:value="False"/>
         <Property oe:key="bootOptions.efiSecureBootEnabled" oe:value="True"/>
   </PropertySection>
</Environment>

ステップ 2

KVM 展開用に収集したパラメータ値を使用して、作成した ovf-env.xml ファイルを更新します（一般パラメータを参照）。

$ cat ovf-env.xml

ステップ 3

ISO ファイルを生成します。

$ mkisofs -R -relaxed-filenames -joliet-long -iso-level 3 -l -o cnc1.iso ovf-env.xml

ステップ 4

https://software.cisco.com/download/home から、Cisco Crosswork プラットフォームの最新バージョンである qcow2.tar.gz ファイルを KVM ホスト上のストレージの場所にダウンロードします（CW-CWM-Solutions-workflowmanager-2.1.0-14-SVM-7.2.0-45-qcow2.signed.bin）。

ステップ 5

次のコマンドを使用して tar.gz ファイルを抽出します。

tar -xvf cnc-workflowmanager-single-node-deployment-7.2.0-45-qcow2.tar.gz

ステップ 6

必要なインストールフォルダに移動し、3 つのディスクを作成します。

cd cnc1/
qemu-img create -f qcow2 disk3 20G
qemu-img create -f qcow2 disk4 485G
qemu-img create -f qcow2 disk6 15G

ls -1
cw_dockerfs.qcow2
cw_extrafs.qcow2
cw_rootfs.qcow2
disk3
disk4
disk6

ステップ 7

ネットワークブリッジまたは SRIOV を使用して Crosswork VM をインストールします。

ステップ 8

VM の作成とインストールの成功を追跡するには、Crosswork サーバーのアクティベーションの監視の手順に従います。

ステップ 1

Crosswork VM ホストから HTTP、HTTPS、または SCP によってアクセス可能なリモートホストで、この手順で使用するダウンロードを含むストレージディレクトリを作成します。

ステップ 2

https://software.cisco.com/download/home から、選択した VM 展開に適した Cisco Crosswork Workflow Manager Advantage Platform Deployment ファイルをリモートホストにダウンロードします。

ステップ 3

次のコマンドを使用して、適切な signed.bin ファイルから tar.gz インストーラバンドルを抽出します。

sh CW-CWM-Solutions-Advantage-2.0.0-14-SVM-7.1.0-48-ova.tar.gz

sh CW-CWM-Solutions-Advantage-2.0.0-14-SVM-7.1.0-48-qcow2.tar.gz

ステップ 4

管理者 ID を使用して Crosswork にログインし、[管理（Administration）][ > Crosswork Manager] > [アプリケーション管理（Application Management）]を選択します。

ステップ 5

[新しいファイルの追加（Add new file）] をクリックし、[CAPPファイルのアップロード(.tar.gz)（Upload CAPP file (.tar.gz)] を選択します。

ステップ 6

[ファイルの追加（.Tar.Gz）（Add File (.Tar.Gz)）] ページを使用して、まず、CWM CAPP ファイルをシステムに追加するために使用する [プロトコル（Protocol）] を選択します。次のアクションを実行します。

1. [URL] を選択した場合：次の図に示されているように、CAPP ファイルが保存されているリモートホストの URL（tar.gz ファイルへのパスを含む）を入力します。[基本認証（Basic Auth）] チェックボックスがオンになっている場合は、リモートホストにアクセスするために必要な [ユーザー名（Username）] と [パスワード（Protocol）] を入力します。

2. [SCP] を選択した場合：リモートホスト上のファイルの [サーバーパス/場所（Server path/Location）]、リモートホストサーバーの [ホスト名/ IPアドレス（Host name/ IP address）]、[ポート（Port）]、ログインの [ユーザー名（Username）] と [パスワード（Password）] を入力します。

ステップ 7

[Add] をクリックします。[ジョブ履歴（Job History）] オプションを選択して、CAPP ファイルのアップロードの進行状況を監視できます。

ステップ 8

アップロードが完了すると、次の図に示すように、 [アプリケーション（Applications）] ページに [Workflow Manager] タイルが表示され、アプリケーションをインストールする準備ができたことを示します。

ステップ 9

[Workflow Manager] タイルの [詳細（More）] アイコン（3 つのドット）をクリックして [Workflow Manager] インストール ポップアップを表示し、[インストール（Install）] をクリックします。インストールが完了すると、[アプリケーション管理（Applications Management）] > [ジョブ履歴（Job History)] タブに、「アクティベーションが成功しました（Activation Successful）」というメッセージが表示されます。

ステップ 10

[管理（Administration）] > [Crosswork Manager] > [Crosswork の正常性（Crosswork Health）] > [Workflow Manager]を選択して、インストールが正常に完了したことを確認します。[マイクロサービス（Microservices）] タブには、次の図に示されている 10 のマイクロサービスが表示され、すべてのマイクロサービスの [ステータス（Status）] 列に [正常（Healthy）] と表示されます。

ステップ 1

まだ行っていない場合は、管理者 ID を使用して Crosswork にログインし、 [管理（Administration）][ > [Crosswork Manager] > [アプリケーション管理（Application Management）]を選択します。

ステップ 2

[新しいファイルの追加（Add new file）] をクリックし、[CAPPファイルのアップロード(.tar.gz)（Upload CAPP file (.tar.gz)] を選択します。

ステップ 3

[ファイルの追加（.Tar.Gz）（Add File (.Tar.Gz)）] ページを使用して、まず、CWM ソリューション CAPP ファイルをシステムに追加するために使用する [プロトコル（Protocol）] を選択します。次のアクションを実行します。

1. [URL] を選択した場合：次の図に示されているように、CAPP ファイルが保存されているリモートホストの URL（tar.gz ファイルへのパスを含む）を入力します。[基本認証（Basic Auth）] チェックボックスがオンになっている場合は、リモートホストにアクセスするために必要な [ユーザー名（Username）] と [パスワード（Protocol）] を入力します。

2. [SCP] を選択した場合：ファイルの [サーバーパス/場所（Server path/Location）]、サーバーの [ホスト名/ IPアドレス（Host name/ IP address）]、[ポート（Port）]、ログインの [ユーザー名（Username）] と [パスワード（Password）] を入力します。

ステップ 4

[Add] をクリックします。アップロードの進行中は、[ジョブ履歴（Job History）] オプションを選択してアップロードを監視することができます。

ステップ 5

追加が完了すると、[アプリケーション（Applications）] ページの右端にある [Workflow Manager] タイルの横に [Workflow Manager Solutions] タイルが表示され、Workflow Manager Solutions アプリケーションのインストール準備が整ったことが示されます。

ステップ 6

[Workflow Manager ソリューション（Workflow Manager Solutions）] タイルの [詳細（More）] アイコン（3 つのドット）をクリックして、インストール ポップアップ メニューを表示し、[インストール（Install）] をクリックします。

ステップ 7

インストールが完了すると、[アプリケーション管理（Applications Management）] > [ジョブ履歴（Job History)] タブに、「Workflow Manager ソリューションアプリケーションのアクティベーションが成功しました（Activation of application Workflow Manager Solutions Successful）」というメッセージが表示されます。

ステップ 8

[アプリケーション管理（Application Management）] > [アプリケーション（Applications ）] タブに、[Workflow Manager] と [Workflow Manager ソリューション（Workflow Manager Solutions）] の両方が稼働していることが表示されます。

ステップ 9

[管理（Administration）] > [Crosswork Manager] > [Crosswork の正常性（Crosswork Health）] > [Workflow Manager ソリューション（Workflow Manager Solutions）]を選択します。[マイクロサービス（Microservices）] タブに、5 つの CWM ソリューションのマイクロサービスがすべて [正常（Healthy）] 状態であると表示されている必要があります。

ステップ 10

最後に、CWM ソリューションは、3 つのダイナミックサービスポッドを CWM に追加します。これらは、CWM ソリューションによって自動的にインストールされた 3 つの CWM アダプタのワーカーポッドです。それらは、[管理（Administration）] > [Crosswork Manager] > [Crosswork 正常性（Crosswork Health）] > [Workflow Manager] の下にあります（[Workflow Manager ソリューション（Workflow Manager Solutions）] の下ではありません）。

ステップ 1

Crosswork にログインし、[デバイス管理（Device Management）] > [ログイン情報プロファイル（Credential Profiles）]を選択します。Crosswork は、[ログイン情報プロファイル（Credential Profiles）] リストを表示します。

ステップ 2

NSO プロバイダーのログイン情報プロファイルを次のように作成します。

1. + をクリックして、NSO プロバイダーのログイン情報プロファイルを追加します。

2. [新しいプロファイルの追加（Add New Profile）] ウィンドウのフィールドに次のように入力します。

   フィールドの内容	入力または選択する内容
   プロファイル名（または意味のある任意の一意の名前）	NSO ログイン情報（または意味のある任意の一意の名前）
   接続タイプ（Connectivity type）	SSH
   ユーザー名（User name）	NSO サーバーの SSH 管理ユーザーのユーザー名。このユーザー名は、NSO サーバーで作成する管理者権限を持つ専用の CWM ソリューション用ユーザー名にすることができます。いずれの場合も、この管理者ユーザー名は、NSO サーバーの ncsadmin グループに含まれているユーザー名である必要があります。
   パスワード（Password）	このユーザー名のパスワード。
   パスワードの確認（Confirm password）	[パスワード（Password）] に入力したのと同じパスワード。
   パスワードを有効にする（Enable password）	このフィールドは空欄のままにします。

3. [さらに追加（+ Add another）] をクリックして、同じ NSO ログイン情報プロファイルに追加する別の接続プロトコルのセットを表示します。今回は、[接続タイプ（Connectivity type）] として [HTTPS] を選択し、ステップ 2b と同じように、このプロトコルの NSO ユーザーとパスワードの情報を入力します。次に例を示します。

   

4. 作業が終了したら、[保存（Save）] をクリックして NSO ログイン情報プロファイルを保存します。指定した [プロファイル名（Profile name）] が [ログイン情報プロファイル（Credential Profiles）] リストに表示されます。

ステップ 3

（オプション）ステップ 2 を繰り返して、デバイスの別のログイン情報プロファイルを作成します。Crosswork Workflow Manager ソリューションを使用して管理する予定のデバイスに適した数のデバイスログイン情報とプロトコルを追加することをお勧めします。管理対象のデバイスがそれらのプロトコルを使用していない場合は、ログイン情報プロファイルにプロトコルを追加しないでください。次の表は、Crosswork ログイン情報プロファイルに追加できるすべてのプロトコルと、それらがサポートするデバイス機能の種類をまとめたものです。

プロトコル	用途
SSH	IoT デバイス制御と安全なファイル転送を提供するデバイス。デバイス管理に一般的に使用されるプロトコル。
NETCONF	リモート設定と RPC 交換。通常は SSH で使用されます。
HTTP	安全でない Web リソースへのアクセスを提供するホスト。
HTTPS	安全で暗号化された Web リソース交換を提供するホスト。
SCP	SSH を使用した安全な暗号化されたファイル交換を提供するデバイス。
TELNET	コンソールアクセス用の一般的なプロトコルであり、ほとんどの Cisco XR、Cisco XE、およびJuniper Junos デバイスに使用されます。
SNMPv2	多くのデバイスで使用される、デバイス管理の標準プロトコル。
gRPC	高パフォーマンス分散システムに参加するデバイス。これにより、クライアント アプリケーションは、ローカルであるかのように、サーバーアプリケーションでリモートプロシージャコールを直接呼び出すことができます。REST の代替手段。
SNMPv3	一部の新しいデバイスで使用される、デバイス管理用の標準プロトコルの最新バージョン。
gNMI	セキュアなストリーミング形式でリアルタイムのネットワーク監視、テレメトリ、およびデバイス管理を提供するデバイス。データセンターやサービスプロバイダーで SNMP の代わりによく使用されます。

次の図に、最も一般的に使用される 2 つのプロトコル用の単一のデバイスログイン情報プロファイルを作成する方法を示します。同じ 2 つのプロトコルを使用しているが、異なるログイン情報を持つデバイスのグループがある場合は、このように複数のログイン情報プロファイルを作成できます。

ステップ 1

NSO サーバーに次の Python パッケージをインストールします。

~$ sudo pip install textfsm
~$ sudo pip install jinja2
~$ sudo pip instapp pyyaml
~$ sudo pip install pycryptodome

ステップ 2

NSO ncs.conf ファイルを以下に示すように編集し、REST サポートを有効にします。<ssl> ブロックは任意であり、REST やその他のコマンドと区別するために、以下ではイタリック体で示されています。次に例を示します。

sudo vi /etc/ncs/ncs.conf
 
 <webui>
    <enabled>true</enabled>
    <transport>

<ssl>
  <enabled>true</enabled>
  <ip>0.0.0.0</ip>
  <port>8888</port>
  <key-file>${NCS_CONFIG_DIR}/ssl/cert/host.key</key-file>
  <cert-file>${NCS_CONFIG_DIR}/ssl/cert/host.cert</cert-file>
  <extra-listen>
    <ip>::</ip>
    <port>8888</port>
  </extra-listen>
      </ssl>
    </transport>
 
    <cgi>
      <enabled>true</enabled>
      <php>
        <enabled>false</enabled>
      </php>
    </cgi>
  </webui>
 
  <restconf>
    <enabled>true</enabled>
  </restconf>

ステップ 3

編集が完了したら、ncs.conf ファイルを保存し、NSO を再起動します。次に例を示します。

sudo systemctl restart ncs

ステップ 4

管理者ユーザー ID を使用して、NSO インストールで REST が正しく機能していることを確認します。次に例を示します。

admin1@ncs% run show ncs-state rest
ncs-state rest listen ssl
 ip   ::
 port 8888
ncs-state rest listen ssl
 ip   0.0.0.0
 port 8888

ステップ 5

次の NSO グローバル構成設定を指定します。

admin1@ncs% show devices global-settings
connect-timeout 600;
read-timeout    600;
write-timeout   600;
ssh-algorithms {
    public-key [ ssh-rsa ];
}
trace           pretty;
}

ステップ 6

コメント付きの行 #End of file の前に Linux オペレーティングシステムの ulimit 値を追加します（まだない場合）。次に例を示します。

1. /etc/security/limits.conf ファイルを確認します。

   $ grep hard /etc/security/limits.conf
   $ grep soft /etc/security/limits.conf 

2. 構成されていない場合は、/etc/security/limits.conf ファイルを編集し、次の行を追加します。

   * soft nproc 65535
    * hard nproc 65535
    * soft nofile 65535
    * hard nofile 65535
    * soft memlock 65535
    * hard memlock 65535 

3. sysctl -p スクリプトを実行してパラメータを設定します。

4. システムからログアウトし、再度ログインして新しい値を適用します。

5. Linux オペレーティングシステムの ulimit 値が適用されていることを確認します。

   $ ulimit -a core file size          (blocks, -c) 0 
   data seg size           (kbytes, -d) unlimited 
   scheduling priority             (-e) 0 
   file size               (blocks, -f) unlimited 
   pending signals                 (-i) 95697 
   max locked memory       (kbytes, -l) 65536 
   max memory size         (kbytes, -m) 
   unlimited open files                      (-n) 65535 
   pipe size            (512 bytes, -p) 8 
   POSIX message queues     (bytes, -q) 819200 
   real-time priority              (-r) 0 
   stack size              (kbytes, -s) 8192 
   cpu time               (seconds, -t) 
   unlimited max user processes              (-u) 65535 
   virtual memory          (kbytes, -v) unlimited 
   file locks                      (-x) unlimited 

ステップ 7

NETCONF Access Control Model（NACM）ルールリストが、ncsadmin および Linux ユーザーに NSO で機能を実行する権限を付与していることを確認します。次に例を示します。

admin1@ncs% show nacm
read-default     deny;
write-default    deny;
exec-default     deny;
groups {
    group ncsadmin {
        user-name [ admin1 private ];
    }
    group ncsoper {
        user-name [ public ];
    }
}

ステップ 8

フリートアップグレードを使用してサポートするデバイスを決定し、次のように、それらのデバイスに適した NSO Network Element Drivers （NED）をインストールします。

1. アカウントチームが提供した NED ライセンス証明書の URL を使用して、Cisco ソフトウェアダウンロードからデバイスの NED を NSO ホストのリソースにダウンロードします。NED は signed.bin ファイルで、これを実行して NED コードを検証および抽出する必要があります。

2. NSO アドミニストレーション ガイドののトピック「新しい NED のインストール」の説明に従って、ダウンロードした NED を確認、抽出、インストールします。

3. 新しい NED のインストールが完了したら、NSO を再起動します。例：

   sudo systemctl restart ncs

ステップ 1

Crosswork にログインし、[管理（Administration）] > [プロバイダアクセスの管理（Manage Provider Access）]を選択します。

ステップ 2

[+] をクリックして NSO プロバイダーを追加します。

ステップ 3

[新しいプロファイルの追加（Add New Profile）] ウィンドウの最初のフィールドセットに次のように入力します。

ステップ 4

[接続タイプ（Connection type(s)）] セクションのフィールドに次のように入力します。

ステップ 5

[プロバイダプロパティ（Provider Properties）] セクションのエントリはオプションです。必要に応じて、次のキー/値のペアのうち 1 つまたは複数を入力します。

Example (for RFS node 1): 
input_url_prefix: /rfc-1

ステップ 6

[モデルプレフィックス情報（Model Prefix Info）] セクションのフィールドに次のように入力します。

ステップ 7

作業が終了したら、[保存（Save）] をクリックして NSO プロバイダープロファイルを保存します。Crosswork が NSO に到達しようとしている間、遅延が発生すると、 [プロバイダーアクセスの管理（Manage Provider Access）] リストにこのプロファイルが表示されます。

ステップ 1

シスコセールスチームに問い合わせて、ネットワーク環境に必要な Cisco NSO Network Element Drivers（NED）を特定してダウンロードしてください。先に進む前に、「新しい NED のインストール」で説明されているように、これらの NED を NSO サーバーにインストールします。

ステップ 2

NED がインストールされたら、Crosswork Workflow Manager にログインし、[管理（Administration）] > [Crosswork Manager] > [NSO展開マネージャ（NSO Deployment Manager）]を選択します。

ステップ 3

[NSO展開マネージャ（NSO Deployment Manager）] で、[NSO機能パックバンドル（NSO Function pack bundles）] タブを選択し、[CWMソリューションFPS（CWM SOLUTIONS FPS）] の横にあるチェックボックスをオンにします。次に、[展開（Deploy）] ボタンをクリックして、展開プロセスを開始します。

ステップ 4

最初の [ログイン情報の提供（Provide credentials）] ページでプロンプトが表示されたら、SSH のユーザー名、パスワード 、および Sudo パスワードログイン情報を入力します。

ステップ 5

[展開ターゲット（Deployment target）] ページで、以下に示すように、[高可用性（High Availability）] 列で [非HA （Non-HA）] を選択します。

ステップ 6

[確認と展開（Review & Deploy）] ページでプロンプトが表示されたら、[展開（Deploy）]をクリックします。

ステップ 7

[ジョブ履歴（Job History）] タブをクリックして、NSO の展開を進行中に監視します。実行中のジョブの [ジョブの詳細（Job Details）] ウィンドウに一覧表示されるパッケージが表示されます。

ステップ 8

ジョブが [成功（Succeeded）] と表示されている場合は、[インストールされているNSO機能パック（Installed NSO Function packs）] タブをクリックし、NSO プロバイダーを展開して、パッケージがすべてインストールされていることを確認します。

パッケージリストは、以下の図のように表示されるはずです。

admin1@ncs% run show packages package oper-status | tab         
                                                                 
                           PROGRAM                              
                           CODE     JAVA           PYTHON       
NAME                   UP  ERROR    UNINITIALIZED  UNINITIALIZED 
-----------------------------------------------------------------
cisco-ios-cli-6.107    X   -        -              -              
cisco-iosxr-cli-7.62   X   -        -              -             
cisco-ztp              X   -        -              -             
dlm-svc                X   -        -              -              
fleet-upgrade          X   -        -              -              
goldenconfig           X   -        -              -              
inventory              X   -        -              -             
inventory-junos        X   -        -              -             
juniper-junos-nc-4.18  X   -        -              -              
resource-manager       X   -        -              -              
 
admin1@ncs% run show packages package package-version  | tab
                       PACKAGE
NAME                   VERSION
--------------------------------
cisco-ios-cli-6.107    6.107.2
cisco-iosxr-cli-7.62   7.62
cisco-ztp              2.0.0
dlm-svc                7.1.0
fleet-upgrade          2.0.0
goldenconfig           2.0.0
inventory              2.0.0
inventory-junos        2.0.0
juniper-junos-nc-4.18  4.18.8
resource-manager       4.2.9

ステップ 9

まだ行っていない場合は、NSO にログインし、構成モードで次のデバイスグローバル設定を行います。これらの NSO 設定は、Crosswork Workflow Manager ソリューションに必要です。

admin@ncs% set devices global-settings connect-timeout 600
admin@ncs% set devices global-settings read-timeout 600
admin@ncs% set devices global-settings write-timeout 600
admin@ncs% set devices global-settings ssh-algorithms public-key ssh-rsa
admin@ncs% set devices global-settings trace pretty
admin@ncs% set devices global-settings ned-settings 
                           cisco-iosxr read admin-show-running-config false
admin@ncs% commit
 
admin@ncs% show devices global-settings
connect-timeout 600;
read-timeout    600;
write-timeout   600;
ssh-algorithms {
    public-key [ ssh-rsa ];
}
trace           pretty;
ned-settings {
    cisco-iosxr {
        read {
            admin-show-running-config false;
        }
    }
}

ステップ 10

NSO には NETCONF アクセス制御モデル（NACM）が必要です。NACM ルールリストが、ncsadmin および Linux ユーザーに対して NSO 上で機能を実行する権限を付与していることを確認してください。次に例を示します。

admin@ncs% set nacm groups group ncsadmin user-name admin
admin@ncs% commit
 
 
admin@ncs% show nacm
read-default     deny;
write-default    deny;
exec-default     deny;
groups {
    group ncsadmin {
        user-name [ admin private ];
    }
    group ncsoper {
        user-name [ public ];
    }
}

ステップ 11

提供されたバンドルから ncs_backup.sh、 ncs_restore.sh 、 get_technical_support_data.sh のスクリプトを NCS_RUN_DIR の下の scripts ディレクトリにコピーし、コピーしたスクリプトの権限を更新して実行可能にします。

# Locate the NCS_RUN_DIR using the following command
cat /etc/systemd/system/ncs.service | grep NCS_RUN_DIR=
 
# Update the permissions
chmod +x ncs_backup.sh ncs_restore.sh get_technical_support_data.sh