Citrix DaaS™

複数のサイトを単一サイトに統合

自動構成のマルチサイトサポートは、複数のオンプレミスサイトを単一のクラウドサイトに統合する方法を提供します。

  • マルチサイトサポートは、オンプレミスサイトごとにコンポーネント名に一意のプレフィックスとサフィックスを追加し、複数のオンプレミスサイトが単一のクラウドサイトに統合された後も名前の一意性を確保します。

  • プレフィックスとサフィックスは、オンプレミスサイトごとに次の各コンポーネントに割り当てることができます。

  • AdminScope
  • AdminRole
  • ApplicationAdmin
  • ApplicationFolder
  • ApplicationGroup
  • ApplicationUser
  • DeliveryGroup
  • GroupPolicy
  • HostConnection
  • MachineCatalog
  • StoreFront
  • Tag

アプリケーションフォルダーは、プレフィックス、サフィックス、および再ルートをサポートしています。再ルートは、アプリケーションの既存のフォルダー構造に最上位のフォルダーを追加します。

プレフィックスとサフィックスのルール

  1. プレフィックスとサフィックスには、次の特殊文字を含めることはできません: \ , / ; : # . * ? = < > | ( ) " ' { } [ ]
  2. プレフィックスとサフィックスには末尾のスペースを含めることができますが、先頭のスペースを含めることはできません。
  3. 末尾のスペースを含めるには、プレフィックスとサフィックスを二重引用符で囲む必要があります。
  4. プレフィックスとサフィックスは、インポート、マージ、および追加時に適用されます。ソースの.ymlファイルは変更されません。
  5. プレフィックスとサフィックスのプロセスは、該当する場合、依存するコンポーネント名に自動的にプレフィックスまたはサフィックスを追加します。たとえば、マシンカタログ名に「East」というプレフィックスが付いている場合、それらを参照するデリバリーグループにも「East」というプレフィックスが付けられます。
  6. コンポーネント名がすでにプレフィックスまたはサフィックスで始まっている場合、プレフィックスまたはサフィックスは追加されません。コンポーネント名に二重の同一のプレフィックスまたはサフィックスを含めることはできません。
  7. プレフィックスとサフィックスは、個別に使用することも、組み合わせて使用することもできます。
  8. コンポーネントでのプレフィックスまたはサフィックスの使用はオプションです。

注:

Studioはコンポーネントをアルファベット順に表示します。

サイトごとのコンポーネントのグループ化

  • 単一サイトのコンポーネントを視覚的にグループ化するには、プレフィックスを使用します。各サイトは独自のグループにリストされ、プレフィックスによって異なるサイトグループの順序がアルファベット順に制御されます。

名前ごとのコンポーネントのグループ化

複数のサイトから同じ名前のコンポーネントを視覚的にグループ化するには、サフィックスを使用します。異なるサイトの同じ名前のコンポーネントは視覚的に交互に表示されます。

プレフィックスとサフィックスのマッピングファイル

サイトのプレフィックスは、1つ以上のオンプレミスサイトのサイトプレフィックスとサフィックスのマッピングを含むSiteMerging.ymlファイルから始まります。SiteMerging.ymlファイルは手動で管理することも、複数のオンプレミスサイトを統合するコマンドレットセクションにリストされている利用可能なコマンドレットを使用して管理することもできます。

オンプレミスサイトのエクスポート

オンプレミスサイトをエクスポートするまで、統合を開始することはできません。オンプレミスサイトをエクスポートするには、オンプレミス構成のエクスポートを参照してください。

中央エクスポートターゲットフォルダー

このセクションで説明する方法では、複数のサイトのエクスポートを中央のファイル共有場所に配置します。SiteMerging.ymlファイル、CustomerInfo.ymlファイル、およびすべてのエクスポートファイルはそのファイル共有場所に存在し、オンプレミスサイトとは独立して1つの場所からインポートを実行できます。

クラウドアクセス操作はオンプレミスサイトやActive Directoryを参照しないため、どこからでもクラウドアクセス操作を実行できます。

