Adobe Experience Manager デスクトップアプリケーション v1.x のトラブルシューティング troubleshoot-aem-desktop-app

AEM デスクトップアプリケーションのインストール、アップグレード、設定などで発生することのある問題のトラブルシューティングについて説明します。

Adobe Experience Manager デスクトップアプリケーションには、AEM Assets リポジトリーをデスクトップのネットワーク共有（Mac OS では SMB 共有）としてマッピングするのに役立つユーティリティが含まれています。ネットワーク共有とは、リモートソースをコンピューターのローカルファイルシステムの一部であるかのように扱うオペレーティングシステム（OS）テクノロジーです。デスクトップアプリケーションの場合は、リモート AEM インスタンスのデジタルアセット管理（DAM）リポジトリー構造をリモートファイルソースとして利用します。デスクトップアプリケーションのトポロジを次の図に示します。

このアーキテクチャでは、デスクトップアプリケーションはマウントされたネットワーク共有に対するファイルシステムコール（open、close、read、write など）を受け取り、それらを AEM サーバーへのネイティブな AEM HTTP 呼び出しに変換します。ファイルはローカルにキャッシュされます。詳しくは、AEM デスクトップアプリケーション v1.x の使用を参照してください。

AEM デスクトップアプリケーションコンポーネントの概要 desktop-app-component-overview

デスクトップアプリケーションには、以下のコンポーネントが含まれています。

AEM デスクトップアプリケーションの想定される使用例 intended-use-cases-for-aem-desktop-app

AEM デスクトップアプリケーションはネットワーク共有テクノロジーを使用して、リモート AEM リポジトリーをローカルデスクトップにマッピングします。しかしこれは、アセットを保持するネットワーク共有の代わりではありません。ユーザーはローカルデスクトップから直接、デジタルアセットの管理操作を行います。これには例えば、直接 Finder／エクスプローラー内で複数のファイルを移動またはコピーしたり、大規模なフォルダー構造を AEM Assets ネットワーク共有にドラッグすることが含まれます。

AEM デスクトップアプリケーションは、AEM Assets のタッチ操作対応 UI とローカルデスクトップの間をつなぎ、DAM アセットのアクセス（オープン）と編集（保存）を手軽におこなえるようにする手段となります。これにより、AEM Assets サーバー内のアセットとデスクトップベースのワークフローがリンクされます。

以下に、AEM デスクトップアプリケーションのサンプルの使用例を示します。

これが唯一の使用例ではありませんが、この例から、AEM デスクトップアプリケーションがアセットのアクセスと編集をローカルで実行する便利な手段であることがわかります。可能な限り、DAM web UI を使用することをお勧めします。こちらの方が操作性に優れており、アドビにとっても、ユーザーの要件に柔軟に対応できるというメリットがあります。

制限事項 limitations

WebDAV／SMB1 ネットワーク共有は、ファイルをエクスプローラー／Finder ウィンドウ内で操作するための便利な方法です。ただし、ネットワーク接続を介してエクスプローラー／Finder と AEM の間でやり取りする際には、一定の制限があります。例えば、1 GB のファイルをマウントされた WebDAV／SMB ディレクトリにコピーするのにかかる時間は、1 GB のファイルを Web ブラウザーを使用して Web サイトにアップロードするのに必要な時間とほぼ同じです。実際のところ、前者の処理については、WebDAV／SMB プロトコルや OS の WebDAV／SMB クライアントの非効率性のために、もっと時間がかかることがあります（特に Mac OS X の場合）。

マウントされたディレクトリで実行できる作業の種類には制限があります。一般的に、大きなファイルの取り扱いは困難です。特に、低速／高レイテンシ／低帯域幅のネットワーク接続を使用する場合や、大きなファイルを編集する場合には支障があります。

マウントされたディレクトリからその場で特定のファイルタイプを効率的に編集できると顧客に約束する前に、そのシナリオに沿ったテストを実施することをお勧めします。

AEM デスクトップアプリケーションは、以下のような大量の I/O を伴うファイルシステムの操作（これらに限りません）には適していません。

オペレーティングシステムの制限により、Windows ではファイルサイズの上限が 4,294,967,295 バイト（約 4.29 GB）と定められています。この制限は、ネットワーク共有上のファイルサイズの上限を定めるレジストリ設定に由来します。このレジストリ設定は DWORD 値であり、DWORD 値の上限が前述の数値になっています。

Experience Manager デスクトップアプリケーションには、一定時間の経過後に Experience Manager サーバーとデスクトップアプリケーションの間の接続を切断するための設定可能なタイムアウト値がありません。サイズの大きいアセットをアップロードする際に、しばらくして接続がタイムアウトした場合、アプリケーションはアップロードタイムアウトを長くして、アセットのアップロードを数回再試行します。デフォルトのタイムアウト設定を変更するお勧めの方法はありません。

