文件AEM 6.4Deploying 指南

升級前維護任務 pre-upgrade-maintenance-tasks

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • 開發人員
CAUTION
AEM 6.4已結束延伸支援，本檔案不再更新。 如需詳細資訊，請參閱 技術支援期. 尋找支援的版本 此處.

開始升級之前，請務必遵循這些維護任務，以確保系統已就緒，並且一旦出現問題，可以回滾：

確保有足夠的磁碟空間 ensure-sufficient-disk-space

執行升級時，除了內容和程式碼升級活動外，還需執行存放庫移轉。 移轉會以新的區段Tar格式建立存放庫復本。 因此，您將需要足夠的磁碟空間來保留儲存庫的第二個版本（可能更大）。

完全備份AEM fully-back-up-aem

AEM應在開始升級前完全備份。 請務必備份儲存庫、應用程式安裝、資料存放區和Mongo例項（如果適用）。 如需備份和還原AEM執行個體的詳細資訊，請參閱 備份和還原.

備份對/etc的更改 backup-changes-etc

升級程式能妥善維護及合併下方的現有內容和設定 /apps 和 /libs 儲存庫中的路徑。 針對 /etc 路徑（包括Context Hub設定）通常需在升級後重新套用這些變更。 雖然升級會製作任何無法合併的變更的備份副本 /var，建議您在開始升級前手動備份這些變更。

生成quickstart.properties檔案 generate-quickstart-properties

從jar檔案啟動AEM時， quickstart.properties 檔案將在下產生 crx-quickstart/conf. 如果AEM過去只是使用啟動指令碼啟動，則此檔案將不存在，且升級將失敗。 請務必檢查此檔案是否存在，並從jar檔案重新啟動AEM（如果不存在）。

配置工作流和審核日誌清除 configure-wf-audit-purging

此 WorkflowPurgeTask 和 com.day.cq.audit.impl.AuditLogMaintenanceTask 任務需要單獨的OSGi配置，如果沒有這些配置，則無法運行。 如果在升級前任務執行期間失敗，則最可能的原因是缺少配置。 因此，如果您不想執行這些任務，請務必為這些任務新增OSGi設定，或從升級前最佳化任務清單中完全移除這些設定。 有關配置工作流清除任務的文檔，請參見 管理工作流程例項 和審核日誌維護任務配置可在 AEM 6中的稽核記錄維護.

如需CQ 5.6的工作流程和稽核記錄清除，以及AEM 6.0的稽核記錄清除，請參閱 清除工作流和審核節點.

安裝、配置和運行升級前任務 install-configure-run-pre-upgrade-tasks

由於AEM允許的自訂層級，環境通常不會遵循執行升級的統一方式。 這使得建立標準化的升級程式成為一個困難的過程。

在舊版中，停止或無法安全恢復的AEM升級也相當困難。 這會導致需要重新啟動完整升級過程，或執行有缺陷的升級而未觸發任何警告的情況。

為了解決這些問題，Adobe已在升級程式中新增數項增強功能，使其更具彈性且方便使用。 必須手動執行的升級前維護任務正在優化和自動化。 此外，還添加了升級後報告，以便能夠充分審查該過程，希望更容易發現任何問題。

預升級維護任務目前分散在手動部分或完全執行的各種介面上。 AEM 6.3中推出的升級前維護最佳化可讓您以統一方式觸發這些工作，並可依需求檢查其結果。

升級前最佳化步驟中包含的所有工作都與AEM 6.0以後的所有版本相容。

如何設定 how-to-set-it-up

在AEM 6.3和更新版本中，升級前維護優化任務包含在quickstart Jar中。 如果您從舊版AEM 6升級，則可透過個別套件使用，而您可從套件管理器下載這些套件。

您可以在以下位置找到套件：

如何使用 how-to-use-it

此 PreUpgradeTasksMBean OSGI元件已預先設定升級前維護任務清單，可一次執行所有任務。 您可以依照下列程式來設定工作：

  1. 瀏覽至 https://serveraddress:serverport/system/console/configMgr

  2. 搜索「預升級任務「 」，然後按一下第一個相符的元件。 元件的完整名稱為 com.adobe.aem.upgrade.prechecks.mbean.impl.PreUpgradeTasksMBeanImpl

  3. 修改需要運行的維護任務清單，如下所示：

    1487758925984

任務清單會因用於啟動實例的運行模式而異。 以下是每個維護任務的運行模式描述。