これを行うには2つの方法があります。

  • 直接ファイル共有: 直接ファイル共有からインポート、マージ、または追加するには、クラウドアクセス操作を実行するマシンを決定する必要があります。
  • SiteMerging.ymlを使用したファイル共有参照: この方法では、サイトのプレフィックスセットのSiteRootFolderメンバーを使用し、エクスポート、インポート、マージ、または追加時に誤ったフォルダーをターゲットにする可能性を減らします。

中央ファイル共有方法を使用しない場合は、個々のデリバリーコントローラーからインポート、マージ、または追加を実行します。クラウドに移行される各デリバリーコントローラーでSiteMerging.ymlファイルを作成し、複製します。デフォルトの場所は%HOMEPATH%\Documents\Citrix\AutoConfigです。正しいサイトプレフィックスを選択するには、–SiteNameパラメーターを指定する必要があります。

直接ファイル共有

エクスポート、インポート、マージ、および新規/追加操作では、デフォルトフォルダーである%HOMEPATH%\Documents\Citrix\AutoConfig以外のフォルダーをターゲットまたはソースとして指定するパラメーターが提供されます。次の例では、管理者がすでにアクセス権を持ち、必要に応じて資格情報を提供している\\share.central.netの中央ファイル共有を使用します。

エクスポートをサイト固有のフォルダーにターゲット設定するには、–TargetFolderパラメーターを使用します。

East Delivery Controller™から:

mkdir  \\share.central.net\AutoConfig\SiteEast

Export-CvadAcToFile   –TargetFolder   \\share.central.net\AutoConfig\SiteEast
<!--NeedCopy-->

West Delivery Controllerから:

mkdir  \\share.central.net\AutoConfig\SiteWest

