elasticsearch安装调研文档

### Elasticsearch 安装与配置详解 #### 一、Elasticsearch 安装步骤与常见问题解析 ##### （一）环境准备及安装 1. **下载与解压** 在 Linux 系统上安装 Elasticsearch，首先需要从官方网站或指定源下载对应版本的 Elasticsearch 压缩包。本例中使用的版本为 5.5.1，可以通过以下命令完成下载与解压： ```bash wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-5.5.1.zip unzip elasticsearch-5.5.1.zip cd elasticsearch-5.5.1/ ``` 2. **权限配置** 由于 Elasticsearch 安全策略更新，禁止 root 用户直接启动服务。因此，需创建一个专用用户，并赋予相应权限： ```bash useradd elasticsearch passwd elasticsearch groupadd es usermod -G elasticsearch es ``` 如遇到用户组或用户不存在的情况，可以尝试更换顺序： ```bash usermod -G es elasticsearch ``` 接下来，确保 Elasticsearch 文件夹下的所有文件都属于新创建的用户及其组： ```bash chown -R elasticsearch.es * su elasticsearch ``` 3. **配置文件调整** 进入 Elasticsearch 配置目录，根据实际情况修改配置文件 `elasticsearch.yml`： ```bash vi config/elasticsearch.yml ``` 修改内容包括但不限于： - 集群名称 (`cluster.name`) - 节点名称 (`node.name`) - 绑定 IP 和端口 (`network.host`, `http.port`) 4. **启动服务** 在完成了上述步骤后，可以尝试启动 Elasticsearch 服务： ```bash ./bin/elasticsearch ``` ##### （二）常见问题与解决方案 1. **数据目录权限问题** 如果启动过程中出现有关 data 目录的错误，需要切换至 root 用户并创建 data 目录： ```bash sudo mkdir /path/to/data sudo chown elasticsearch.es /path/to/data ``` 2. **虚拟内存限制问题** Elasticsearch 启动时可能会因系统虚拟内存限制较低而失败。此时需要调整 `vm.max_map_count` 参数： - 临时设置： ```bash sudo sysctl -w vm.max_map_count=262144 ``` - 永久设置： ```bash echo "vm.max_map_count=262144" | sudo tee -a /etc/sysctl.conf sudo sysctl -p ``` 3. **文件句柄限制问题** Elasticsearch 对文件句柄数量有较高需求，可以通过修改 `/etc/security/limits.conf` 文件来增加限制： ```bash vi /etc/security/limits.conf ``` 添加以下内容： ```bash * soft nofile 65536 * hard nofile 131072 * soft nproc 2048 * hard nproc 4096 ``` 之后重启会话或终端。 4. **验证安装** 使用 curl 或浏览器验证 Elasticsearch 是否正确启动： ```bash curl http://10.0.1.246:9200/ ``` #### 二、Kibana 和 Head 插件安装指南 ##### （一）Kibana 安装步骤 1. **下载与安装** 下载 Kibana 的对应版本，并按照官方文档进行安装与配置。 2. **启动 Kibana** 根据安装方式不同，启动命令可能有所差异。通常可以通过 Kibana 的二进制文件启动服务。 3. **验证安装** 浏览器访问 Kibana 的默认端口 (通常是 `http://localhost:5601/`) 来确认安装是否成功。 ##### （二）Head 插件安装步骤 1. **下载 Head 插件** 通过 Git 克隆 Head 插件仓库： ```bash git clone git://github.com/mobz/elasticsearch-head.git ``` 2. **安装依赖** 切换到 Head 插件目录，安装必要的 Node.js 依赖： ```bash cd elasticsearch-head npm install ``` 3. **配置 Gruntfile.js** 修改 `Gruntfile.js` 文件中的监听 IP 地址： ```javascript var config = { ... server: { options: { host: '0.0.0.0', // 修改为实际 IP 地址 port: 9100 } }, ... }; ``` 4. **启动 Head 插件** 运行 Head 插件服务： ```bash cd elasticsearch-head/node_modules/grunt/bin/ ./grunt server ``` 5. **验证安装** 使用浏览器访问 `http://localhost:9100`，可以看到 Head 插件界面，表明安装成功。 通过以上步骤，可以在 Linux 系统上成功安装并配置 Elasticsearch、Kibana 及 Head 插件，为后续的数据索引、查询以及可视化提供了坚实的基础。