diff --git a/docs/ES/ES_9_本机安装记录.md b/docs/ES/ES_9_本机安装记录.md new file mode 100644 index 0000000..c03146f --- /dev/null +++ b/docs/ES/ES_9_本机安装记录.md @@ -0,0 +1,59 @@ +# Elasticsearch 9.3.1 本机安装记录 + +按 [ES_9](./ES_9) 文档在本机完成安装,数据与日志安装在 **/data** 目录下。 + +## 安装概要 + +| 项目 | 说明 | +|------|------| +| 版本 | Elasticsearch 9.3.1(APT 9.x 源) | +| 安装方式 | 官方 APT 源,二进制在 `/usr/share/elasticsearch` | +| 数据目录 | `/data/elasticsearch/data` | +| 日志目录 | `/data/elasticsearch/logs` | +| 配置 | `/etc/elasticsearch/elasticsearch.yml` | +| 模式 | 单机单节点 `discovery.type: single-node` | +| 安全 | `xpack.security.enabled: false`(开发环境) | +| HTTP | `http://0.0.0.0:9200` | +| Kibana | 9.3.1,`http://0.0.0.0:5601`,已安装并启用 | + +## 已执行步骤 + +1. 添加 ES 9.x APT 源与 GPG,`apt-get install elasticsearch` +2. 创建 `/data/elasticsearch/{data,logs}` 并 `chown elasticsearch:elasticsearch` +3. 配置 `elasticsearch.yml`:cluster、node、path.data/logs、network、discovery、security +4. JVM 堆:`/etc/elasticsearch/jvm.options.d/heap.options` 中 `-Xms4g -Xmx4g`(本机约 15GB 内存) +5. sysctl 与 limits 已按文档追加(vm.max_map_count、nofile、nproc、memlock 等) +6. `systemctl enable elasticsearch` 且 `systemctl start elasticsearch` +7. Kibana:`apt-get install kibana`,配置 `/etc/kibana/kibana.yml`(server.host: 0.0.0.0, elasticsearch.hosts: http://127.0.0.1:9200),`systemctl enable kibana` 且 `systemctl start kibana` + +## 验证 + +```bash +curl http://127.0.0.1:9200 +# 返回 cluster_name: searchengine-cluster, version.number: 9.3.1 +``` + +## 常用命令 + +```bash +# Elasticsearch +sudo systemctl status elasticsearch # 状态 +sudo systemctl start elasticsearch # 启动 +sudo systemctl stop elasticsearch # 停止 + +# Kibana +sudo systemctl status kibana +sudo systemctl start kibana +sudo systemctl stop kibana +``` + +## Kibana + +- **版本**:9.3.1(与 ES 同源) +- **配置**:`/etc/kibana/kibana.yml`(server.host: 0.0.0.0, server.port: 5601, elasticsearch.hosts: http://127.0.0.1:9200) +- **访问**:浏览器打开 `http://<本机IP>:5601`(ES 未开安全时可直接进入首页) + +## 与 SearchEngine 项目集成 + +- 环境变量或配置中 ES 地址:`ES_HOST=http://127.0.0.1:9200` +- 索引与导入:使用项目内 `mappings/search_products.json`(9.3 建议 bfloat16)及 `./scripts/ingest.sh` 等脚本。 diff --git a/docs/ES/elasticsearch-9-data-yml.txt b/docs/ES/elasticsearch-9-data-yml.txt new file mode 100644 index 0000000..d82d298 --- /dev/null +++ b/docs/ES/elasticsearch-9-data-yml.txt @@ -0,0 +1,29 @@ +# ======================== Elasticsearch 9.x - 单机单节点(数据在 /data) ========================= +# 按 docs/ES/ES_9 配置,适用于 SearchEngine 项目 + +# ---------------------------------- Cluster ----------------------------------- +cluster.name: searchengine-cluster + +# ------------------------------------ Node ------------------------------------ +node.name: node-1 + +# ----------------------------------- Paths ------------------------------------ +# 数据与日志安装到 /data 目录 +path.data: /data/elasticsearch/data +path.logs: /data/elasticsearch/logs + +# ---------------------------------- Network ----------------------------------- +network.host: 0.0.0.0 +http.port: 9200 + +# --------------------------------- Discovery ---------------------------------- +# 单机开发/生产单节点模式 +discovery.type: single-node + +# ---------------------------------- Security ---------------------------------- +# 开发环境关闭安全(与文档一致);生产请改为 true 并配置证书与用户 +xpack.security.enabled: false + +# 以下为可选性能调优(与 ES_9 第 11 节一致,可按机器内存调整) +# indices.fielddata.cache.size: 40% +# indices.queries.cache.size: 30% -- libgit2 0.21.2