StoreFront のトラブルシューティング
インストールログ
StoreFront のインストールまたはアンインストール時に、StoreFront インストーラーによって C:\Windows\Temp\StoreFront ディレクトリに次のログファイルが作成されます。ファイル名には、それらを作成したコンポーネントが反映され、タイムスタンプが含まれます。
- Citrix-DeliveryServicesRoleManager-*.log—Created when StoreFront is installed interactively.
- Citrix-DeliveryServicesSetupConsole-*.log—StoreFront がサイレントインストールされたとき、および StoreFront が対話形式またはサイレントでアンインストールされたときに作成されます。
- CitrixMsi-CitrixStoreFront-x64-*.log—StoreFront が対話形式またはサイレントでインストールおよびアンインストールされたときに作成されます。
イベントログ
StoreFront は、認証サービス、ストア、およびReceiver for WebサイトのWindowsイベントログをサポートしています。生成されたイベントはすべてStoreFrontアプリケーションログに書き込まれ、アプリケーションとサービスログ > Citrix Delivery Services または Windowsログ > アプリケーション のいずれかでイベントビューアーを使用して表示できます。認証サービス、ストア、およびReceiver for Webサイトの構成ファイルを編集することで、単一イベントの重複ログエントリの数を制御できます。
ログの調整
-
Use a text editor to open the web.config file for the authentication service, store, or Receiver for Web site, which are typically located in the C:\inetpub\wwwroot\Citrix\Authentication\, C:\inetpub\wwwroot\Citrix\storename\, and C:\inetpub\wwwroot\Citrix\storenameWeb\ directories, respectively, where storename is the name specified for the store when it was created.
-
ファイル内で次の要素を見つけます。
<logger duplicateInterval="00:01:00" duplicateLimit="10">デフォルトでは、StoreFront は重複するログエントリの数を1分あたり10個に制限するように構成されています。
-
duplicateInterval 属性の値を変更して、重複するログエントリが監視される時間（時、分、秒）を設定します。duplicateLimit 属性を使用して、指定された時間間隔内にログに記録される必要のある重複エントリの数を設定し、ログの調整をトリガーします。
ログの調整がトリガーされると、それ以降の同一のログエントリが抑制されることを示す警告メッセージがログに記録されます。時間制限が経過すると、通常のログ記録が再開され、重複するログエントリが抑制されなくなったことを示す情報メッセージがログに記録されます。
PowerShellと管理コンソールログ
PowerShellまたは管理コンソールを介して行われた構成変更は、C:\Program Files\Citrix\Receiver StoreFront\Admin\logsにログ記録されます。ログファイル名には、コマンドアクションとサブジェクト、およびコマンドシーケンスを区別するために使用できるタイムスタンプが含まれています。
診断ログ記録
StoreFrontは診断ログをc:\Program Files\Citrix\Receiver StoreFront\admin\traceに書き込みます
デフォルトでは、エラー、警告、情報レベルのメッセージがログに記録されます。ほとんどの場合、これには問題の診断に十分な情報が含まれています。
トラブルシューティングのために、追加の詳細ログを有効にできます。これはCitrix®サポートから要求された場合にのみ必要です。パフォーマンスに影響を与える可能性があるため、トラブルシューティングが完了したらTraceLevelをInfoに戻す必要があります。
詳細ログを有効にするには：
-
ローカル管理者権限を持つアカウントを使用して、Windows PowerShellを起動します
-
コマンドを入力します。
Set-STFDiagnostics -All -TraceLevel "Verbose" -confirm:$False <!--NeedCopy-->これにより、確認を求めることなく、すべてのサービスに対して「詳細」ログが有効になります。このコマンドが入力されると、StoreFrontサービスが再起動されます。PowerShellプロンプトが戻るのを待って、サービスが再起動を完了したことを確認します。これらのサービスが再起動している間、StoreFrontサーバーはユーザーがアクセスできません。
-
ログを作成するために問題を再現します。
-
すべてのサービスのログをデフォルトレベルに戻します
Set-STFDiagnostics -All -TraceLevel "Info" -confirm:$False <!--NeedCopy-->
診断ログをさらにカスタマイズできます。
-
StoreFrontは、サービスごとに個別のログファイルを書き込みます。デフォルトでは、各ログファイルは最大200MBで、StoreFrontは古いログファイルをパージする前に、サービスごとに最大5つのログファイルを書き込みます。書き込まれるログのサイズまたは数をカスタマイズする必要がある場合は、
-FileSizeKbおよび-FileCountパラメーターを使用してこれを行うことができます。 -
-TraceLevelを使用してログに記録される詳細レベルを変更します。許可される値は、Off、Error、Warning、Info、またはVerboseです。 -
パラメーター
-Allを使用すると、すべてのサービスのログ記録パラメーターが設定されます。個々のサービスのログ記録は-Service [Service name]を使用してカスタマイズできます。
Set-STFDiagnostics コマンドレットの詳細については、StoreFront PowerShell SDK ドキュメント を参照してください。
Launch.ica ファイルのログ記録
ユーザーがアプリまたはデスクトップを起動すると、StoreFront は launch.ica というファイルを生成します。Workspace アプリはこのファイルを読み取り、アプリまたはデスクトップへの接続方法を決定します。構成によっては、このファイルはメモリに保存されるため、直接アクセスできない場合があります。起動エラーを診断するには、launch.ica の内容を表示すると役立つことがあります。
クライアント PC で 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=”ログファイルへのパス”
- ICAファイルログ=true
例えば：
LogFile=C:\ica\ica.log LogICAFile=true <!--NeedCopy-->
注:
トラブルシューティング以外の目的で環境内でICAファイルを使用することについては、CTX200126 でさらに詳しく説明されています。