Show Menu
主題×

疑難排解AEM案頭應用程式v1.x

疑難排解AEM案頭應用程式,以解決與安裝、升級、設定等相關的偶發性問題。
Adobe Experience Manager(AEM)案頭應用程式包含公用程式,可協助您將AEM Assets存放庫對應為案頭上的網路共用(Mac OS上的SMB共用)。 網路共用是一種作業系統技術,它使遠程源被視為電腦本地檔案系統的一部分。 在案頭應用程式中,遠端AEM例項的數位資產管理(DAM)儲存庫結構會定位為遠端檔案來源。 下圖說明案頭應用程式拓撲:
使用此架構,案頭應用程式會截取檔案系統呼叫(開啟、關閉、讀取、寫入等)至已載入的網路共用,並將它們轉譯為AEM伺服器的原生AEM HTTP呼叫。 檔案會快取至本機。 如需詳細資訊,請 參閱「使用AEM案頭應用程式v1.x 」。

AEM desktop app component overview

案頭應用程式包含下列元件:
  • 案頭應用程式 :應用程式會將DAM安裝或解除安裝為遠端檔案系統,並在本機載入的網路共用與它所連接的遠端AEM例項之間轉換檔案系統呼叫。
  • 作業系統WebDAV/SMB客戶端 :處理Windows檔案總管/Finder和案頭應用程式之間的通訊。 如果擷取、建立、修改、刪除、移動或複製檔案,作業系統(OS)WebDAV/SMB用戶端會將此作業傳送至案頭應用程式。 在收到通訊後,案頭應用程式會將它轉譯為原生AEM遠端API呼叫。 例如,如果用戶在掛載的目錄中建立檔案,WebDAV/SMB客戶端將啟動請求,案頭應用程式將其轉換為在DAM中建立檔案的HTTP請求。 WebDAV/SMB客戶端是作業系統的內置元件。 它不會以任何方式與案頭應用程式、AEM或Adobe附屬。
  • Adobe Experience Manager實例 :提供對儲存在AEM Assets DAM儲存庫中的資產的存取權。 此外,它會代表與掛載的網路共用互動的本機案頭應用程式,執行案頭應用程式要求的動作。 目標AEM例項應執行AEM 6.1版或更新版本。 執行舊版AEM的AEM例項可能需要安裝額外的功能套件和Hotfix,才能完全發揮功能。

AEM案頭應用程式的預期使用案例

AEM案頭應用程式使用網路共用技術,將遠端AEM存放庫對應至本機案頭。 但是,它不是用來取代網路共用持有資產,即用戶直接從本機案頭執行數位資產管理操作。 這些動作包括移動或複製多個檔案,或將大型檔案夾結構拖曳至直接在Finder/Explorer中共用的AEM Assets網路。
AEM案頭應用程式提供在AEM Assets Touch UI和本機案頭之間存取(開啟)和編輯(儲存)DAM資產的便利方式。 它會將AEM Assets伺服器中的資產與您案頭工作流程連結。
下列範例使用案例說明如何使用AEM Desktop:
  • 使用者登入AEM並使用網頁UI來尋找資產。
  • 使用AEM網頁UI的案頭動作功能,使用者可視需要在案頭上開啟、顯示或編輯資產。
  • AEM Desktop會在資產檔案類型的預設編輯器中開啟資產。
  • 使用者對資產進行所需的變更。
  • 修改檔案後,使用者可以使用AEM Desktop的背景同步狀態視窗來檢視檔案的同步狀態。
  • 使用AEM Desktop的內容選單,使用者會簽入/簽出資產,或返回DAM使用者介面。
  • 完成檔案的變更後,使用者會返回AEM網頁UI
這並非唯一的使用案例。 不過,它說明AEM Desktop是存取/編輯本機資產的便利機制。 我們建議您盡可能使用DAM網頁UI,因為它可提供更佳的體驗。 它為Adobe提供更大的彈性,以符合客戶需求。

限制

