AppDNA

トラブルシューティング

インストールの問題

AppDNAの詳細ログを有効にする方法

:AppDNAのすべての種類のログの詳細については、「CTX219766」を参照してください。

Citrix AppDNAのインストールで問題が発生した場合、以下の手順では、AppDNAサーバー上で詳細なインストールログファイルの収集を有効にする方法を示します。

注意: レジストリを誤って編集すると、深刻な問題が発生し、オペレーティングシステムの再インストールが必要になることがあります。Citrix は、レジストリエディタの誤った使用に起因する問題を解決できることを保証できません。レジストリエディタは、自己の責任において使用してください。レジストリを編集する前に、必ずレジストリをバックアップしてください。

AppDNAサーバーで詳細ログを有効にするには、次の手順を実行します。

  1. [ ファイル名を指定して実行 ] ダイアログボックスを開きます。
  2. regedit 」と入力し、「 OK」 をクリックします。
  3. [ユーザアクセス制御] ダイアログで、[ はい] をクリックします。
  4. レジストリエディターで、キー HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\AppDNA\appTitude\common
    に移動1. レジストリ設定の VerboseLogging (REG_DWORD) を検索または作成し、値を 1 に変更します。

このレジストリ値が設定されていることが検出されると、詳細ログが%temp%AppDNAVerboseLog.logに書き込まれます。

サーバープロセスの場合、これはAppDNAAppPoolがIISで実行されているIDの一時ディレクトリになります。デフォルトでは、これは「アプリケーションプールアイデンティティ” のビルドになり、一時ディレクトリはC:\windows\tempになります。

ログは、クライアントプロセスとサーバープロセスごとに個別にキャプチャされます (同じユーザーとして実行されている場合を除く)。

テキストエディタを使用して、AppDNAVerboseLog.logファイルの内容を読み取ります。

詳細ログを無効にするには、VerboseLogging レジストリ値を 0に変更します。

同様のプロセスに従って、Citrix AppDNAサービス、 QueueProcessorの詳細なログ記録を有効にすることもできます。QueueProcessor サービスの詳細ログを有効にするには、上記の手順 1 ~ 4 を実行します。手順 5 では、レジストリ値 QueueProcessorVerboseLoggingを検索または作成します。メッセージは、次の場所で(ファイルではなく)Windowsイベントログに書き込まれます。

イベントビューア > アプリケーションログとサービスログ > AppDNA > ソース = AppDNAサービス

ログオンの問題

「要求は HTTP ステータス 503 で失敗しました:サービスは利用できません」

このエラーは、AppDNA WebサイトがAppDNAデータベースへの接続に使用するパスワードの有効期限が切れているか、変更されたことを意味します。この問題を修正するには、ホームページを参照してください。

「操作がタイムアウトしました」エラーでログインが失敗する

このエラーは、AppDNAサービスまたはAppDNAが依存する別のサービスが実行されていないために発生することがあります。

IIS サービスをチェックする

  1. IIS マネージャーを開きます。Windows の [スタート] 画面またはメニューで [プログラム] > [アクセサリ] > [ファイル名を指定して実行] を選択し、「inetmgr」と入力して [OK] をクリックします。

  2. IIS サーバーが実行されていることを確認し、実行されていない場合は起動します。

    これを行うには、ウィンドウの右側にある [アクション] パネルの [サーバーの管理] で、[開始] をクリックします。サーバが実行中の場合は、[Start] リンクは無効になります。

  3. IISサーバーが実行されている場合は、AppDNAAppPoolが実行されていることを確認し、実行されていない場合は起動します。

    これを行うには、[IIS マネージャ] ウィンドウの左側にあるツリーを展開し、[アプリケーションプール] をクリックします。中央のパネルで「AppDNAAppPool」をクリックし、右側のパネルで「開始」をクリックします。AppDNAAppPoolが実行されている場合、[開始] リンクは無効になります。

  4. IISサーバーとAppDNAAppPoolが実行されている場合は、AppDNA Webサイトが実行されていることを確認し、実行されていない場合は起動します。

    これを行うには、IISマネージャーウィンドウの左側にあるツリービューで「サイト」ノードを展開し、AppDNA Webサイト(デフォルトではAppDNAと呼ばれます)をクリックします。次に、右側のパネルで [開始] をクリックします。AppDNA Webサイトが実行中の場合は、[開始]リンクは無効になります。