キャッシュと AEM との通信 caching-and-communication-with-aem

AEM デスクトップアプリケーションは、使い勝手を向上させるために、内部キャッシュとバックグラウンドアップロード機能を備えています。大きなファイルを保存する際は、作業を続行できるよう、まずローカルに保存されます。しばらくすると（現在は 30 秒）、ファイルがバックグラウンドで AEM サーバーに送信されます。

Creative Cloud デスクトップアプリケーションやその他のファイル同期ソリューション（Microsoft One Drive など）とは異なり、AEM デスクトップアプリケーションは完全なデスクトップ同期クライアントではありません。なぜなら、AEM デスクトップアプリケーションは AEM Assets リポジトリー全体へのアクセスを提供しますが、このリポジトリーはときに数百 GB から数 TB に及び、完全に同期するには大きすぎる場合があるからです。

キャッシュは、ネットワークやストレージのオーバーヘッドを制限し、ユーザーに関連のあるアセットのサブセットのみを扱うための機能です。

AEM デスクトップアプリケーションにおけるキャッシュの仕組みは以下のとおりです。

すべての操作がローカルにキャッシュされるわけではありません。 以下は、ローカルにキャッシュされることなく、すぐに AEM サーバーに送信されます。

個別の操作 individual-operations

個別のユーザーについてパフォーマンス関連のトラブルシューティングをおこなう際は、まずアプリの制限事項を確認してください。以降の節では、個別のユーザーのパフォーマンスを向上させるための推奨事項について説明します。

帯域幅の推奨事項 bandwidth-recommendations

個々のユーザーが利用できる帯域幅は、WebDAV／SMB クライアントのパフォーマンスにとって重要な役割を果たします。

アドビでは、個々のユーザーのアップロード速度を 10 Mbps に近づけることをお勧めします。ワイヤレス接続の場合、帯域幅が複数のユーザーで共有されることがよくあります。複数のユーザーが同時にネットワーク帯域幅を消費するタスクを実行すると、パフォーマンスがさらに低下する可能性があります。 このような問題を回避するには、有線接続を使用してください。

同時操作 concurrent-operations

ユーザーがローカルでファイルを操作するときには、AEM デスクトップアプリケーションは、そのファイルの新しいバージョンが AEM 内にないかを確認します。新しいバージョンが使用可能な場合、アプリケーションはファイルの新しいコピーをローカルキャッシュにダウンロードします。 ただし、AEM デスクトップでは、ローカルにキャッシュされたファイルが変更されていても、上書きされません。 この機能は、作業内容が誤って上書きされるのを防ぎます。

同じファイルがローカルと AEM の両方で変更されている場合は、ローカルで変更された方のバージョンが AEM のバージョンを上書きします。この場合、以前のバージョンはアセットのタイムラインで利用できるので、ユーザーが両方のバージョンを確認して、競合を解決することができます。

ローカルファイルと、サーバーにあるバージョンが一致しない場合は、バックグラウンドアップロードのステータスダイアログに、競合についての通知が表示されます。この問題を解決するには、競合しているファイルを開いて保存します。ファイルを保存することで、AEM デスクトップアプリケーションに最新のローカルの変更内容を AEM に同期させることができます。ユーザーは以前のバージョンのアセットをタイムラインで参照して、競合を解決できます。

複数のユーザーが別々のマウントされたディレクトリで同じ AEM インスタンスをターゲットにして作業する場合には、さらに考慮すべき点があります。特に、以下の点が重要になります。

追加の AEM 設定 additional-aem-configurations

複数のユーザーが同時に作業すると WebDAV／SMB のパフォーマンスが大幅に低下する場合は、AEM でいくつかの設定を行って、パフォーマンスの向上を図ることができます。

アセットの更新の一時的なワークフロー update-asset-transient-workflows

DAM アセットの更新ワークフローで一時的なワークフローを有効にすることで、AEM 側のパフォーマンスを向上できます。一時的なワークフローを有効にすることで、AEM でアセットを作成または変更する際に、アセットの更新に必要な処理能力を低く抑えることができます。

Granite 一時ワークフローキューの調整 adjust-granite-transient-workflow-queue

AEM のパフォーマンスを向上させるもう 1 つの方法は、「Granite 一時的なワークフローキュー」ジョブについて並列ジョブの最大数を設定することです。推奨される値は、サーバーで利用可能な CPU の数の半分程度です。値を調整するには、以下の手順に従います。

AWS 設定 aws-configuration

