トラブルシューティング

ここでは、管理者によるLinux向けCitrix Workspaceアプリのトラブルシューティングに役立つ情報について説明します。

接続

以下の接続関連の問題が確認されています。

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

Windowsサーバーへの接続を確立している時に、ダイアログボックスに「サーバーxxxに接続しています」というメッセージが表示されて接続画面が開かない場合は、サーバーのクライアントアクセスライセンス（CAL）の構成を確認する必要があります。ライセンスについて詳しくは、「ライセンス」を参照してください。

セッション再接続

Citrix Workspaceアプリからの要求よりも多いウィンドウの色数でセッションを再接続しようとすると、接続に失敗する場合があります。これは、サーバーのメモリ不足が原因です。再接続に失敗した場合、Citrix Workspaceアプリはセッションで元の色数を使おうとします。再接続した場合は、サーバーは新しいセッションを要求した色数で開始しようとし、元のセッションは切断されたままになります。ただし、サーバーのメモリが依然不足している場合は2つ目のセッションも失敗する可能性があります。

完全なインターネット名

ネットワークでDNS（ドメインネームシステム）を構成すると、接続するサーバー名を解決できるようになります。構成されたDNSがない場合は、サーバー名をIPアドレスに解決することができません。また、サーバーを名前ではなくIPアドレスで指定することもできます。TLS接続には、IPアドレスではなく、完全修飾ドメイン名が必要です。

プロキシ検出の失敗

接続が自動プロキシ検出を使用するように構成されていて、接続時に「プロキシを検出できません。JavaScriptエラーです。」というエラーメッセージが表示される場合は、$ICAROOT/util内にwpad.datファイルをコピーします。次のコマンドを実行します。ここで、hostnameは接続するサーバーのホスト名です。

cat wpad.dat | ./pacexec pac.js FindProxyForURL http://hostname hostname 2>&1 | grep “undeclared variable”

コマンドを実行しても出力がない場合は、サーバーのwpad.datファイルに調査が必要な深刻な問題があります。ただし、“assignment to undeclared variable …”のような出力がある場合は問題を解決できます。pac.jsを開き、出力内に表示されている各変数について、ファイルの最初に次の形式の行を追加します。ここで、“…”は変数名です。

var ...;

セッション開始の遅延

マウスを動かすまでセッションが開始されないことがあります。Linuxカーネルでの乱数生成に問題があると、この問題が発生します。この問題を回避するには、run an entropy-generating daemon such as rngd（ハードウェアベース）またはhaveged（Magic Software）などのエントロピー生成デーモンを実行してください。

暗号の組み合わせ

新しい暗号のサポートで接続が失敗した場合は、次の手順を実行します：

1. 以下のようなさまざまなツールを使用して、サーバーがサポートする暗号の組み合わせを確認できます：
   • Ssllab.com（サーバーがインターネットにアクセスできるようにする必要があります）
   • sslyze（https://github.com/nabla-c0d3/sslyze）
2. Linuxクライアントで、WireSharkがパケット（Client Hello、Server Hello）を検出し、フィルター（ip.addr == VDAIPAddress）を使用してSSLセクションを検出します。結果には、クライアントによって送信され、サーバーによって受け入れられた暗号の組み合わせが表示されます。

SSL接続の暗号の組み合わせが弱い

TLS接続を確立すると、Linux向け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

接続の切断

UDTプロトコルを使用すると、次のエラーメッセージが表示されることがあります：”…”への接続が失われましたこの問題は、UDTの最大転送単位がデフォルトの1,500バイトより小さいルーター経由の接続が原因で発生することがあります。以下の両方を試してください：

• $ICAROOT/config/All_Regions.iniおよび$HOME/.ICAClient/All_Regions.iniでudtMSSエントリのコメントアウトを解除します
• 構成ファイルでudtMSS=1000を設定します

接続エラー

接続エラーでは、さまざまな異なるエラーダイアログが表示されます。以下はその例です。

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

こうしたエラーの原因は、以下のようにさまざまです：

• ローカルコンピューターとリモートコンピューターが共通のTLSプロトコルをネゴシエートできないとき。詳しくは、「TLS」を参照してください。
• リモートコンピューターのTLS接続に古い暗号の組み合わせが必要な場合。この場合、接続の再開前に、構成ファイルの[WFClient]セクションで構成オプションをSSLCiphers=ALLに設定し、killall AuthManagerDaemon ServiceRecord selfservice storebrowseを実行します。
• リモートコンピューターが不適切にクライアント証明書を要求する場合。IISはCitrix/Authentication/Certificateの証明書のみを「許可」または「要求」する必要があります。
• そのほかの問題。

