Citrix DaaS™

Nutanixカタログの管理

マシンカタログの管理では、マシンカタログを管理するウィザードについて説明しています。以下の情報は、Nutanix AHV Prism Central環境に固有の詳細を扱っています。

注記:

Nutanix AHV Prism Centralでマシンカタログを管理する前に、Nutanix AHV Prism Centralでマシンカタログの作成を完了する必要があります。Nutanixカタログの作成を参照してください。

Nutanix AHV Prism Centralでマシンカタログを管理するには、以下を使用できます。

Studioの使用

Studioを使用してNutanix AHV Prism Centralでマシンカタログを管理するためのオプションは次のとおりです。

オプション 説明
マシンの追加 マシンカタログにVMを作成して追加します。
マシンカタログの削除 マシンカタログを削除します。同時にVMを削除するか、永続VMをそのまま残すかを選択できます。
マスターイメージの変更 カタログ内のすべてのVMのテンプレートとして使用されるマスターイメージを変更します。
マシンプロファイルの追加または変更 マシンプロファイルのテンプレートバージョンを変更するか、既存のカタログにマシンプロファイルを追加します。
構成セットの管理 カタログをWorkspace Environment Management™構成セットにバインドするか、別の構成に切り替えます。
マシンカタログの編集 NICや仮想マシンなど、カタログの構成を変更します。
マシンの表示 検索ノードに移動して、カタログに属するすべてのVMを表示します。
マシンカタログ名の変更 カタログ名を変更します。
VDAのアップグレード カタログごとにVDAをアップグレードします。この機能は、静的永続マシンにのみ適用されます。
機能レベルの変更 カタログの最小機能レベルを選択します。機能レベルを設定すると、すべての機能が利用可能になります。
マシンカタログのテスト カタログにエラーまたは警告があるかどうかをテストします。
タグの管理 タグを作成、編集、削除します。カタログに適用するタグを選択します。
マシンカタログの移動 カタログを別のフォルダーに移動します。

注記:

現在、クローンオプションは利用できません。

マスターイメージの変更

カタログのマスターイメージを変更するには、次の手順に従います。

  1. [マシンカタログ]ページで、更新するマシンカタログを右クリックし、[マスターイメージの変更]を選択します。
  2. [マスターイメージの変更]ページで、[イメージの選択]をクリックします。

    • マスターイメージの変更ページでイメージを選択する画面
  3. [イメージの選択]ページで、テンプレートを展開し、マスターイメージとして使用するテンプレートバージョンを選択します。マシンテンプレートは名前でフィルタリングできます。
  4. [ロールアウト戦略]ページで、更新を適用するタイミングを選択します。

注記:

  • Nutanix AHV Prism Centralホスト接続プラグインを使用するMCSプロビジョニングされた非永続カタログの場合、マスターイメージを更新してブート構成をLegacyとUEFIの間で切り替えると、既存のVMが次回の起動時に開始できなくなります。

  • マスターイメージを更新すると、OSディスクのみが更新されます。ハードウェアプロパティは変更されません。ハードウェアプロパティを更新するには、マシンプロファイルの追加または変更NICの変更、およびVM構成の変更を参照してください。

マシンプロファイルの追加または変更

カタログのマシンプロファイルを追加または変更するには、次の手順に従います。

  1. [マシンカタログ]ページで、変更するマシンカタログを右クリックし、[マシンカタログの編集]を選択します。
  2. [マシンプロファイル]ページで、

    • マシンカタログにすでにマシンプロファイルがある場合は、鉛筆アイコンをクリックして別のマシンプロファイルテンプレートバージョンを選択します。テンプレート名でフィルタリングできます。マシンプロファイルの設定を確認します。
    • マシンカタログにマシンプロファイルがない場合は、[マシンプロファイルを使用]を選択し、マシンプロファイルを選択します。マシンプロファイルの設定を確認します。
    1. [仮想マシン]ページには、選択したマシンプロファイルテンプレートバージョンに従って更新された構成が反映されている必要があります。

NICの変更

カタログのNICを変更するには、次の手順に従います。

  1. [マシンカタログ]ページで、変更するマシンカタログを右クリックし、[マシンカタログの編集]を選択します。
  2. [NIC]ページで、

    • NICタイプを選択します。
    • 選択したカタログがマシンプロファイルで作成された場合、NICの数はマシンプロファイルのNICの数と一致しており、変更できません。各NICに関連付けられた仮想ネットワークを選択します。
  • マシンプロファイルを使用したNutanix AHV Prism Central NIC

    • 選択したカタログがマシンプロファイルなしで作成された場合、[NICの追加]をクリックしてNICの数を増やすか、[削除]をクリックして選択したNICを削除します。ボックスを選択またはクリアしてNICを選択し、各NICに関連付けられた仮想ネットワークを選択します。

      マシンプロファイルを使用しないNutanix AHV Prism Central NIC

