如何使用TarMK冷备用运行AEM

简介

Tar微内核的冷备用容量允许一个或多个备用AEM实例连接到主实例。 同步过程只意味着它只从主实例到备用实例完成。

备用实例的目的是保证主控存储库的Live Data Copy，并确保在主控因任何原因不可用时快速切换，而不会丢失数据。

内容在主实例和备用实例之间线性同步，而无需进行任何完整性检查文件或存储库损坏。 由于这种设计，备用实例是主实例的精确副本，无法帮助缓解主实例上的不一致问题。

注意

“冷备用”功能用于保护​author​实例上需要高可用性的情况。 如果在使用Tar微内核的​publish​实例上需要高可用性，则Adobe建议使用发布场。

有关更多可用部署的信息，请参阅推荐部署页面。

工作原理

在主AEM实例上，打开一个TCP端口，该端口正在侦听传入消息。 目前，奴隶将向主控发送两种类型的消息：

  • 请求当前头的分段ID的消息
  • 请求具有指定ID的区段数据的消息

备用设备定期请求主设备当前头的段ID。 如果区段在本地未知，则将检索该区段。 如果已存在，则会比较区段，并在必要时也会请求引用的区段。

注意

待机实例无法接收任何类型的请求，因为它们仅在同步模式下运行。 备用实例上唯一可用的部分是Web控制台，以便于进行捆绑和服务配置。

典型的TarMK冷备用部署：

chlimage_1

其他特征

稳健性

数据流设计用于自动检测和处理连接和网络相关问题。 所有数据包都与校验和捆绑在一起，一旦连接或损坏数据包发生重试机制问题，就会立即触发。

演出

在主实例上启用TarMK冷备用对性能几乎没有可衡量的影响。 额外的CPU消耗非常低，额外的硬盘和网络IO不应产生和性能问题。

在待机状态下，在同步过程中，CPU消耗可能会很高。 由于该过程不是多线程的，因此无法通过使用多个内核来加速。 如果没有数据发生更改或传输，则将没有可衡量的活动。 连接速度将因硬件和网络环境而异，但不取决于存储库的大小或SSL的使用情况。 在估算初始同步所需的时间或在主节点上同时更改了大量数据时，应牢记这一点。

安全

假设所有实例都在同一内部网安全区域中运行，则安全违规的风险大大降低。 但是，您可以通过启用从服务器与主控之间的SSL连接来添加额外的安全层。 这样做可以降低中间人对数据造成损害的可能性。

此外，您还可以通过限制传入请求的IP地址来指定允许连接的备用实例。 这应有助于确保内联网中的任何人都无法复制存储库。

注意

建议在调度程序与作为Coldy Standby设置一部分的服务器之间添加负载平衡器。 应将负载平衡器配置为仅将用户流量定向到​primary​实例，以确保一致性，并防止内容通过Cold Standby机制以外的其他方式在备用实例上复制。

创建AEM TarMK冷备用设置

注意

与以前的版本相比，AEM 6.3中段节点存储和备用存储服务的PID发生了以下更改：

  • 来自org.apache.jackrabbit.oak。plugins.segment.standby.store.StandbyStoreService到org.apache.jackrabbit.oak.segment.standby.StandbyStoreService
  • 来自org.apache.jackrabbit.oak。plugins.segment.SegmentNodeStoreService到org.apache.jackrabbit.oak.segment.SegmentNodeStoreService

确保进行必要的配置调整以反映此更改。

要创建TarMK冷备用安装，首先需要通过执行主安装文件夹的整个文件系统副本到新位置来创建备用实例。 然后，您可以使用将指定其角色（primary或standby）的运行模式来启动每个实例。