IISサービスを再起動した場合は、AppDNAに再度ログオンしてみてください。それ以外の場合は、SQL Server インスタンスサービスが実行されていることを確認し、必要に応じて次のように起動します。

  1. [Windows サービス] ウィンドウを開きます ([コントロールパネル] > [管理ツール] > [サービス])。
  2. サービスのリストで、AppDNAデータベースに使用するSQL Serverインスタンスを見つけます。
  3. [状態] 列が空白の場合は、[開始] をクリックしてサービスを開始します。これが成功した場合は、[Windows サービス] ウィンドウを閉じます。これで、AppDNAにログオンできるようになります。

要求は HTTP ステータス 407 で失敗しました:プロキシ認証が必要です

このエラーは、Internet Explorer が LAN にプロキシサーバーを使用するように構成されている場合に発生します。この問題を回避するには、次のようにします。

  1. Internet Explorer のメニューから、[ツール] > [インターネットオプション] を選択します。
  2. [インターネットオプション] ダイアログボックスの [接続] タブで、[LAN の設定] をクリックします。
  3. [ローカルエリアネットワーク (LAN) の設定] ダイアログボックスの [プロキシサーバー] で、[ローカルアドレスにはプロキシサーバーを使用しない] チェックボックスをオンにします。
  4. [ OK] をクリックします。

ライセンスの問題

このセクションでは、AppDNAバナーが赤色になる原因など、ライセンスの問題のトラブルシューティングに役立つ情報を提供します。この問題が発生した場合は、ダッシュボードの「モジュールライセンスの概要」セクションの説明メッセージを参照してください。これにより、AppDNAがAppDNAライセンスサービスに接続できないか、データベース自体の実際のライセンスに問題があるかが明らかになります。これらの根本原因のそれぞれについて、個別の見出しの下に情報が続きます。

ライセンスの問題と赤いバナーがあるAppDNAを引き続き使用できます。ただし、機能は非常に制限されています。アプリケーションをインポートすることはできますが、他のほとんどの機能はブロックされます。ライセンスの問題が解決されると、ブロックされた機能が再び使用可能になります。

AppDNAがライセンスサービスにアクセスできない

ライセンスサービスに接続できないというメッセージが表示される場合は、AppDNAライセンスサーバーが実行されていない可能性があります。これをチェックし、必要に応じて次のように再起動することができます。

  1. [Windows サービス] ウィンドウを開きます ([コントロールパネル] > [管理ツール] > [サービス])。
  2. サービスのリストで、AppDNAライセンスサーバーを探します。
  3. [状態] 列が空白の場合は、サービスが開始されていないことを意味します。[開始] をクリックして、サービスを開始します。これが成功した場合は、[サービス] ウィンドウを閉じます。
  4. AppDNAを再起動します。

AppDNAサーバーの移動またはライセンスの転送後にデータベースライセンスが破損する

AppDNAライセンスは、ライセンスがアクティブ化されると、データベースとAppDNAライセンスサービスが実行されているマシンの両方に関連付けられます。データベース内のライセンスとライセンスサービスの場所との間のリンクが壊れていると、問題が発生する可能性があります。たとえば、AppDNAサーバーをあるマシンから別のマシンに移動したか、ライセンスを転送するための2段階の手順を開始したが完了していない場合などです。

  • 別のマシンのライセンスサービスでデータベースを使用できるようにするには、古いマシンのAppDNAライセンスサービスから新しいマシンにライセンスを転送します。

  • ライセンスの転送手順を開始した場合 (たとえば、ライセンス・トークンをエクスポートしたが、新しいライセンス・サーバーの場所とともにデータベースにインポートし直さなかった場合) は、手順を完了します。その後、データベースが再び利用可能になります。

詳しくは、ライセンスの転送を参照してください。

注:通常、ライセンスサービスはAppDNAサーバーと同じマシン上で実行されます。ただし、以前のバージョンのAppDNAからアップグレードした場合は、そうではない可能性があります。

デフォルトのライセンスサーバポートは使用できません

