安装体验 #

在您安装 Easysearch 之前，您应该对服务器运行环境进行相应的优化，具体参数调整请参考系统调优。

如您想快速体验 Easysearch，可以通过 Docker 方式来进行，详细安装操作请您查看 Docker 环境下使用 Easysearch。

如您想快速体验 Easysearch 集群，可以通过 Docker Compose 方式来进行，详细安装操作请您查看 Docker Compose 环境下使用 Easysearch 集群。

对于使用 Linux 服务器的用户，详细安装操作请您查看 Linux 环境下使用 Easysearch。如果你使用的是国产的 arm 操作系统或龙芯操作系统，请参考博客文章 Arm 架构、 LoongArch 架构。

对于使用 Windows 的用户，详细安装操作请您查看 Windows 环境下使用 Easysearch。

JVM #

对于实例的 JVM 配置，可以通过过启动参数 ES_JAVA_OPTS="-Xms4g -Xmx4g" 进行设置，也可以直接修改 config/jvm.options 中相应的参数值。

插件安装 #

如需进行索引生命周期管理，分词、Logstash/Filebeat 生态工具支撑，需要进行插件安装。最新版本插件的下载地址

具体插件安装步骤参考如下：

联网环境判断，只有返回 200 才表示联网成功

curl -m1 -o /dev/null -sSL -w "%{http_code}\n" https://release.infinilabs.com

切换到 Easysearch 运行用户，此处假设为 infini 用户

su - infini

在线安装 index-management 插件

#linux环境，假设 Easysearch 安装目录为 /opt/easysearch
cd /opt/easysearch && bin/easysearch-plugin install index-management

离线安装，需要先下载好插件，然后通过指定插件位置进行安装

#e.g 假设当前Easysearch版本为1.2.0，且插件已下载到 /tmp/index-management-1.2.0.zip
bin/easysearch-plugin install file:///tmp/index-management-1.2.0.zip

查看已安装好的插件

bin/easysearch-plugin list

#以下为输出示例
analysis-ik
analysis-pinyin
cross-cluster-replication
index-management
ingest-common
ingest-geoip
ingest-user-agent
knn

一次性安装所有插件

#切换用户
su - infini

#切换到 Easysearch 安装目录
cd /opt/easysearch

#循环安装所有支持的插件
plugins=(analysis-ik analysis-pinyin index-management ingest-common ingest-geoip ingest-user-agent cross-cluster-replication knn)
for p in ${plugins[@]}; do
  echo y |bin/easysearch-plugin install $p
done

验证工作 #

为了保证 Easysearch 数据安全，初始化脚本会为 admin 用户生成随机的密码，如果使用 Docker 运行 Easysearch 或执行初始化脚本时同意记录初始密码到日志文件，则可在 Docker 日志文件或 logs/initialize.log 中找到 admin 用户对应的初始化密码。

由于初始脚本会自动覆盖集群上次使用的证书及内置的 admin 用户密码，请勿多次运行！如果您忘记了初始密码，可以通过内置的证书来进行密码重置。

#根据初始化脚本生成的随机密码访问 Easysearch 的 REST API
curl -ku admin:xxx https://localhost:9200

也可以在浏览器中输入网址 https://localhost:9200/，即可验证 Easysearch 是否完成启动。

推荐使用 INFINI Console 来进行集群管理，功能更加强大和方便。

注：各类客户端及周边工具，如 Logstash/Filebeat 请使用 7.10.2 oss 版本。并打开 config/easysearch.yml 中的配置项 elasticsearch.api_compatibility: true