WebDAV/SMB1網路共用為在Explorer/Finder窗口中處理檔案提供了方便。 不過,Explorer/Finder和AEM會透過網路連線進行通訊,而且這些連線有特定限制。 例如,將1-GB檔案複製至已載入的WebDAV/SMB目錄所耗用的時間,與使用Web瀏覽器將1-GB檔案上傳至網站所需的時間大致相同。 事實上,在前一種情況下,由於WebDAV/SMB協定和作業系統的WebDAV/SMB客戶端(尤其是Mac OS X)效率低下,持續時間可能會更長。
從掛載的目錄可以執行的任務類型有一些限制。 一般而言,處理大型檔案(尤其是在低/高延遲/低頻寬網路連線上)可能很有挑戰性,尤其是在編輯大型檔案時。
Adobe建議您先執行一些使用案例測試,然後再將某些類型的檔案從已載入的目錄中就地進行有效編輯。
AEM Desktop不適合執行密集的檔案系統控制,包括但不限於:
  • 移動或複製檔案和目錄
  • 新增許多資產至AEM
  • 通過檔案系統搜索和開啟檔案(瀏覽資料夾除外)
  • 壓縮或解壓縮檔案存檔
由於作業系統的限制,Windows的檔案大小限制為4,294,967,295位元組(約4.29 GB)。 這是由於註冊表設定,它定義了網路共用上的檔案的大小。 註冊表設定的值是DWORD,其最大大小等於引用的數字。
Experience Manager案頭應用程式沒有可設定的逾時值,此值會在固定時間間隔後中斷Experience Manager伺服器與案頭應用程式之間的連線。 上傳大型資產時,如果連線在一段時間後逾時,應用程式會增加上傳逾時,重新嘗試上傳資產幾次。 不建議使用任何方法來變更預設逾時設定。

快取與與AEM通訊

AEM案頭應用程式提供內部快取和背景上傳功能,以改善使用者體驗。 當您儲存大型檔案時,它會先儲存在本機,讓您繼續工作。 在某個時候(目前為30秒)後,檔案就會在背景傳送至AEM伺服器。
與Creative Cloud Desktop或其他檔案同步解決方案(例如Microsoft One Drive)不同,AEM案頭應用程式不是完整的Desktop Sync用戶端。 其原因是它可讓您存取整個AEM Assets存放庫,因為此存放庫可能非常大(數百GB或TB),以進行完全同步。
快取功能可將網路/儲存空間開銷限制在與使用者相關的資產子集。
Adobe建議關閉縮圖產生功能,以加快瀏覽速度。 如果您啟用圖示預覽,應用程式會在您瀏覽已載入的檔案夾時快取數位資產。 應用程式也會下載使用者可能不在乎的資產,這會增加伺服器的負載、耗用使用者的頻寬,並且會佔用使用者的更多磁碟空間。
以下是AEM案頭應用程式如何執行快取:
  • 當您在Finder中開啟檔案夾並顯示檔案的縮圖/預覽,或當您在應用程式中開啟檔案時,案頭應用程式會快取檔案二進位檔。
  • 當您透過Finder或其他案頭應用程式儲存檔案時,會先在本機(快取)儲存檔案,並通知作業系統。 然後,檔案會排入佇列,等候上傳至背景的伺服器,最終透過網路上傳。 萬一發生網路錯誤,案頭應用程式會嘗試上傳整個檔案,最多三次。 如果在三次重試後無法上傳,檔案會標示為衝突的檔案,並透過「背景上傳佇列狀態」視窗顯示狀態。 案頭應用程式不會再嘗試更新檔案。 使用者應更新檔案,並在連線恢復後重新上傳檔案
每個操作都不會在本地快取。 以下內容會立即傳送至AEM伺服器,而不需進行本機快取:
  • 對資料夾執行的任何操作,例如建立、刪除等
  • 1.4 版中加入的「檔案夾上傳」功能可上傳本機檔案夾階層,而不需在本機快取檔案

個別作業

在針對個別使用者疑難排解未最佳化效能時,請先檢閱 限制 。 後續章節包含改善個別使用者效能的建議。