デフォルトでは、AppDNAライセンスサービスではポート8079が使用されます。そのポートが使用できない場合は、次のように変更します。

  1. サーバー上のAppDNAと、接続されているすべてのAppDNAクライアントを閉じます。

  2. AppDNAライセンスサービスファイルを見つけます。

    デフォルトの場所は、C:\Program Files[ (x86)]\Citrix\AppDNA\License Server。

  3. テキストエディタで remoting.config を開きます。

  4. 次の行で、8079 を別のポート番号に変更し、ファイルを保存します。 <channel ref="tcp" port="8079" bindTo="0.0.0.0">

  5. Windows の [スタート] 画面またはメニューから、[コントロールパネル]、[管理ツール]、[サービス] の順に選択します。

  6. Windowsサービスパネルで、サービスのリストでAppDNAライセンスサービスを探し、ツールバーの「開始」または「再起動」をクリックして、AppDNAライセンスサービスを再起動します。

インポートと分析の問題

「このトランザクションは完了したため使用できません」

このエラーメッセージは、解析中または任意のタイプのインポート中に発生する可能性があります。これは、通常、データベースが拡張するのに十分なディスク容量がないことが原因です。

  1. Microsoft SQL Server Management Studioを開き、AppDNAデータベースをホストするSQL Serverインスタンスに接続します。

  2. SQL Server のログをチェックして、ディスク領域の不足が問題であるかどうかを確認します。

    これを行うには、左側のツリービューで、[管理] > [SQL Server ログ] フォルダを開きます。最近のログを表示し、ディスクに十分な空き領域がないことを示すテキストを探します。ディスク容量に問題がある場合は、次の手順に従います。

  3. AppDNAデータベースのデータファイルとログファイルの拡張が許可されていることを確認します。

    左側のツリービューで、[データベース] フォルダを開きます。次に、AppDNAデータベースを右クリックし、ショートカットメニューから「プロパティ」を選択します。[データベースのプロパティ] ダイアログボックスが開きます。サイドバーの[ファイル]をクリックし、データ・ファイルとログ・ファイルの両方が小さいチャンク(たとえば、10%)になるように構成されており、最大サイズが設定されていないことを確認します。

  4. データベースの回復モデルを simple に設定します。

    [データベースプロパティ] ダイアログボックスで、サイドバーの [オプション] をクリックし、[リカバリモデル] が [シンプル] に設定されていることを確認します。

  5. 使用可能なディスク容量を確認し、必要に応じて不要なデータをクリーンアップするか、ハードウェアをアップグレードして空きディスク容量を増やします。

App-Vパッケージ(.sftまたは.appv)のインポートが失敗する

.sftパッケージまたは.appvパッケージをインポートすると、AppDNAはその内容を自動的に中間フォルダーに解凍し、元のディレクトリ構造を保持します。これは、結果のファイルパスの合計文字数が Windows の制限 (通常は 256 文字) を超えた場合に失敗します。この場合、インポートログファイルには create_deep_dir というテキストが含まれます。

デフォルトでは、AppDNAは.sftファイルと.appvファイルをファイル設定で指定した一時フォルダーに展開します。ただし、設定の読み込みと解析の SFT 中間フォルダボックスで、.sft ファイルと.appv ファイル用に別個の中間フォルダを指定できます。

この問題を解決するには、SFT 中間フォルダーの非常に短いファイルパスを設定します。このフォルダーは自動的にはクリアされません。必要に応じて、インポートの完了後に、解凍したファイルを手動で削除できます。

インポートは成功しましたが、アプリケーションに期待されるDNAが含まれていません

これは、Install Captureまたはセルフプロビジョニングによってインポートされたアプリケーションで、インストールが失敗しても、インストーラが成功の場合はゼロ、失敗の場合はゼロ以外の値を返すという規則に従わない場合に発生することがあります。この場合、デフォルトでは、AppDNAはキャプチャが成功したと見なされ、キャプチャされたDNAがインポートされ、インポートが成功したとマークされます。ただし、実際のアプリケーションDNAはまったくキャプチャされませんでした。この状況では、キャプチャされた DNA は、基盤となるオペレーティングシステムにアプリケーションをインストールしようとして失敗したマイナーな変更で構成されます。

オートクリッカーを使用してキャプチャを実行した場合、ユーザー入力を待機していたため、インストールが失敗した可能性があります。したがって、オートクリッカーを使用せずにキャプチャを再度実行します。これにより、インストール、およびキャプチャが正常に完了する可能性があります。

