升级手册
View as Markdown

升级手册 #

Easysearch 版本升级与迁移指南。

升级文档 #

升级前建议 #

  1. 查阅目标版本的 发布日志，了解变更与破坏性更新
  2. 在测试环境验证升级流程
  3. 做好数据备份

升级到 2.5.0：JDK 与 JVM 安全配置 #

Easysearch 2.5.0 默认使用并推荐 JDK 25，Bundle 包默认内置 JDK 25。 对于已部署 JDK 21 且暂不方便升级 JDK 的客户环境，保留 JDK 21 兼容运行能力。 安全 agent 在 JDK 21 及以上统一加载，并要求禁用 JDK 自身的 SecurityManager。 JDK 26、27 已通过发行包实际启动验证，可正常运行；切换 JDK 时仍需同步下述必要启动参数。 详见安装指南。

如果升级时保留了旧的 config/jvm.options、config/jvm.options.d/*.options 或自定义 ES_PATH_CONF， 需对照新发行包逐项同步必要参数，不能只替换程序文件：

  1. 保留 -Djava.security.manager=disallow，移除旧的 allow、启用 SecurityManager 的参数及其他冲突覆盖。 也检查 ES_JAVA_OPTS 等额外参数。启动时会检查该属性严格为 disallow 且没有安装 JDK SecurityManager，否则拒绝启动。

  2. 将旧的 21:、25: 两条 agent 配置替换为新包的单条 21-: 配置，并同步 jar 文件名：

    21-:-javaagent:lib/easysearch-security-agent-2.5.0.jar

    21-: 在 JDK 21 及以上生效。移除旧的重复引用，并检查 jvm.options.d/ 和 ES_JAVA_OPTS， 确保每次启动只加载一个安全 agent。保留随包提供的 bootstrap jar，避免混用旧版本文件。 Windows NIO Selector 临时 socket 清理权限修复还涉及核心程序和相关模块策略，需使用配套的完整发行包， 不能仅替换 agent jar 或修改 jvm.options。

  3. 保留新包的 21-:--enable-preview、19-:--enable-native-access=ALL-UNNAMED 等必要 JVM 参数， 再迁移自定义堆大小、GC 日志路径等配置。不要直接用旧配置覆盖新包配置。 JVMCI 编译器相关的解锁、禁用及重新锁定三行使用 21-26: 条件；JDK 27 不再识别 UseJVMCICompiler， 旧的 21-:-XX:-UseJVMCICompiler 会导致 JVM 启动失败。

  4. 确认实际选中的 JDK。Linux/macOS 启动器使用 jdk/ > ES_JAVA_HOME > JAVA_HOME； Windows bin\easysearch.bat 使用 jdk/ > JAVA_HOME。已有 jdk/ 时，仅设置环境变量不会切换运行时。

启动后可核对各节点实际运行时：

# 使用现有管理员密码
curl -ku 'admin:YOUR_PASSWORD' 'https://localhost:9200/_cat/nodes?h=name,jdk&v'

升级时保留原有数据目录、认证与 TLS 配置；上述 JVM 安全配置不要求重新生成证书或管理员密码。 security.enabled: false 也不会关闭安全 agent 或取消 SecurityManager 禁用校验。 详细参数与安全检查范围见JVM 配置。

©INFINI.LTD, All Rights Reserved.