StoreFrontのトラブルシューティング
StoreFrontのインストール時やアンインストール時に、インストーラーによりC:\Windows\Temp\StoreFrontに以下のログファイルが作成されます。これらのログファイルには、作成元のコンポーネントと日時を示すファイル名が付けられます。
- Citrix-DeliveryServicesRoleManager-*.log：StoreFrontのインタラクティブインストール時に作成されます。
- Citrix-DeliveryServicesSetupConsole-*.log：StoreFrontのサイレントインストール時、インタラクティブアンインストール時、およびサイレントアンインストール時に作成されます。
- CitrixMsi-CitrixStoreFront-x64-*.log：StoreFrontのインタラクティブインストール時、サイレントインストール時、インタラクティブアンインストール時、およびサイレントアンインストール時に作成されます。
StoreFrontの認証サービス、ストア、およびReceiver for Webサイトのイベントは、Windowsイベントログに書き込まれます。生成されたイベントはStoreFrontのアプリケーションログに書き込まれます。このログを表示するには、イベントビューアで ［アプリケーションとサービスログ］>［Citrix Delivery Services］ または ［Windowsログ］>［アプリケーション］ の順に選択します。単一イベントに対して同じログエントリが何度も書き込まれないようにするには、認証サービス、ストア、およびReceiver for Webサイトの構成ファイルを編集してログ調整を構成します。
Citrix StoreFront管理コンソールが自動的にトレース情報を記録します。デフォルトではほかの操作のトレースは無効になっており、手作業で有効にする必要があります。Windows PowerShellコマンドにより作成されるログファイルは、StoreFrontのインストール先フォルダーにある\Admin\logs\フォルダー内に保存されます。このインストール先フォルダーは通常、C:\Program Files\Citrix\Receiver StoreFrontです。このログファイルの名前は、実行されたコマンド処理、対象、および実行順序を識別するための日時で構成されます。
重要：
複数サーバーによる展開環境では、複数のサーバー上で同時にサーバーグループの構成を変更しないでください。展開内のほかのサーバー上でCitrix StoreFront管理コンソールを同時に実行していないことを確認してください。変更が完了したら、 構成の変更をサーバーグループに反映させて、展開内のほかのサーバーを更新します。
ログ調整を構成するには
-
認証サービス、ストア、またはReceiver for Webサイトのweb.configファイルをテキストエディターで開きます。これらのファイルは通常、それぞれC:\inetpub\wwwroot\Citrix\Authentication、C:\inetpub\wwwroot\Citrix\storename、C:\inetpub\wwwroot\Citrix\storenameWeb\フォルダーにあります。ここで、storenameはストアの作成時に指定した名前です。
-
ファイル内で次の要素を検索します。
<logger duplicateInterval="00:01:00" duplicateLimit="10">StoreFrontのデフォルトでは、重複するログエントリの数が1分あたり10件までに制限されます。
-
duplicateInterval属性の値を変更して、重複エントリの監視期間を時間、分、秒で設定します。duplicateLimit属性の値を変更して、指定した監視期間内に記録される重複エントリの数を設定します。この数を超えるとログ調整が実行されます。
ログ調整が実行されると、指定した数を超える重複ログエントリが抑制され、それを示す警告メッセージが記録されます。監視期間が経過すると、ログ調整が解除され、それを示す情報メッセージが記録されます。
デバッグのトレースを有効にするには
重要：
StoreFront管理コンソールとPowerShellコンソールを同時に開くことはできません。StoreFront管理コンソールを閉じてからPowerShellコンソールを開いてください。同様に、PowerShellコンソールのすべてのインスタンスを閉じてからStoreFront管理コンソールを開いてください。
トレースの出力はc:\Program Files\Citrix\Receiver StoreFront\admin\traceに送信されます。
注：
Get-Help Set-STFDiagnostics -detailedを実行してPowershellのヘルプおよび手順とSet-STFDiagnosticsコマンドレットの使用方法の手順を入手します。
ローカルの管理者アカウントを使ってWindows PowerShellを起動して、コマンドプロンプトで次のコマンドを実行します。その後次の必須パラメーターを指定してトレースを有効または無効にします。
- -All。フラグは、すべてのインスタンスおよびサービスでトレースを更新する必要があることを示しています。
- -TraceLevel。トレースの詳細レベルが低い順に次の値が-TraceLevelに許可されています：Off、Error、Warning、Info、Verbose。大量のデータが生成されるため、トレースはStoreFrontのパフォーマンスに重大な影響を与える可能性がありますInfoレベルまたはVerboseレベルの使用は、トラブルシューティングで指定された場合を除いてはお勧めしません。
オプションのパラメーター：
- -FileSizeKb。トレースファイルのサイズ（KB）。
- -FileCount。ディスク上で同時に保持できるトレースファイルの数。
- -confirm:$False。Windowsのプロンプトが表示されないようにして、毎回StoreFrontコマンドレットを実行できるようにします。
例
デバッグのために、すべてのデバイスでVerboseレベルのトレースを有効にするには：
Set-STFDiagnostics -All -TraceLevel "Verbose" -confirm:$False
<!--NeedCopy-->
すべてのサービスでVerboseレベルのトレースを無効にして、トレースレベルをデフォルト値設定に戻すには：
Set-STFDiagnostics -All -TraceLevel "Error" -confirm:$False
<!--NeedCopy-->
Set-STFDiagnosticsコマンドレットについて詳しくは、StoreFront PowerShell SDKのドキュメントを参照してください。
launch.icaファイルのログ作成を有効にするには
launch.icaファイルの情報をクライアントコンピューターに保存して、複数の問題をトラブルシューティングします。launch.icaファイルは、Citrix Web InterfaceまたはCitrix StoreFrontサーバーで生成されます。
launch.icaファイルのログ作成を有効にするには、次の手順を完了します：
-
レジストリエディターを使用して次のレジストリキーを参照します：
32ビットシステム：
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\Logging64ビットシステム：
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\Logging -
次の2つの文字列キー値を設定します：
- LogFile=「ログファイルへのパス」
- LogICAFile=true
例：
LogFile=C:\ica\ica.log LogICAFile=true <!--NeedCopy-->
そのほかの情報の入手先
注：
トラブルシューティング目的以外で環境でICAファイルを使用する場合について詳しくは、CTX200126を参照してください。
StoreFrontのアップグレードの問題に関するトラブルシューティング
以下の手順を使用して、StoreFrontのアップグレードの問題をトラブルシューティングします。
アップグレード前の準備
- すべてのStoreFrontサーバーのバックアップが存在することを確認してください。
- StoreFrontの製品終了となったバージョンからアップグレードしようとしていないことを確認してください。詳しくは、CTX200356を参照してください。
- サポートされているバージョンのStoreFrontから最新バージョンにのみアップグレードしていることを確認してください。
- StoreFrontサーバーがStoreFrontサーバーグループの一部である場合は、グループ内のすべてのサーバーを順番にアップグレードする必要があります。StoreFrontサーバーグループの同時アップグレードはサポートされていません。
- C:\inetpub\wwwroot\citrixまたはそのサブディレクトリ内のthumbs.dbファイルを削除します。この手順を完了するには、隠しファイルを表示します：［フォルダーオプション］>［表示］ で ［隠しファイル、隠しフォルダー、および隠しドライブを表示する］ オプション選択し、［保護されたオペレーティングシステムファイルを表示しない（推奨）］ オプションを選択解除します。
- アップグレード手順を開始する前に、ウイルス対策ソフトウェアを無効にしてください。
- アップグレード中のサーバーがロードバランサーから削除されていること、およびアクティブなユーザーセッションが接続されていないことを確認します。
- アップグレードを実行する前にStoreFrontサーバーを再起動します。
- 次のサービスを手動で停止します：
- CitrixConfigurationReplication
- CitrixCredentialWallet
- CitrixDefaultDomainService
- CitrixPeerResolutionService
- CitrixSubscriptionsStore
- 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で上記の例外エラーメッセージが含まれるエラーがないか確認します。対応するアドバイスを実行します。
手動でStoreFrontを削除するには
警告：
手動でStoreFrontを削除すると、既存の情報がすべて消去されます。
手動でStoreFrontを削除するには、以下を実行します：
- StoreFrontをアンインストールします。
- Webサーバーの役割を削除します。
- C:\Program Files\Citrix\Receiver StoreFrontフォルダーを削除します。
- C:\Program Files\Citrix\StoreFront Installのすべてのサブディレクトリを削除します。
- C:\Inetpubフォルダーを削除します。
StoreFrontを再インストールできるようになりました。