无法启动Enterprise Search 8.6.2的问题求助

问题概述 #

• Elasticsearch 8.6.2运行正常，Kibana 8.6.2可正常登录Web UI
• Enterprise Search 8.6.2无法启动，app-server.log显示程序尝试连接http://localhost:5601，但所有YML配置已替换为服务器IP，所有服务部署在同一服务器

关键日志片段 #

[2023-04-24T22:39:49.489+00:00][95252][4004][app-server][INFO]: [pre-flight] Elasticsearch will be used for authentication
[2023-04-24T22:39:49.495+00:00][95252][4004][app-server][INFO]: Elasticsearch looks healthy and configured correctly to run Enterprise Search
[2023-04-24T22:39:49.496+00:00][95252][4004][app-server][INFO]: Performing pre-flight checks for Kibana running on http://localhost:5601...
[2023-04-24T22:39:49.806+00:00][95252][4004][es][DEBUG]: {
  "request": {
    "url": "http://localhost:5601/api/status",
    "method": "get",
    "headers": {
      "Authorization": "[FILTERED]",
      "Content-Type": "application/json",
      "User-Agent": "Faraday v1.10.2"
    },
    "params": null,
    "body": null
  },
  "exception": "/usr/share/enterprise-search/lib/war/lib/middleware/request_logging_middleware.class:55: Connect to localhost:5601 [localhost/127.0.0.1, localhost/0:0:0:0:0:0:0:1] failed: Connection refused (Connection refused) (Faraday::ConnectionFailed)\n",
  "duration": 302.5,
  "stack": [
    "/usr/share/enterprise-search/lib/war/shared_togo/lib/shared_togo/kibana_checks.class:79:in `check_kibana_connection_with_retries!'",
    "/usr/share/enterprise-search/lib/war/shared_togo/lib/shared_togo/kibana_checks.class:34:in `check_kibana_connection!'",
    "/usr/share/enterprise-search/lib/war/shared_togo/lib/shared_togo/kibana_checks.class:18:in `block in run!'",
    "/usr/share/enterprise-search/lib/war/shared_togo/lib/shared_togo/kibana_checks.class:17:in `run!'",
    "/usr/share/enterprise-search/lib/war/shared_togo/lib/shared_togo/kibana_checks.class:13:in `run!'",
    "/usr/share/enterprise-search/lib/war/shared_togo/lib/shared_togo.class:313:in `configure_kibana!'",
    "/usr/share/enterprise-search/lib/war/shared_togo/lib/shared_togo.class:271:in `configure!'",
    "/usr/share/enterprise-search/lib/war/config/application.class:20:in `<main>'",
    "/usr/share/enterprise-search/lib/war/config/application.rb:1:in `<main>'",
    "/usr/share/enterprise-search/lib/war/shared_togo/lib/shared_togo/cli/command.class:36:in `initialize'",
    "/usr/share/enterprise-search/lib/war/shared_togo/lib/shared_togo/cli/command.class:10:in `new'",
    "/usr/share/enterprise-search/lib/war/shared_togo/lib/shared_togo/cli/command.class:10:in `run_and_exit'",
    "/usr/share/enterprise-search/lib/war/shared_togo/lib/shared_togo/cli.class:148:in `run_supported_command'",
    "/usr/share/enterprise-search/lib/war/shared_togo/lib/shared_togo/cli.class:130:in `run_command'",
    "/usr/share/enterprise-search/lib/war/shared_togo/lib/shared_togo/cli.class:112:in `run!'",
    "bin/enterprise-search-internal:15:in `<main>'"
  ]
}
[2023-04-24T22:39:49.807+00:00][95252][4004][app-server][WARN]: [pre-flight] Failed to connect to Kibana backend. Make sure it is running and healthy.
[2023-04-24T22:39:49.811+00:00][95252][4004][app-server][DEBUG]: [pre-flight] Kibana connection error: /usr/share/enterprise-search/lib/war/shared_togo/lib/shared_togo/kibana_checks.class:128: Connect to localhost:5601 [localhost/127.0.0.1, localhost/0:0:0:0:0:0:0:1] failed: Connection refused (Connection refused) (Faraday::ConnectionFailed)

排查步骤 #

1. 确认Enterprise Search的Kibana地址配置 #

打开Enterprise Search的enterprise-search.yml配置文件，添加或修改以下参数：

kibana.host: "http://你的服务器IP:5601"

若Kibana启用HTTPS，需改为https://开头，并配置证书相关参数（如kibana.ssl.certificate_authorities指定CA证书路径）。

2. 检查环境变量是否强制覆盖配置 #

Enterprise Search优先读取环境变量，执行以下命令检查是否存在冲突的环境变量：

echo $ENT_SEARCH_KIBANA_HOST

如果输出为http://localhost:5601，需清空该变量或设置为正确IP后重启服务：

# 临时清空（仅当前会话有效）
unset ENT_SEARCH_KIBANA_HOST
# 永久修改需编辑环境变量配置文件（如/etc/profile或~/.bashrc）

3. 验证Kibana监听地址 #

检查Kibana的kibana.yml，确保server.host未限制为localhost：

server.host: "你的服务器IP"
# 或者允许所有IP访问
server.host: "0.0.0.0"

修改后重启Kibana，在服务器本地执行测试：

curl http://你的服务器IP:5601/api/status

若返回正常JSON状态，说明Kibana可通过服务器IP访问；若失败，检查防火墙/安全组是否开放5601端口。

4. 确认Enterprise Search加载正确配置文件 #

启动Enterprise Search时，确保指定了修改后的配置文件路径：

bin/enterprise-search --path.config /path/to/your/config/directory

未指定时默认读取安装目录下的config/enterprise-search.yml，需确认该文件已更新Kibana地址。

5. 清理缓存残留（可选） #

若之前配置过localhost，可能存在缓存残留，停止服务后清理缓存目录：

rm -rf /usr/share/enterprise-search/data/cache/*

清理完成后重新启动Enterprise Search。

内容的提问来源于stack exchange，提问作者Neil Maffitt