Citrix DaaS™

Citrix 接続のトラブルシューティング

Citrix Troubleshoot Connection機能は、エンドユーザーがデスクトップまたはアプリケーションの起動失敗の可能性を効果的に自己トラブルシューティングできるように設計されています。この機能強化は、明確な診断、潜在的な推奨事項、および簡単なクリックで修正を実行する機能を提供することを目的としています。

概要

Citrixは、ユーザーが起動失敗の根本原因を明確に理解できるように、より詳細で強化されたエラーメッセージを提供するようになりました。Troubleshoot Connection機能は、起動プロセス中にVirtual Delivery Agent (VDA)への到達可能性に関する課題をリアルタイムで分析します。その後、ユーザーフレンドリーなエラーメッセージと推奨事項を提示し、ユーザーが問題を直接解決するか、必要に応じてサポートチケットのためにログを収集できるようにします。

分析される接続パス

この機能は、以下を含む重要な接続ポイント全体で、仮想アプリおよびデスクトップの起動に関する潜在的な問題を診断します。

  • クライアントからゲートウェイへのネットワーク接続。
  • ゲートウェイからStoreFrontサーバーへの接続。
  • StoreFrontサーバーからBrokerへの接続。
  • BrokerからVDAへの接続。

強化されたエラーメッセージと診断

起動失敗が発生した場合、Citrixは、ネットワークエラー、サーバーの利用不可、VDA障害などの特定の接続問題を特定する、明確でユーザーフレンドリーなエラーメッセージを表示するようになりました。管理者向けには、詳細なエラーコードがログに提供され、サーバー側エラーとクライアント側エラーに分類されており、より詳細な調査のための貴重な参照情報となります。

自己回復と修復アクション

Citrix Troubleshoot Connection機能には、ユーザーが一般的な問題から自動的に回復するために実行できる手順が含まれており、これによりサポート介入の必要性を最小限に抑えます。ガイド付き修復で解決できる潜在的な問題は次のとおりです。

  • VDAの再起動
  • Citrix Workspaceアプリ (CWA) を再起動する - CWAに再ログインする
  • リソースリストを更新する
  • アプリを更新して試す
  • ストアを再構成する
  • CWAをアップグレードする
  • CWAを再インストールする
  • ネットワークを確認する
  • 待機して再試行する

システム要件

接続トラブルシューティング機能を使用するには、以下のCitrix Workspaceアプリのバージョンが必要です。

  • Mac用Citrix Workspaceアプリ: バージョン2505以降
  • Windows用Citrix Workspaceアプリ: バージョン2507以降
  • iOS用Citrix Workspaceアプリ: バージョン2509以降
  • Android用Citrix Workspaceアプリ: バージョン2509以降

使用方法

接続トラブルシューティング機能は、Citrix DaaS環境向けにデフォルトで有効になっています。詳細かつ強化されたエラーメッセージは、修復の推奨事項とともに、ブラウザから起動されたセッションと、ネイティブのCitrix Workspaceアプリを介して直接起動されたセッションの両方に提供されます。

重要な考慮事項

この機能は堅牢なセルフサービス機能を提供しますが、以下の点に注意することが重要です。

  • 「VDAの再起動」修復アクションは、ハイブリッド起動モード(つまり、ブラウザからICAファイルをダウンロードし、ネイティブのCitrix Workspaceアプリで起動するモード)で起動されたセッションをサポートしていません。

エラーコード

エラーコードは、サーバー側エラーとクライアント側エラーに分かれています。以下にエラーコードの表を示します。

一般的なサーバー側エラー

エラーID 説明 推奨事項
ResourceNotFound リソースは管理者によって削除されました。 利用可能なアプリとデスクトップの最新リストについては、Citrix Workspaceアプリを更新するか、ログアウトして再度ログインしてください。
WorkstationInMaintenance デスクトップは計画メンテナンス中です。 メンテナンスが完了するまで待ってから、もう一度試してください。
UnavailableDesktop 接続できるデスクトップがありません。 数分待ってから、もう一度試してください。問題が解決しない場合は、システム管理者に連絡してください。
UnavailableAppProtectedDesktop 保護されたリソースを開くには、App Protectionが必要です。 App Protectionを搭載したCitrix Workspaceアプリのバージョンにアップグレードするか、システム管理者に連絡してサポートを受けてください。
NotLicensed サーバーに適切なライセンスがないため、リソースを起動できません。 システム管理者に連絡してサポートを受けてください。
NoMoreActiveSessions 利用可能なセッションスロットがないため、リソースを起動できません。 数分待ってから、もう一度試してください。問題が解決しない場合は、システム管理者に連絡してください。
GeneralAppLaunchError リソースを開こうとしたときに不明なエラーが発生しました。 システム管理者に連絡して支援を求めてください。
ResourceDisabled 管理者がリソースを無効にしました。 利用可能なアプリとデスクトップの最新リストを表示するには、Citrix Workspaceアプリを更新するか、ログアウトして再度ログインしてください。