任務
執行模式
附註
TarIndexMergeTask
crx2
DataStoreGarbageCollectionTask
crx2
將執行標籤和掃描。 對於共用資料儲存區，請移除此步驟並執行
在執行前手動或正確準備執行個體。
ConsistencyCheckTask
crx2
WorkflowPurgeTask
crx2/crx3
在執行前，必須先設定AdobeGranite工作流程清除設定OSGi。
GenerateBundlesListFileTask
crx2/crx3
RevisionCleanupTask
crx3
對於AEM 6.0到6.2上的TarMK例項，請改為手動執行離線修訂清除。
com.day.cq.audit.impl.AuditLogMaintenanceTask
crx3
運行前必須配置審核日誌清除計畫程式OSGi配置。
CAUTION
DataStoreGarbageCollectionTask 正在調用帶有標籤和掃描階段的「資料儲存垃圾收集」操作（如果使用）。 對於使用共用資料存放區的部署，請務必重新設定或正確準備執行個體，以避免刪除其他執行個體所參考的項目。 這可能需要在觸發此升級前任務之前，在所有實例上手動運行標籤階段。

升級前運行狀況檢查的預設配置 default-configuration-of-the-pre-upgrade-health-checks

此 PreUpgradeTasksMBeanImpl OSGI元件已預先設定升級前健康狀態檢查標籤清單，以在 runAllPreUpgradeHealthChecks 方法呼叫：

  • 系統 - granite維護狀況檢查所使用的標籤

  • 預升級 — 這是自訂標籤，可新增至您可設定在升級前執行的所有健全狀態檢查

清單是可編輯的。 您可以使用加號 (+) 減 (-) 按鈕，以新增更多自訂標籤，或移除預設標籤。

MBean方法

可使用 JMX控制台.

您可以通過以下方式訪問MBean:

  1. 前往JMX主控台，網址為 https://serveraddress:serverport/system/console/jmx

  2. 搜尋 PreUpgradeTasks 然後按一下結果

  3. 從 操作 區段，然後選取 叫用 中。

以下列出 PreUpgradeTasksMBeanImpl 公開：

方法名稱
類型
說明
getAvailablePreUpgradeTasksNames()
資訊
顯示可用的升級前維護任務名稱清單。
getAvailablePreUpgradeHealthChecksTagNames()
資訊
顯示升級前運行狀況檢查標籤名稱的清單。
runAllPreUpgradeTasks()
動作
運行清單中的所有升級前維護任務。
runPreUpgradeTask(preUpgradeTaskName)
動作
以參數指定的名稱運行升級前維護任務。
isRunAllPreUpgradeTaskRunning()
ACTION_INFO
檢查 runAllPreUpgradeTasksmaintenance 任務當前正在運行。
getAnyPreUpgradeTaskRunning()
ACTION_INFO
檢查當前是否有任何預升級維護任務正在運行，
返回包含當前運行任務名稱的陣列。
getPreUpgradeTaskLastRunTime(preUpgradeTaskName)
動作
顯示升級前維護任務的確切運行時間，並將名稱指定為參數。
getPreUpgradeTaskLastRunState(preUpgradeTaskName)
動作
顯示升級前維護任務的最後運行狀態，並將名稱指定為參數。
runAllPreUpgradeHealthChecks(shutDownOnSuccess)
動作

運行所有預升級運行狀況檢查，並將其狀態保存在名為的檔案中 preUpgradeHCStatus.properties 位於sling首頁路徑中。 若 shutDownOnSuccess 參數設為 true，則AEM執行個體將會關閉，但唯有所有預先升級的健全狀態檢查都具備「確定」狀態時。

屬性檔案將用作將來任何升級的前提條件
如果升級前運行狀況檢查，則升級過程將停止
執行失敗。 如果要忽略預升級的結果
無論如何，運行狀況檢查並啟動升級，您都可以刪除該檔案。

detectUsageOfUnavailableAPI(aemVersion)
動作
列出在
升級至指定的AEM版本。 目標AEM版本必須
參數。
NOTE
MBean方法可通過以下方式調用：
  • JMX控制台
  • 連接到JMX的任何外部應用程式
  • cURL

停用自訂登入模組 disable-custom-login-modules

NOTE
只有從AEM 5版本升級時才需要此步驟。 您可以完全略過此選項，以從舊版AEM 6升級。

自訂方式 LoginModules 已設定為在存放庫層級進行驗證，但Apache Oak已根本變更。

在使用CRX2設定的AEM版本中， repository.xml 檔案，但從AEM 6開始，可透過Web主控台在Apache Felix JAAS Configuration Factory服務中完成。

因此，升級後必須停用任何現有設定，並針對Apache Oak重新建立。

若要停用JAAS設定中定義的自訂模組，請執行以下操作： repository.xml，您需要修改設定以使用預設值 LoginModule，如此範例：

