1. 온프레미스 OpenSearch를 설치하려면 전용 서버(예: Ubuntu 22.04 LTS)를 프로비저닝하세요.

2. Java를 설치하세요 (OpenSearch는 Java 11 이상이 필요합니다):

   sudo apt update 
   sudo apt install -y openjdk-11-jdk 
   java -version
   

3. OpenSearch 2.x를 다운로드 및 압축 해제하세요:

   wget https://artifacts.opensearch.org/releases/bundle/opensearch/2.9.0/opensearch-2.9.0-linux-x64.tar.gz 
   tar -xzf opensearch-2.9.0-linux-x64.tar.gz 
   sudo mv opensearch-2.9.0 /usr/share/opensearch
   

4. 전용 사용자를 생성하고 권한을 설정하세요:

   sudo useradd --no-create-home --shell /bin/false opensearch 
   sudo chown -R opensearch:opensearch /usr/share/opensearch
   

5. systemd를 구성하세요:

   [Unit] 
     Description=OpenSearch 
     Wants=network-online.target 
     After=network-online.target 
   
   [Service] 
     Type=notify 
     User=opensearch 
     Group=opensearch 
     ExecStart=/usr/share/opensearch/bin/opensearch 
     Restart=on-failure 
     LimitNOFILE=65536 
     LimitNPROC=4096 
   
   [Install] 
     WantedBy=multi-user.target
   

6. 다음을 포함하도록 opensearch.yml을 편집하세요:

   cluster.name: mattermost-cluster
   node.name: node-1
   path.data: /var/lib/opensearch
   path.logs: /var/log/opensearch
   network.host: 0.0.0.0
   discovery.seed_hosts: ["<other-node-ip>"]
   cluster.initial_master_nodes: ["node-1", "node-2"]
   

서비스를 시작하기 전에 `path.data`와 `path.logs` 디렉터리가 존재하고 `opensearch` 사용자가 소유하고 있는지 확인하세요:

``` sh
sudo mkdir -p /var/lib/opensearch /var/log/opensearch
sudo chown -R opensearch:opensearch /var/lib/opensearch /var/log/opensearch
```

7. OpenSearch를 활성화하고 시작하세요:

   sudo systemctl daemon-reload 
   sudo systemctl enable opensearch 
   sudo systemctl start opensearch 
   sudo systemctl status opensearch
   

8. 다음 명령을 실행하여 /usr/share/opensearch/plugins 디렉터리에 icu-analyzer 플러그인을 설치하세요:

`analysis-icu` 플러그인은 선택 사항이 아니라 **클러스터의 모든 노드에 필요합니다**. Mattermost의 게시물 및 파일 인덱스 템플릿이 이 플러그인에 의존합니다. 플러그인이 없으면 Mattermost가 이러한 템플릿을 생성할 수 없습니다.

``` sh
sudo /usr/share/opensearch/bin/opensearch-plugin install analysis-icu
```

새로 설치한 플러그인을 로드하려면 확인하기 전에 각 노드에서 OpenSearch를 재시작하세요. `_cat/plugins`는 활성화된 플러그인만 보고하므로 먼저 재시작해야 합니다. 프로덕션 클러스터에서는 모든 노드를 한꺼번에 재시작하지 말고 한 번에 한 노드씩 재시작(롤링 재시작)하세요. 계속하기 전에 모든 노드에 플러그인이 설치되어 활성화되어 있는지 확인하세요. 호스트, 관리자 비밀번호, 클러스터의 CA 인증서 경로를 사용자 환경에 맞게 바꾸세요:

``` sh
curl --silent --show-error --fail-with-body --cacert <path-to-root-ca.pem> --user 'admin:<password>' 'https://<your-opensearch-host>:9200/_cat/plugins?v&h=name,component,version&s=name,component'
```

이 명령을 실행하면 클러스터의 노드마다 `analysis-icu`가 한 번씩 표시됩니다. 어느 노드에서든 `analysis-icu` 줄이 없으면 해당 노드에 플러그인이 설치되지 않은 것입니다.

(선택 사항) CJK 언어 분석기 플러그인: 한국어, 일본어 또는 중국어 콘텐츠 검색을 개선하려면 다음 언어별 분석기 플러그인 중 하나 이상을 설치하세요: analysis-nori(한국어), analysis-kuromoji(일본어), analysis-smartcn(중국어).

sudo /usr/share/opensearch/bin/opensearch-plugin install analysis-nori
sudo /usr/share/opensearch/bin/opensearch-plugin install analysis-kuromoji
sudo /usr/share/opensearch/bin/opensearch-plugin install analysis-smartcn

CJK 플러그인을 설치한 후 로드하려면 OpenSearch를 재시작하세요:

sudo systemctl restart opensearch

그런 다음 EnableCJKAnalyzers 구성 설정을 활성화하세요. 추가 CJK 검색 구성 옵션은 중국어, 일본어, 한국어 검색 활성화를 참조하세요.

Terraform (Docker) 예시#

provider "docker" { 
  host = "unix:///var/run/docker.sock" 
}

resource "docker_image" "opensearch" { 
  name = "opensearchproject/opensearch:2.9.0" 
}

resource "docker_container" "opensearch" { 
  name = "opensearch" 
  image = docker_image.opensearch.latest 

  ports { 
    internal = 9200 
    external = 9200 
  }
  ports { 
    internal = 9600 
    external = 9600 
  }

  env = [
    "cluster.name=mattermost-cluster",
    "network.host=0.0.0.0",
    "discovery.type=single-node", # remove for multi-node 
  ]

  restart = "unless-stopped" 
}

resource "null_resource" "install_icu_plugin" {
  depends_on = [docker_container.opensearch]

  provisioner "local-exec" {
    command = "docker exec opensearch /usr/share/opensearch/bin/opensearch-plugin install analysis-icu && docker restart opensearch"
  }
}