複数のユーザーが同時に作業を行うと、ネットワーク帯域幅の制限により、WebDAV／SMB のパフォーマンスが低下することがあります。WebDAV／SMB のパフォーマンスを向上させるために、AWS 上で実行されるターゲット AEM インスタンス用の AWS インスタンスのサイズを大きくすることをお勧めします。

具体的には、サーバーで利用できるネットワーク帯域幅の量を増やします。以下に詳細を示します。

チェックアウトしたファイルの制限 checked-out-file-limitations

チェックアウトしたファイルをエクスプローラー／Finder から操作する方法については、いくつか既知の制限があります。チェックアウトされたファイルは、そのファイルをチェックアウトしたユーザー以外のユーザーに対しては読み取り専用となっていることが必要です。AEM の WebDAV／SMB1 プロトコルの実装では、このルールが適用されます。しかし、OS の WebDAV／SMB クライアントは、チェックアウトされたファイルに対して適切な処理を行わないことがあります。以下に、不適切な動作のいくつかを示します。

一般 general

チェックアウトしたファイルに書き込むときには、AEM の WebDAV 実装の範囲内においてのみロックが適用されます。その結果、WebDAV を使用するクライアント（デスクトップアプリケーションなど）でのみロックが適用されることになります。AEM の Web インターフェイスを介した場合は、ロックが適用されません。AEM インターフェイスは、チェックアウトされたアセットのカード表示にロックアイコンを表示するのみです。このアイコンはただの飾りであり、AEM の動作には影響しません。

通常、WebDAV クライアントは、常に予期したとおりに動作するとは限りません。追加で問題が発生することがあります。ただし、AEM 内でアセットを更新またはチェックインすれば、アセットが変更されていないことを確認できます。これはアドビの管理下にない OS の WebDAV クライアントで一般的な動作です。

Windows windows

ファイルを削除すると、そのファイルが Windows のエクスプローラーに表示されなくなるので、処理が成功したように見えます。しかし、ディレクトリを更新して AEM アセットをチェックインすると、ファイルがまだ存在していると表示されます。また、ファイルの編集も成功したように見えます（警告ダイアログやエラーメッセージは表示されません）が、ファイルを再度開いたり、AEM アセットをチェックインすると、ファイルが変更されていないことがわかります。

Mac OS X mac-os-x

ファイルを置換しても警告やエラーは表示されませんが、AEM にアセットをチェックインすると、変更されていない状態のままになっています。AEM 内でアセットを更新またはチェックインすると、アセットが変更されていないことを確認できます。

デスクトップアプリケーションのアイコンに関する問題のトラブルシューティング（Mac OS X） troubleshooting-desktop-app-icon-issues-mac-os-x

デスクトップアプリケーションをインストールすると、デスクトップアプリケーションのメニューアイコンがメニューバーに表示されます。アイコンが表示されない場合は、問題解決のために以下の手順を実行してください。

AEM デスクトップアプリケーションは、特定のファイルに対して 3 回同期を試みます。3 回試行してもファイルの同期に失敗する場合、AEM デスクトップアプリケーションはファイルが競合していると見なし、バックグラウンドアップロードのステータスウィンドウに通知が表示されます。競合状態とは、最新の変更内容がローカルに存在しているが、まだ AEM に同期されていないことを示します。それ以降、AEM デスクトップアプリケーションは同期を試みません。

この状況を解決する最も簡単な方法は、競合しているファイルを開き、再度保存することです。保存することで、AEM デスクトップアプリケーションはさらに 3 回同期を試みます。それでもファイルの同期に失敗する場合は、以下の節を参照してください。

AEM デスクトップアプリケーションのキャッシュのクリア clearing-aem-desktop-cache

AEM デスクトップアプリケーションのキャッシュのクリアは、最初におこなうべきトラブルシューティング作業です。これにより、AEM デスクトップアプリケーションで発生するいくつかの問題を解決できます。

次の場所にあるアプリケーションのキャッシュディレクトリを削除して、キャッシュをクリアできます。
Windows の場合、%LocalAppData%\Adobe\AssetsCompanion\Cache\

Mac の場合、~/Library/Group/Containers/group.com.adobe.aem.desktop/cache/

ただし、AEM デスクトップアプリケーションの AEM エンドポイントの設定によっては、場所が異なる場合があります。値は、ターゲット URL のエンコードされたバージョンです。例えば、アプリケーションのターゲットが http://localhost:4502 の場合、ディレクトリ名は http%3A%2F%2Flocalhost%3A4502%2F となります。

キャッシュをクリアするには、<Encoded AEM Endpoint> ディレクトリを削除します。

AEM デスクトップアプリケーションのバージョンの確認 finding-the-aem-desktop-version

