Linux向けCitrix Workspace™アプリ

PDFを表示

トラブルシューティング

April 13, 2026

寄稿者:

C C

この記事では、管理者がCitrix Workspaceアプリに関する問題をトラブルシューティングするのに役立つ情報を提供します。

接続

次の接続問題が発生する可能性があります。

公開リソースまたはデスクトップセッション

Windowsサーバーへの接続を確立する際に、「Connecting to server…」というメッセージのダイアログボックスが表示されるものの、その後接続ウィンドウが表示されない場合、サーバーをクライアントアクセスライセンス (CAL) で構成する必要があるかもしれません。ライセンスの詳細については、「ライセンス」を参照してください。

セッションの再接続

Citrix Workspaceアプリが必要とするよりも高い色深度のセッションに再接続する際に、接続が失敗する場合があります。この失敗は、サーバー上の利用可能なメモリが不足している場合に発生します。

再接続が失敗した場合、Citrix Workspaceアプリは元の色深度を使用しようとします。そうでない場合、サーバーは要求された色深度で新しいセッションを開始しようとし、元のセッションは切断された状態のままになります。サーバー上で利用可能なメモリが依然として不足している場合、2回目の接続も失敗する可能性があります。

完全なインターネット名

Citrix®は、ネットワーク上でDNS (Domain Name Server) を構成することを推奨します。この構成により、接続したいサーバーの名前を解決できます。DNSが構成されていない場合、サーバー名をIPアドレスに解決できない可能性があります。代わりに、サーバー名を指定するのではなく、IPアドレスでサーバーを指定できます。TLS接続には、IPアドレスではなく、完全修飾ドメイン名が必要です。
低速セッション

マウスを動かすまでセッションが開始されない場合、Linuxカーネルの乱数生成に問題がある可能性があります。回避策として、rngd (ハードウェアベース) または haveged (Magic Software製) のようなエントロピー生成デーモンを実行してください。

Citrix Workspaceアプリのフィードバック送信

フィードバックの送信オプションを使用すると、Citrix Workspaceアプリの使用中に発生する可能性のある問題についてCloud Software Groupに通知できます。また、Citrix Workspaceアプリのエクスペリエンスを向上させるための提案を送信することもできます。

この新機能はフィードバックエクスペリエンスを向上させ、ユーザーとサポートチーム間のより効率的で情報豊富なコミュニケーションチャネルを確保します。

フィードバックの送信オプションには統合されたログマネージャーが含まれており、ユーザーは包括的なフィードバックレポートのために関連するログをキャプチャして含めることができます。

また、フィードバックの送信は、ユーザーがシステムにインストールされているデフォルトのメールクライアントを使用してフィードバックメールを直接送信できるようにすることで、シームレスなコミュニケーションを提供します。

サポートされているメールクライアントは次のとおりです。

Thunderbird
Evolution
- Mutt
- Alpine

フィードバック送信用のメールアドレスを構成するには、次の手順を実行します。

Authmanconfig.xmlファイルに次のキーを追加します。

<!-- Configure email address for sendfeedback - - >
 
<FeedbackEmailAddress>cwa-linux-feedback@cloud.com</FeedbackEmailAddress>
 
<key>SendFeedbackEnabled</key>
 
<value>true</value>
<!--NeedCopy-->

注：

Cloud Software Groupにフィードバックを送信することにより、お客様の参加がCloud Software Groupエンドユーザー契約に準拠し、それに従うことに同意するものとします。

次のいずれかの方法でフィードバックを送信できます。

アカウントの追加画面に移動します。
ハンバーガーメニューをクリックします。
フィードバックの送信をクリックします。

または、

アプリインジケーターアイコンのフィードバックの送信をクリックします。

または、

-  1.  コマンドラインで、`/opt/Citrix/ICAClient/util`パスに移動します。

次のコマンドを実行します。
```
./sendfeedback

```
フィードバックの送信画面が表示されます。
問題のタイトルを入力します。
詳細を教えてくださいフィールドに問題の詳細を追加します。
問題のキャプチャをクリックします。Citrixログ収集ユーティリティ画面が表示されます。

キャプチャの開始をクリックし、問題を再現して最新のログを収集します。

または、

問題を再現できない場合は、既存のログを選択をクリックします。
注：

Citrixログ収集ユーティリティの詳細については、「ログ収集」を参照してください。

ログファイルが問題のキャプチャの横に表示されていることを確認します。
ファイルの選択をクリックし、スクリーンショットや画面録画など、問題を示す添付ファイルを追加します。

送信をクリックします。フィードバックレポート画面が表示されます。

.tar.gz ファイルには、ログファイル、テストファイルとしての問題の説明、および添付ファイルが含まれています。

以下のオプションを使用して、Citrix にフィードバックレポートを送信できます。

デフォルトのメールアプリを使用してフィードバックレポートを送信 をクリックして、システムでデフォルトのメールアプリを使用します。
または、

提供されたメール ID にレポートを手動で送信します。

注：

メールに .zip ファイルが添付されていることを確認してください。

暗号スイート

新しい暗号化サポートで接続が失敗した場合：