Export-CvadAcToFile   –TargetFolder   \\share.central.net\AutoConfig\SiteWest`
<!--NeedCopy-->

エクスポートが完了したら、CustomerInfo.ymlファイルとSiteMerging.ymlファイルを作成し、\\share.central.net\AutoConfigに配置します。

注:

この直接ファイル共有参照方法を使用する場合、SitePrefixes.ymlを作成するときにSiteRootFolderパラメーターを使用しないでください。

直接ファイル共有からインポート、マージ、または追加するには、クラウドアクセス操作を実行するマシンを決定する必要があります。オプションは次のとおりです。

  • ツールがすでにインストールされているオンプレミスデリバリーコントローラーのいずれか。
  • ファイル共有をホストしているマシン。
  • 別のマシン。

クラウドにアクセスするマシンには、自動構成がインストールされている必要があります。オンプレミスのPowerShell SDK、デリバリーコントローラー、Active Directoryのいずれも使用されないため、クラウドアクセス実行の要件はエクスポートの要件よりも単純です。

East Delivery Controllerをクラウドに統合するには:

Merge-CvadAcToSite –SiteName East –SourceFolder  \\share.central.net\AutoConfig\SiteEast -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
<!--NeedCopy-->

West Delivery Controller をクラウドにマージするには:

Merge-CvadAcToSite –SiteName West –SourceFolder  \\share.central.net\AutoConfig\SiteWest -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
<!--NeedCopy-->

以下は、前の例で使用された SitePrefixes.yml ファイルのサンプルです。

    East:
      SiteRootFolder: "" # 重要: このフィールドは空のままにしてください
      AdminScopePrefix: "East_"
      AdminRolePrefix: "East_"
      ApplicationAdminPrefix: "East_"
      ApplicationFolderPrefix: "" # 代わりに新しい親ルートフォルダーが使用されることに注意してください
      ApplicationFolderRoot: "East"
      ApplicationGroupPrefix: "East_"
      ApplicationUserPrefix: "East_"
      DeliveryGroupPrefix: "East_"
      GroupPolicyPrefix: "East_"
      HostConnectionPrefix: "East_"
      MachineCatalogPrefix: "East_"
      StoreFrontPrefix: "East_"
      TagPrefix: "East_"
      AdminScopeSuffix: "_east"
      AdminRoleSuffix: "_east"
      ApplicationAdminSuffix: "_east"
      ApplicationFolderSuffix: "_east"
      ApplicationGroupSuffix: "_east"
      ApplicationUserSuffix: "_east"
      DeliveryGroupSuffix: "_east"
      GroupPolicySuffix: "_east"
      HostConnectionSuffix: "_east"
      MachineCatalogSuffix: "_east"
      StoreFrontSuffix: "_east"
      TagSuffix: "_east"
    West:
      SiteRootFolder: "" # 重要: このフィールドは空のままにしてください
      AdminScopePrefix: "Western "
      AdminRolePrefix: "Western "
      ApplicationAdminPrefix: "Western "
      ApplicationFolderPrefix: "" # 代わりに新しい親ルートフォルダーが使用されることに注意してください
      ApplicationFolderRoot: "Western"
      ApplicationGroupPrefix: "Western "
      ApplicationUserPrefix: "Western "
      DeliveryGroupPrefix: "Western "
      GroupPolicyPrefix: "Western "
      HostConnectionPrefix: "Western "
      MachineCatalogPrefix: "Western "
      StoreFrontPrefix: "Western "
      TagPrefix: "Western "
      AdminScopeSuffix: ""
      AdminRoleSuffix: ""
      ApplicationAdminSuffix: ""
      ApplicationFolderSuffix: ""
      ApplicationGroupSuffix: ""
      ApplicationUserSuffix: ""
      DeliveryGroupSuffix: ""
      GroupPolicySuffix: ""
      HostConnectionSuffix: ""
      MachineCatalogSuffix: ""
      StoreFrontSuffix: ""
      TagSuffix: ""

SiteMerging.yml を使用したファイル共有参照

この方法では、サイトのプレフィックスセットの SiteRootFolder メンバーを使用します。直接ファイル共有する方法よりも複雑ですが、この方法を使用すると、エクスポート、インポート、マージ、または追加の際に誤ったフォルダーをターゲットにする可能性が低減されます。

まず、SiteMerging.yml ファイルで各サイトの SiteRootFolder を設定します。これは共有場所で実行する必要があります。

New-CvadAcSiteMergingInfo –SiteName East –SiteRootFolder \\share.central.net\AutoConfig\SiteEast -SitePrefixesFolder  \\share.central.net\AutoConfig

New-CvadAcSiteMergingInfo –SiteName West –SiteRootFolder SiteWest -SitePrefixesFolder  \\share.central.net\AutoConfig
<!--NeedCopy-->

この例では、East は完全修飾フォルダー指定であり、West は相対フォルダー指定です。

SiteMerging.yml ファイルを使用してエクスポートをサイト固有のフォルダーにターゲット設定するには:

East Delivery Controller から:

mkdir  \\share.central.net\AutoConfig\SiteEast

Export-CvadAcToFile   -SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
<!--NeedCopy-->

West Delivery Controller から:

mkdir  \\share.central.net\AutoConfig\SiteWest

Export-CvadAcToFile   -SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
<!--NeedCopy-->

エクスポートコマンドレットは、CustomerInfo.yml フォルダーの場所を使用して SiteMerging.yml ファイルを検索します。East の場合、SiteRootFolder は完全修飾されています。これはそのまま使用されます。West の場合、SiteRootFolder は完全修飾されていません。これは CustomerInfo.yml フォルダーの場所と組み合わされて、West の完全修飾フォルダーの場所が取得されます。

East Delivery Controller をクラウドにマージするには:

Merge-CvadAcToSite –SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
<!--NeedCopy-->

West Delivery Controller をクラウドにマージするには:

Merge-CvadAcToSite –SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
<!--NeedCopy-->

以下は、前の例で使用された SitePrefixes.yml ファイルのサンプルです。

      East:
      SiteRootFolder: "\\\\share.central.net\\AutoConfig\\SiteEast"
      AdminScopePrefix: "East_"
      AdminRolePrefix: "East_"
      ApplicationAdminPrefix: "East_"
      ApplicationFolderPrefix: "" # 代わりに新しい親ルートフォルダーが使用されることに注意してください
      ApplicationFolderRoot: "East"
      ApplicationGroupPrefix: "East_"
      ApplicationUserPrefix: "East_"
      DeliveryGroupPrefix: "East_"
      GroupPolicyPrefix: "East_"
      HostConnectionPrefix: "East_"
      MachineCatalogPrefix: "East_"
      StoreFrontPrefix: "East_"
      TagPrefix: "East_"
      AdminScopeSuffix: "_east"
      AdminRoleSuffix: "_east"
      ApplicationAdminSuffix: "_east"
      ApplicationFolderSuffix: "_east"
      ApplicationGroupSuffix: "_east"
      ApplicationUserSuffix: "_east"
      DeliveryGroupSuffix: "_east"
      GroupPolicySuffix: "_east"
      HostConnectionSuffix: "_east"
      MachineCatalogSuffix: "_east"
      StoreFrontSuffix: "_east"
      TagSuffix: "_east"
    West:
      SiteRootFolder: "\\\\share.central.net\\AutoConfig\\SiteWest"
      AdminScopePrefix: "Western "
      AdminRolePrefix: "Western "
      ApplicationAdminPrefix: "Western "
      ApplicationFolderPrefix: "" # 代わりに新しい親ルートフォルダーが使用されることに注意してください
      ApplicationFolderRoot: "Western"
      ApplicationGroupPrefix: "Western "
      ApplicationUserPrefix: "Western "
      DeliveryGroupPrefix: "Western "
      GroupPolicyPrefix: "Western "
      HostConnectionPrefix: "Western "
      MachineCatalogPrefix: "Western "
      StoreFrontPrefix: "Western "
      TagPrefix: "Western "
      AdminScopeSuffix: ""
      AdminRoleSuffix: ""
      ApplicationAdminSuffix: ""
      ApplicationFolderSuffix: ""
      ApplicationGroupSuffix: ""
      ApplicationUserSuffix: ""
      DeliveryGroupSuffix: ""
      GroupPolicySuffix: ""
      HostConnectionSuffix: ""
      MachineCatalogSuffix: ""
      StoreFrontSuffix: ""
      TagSuffix: ""

サイトのマージ

Citrix® は、クラウド操作を段階的に実行し、次のクラウド操作を行う前に各結果を完全にレビューすることを推奨します。たとえば、3 つのサイトを単一のクラウドサイトにマージする場合:

  1. 適切な SiteName 値を使用して、最初のサイトをクラウドにマージします
  2. Studio で結果を確認します
  3. 結果が正しくない場合は、問題とその原因を特定し、修正してからマージを再実行します。必要に応じて、選択したコンポーネントとメンバーに対して Remove-CvadAcFromSite を使用してクラウドコンポーネントを削除し、最初からやり直します。結果が正しい場合は、続行します
  4. 最初のマージが正しい場合は、2 番目のサイトを単一のクラウドサイトにマージします
  5. 手順 2 と 3 を繰り返します
  6. 2 番目のマージが正しい場合は、3 番目のサイトを単一のクラウドサイトにマージします
  7. 手順 2 と 3 を繰り返します
  8. ユーザーの視点からリソースをレビューし、ビューが目的の状態であることを確認します

サイトプレフィックスを使用したコンポーネントの削除

Remove-CvadAcFromSite コマンドレットの –IncludeByName パラメーターでプレフィックスを使用することにより、単一のサイトコンポーネントを選択的に削除できます。次の例では、West Delivery Controller のデリバリーグループが正しくありません。West サイトのみのデリバリーグループを削除するには:

Remove-CvadAcFromSite   –DeliveryGroups   –IncludeByName “Western *”
<!--NeedCopy-->

すべての West コンポーネントを削除するには、次のコマンドレットを順番に実行します。

Remove-CvadAcFromSite –GroupPolicies –IncludeByName “Western *”

Remove-CvadAcFromSite –Applications –IncludeByName “Western *”

Remove-CvadAcFromSite – ApplicationGroups –IncludeByName “Western *”

Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”

Remove-CvadAcFromSite –MachineCatalogs –IncludeByName “Western *”

Remove-CvadAcFromSite –HostConnections –IncludeByName “Western *”

Remove-CvadAcFromSite –Tags –IncludeByName “Western *”

East コンポーネントのグループポリシーを削除するには、サフィックスを使用します:

Remove-CvadAcFromSite   –GroupPolicies   –IncludeByName “*_east”
<!--NeedCopy-->
複数のサイトを単一サイトに統合