Windows向けCitrix Workspaceアプリ

エラーID 説明 推奨事項
CertificateError サーバー証明書でエラーが発生しました。 システム管理者に連絡して支援を求めてください。
PassthroughClientError アクティブなセッションが既に存在します。 システム管理者に連絡して支援を求めてください。
IcaFileRetrieveError ICAファイルの取得中にエラーが発生しました。 サポートについては、システム管理者に問い合わせてください。
Icafileretrieveerrorreconnection 再接続中にICAファイルの取得中にエラーが発生しました。 サポートについては、システム管理者に問い合わせてください。
NoCWA リソースを開くにはCitrix Workspaceアプリが必要です。 Citrix Workspaceアプリをインストールするか、サポートについてはシステム管理者に問い合わせてください。
CouldNotFindStore リソースを起動するために必要なストア構成を取得できません。 Citrix Workspaceアプリからストアを削除し、再度追加してください。問題が解決しない場合は、システム管理者に問い合わせてください。
noclientinstalled リソースを起動するために必要な情報を取得できません。 Citrix Workspaceアプリを更新するか、ログアウトしてから再度ログインしてください。
AuthCancelled 認証セッションの有効期限が切れました。 問題の解決を試みるには、Citrix Workspaceアプリで再認証してください。問題が解決しない場合は、システム管理者に連絡してください。
IcaFileLaunchError ICAファイルの起動中にエラーが発生しました。 Citrix Workspaceアプリを終了して、再度開いてください。問題が解決しない場合は、システム管理者に連絡してください。
CouldNotContactStore VDAとの通信中にエラーが発生しました。これはサーバー接続の問題が原因である可能性があります。 Citrix Workspaceアプリを終了して、再度開いてください。問題が解決しない場合は、システム管理者に連絡してください。
CCMError Connection Managerエラーのため、リソースを起動できません。エラーコード: {errorCodeValue} Citrix Workspaceアプリを終了して、再度開いてください。問題が解決しない場合は、システム管理者に連絡してください。
CCMInitFailed Connection Managerの初期化に失敗したため、リソースを起動できません。 Citrix Workspaceアプリを終了して、再度開いてください。問題が解決しない場合は、システム管理者に連絡してください。
CCMLoadFailed Connection Managerの読み込みに失敗したため、リソースを起動できません。 Citrix Workspaceアプリを終了して再起動してください。問題が解決しない場合は、システム管理者に連絡してください。
InvalidIcaParams ICAパラメーターが正しくないため、リソースを起動できません。 Citrix Workspaceアプリを終了して再起動してください。問題が解決しない場合は、システム管理者に連絡してください。
AppExiting Citrix Workspaceアプリが終了しているため、リソースを起動できません。 Citrix Workspaceアプリを終了して再起動してください。問題が解決しない場合は、システム管理者に連絡してください。
UTF8ConversionFailed ICAファイルを解析できません。 Citrix Workspaceアプリを終了して再起動してください。問題が解決しない場合は、システム管理者に連絡してください。
MissingSoftware このアプリを使用するには、追加のソフトウェアが必要です。 サポートについては、システム管理者に連絡してください。

Citrix Workspaceアプリ Mac用

エラーID 説明 推奨事項
AuthCancelled 認証セッションの有効期限が切れました。 問題の解決を試みるには、まず資格情報で認証してください。問題が解決しない場合は、システム管理者に連絡してください。
NetworkError ネットワーク接続の問題により、リソースを起動できません。 接続を確認して、もう一度試してください。問題が解決しない場合は、システム管理者に連絡してください。
ViewerNotFound Citrix Viewerのパスが見つかりません。 問題の解決を試みるには、Citrix Workspaceアプリをアンインストールして再インストールしてください。問題が解決しない場合は、システム管理者に連絡してください。
ViewerOpenEventFailed Citrix Viewerがイベントの作成に失敗しました。 ストアからリソースをもう一度起動してみてください。問題が解決しない場合は、システム管理者に連絡してください。
ViewerLaunchTimeout Citrix Viewer の起動がタイムアウトしました。 ストアからリソースを再度起動してみてください。問題が解決しない場合は、システム管理者に連絡してください。
ViewerLaunchFailure Citrix Viewer の起動に失敗しました。 ストアからリソースを再度起動してみてください。問題が解決しない場合は、システム管理者に連絡してください。
InvalidICAFile ICA ファイルが無効なため、リソースを起動できません。 ストアからリソースを再度起動してみてください。問題が解決しない場合は、システム管理者に連絡してください。
CertificateError サーバー証明書でエラーが発生しました。 システム管理者に連絡してサポートを受けてください。
ResourceError リソースの起動中にエラーが発生しました。これはサーバー接続の問題が原因である可能性があります。 数分待ってから再試行してください。問題が解決しない場合は、システム管理者に連絡してください。
UnknownError リソースを開こうとしたときに不明なエラーが発生しました。 数分待ってから、もう一度お試しください。問題が解決しない場合は、システム管理者に連絡してください。

