CRX2Oak是一種工具,專為在不同存放庫之間遷移資料而設計。
它可用來將資料從以Apache Jackrabbit 2為基礎的舊CQ版本移轉至Oak,也可用來在Oak存放庫之間複製資料。
您可以從公共Adobe存放庫下載最新版本的crx2oak,網址為:
https://repo1.maven.org/maven2/com/adobe/granite/crx2oak/
如需Apache Oak和AEM持續性的重要概念的詳細資訊,請參閱 AEM平台簡介.
此工具可用於:
對於使用外部Blob存放區(通常稱為資料存放區)移轉存放庫的支援以不同的組合提供。 一個可能的移轉路徑來自使用外部的CRX2存放庫 FileDataStore
使用至Oak存放庫 S3DataStore
.
下圖說明CRX2Oak支援的所有可能移轉組合:
CRX2Oak是在AEM升級期間以使用者可以指定預先定義的移轉設定檔的方式來呼叫,以自動重新設定持續性模式。 這稱為快速入門模式。
如果需要更多自訂,也可以單獨執行。 不過,請注意,在此模式中,變更只會針對存放庫進行,而且需要手動執行任何額外的AEM重新配置。 這稱為獨立模式。
另外需要注意的是,若使用獨立模式中的預設設定,則只會移轉節點存放區,而新的存放庫會重複使用舊的二進位存放區。
自AEM 6.3起,CRX2Oak就能夠處理使用者定義的移轉設定檔,這些設定檔可設定所有可用的移轉選項。 這樣既可擁有更高的靈活性,又可自動設定AEM,這些功能在獨立模式下使用工具時不可用。
若要將CRX2Oak切換為快速啟動模式,您需要透過此作業系統環境變數在AEM安裝目錄中定義crx-quickstart資料夾的路徑:
對於基於UNIX的系統和macOS:
export SLING_HOME="/path/to/crx-quickstart"
對於Windows:
SET "SLING_HOME=/path/to/crx-quickstart"
移轉作業可隨時中斷,之後可繼續進行。
自訂Java邏輯也可以使用來實作 CommitHooks
. 自訂 RepositoryInitializer
類別可以實作,以便使用自訂值初始化存放庫。
CRX2Oak預設也支援記憶體對應作業。 記憶體對應可大幅提升效能,應儘可能使用。
但是請注意,Windows平台不支援記憶體對應作業。 因此,建議新增 —disable-mmap 在Windows上執行移轉時的引數。
依預設,工具會移轉以下專案下的整個存放庫 "/"
路徑。 不過,您可以完全控制應該移轉哪些內容。
如果新執行個體上有不需要的內容任何部分,您可以使用 --exclude-path
用於排除內容並最佳化升級程式的引數。
如果需要在兩個存放庫之間複製資料,且您的內容路徑在兩個執行個體上不同,您可以在以下位置定義該資料: --merge-path
引數。 完成後,CRX2Oak只會將新節點複製到目的地存放庫,並保留舊節點。
依預設,AEM會建立每個要修改的節點或頁面的版本,並將其儲存在存放庫中。 然後可以使用版本將頁面還原到先前的狀態。
不過,即使刪除原始頁面,系統也不會清除這些版本。 處理已運作很久的存放庫時,移轉可能需要處理大量由孤立版本造成的重複資料。
對於這些型別的情況來說,一個有用的功能是新增 --copy-versions
引數。 它可用來在移轉或存放庫複製期間略過版本節點。
您也可以選擇是否要透過新增來複製孤立版本 --copy-orphaned-versions=true
.
這兩個引數也支援 YYYY-MM-DD
日期格式,以備您在不遲於特定日期復製版本時使用。
CRX2Oak的開放原始碼版本以Oak-upgrade的形式提供。 除了以下功能外,支援其他所有功能:
請參閱 Apache檔案 以取得詳細資訊。
--cache
:快取大小(預設為MB) 256
)
--mmap
:啟用區段存放區的記憶體對應檔案存取
--src-password:
來源RDB資料庫密碼
--src-user:
來源RDB的使用者
--user
:目標RDB的使用者
--password
:目標RDB的密碼。
--early-shutdown
:在複製節點後和套用認可掛接前關閉來源JCR2存放庫
--fail-on-error
:如果無法從來源存放庫讀取節點,則強制移轉失敗。
--ldap
:將LDAP使用者從CQ 5.x執行個體移轉至Oak型執行個體。 為了讓此功能發揮作用,Oak設定中的身分提供者必須命名為ldap。 如需詳細資訊,請參閱 LDAP檔案.
--ldap-config:
請將此與 --ldap
使用多個LDAP伺服器進行驗證的CQ 5.x存放庫引數。 您可以使用它指向CQ 5.x ldap_login.conf
或 jaas.conf
組態檔。 格式為 --ldapconfig=path/to/ldap_login.conf
.
--copy-orphaned-versions
:略過複製孤立版本。 支援的引數包括: true
, false
和 yyyy-mm-dd
. 預設為 true
.
--copy-versions:
復製版本儲存空間。 引數: true
, false
, yyyy-mm-dd
. 預設為 true
.
--include-paths:
複製期間要包含的以逗號分隔的路徑清單--merge-paths
:複製期間要合併的逗號分隔路徑清單--exclude-paths:
複製期間要排除的逗號分隔路徑清單。--src-datastore:
要作為來源使用的資料存放區目錄 FileDataStore
--src-fileblobstore
:要當作來源使用的資料存放區目錄 FileBlobStore
--src-s3datastore
:要用於來源的資料存放區目錄 S3DataStore
--src-s3config
:來源的設定檔 S3DataStore
.
--datastore:
用作目標的資料存放區目錄 FileDataStore
--fileblobstore:
用作目標的資料存放區目錄 FileBlobStore
--s3datastore
:用於目標的資料存放區目錄 S3DataStore
--s3config
:目標的設定檔案 S3DataStore
.
-?, -h, --help:
顯示說明資訊。您也可以啟用移轉程式的偵錯資訊,以便疑難排解程式期間可能出現的任何問題。 您可以根據您想要在其中執行工具的模式來採取不同的做法:
CRX2Oak模式 | 動作 |
快速入門模式 | 您可以新增 — 記錄層級TRACE 或 — 記錄層級DEBUG 執行CRX2Oak時命令列的選項。 在此模式中,記錄檔會自動重新導向至 upgrade.log檔案. |
獨立模式 | 新增 —trace CRX2Oak命令列的選項,以在標準輸出上顯示TRACE事件(您需要使用重新導向字元:'>'或'tee'命令自行重新導向記錄,以供稍後檢查)。 |
移轉至MongoDB復本集時,請務必將 WriteConcern
引數至 2
與Mongo資料庫的所有連線。
您可以新增 w=2
連線字串結尾的引數,如下所示:
java -Xmx4092m -jar crx2oak.jar crx-quickstart/repository/ mongodb://localhost:27017/aem-author?replicaset=replica1&w=2
如需詳細資訊,請參閱MongoDB連線字串檔案,網址為 撰寫關注事項.