クラウド構成をオンプレミスに移行する

この記事では、クラウド構成をバックアップし、オンプレミスサイトに移行する方法について説明します。

構成を移行するための前提条件

  • 少なくとも1つの登録済みVDAを持つCitrix Virtual Apps and Desktops™オンプレミス環境。
  • 次のいずれかのバージョンで実行されているCitrix Virtual Apps and Desktopsオンプレミス環境:
    • 最新の長期サービスリリース (LTSR) バージョン - 2402。
    • いずれかの現在のリリース (CR) バージョン - 2308、2311。
  • .Net 4.7.2以降のバージョンがインストールされたドメイン参加済みマシンで、Automated Configuration tool (ACT) コマンドを実行します。
  • シトリックス PowerShell SDK がインストールされたマシン。PowerShell SDK は、シトリックス Delivery Controller™ のインストール可能なコンポーネントとして利用できます。

注:

  • 別のマシンでACTを実行している場合は、そのマシンがドメインに参加している必要があり、Studioには適切なPowerShellスナップインがインストールされている必要があります。インストーラーを入手するには、Citrix Virtual Apps and DesktopsダウンロードWebサイトにアクセスしてください。
  • オンプレミスサイトでは、ACTをDelivery Controllerにインストールすることをお勧めします。ACTはデスクトップアイコンから起動できます。
  • ACTを標準のPowerShellウィンドウから使用する場合は、次のコマンドを実行する必要があります。 Import-Module Citrix.AutoConfig.Commands

ACTはシステムPowerShellパスの一部ではないため、明示的にインポートする必要があります。

主要な手順

クラウド構成をオンプレミスに移行する手順は次のとおりです。

  1. クラウド構成のバックアップ
  2. YML ファイルの変更
  3. 構成をオンプレミスにインポート

クラウド構成のバックアップ

  1. オートメーテッド構成」をインストールします。
  2. Auto Config アイコンをダブルクリックします。PowerShell ウィンドウが表示されます。
  3. CustomerInfo.yml ファイルを作成するには、New-CvadAcCustomerInfoFileを実行します。詳細については、「顧客情報ファイルの入力」を参照してください。
  4. クラウド構成のバックアップを作成するには、コマンド Backup-CvadAcToFile を実行します。

    注:

    • 任意のコマンドレットを初めて実行すると、.yml 構成ファイルとログを含むエクスポートフォルダーが作成されます。フォルダーは %HOMEPATH%\Documents\Citrix\AutoConfig にあります。
    • エラーまたは例外が発生した場合は、ログファイルの Fixups セクションを参照してください。
    • Backup-CvadToFile は、パラメーター IncludeByName または ExcludeByName をサポートしていません。

重要:

Citrix では、すべてのコンポーネントをまとめてバックアップすることをお勧めします。

YMLファイルの変更

次の表に示すように、%HOMEPATH%\Documents\Citrix\AutoConfigにある.ymlファイルを変更して、オンプレミスの詳細を含めます。

YMLファイル パラメーター 説明文 例示
カスタマー情報.yml デプロイ環境 Environment を OnPrem に変更します。環境パラメーターの値は大文字と小文字を区別します。  
ゾーンマッピング.yml ダース:シーブイエーディー クラウドのリソースの場所をオンプレミスのゾーンにマッピングします。 old:new ゾーンである必要があります
CvadAcセキュリティ.yml ハイパーバイザー: 接続タイプ: ‘ ‘ ユーザー名: ‘ ’ パスワード: ‘ ‘ ハイパーバイザーのユーザー名とパスワードを追加します。 If the hypervisor is XenServer,XenServer: ConnectionType: ‘XenServer’ Username: ‘root’ Password: ‘ ‘

オンプレミスへの構成のインポート

  1. 要件に基づいて、オンプレミスサイトで次のいずれかのコマンドを実行します。
    1. Merge-CvadAcToSite - オンプレミスサイトが稼働しており、クラウド構成をそれにマージする場合。
    2. Import-CvadAcToSite -Environment OnPrem - オンプレミス構成が利用できず、クラウド構成をインポートして新しいものを作成する場合。

重要:

Citrixは、競合を避けるために、一度に1つのコンポーネントをインポートすることを推奨します。

クラウド構成をオンプレミスに移行する