# 版本升级问题

本文档主要介绍低版本向高版本升级中可能会影响正常运行的差异点，及影响，并标明变更方式。

# 1.0.x版本 向 1.1.x版本升级

# 一、核心服务开关控制配置变化

# 差异

• 1.0.x版本核心服务控制配置，通过黑名单机制控制核心服务加载，来达到开启和关闭核心服务的目的。

• 1.1.x版本核心服务控制配置，针对各核心服务新增开关（默认为关），更易于控制。

agent.service.heartbeat.enable=false
agent.service.gateway.enable=false
agent.service.tracing.enable=false
agent.service.visibility.enable=false
agent.service.inject.enable=true
agent.service.dynamic.config.enable=true

# 影响

版本升级后，不进行配置更新，会导致核心服务无法正常开启，例如默认关闭的动态配置服务，心跳服务等。

# 变更

需要将 agent.config.serviceBlackList配置替换为针对各核心服务的独立配置，按照 差异 中1.1.x版本进行配置，如需开启某一核心服务，则配置为true。

# 二、Bytebuddy日志&字节码输出配置变化

# 差异

• 1.0.x版本中的Bytebuddy日志输出控制配置 agent.config.isShowEnhanceLogEnable ，字节码输出配置 agent.config.enhancedClassOutputPath，此配置为空则关闭字节码输出，如果配置路径则开启字节码输出到指定路径。
• 1.1.x版本中的Bytebuddy日志输出控制配置agent.config.isShowEnhanceLog，通过agent.config.isOutputEnhancedClasses控制字节码输出配置开启和关闭，默认输出到agent/enhancedClasses目录下，以时间戳区分不同批次的字节码增强结果，如果需要指定自定义输出路径，则通过agent.config.enhancedClassesOutputPath来配置。

# 影响

版本升级后，不进行配置更新，会导致Bytebuddy日志无法正常输出，增强后的字节码无法正常输出。

# 变更

• 需要将 agent.config.isShowEnhanceLogEnable 配置修改为agent.config.isShowEnhanceLog，并且配置其值为true来正常开启Bytebuddy日志输出。
• 需要将 agent.config.enhancedClassOutputPath配置修改为agent.config.isOutputEnhancedClasses，并且配置其值为true来正常开启增强后的字节码输出。如需指定自定义目录，还需添加配置agent.config.enhancedClassesOutputPath，其值为自定义路径。

# 三、连接Backend配置变化

# 差异

• 1.0.x版本中针对连接Backend时的配置

  # backend config
  backend.nettyIp=127.0.0.1
  backend.nettyPort=6888
  

• 1.1.x版本中针对连接Backend时的配置，变更配置前缀为 gateway，更贴合实现逻辑，避免被理解为通过该配置项来控制Backend组件，并且针对该能力提供了更多的可配置项

  # gateway config
  gateway.nettyIp=127.0.0.1
  gateway.nettyPort=6888
  gateway.nettyConnectTimeout=5000
  gateway.nettyWriteAndReadWaitTime=60000
  gateway.sendInternalTime=10
  gateway.initReconnectInternalTime=5
  gateway.maxReconnectInternalTime=180
  

# 影响

版本升级后，不进行配置更新，会导致无法连接Backend。

# 变更

需要将1.0.x版本中的Backend配置修改为1.1.x版本中的Gateway配置

# 四、标签路由配置模型变化

# 差异

• 1.0.x版本仅支持基于流量的路由规则配置

• 1.1.x版本中新增了路由规则的类型标识（flow、tag、lane），可单独配置也可同时配置，其中flow类型为1.0.x版本中的机遇流量的路由规则配置模型

# 影响

1.1.x版本中，针对标签路由进行了配置模型的重构，提升了配置的灵活性和丰富度，版本升级后将，无法解析低版本的配置

# 变更

参照标签路由使用手册进行变更，本文不再赘述。