以下是创建具有一个主控实例和一个备用实例的设置时需要遵循的过程：

  1. 安装AEM。

  2. 关闭实例，并将其安装文件夹复制到冷备用实例将从的位置。 即使从不同的计算机运行，也应确保为每个文件夹提供一个描述性名称（如​aem-primary​或​aem-standby），以区分实例。

  3. 转到主实例的安装文件夹，然后：

    1. 检查并删除您可能在aem-primary/crx-quickstart/install下拥有的任何以前的OSGi配置

    2. 在aem-primary/crx-quickstart/install下创建名为install.primary的文件夹

    3. 在aem-primary/crx-quickstart/install/install.primary下为首选节点存储和数据存储创建所需的配置

    4. 在同一位置创建名为org.apache.jackrabbit.oak.segment.standby.store.StandbyStoreService.config的文件，并相应地对其进行配置。 有关配置选项的更多信息，请参阅配置。

    5. 如果将AEM TarMK实例与外部数据存储一起使用，请在aem-primary/crx-quickstart/install下创建名为crx3的文件夹，名称为crx3

    6. 将数据存储配置文件放入crx3文件夹中。

    例如，如果您正在通过外部文件数据存储运行AEM TarMK实例，则需要以下配置文件：

    • aem-primary/crx-quickstart/install/install.primary/org.apache.jackrabbit.oak.segment.SegmentNodeStoreService.config
    • aem-primary/crx-quickstart/install/install.primary/org.apache.jackrabbit.oak.segment.standby.store.StandbyStoreService.config
    • aem-primary/crx-quickstart/install/crx3/org.apache.jackrabbit.oak.plugins.blob.datastore.FileDataStore.config

    下面将找到主实例的示例配置：

    示 例oforg.apache.jackrabbit.oak.segment.SegmentNodeStoreService.config

    org.apache.sling.installer.configuration.persist=B"false"
customBlobStore=B"true"
standby=B"false"

    org.apache.jackrabbit.oak.segment.standby.store.StandbyStoreService.config的示例

    org.apache.sling.installer.configuration.persist=B"false"
mode="primary"
port=I"8023"

    org.apache.jackrabbit.oak.plugins.blob.datastore.FileDataStore.config的示例

    org.apache.sling.installer.configuration.persist=B"false"
path="./crx-quickstart/repository/datastore"
minRecordLength=I"16384"

  4. 启动主运行模式，确保指定主运行模式：

    java -jar quickstart.jar -r primary,crx3,crx3tar

  5. 为​org.apache.jackrabbit.oak.segment​包创建新的Apache Sling日志记录记录器。 将日志级别设置为“Debug”，并将其日志输出指向单独的日志文件，如​/logs/tarmk-coldstandby.log。 有关更多信息，请参阅日志记录。

  6. 转到​standby​实例的位置，然后通过运行jar启动该实例。

  7. 创建与主日志记录配置相同的日志记录配置。 然后，停止实例。

  8. 接下来，准备备用实例。 为此，您可以执行与主实例相同的步骤：

    1. 删除您可能在aem-standby/crx-quickstart/install下拥有的任何文件。

    2. 在aem-standby/crx-quickstart/install下创建一个名为install.standby的新文件夹

    3. 创建两个名为的配置文件：

      • org.apache.jackrabbit.oak.segment.SegmentNodeStoreService.config
      • org.apache.jackrabbit.oak.segment.standby.store.StandbyStoreService.config

    4. 在aem-standby/crx-quickstart/install下创建一个名为crx3的新文件夹

    5. 创建数据存储配置，并将其放在aem-standby/crx-quickstart/install/crx3下。 在本例中，您需要创建的文件是：

      • org.apache.jackrabbit.oak.plugins.blob.datastore.FileDataStore.config

    6. 编辑文件并创建必要的配置。

    以下是典型备用实例的示例配置文件：

    org.apache.jackrabbit.oak.segment.SegmentNodeStoreService.config的示例

    org.apache.sling.installer.configuration.persist=B"false"
name="Oak-Tar"
service.ranking=I"100"
standby=B"true"
customBlobStore=B"true"

    org.apache.jackrabbit.oak.segment.standby.store.StandbyStoreService.config的示例

    org.apache.sling.installer.configuration.persist=B"false"