狭帯域幅接続

サーバー上ではCitrix Virtual AppsまたはCitrix Virtual Desktops、ユーザーデバイスではCitrix Workspaceアプリのそれぞれ最新バージョンを使用することを推奨します。

帯域幅の狭い接続を使用する場合は、Citrix Workspaceアプリの構成や使い方を変えてパフォーマンスを向上させることができます。

• Citrix Workspaceアプリの接続構成 - Citrix Workspaceアプリの接続構成を変更することで、ICAで消費される帯域幅を減らしてパフォーマンスを改善できます。
• Citrix Workspaceアプリの使用方法 - Citrix Workspaceアプリの使用方法を変更することで、高いパフォーマンスが求められる接続での消費帯域幅を抑えることができます。
• UDPオーディオの有効化 - この機能を有効にすると、ネットワークトラフィック負荷の高いVoIP（Voice over IP）接続での遅延レベルが安定します。
• 最新バージョンのCitrix Virtual AppsおよびLinux向けCitrix Workspaceアプリの使用 - シトリックス製品では、パフォーマンスを向上して機能を拡張するためのバージョンアップが常に行われています。また、多くのパフォーマンス機能を使用するには、最新のCitrix Workspaceアプリおよびサーバーソフトウェアが必要である場合もあります。

表示

スクリーンティアリング

スクリーンティアリングは、横ブロックに画面上で複数の異なるフレームが同時に積み重なって表示される時に発生します。画面上のコンテンツを迅速に大幅に変更するとよく見られる現象です。データはティアリングを避ける方法でVDAでキャプチャされ、ティアリングを起こさない方法でクライアントに渡されますが、X11（Linux/Unixグラフィックスサブシステム）によって、ティアリングを防ぐ方法で画面に描画する一貫した方法が提供されません。

スクリーンティアリングを防ぐには、アプリケーションの描画と画面の描画を同期化する標準的なアプローチをお勧めします。つまり、vsvncによる次のフレームの描画開始を待機します。Linuxを使用する場合、クライアントに搭載されているグラフィックスハードウェアおよび使用するウィンドウマネージャーに応じて、多くの選択肢があります。これらの選択肢は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グラフィックスについては、お使いの構成に対応する”MetaModes”オプションを含む、xorg.conf.dフォルダーでファイルを見つけます。コンマ区切りの使用される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 Settings Managerをインストールします。

  CompizConfig Settings Managerを実行します。

  “General->Composition”で”Undirect Fullscreen Windows”をチェック解除します。

注：

CompizConfig Settings Managerは注意して使用してください。誤って値を変更するとシステムが起動しなくなる可能性があります。

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

  compton --vsync opengl --vsync -aggressive

不正なキーストローク

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

過剰な再描画

ウィンドウマネージャーの種類によっては、シームレスウィンドウを移動すると新しいウィンドウ位置が常にサーバーにレポートされるため、再描画が過度に発生することがあります。ウィンドウを移動した時にウィンドウ枠のみを描画するモードに切り替えると、この問題は解決します。

アイコンの互換性

Linux向けCitrix Workspaceアプリは、ほとんどのウィンドウマネージャーと連携するウィンドウアイコンを作成しますが、ICCCM（Inter-Client Communication Convention Manual：クライアント間通信規約マニュアル）に準拠していません。

アイコンの完全な互換性

ICCCMに完全に準拠するには：

1. 構成ファイルwfclient.iniを開きます。
2. [WFClient]セクションで次のように行を編集します：UseIconWindow=True
3. ファイルを保存して閉じます。

カーソルの色

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

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

1. 構成ファイルwfclient.iniを開きます。

2. 次のいずれかの行を[WFClient]セクションに追加します：

   CursorStipple=ffff,ffff （カーソルを黒で表示）

   CursorStipple=0,0 （カーソルを白で表示）

3. ファイルを保存して閉じます。

色のちらつき

接続ウィンドウの内/外にマウスを移動させると、フォーカスのないウィンドウの色がちらつくことがあります。これは、PseudoColor表示でX Windows Systemを使用する場合の制限事項として知られています。可能な場合、問題のある接続ではより色数の多いウィンドウを使用してください。

