PoC ガイド:自動構成ツール-オンプレミスでのバックアップと復元

概要

Citrix 自動構成ツール(ACT)は、オンプレミスとクラウドの両方でワークロードを移行し、毎日のCitrix 管理タスクを支援します。 ACTのバックアップと復元機能により、Citrix管理者はサイトの現在の状態を含む構成ファイル(.yaml)にCitrixサイトのバックアップを作成できます。これは、インクリメンタルバックアップではなく、Citrix サイトの特定の時点のスナップショットと考えてください。ACTは、Citrixコンポーネント(マシンカタログ、デリバリーグループ、アプリケーション、ホスト接続)ごとに構成ファイルを生成します。 ACTのバックアップと復元機能は、Citrix Web Studioコンソールの一部としてのみ使用できます。記事「 Web Studioのインストール 」では、Citrix Web Studioコンソールのインストールと構成に必要な手順について詳しく説明しています。

Web Studio

バックアップと復元のプロセス

Citrix Web Studioで[バックアップ+復元]タブを選択すると、自動構成ツールをダウンロードしてインストールするように求められます。バックアップと復元のプロセスは、ACTのPowerShell SDKを使用して完了します。

ACT ダウンロード 1

.msi ファイルをダウンロードし、自動構成ツールをインストールします。Citrix Delivery Controllerサーバーにインストールすることをお勧めします。

ACT ダウンロード 2

自動構成ツールをインストールしたら、「プログラムと機能」の下に表示されている内容を確認して、インストールを確認します。

ACT コントロールパネル

自動構成ツール用に「 自動構成 」という名前のダイレクト・アクセス・アイコンがデスクトップ上に作成されます。

ACT ダイレクトアクセス

バックアップと復元の作成

ツールを使い始める前に、自動化設定ツールの主な基本コマンドレットについて理解しておきましょう。

  • バックアップ-CVADACTOFile -Citrix サイトのすべての構成をバックアップします。
  • 復元-CVADACTOSITE-バックアップYAMLファイルをCitrix サイトに復元します 。これは、同じCitrix サイトを指す場合もあれば、別のCitrix サイトを指す場合もあります。

これらのコマンドレットに基づいて、必要なコンポーネントを完全に復元することも、 -includebyname などの特定のリソース/構成ファイル (.yml) を指すスイッチを追加して、必要なコンポーネントを細かく選択することもできます (これについては後で説明し、例を示します)。

前述のように、サイトのバックアップは簡単なプロセスです。自動構成ツールはサイトの「スナップショット」を構成ファイルにエクスポートします。ACT ファイルは %HOMEPATH%\ Documents\ Citrix\ AutoConfigフォルダにあります

以下は、バックアップフォルダの内容を表示するスクリーンショットです。バックアップごとに、バックアップが完了した日付とタイムスタンプを含む一意のフォルダが作成されます。すべてのバックアップフォルダには、復元に使用できる設定ファイルがあります。

ACT ダウンロード 3

バックアップと復元の例

この例では、自動構成ツールを使い始めるための以下のプロセスを順を追って説明します。

  1. 基本フォルダ構造 %HOMEPATH%\ Documents\ Citrix\ AutoConfig を作成しています
  2. オンプレミス用の CustomerInfo.yml ファイルの変更
  3. バックアップの作成
  4. バックアップからの復元

フォルダー構造の作成

ACT では、バックアップ中に生成された.yml ファイルを見つけるためのフォルダー構造が必要です。まず、初期構成を「エクスポート」する必要があります。

  • ACT を起動し、コマンド Export-CvadAcToFileFile を実行します

ACT エクスポート 1

ACT はフォルダー構造を作成し、その中に設定ファイルを作成します。以下は、結果を表示するスクリーンショットです。

ACT エクスポート 2

オンプレミスの設定ファイルの変更

  • C:\Users %username%\ Documents\ Citrix\ AutoConfig から CustomerInfo.ymlファイルを開きます
  • 「環境」変数を見つけて、「プロダクション」の値を「OnPram」に置き換えます

注:

‘OnPrem’ パラメータでは大文字と小文字が区別されることに注意してください。必ず「O」と「P」の両方を大文字にしてください。そうしないと、Citrix Cloudへのログインを求められます。

ACT エクスポート 3

バックアップの作成

