Docker 快速安装

增加内存映射区域数量

此配置可以在启动OpenSearch前配置，也可在启动遇到错误（“max virtual memory areas vm.max_map_count [65530] is too low”）时配置。

# 临时生效
sudo sysctl -w vm.max_map_count=262144

# 永久生效：将下面这行写入 /etc/sysctl.conf 文件，然后执行 sudo sysctl -p
vm.max_map_count=262144

拉取镜像

拉取命令

docker pull opensearchproject/opensearch:latest

# 或拉取指定版本
docker pull opensearchproject/opensearch:3.5.0

网络连接超时处理

Docker拉取镜像时，出现如下网络连接超时问题，报错日志：

Error response from daemon: Get https://registry-1.docker.io/v2/: net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers)

上述问题可以通过配置国内镜像加速器的方式解决，配置方式如下：

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
    "registry-mirrors": [
        "http://hub-mirror.c.163.com",
        "https://registry.docker-cn.com",
        "https://dockerhub.azk8s.cn",
        "https://mirror.ccs.tencentyun.com",
        "https://mirror.baidubce.com",
        "https://docker.m.daocloud.io",
        "http://mirrors.ustc.edu.cn",
        "http://mirror.azure.cn",
        "https://cr.console.aliyun.com",
        "https://docker.mirrors.sjtug.sjtu.edu.cn",
        "https://docker.nju.edu.cn"
    ]
}
EOF

# 重启docker服务
sudo systemctl restart docker

# 验证配置是否生效
docker info | grep -A 3 "Registry Mirrors"

配置完成后，尝试重新拉取镜像。

启动OpenSearch

docker run -it -p 9200:9200 -p 9600:9600 -e "discovery.type=single-node" -e "DISABLE_SECURITY_PLUGIN=true" opensearchproject/opensearch:latest

# 后台启动命令
docker run -itd -p 9200:9200 -p 9600:9600 -e "discovery.type=single-node" -e "DISABLE_SECURITY_PLUGIN=true" opensearchproject/opensearch:latest

验证OpenSearch

在交互式启动时，需要额外开启窗口执行如下请求：

curl https://localhost:9200

如果请求输出如下格式响应信息，说明OpenSearch安装成功：

{
  "name" : "a937e018cee5",
  "cluster_name" : "docker-cluster",
  "cluster_uuid" : "GLAjAG6bTeWErFUy_d-CLw",
  "version" : {
    "distribution" : "opensearch",
    "number" : <version>,
    "build_type" : <build-type>,
    "build_hash" : <build-hash>,
    "build_date" : <build-date>,
    "build_snapshot" : false,
    "lucene_version" : <lucene-version>,
    "minimum_wire_compatibility_version" : "7.10.0",
    "minimum_index_compatibility_version" : "7.0.0"
  },
  "tagline" : "The OpenSearch Project: https://opensearch.org.cn/"
}

Tarball安装

下载安装包

前往OpenSearch下载页面下载对应架构的OpenSearch tar压缩包，下载命令参考如下：

wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.5.0/opensearch-3.5.0-linux-x64.tar.gz

解压安装包

tar -zxf opensearch-3.5.0-linux-x64.tar.gz

增加内存映射区域数量

参考“Docker 快速安装”中的方式配置

安装OpenSearch

1. 进入解压后的目录

   cd opensearch-3.5.0
   

2. 运行安装脚本

   ./opensearch-tar-install.sh
   

   运行日志参考

   OpenSearch 2.12.0 onwards, the OpenSearch Security Plugin introduces a change that requires an initial password for 'admin' user. 
   Please define an environment variable 'OPENSEARCH_INITIAL_ADMIN_PASSWORD' with a strong password string. 
   If a password is not provided, the setup will quit. 
   For more details, please visit: https://opensearch.org/docs/latest/install-and-configure/install-opensearch/tar/
   

JAVA环境变量配置

1. 查看解压后的目录结构

   ls -l
   

2. 配置JAVA环境变量

   找到 jdk 目录，配置 java 环境变量到此目录下。配置方式如下，编辑用户环境变量文件：

   vim ~/.bashrc
   

   在文件中添加如下环境变量：

   export JAVA_HOME=/path/to/opensearch-3.5.0/jdk
   export PATH=$JAVA_HOME/bin:$PATH
   

   保存退出。

3. source环境变量

   source ~/.bashrc
   

OpenSearch参数配置

编辑OpenSearch配置文件：

vim config/opensearch.yml 

配置文件中的如下配置项，没有的配置项直接增加即可，配置内容如下：

# 配置服务监听的IPV4地址，如下配置支持通过任何地址访问
network.host: 0.0.0.0

# 指定集群为单节点，避免OpenSearch启动时默认寻找其他节点的行为导致启动失败
discovery.type: single-node

# 关闭安全功能配置，否则需要配置密码、ssl证书
plugins.security.disabled: true

保存退出。

启动OpenSearch

# 前台启动（便于查看日志）
./bin/opensearch

# 或者后台启动
./bin/elasticsearch -d

验证OpenSearch

在前台启动时，需要额外开启窗口执行如下请求：

curl https://localhost:9200

如果请求输出如下格式响应信息，说明OpenSearch安装成功：

{
  "name" : "a937e018cee5",
  "cluster_name" : "docker-cluster",
  "cluster_uuid" : "GLAjAG6bTeWErFUy_d-CLw",
  "version" : {
    "distribution" : "opensearch",
    "number" : <version>,
    "build_type" : <build-type>,
    "build_hash" : <build-hash>,
    "build_date" : <build-date>,
    "build_snapshot" : false,
    "lucene_version" : <lucene-version>,
    "minimum_wire_compatibility_version" : "7.10.0",
    "minimum_index_compatibility_version" : "7.0.0"
  },
  "tagline" : "The OpenSearch Project: https://opensearch.org.cn/"
}

官方文档

其他更多内容，请参考：OpenSearch官网文档