TrueColor表示での色の変更

サーバーに接続する時、ウィンドウの色数として256色を選択できます。256色を選択する場合は、ビデオカードがパレットをサポートしていて、アプリケーションでパレットの色を変更し、アニメーション表示が可能であることが前提になります。

True Color表示では、パレットを高速変更してアニメーションを生成する機能はエミュレートできません。ソフトウェアでのこの機能のエミュレーションは相対的に時間がかかり、多くのネットワークトラフィックが費やされます。この問題を解決するために、Citrix Workspaceアプリは高速パレット変更をバッファに格納し、数秒ごとに実際のパレットを更新するように設定されています。

不正確な表示

Citrix Workspaceアプリでは、日本語文字にEUC-JPまたはUTF-8文字エンコードが使用されます。一方、サーバー側ではShift-JIS文字エンコードが使用されます。Citrix Workspaceアプリでは、これらの文字セット間でのエンコーディングが実行されません。このため、ファイルに日本語の名前を使用し、クライアントドライブマッピングを使用してローカルコンピューターにそのファイルを保存する場合、ローカルコンピューターではその日本語ファイル名が正しく表示されません。逆に、ローカルで日本語名のファイルを作成し、クライアントドライブマッピングを使用してサーバーに保存した場合、サーバー上でこのファイル名を正しく表示できません。この問題は、拡張パラメーターパス機能で使用されるパラメーターの日本語でも発生します。

セッションの表示モニター

全画面モードのセッションは、すべてのモニターの表示領域全体に表示されます。また、コマンドラインオプションとして-spanを使用することもできます。これにより全画面セッションを複数モニターにまたがって表示できます。

デスクトップビューアーツールバーの機能によって、モニターを横断したマルチモニターサポートなど、ウィンドウモードと全画面モードのセッションの切り替えることができます。

重要：

-spanは、シームレスセッションや標準のウィンドウセッション、またそれらが混在するセッションには適用されません。

-spanオプションは、以下のように指定します： -span [h][o][a|mon1[,mon2[,mon3,mon4]]]

hを指定すると、モニターの一覧がstdoutに出力されます。また、この値のみを指定した場合、モニター一覧の出力後にwficaが終了します。

oを指定すると、セッションウィンドウのリダイレクト属性がoverride-redirectになります。

注意：

この値の使用は推奨されません。これは、非協調性のウィンドウマネージャーで使用するための最後の手段です。セッションウィンドウはウィンドウマネージャーで非表示となり、アイコンもなく、再スタックできません。セッションを終了することによってのみウィンドウを削除できます。

aを指定すると、すべてのモニターを使用してセッションが表示されます。

-spanオプションの残りの値は、使用するモニターの番号として処理されます。特定のモニターを使用する場合は単一の値（<mon1>）を指定します。また、表示領域の左上と右下のモニターを指定（<mon1>,<mon2>）したり、上端、下端、左端、および右端のモニターを指定（<mon1>,<mon2>,<mon3>,<mon4>）したりできます。

wficaコマンドでは、（oを指定しない場合）_NET_FULLSCREEN_MONITORSメッセージによりウィンドウマネージャーから適切なウィンドウレイアウトが取得されます（サポートされる場合）。それ以外の場合は、サイズおよび位置に関するヒントを使用して必要なレイアウトを要求します。

ウィンドウマネージャーがこのクライアントメッセージをサポートするかどうかを確認するには、次のコマンドを実行します： xprop -root | grep \_NET\_WM\_FULLSCREEN\_MONITORS

出力がない場合、サポートされません。サポートされないウィンドウマネージャーでは、ウィンドウリダイレクトの上書き（override-redirect）が必要な場合があります。-span oを使って、override-redirectウィンドウをセットアップできます。

コマンドラインからセッションを複数のモニターにまたがって実行するには：

1. コマンドプロンプトで、次のコマンドを実行します：

   /opt/Citrix/ICAClient/wfica -span h

   ユーザーデバイスに現在接続しているモニターの番号の一覧がstdoutに出力され、wficaが終了します。

2. これらのモニターの番号をメモしておきます。