mode="standby"
primary.host="127.0.0.1"
port=I"8023"
secure=B"false"
interval=I"5"
standby.autoclean=B"true"

    org.apache.jackrabbit.oak.plugins.blob.datastore.FileDataStore.config的示例

    org.apache.sling.installer.configuration.persist=B"false"
path="./crx-quickstart/repository/datastore"
minRecordLength=I"16384"

  9. 使用备用运行模式启动​standby​实例：

    java -jar quickstart.jar -r standby,crx3,crx3tar

该服务也可以通过以下方式通过Web控制台进行配置：

  1. 转到Web控制台：https://serveraddress:serverport/system/console/configMgr
  2. 正在查找名为​Apache Jackrabbit Oak Segment Tar Cold Standby Service​的服务，并双击该服务以编辑设置。
  3. 保存设置并重新启动实例，以便新设置生效。
注意

您可以随时检查实例的角色，方法是在Sling设置Web控制台中检查存在​primary​或​standby​运行模式。

可以通过转到​https://localhost:4502/system/console/status-slingsettings​并检查​**"Run Modes"**​行来完成此操作。

首次同步

准备完成并首次启动备用后，当备用赶上主备用时，实例之间将会有大量网络流量。 您可以查阅日志来观察同步的状态。

在备用​tarmk-coldstandby.log​中，您将看到如下条目：

    *DEBUG* [defaultEventExecutorGroup-2-1] org.apache.jackrabbit.oak.segment.standby.store.StandbyStore trying to read segment ec1f739c-0e3c-41b8-be2e-5417efc05266

    *DEBUG* [nioEventLoopGroup-3-1] org.apache.jackrabbit.oak.segment.standby.codec.SegmentDecoder received type 1 with id ec1f739c-0e3c-41b8-be2e-5417efc05266 and size 262144

    *DEBUG* [defaultEventExecutorGroup-2-1] org.apache.jackrabbit.oak.segment.standby.store.StandbyStore got segment ec1f739c-0e3c-41b8-be2e-5417efc05266 with size 262144

    *DEBUG* [defaultEventExecutorGroup-2-1] org.apache.jackrabbit.oak.segment.file.TarWriter Writing segment ec1f739c-0e3c-41b8-be2e-5417efc05266 to /mnt/crx/author/crx-quickstart/repository/segmentstore/data00016a.tar

在备用的​error.log​中，您应会看到如下条目：

*INFO* [FelixStartLevel] org.apache.jackrabbit.oak.segment.standby.store.StandbyStoreService started standby sync with 10.20.30.40:8023 at 5 sec.

在上述日志代码片段中， 10.20.30.40​是主代码的IP地址。

在​primary tarmk-coldstandby.log​中，您将看到如下条目：

    *DEBUG* [nioEventLoopGroup-3-2] org.apache.jackrabbit.oak.segment.standby.store.CommunicationObserver got message ‘s.d45f53e4-0c33-4d4d-b3d0-7c552c8e3bbd’ from client c7a7ce9b-1e16-488a-976e-627100ddd8cd

    *DEBUG* [nioEventLoopGroup-3-2] org.apache.jackrabbit.oak.segment.standby.server.StandbyServerHandler request segment id d45f53e4-0c33-4d4d-b3d0-7c552c8e3bbd

    *DEBUG* [nioEventLoopGroup-3-2] org.apache.jackrabbit.oak.segment.standby.server.StandbyServerHandler sending segment d45f53e4-0c33-4d4d-b3d0-7c552c8e3bbd to /10.20.30.40:34998

    *DEBUG* [nioEventLoopGroup-3-2] org.apache.jackrabbit.oak.segment.standby.store.CommunicationObserver did send segment with 262144 bytes to client c7a7ce9b-1e16-488a-976e-627100ddd8cd

在这种情况下，日志中提到的“client”是​standby​实例。

在这些条目停止在日志中显示后，您可以安全地假定同步过程已完成。

虽然上述条目显示轮询机制运行正常，但在发生轮询时了解是否有任何数据正在同步通常非常有用。 为此，请查找如下条目：