頻寬建議

單個用戶可用的頻寬對WebDAV/SMB客戶端的效能起著關鍵作用。
Adobe建議個別使用者的上傳速度接近10 Mbps。 對於無線連接,頻寬通常在多個用戶之間共用。 如果多個用戶同時執行消耗網路頻寬的任務,效能可能會進一步降低。 為避免此類問題,請使用有線連接。

Windows特定配置

如果您在Windows上執行AEM,可以設定Windows以增強WebDAV用戶端的效能。 如需詳細資訊,請前往 https://support.microsoft.com/en-us/kb/2445570
在Windows 7中,修改IE設定可改善WebDAV的效能。 如需詳細資訊,請造 訪http://oddballupdate.com/2009/12/fix-slow-webdav-performance-in-windows-7/

併發操作

當您在本機與檔案互動時,AEM Desktop會檢查AEM中是否有較新版本的檔案。 如果有新版本,應用程式會將檔案的新副本下載至本機快取。 不過,AEM Desktop不會覆寫已修改的本機快取檔案。 此功能可防止您的作品不慎覆寫。
當在本機和AEM中修改相同檔案時,本機修改的版本會覆寫AEM中的版本。 在此情況下,舊版可在資產時間軸中使用。 您可以驗證兩個版本並解決任何衝突。
如果本機檔案與伺服器中可用的版本不一致,背景上傳狀態對話方塊會通知您有關衝突。 若要解決問題,請開啟衝突的檔案並加以儲存。 儲存檔案會強制AEM Desktop將您最新的本機變更同步至AEM。 您可以在時間軸中檢視資產的先前版本,並解決任何衝突。
當多位使用者嘗試在針對相同AEM例項的個別已載入目錄中工作時,您應考量其他因素。 特別是,以下因素很重要:
  • 用戶的源網路上可用的頻寬量
  • 原始網路的網路配置,如防火牆或代理
  • 目標AEM例項網路中可用的頻寬量
  • 目標AEM例項之前是否存在分派器
  • 目標AEM例項的目前載入

其他AEM設定

如果WebDAV/SMB效能在多位使用者同時工作時大幅降低,您可以在AEM中設定一些項目,以協助改善效能。

更新資產暫時性工作流程

