桥梁配置（bridge.ncconf）

此 网桥.ncconf 该文件包含所有已注册用于多站点复制的网桥的信息，包括其关联的节点、拓扑设置（例如主动或被动模式）、通信参数和连接的缓存。此文件随附于安装包中。 NCache 每当通过以下方式添加或配置桥接器时，都会自动更新： NCache 管理中心。

所有与桥接相关的配置都保存在一个单独的系统中。 网桥.ncconf 文件用于确保复制设置的一致性。用户可以通过以下方式修改 Bridge 设置： NCache 管理中心或通过编辑 网桥.ncconf 直接存档。

注意：

该文件位于 %NCHOME%\config 在Windows中或 /opt/ncache/config 在Linux中。

桥接配置语法

下面对 Bridge 配置文件进行解释。

<configuration>
  <bridge-config config-id="64e33aab-966c-4ff3-a51e-05cfb77f6fc4" config-version="0" deployment-version="0" id="myBridge" bridge-nodes="20.200.20.39" num-bridge-nodes="1" bridge-active="20.200.20.39" bridge-port="10000" opt-timeout="60" src-cache="" topology="active-active" replicator-virtual-queue-size="2048MB" auto-start="False">
    <log enabled="True" trace-errors="True" trace-notices="False" trace-warnings="False" trace-debug="False"/>
    <queue optimized="False" size="2048"/>
    <perf-counter enabled="True"/>
  </bridge-config>
</configuration>

了解桥接配置标签

以下部分解释了文件语法中提到的标签。

<bridge-config config-id="64e33aab-966c-4ff3-a51e-05cfb77f6fc4" config-version="0" deployment-version="0" id="myBridge" bridge-nodes="20.200.20.39" num-bridge-nodes="1" bridge-active="20.200.20.39" bridge-port="10000" opt-timeout="60" src-cache="" topology="active-active" replicator-virtual-queue-size="2048MB" auto-start="False">

  • 配置 ID：标识 Bridge 缓存配置。

  • 配置版本：指定 Bridge 配置的更新次数，保持所有节点的版本一致性。

  • 部署版本：指定对 Bridge 部署所做的更改数量，确保所有节点的版本一致性。

  • id：指定一个唯一的ID来标识Bridge缓存。

  • 桥节点：指定配置了网桥的服务器节点的 IP 地址或以逗号分隔的 IP 地址列表。

  • 桥节点数：确定组成网桥的服务器数量。

  • 桥主动：指定活动桥接节点的 IP 地址。

  • 桥口：Bridge 所在的端口号。

  • 选择超时：指定 Bridge 认为自身与已连接缓存断开连接的时间。默认值为 60 seconds.

  • src-缓存：指定 Bridge 从中复制数据的源缓存名称。

  • 拓扑：指定桥接拓扑结构，例如： active-active or active-passive.

  • 复制器虚拟队列大小：用于将数据从 Bridge 复制到目标缓存的复制器的虚拟队列的大小。默认大小为 2048 MB.

  • 自动开启：设置为 True 时，服务重启时会自动启动 Bridge。默认值为 False.

NCache 维护一个日志文件来写入跟踪信息和调试目的。 NCache 提供不同类型的跟踪，如上面的 XML 标签所示。用户可以使用这些标签启用/禁用各种跟踪。默认情况下，仅显示跟踪信息。 Error 错误跟踪已启用，其余跟踪已禁用。错误跟踪不会影响缓存性能，但对于其他跟踪，我们建议不要在生产环境中启用，因为它们会影响性能。 NCache每个缓存的日志文件都会在以下位置创建： %NCHOME%\log-files 在 Windows 和 /opt/ncache/log-files 适用于 Linux，其中包含与已启用跟踪相关的信息。 

<log enabled="True" trace-errors="True" trace-notices="False" trace-warnings="False" trace-debug="False"/>

  • 启用：指定是否为桥接器启用日志记录。如果设置为 True， NCache 根据配置的跟踪级别记录 Bridge 日志消息。如果设置为 False，则禁用 Bridge 日志记录。默认情况下，此项为启用。 True.

  • 跟踪错误：记录错误痕迹，这对于识别和排除关键问题至关重要。默认情况下， True.

  • 跟踪通知：记录一般信息性消息的通知跟踪。默认情况下， False.

  • 跟踪警告：记录警告跟踪，有助于检测和解决潜在问题。默认情况下， False.

  • 跟踪调试：记录详细的调试跟踪信息，有助于在开发或测试期间诊断问题并分析系统行为。默认情况下， False.

此标签定义了用于复制操作的桥接队列设置。

<queue optimized="False" size="2048"/>

  • 优化：设置为 True 时，启用 Bridge 队列优化。默认情况下， False.

  • 尺寸：指定桥接队列的最大大小（以 MB 为单位）。队列中的项目数受配置的队列大小和可用内存量的限制。默认值为 2048.

此标签控制是否 NCache 发布 Bridge 的性能监视器计数器。

<perf-counter enabled="True"/>
  • 启用：指定是否为桥接器启用性能监视器计数器。如果设置为 True， NCache 发布 Bridge PerfMon 计数器以进行监控。

<cache cache-id="demoClusteredCache.WestCoast" status="active" bulk-operation-size="500" enable-compression="False" connection-retry-interval="3" heart-beat-enabled="True" replicator-virtual-queue-size="2048MB" is-connected="True" is-master="False"/>

  • 缓存 ID：指定一个唯一 ID 来标识连接到 Bridge 的缓存。

  • 服务器：指定 Bridge 用于连接缓存的缓存服务器端点。这可以是服务器 IP 地址、主机名或负载均衡器端点。

  • 状态：确定连接到网桥的缓存状态。根据所选拓扑，缓存状态可以是主动或被动。

  • 批量操作大小：指定要在目标缓存上复制的捆绑操作的大小上限。默认大小为 500.

  • 启用压缩允许您在向目标缓存发送操作时启用压缩。默认值为 False.

  • 连接重试间隔：指定 Bridge 尝试重新连接到已连接缓存时，两次连续重试之间的间隔。默认值为 3.

  • 心跳启用：指定是否对连接的缓存启用心跳监控。

  • 复制器虚拟队列大小：指定用于将数据从 Bridge 复制到目标缓存的复制器的虚拟队列的大小。默认大小为 2048 MB.

  • 已连接：指定缓存是否连接到 Bridge。

  • 是主：指定连接的缓存是否在主动-被动桥接拓扑中充当主缓存。设置为 True 时，此缓存负责将复制操作发送到目标（被动）缓存。

此标签在以下情况下指定： <cache> 标签并定义 Bridge 使用的缓存端点。

<server name="20.200.20.40" is-load-balancer="False"/>

  • 姓名：指定缓存服务器 IP 地址、主机名或负载均衡器端点。

  • 负载均衡器：指定是否提供以下值 name 表示负载均衡器端点。将此值设置为 True 如果网桥通过负载均衡器连接到缓存。

参见

缓存配置
客户端配置
安全配置