Citrix DaaS™

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

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

概要

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

分析される接続パス

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

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

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

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

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

Citrix 接続トラブルシューティング機能には、ユーザーが一般的な問題から自動的に回復するための手順が含まれており、サポート介入の必要性を最小限に抑えます。ガイド付き修復で解決できる潜在的な問題は次のとおりです。

  • 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アプリで起動するモード)で起動されたセッションをサポートしていません。

エラーコード

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

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

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

Windows向けCitrix Workspaceアプリ

Error 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 このアプリを使用するには追加のソフトウェアが必要です。 システム管理者に連絡してサポートを受けてください。

Mac向けCitrix Workspaceアプリ

Error 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アプリ

Error 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 接続トラブルシューティング