*DEBUG* [defaultEventExecutorGroup-156-1] org.apache.jackrabbit.oak.segment.file.TarWriter Writing segment 3a03fafc-d1f9-4a8f-a67a-d0849d5a36d5 to /<<CQROOTDIRECTORY>>/crx-quickstart/repository/segmentstore/data00014a.tar

此外，当使用非共享FileDataStore运行时，如下消息将确认正确传输二进制文件：

*DEBUG* [nioEventLoopGroup-228-1] org.apache.jackrabbit.oak.segment.standby.codec.ReplyDecoder received blob with id eb26faeaca7f6f5b636f0ececc592f1fd97ea1a9#169102 and size 169102

配置

以下OSGi设置可用于冷备用服务：

  • 保留配置： 如果启用，则会将配置存储在存储库中，而不是传统的OSGi配置文件中。建议在生产系统上禁用此设置，以便备用系统不会拉取主配置。

  • 模式(mode): 这将选择实例的运行模式。

  • 端口（端口）： 用于通信的端口。默认为 8023.

  • 主主机(primary.host): — 主实例的主机。此设置仅适用于备用设备。

  • 同步间隔(interval): — 此设置确定同步请求之间的间隔，并且仅适用于备用实例。

  • 允许的IP范围(primary.allowed-client-ip-ranges): — 主要允许从中进行连接的IP范围。

  • 安全(secure): 启用SSL加密。要使用此设置，必须在所有实例上启用此设置。

  • 备用读取超时(standby.readtimeout): 从备用实例发出的请求超时（以毫秒为单位）。使用的默认值为60000（一分钟）。

  • 备用自动清理(standby.autoclean): 如果存储的大小在同步周期中增加，则调用清理方法。

注意

强烈建议主存储库ID和备用存储库ID不同，以便它们对于卸载等服务可单独不可识别。

确保覆盖此内容的最佳方法是删除备用文件上的​sling.id​文件并重新启动实例。

故障转移过程

如果主实例因任何原因失败，您可以设置其中一个备用实例，通过更改启动运行模式来承担主实例的角色，如下所述：

注意

还需要修改配置文件，以便它们与主实例使用的设置匹配。

  1. 转到安装备用实例的位置，然后停止该实例。

  2. 如果已使用设置配置了负载平衡器，则可以在此时从负载平衡器的配置中删除主。

  3. 从备用安装文件夹备份crx-quickstart文件夹。 在设置新待机时，可以将其用作起点。

  4. 使用primary运行模式重新启动实例：

    java -jar quickstart.jar -r primary,crx3,crx3tar

  5. 向负载平衡器中添加新的主。

  6. 创建并启动新的备用实例。 有关更多信息，请参阅上面创建AEM TarMK冷备用设置🔗中的过程。

对冷备用设置应用修补程序

将修补程序应用到冷备用安装程序的推荐方法是：将它们安装到主实例，然后将其克隆到新的冷备用实例，并安装修补程序。

您可以按照以下步骤操作：

  1. 通过转到JMX控制台并使用​org.apache.jackrabbit.oak来停止冷备用实例上的同步过程：状态（“备用”）​bean。 有关如何执行此操作的更多信息，请参阅Monitoring上的部分。
  2. 停止冷备用实例。
  3. 在主实例上安装修补程序。 有关如何安装修补程序的更多详细信息，请参阅如何使用包。
  4. 在安装后测试实例以了解问题。
  5. 通过删除其安装文件夹来删除冷备用实例。
  6. 停止主实例并克隆该实例，方法是将其整个安装文件夹的文件系统副本复制到冷备用位置。
  7. 重新配置新创建的克隆以充当冷备用实例。 有关更多详细信息，请参阅创建AEM TarMK冷备用设置。
  8. 启动主实例和冷备用实例。

监测

该功能使用JMX或MBean公开信息。 这样，您可以使用JMX控制台检查备用和主控的当前状态。 该信息可在名为Status的type org.apache.jackrabbit.oak:type="Standby"的MBean中找到。

