StoreFrontのアップグレード
アップグレードすると、StoreFront構成が保存され、ユーザーのお気に入りがそのまま残ります。一方、StoreFrontのアンインストールは、StoreFrontおよび関連サービス、サイト、お気に入り(スタンドアロンサーバーの場合)、関連構成を削除します。
サポートされるアップグレードパス
以下からStoreFront 1912の最新CUにアップグレードできます:
- StoreFront 1912 LTSR(初期リリースまたはいずれかのCU)
- StoreFront 1909
- StoreFront 1906
- StoreFront 1903
- StoreFront 1811
- StoreFront 3.16
- StoreFront 3.12 LTSR(いずれかのCU)
- StoreFront 3.0.1 LTSR(いずれかのCU)
3.0.1より前のバージョンからアップグレードするには、まずStoreFront 3.12にアップグレードする必要があります。
警告:
1912以前のバージョンからアップグレードすると、展開内のデスクトップアプライアンスサイトは自動的に削除されます。代わりに、Citrixではドメイン不参加のユースケースでは「Citrix WorkspaceアプリDesktop Lock」を使用することをお勧めします。
ヒント
- StoreFrontでは、複数の製品バージョンが混在する複数サーバーの展開環境がサポートされないため、サーバーグループ内のすべてのサーバーを同じバージョンにアップグレードしてから、ユーザーが展開環境にアクセスできるようにしてください。
- 複数サーバー展開環境では、同時アップグレードはサポートされません。各サーバーを順番にアップグレードする必要があります。
- StoreFrontのアップグレードを実行する前に、アップグレード前チェックを実行します。アップグレード前チェックが失敗した場合、アップグレードは開始されず、エラーに関する通知が表示されます。StoreFrontのインストールは変更されません。エラーの原因を修復してから、アップグレードに戻ります。
- StoreFrontのアップグレード自体が失敗すると、既存のStoreFrontのインストールで初期構成が失われる可能性があります。StoreFrontのインストールを機能する状態に復元してから、アップグレードを再度実行してください。StoreFrontを機能する状態に復元するには、次の方法を検討してください:
- アップグレード前に作成した仮想マシンスナップショットを復元する、
- アップグレード前にエクスポートしたStoreFront構成をインポートする(「StoreFront構成のエクスポートとインポート」を参照)、
- 「StoreFrontのアップグレードの問題に関するトラブルシューティング」のトラブルシューティング方法を実行する。
- Citrix Virtual Apps and Desktops MetainstallerでStoreFrontのアップグレードが失敗した場合、ダイアログで報告され関連するエラーログへのリンクが記載されます。
アップグレードの準備
アップグレードを開始する前に、アップグレードの失敗を防ぐために次の手順の実行をお勧めします:
- アップグレード前にバックアップを計画します。
- サポートされているバージョンからアップグレードしていることを確認してください。
- StoreFrontインストーラーをCitrix Webサイトからダウンロードします。
単一のStoreFrontサーバーのアップグレード
- 仮想マシンスナップショットを作成してサーバーのバックアップを作成します。
- 既存のStoreFront構成をエクスポートします。サーバーグループに複数のサーバーがある場合は、1つのサーバーからのみサーバーグループ構成をエクスポートします。サーバー間ですべての変更を伝達していることを前提としているため、サーバーグループ内のすべてのサーバーは同一コピーの構成を維持します。このバックアップにより、新しいサーバーグループを簡単に構築できるため、問題が発生した場合でも構成を簡単に復元できます。このバックアップは、エクスポート元と同じバージョンを実行しているサーバーにのみ復元できます。
- default.icaやusernamepassword.tfrmなど、
C:\inetpub\wwwroot\Citrix\<StoreName>\App_Data
のファイルを変更した場合は、ストアごとにバックアップを作成します。アップグレード後はそれらを復元して、変更内容を元に戻すことができます。 - ロードバランサーからサーバーを削除するか、接続をブロックすることにより、ユーザーが接続できないようにします。
- サーバーを再起動します:
- StoreFront管理コンソール、コマンドライン、PowerShellウィンドウなど、StoreFrontファイルをロックする可能性のあるすべてのアプリケーションが実行されていないことを確認してください。これにより、アップグレード時にインストーラーがすべてのStoreFrontファイルに確実にアクセスできるようになります。インストーラーがファイルにアクセスできない場合、それらのファイルを置き換えることができないため、アップグレードに失敗して既存のStoreFront構成が削除されます。
- StoreFrontファイルを含んでいるディレクトリでWindowsエクスプローラーやコマンドプロンプトが開いていないことを確認してください
- ウイルス対策アプリケーションをすべて無効にします。
- 必要なバージョンのStoreFront用のインストールファイルを実行します。
StoreFrontサーバーグループをアップグレードするには
StoreFrontサーバーグループのアップグレードでは、いずれかのサーバーを使用して他のサーバーをグループから削除します。削除されたサーバーは、グループに関連する構成を保持しているため、新しいサーバーグループに参加できなくなります。新しいサーバーグループを構築するために再利用する前に、またはスタンドアロンのStoreFrontサーバーとして再利用する前に、削除されたサーバーを出荷時のデフォルト設定にリセットするか、またはStoreFrontに再インストールする必要があります。StoreFrontサーバーグループのサーバーの同時アップグレードはサポートされていません。
例1:スケジュールされたメンテナンスダウンタイム中に3ノードのStoreFrontサーバーグループをアップグレードします
スケジュールされたダウンタイム中に、3台のサーバーA、B、CによるStoreFrontサーバーグループをアップグレードします。
- 負荷分散URLを無効にして、サーバーグループへのユーザーアクセスを無効にします。これにより、ユーザーがアップグレードプロセス中に展開環境に接続できなくなります。
-
サーバーAを使用して、サーバーBとCをグループから削除します。
サーバーBとCは、サーバーグループから「孤立」しています。
- 「単一のStoreFrontサーバーのアップグレード」の手順に従って、サーバーAをアップグレードします。
- サーバーAが正常にアップグレードされたことを確認してください。
- サーバーBとCで、現在インストールされているStoreFrontをアンインストールし、新しいバージョンのStoreFrontをインストールします。
-
アップグレードされたサーバーグループを作成するために、アップグレードされたサーバーAにサーバーBとCを参加させます。このサーバーグループは、アップグレードされた1台のサーバー(A)と2台の新しくインストールされたサーバー(BとC)で構成されています。
既存のサーバーグループへの参加プロセスは自動的にすべての構成データとサブスクリプションデータを新しいサーバーBとCに伝達します。
- すべてのサーバーが正しく機能していることを確認してください。
- 負荷分散URLを有効にして、アップグレードされたサーバーグループへのユーザーアクセスを有効にします。
例2:スケジュールされたダウンタイムなしで3ノードのStoreFrontサーバーグループをアップグレードします
スケジュールされたダウンタイムなしで、3台のサーバーA、B、CによるStoreFrontサーバーグループをアップグレードします。
サーバーグループをアップグレードする前に、以下を実行します:
- Export-STFConfigurationを使用して、StoreFront構成をエクスポートします。このバックアップは、サーバーがプロセスの後半で工場出荷時設定にリセットされて構成データが削除されてしまうため、必要になります。
- Export-STFStoreSubscriptionsを使用してサーバーAからサブスクリプションデータをエクスポートします。このバックアップは、サーバーがプロセスの後半で工場出荷時設定にリセットされてサブスクリプションデータが削除されてしまうため、必要になります。「ストアのサブスクリプションデータの管理」を参照してください。
- サーバーCをロードバランサーから削除して、サーバーCへのユーザーアクセスを無効にします。これにより、ユーザーはアップグレードプロセス中にサーバーCに接続できなくなります。ロードバランサーはサーバーAとBに要求を送信し続けます。
- グループからサーバーCを削除するには、サーバーAを使用します。 サーバーAとBは、引き続きユーザーのリソースへのアクセスを提供します。サーバーCはサーバーグループから孤立し、工場出荷時設定にリセットされました。
- Clear-STFDeploymentを使用して、孤立したサーバーCを出荷時のデフォルト設定にリセットします。
- Import-STFConfigurationを使用して、以前にサーバーCにエクスポートしたことがあるStoreFront構成をインポートします。これで、サーバーCは以前のサーバーグループと同じ構成になります。後からこの手順を繰り返す必要はありません。必要なのはサーバー1台分の構成データのコピーであり、グループに参加しているその他のサーバーにはデータが伝達されます。
- 「単一のStoreFrontサーバーのアップグレード」の手順に従って、サーバーCをアップグレードします。これで、サーバーCは以前のサーバーグループと同じ構成になり、新しいバージョンのStoreFrontにアップグレードされます。
- 以前にサーバーCにエクスポートしたサブスクリプションデータをインポートします。後からこの手順を繰り返す必要はありません。必要なのはサーバー1台分のサブスクリプションデータのコピーであり、グループに参加しているその他のサーバーにはデータが伝達されます。
- サーバーBを使用して、手順3、4、5、7を繰り返します(手順6は繰り返さないでください)。この間、ユーザーはサーバーAのリソースにのみアクセスできます。そのためこの手順は、StoreFrontサーバーグループの負荷が最小になると予想される、作業の少ない期間に実行することをお勧めします。
- 既存のサーバーグループへの参加プロセスを使用して、サーバーBをサーバーグループCに参加させます。これにより、StoreFrontの現在のバージョンで単一サーバー(サーバーA)を、StoreFrontの新しいバージョンで新しい2ノードサーバーグループ(サーバーBおよびC)を展開できます。
- サーバーBとCを負荷分散サービスに追加にして、サーバーAから引き継ぐことができるようにします。
- サーバーAをロードバランサーから削除して、ユーザーが新しくアップグレードされたサーバーBおよびCに接続されるようにします。
- サーバーAを使用して手順5、7、10、11を繰り返します(手順6は繰り返さないでください)。サーバーグループのアップグレードプロセスが完了すると、サーバーA、B、Cには、元のグループと同じ構成およびサブスクリプションデータが配置されます。
注:
サーバーAが唯一アクセス可能なサーバーである短い期間中に、サブスクリプションが失われる可能性があります(手順9)。これによって、アップグレード後の新しいサーバーグループに存在するサブスクリプションデータベースが比較的古いものになり、新しいサブスクリプションレコードはすべて失われる可能性があります。
サブスクリプションデータはユーザーがログオンしてリソースを起動できるようにするために不可欠な要素ではないため、これによる機能への影響はありません。ただし、サーバーAが工場出荷時の設定にリセットされ、新しくアップグレードされたグループに参加した後で、ユーザーはリソースを再度サブスクライブする必要があります。ダウンタイムなしでStoreFront実稼働環境をライブでアップグレードすると、多数ではないものの、いくつかのサブスクリプションレコードが失われる可能性があります。
アップグレードが失敗した場合
-
C:\Windows\Temp\StoreFrontで最新のCitrixMsi*.logを開き、例外エラーがないか確認します。
Thumbs.db Accessの例外:原因はC:\inetpub\wwwroot\citrixおよびそのサブディレクトリ内のthumbs.dbファイルです。検出されたすべてのthumbs.dbファイルを削除します。
Cannot get exclusive file access \in useの例外:利用可能な場合スナップショット/バックアップを復元するか、サーバーを再起動し、すべてのStoreFrontサービスを手動で停止します。
Service cannot be startedの例外: 利用可能な場合スナップショット/バックアップを復元するか、(クライアントプロファイルではなく).NET framework 4.5のフルバージョンをインストールします。
- CitrixMsi*.logに例外エラーがない場合、サーバーの [イベントビューアー]>[デリバリーサービス] で上記の例外エラーメッセージが含まれるエラーがないか確認します。対応するアドバイスを実行します。
- イベントビューアーに例外エラーがない場合、AdminログのC:\ProgramFiles\Citrix\Receiver StoreFront\logsで上記の例外エラーメッセージが含まれるエラーがないか確認します。対応するアドバイスを実行します。
ログファイルについて詳しくは、「インストールログ」を参照してください。