フォルダ構造の準備ができたら、引き続き ‘Backup’ コマンドレットを実行できます。 前述のように、バックアップを作成するには、次のコマンドを実行する必要があります。 Backup-CvadAcToFile

ACT コンフィグバックアップ 1

ACT コンフィグバックアップ 2

バックアップからの復元

インポートされるファイルは、-RestoreFolder パラメーターを使用して指定されたフォルダーから取得されます。このパラメータは、サイトを復元する.yml ファイルを格納するフォルダを認識します。これは完全修飾フォルダーパスでなければなりません。このコマンドレットを使用して、以前の構成に戻したり、Citrix サイトをバックアップおよび復元したりすることもできます。このコマンドは、Citrix Cloudサイトを追加、削除、および更新できます。

注:

スイッチ名は各.yamlファイルの内容に対応しているため、マシンカタログ、デリバリーグループ、アプリケーション、ポリシーなどのコンポーネントを復元できます。

リストアの精度とそれに対応するコマンドの例をいくつか示します。

  • 特定のバックアップに復元
    • 復元-CVADACTOSite-RestoreFolder %HOMEPATH%\ Documents\ Citrix\ AutoConfig/ Backup_YYYY_MM_DD_HH_MM_SS

特定のコンポーネントのグラニュラーリストア

  • 特定のマシンカタログを復元する
    • リストア-CVADACTOサイト-リストアフォルダ %HOMEPATH%\ Documents\ Citrix\ AutoConfig/Backup_YYYY_MM_DD_HH_MM_SS-MachineCatalog-IncludeByName「カタログの名前」
  • 特定のデリバリーグループを復元する
    • リストア-CVADACTOサイト-リストアフォルダ %HOMEPATH%\ Documents\ Citrix\ AutoConfig/Backup_YYYY_MM_DD_HH_MM_SS-デリバリーグループ-IncludeByName「デリバリーグループの名前」

リストアの実行

ACT を起動し、復元する内容 (完全復元またはコンポーネント別) に応じて「復元」コマンドを入力します。

この例では、1つのデリバリーグループを復元して、コマンド構文をどれほど詳細かつ細かくできるかを示します。 **リストア-CVAD ACTO サイト-リストアフォルダ C:\Users\amiringectxadminaz\Documents\Citrix\AutoConfig\Backup_2023_04_14_10_50_31-デリバリーグループ-「VDI-MANUAL」という名前で追加**

このコマンドがどのように機能するかを明確に理解するために、このコマンドを分解してみましょう。これにより、他のスイッチを使用する際のガイダンスが示されます。

  • 復元-CVADACTOSITE: これは復元の基本コマンドまたは命令です。
  • -RestoreFolder: その後にフォルダー名が続きます。復元するファイルの特定のパス/場所を呼び出します。
  • -DeliveryGroups: 移行するCitrixコンポーネントを指定するために使用するスイッチ。
  • -IncludeByName: このコマンドを使用して移行するリソースを 1 つ指定します (suffix/prefix を追加すると、同じ名前の複数のリソースを復元できます)。

続行する場合は「確認」を求めるプロンプトが表示されます。

  • 「YES」 と入力して続行します。

ACT リストア

ACTは、コマンドで指定したバックアップフォルダーにアクセスしてから、特定のコンポーネント(この例ではデリバリーグループ)にアクセスすることでプロセスを開始します。ACT は、以下に示すように、DeliveryGroups.yml ファイル内の既存の情報を読み込んで取得します:

ACT デリバリーグループ 1

ACT デリバリーグループ 2

最終結果

ACT が復元プロセスの実行を終了すると、実行された内容の詳細と、 問題が発生した場合に備えて推奨事項を一覧表示したログファイルが生成されます 。以下に、ログファイルの内容を示します。

ACT ログファイル 1

ACT ログファイル 2

Citrix Web Studioコンソールで、右上隅の[ 更新 ]ボタンをクリックすると、コンソールが更新され、復元されたコンポーネントが表示されます。

  • Citrix Web Studio コンソールで [更新] をクリックします。
  • 復元プロセスが完了しました。

ACT ウェブStudio 2

まとめ

このガイドでは、ACT フォルダー構造の構成、オンプレミス構成の変更、バックアップの作成、および復元の実行について説明しました。 Citrix 自動構成ツールのコマンドレットについて詳しくは、自動構成ツールの製品ドキュメントをご覧ください。

PoC ガイド:自動構成ツール-オンプレミスでのバックアップと復元