iOS版Citrix Workspaceアプリ

エラーID 説明 推奨事項
credentialsMustChange パスワードを変更する必要があります。 アカウント設定に移動してパスワードを変更してください。問題が解決しない場合は、システム管理者に連絡してください。
noConfigurationFile 必要な構成データを取得できません。 問題を解決するには、Citrix Workspaceアプリからストアを削除し、再度追加してください。問題が解決しない場合は、システム管理者に連絡してください。
http404Error リソースが利用できません。 システム管理者に連絡して支援を求めてください。
invalidTransactionId 無効なトランザクションIDです。 数分待ってから、もう一度お試しください。問題が解決しない場合は、システム管理者にお問い合わせください。
credentialsExpired パスワードの有効期限が切れました。 アカウント設定に移動してパスワードを変更してください。問題が解決しない場合は、システム管理者にお問い合わせください。
badAddressError リソースアドレスが見つかりません。 接続を確認して、もう一度お試しください。問題が解決しない場合は、システム管理者にお問い合わせください。
accountDisabled アカウントが無効になっています。 システム管理者に連絡して支援を求めてください。
accountLockedOut アカウントは一時的にロックされています。 システム管理者に連絡して支援を求めてください。
storeServerConnectionError サーバーとの通信中にエラーが発生しました。 数分待ってから、もう一度試してください。問題が解決しない場合は、システム管理者に連絡してください。
internalServerError サーバーへの接続中に不明なエラーが発生しました。 システム管理者に連絡して支援を求めてください。
invalidXML XMLサービスからのエラーにより、リソースを開けませんでした。 システム管理者に連絡して支援を求めてください。
badCredentials 資格情報が期限切れです。 問題を解決するには、Citrix Workspaceアプリからログアウトし、再度ログインしてください。問題が解決しない場合は、システム管理者に連絡してください。
appRemoved リソースは管理者によって削除または無効化されました。 利用可能なアプリとデスクトップの最新リストについては、Citrix Workspaceアプリを更新するか、ログアウトして再度ログインしてください。
invalidLogonHours 管理者によって設定された制限のため、現在ログインできません。 通常の勤務時間中に再度お試しください。問題が解決しない場合は、システム管理者に連絡してください。
connectionError サーバーに接続できません。これはネットワーク接続の問題が原因である可能性があります。 問題を解決するには、Citrix Workspaceアプリを終了して再度開いてください。問題が解決しない場合は、システム管理者に連絡してください。

Android版Citrix Workspaceアプリ

エラーID 説明 推奨事項
http404Error ネットワーク接続の問題により、リソースを起動できません。 接続を確認して、もう一度お試しください。問題が解決しない場合は、システム管理者に連絡してください。
couldNotConnectToWorkstation デスクトップに接続できません。 Citrix Workspaceアプリを終了して、再度開いてください。問題が解決しない場合は、システム管理者に連絡してください。
retryReasonRebooting リソースの起動中にエラーが発生しました。要求されたワークステーションは再起動中です。 Citrix Workspaceアプリを終了して、再度開いてください。問題が解決しない場合は、システム管理者に連絡してください。
retryReasonResuming リソースの起動中にエラーが発生しました。要求されたワークステーションは再開中です。 Citrix Workspaceアプリを終了して、再度開いてください。問題が解決しない場合は、システム管理者に連絡してください。
generalProblem リソースを開こうとしているときに問題が発生しました。 Citrix Workspaceアプリを終了して、再度開いてください。問題が解決しない場合は、システム管理者に連絡してください。
retryReasonUnknown ICAファイルでエラーが発生しました。 Citrix Workspaceアプリを終了して、再度開いてください。問題が解決しない場合は、システム管理者に連絡してください。
appRemoved リソースは管理者によって削除または無効にされました。 利用可能なアプリとデスクトップの最新リストについては、Citrix Workspaceアプリを更新するか、ログアウトして再度ログインしてください。
resourceError ICAファイルの起動中にエラーが発生しました。 数分待ってから、もう一度お試しください。問題が解決しない場合は、システム管理者に連絡してください。専用マシンである場合は、VDAを再起動してください。
resourceUnavailable ICAファイルの起動中にエラーが発生しました。 数分待ってから、もう一度お試しください。問題が解決しない場合は、システム管理者に連絡してください。専用マシンである場合は、VDAを再起動してください。
Citrix 接続のトラブルシューティング