3. コマンドプロンプトで、次のコマンドを実行します：

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

   ここでw、x、y、およびzは、手順1でメモしたモニターの番号です。特定のモニターを使用する場合は単一の値（w）を指定します。また、表示領域の左上と右下のモニターを指定（w,x）したり、上端、下端、左端、および右端のモニターを指定（w,x,y,z）したりできます。

   重要：

   self-serviceを起動したりWebブラウザーでWeb interfaceに接続したりする前に、WFICA_OPTS変数を定義します。これを行うには、プロファイルファイル（通常は、$HOME/.bash_profileまたは$HOME/.profile）を編集して、WFICA_OPTS変数を定義する行を追加します。次に例を示します：

   export WFICA_OPTS="-span a"

   この変更は、Citrix Virtual Apps and Desktopsの両方のセッションに影響を及ぼします。

   self-serviceまたはstorebrowseを開始している場合は、新しい環境変数を適用するために開始したプロセスを削除します。次のコマンドで削除します：

   killall AuthManagerDaemon ServiceRecord storebrowse

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

全画面セッションからローカルアプリケーションまたはほかのセッションに切り替えることができなないことがあります。これは、クライアント側のシステムUIが非表示になっていて、キーボード透過機能が通常のキーボードコマンドを無効にするためです。たとえば、Alt+Tabは通常とは違い、サーバーにコマンドを送信します。

この問題を回避するには、フォーカスがセッションウィンドウに移るまでCtrl+F2キーを押してキーボード透過機能を一時的にオフにします。また代替策として、$ICAROOT/config/module.iniでTransparentKeyPassthroughをNoに設定します。これにより、キーボード透過機能が無効になります。ただし、All_regions.iniファイルにこの設定を追加してICAファイルを上書きすることが必要な場合があります。

ブラウザー

ローカルブラウザー

Windowsセッション内のリンクをクリックすると、コンテンツがクライアントコンピューターのWebブラウザーで表示されます。サーバーからクライアントへのコンテンツリダイレクトは、wfclient.iniで有効になっています。このため、ローカルのアプリケーションが実行されます。サーバーからクライアントへのコンテンツリダイレクト機能を無効にする方法については、「サーバーからクライアントへのコンテンツリダイレクト」を参照してください。

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

公開リソースにアクセスする場合、Webブラウザーにファイルの保存ダイアログボックスが表示されます。FirefoxやChrome以外のWebブラウザーでは、公開リソースに接続するための設定が必要な場合があります。Web Interfaceを介して接続する場合、リソースの一覧が表示されたWeb Interfaceのページにアクセスできる場合があります。公開されているリソースの一覧からアイコンをクリックしてリソースにアクセスしようとすると、ICAファイルの保存を確認するメッセージが表示されることがあります。

別のブラウザーの構成

Web Interfaceで別のブラウザーを構成するには：Webブラウザーにより詳細は異なりますが、WebブラウザーのMIMEタイプをセットアップして、MIMEタイプapplication/x-icaまたはICAファイルが$ICAROOT/wficaにより実行されるように設定します。

特定のブラウザー

特定のWebブラウザーで問題が生じる場合、setupwfcを実行する前に環境変数BROWSERを設定して必要なWebブラウザーのローカルパスや名前を指定してください。

Firefoxブラウザー

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

FirefoxのICAプラグイン

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

構成エラー

このエラーは、接続エントリが適切に構成されていない場合に発生します。

E_MISSING_INI_SECTION - 構成ファイルを検証してください：”…” 構成ファイルでセクション”…“が見つかりません。

構成ファイルが直接編集されたか、壊れています。

E_MISSING_INI_ENTRY - 構成ファイルを検証してください：”…” セクション”…“にはエントリ”…“が含まれている必要があります。

構成ファイルが直接編集されたか、壊れています。

E_INI_VENDOR_RANGE - 構成ファイルを検証してください：”…” 構成ファイルのXサーバーベンダーの範囲”…“が無効です。

構成ファイル内のXサーバーのベンダー情報が壊れています。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ファイルを使用できません。［ビュー］メニューの［アプリケーションの更新］を選択して公開リソースの一覧を更新し、もう一度リソースにアクセスしてみてください。問題が解決されない場合は、デスクトップアイコンまたはメニューのプロパティ、およびアイコンまたはメニューが参照しているCitrix Virtual Appsファイルのプロパティを確認します。

PACファイルエラー

プロキシ自動検出スクリプトファイル（PACファイル）を使用してプロキシ構成を指定する場合、以下のエラーが発生することがあります。

プロキシ検出に失敗しました。不適切な自動構成URLです。

