StoreFront™ のアップグレード
アップグレードすると、StoreFront の構成が保持され、ユーザーのお気に入りはそのまま残ります。これに対し、StoreFront のアンインストールでは、StoreFront と関連サービス、サイト、お気に入り（スタンドアロンサーバーの場合）、および関連構成が削除されます。
サポートされているアップグレードパス
StoreFront 2402 には、以下のバージョンからアップグレードできます。
- StoreFront 2311
- StoreFront 2308
- StoreFront 2203 LTSR (任意の CU)
- StoreFront 1912 LTSR (任意の CU)
- StoreFront 3.12 LTSR CU9
3.12 CU9 より前のバージョンからアップグレードするには、まず StoreFront 3.12 CU9 にアップグレードする必要があります。
警告：
1912 より前のバージョンからアップグレードすると、展開内のデスクトップアプライアンスサイトは自動的に削除されます。代替策として、Citrix では、ドメインに参加していないすべてのユースケースで Citrix Workspaceアプリのデスクトップロックを使用することをお勧めします。
知っておくべきこと
- StoreFront は、異なる製品バージョンを含む複数サーバー展開をサポートしていません。そのため、展開へのアクセスを許可する前に、サーバーグループ内のすべてのサーバーを同じバージョンにアップグレードする必要があります。
- 複数サーバー展開では同時アップグレードはサポートされていません。サーバーは順次アップグレードする必要があります。
- StoreFront のアップグレードが実行される前に、いくつかのアップグレード前チェックが実行されます。アップグレード前チェックが失敗した場合、アップグレードは開始されず、失敗が通知されます。StoreFront のインストールは変更されません。失敗の原因を修正した後、アップグレードを再実行してください。
- StoreFront のアップグレード自体が失敗した場合、既存の StoreFront インストールは初期構成を失う可能性があります。StoreFront のインストールを機能する状態に復元してから、アップグレードを再実行してください。StoreFront を機能する状態に復元するには、次のアプローチを検討してください。
- アップグレード前に作成した VM スナップショットの復元
- アップグレード前にエクスポートした StoreFront 構成のインポート。詳しくは、StoreFront 構成のエクスポートとインポートを参照してください。
- StoreFront のアップグレードに関する問題のトラブルシューティングに記載されているトラブルシューティングアドバイスの実行
- Citrix Virtual Apps and Desktops メタインストーラーから発生する StoreFront のアップグレード失敗は、関連する失敗ログへのリンクとともにダイアログで報告されます。
-
1912 から 2203 までの StoreFront バージョンでのハイブリッド起動
1912 から 2203 までの StoreFront バージョンは、App Protection ポリシーが有効になっている仮想アプリおよびデスクトップのハイブリッド起動を、次のようにカスタマイズして有効にすることをサポートしています。
Citrix® は、StoreFront 2308 以降にアップグレードする際に、このカスタマイズを削除することをお勧めします。
詳しくは、1912 から 2203 までの StoreFront バージョンでのハイブリッド起動を参照してください。
アップグレードの準備
アップグレードを開始する前に、アップグレードの失敗を防ぐために次の手順を実行することをお勧めします。
- アップグレード前にバックアップ戦略を計画する。
- サポートされているバージョンからアップグレードしていることを確認する。
- Citrix WebサイトからStoreFrontインストーラーをダウンロードする。
単一のStoreFrontサーバーのアップグレード
- VMスナップショットを作成してサーバーをバックアップします。
- 既存のStoreFront構成をエクスポートします。サーバーグループに複数のサーバーがある場合は、1つのサーバーからのみサーバーグループ構成をエクスポートします。すべての変更がそれらの間で伝播されている場合、サーバーグループ内のすべてのサーバーは構成の同一のコピーを維持します。このバックアップにより、新しいサーバーグループを簡単に構築できます。これにより、問題が発生した場合に構成を簡単に復元できます。このバックアップは、エクスポート元のバージョンと同じバージョンを実行しているサーバーにのみ復元できることに注意してください。
-
C:\inetpub\wwwroot\Citrix\<StoreName>\App_DataまたはC:\inetpub\wwwroot\Citrix\<StoreName>Auth\App_Data内のファイル（default.ica や usernamepassword.tfrm など）に変更を加えた場合は、各ストアのファイルをバックアップします。アップグレード後、それらを復元して変更を元に戻すことができます。 - ロードバランサーからサーバーを削除するか、接続をブロックして、ユーザーが接続できないようにします。
- サーバーを再起動します。
- StoreFront管理コンソール、コマンドライン、PowerShellウィンドウ、またはStoreFrontファイルにロックをかける可能性のあるその他のアプリケーションを含め、実行中のアプリケーションがないことを確認します。これにより、アップグレード中にインストーラーがすべてのStoreFrontファイルにアクセスできるようになります。インストーラーがファイルにアクセスできない場合、それらは置き換えられず、アップグレードは失敗し、既存のStoreFront構成が削除されます。
- StoreFrontファイルを含むディレクトリでWindowsエクスプローラーまたはコマンドプロンプトが開いていないことを確認します。
- すべてのウイルス対策アプリケーションを無効にします。
- 必要なバージョンのStoreFrontのインストールファイルを実行します。
計画メンテナンスダウンタイム中のStoreFrontサーバーグループのアップグレード
計画されたダウンタイム中に複数のサーバーで構成されるStoreFrontサーバーグループをアップグレードするには、次の手順を実行します。
- ロードバランシングURLを無効にして、サーバーグループへのユーザーアクセスを無効にします。これにより、アップグレードプロセス中にユーザーが展開に接続できなくなります。
- 単一のStoreFrontサーバーのアップグレードの手順に従って、各サーバーをアップグレードします。
- すべてのサーバーが正しく機能していることを確認します。
- ロードバランシングURLを有効にして、アップグレードされたサーバーグループへのユーザーアクセスを有効にします。
計画ダウンタイムなしでのStoreFrontサーバーグループのアップグレード
稼働中のStoreFrontサーバーグループ内のサーバーを同時にアップグレードすることはサポートされていません。ただし、同一の構成を持つ新しいサーバーグループを作成し、それをアップグレードしてから、ユーザー接続を新しいサーバーグループに移行することで、ライブアップグレードを実現できます。ユーザーは、サーバーグループ間で転送される際にStoreFrontに再認証する必要があります。
たとえば、3台のサーバーA、B、Cで構成されるStoreFrontサーバーグループをアップグレードするには、次の手順を実行します。
- Export-STFConfiguration を使用して、StoreFront構成をエクスポートします。このバックアップは、後でサーバーが工場出荷時の設定にリセットされ、構成データが削除されるため、必要です。
- Export-STFStoreSubscriptions を使用して、サーバーAからサブスクリプションデータをエクスポートします。このバックアップは、後でサーバーが工場出荷時の設定にリセットされ、サブスクリプションデータが削除されるため、必要です。ストアのサブスクリプションデータの管理を参照してください。
- ロードバランサーからサーバーCを削除して、サーバーCへのユーザーアクセスを無効にします。これにより、アップグレードプロセス中にユーザーがサーバーCに接続できなくなります。ロードバランサーは引き続きサーバーAとBに要求を送信します。
- サーバーAを使用して、サーバーCをグループから削除します。サーバーAとBは引き続きユーザーのリソースへのアクセスを提供します。サーバーCはサーバーグループから孤立し、工場出荷時の設定にリセットされます。
- Clear-STFDeployment を使用して、孤立したサーバーCを工場出荷時の設定にリセットします。
- Import-STFConfiguration を使用して、以前にエクスポートしたStoreFront構成をサーバーCにインポートします。サーバーCは、古いサーバーグループと同一の構成を持つようになります。この手順を後で繰り返す必要はありません。構成データをグループに参加する他のサーバーに伝播するには、1つのサーバーに構成データのコピーがあれば十分です。
- 単一のStoreFrontサーバーのアップグレードの手順に従って、サーバーCをアップグレードします。サーバーCは、古いサーバーグループと同一の構成を持ち、StoreFrontの新しいバージョンにアップグレードされます。
- 以前にエクスポートしたサブスクリプションデータをサーバーCにインポートします。この手順を後で繰り返す必要はありません。サブスクリプションデータをグループに参加する他のサーバーに伝播するには、1つのサーバーにサブスクリプションデータのコピーがあれば十分です。
- サーバーBを使用して手順3、4、5、7を繰り返します（手順6は繰り返さないでください）。この間、サーバーAのみがユーザーにリソースへのアクセスを提供します。したがって、StoreFrontサーバーグループへの負荷が最小限になると予想される静かな作業時間中にこの手順を実行することをお勧めします。
- 既存のサーバーグループへの参加プロセスを使用して、サーバーBをサーバーCに参加させます。これにより、現在のバージョンのStoreFront（サーバーA）上の単一サーバー展開と、新しいStoreFrontバージョン（サーバーBとC）上の新しい2ノードサーバーグループが作成されます。
- サーバー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アクセス例外：C:\inetpub\wwwroot\citrix またはそのサブディレクトリ内の thumbs.db ファイルが原因です。見つかった thumbs.db ファイルをすべて削除します。
排他的ファイルアクセスを取得できません/使用中例外：利用可能な場合はスナップショット/バックアップを復元するか、サーバーを再起動し、StoreFrontサービスを手動で停止します。
サービスを開始できません例外：利用可能な場合はスナップショット/バックアップを復元するか、.NET Framework 4.5のフルバージョン（クライアントプロファイルではない）をインストールします。
- CitrixMsi*.log に例外エラーがない場合は、サーバーの イベントビューアー > Delivery Services で、前述の例外エラーメッセージを含むエラーがないか確認します。対応するアドバイスに従ってください。
- イベントビューアーに例外エラーがない場合は、C:\Program Files\Citrix\Receiver StoreFront\logs の管理者ログで、前述の例外エラーメッセージを含むエラーがないか確認します。対応するアドバイスに従ってください。
ログファイルの詳細は、インストールログを参照してください。