备用

观察备用实例时，您将公开一个节点。 ID通常是通用UUID。

此节点具有五个只读属性：

  • Running: 布尔值，指示同步进程是否正在运行。

  • Mode: 客户：后跟用于标识实例的UUID。请注意，每次更新配置时，此UUID都会发生更改。

  • Status: 当前状态的文本表示形式( running 如 stopped或)。

  • FailedRequests:连续错误的数量。

  • SecondsSinceLastSuccess: 自上次与服务器成功通信后经过的秒数。如果未成功进行通信，则将显示-1。

还有三种可调用的方法：

  • start(): 启动同步过程。
  • stop(): 停止同步过程。
  • cleanup(): 在待机上运行清理操作。

主要

观察主设备会通过ID值为TarMK备用服务所使用的端口号的MBean公开一些常规信息（默认为8023）。 大多数方法和属性与备用方法相同，但有些方法和属性不同：

  • Mode: 将始终显示值 primary。

此外，可检索与主控连接的多达10个客户端（备用实例）的信息。 MBean ID是实例的UUID。 这些MBean没有可调用的方法，但有一些非常有用的只读属性：

  • Name: 客户端的ID。
  • LastSeenTimestamp: 文本表示形式中最后一个请求的时间戳。
  • LastRequest: 客户端的最后一个请求。
  • RemoteAddress: 客户端的IP地址。
  • RemotePort: 客户端用于最后一个请求的端口。
  • TransferredSegments: 传输到此客户端的区段总数。
  • TransferredSegmentBytes:传输到此客户端的总字节数。

冷备用存储库维护

修订版清理

注意

如果在主实例上运行联机修订版清理，则不需要执行下面介绍的手动过程。 此外，如果您使用联机修订版清理，则将自动对备用实例执行cleanup ()操作。

注意

请勿在备用系统上运行脱机修订版清理。 不需要它，也不会减小segmentstore大小。

Adobe建议定期运行维护，以防止存储库随时间的推移而过度增长。 要手动执行冷备用存储库维护，请执行以下步骤：

  1. 通过转到JMX控制台并使用​org.apache.jackrabbit.oak ，停止备用实例上的备用进程：状态("Standby") bean。 有关如何执行此操作的更多信息，请参阅上述Monitoring部分。

  2. 停止主AEM实例。

  3. 在主实例上运行oak压缩工具。 有关更多详细信息，请参阅维护存储库。

  4. 启动主实例。

  5. 使用第一步中所述的相同JMX Bean在备用实例上启动备用进程。

  6. 观看日志并等待同步完成。 此时，备用存储库可能会大幅增长。

  7. 使用第一步中所述的相同JMX Bean，在备用实例上运行cleanup()操作。

备用实例完成与主实例的同步可能比通常花费的时间长，因为离线压缩会有效地重写存储库历史记录，从而使计算存储库中的更改需要更长时间。 还应指出，此过程完成后，备用存储库的大小将与主存储库上的存储库的大小大致相同。

作为替代方法，在主存储库上运行压缩后，可以手动将主存储库复制到备用存储库，实际上每次压缩运行时都会重建备用存储库。

数据存储垃圾收集

对文件数据存储实例不时运行垃圾收集很重要，否则，已删除的二进制文件将保留在文件系统上，最终填满驱动器。 要运行垃圾收集，请按照以下步骤操作：

  1. 按照上面🔗部分中所述，运行冷备用存储库维护。

  2. 在维护过程完成且实例重新启动后：

    • 在主服务器上，通过相关的JMX Bean运行数据存储垃圾收集，如本文中所述。
    • 在待机状态下，数据存储垃圾收集只能通过​BlobGarbageCollection MBean - startBlobGC()进行。 备用时​RepositoryManagement MBean不可用。
    注意

    如果您未使用共享数据存储，则垃圾收集首先必须在主存储器上运行，然后在备用存储器上运行。

在此页面上