<Security >
             ....
          <!--
                 Use LoginModule authenticating against repository itself
                 -->
                 <LoginModule class = "com.day.crx.core.CRXLoginModule" >
                     <param name = "anonymousId" value = "anonymous" />
                     <param name = "adminId" value ="admin" />
                     <param name = "disableNTLMAuth" value = "true" />
                     <param name = "tokenExpiration" value = "43200000" />
                     <!-- param name="trust_credentials_attribute" value="d5b9167e95dad6e7d3b5d6fa8df48af8"/
                -->
                 </LoginModule >
         </ Security>
NOTE
如需詳細資訊，請參閱 使用外部登錄模組進行身份驗證.
例如 LoginModule 在AEM 6中進行設定，請參閱 使用AEM 6配置LDAP.

從/install目錄中刪除更新 remove-updates-install-directory

NOTE
關閉AEM執行個體後，僅從crx-quickstart/install目錄中移除套件。 這是開始就地升級程式之前的最後步驟之一。

移除透過 crx-quickstart/install 目錄。 這可避免更新完成後，無意中將舊的Hotfix和Service Pack安裝在新的AEM版本之上。

停止任何冷備用實例 stop-tarmk-coldstandby-instance

如果使用TarMK冷備，請停止任何冷備實例。 這將保證在升級中出現問題時，能以有效的方式重新上線。 成功完成升級後，需要從升級的主實例重建冷備用實例。

停用自訂排程作業 disable-custom-scheduled-jobs

停用應用程式程式碼中包含的任何OSGi排程作業。

執行離線修訂清除 execute-offline-revision-cleanup

NOTE
此步驟僅對TarMK安裝是必要的

若使用TarMK，您應在升級前執行離線修訂清除。 這將使儲存庫遷移步驟和後續升級任務的執行速度更快，並有助於確保升級完成後線上修訂清除能夠成功執行。 如需執行離線修訂清除的詳細資訊，請參閱 執行離線修訂清除.

執行資料儲存垃圾收集 execute-datastore-garbage-collection

NOTE
只有執行crx3的例項才需要此步驟

在CRX3例項上執行修訂清除後，您應執行「資料存放區垃圾收集」以移除資料存放區中任何未參考的Blob。 如需指示，請參閱 資料儲存垃圾收集.

刪除可能阻礙升級的用戶 delete-users-that-might-hinder-the-upgrade

NOTE
只有符合以下條件時才需要此升級前維護任務：
  • 您從AEM 6.3之前的版本升級
  • 在升級期間，您會遇到下列任何錯誤。

有些特殊情況下，服務使用者最終可能會遇到較舊的AEM版本，而未正確標示為一般使用者。

如果發生此情況，升級會失敗並出現下列訊息：

ERROR [Apache Sling Repository Startup Thread] com.adobe.granite.repository.impl.SlingRepositoryManager Exception in a SlingRepositoryInitializer, SlingRepository service registration aborted
java.lang.RuntimeException: Unable to create service user [communities-utility-reader]:java.lang.RuntimeException: Existing user communities-utility-reader is not a service user.

若要解決此問題，請務必執行下列動作：

若要解決此問題，請務必執行下列動作：

  • 將執行個體與生產流量分離

  • 建立導致問題的用戶的備份。 您可以透過套件管理器完成此操作。 如需詳細資訊，請參閱 如何使用套件.

  • 刪除導致問題的用戶。 以下是可能屬於此類別的使用者清單：

    • dynamic-media-replication
    • communities-ugc-writer
    • communities-utility-reader
    • communities-user-admin
    • oauthservice
    • sling-scripting

視需要升級資料庫架構 upgrade-the-database-schema-if-needed

通常，用於永續性的基礎Apache Oak stack AEM會視需要負責升級資料庫架構。

但是，當無法自動升級架構時，可能會發生案例。 這些環境大多是高安全性的，資料庫在權限非常有限的用戶下運行。 如果發生此情況，AEM將繼續使用舊結構。

為避免發生此情況，您需依照下列程式升級結構：

  1. 關閉需要升級的AEM執行個體。

  2. 升級資料庫架構。 請查閱資料庫類型的文檔，以了解實現此目標所需的工具。

    如需Oak如何處理架構升級的詳細資訊，請參閱 Apache網站上的此頁面.

  3. 繼續升級AEM。

旋轉日誌檔案 rotate-log-files

建議您在開始升級之前先封存目前的記錄檔。 這樣，在升級期間和升級後就能更輕鬆地監視和掃描日誌檔案，以識別和解決可能發生的任何問題。

recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56