UBTurbo 配置说明 ​

配置原则说明 ​

1. UBTurbo 的配置能力通过文件的方式暴露，配置文件安装目录为 /opt/ubturbo/conf/。

2. UBTurbo 配置文件采用 ini 风格的键值对格式：

   • 由键（key）和值（value）构成，每行一条
   • 每个键值对用等号（=）进行连接；左边为键，作为配置项的名称；右边为值，作为配置项内容
   • 以 # 开头的行视为注释；空行将被忽略

3. 配置按职责分为多个文件，各文件独立维护：

   配置文件	作用	读取时 section 名
   ubturbo.conf	主进程配置（日志等级等）	ubturbo
   ubturbo_plugin_admission.conf	插件准入白名单（决定加载哪些插件）	—
   plugin_rmrs.conf	RMRS 插件配置	plugin_rmrs
   plugin_turbo_ucache.conf	UCache 插件配置	plugin_turbo_ucache
   smap/period.config	SMAP 策略配置（扫描/迁移周期、冷热阈值等）	—（SMAP 自有解析器，扁平键值，无 section）

   说明

   上述前 4 个文件由 UBTurbo 框架的 TurboConfManager 统一加载，采用「section + key」定位；smap/period.config 由 SMAP 自身的策略解析器（StrategyConfigRead）按行匹配键名读取，不走 section 机制，详见下文「SMAP 策略配置说明」。

4. 配置项读取采用「section + key」定位：TurboConfManager::Init 在启动时加载主配置、准入白名单及各 plugin_*.conf；运行代码通过 UBTurboGetStr / UBTurboGetUInt32 / UBTurboGetBool / UBTurboGetFloat / UBTurboGetUInt64 等 API 按 section 与 key 读取。

5. UBTurbo 默认不启用任何插件。如需启用插件，必须在 ubturbo_plugin_admission.conf 中取消对应插件项的注释（#），并保证对应插件已安装且其 plugin_*.conf 配置完成，否则 UBTurbo 启动异常。

6. 修改任一配置文件后，需重启 ubturbo 服务生效：systemctl restart ubturbo。

UBTurbo 各配置文件样例如下：

# ===== ubturbo.conf =====
log.level=INFO

# ===== ubturbo_plugin_admission.conf =====
# code 必须大于200
#rmrs=777
#turbo_ucache=778

# ===== plugin_rmrs.conf =====
turbo.plugin.name=rmrs
turbo.plugin.pkg=librmrs_ubturbo_plugin.so
rmrs.ucache.enable=false

# ===== plugin_turbo_ucache.conf =====
turbo.plugin.name=ucache
turbo.plugin.pkg=libucache_os_turbo_plugin.so
migrate.migrateInterval=1000

# ===== smap/period.config =====
smap.scan.period = 200
smap.migrate.period = 2000
smap.slow.threshold = 2
smap.remote.freq.percentile = 99
smap.freq.wt = 0
smap.remote.hot.threshold = 65535
smap.group.swap.ratio = 1
smap.group.swap.min.remote.freq = 0
smap.group.swap.min.freq.gain = 0
smap.group.swap.local.watermark.ratio = 95
smap.migrate.mode = 1
smap.migrate.mode.enable = false
smap.zero.freq.migrate.enable = true
smap.adaptive.ratio.enable = true
smap.period.file.config.switch = false
smap.scan.cpu = 0-127
smap.ub.bw.threshold = 0

主进程配置说明 ​

配置文件：ubturbo.conf section 取值：ubturbo

配置项说明：

插件准入配置说明 ​

配置文件：ubturbo_plugin_admission.conf 作用：声明 UBTurbo 启动时通过 dlopen 加载的插件清单。仅在此文件中登记（且未注释）的插件才会被加载并调用其 TurboPluginInit(moduleCode) 入口。

格式为 插件名=moduleCode，每行一条，# 开头为注释（即不启用该插件）。

RMRS 插件配置说明 ​

配置文件：plugin_rmrs.conf section 取值：plugin_rmrs

配置项说明：

UCache 插件配置说明 ​

配置文件：plugin_turbo_ucache.conf section 取值：plugin_turbo_ucache

配置项说明：

SMAP 策略配置说明 ​

配置文件：smap/period.config（路径 /opt/ubturbo/conf/smap/period.config） 作用：SMAP 分层内存引擎的扫描与迁移策略参数。

扫描与迁移周期 ​

冷热识别与频率 ​

分组交换策略 ​

用于多 local NUMA 共用同一远端 NUMA 时，按分组批次交错执行冷热页面交换，避免单次迁移冲击过大。

迁移方式 ​

功能使能开关 ​

扫描 CPU 与 UB 带宽 ​

配置示例 ​

启用 RMRS 插件（虚拟化场景） ​

1. 编辑 /opt/ubturbo/conf/ubturbo_plugin_admission.conf，取消 RMRS 注释：

   shell

   # code 必须大于200
   rmrs=777
   #turbo_ucache=778

2. 确认 /opt/ubturbo/conf/plugin_rmrs.conf：

   shell

   turbo.plugin.name=rmrs
   turbo.plugin.pkg=librmrs_ubturbo_plugin.so
   rmrs.ucache.enable=false

3. 调整日志等级（可选），编辑 /opt/ubturbo/conf/ubturbo.conf：

   shell

   log.level=INFO

4. 重启服务使配置生效：

   shell

   systemctl restart ubturbo

同时启用 RMRS 与 UCache 插件 ​

1. 编辑 /opt/ubturbo/conf/ubturbo_plugin_admission.conf：

   shell

   # code 必须大于200
   rmrs=777
   turbo_ucache=778

2. 确认 /opt/ubturbo/conf/plugin_turbo_ucache.conf：

   shell

   turbo.plugin.name=ucache
   turbo.plugin.pkg=libucache_os_turbo_plugin.so
   # 迁移周期，单位毫秒
   migrate.migrateInterval=1000

3. 重启服务：

   shell

   systemctl restart ubturbo