AEM デスクトップアプリケーションのバージョンの確認手順は、Windows と Mac OS の両方で同じです。

AEM デスクトップアプリケーションのアイコンをクリックして、「バージョン情報」を選択します。画面にバージョン番号が表示されます。

macOS での AEM デスクトップアプリケーションのアップグレード upgrading-aem-desktop-app-on-macos

macOS で AEM デスクトップアプリケーションをアップグレードするときに問題が発生することがあります。これは、AEM デスクトップアプリケーションの古いシステムフォルダーによって、AEM デスクトップアプリケーションの新しいバージョンが正しく読み込まれなくなるからです。この問題を修正するには、以下のフォルダーおよびファイルを手動で削除します。

以下の手順を実行する前に、「Adobe Experience Manager デスクトップアプリケーション」アプリケーションを macOS のアプリケーションフォルダーからゴミ箱にドラッグします。次に、ターミナルを開き、以下のコマンドを実行します。パスワードを求められたら入力します。

sudo rm -rf ~/Library/Application\ Support/com.adobe.aem.desktop
sudo rm -rf ~/Library/Preferences/com.adobe.aem.desktop.plist
sudo rm -rf ~/Library/Logs/Adobe\ Experience\ Manager\ Desktop

sudo find /var/folders -type d -name "com.adobe.aem.desktop" | xargs rm -rf
sudo find /var/folders -type d -name "com.adobe.aem.desktop.finderintegration-plugin" | xargs rm -rf

他のユーザーによってチェックアウトされているファイルの保存 saving-a-file-checked-out-by-others

オペレーティングシステムの技術的な制限により、他のユーザーによってチェックアウトされているファイルを上書きしようとした際、一貫した動作が保証されていません。チェックアウトされたファイルをどのアプリケーションで編集するかによって、動作が異なります。アプリケーションによっては、ディスク書き込みエラーを示すエラーメッセージが表示されたり、無関係に見えるエラーや一般的なエラーが表示されることがあります。また、エラーメッセージが表示されず、操作が成功したように見えることもあります。

上記のような場合でも、ファイルを閉じてから再度開くと、コンテンツが変化していないことがあります。ただし、一部のアプリケーションでは、ファイルのバックアップが保存されるので、変更内容を後から適用することができます。

この動作にもかかわらず、チェックインしても、ファイルは変更されていません。異なるバージョンのファイルが表示されている場合でも、変更内容は AEM に同期されません。

ファイルの移動に関する問題のトラブルシューティング troubleshooting-problems-around-moving-files

移動およびコピー操作を機能させるには、サーバー API に追加のヘッダー X-Destination、X-Depth および X-Overwrite を渡す必要があります。Dispatcher はこれらのヘッダーをデフォルトで渡さないので、それが原因で操作が失敗します。詳しくは、Dispatcher の背後にある AEM インスタンスへの接続を参照してください。

AEM デスクトップアプリケーションの接続の問題のトラブルシューティング troubleshooting-aem-desktop-connection-issues

SAML のリダイレクトの問題 saml-redirect-issue

AEM デスクトップアプリケーションを SSO 対応（SAML）AEM インスタンスに接続する際に発生する問題の最も一般的な原因は、SAML プロセスが最初にリクエストされたパスに戻ってこないことです。あるいは、AEM デスクトップアプリケーションで設定されていないホストに接続がリダイレクトされることがあります。ログインプロセスを確認するために、以下の手順を実行してください。

SSL 設定の問題 ssl-configuration-issue

AEM デスクトップアプリケーションが HTTP 通信に使用するライブラリは SSL を厳格に適用します。ブラウザーでは成功する接続が、AEM デスクトップアプリケーションでは失敗することがあります。SSL を適切に設定するには、不足している中間証明書を Apache にインストールします。中間 CA の証明書を Apache にインストールするにはを参照してください。

AEM デスクトップアプリケーションを Dispatcher と併用する using-aem-desktop-with-dispatcher

AEM デスクトップアプリケーションは、AEM を Dispatcher の背後にデプロイする構成で動作します。これは、AEM サーバーの推奨されるデフォルトの構成です。AEM オーサリング環境の前にある AEM Dispatcher は、通常、DAM アセットのキャッシュをスキップするように設定されます。したがって、AEM デスクトップアプリケーションから見ると、Dispatcher は追加のキャッシュ機能を提供しません。Dispatcher の設定が AEM デスクトップアプリケーションに適したものとなっていることを確認してください。詳しくは、Dispatcher の背後にある AEM インスタンスへの接続を参照してください。

ログファイルの確認 checking-for-log-files

AEM デスクトップアプリケーションのログファイルの場所は、オペレーティングシステムによって異なります。それぞれ以下の場所にあります。