VM構成の変更

メモリ、CPU数、vCPUあたりのコア数など、VMの構成を変更するには、次の手順に従います。

  1. [マシンカタログ]ページで、変更するマシンカタログを右クリックし、[マシンカタログの編集]を選択します。
  2. [仮想マシン]ページで、上矢印または下矢印を使用するか、値を直接入力して、VMのメモリ、CPU数、およびvCPUあたりのコア数を調整します。

    Nutanix AHV Prism Centralホスト接続 - カタログVMの編集

PowerShellの使用

マスターイメージの変更

必要なパラメーターは次のとおりです。

  • ProvisioningSchemeName: 編集するプロビジョニングスキームの名前。
  • MasterImage: 新しいマスターイメージへのリテラルパス。

次のコマンドを実行します。例:


Set-ProvSchemeMetadata  -Name "ImageManagementPrep_DoImagePreparation" -ProvisioningSchemeName "<ProvisioningSchemeName>" -Value "True"

Publish-ProvMasterVMImage  -MasterImageVM "<Literal path to the new master image- template version> -ProvisioningSchemeName "<ProvisioningSchemeName>" -RunAsynchronously

<!--NeedCopy-->

注:

マスターイメージを更新すると、OSディスクのみが更新されます。ハードウェアプロパティは変更されません。ハードウェアプロパティを更新するには、「マシンプロファイルの追加または変更」、「NICの変更」、および「NICとVMの構成の変更」を参照してください。

マシンプロファイルの追加または変更

Set-ProvScheme コマンドを使用します。

  • 新しいマシンプロファイルでカタログを更新する場合、または
  • マシンプロファイルを持たない既存のカタログを、ハードウェア仕様のソースとしてマシンプロファイルを使用するように更新する場合。

注:

これは、カタログ内の既存のVMのハードウェア仕様を更新するものではありません。カタログに追加された新しいVMのみが、指定されたマシンプロファイルからのハードウェア仕様を持ちます。

  • マシンプロファイルを変更するか、既存のカタログをマシンプロファイルの使用を開始するように変換するには:

-  Set-ProvScheme -ProvisioningSchemeName <ProvScheme Name> `                  
-  -MachineProfile "XDHyp:\HostingUnits\<Hosting Unit Name>\Templates.folder\<Template Name>.template\<Template Version Name>.templateversion"
               -NetworkMapping @{"0"="XDHyp:\HostingUnits\<Hosting unit name>\Clusters.folder\<Cluster Name>.cluster\<Network name>.network"} 
-  <!--NeedCopy-->

マシンプロファイルには少なくとも1つのNICが必要であり、マシンプロファイル内のNICの数は NetworkMapping のサブネットマッピングと一致する必要があります。

テンプレートバージョンのNICの総数は、そのインベントリアイテムの AdditionalData から次を使用して取得できます。

-  ```
-  $tv = Get-Item -Path "XDHyp:\HostingUnits\<Hosting Unit Name>\Templates.folder\<Template Name>.template\<Template Version Name>.templateversion"
-  $tv.AdditionalData.TotalNics
-  <!--NeedCopy--> ```
  • 上書きされたハードウェア仕様でマシンプロファイルを変更するには:

  • 特定の構成は、特定のコマンドラインパラメーターを使用して構成できます。これらのコマンドラインパラメーター(VMCpuCountVMMemoryMB、および CustomProperties 内の CPUCores など)は、マシンプロファイルテンプレートバージョンの値よりも優先されます。

  • ``` $customProperties = @”
  • ”@

  • Set-ProvScheme -ProvisioningSchemeName `
  • -MachineProfile “XDHyp:\HostingUnits<Hosting Unit Name>\Templates.folder<Template Name>.template<Template Version Name>.templateversion” `
  • -CustomProperties $customProperties `
  • -VMCpuCount 4 ` -VMMemoryMB 4096

### NICとVMの構成の変更

-  必要なパラメーターは次のとおりです。

-  `ProvisioningSchemeName`: 編集するプロビジョニングスキームの名前。
-  `NetworkMapping`: 更新されたネットワークマッピング。