サーバーがサポートする暗号スイートを確認するために、次のようなさまざまなツールを使用できます。
- Ssllabs.com (サーバーがインターネットアクセスを必要とします)
- sslyze (https://github.com/nabla-c0d3/sslyze)
Linux クライアントの WireShark で、フィルター (ip.addr == VDAIPAddress) を使用してパケット (Client Hello、Server Hello) を見つけ、SSL セクションを見つけます。結果には、クライアントによって送信され、サーバーによって受け入れられた暗号スイートが含まれています。

不適切な Citrix Optimization SDK

Citrix Optimization SDK パッケージには、UIDialogLibWebKit.so の不適切なバージョンが含まれています。回避策として、次の手順を実行します。

ダウンロードページから Citrix Optimization SDK パッケージバージョン 18.10 をダウンロードします。
1. パス CitrixPluginSDK/UIDialogLib/GTK に移動します。
  
  cd CitrixPluginSDK/UIDialogLib/GTK

1. すべてのオブジェクトファイルを削除します。
  
  rm -rf *.o
2. WebKit フォルダーに移動します。
  
  cd ../WebKit
1. 既存の UIDialogLibWebKit.so を削除します。
  
  rm -rf UIDialogLibWebKit.so
2. WebKit ディレクトリで次のコマンドを使用します。
  
  make all
  
  新しい UIDialogLibWebKit.so が生成されます。
3. 新しいライブラリを $ICAROOT/lib ディレクトリにコピーします。

SSL 接続用の脆弱な暗号スイート

TLS 接続を行う際、Citrix Workspace アプリはデフォルトで高度で制限された暗号スイートのセットを提供します。

古い暗号スイートを必要とするサーバーに接続している場合は、構成ファイルの \[WFClient\] セクションで構成オプション SSLCiphers=ALL を設定します。

次の高度な暗号スイートがサポートされています。

TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (0xc030), ALL, GOV
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 (0xc028), ALL, GOV
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA (0xc013), ALL, COM

接続の損失

EDT プロトコルを使用している場合、「…」への接続が失われました、というエラーメッセージが表示されることがあります。この問題は、接続がデフォルトの 1,500 バイトよりも小さい EDT の最大伝送ユニットを持つルーターを通過するときに発生する可能性があります。次の手順を実行します。

構成ファイルで edtMSS=1000 を設定します。
接続エラー

接続エラーにより、さまざまなエラーダイアログが表示されることがあります。例を次に示します。

接続エラー：認証サービスとの通信中にプロトコルエラーが発生しました。
認証サービスに接続できません。
このサーバーアドレスを使用してアカウントを追加できません。

次のような問題が、このようなエラーを引き起こす可能性があります。

ローカルコンピューターとリモートコンピューターが共通の TLS プロトコルをネゴシエートできない場合にエラーが発生する可能性があります。詳細については、TLS を参照してください。
リモートコンピューターが TLS 接続に古い暗号スイートを必要とする場合にエラーが発生する可能性があります。この場合、構成ファイルの \[WFClient\] セクションで構成オプション SSLCiphers=ALL を設定し、接続を再開する前に killall AuthManagerDaemon ServiceRecord selfservice storebrowse を実行できます。
リモートコンピューターがクライアント証明書を不適切に要求した場合にエラーが発生する可能性があります。IIS は、Citrix、認証、および証明書に対してのみ証明書を 受け入れる か 要求する 必要があります。
その他の問題。
低帯域幅接続

Citrix は、サーバーで Citrix Virtual Apps and Desktops または Citrix DaaS (旧称 Citrix Virtual Apps and Desktops サービス) の最新バージョンを使用することをお勧めします。また、ユーザーデバイスでは最新の Citrix Workspace アプリを使用してください。

低帯域幅接続を使用している場合は、Citrix Workspace アプリの構成と Citrix Workspace アプリの使用方法を変更して、パフォーマンスを向上させることができます。
Citrix Workspace アプリ接続の構成 - Citrix Workspace アプリ接続を構成すると、ICA が必要とする帯域幅を削減し、パフォーマンスを向上させることができます。
Citrix Workspace アプリの使用方法の変更 - Citrix Workspace アプリの使用方法を変更すると、高性能接続に必要な帯域幅を削減することもできます。
UDP オーディオの有効化 - この機能は、Voice-over-IP (VoIP) 接続において、混雑したネットワークで一貫した遅延を維持できます。
Citrix Workspace アプリ for Linux および Citrix Virtual Apps and Desktops または Citrix DaaS の最新バージョンの使用 - Citrix はリリースごとにパフォーマンスを継続的に強化および改善しており、多くのパフォーマンス機能には最新の Citrix Workspace アプリとサーバーソフトウェアが必要です。

ディスプレイ

画面のティアリング

画面のティアリングは、2 つ (またはそれ以上) の異なるフレームの一部が、水平ブロックで同時に画面に表示されるときに発生します。この問題は、画面上で急速に変化するコンテンツの広い領域で最も顕著に現れます。

VDA でデータがキャプチャされると、ティアリングは回避されます。データがクライアントに渡されるときにティアリングは発生しません。ただし、X11 (Linux/Unix グラフィックサブシステム) は、ティアリングを防ぐ方法で画面に描画するための一貫した方法を提供しません。

画面のティアリングを防ぐために、Citrix はアプリケーションの描画と画面の描画を同期させる標準的なアプローチを推奨しています。つまり、次のフレームの描画を開始するために vsvnc を待ちます。クライアントのグラフィックハードウェアと使用しているウィンドウマネージャーに応じて、画面のティアリングを防ぐために次の 2 つのソリューショングループが利用可能です。

X11 GPU 設定
コンポジションマネージャーの使用

X11 GPU設定

Intel HDグラフィックスの場合、xorg.conf.dに20-intel.confというファイルを作成し、以下の内容を記述します。

Section "Device"

 Identifier    "Intel Graphics"
 Driver        "intel"
 Option        "AccelMethod" "sna"
 Option        "TearFree" "true"

 EndSection

NVIDIAグラフィックスの場合、xorg.conf.dフォルダーにある、構成の「MetaModes」オプションを含むファイルを見つけます。コンマ区切りのMetaModeごとに、以下を追加します。

{ForceFullCompositionPipeline = On}

例:

Option “MetaModes” “DFP-0: 1920x1200 +0+0 {ForceFullCompositionPipeline = On}”

注:

Linuxディストリビューションによってxorg.conf.dへのパスは異なり、たとえば /etc/X11/xorg.conf.d や /user/share/X11/xorg.conf.d などがあります。

コンポジションマネージャー

以下を使用します。

Compiz（Ubuntu Unityに組み込まれています）。「CompizConfig設定マネージャー」をインストールします。

「CompizConfig設定マネージャー」を実行します。

General > Compositionの下で、Undirect Fullscreen Windowsをクリアします。

注:

「CompizConfig設定マネージャー」は、値を誤って変更するとシステムの起動を妨げる可能性があるため、注意して使用してください。

Compton（アドオンユーティリティ）。詳細については、Comptonのメインページ/ドキュメントを参照してください。たとえば、次のコマンドを実行します。

compton ---vsync opengl ---vsync -aggressive

キー入力の誤り

非英語キーボードを使用している場合、画面表示がキーボード入力と一致しないことがあります。この場合、使用しているキーボードの種類とレイアウトを指定する必要があります。キーボードの指定方法について詳しくは、「キーボードの動作の制御」を参照してください。

過剰な再描画

一部のウィンドウマネージャーでは、シームレスウィンドウを移動する際に新しいウィンドウの位置を継続的に報告するため、過剰な再描画が発生する可能性があります。この問題を解決するには、ウィンドウを移動するときにウィンドウの輪郭のみを描画するモードにウィンドウマネージャーを切り替えます。

アイコンの互換性

Citrix Workspaceアプリは、ほとんどのウィンドウマネージャーと互換性のあるウィンドウアイコンを作成します。ただし、これらのアイコンはX Inter-Client Communication Conventionと完全な互換性があるわけではありません。

完全なアイコン互換性

完全なアイコン互換性を提供するには：

wfclient.ini設定ファイルを開きます。
[WFClient]セクションの次の行を編集します：UseIconWindow=True
ファイルを保存して閉じます。

カーソル色

-  カーソルが背景色と同じまたは類似している場合、見えにくくなることがあります。この問題は、カーソルの一部を黒または白に強制することで解決できます。

カーソルの色を変更するには

wfclient.ini設定ファイルを開きます。
[WFClient]セクションに次のいずれかの行を追加します。

CursorStipple=ffff,ffff（カーソルを黒にする場合）

CursorStipple=0,0（カーソルを白にする場合）
ファイルを保存して閉じます。

色のちらつき

-  マウスを接続ウィンドウの内外に移動すると、フォーカスされていないウィンドウの色がちらつき始めます。この問題は、PseudoColorディスプレイでX Windows Systemを使用する場合に既知の制限です。可能であれば、影響を受ける接続にはより高い色深度を使用してください。

TrueColorディスプレイでの色の変化

サーバーに接続する際に256色を使用するオプションがあります。このオプションは、ビデオハードウェアがパレットサポートを備えており、アプリケーションがパレットの色を変更してアニメーション表示を生成できることを前提としています。

TrueColorディスプレイには、パレットをすばやく変更してアニメーションを生成する機能をエミュレートする機能がありません。この機能のソフトウェアエミュレーションは、時間とネットワークトラフィックの点でコストがかかります。このコストを削減するため、Citrix Workspaceアプリは高速なパレット変更をバッファリングし、数秒ごとに実際のパレットを更新します。

不正確な表示

Citrix Workspaceアプリは日本語文字にEUC-JPまたはUTF-8文字エンコードを使用しますが、サーバーはSJIS文字エンコードを使用します。Citrix Workspaceアプリはこれらの文字セット間の変換を行いません。この問題は、以下の表示に問題を引き起こす可能性があります。

サーバーに保存され、ローカルで表示されるファイル
ローカルに保存され、サーバーで表示されるファイル

この問題は、拡張パラメーター渡しで使用されるパラメーター内の日本語文字にも影響します。

セッションのスパン

フルスクリーンセッションはデフォルトですべてのモニターにまたがりますが、コマンドラインのマルチモニター表示制御オプションである -span も利用できます。これにより、フルスクリーンセッションを複数のモニターにまたがって表示できます。

Desktop Viewer のツールバー機能を使用すると、ウィンドウモードとフルスクリーンセッションウィンドウ間でセッションを切り替えることができ、交差するモニターのマルチモニターサポートも含まれます。

重要:

スパンは、シームレスセッションや通常のウィンドウセッション（最大化されたウィンドウのセッションを含む）には影響しません。

-span オプションの形式は次のとおりです。 -span [h][o][a|mon1[,mon2[,mon3, mon4]]]

h が指定されている場合、モニターのリストが stdout に出力されます。h がオプション値全体である場合、wfica は終了します。

o が指定されている場合、セッションウィンドウは override-redirect 属性を持ちます。

注意:

このオプションの使用は推奨されません。これは、非協力的なウィンドウマネージャーで使用するための最終手段として意図されています。
セッションウィンドウはウィンドウマネージャーに表示されず、アイコンを持たず、再スタックできません。
セッションを終了することによってのみ削除できます。

a が指定されている場合、Citrix Workspace アプリはすべてのモニターをカバーするセッションを作成しようとします。

Citrix Workspace アプリは、-span オプション値の残りがモニター番号のリストであると想定します。

単一の値は特定のモニターを選択します。
2つの値は、必要な領域の左上隅と右下隅にあるモニターを選択します。
4つの値は、領域の上、下、左、右の端にあるモニターを指定します。

o が指定されていない場合、wfica は、サポートされている場合は _NET_WM_FULLSCREEN_MONITORS メッセージを使用して、ウィンドウマネージャーから適切なウィンドウレイアウトを要求します。そうでない場合は、サイズと位置のヒントを使用して目的のレイアウトを要求します。

ウィンドウマネージャーのサポートをテストするには、次のコマンドを使用できます。 xprop -root | grep \_NET\_WM\_FULLSCREEN\_MONITORS

出力がない場合、サポートはありません。サポートがない場合は、override-redirect ウィンドウが必要になる場合があります。-span o を使用して override-redirect ウィンドウを設定できます。

コマンドラインから複数のモニターにまたがるセッションを作成するには:

コマンドプロンプトで、次のように入力します。

/opt/Citrix/ICAClient/wfica -span h

現在ユーザーデバイスに接続されているモニターの番号のリストが stdout に出力され、wfica は終了します。
これらのモニター番号をメモします。

コマンドプロンプトで、次のように入力します。

/opt/Citrix/ICAClient/wfica -span \[w\[,x\[,y,z\]\]\]

w、x、y、および z の値は、前の手順のステップ 1 で取得したモニター番号です。単一の値 w は特定のモニターを指定します。2つの値 w と x は、必要な領域の左上隅と右下隅にあるモニターを指定します。4つの値 w、x、y、および z は、領域の上、下、左、および右の端にあるモニターを指定します。

> **重要:**
>
> -  ブラウザを介してセルフサービスを開始する前に、`WFICA_OPTS` 変数を定義します。この変数を定義するには、通常 `$HOME/.bash_profile` または `$HOME/.profile` にあるプロファイルファイルを編集し、`WFICA_OPTS` 変数を定義する行を追加します。例: `export WFICA_OPTS="-span a"`
> -  この変更は、仮想アプリとデスクトップの両方のセッションに影響します。
> -  セルフサービスまたは `storebrowse` を開始している場合は、新しい環境変数を有効にするために開始されたプロセスを削除します。これらを削除するには、次を使用します: `killall AuthManagerDaemon ServiceRecord storebrowse`

ローカルアプリケーション

フルスクリーンセッションからローカルアプリケーションや別のセッションを使用するために抜け出せない場合があります。この問題は、クライアント側のシステム UI が非表示になり、キーボード透過機能が通常のキーボードコマンド（例: Alt+Tab）を無効にし、代わりにコマンドをサーバーに送信するために発生します。

回避策として、次にフォーカスがセッションウィンドウに戻るまで、CTRL+F2 を使用してキーボード透過機能を一時的に解除します。別の回避策として、$ICAROOT/config/module.ini で TransparentKeyPassthrough を No に設定します。この回避策はキーボード透過機能を無効にします。ただし、ICA ファイルにこの設定を追加して All_regions.ini ファイルで上書きする必要がある場合があります。

エラーメッセージの改善

以前は、すべてのエラーメッセージにデフォルトのエラーコードと、エラーに固有ではない説明が含まれていました。Citrix Workspace アプリバージョン 2309 以降、エラーメッセージは、エラーに固有の エラーコード、トランザクション ID、および説明フィールドを含むように改善されました。これらのエラーメッセージは、ICA 起動を使用してセッションが開始されるとき、またはサービス継続機能が有効な状態でセッションが開始されるときに表示されます。

たとえば、セッション起動に失敗した場合、次のエラーメッセージが表示されます。

-  ![セッション起動の失敗](/en-us/citrix-workspace-app-for-linux/media/session-launch-failed.png)

Webカメラ

デフォルトのWebカメラの更新

現在、Linux 版 Citrix Workspace アプリの Webカメラリダイレクトは、一度に1つの Webカメラのみをサポートしています。選択されたデフォルトの Webカメラは、デバイスパス /dev/video0 にマッピングされます。これは通常、ノートパソコンの内蔵 Webカメラです。

システム内のビデオ機能を持つすべてのデバイスを一覧表示するには、次のコマンドを使用して v4l ツールをインストールする必要があります。

sudo apt-get install v4l-utils
<!--NeedCopy-->

次のコマンドを使用してビデオデバイスを一覧表示します。

v4l2-ctl --list-devices
<!--NeedCopy-->

次のような出力が表示される場合があります。

user@user-pc:~ $ v4l2-ctl --list-devices
UVC Camera (046d:09a6) (usb-0000:00:14.0-1):
    /dev/video2
    /dev/video3
    /dev/media1
Integrated Camera: Integrated C (usb-0000:00:14.0-8):
    /dev/video0
    /dev/video1
    /dev/media0
<!--NeedCopy-->

上記の例のとおり、2つの Webカメラがあります。どちらでも使用できます。Citrix は最初のインデックスを使用することを推奨します。Ubuntu には既知の問題があり、1つの Webカメラに対して複数のインデックスが表示される場合があります。この例では、/dev/video0 と /dev/video2 を使用できます。

別のキャプチャビデオをデフォルトとして設定するには、次の操作を行います。

~/.ICAClient/wfclient.ini 設定ファイルに移動して編集します。
[WFClient] セクションに、次の設定を追加します。

HDXWebCamDevice=<device path>

例として、システム内で /dev/video2 にマッピングされたウェブカメラを設定するには、HDXWebCamDevice=/dev/video2 を追加します。

テスト機能

クライアントでは、ウェブカメラリダイレクトモジュールをさまざまなモードで使用して、顧客の環境条件下で分離されたコンポーネントをテストできます。

プロダクションおよびデバッグモード

このモードでは、VDA側で表示されるビデオと、エンコーダーがクライアント側で生成する実際のバッファーを比較します。これにより、パイプライン全体をテストできます。

このモードを有効にするには：

~/.ICAClient/wfclient.ini 設定ファイルに移動し、編集します。
HDXWebcamDebug の値を True に設定します。

HDXWebcamDebug=True

このモードが有効になると、使用されているエンコーダーに応じて、エンコーダーはバッファーを含む以下のファイルを生成します。
H264 エンコーダーの場合: /tmp/file_mode_buffers.h264
Theora エンコーダーの場合: /tmp/file_mode_buffers.theora

次の図は、プロダクションおよびデバッグモードを示しています。

プロダクションおよびデバッグモードの画像

ウェブカメラテスターモード

このモードでは、パイプラインの他の要素から分離してウェブカメラをテストできます。

./gst_read --buffers | -b BUFFERS_AMOUNT  [ --input_device | -i WEBCAM_DEVICE; default=/dev/video0]
<!--NeedCopy-->

ウェブカメラテスターモードを有効にするには、コマンドラインから以下のコマンドを実行します。

   cd /opt/Citrix/ICAClient/util
   <!--NeedCopy-->

   `$./gst_read -b 100 /dev/video0
   <!--NeedCopy-->

このモードが有効になると、ビデオプレビューが表示され、ウェブカメラからの生バッファーを含む以下のファイルが作成されます。

/tmp/wewbcam_buffers.buff

ウェブカメラテスターモードに必要な唯一のスイッチは、---buffers (-b) オプションです。テストするウェブカメラデバイスを指定することもできます。例を以下に示します。
./gst_read -buffers 150
./gst_read ---buffers 100 ---input_device /dev/video2

次の図は、ウェブカメラテスターモードを示しています。

ウェブカメラテスターモードの画像

エンコーダーテスターモード

このモードでは、パイプラインから分離してエンコーダーをテストできます。

./gst_read --output_file | -o FILE_NAME [ --buffers | -b BUFFER_AMOUNT; default=10 0 ]  [ --enableH264  | -e ]
<!--NeedCopy-->

エンコーダーテスターモードを有効にするには、コマンドラインから以下のコマンドを実行します。

cd /opt/Citrix/ICAClient/util
<!--NeedCopy-->

./gst_read -o ~/file_buffers.h264 -e
 <!--NeedCopy-->

このモードに必要な唯一のスイッチは、---output_file (-o) オプションです。Theora または H264 エンコーダー、および生成するバッファーの量をテストすることもできます。例を以下に示します。

H264 の場合: ./gst_read ---output_file ~/file_buffers.h264 --buffers 200 --enableH264
Theora の場合: ./gst_read -o ~/file_buffers.theora -b 100

次の図は、エンコーダーテスターモードを示しています。

エンコーダーテスターモードの画像

H264 ソフトウェアエンコーダー

ソフトウェアベースの H264 エンコーダーが正しく動作しない場合は、以下の手順を使用してその依存関係を確認する必要があります。

gstreamer-plugins-ugly の一部として、x264 GStreamer プラグインがシステムに存在するかどうかを確認します。libgstx264.so ライブラリで利用可能な場合は、以下のコマンドを実行して確認します。
```
gst-inspect-1.0 x264

```
libgstx264.so ライブラリの依存関係を確認するには、以下のコマンドを実行します。
```
ldd /usr/lib/x86_64-linux-gnu/gstreamer-1.0/libgstx264.so

```

libgstx264.so ファイルが存在しない場合は、以下のコマンドを使用して GStreamer プラグイン ugly をインストールする必要があります。

sudo apt-get install gstreamer1
0-plugins-ugly
<!--NeedCopy-->

H264 ハードウェアエンコーダー

vaapi GStreamer プラグインが gstreamer1.0-vaapi の一部としてシステムに存在することを確認します。libgstvaapi.so ライブラリで利用可能な場合は、次のコマンドを実行して確認します。
```
gst-inspect-1.0 vaapi

```

1. 次のコマンドを実行して、libgstvaapi.so ライブラリの依存関係を確認します。
```
     ldd /usr/lib/x86_64-linux-gnu/gstreamer-1.0/libgstvaapi.so
 
```

不足している依存関係を解決します。

vaapi をインストールおよび構成するには、GStreamer vaapiインストールガイドに従ってください。

内部 `GStreamer` フレームワークと `gst_read` ログの収集

通常の ICAClient ログの代わりに、gst_read モジュールからログを収集する必要があります。

ログを収集するには、次の手順を実行します。

ターミナルを開き、次のコマンドを実行します。
```
export GST_DEBUG=2,gst_read_debug:6

```
```
export GST_DEBUG_FILE=~/gst_read.log

```
注：

この変数は、ログ収集のレベルとログを保存するファイルを指定します。この場合、GStreamer フレームワークにはレベル2を、gst_read モジュールにはレベル7を設定しています。詳細については、ドキュメントを参照してください。内部 GStreamer フレームワークにはエラーおよび警告レベルのみを設定し、gst_read にはログレベルを設定することをお勧めします。
有効なVDAのICA®ファイルをダウンロードします。
同じターミナルで、次のコマンドを実行してVDAセッションを開始します。
```
cd /opt/Citrix/ICAClient

```
```
./wfica   <ICA file path>/vda.ica

```

内部 GStreamer フレームワークと gst_read ログを含む gst_read.log ファイルが生成されます。

`GStreamer` パイプラインの検査

GStreamer フレームワークが作成している実際のパイプラインを確認するには、次の手順を実行します。

dotファイルを保存するフォルダーを作成します。例: gstIntPipes。
ターミナルを開き、GST_DEBUG_DUMP_DOT_DIR=<Absolute path>/gstIntPipes をエクスポートします。この変数は、GStreamer にdotファイルの保存場所を示します。
有効なVDAのICAファイルをダウンロードします。
同じターミナルで、次のコマンドを実行してVDAセッションを開始します。
```
cd /opt/Citrix/ICAClient/

```
```
./wfica <ICA file path>/vda.ica

```
ディレクトリ gstIntPipes にはdotファイルが含まれています。GStreamer は、パイプラインの状態が変更されるたびにdotファイルを生成します。その結果、パイプライン作成のすべてのプロセスを検査できます。以下は、dotファイルのセットの例です。
パイプラインの視覚的な表現を確認するには、dotファイルユーティリティをインストールします。例: Graphviz。以下の画像は、パイプラインの良好な作成例と不良な作成例です。

パイプラインが正常に作成されました:

パイプラインをリンクできません:

パイプラインをリンクできない画像

注：

上記の画像またはその他の画像を拡大するには、画像を右クリックし、[新しいタブで画像を開く] を選択して、必要に応じてブラウザをズームします。

上記の画像に示すように、2番目のパイプラインは GstCapsFilter 要素と GstVaapiEncodeH264 要素をリンクできません。機能は完全にネゴシエートされません。詳細については、ドキュメントを参照してください。

RAVE 用システム診断スクリプト

Remote Audio Video Extensions (RAVE) をサポートするために、システム構成と依存関係が適切であるかどうかを確認するためのスクリプト rave_troubleshooting.sh を提供しています。

注：

RAVE は、Citrix VDA の最適化されたWebカメラリダイレクトとWindows Media PlayerリダイレクトをサポートするHDX™機能です。

スクリプトを実行するには、次の手順を実行します。

rave_troubleshooting.sh をクリックしてスクリプトをダウンロードします。
Linuxマシンでターミナルを開きます。
サポートされているコマンドライン引数を確認するには、rave_troubleshooting.sh --help または rave_troubleshooting.sh -h と入力します。
次のいずれかを入力します。
- rave_troubleshooting.sh -w または rave_troubleshooting.sh --webcam - このコマンドを使用して、Webカメラリダイレクトのチェックを実行します。このコマンドがデフォルトです。
- rave_troubleshooting.sh -r または rave_troubleshooting.sh --rave - このコマンドを使用して、RAVEのチェックを実行します。h264テストビデオを再生するポップアップウィンドウが表示されます。
システム構成と依存関係が表示されます。

汎用USBリダイレクト

Androidフォンを汎用USBとしてリダイレクトする方法

Androidフォンを汎用USBとしてリダイレクトするには、次の手順を実行します。

Android スマートフォンを、Citrix Workspace アプリ for Linux がインストールされているシステムに USB ケーブルで接続します。
スマートフォンで USB 接続モード (MTP または PTP) を選択します。ほとんどの Android スマートフォンでは、PTP がサポートされているモードです。
ターミナルで以下を入力して、Android スマートフォンのデバイス記述子からのベンダー ID (VID) と製品 ID (PID) を取得します。
```
lsusb

```
Android スマートフォンの VID と PID をメモします。
usb.conf ファイルに移動します。
usb.conf ファイルの末尾に CONNECT vid=<お使いのスマートフォンのVID> pid=<お使いのスマートフォンのPID> split=01 intf=00 の行を追加します。たとえば、次のように追加します。
```
CONNECT vid=18d1 pid=4ee2 split=01 intf=00

```
Desktop Viewer ツールバーの [デバイス] メニューに移動します。
リダイレクトする Android スマートフォンを選択します。

ブラウザー

ローカルブラウザー

Windows セッションでリンクをクリックすると、コンテンツがローカルブラウザーに表示されます。サーバーとクライアント間のコンテンツリダイレクトは wfclient.ini で有効になっています。このリダイレクトにより、ローカルアプリケーションが実行されます。サーバーとクライアント間のコンテンツリダイレクトを無効にするには、「サーバーとクライアント間のコンテンツリダイレクト」を参照してください。
公開リソースへのアクセス

公開リソースにアクセスすると、ブラウザーはファイルの保存を促します。Firefox および Chrome 以外のブラウザーでは、公開リソースに接続する前に構成が必要になる場合があります。ただし、ページ上のアイコンをクリックしてリソースにアクセスしようとすると、ブラウザーは ICA ファイルの保存を促します。

特定のブラウザー

特定の Web ブラウザーの使用に問題がある場合は、setupwfc を実行する前に、環境変数 BROWSER を設定して、必要なブラウザーのローカルパスと名前を指定します。

Firefox ブラウザー

Firefox でデスクトップまたはアプリケーションを起動したときに、ページが応答しない場合は、ICA プラグインを有効にしてみてください。

Firefox の ICA プラグイン

Firefox で ICA プラグインが有効になっている場合、デスクトップおよびアプリケーションセッションが起動しないことがあります。この場合は、ICA プラグインを無効にしてみてください。

構成エラー

接続エントリを誤って構成した場合に、これらのエラーが発生する可能性があります。

E_MISSING_INI_SECTION - 構成ファイルを確認してください: 「…」。構成ファイルにセクション「…」がありません。

構成ファイルが誤って編集されたか、破損しています。

E_MISSING_INI_ENTRY - 構成ファイルを確認してください: 「…」。セクション「…」にはエントリ「…」が含まれている必要があります。

構成ファイルが誤って編集されたか、破損しています。

E_INI_VENDOR_RANGE - 構成ファイルを確認してください: 「…」。構成ファイル内の X サーバーベンダー範囲「…」が無効です。

構成ファイル内の X Server ベンダー情報が破損しています。Citrix にお問い合わせください。

wfclient.ini 構成エラー

wfclient.ini を誤って編集した場合に、これらのエラーが発生する可能性があります。

-  `E_CANNOT_WRITE_FILE - ファイルを書き込めません: 「...」`

-  接続データベースの保存中に問題が発生しました。たとえば、ディスク容量が不足しています。

E_CANNOT_CREATE_FILE - ファイルを作成できません: 「...」

接続データベースの作成中に問題が発生しました。

E_PNAGENT_FILE_UNREADABLE - Citrix Virtual Apps ファイル「…」を読み取れません: そのようなファイルまたはディレクトリはありません。

— または —

Citrix Virtual Apps™ ファイル「…」を読み取れません: アクセスが拒否されました。

デスクトップ項目またはメニューからリソースにアクセスしようとしていますが、そのリソースの Citrix Virtual Apps and Desktops™ または Citrix DaaS ファイルが利用できません。[表示] メニューで [アプリケーションの更新] を選択して公開リソースのリストを更新し、もう一度リソースにアクセスしてみてください。エラーが解決しない場合は、次のことを確認してください。

-  デスクトップアイコンまたはメニュー項目のプロパティを確認します
-  アイコンまたは項目が参照する Citrix Virtual Apps and Desktops または Citrix DaaS™ ファイルを確認します。

ブラウザーコンテンツリダイレクト

ブラウザーコンテンツリダイレクトのトラブルシューティング方法については、Knowledge Center の記事「CTX230052」を参照してください。

自己署名証明書を nssdb にインポートする方法

自己署名証明書を nssdb にインポートするには、ターミナルで次のコマンドを実行します。

certutil -A -n "badssl.cer" -t "C,," -d ~/.pki/nssdb -i ~/Downloads/badssl.cer
<!--NeedCopy-->

コマンドの引数は次のとおりです。

-  `-A` - データベースに証明書を追加します。

-n - 証明書の名前。この引数はオプションであり、ニックネームを追加するために使用できます。
"badssl.cer" - badssl.com サイトからエクスポートされた証明書の名前。
-t "C,," - -t は TRUSTARGS 用で、C は CA 証明書用です。詳細については、Google ドキュメントを参照してください。
-d ~/.pki/nssdb - データベースの場所。
-i - 入力ファイルを示します。この引数は、証明書ファイルの場所と名前を追加するためのものです。

BCR の詳細については、Citrix Virtual Apps and Desktops ドキュメントの「ブラウザーコンテンツリダイレクト」ページを参照してください。

その他

接続の問題

以下の問題も発生する可能性があります。

セッションの終了

サーバーがCitrix Workspaceアプリにセッションを閉じるよう指示したかどうかを知るには、wficaプログラムを使用します。このプログラムは、サーバーからセッションを終了するコマンドを受信したときにログを記録します。

この情報をsyslogシステムを通じて記録するには、設定ファイルの[WFClient]セクションにSyslogThresholdを値6で追加します。この設定により、LOG_INFO以上の優先度を持つメッセージのログ記録が有効になります。SyslogThresholdのデフォルト値は4（=LOG_WARNING）です。

同様に、wficaに情報を標準エラーに送信させるには、[WFClient]セクションにPrintLogThresholdを値6で追加します。PrintLogThresholdのデフォルト値は0（=LOG_EMERG）です。

ログ収集の詳細については、ログ収集を、syslog設定の詳細については、syslog設定を参照してください。

設定ファイルの設定

wfclient.iniの各エントリには、設定を有効にするためにAll_Regions.iniに対応するエントリが必要です。また、wfclient.iniの[Thinwire3.0]、[ClientDrive]、および[TCP/IP]セクションの各エントリには、設定を有効にするためにcanonicalization.iniに対応するエントリが必要です。詳細については、$ICAROOT/configディレクトリにあるAll_Regions.iniおよびcanonicalization.iniファイルを参照してください。

公開アプリケーション

シリアルポートにアクセスする公開アプリケーションの実行に問題がある場合、そのポートが別のアプリケーションによってロックされていると、アプリケーションが失敗する可能性があります（アプリケーション自体によってエラーメッセージが表示される場合とされない場合があります）。このような状況では、シリアルポートを一時的にロックしている、またはシリアルポートをロックしたまま解放せずに終了したアプリケーションがないことを確認してください。

この問題を解決するには、シリアルポートをブロックしているアプリケーションを停止します。UUCPスタイルのロックに関しては、アプリケーションの終了後にロックファイルが残される場合があります。これらのロックファイルの場所は、使用されているオペレーティングシステムによって異なります。

Citrix Workspaceアプリの起動

Citrix Workspaceアプリが起動しない場合、「Application default file could not be found or is out of date」というエラーメッセージが表示されます。その理由は、環境変数ICAROOTが正しく定義されていないことにあるかもしれません。この変数は、Citrix Workspaceアプリをデフォルト以外の場所にインストールした場合に必須です。この問題を解決するために、Citrixは以下のいずれかを実行することを推奨します。

ICAROOTをインストールディレクトリとして定義します。

ICAROOT環境変数が正しく定義されていることを確認するには、ターミナルセッションからCitrix Workspaceアプリを起動してみてください。エラーメッセージが引き続き表示される場合、ICAROOT環境変数が正しく定義されていない可能性が高いです。
Citrix Workspaceアプリをデフォルトの場所に再インストールします。Citrix Workspaceアプリのインストールに関する詳細については、インストールとセットアップを参照してください。

Citrix Workspaceアプリが以前にデフォルトの場所にインストールされていた場合は、再インストールする前に/opt/Citrix/ICAClientまたは$HOME/ICAClient/platformディレクトリを削除してください。

Citrix CryptoKit（旧SSLSDK）

実行中のCitrix CryptoKit（旧SSLSDK）またはOpenSSLのバージョン番号を確認するには、次のコマンドを使用します。 strings libctxssl.so | grep "Citrix SSLSDK"

このコマンドはAuthManagerDaemonまたはPrimaryAuthManagerでも実行できます。

キーボードショートカット

ウィンドウマネージャーがネイティブ機能を提供するために同じキーの組み合わせを使用している場合、キーの組み合わせが正しく機能しない可能性があります。たとえば、KDEウィンドウマネージャーは、デスクトップ13から16を切り替えるためにCTRL+SHIFT+F1からCTRL+SHIFT+F4の組み合わせを使用します。この問題が発生した場合は、以下の解決策を試してください。

キーボードの翻訳モードは、一連のローカルキーの組み合わせをサーバー側のキーの組み合わせにマッピングします。たとえば、デフォルトでは翻訳モードでCTRL+SHIFT+F1はサーバー側のキーの組み合わせALT+F1にマッピングされます。このマッピングを代替のローカルキーの組み合わせに再構成するには、$HOME/.ICAClient/wfclient.iniの[WFClient]セクションにある次のエントリを更新します。この設定は、ローカルキーの組み合わせAlt+Ctrl+F1をAlt+F1にマッピングします
- Hotkey1Shift=Ctrl+ShiftをHotkey1Shift=Alt+Ctrlに変更します。
キーボードのダイレクトモードは、すべてのキーの組み合わせを直接サーバーに送信します。これらはローカルでは処理されません。ダイレクトモードを設定するには、$HOME/.ICAClient/wfclient.iniの[WFClient]セクションでTransparentKeyPassthroughをRemoteに設定します。
デフォルトのキーボードの組み合わせを抑制するようにウィンドウマネージャーを再構成します。

リモートのクロアチア語キーボード

この手順により、ASCII文字がクロアチア語キーボードレイアウトのリモート仮想デスクトップに正しく送信されるようになります。

適切な設定ファイルのWFClientセクションで、UseEUKSforASCIIをTrueに設定します。
UseEUKSを2に設定します。

日本語キーボード

日本語キーボードの使用を設定するには、wfclient.ini設定ファイルの次のエントリを更新します。

KeyboardLayout=Japanese (JIS)

ABNT2キーボード

ABNT2キーボードの使用を設定するには、wfclient.ini設定ファイルの次のエントリを更新します。

KeyboardLayout=Brazilian (ABNT2)

ローカルキーボード

ローカルキーボードの一部のキーが期待どおりに動作しない場合は、$ICAROOT/config/module.iniのリストから最適なサーバーレイアウトを選択してください。

Windows Media Player

Citrix Workspaceアプリには、要求された形式を処理するためのGStreamerプラグインがない場合があります。この問題は通常、サーバーが異なる形式を要求する原因となります。場合によっては、適切なプラグインの初期チェックが誤って存在すると示してしまうことがあります。この問題は通常検出され、Windows Media Playerがファイルの再生中に問題を発見したことを示すエラーダイアログがサーバーに表示されます。セッション内でファイルを再試行すると、Citrix Workspaceアプリがその形式を拒否するため、通常は機能します。その結果、サーバーは別の形式を要求するか、メディア自体を提供します。

いくつかの状況では、適切なプラグインが検出されず、Windows Media Playerで進行状況インジケーターが期待どおりに動いているにもかかわらず、ファイルが正しく再生されないことがあります。

将来のセッションでこのエラーダイアログや再生の失敗を回避するには：

一時的に、例えば$Home/.ICAClient/wfclient.iniの[WFClient]セクションに設定オプション「SpeedScreenMMAVerbose=On」を追加します。
ターミナルから起動されたセルフサービスからwficaを再起動します。
このエラーを生成するビデオを再生します。
（トレース出力で）不足しているプラグインのトレースに関連付けられたMIMEタイプ、またはサポートされるべきだが再生されないMIMEタイプ（例：「video/x-h264..」）をメモします。
$ICAROOT/config/MediaStreamingConfig.tblを編集します。メモしたMIMEタイプのある行で、「:」とMIMEタイプの間に「?」を挿入します。この設定により、その形式が無効になります。
このエラー状態を引き起こす他のメディア形式についても、手順2～5（前述）を繰り返します。
同じGStreamerプラグインのセットを持つ他のマシンに、この変更されたMediaStreamingConfig.tblを配布します。

注：

あるいは、MIMEタイプを特定した後、それをデコードするためのGStreamerプラグインをインストールできる場合があります。

Windows Media Playerリダイレクトのシステム要件検証スクリプト

2307リリースでは、Citrix Workspaceアプリ for LinuxのWindows Media Playerリダイレクト機能に必要な構成を検証するための新しいbashスクリプトが導入されました。この機能は、Windows Media Playerリダイレクト機能のトラブルシューティング時間の短縮に役立ちます。構成を検証するには、RAVEのシステム診断スクリプトで入手可能な同じrave_troubleshooting.shを使用できます。

シリアルポート設定

単一のシリアルポートを構成するには、$ICAROOT/config/module.ini構成ファイルに次のエントリを追加します。

LastComPortNum=1

ComPort1=device

2つ以上のシリアルポートを構成するには、$ICAROOT/config/module.ini構成ファイルに次のエントリを追加します。

LastComPortNum=2

ComPort1=device1

ComPort2=device2

エラー

このトピックには、Citrix Workspaceアプリの使用時に表示される可能性のある他の一般的なエラーメッセージのリストが含まれています。

エラーが発生しました。エラーコードは11 (E_MISSING_INI_SECTION)です。ドキュメントを参照してください。終了します。

コマンドラインからCitrix Workspaceアプリを実行すると、このエラーは通常、コマンドラインで指定された説明がappsrv.iniファイルに見つからなかったことを意味します。

E_BAD_OPTION - オプション「…」が無効です。

オプション「…」の引数がありません。

E_BAD_ARG - オプション「…」に無効な引数「…」があります。

オプション「…」に指定された引数が無効です。

E_INI_KEY_SYNTAX - 構成ファイル「…」内のキー「…」が無効です。

構成ファイル内のX Serverベンダー情報が破損しています。構成ファイルを作成してください。

E_INI_VALUE_SYNTAX - 構成ファイル「…」内の値「…」が無効です。

構成ファイル内のX Serverベンダー情報が破損しています。構成ファイルを作成してください。

E_SERVER_NAMELOOKUP_FAILURE - サーバー「…」に接続できません。

サーバー名を解決できません。

1つ以上のファイル「…」に書き込めません。ディスク容量不足の問題または権限の問題を修正して、もう一度試してください。

ディスク容量不足の問題、または権限の問題を確認してください。問題が見つかり修正された場合は、エラーメッセージが表示された操作を再試行してください。

サーバー接続が失われました。再接続して、もう一度試してください。これらのファイルはデータが欠落している可能性があります：「…」。

再接続して、エラーが表示された操作を再試行してください。

診断情報

Citrix Workspaceアプリの使用中に問題が発生した場合、テクニカルサポートに診断情報の提供を求められることがあります。この情報は、このチームが問題の診断を試み、それを修正するための支援を提供するのに役立ちます。

Citrix Workspaceアプリの診断情報を取得するには：

インストールディレクトリで、util/lurdumpと入力します。セッションが開いている間、可能であれば問題が発生している間にこの変更を行うことをお勧めします。

バージョン詳細、Citrix Workspaceアプリの構成ファイルの内容、およびさまざまなシステム変数の値を含む詳細な診断情報を提供するファイルが生成されます。
ファイルをテクニカルサポートに送信する前に、機密情報がないか確認してください。

リソースへの接続のトラブルシューティング

ユーザーはConnection Centerを使用してアクティブな接続を管理できます。この機能は、ユーザーと管理者が遅い接続や問題のある接続のトラブルシューティングを行うことを可能にする、便利な生産性向上ツールです。Connection Centerを使用すると、ユーザーは次の方法で接続を管理できます。

アプリケーションを閉じる
セッションからログオフする。この手順により、セッションが終了し、開いているすべてのアプリケーションが閉じられます。
セッションから切断する。この手順により、開いているアプリケーションを閉じずに、選択したサーバーへの接続が切断されます（サーバーが切断時にアプリケーションを閉じるように構成されている場合を除く）。
接続トランスポート統計を表示する

ログ収集

以前のバージョンでは、debug.iniおよびmodule.iniファイルがログの構成に使用されていました。

バージョン2009以降、次のいずれかの方法を使用してログ収集を構成できます。

コマンドラインインターフェイス
GUI

Version 2009以降、debug.ini 設定ファイルはCitrix Workspaceアプリのインストーラーパッケージから削除されています。

ログは、Citrix Workspaceアプリの展開の詳細、構成の変更、および管理アクティビティをログ収集データベースにキャプチャします。サードパーティの開発者は、Citrix WorkspaceアプリPlatform Optimization SDKの一部としてバンドルされているログ収集SDKを使用して、このログ収集メカニズムを適用できます。

ログ情報は、次の目的で使用できます。

変更後に発生する問題を診断し、トラブルシューティングする。ログは追跡記録を提供します。
変更管理を支援し、構成を追跡する。
管理アクティビティを報告する。

Citrix Workspaceアプリがrootユーザー権限でインストールされている場合、ログは/var/log/citrix/ICAClient.logに保存されます。それ以外の場合、ログは${HOME}/.ICAClient/logs/ICAClient.logに保存されます。

Citrix Workspaceアプリがインストールされると、ログ機能を処理するためにcitrixlogというユーザーが作成されます。

コマンドラインインターフェイス

コマンドプロンプトで、/opt/Citrix/ICAClient/utilパスに移動します。
ログ設定を行うには、次のコマンドを実行します。

./setlog help

利用可能なすべてのコマンドが表示されます。

次の表に、さまざまなモジュールとその対応するトレースクラス値を示します。特定のコマンドラインログ値セットには、次の表を使用してください。

モジュール	ログクラス
Assertions	LOG_ASSERT
Audio Monitor	TC_CM
BCR with CEF	TC_CEFBCR
Client Audio Mapping	TC_CAM
Connection Center	TC_CONNCENTER
Client Communication Port	TC_CCM
Client Drive Mapping	TC_CDM
Clip	TC_CLIP
Client Printer Mapping	TC_CPM
Client Printer Mapping	TC_CPM
Font	TC_FONT
Frame	TC_FRAME
Graphics Abstraction	TC_GA
Input Method Editor	TC_IME
IPC	TC_IPC
Keyboard Mapping	TC_KEY
Licensing Driver	TC_VDLIC
Multimedia	TC_MMVD`
Mouse Mapping	TC_MOU
MS Teams	TC_MTOP
Other Libraries	TC_LIB
Protocol Driver	TC_PD
PNA Store	TC_PN
Standard Event Logs	LOG_CLASS
SRCC	TC_SRCC
SSPI Login	TC_CSM
Smart Card	TC_SCARDVD
Selfservice	TC_SS
Selfservice Extension	TC_SSEXT
StorefrontLib	TC_STF
Transport Driver	TC_TD
Thinwire	TC_TW
Transparent Window Interface	TC_TUI
Virtual Channel	TC_VD
PAL	TC_VP
UI	TC_UI
`UIDialogLibWebKit3`	TC_UIDW3
`UIDialogLibWebKit3_ext	TC_UIDW3E
USB Daemon	TC_CTXUSB
Video Frame Driver	TC_VFM
Web kit	TC_WEBKIT
WinStation Driver	TC_WD
`Wfica`	TC_NCS
`Wfica` Engine	TC_WENG
`Wfica` Shell	TC_WFSHELL
Web helper	TC_WH
Zero Latency	TC_ZLC

GUI

メニュー > 環境設定に移動します。Citrix Workspace - 環境設定ダイアログが表示されます。 Preferences dialog

トレースの詳細レベルを上げるには、次の値が利用可能です。

無効
エラーのみ
標準
詳細

デフォルトでは、ログ記録オプションはエラーのみに設定されています。

生成されるデータ量が多いため、トレースはCitrix Workspaceアプリのパフォーマンスに大きな影響を与える可能性があります。詳細レベルは、トラブルシューティングに必要な場合にのみ推奨されます。

目的のログ収集レベルを選択した後、保存して閉じるをクリックします。変更はセッションに動的に適用されます。

ログ記録オプションのドロップダウンメニューの横にある設定アイコンをクリックします。Citrixログ環境設定ダイアログが表示されます。 Log Preferences dialog

注：

ICAClient.logファイルを削除した場合、ログ収集サービスctxcwalogdを再起動する必要があります。

たとえば、systemd-capableセットアップを使用している場合は、次のコマンドを実行します。

systemctl restart ctxcwalogd。

Version 2006以前でのログ収集の有効化：

Version 2006以前を使用している場合は、次の手順でログ収集を有効にします。

LinuxマシンにCitrix Workspaceアプリをダウンロードしてインストールします。
ICAROOT環境変数をインストール場所に設定します。

例：/opt/Citrix/ICAClient。

デフォルトでは、すべてのトレースを提供するためにTC_ALLトレースクラスが有効になっています。
特定のモジュールのログを収集するには、$ICAROOTにあるdebug.iniファイルを開き、必要なトレースパラメーターを[wfica]セクションに追加します。

トレースクラスは「+」記号を付けて追加します。例：+TC_LIB。

パイプ記号で区切って異なるクラスを追加できます。例：+TC_LIB|+TC_MMVD。

次の表に、wficaモジュールとその対応するトレースクラス値を示します。

モジュール	TraceClasses値
Graphics	TC_TW
EUEM	TC_EUEM
`WFICA` (Session Launch)	TC_NCS
Printing	TC_CPM
Connection Sequence - WD	TC_WD
Connection Sequence - PD	TC_PD
Connection Sequence - TD	TC_TD
Proxy related files	TC_PROXY
Multimedia Virtual Driver / Webcam	TC_MMVD
Virtual Drivers	TC_VD
Client Drive Mapping	TC_CDM
Audio	TC_CAM
COM (Communication Port)	TC_CCM
Seamless	TC_TWI
Smart Card	TC_SCARDVD

次の表に、接続センターモジュールとその対応するトレースクラス値を示します。

モジュール	TraceClasses値
Connection center	TC_CSM

次の表に、setWebHelperのトレースクラス値を示します。

TraceClasses値
Set logSwitch to 1 (to enable) or 0 (to disable)
Example: logSwitch = 1

トラブルシューティング：

ctxcwalogdが応答しなくなった場合、ログはsyslogにトレースされます。

後続の起動で新規および更新されたログを取得する方法については、「Syslog構成」を参照してください。

Syslog構成

デフォルトでは、すべてのsyslogログは/var/log/syslogに保存されます。ログファイルのパスと名前を構成するには、/etc/rsyslog.confファイルの[RULES]セクションの下にある次の行を編集します。例：

user.* -/var/log/logfile_name.log

変更を保存し、次のコマンドを使用してsyslogサービスを再起動します。

sudo service rsyslog restart

注意点：

新しいsyslogが利用可能であることを確認するには、syslogを削除し、コマンドsudo service rsyslog restartを実行します。
重複メッセージを回避するには、rsyslog.conf ファイルの先頭に $RepeatedMsgReduction on を追加します。
ログを受信するには、rsyslog.conf ファイルの先頭で $ModLoad imuxsock.so の行がコメント解除されていることを確認します。

リモートログ収集

リモートログ収集を有効にするには：

サーバー側の設定: syslogサーバーの rsyslog.conf ファイルで、以下の行のコメントを解除します。

$ModLoad imtcp

$InputTCPServerRun 10514
クライアント側の設定: rsyslog.conf ファイルで、localhost をリモートサーバーの IP アドレスに置き換えて、以下の行を追加します。

*.* @@localhost:10514

ログファイルの収集

以前は、Citrix Workspaceアプリでログファイルを収集するためのツールはありませんでした。ログファイルは異なるフォルダーに存在しており、異なるフォルダーから手動でログファイルを収集する必要がありました。

バージョン2109以降、Citrix Workspaceアプリは、異なるフォルダーからログファイルを収集するためのcollectlog.pyツールを導入しました。このツールはコマンドラインを使用して実行できます。ログファイルは圧縮ログファイルとして生成されます。ローカルサーバーからダウンロードできます。

前提条件

Python 3
ログを保存するための追加のスペースが必要です

バージョン2109以降、collectlog.pyツールを使用してログファイルを収集するために、2つの新しいファイルが追加されました。

logcollector.ini ファイル – ログファイルの名前とパスを保存します。
collectlog.py ファイル – ログファイルを収集し、cwalog_{timestamp}.tar.gz という圧縮ファイルとして保存します。

デフォルトでは、Microsoft Teams のログファイルを収集するために、logcollector.ini ファイルに [hdxteams] コンポーネントが追加されています。ただし、以下の手順を使用して、他のコンポーネントも logcollector.ini ファイルに追加できます。

${HOME}/.ICAClient/logs/ICAClient.log/logcollector.ini ファイルに移動します。
以下の例に従って、ログファイルを収集するために必要なコンポーネントを追加します。

[component_name]

log_name1 = “log_path1”

log_name2 = “log_path2”

バージョン2109を使用している場合は、以下の手順でログファイルを収集します。

LinuxマシンにCitrix Workspaceアプリをダウンロードしてインストールします。
コマンドラインで、/opt/Citrix/ICAClient/util パスに移動します。
以下のコマンドを実行します。 ./collctlog.py -h

以下のコマンド使用情報が表示されます。

usage: collect_log [-h] [-c CONFIG] [-a ARCHIVE]optional arguments: -h, --help show this help message and exit -c CONFIG, --config CONFIG The logcollector.ini path & file -a ARCHIVE, --archive ARCHIVE The archive path & file
必要に応じて、以下のコマンドを実行します。
- ./collectlog.py – デフォルトパスの構成ファイルを使用してログファイルを収集し、デフォルトパスに圧縮ログファイルとして保存します。
- ./collectlog.py -c /user_specified_path/logcollector.ini – ユーザー指定パスの構成ファイルを使用してログファイルを収集し、デフォルトパスに圧縮ログファイルとして保存します。
- ./collectlog.py -c /user_specified_path/logcollector.ini -a/another_user_specified_path/ – ユーザー指定パスの構成ファイルを使用してログファイルを収集し、ユーザー定義パスに圧縮ログファイルとして保存します。
注:

logcollector.ini 構成ファイルのデフォルトパスは /opt/Citrix/ICAClient/config/logcollector.ini です。圧縮ログファイルのデフォルトパスは /tmp です。
/tmp フォルダーに移動し、cwalog_{timestamp }.tar.gz 圧縮ファイルを収集します。

注:

ログファイルは、/tmp フォルダーに cwalog_{timestamp}.tar.gz というファイル名で保存されます。

ログ収集の機能強化

Citrix Workspaceアプリバージョン2309以降、以下の機能強化が利用可能です。

Citrixログ収集ユーティリティ

Citrixログ収集ユーティリティは、新規および既存のログの両方を収集するのに役立ちます。このユーティリティは、特に詳細ログを収集し、すべてのログをtar.gzファイルに保存します。

Citrixログ収集ユーティリティは、以下のいずれかの方法で開くことができます。

アカウントの追加画面に移動します。
ハンバーガーメニューをクリックします。
ログの収集を選択します。

または、

アプリインジケーターアイコンで、トラブルシューティング > ログの収集をクリックします。

App indicator

または、

コマンドラインで、/opt/Citrix/ICAClient/util パスに移動します。
以下のコマンドを実行します: ./logmgr

Citrixログ収集ユーティリティ画面が表示されます。

Citrix log collection utility

新規ログの収集

Citrix Log Collection Utility に移動し、ログの収集を開始 をクリックします。次の画面が表示されます。
問題のシナリオを再現します。
問題が再現されたら、ログの収集を停止 をクリックします。次の画面が表示されます。
ログの保存 をクリックしてログを保存します。ログを保存するためのファイルエクスプローラーウィンドウが開きます。
保存をクリックします。ログファイルが保存されます。次の画面が表示されます。
保存されたログの表示 をクリックして、保存されたログを表示します。保存されたログファイルが次の画面に表示されます。

注:

2回目に ログの収集を開始 をクリックすると、既存のログを上書きするための警告メッセージが表示されます。

既存のログの収集

Citrix Log Collection Utility を開きます。
既存のログの収集 をクリックして、以前の発生から問題をキャプチャした可能性のあるログを収集します。既存のログを保存するためのファイルエクスプローラーウィンドウが開きます。
保存をクリックして、既存のログを別のフォルダーに保存します。そこから後でログファイルにアクセスできます。次の画面が表示されます。
保存されたログの表示 をクリックしてログを表示します。

ユーザーアクティビティログの収集

バージョン 2311 以降、ユーザーアクティビティログを収集できます。ほとんどの Storebrowse コマンドに関連するアクティビティはログファイルに保存されます。ログファイルは次の場所にあります。

${HOME}/.ICAClient/logs/userActivitylog/

デフォルトでは、ユーザーアクティビティログは有効になっています。無効にするには、Authmanconfig.xml ファイルに次のキーを追加します。

<key>UserActivityLogsDisabled</key>
<value>true</value>
<!--NeedCopy-->

DSログの収集の無効化

DSログはすべてのログを収集します。dslogs が不要な場合は、Authmanconfig.xml ファイルに次のキーを追加することで無効にできます。

<key>DsLogsDisabled</key>
<value>true</value>
<!--NeedCopy-->

ブラウザコンテンツリダイレクトの拡張システムログ

バージョン 2405 以降、ブラウザコンテンツリダイレクトでは、システムログの機能強化の一環として、管理者が機能ステータスを監視できるようになりました。詳細については、「ブラウザコンテンツリダイレクト」を参照してください。

拡張ログサポート

バージョン 2601 以降、Citrix Workspace app for Linux には、診断を容易にするために拡張ログを有効にする構成オプションが追加されました。

拡張ログを有効にするには:

/opt/Citrix/ICAClient/config/AuthManConfig.xml にある AuthManConfig.xml ファイルを編集します。
ExtendedLoggingEnabled を true に設定します。

例:

<!-- ExtendedLoggingEnabled - true, false (Collects verbose, service record, and dslogs) -->
<key>ExtendedLoggingEnabled</key>
<value>false</value>

<!-- To enable extended logging -->
<key>ExtendedLoggingEnabled</key>
<value>true</value>
<!--NeedCopy-->

有効にすると、Citrix Workspace app for Linux の ServiceRecord および dslogs の拡張ログが収集されます。

この製品ドキュメントの正式なバージョンは英語版です。英語以外のすべてのバージョンは、お客様の利便性のためにのみ提供され、機械翻訳された内容が含まれている場合があります。詳しくは、Cloud Software Group home で機械翻訳に関する免責事項（Machine Translation Disclaimer）をご覧ください。

この情報は役に立ちましたか?

トラブルシューティング

April 13, 2026

寄稿者:

C C

April 13, 2026

寄稿者:

C C

この情報は役に立ちましたか?

トラブルシューティング

接続

公開リソースまたはデスクトップセッション

セッションの再接続

完全なインターネット名

低速セッション

Citrix Workspaceアプリのフィードバック送信

暗号スイート

不適切な Citrix Optimization SDK

SSL 接続用の脆弱な暗号スイート

接続の損失

接続エラー

低帯域幅接続

ディスプレイ

画面のティアリング

X11 GPU設定

コンポジションマネージャー

キー入力の誤り

過剰な再描画

アイコンの互換性

完全なアイコン互換性

カーソル色

色のちらつき

TrueColorディスプレイでの色の変化

不正確な表示

セッションのスパン

ローカルアプリケーション

エラーメッセージの改善

Webカメラ

デフォルトのWebカメラの更新

テスト機能

プロダクションおよびデバッグモード

ウェブカメラテスターモード

エンコーダーテスターモード

H264 ソフトウェアエンコーダー

H264 ハードウェアエンコーダー

内部 GStreamer フレームワークと gst_read ログの収集

GStreamer パイプラインの検査

RAVE 用システム診断スクリプト

汎用USBリダイレクト

Androidフォンを汎用USBとしてリダイレクトする方法

ブラウザー

ローカルブラウザー

公開リソースへのアクセス

特定のブラウザー

Firefox ブラウザー

Firefox の ICA プラグイン

構成エラー

wfclient.ini 構成エラー

ブラウザーコンテンツリダイレクト

自己署名証明書を nssdb にインポートする方法

その他

接続の問題

セッションの終了

設定ファイルの設定

公開アプリケーション

Citrix Workspaceアプリの起動

Citrix CryptoKit（旧SSLSDK）

キーボードショートカット

リモートのクロアチア語キーボード

日本語キーボード

ABNT2キーボード

ローカルキーボード

Windows Media Player

Windows Media Playerリダイレクトのシステム要件検証スクリプト

シリアルポート設定

エラー

診断情報

リソースへの接続のトラブルシューティング

ログ収集

コマンドラインインターフェイス

GUI

Syslog構成

リモートログ収集

ログファイルの収集

ログ収集の機能強化

Citrixログ収集ユーティリティ

新規ログの収集

既存のログの収集

ユーザーアクティビティログの収集

内部 `GStreamer` フレームワークと `gst_read` ログの収集

`GStreamer` パイプラインの検査