ブラウザーで指定したアドレスのURLのタイプが無効です。有効なタイプは「http://」および「https://」で、ほかのタイプはサポートされていません。アドレスを有効なURLタイプに変更してもう一度試してください。

プロキシを検出できません。.PACスクリプトHTTPダウンロードに失敗しました。接続できません。

入力した名前またはアドレスが間違っていないかチェックします。間違いがある場合は、それを修正してもう一度入力します。間違いがない場合は、サーバーがダウンしています。しばらくしてから、もう一度試してください。

プロキシ検出に失敗しました。.PACスクリプトのHTTPダウンロードができません。パスが見つかりません。

必要なPACファイルがサーバーにありません。サーバー上でこれを変更するか、ブラウザーを再構成してください。

プロキシ検出に失敗しました。.PACスクリプトをHTTPでダウンロードできません。

PACファイルのダウンロード中に接続が切断しました。再接続してもう一度実行します。

プロキシ検出に失敗しました。自動構成スクリプトが空です。

PACファイルが空です。サーバー上でこれを変更するか、ブラウザーを再構成してください。

プロキシ検出に失敗しました。JavaScriptがサポートされていません。

PAC実行ファイルまたはpac.jsテキストファイルがありません。Citrix Workspaceアプリを再インストールしてください。

プロキシ検出に失敗しました。JavaScriptエラーです。

PACファイルに含まれているJavaScriptが無効です。サーバーでPACファイルを修正してください。また、「接続」も参照してください。

プロキシ検出に失敗しました。プロキシ自動構成スクリプトから不適切な結果が戻されました。

サーバーから不正な形式の応答を受信しました。サーバー上でこれを修正するか、ブラウザーを再構成してください。

証明書

ストアをSAML認証（AUTHv3プロトコルを使用）で使用すると、次のエラーメッセージが表示されます：「Unacceptable TLS Certificate。」

この問題は、Linux向けCitrix Workspaceアプリ1906以降を使用する場合に発生します。トラブルシューティングの手順については、Knowledge CenterのCTX260336を参照してください。

その他

接続の問題

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

セッションを閉じる

サーバーがCitrix Workspaceアプリにセッションを閉じる指示をしたかどうかを確認する場合、wficaプログラムを使って、セッションを中断するコマンドをサーバーからいつ受信したのかのログを記録できます。

Syslogシステムを介してこの情報を記録するには、値を6に設定したSyslogThresholdを構成ファイルの[WFClient]セクションに追加します。これにより、LOG_INFO以上の優先度のメッセージのログが記録されます。SyslogThresholdのデフォルト値は4（LOG_WARNING）です。

同様に、wficaが情報を標準のエラーに送信するようにするには、値を6に設定したPrintLogThresholdを[WFClient]セクションに追加します。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アプリをインストールした場合は、環境変数ICAROOTを定義する必要があります。この問題を解決するには、次のいずれかを実行してください。

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

  ICAROOT環境変数が正しく定義されているかをチェックするには、Citrix Workspaceアプリをターミナルセッションから起動します。エラーメッセージが表示される場合は、ICAROOT環境変数が正しく定義されていません。

• Citrix Workspaceアプリをデフォルトの場所に再インストールします。Citrix Workspaceアプリのインストール方法については、「インストールとセットアップ」を参照してください。

  以前デフォルトの場所にCitrix Workspaceアプリをインストールしていた場合は、再インストールする前に/opt/Citrix/ICAClientまたは$HOME/ICAClient/プラットフォームディレクトリを削除する必要があります。

Citrix CryptoKit（SSLSDKの新名称）

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

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

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

ウィンドウマネージャーで同じキーボードショートカットが定義されている場合、セッションでのキーボードショートカットが正しく機能しない場合があります。たとえば、KDEウィンドウマネージャーでデスクトップ13～16に切り替えるためのキーの組み合わせである、Ctrl+Shift+F1～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文字が正しく送信されるようにするには、以下の手順に従います。

1. 適切な構成ファイルを開き、[WFClient]セクションのUseEUKSforASCIIでTrueを指定します。
2. UseEUKSで2を指定します。

日本語キーボード

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

KeyboardLayout=Japanese (JIS)

ABNT2キーボード

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

KeyboardLayout=Brazilian (ABNT2)

ローカルキーボード

ローカルキーボードの一部のキーが正常に機能しない場合、$ICAROOT/config/module.iniの一覧で最適なサーバーレイアウトを選択します。