また、インストーラが成功時にゼロ終了コードを返す規則に従わないことがわかっている場合は、そのアプリケーションの実行プロファイルで成功終了コードを指定できます。これを行う方法については、実行プロファイルの編集を参照してください。

OS イメージのインポートが失敗し、エラー 404: ファイルが見つかりません

OS イメージのインポートが「404: ファイルが見つかりません」エラーで失敗すると、通常、IIS でコンテンツの最大長のサイズ制限を超えたことを意味します。許可されるコンテンツの最大長を増やすには、AppDNAの最適化の「IIS の最適化」の手順を参照してください。

問題を報告する

レポートビューの表示が非常に遅い

この問題は、1 ページあたりのレコード数が誤って非常に大きな値に設定されている場合に発生することがあります。ページが遅すぎて使用できない場合は、次のように、レポートビューから移動して、1 ページあたりのレコード数を変更します。

  1. AppDNAの「編集」メニューから「設定」を選択します。
  2. [設定] ダイアログボックスのサイドバーで、[レポート] をクリックします。
  3. [ページあたりのレコード数] ボックスに、小さい値 (200 など) を入力します。
  4. [保存] をクリックします。

Web クライアントの 1 ページあたりのレコード数を変更するには、次の手順に従います。

  • レポートビューの URL に以下を追加します。 &FRMKEY_PAGE_SIZE=n

n は、次の例に示すように、必須のデフォルトのページ・サイズです。わかりやすくするために、この URL は複数行に表示されます。実際には、URLは分割されていない1つの文字列として入力する必要があります。

http://appdna-machine:8199/appdna/Reporting/AssessmentReport.aspx? FRMKEY_TOKEN=1dd82045-b9a3-4840-af46-75e112bfcbb0 &FRMKEY_MODULE_ID=Win8Module &FRMKEY_CUSTOMISATION=&FRMKEY_POSTIMAGE=-2147483637 &FRMKEY_PREIMAGE=-2147483647&FRMKEY_RESOLUTION=app_group_summary &FRMKEY_PAGE_SIZE=5

レポートビューでのイメージの表示に失敗する

この問題は、Windows 8にAppDNAをインストールした後に最初にレポートを表示するときに発生します。この問題は、インターネットインフォメーションサービス (IIS) の構成が不完全であるために発生します。

この問題を解決するには、次の手順に従います。

  1. AppDNAを閉じて、AppDNAクライアントを停止します。
  2. AppDNAサーバーマシンで、必要なIIS機能がすべて有効になっていることを確認します。詳しくは、AppDNA 7.6のシステム要件を参照してください。
  3. IIS をリセットするには、iisreset コマンドを使用します。

Effort Calculatorが読めません

メイン Effort Calculator 画面は、コントロールパネルの [画面上の内容を読みやすくする] 表示オプションを使用して、画面上のテキストやその他の項目のサイズを 125% 増やした場合、読み取りできません。このオプションは、Windows 8ではデフォルトでオンになることがあります。

このオプションが使用されている場合、Effort Calculator はテキストのサイズを大きくします。これにより、テキストが切り捨てられるか、他の項目にまたがって読みにくくなります。他のレポートも、同様の方法で影響を受けます。

この問題を解決するには、コントロールパネルの [画面] で、表示サイズを 100% 設定にリセットします。

PDF のエクスポートが失敗する

Adobe Readerのインストール後、実際にAdobe Readerを実行するか、PDFファイルを開く前に、PDFのエクスポートを実行しようとすると、エラーでPDFのエクスポートが失敗します(「UACが無効になっていると、このアプリはアクティブにできません」)。これは、Adobe Readerライセンス契約に同意するまで、AppDNA PDFのエクスポートが機能しないためです。

この問題を解決するには、AppDNAを実行しているマシンでPDFファイルを開き、Adobe Readerライセンス契約に同意します。

PDF エクスポートの [レポートデータ] セクションで列が重複

レポートに多数のアルゴリズムグループがある場合、PDF エクスポートの「レポートデータ」セクションの列が重なり、判読不能になることがあります。この問題を解決するには、レポート設定で [PDF エクスポートでカウントを表示する] チェックボックスをオフにし、PDF エクスポートを再度実行します。

トラブルシューティング