次のコマンドを実行します。例:

    -  ```
    -  Set-ProvScheme  -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"><Property xsi:type=`"StringProperty`" Name=`"ClusterId`" Value=`"000xxxx-1fb0-xxxxx-4fc8-5c257335xxxx`" /><Property xsi:type=`"StringProperty`" Name=`"CPUCores`" Value=`"1`" /></CustomProperties>"  -NetworkMapping @{"6"="XDHyp:\HostingUnits\<Hosting Unit Name>\Clusters.folder\<Cluster Name>\<Network name>.network"} -ProvisioningSchemeName "<ProvisioningSchemeName>" -VMCpuCount 4
    -  <!--NeedCopy-->

マシンカタログのCitrix管理Nutanix AHV Prism Centralホスト接続への移行

-  既存のNutanix AHV (Prism Element用) およびNutanix AHV PC (NC2 on Azure用) ホスト接続から、Citrix管理Nutanix AHV Prism Centralホスト接続へ、Citrixマシンカタログおよび関連するVMを移行します。移行にはPowerShellコマンドを使用します。これには、問題発生時の高速ロールバックオプションや、移行後のソースリソースをクリーンアップするコマンドも含まれます。

利点

-  **中断の最小化**: Nutanix AHV Prism Centralプラグインへのスムーズな移行が可能です。これにより、既存の展開への影響を最小限に抑えます。
-  **シームレスなアップグレードパス**: インフラストラクチャをアップグレードし、新しい管理インターフェイスを活用するための明確でサポートされたパスを提供します。
-  **データの整合性と安全性**: ロールバックオプションにより、予期せぬ問題が発生した場合でも環境を元の状態に戻すことができます。これにより、リスクが軽減されます。
  • リソース効率: 移行が成功した後、ソースリソースをクリーンアップします。これにより、ストレージと管理のオーバーヘッドが最適化されます。
  • 柔軟性: MCSとサードパーティテクノロジーの両方によってプロビジョニングされたカタログの移行をサポートします。これにより、幅広い適用性が提供されます。

適用範囲

この機能は、Nutanix AHV (Prism Element用) およびNutanix AHV PC (NC2 on Azure用) ホスト接続下のマシンカタログに適用されます。

  • 永続タイプと非永続タイプの両方を含む、MCSによって管理されるマシンカタログ。
  • サードパーティテクノロジーによってプロビジョニングされたVMを含む、電源管理のみのマシンカタログ。

システム要件

  • Nutanix AHV Prism Element (PE) AOSバージョン: 最小バージョン6.8が必要です。
  • Nutanix Prism Central (PC) バージョン: 最小バージョン2024.3が必要です。

注:

Nutanixの既知の問題により、Nutanix Prism Central 7.3にはAOS 7.3が必要です。

制限事項

  • PVSカタログはサポートされていません: この機能は、Citrix Provisioning Services (PVS) Xendesktop Setup Wizard を使用して作成されたマシンカタログをサポートしていません。
  • ロールバックの制限事項:
    • 最初の移行後にカタログを変更していない場合にのみ、移行されたカタログのロールバックを許可します。
    • ソースリソースのクリーンアップ」操作を実行すると、移行状態がクリアされます。これにより、その後のロールバックが防止されます。
  • 再移行はできません: 既に移行したマシンカタログは、再移行をサポートしていません。
  • 複数ホスト接続VM: 複数のホスト接続からインポートされたVMを含む、電源管理のみのマシンカタログの移行はサポートされていません。

重要な考慮事項

  • Nutanixクラスター管理: ホスティングNutanix AHVクラスターは、Nutanix Prism Centralに登録されている必要があります。
  • マスターイメージテンプレートの作成: MCSマシンカタログの場合、移行コマンドには、マシンカタログのマスターイメージの元のスナップショットからPrism Central上にVMテンプレートバージョンを生成するオプションが用意されています。このVMテンプレートバージョンは、後でPrism Centralホスト接続下のマシンカタログのMCSマスターイメージとして使用できます。デフォルトでは、このオプションは有効になっていません。
  • ロールバックの前提条件:

ロールバックを成功させるには、ホスト接続、ベースディスクを含む元のソース環境が変更されていない必要があります。また、移行が成功したと確認されるまで、移行されたマシンカタログへの構成変更やVMの追加/削除を避ける必要があります。確認後、最終的な「ソースリソースのクリーンアップ」操作を実行できますが、これは元に戻せない手順であり、ロールバックが不可能になることに注意してください。

移行とロールバックに必要な権限

カタログを移行またはロールバックするには、次の権限が必要です。

Prism Element管理者:

  • 仮想マシンの作成

Prism Central管理者:

  • VMテンプレートの作成
  • VMテンプレートの削除
  • VMリカバリポイントの削除
  • 仮想マシンの削除

Citrix管理のNutanix AHV Prism Centralホスト接続に必要な特定の権限の完全なリストについては、「必要な権限」を参照してください。

移行方法

この機能は、専用のPowerShellコマンドレットを通じて管理します。一般的なワークフローには、移行、ロールバック、ソースリソースのクリーンアップの3つの主要な操作が含まれます。

マシンカタログの移行

  • この操作は、マシンカタログとその関連VMを、ソースのNutanix AHVまたはNutanix AHV PCホスト接続から、ターゲットのCitrix管理Nutanix AHV Prism Centralホスト接続に移動します。
  • MCSプロビジョニングされたカタログの場合、このプロセスはターゲット接続に新しいベースディスクを作成します。
  • オプションで、元のマスターイメージスナップショットからターゲット接続にマスターVM相当(VMテンプレートバージョン)を作成することを選択できます。
  1. 新しいNutanix AHV Prism Centralホスト接続の作成: 移行する前に、ホスティングNutanix AHVクラスターをNutanix Prism Centralに登録し、ターゲットのNutanix Prism Centralインスタンスを指す新しいNutanix AHV Prism Centralホスト接続を確立します。この接続は、移行されたカタログの宛先として機能します。詳細については、「Nutanix AHV Prism Centralホスト接続」を参照してください。
  2. 既存のマシンカタログの移行: 既存のマシンカタログの場合、Switch-ProvCatalog PowerShellコマンドレットを使用して、Citrix管理のNutanix AHV Prism Centralホスト接続への移行を開始します。

    
    c:\PS>Switch-ProvCatalog -BrokerCatalogUid <Catalog_UID> -DestinationHypervisorConnectionName "DestinationConnection" -DestinationHostingUnitName "DestinationUnit" -CreateMasterImageAtDestination
    
    <!--NeedCopy-->
    
    • <Catalog_UID> を、移行するマシンカタログの一意の識別子に置き換えます。カタログ名 Get-BrokerCatalog -Name <Catalog Name>BrokerCatalogUid を見つけるには、次のPowerShellコマンドレットを使用します。
    • DestinationConnection は、手順1で作成した新しいNutanix AHV Prism Centralホスト接続の名前です。
    • DestinationUnit は、マシンカタログが配置される DestinationConnection 内のホスティングユニットに付ける名前です。
    • -CreateMasterImageAtDestination パラメーターはオプションです。これは、ターゲットのPrism Central上にマスターイメージVMテンプレートバージョンを作成します。
  3. 移行完了の確認: 移行コマンドレットを実行した後、PowerShellウィンドウでタスクステータスを監視し、正常に完了したことを確認します。移行が完了すると、カタログは手順1で作成されたターゲットホスト接続に移動されます。タスクタイプ SwitchProvCatalog でステータスが完了したことを確認する必要があります。移行完了を確認するための推奨手順は次のとおりです。

    • Studioでカタログのステータスを確認します。
    • カタログ内のVMが新しい宛先ハイパーバイザー接続に関連付けられていることを確認します。
    • カタログ内のVMが正しい電源状態を表示していることを確認します。
    • マシンを追加または削除したり、電源操作を実行したりして、移行されたマシンカタログの機能をテストし、カタログが正しく機能していることを確認します。

移行されたカタログのロールバック

この操作は、マシンカタログとそのVMを元のソースホスト接続に戻します。移行プロセス中に作成したリソースはすべて削除されます。

重要:

移行後にカタログを変更しておらず、「ソースリソースのクリーンアップ」操作を実行していない場合にのみ、ロールバックを実行します。元のソース接続は変更されず、ベースディスクは引き続き含まれています。


c:\PS>Switch-ProvCatalog -BrokerCatalogUid <Catalog_UID> -Rollback

<!--NeedCopy-->

ソースリソースのクリーンアップ

移行が成功した後、この操作は、元のハイパーバイザー接続からベースディスクなどのソースリソースを削除します。

重要:

このコマンドを実行すると、移行状態がクリアされます。これにより、その後のロールバックが不可能になります。


c:\PS>Switch-ProvCatalog -BrokerCatalogUid <Catalog_UID> -CleanupSourceResources

<!--NeedCopy-->

この操作は元に戻せないため、続行する前に確認プロンプトが表示されます。プロンプトを承認してクリーンアップを完了します。

詳細情報

Nutanixカタログの管理