您可以啟用DAM更新資產工作流程的暫時性工作流程,以改善AEM端的效能。 啟用暫時性工作流程可降低在AEM中建立或修改資產時更新資產所需的處理能力。
  1. 導覽至 /miscadmin 要設定的AEM例項(例如 http://[Server]:[Port]/miscadmin )。
  2. 從導覽樹狀結構中,展 開「工具 >工 作流程 >模 型> dam 」。
  3. 按兩下「 DAM更新資產」
  4. 從浮動工具面板切換至「頁面 」標籤 ,然後按一下「 頁面屬性」
  5. 選中「暫 態工作流 」(Transient Workflow )複選框,然後按一下「 ​確定」(OK)。

調整 Granite 暫時工作流程佇列

另一個改善AEM效能的方法是為Granite Transient Workflow Queue(Granite暫時工作流程佇列)工作設定最大並行作業的值。 建議的值大約是伺服器可用CPU數的一半。 要調整值,請執行以下步驟:
  1. 導覽至 要設定之AEM例項中的/system/console/configMgr (例如 )。
  2. 搜索 QueueConfiguration ,然後按一下以開啟每個作業,直到找到 Granite Transient Workflow Queue job。 按一下旁邊的「編輯」圖示。
  3. 更改「最 大並行作業數 」值,然後按一下「 保存」

AWS配置

由於網路頻寬限制,當多個用戶同時工作時,WebDAV/SMB的效能可能會降低。 Adobe建議增加在AWS上運行的目標AEM實例的AWS實例大小,以增強WebDAV/SMB的效能。
此措施特別提高了伺服器可用的網路頻寬量。 以下是一些細節:
  • 專用於AWS實例的網路頻寬量隨著實例大小的增加而增加。 有關每個實例大小的可用頻寬資訊,請參閱 AWS文檔
  • 針對大型用戶端進行疑難排解時,Adobe會將其AEM執行個體的大小設定為c4.8xlarge,主要針對其提供的4000 Mbps專用頻寬。
  • 如果AEM例項前有調度器,請確定它的大小適當。 如果AEM例項提供4000 Mbps,但發送器僅提供500 Mbps,則有效頻寬僅為500 Mbps。 這是因為調度程式造成了網路瓶頸。

已簽出的檔案限制

您可透過Explorer/Finder與已簽出檔案互動的方式有一些已知限制。 如果檔案已簽出,則除已簽出該檔案的用戶外,其他任何人都應該只讀。 在AEM中實作WebDAV/SMB1通訊協定會實施此規則。 但是,OS WebDAV/SMB客戶端通常無法與已簽出的檔案正常交互。 以下說明一些怪異之處。

一般

當寫入已簽出的檔案時,鎖定只會在AEM WebDAV實作中強制執行。 因此,鎖定僅由使用WebDAV(如案頭應用程式)的用戶端執行。 此鎖定不會透過AEM網頁介面執行。 AEM介面只會在已簽出的資產的卡片檢視中顯示鎖定圖示。 圖示為修飾,對AEM的行為無影響。
一般而言,WebDAV用戶端的行為並不總是如預期般。 可能還有其他問題。 不過,在AEM中重新整理或檢查資產是驗證資產是否未修改的良好方式。 這是OS WebDAV用戶端的典型行為,不受Adobe控制。

Windows

刪除檔案似乎成功,因為該檔案從Windows的檔案資源管理器中消失。 不過,重新整理目錄並簽入AEM資產會顯示檔案仍然存在。 此外,編輯檔案似乎成功(未顯示警告對話框或錯誤訊息)。 不過,重新開啟檔案或簽入AEM資產會顯示檔案未變更。

Mac OS X

取代檔案不會顯示警告或錯誤,但是在AEM中檢查資產會顯示其維持不變。 在AEM中重新整理或檢查資產,以確認其未修改。

案頭應用程式圖示問題疑難排解(Mac OS X)

安裝案頭應用程式後,案頭應用程式選單圖示會出現在選單列中。 如果未顯示該表徵圖,請執行以下步驟以解決問題:
  1. 開啟作業系統終端窗口。
  2. 在命令提示符下鍵入以下命令,然後按Enter鍵:
     cd ../Library/Caches.
    
    
  3. 鍵入以下命令,然後按Enter:
    rm -r com.adobe.aem.assetscompanion 
    
    
  4. 鍵入以下命令,然後按Enter:
    cd ~/Library/Preferences
    
    
  5. 鍵入以下命令,然後按Enter:
    rm com.adobe.aem.assetscompanion.plist
    
    
  6. 鍵入以下命令,然後按Enter:
    rm ~/Library/Group\ Containers/group.com.adobe.aem.desktop/*
    
    
  7. 重新啟動系統。
AEM Desktop會嘗試同步任何指定檔案三次。 如果檔案在第三次嘗試後無法同步,AEM Desktop會認為檔案有衝突,並透過背景上傳狀態視窗通知您。 衝突狀態表示您的最新變更仍可在本機使用,但不會同步回AEM。 AEM案頭應用程式不再嘗試同步。
要修正此情況,最簡單的方法是開啟衝突的檔案,然後再次儲存。 它會強制AEM Desktop嘗試在另外三個情況下進行同步。 如果檔案仍無法同步,請參閱下列章節以取得更多說明。

清除AEM Desktop Cache

清除AEM Desktop的快取是一項初步的疑難排解工作,可解決數個AEM Desktop問題。
通過刪除應用程式的快取目錄(位於以下位置),可以清除快取:Windows:%LocalAppData%\Adobe\AssetsCompanion\Cache\
Mac:~/Library/Group/Containers/group.com.adobe.aem.desktop.cache/
不過,位置會依AEM Desktop的設定AEM端點而變更。 值是目標URL的編碼版本。 例如,如果應用程式正在定位, http://localhost:4502 則目錄名稱為 http%3A%2F%2Flocalhost%3A4502%2F
若要清除快取,請刪除<Encoded AEM Endpoint>目錄。
如果您清除AEM Desktop快取,則未同步至AEM的本機檔案變更會遺失。
從AEM案頭應用程式1.5版開始,案頭應用程式UI中有一個選項可清除快取。

尋找AEM Desktop版本

在Windows和Mac OS中,確定AEM Desktop版本的程式相同。
按一下「AEM Desktop」圖示,然後選擇「關 」。 版本號碼顯示在螢幕上。

在macOS上升級AEM案頭應用程式

在macOS上升級AEM案頭應用程式時,偶爾會發生問題。 這是由於AEM案頭應用程式的舊系統資料夾導致無法正確載入新版本的AEM Desktop。 要解決此問題,可以手動刪除以下資料夾和檔案。
在執行下列步驟之前,請將「Adobe Experience Manager Desktop」應用程式從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

保存其他人簽出的檔案

作業系統的技術限制,讓使用者在嘗試覆寫其他人已簽出的檔案時,無法獲得一致的使用體驗。 體驗會依用來編輯已簽出檔案的應用程式而有所不同。 有時,應用程式會顯示一條錯誤消息,指示磁碟寫入失敗,或顯示一個看似不相關或一般的錯誤。 在其他情況下,不會顯示錯誤訊息,且操作似乎成功。
在這種情況下,關閉和重新開啟檔案可能會顯示內容未變更。 不過,有些應用程式可能會儲存檔案的備份,以便套用您的變更。
不論您的行為如何,檔案都會在您登入時維持不變。 即使顯示不同版本的檔案,變更也不會同步至AEM。

疑難排解移動檔案的相關問題

伺服器API需要傳遞額外的標題、X-Destination、X-Depth和X-Overwrite,才能讓移動和復製作業運作。 預設情況下,調度程式不會傳遞這些標頭,這會導致這些操作失敗。 如需詳細資訊,請 參閱Connecting to AEM Bathen a Dispatcher

疑難排解AEM Desktop連線問題

SAML重新導向問題

AEM Desktop連線至您啟用SSO(SAML)AEM例項時,最常見的原因是SAML程式不會重新導向回原始要求的路徑。 或者,該連線可重新導向至未在AEM案頭中設定的主機。 執行下列步驟以驗證登入程式:
  1. 開啟網頁瀏覽器。
  2. 在位址列中,指定URL /content/dam.json
  3. 例如,以目標AEM例項取代URL http://localhost:4502/content/dam.json
  4. 登入AEM。
  5. 登入後,在位址列中檢查瀏覽器的目前位址。 它應符合您最初輸入的URL。
  6. 確認所有項目之 /content/dam.json 前皆符合AEM Desktop中設定的目標AEM值。

SSL設定問題

AEM案頭應用程式用於HTTP通訊的程式庫採用嚴格的SSL強制。 有時,連線可能會使用瀏覽器成功,但無法使用AEM案頭應用程式。 若要正確設定SSL,請在Apache中安裝遺失的中間憑證。 請參 閱如何在Apache中安裝Intemider CA憑證

搭配使用AEM Desktop和dispatcher

AEM Desktop可與Dispatcher後面的AEM部署搭配使用,這是AEM伺服器的預設和建議設定。 AEM製作環境前面的AEM調度程式通常會設定為略過快取DAM資產。 因此,從AEM Desktop的觀點來看,調度程式不會提供額外的快取。 請確定已調整Dispatcher設定,以便適用於AEM Desktop。 如需詳細資訊,請參 閱「在調度程式後連線至AEM」

正在檢查日誌檔案

視您的作業系統而定,您可在下列位置找到AEM Desktop的記錄檔:
  • Windows: %LocalAppData%\Adobe\AssetsCompanion\Logs
  • Mac: ~/Library/Logs/Adobe\ Experience\ Manager\ Desktop