Windows Media Player

要求されたフォーマットを処理するためのGStreamerプラグインがCitrix Workspaceアプリにないことがあります。この場合は通常、サーバーに別のフォーマットが要求されます。まれに、適正プラグインの初期チェックにおいて間違って必要なプラグインが存在すると表示されることがあります。通常、この誤りは検出され、ファイルの再生中Windows Media Playerで問題が起こったことを示すエラーダイアログがサーバーに表示されます。Citrix Workspaceアプリにより件の形式は拒否されるため、セッション内でファイルの再生を再試行すると通常は正常に機能し、その結果、サーバーがほかのフォーマットを要求するか、あるいはメディアそのものをレンダリングします。

まれに、進行状況インディケーターがWindows Media Playerで正常に動作しているにもかかわらず、適正なプラグインがないという事実が検出されずにファイルが正常に再生されないことがあります。

以降のセッションで、このエラーダイアログや再生の失敗を避けるには：

1. たとえば、構成オプション”SpeedScreenMMAVerbose=On”を$Home/.ICAClient/wfclient.iniの[WFClient]セクションに一時的に追加します。

2. ターミナルから開始されたセルフサービスのwficaを再開します。

3. このエラーを生成するビデオを再生します。

4. 見つからないプラグイントレースに関連付けられたMIMEの種類、またはサポート対象であるが再生されないMIMEの種類（”video/x-h264..”など）を（トレースアウトプットなどに）メモします。

5. $ICAROOT/config/MediaStreamingConfig.tblを編集します。メモしたMIMEの種類がある行で、’:’とそのMIMEの種類の間に’?’を挿入します。これによりフォーマットが無効となります。

6. このエラー状態の原因となるそのほかのメディアフォーマットに対して、（上記の）手順2～5を繰り返します。

7. GStreamerプラグインのほかのセットがあるそのほかのマシンに、この変更したMediaStreamingConfig.tblを配信します。

注：

または、MIMEの種類を識別した後、それをデコードするためにGStreamerプラグインをインストールすることができます。

シリアルポート設定

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

LastComPortNum=1

ComPort1=device

複数のシリアルポートを構成するには、$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サーバーのベンダー情報が壊れています。構成ファイルを作成してください。

E_INI_VALUE_SYNTAX - 構成ファイル”…“の値”…“が無効です。

構成ファイル内のXサーバーのベンダー情報が壊れています。構成ファイルを作成してください。

E_SERVER_NAMELOOKUP_FAILURE - サーバー”…“に接続できません。

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

1つまたは複数のファイルに書き込めません：”…“。ディスクの空き容量の問題または権限の問題を解決して、もう一度実行してください。

ディスクの空き容量または権限をチェックします。問題が見つかった場合は、これを修正し、エラーのあった操作をもう一度試してください。

サーバー接続がなくなりました。再接続してもう一度実行します。これらのファイルにはデータがない可能性があります：”…“。

再接続し、エラーのあった操作をもう一度試してください。

診断情報

Citrix Workspaceアプリの実行時に問題が発生した場合、Citrixテクニカルサポートに診断情報の提出を求められる場合があります。この情報は、Citrixテクニカルサポートで問題を調査して修正する目的で使用されます。

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

1. インストール先のディレクトリで、util/lurdumpを実行します。セッションが開かれていて、可能なら問題が発生している間にこれを事項することをお勧めします。

   Citrix Workspaceアプリのバージョン、構成ファイルの内容、およびさまざまなシステム変数値などの詳細な診断情報を含むファイルが作成されます。

2. テクニカルサポートにこのファイルを送信する前に、ファイルに機密情報が含まれていないことを確認してください。

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

ユーザーがアクティブなコネクションを管理するには、コネクションセンターを使用します。セッションの動作が遅い、またはコネクションに問題がある場合、ユーザーや管理者はコネクションセンターを使用してトラブルシューティングを行えます。ユーザーは、コネクションセンターで以下の操作を行えます。

• アプリケーションを終了する。
• セッションからログオフする。これによりセッションが終了し、実行中のアプリケーションが終了します。
• セッションから切断する。これにより、アプリケーションを実行したまま（切断時にアプリケーションを閉じるようにサーバーを構成していない場合）、選択したコネクションのサーバー接続が切断されます。
• コネクションの転送統計値を参照する。