---
title: "Logstash를 활용한 Search Engine Cluster 교체"
slug: "ses-example03"
updated: 2026-07-23T09:02:24Z
published: 2026-07-23T09:02:24Z
canonical: "guide-fin.ncloud-docs.com/ses-example03"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide-fin.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Logstash를 활용한 Search Engine Cluster 교체

LogStash 를 사용하여 CentOS가 적용된 Search Engine Service Cluster 를 Rocky등 OS가 적용된 Search Engine Service Cluster 로 교체하는 방법을 설명합니다.  
예제로는 Server에 LogStash를 구동한 후, Search Engine Service Cluster 의 데이터를 복제하고 교체하는 방법을 다루고 있습니다. 

## 사전 작업
이 가이드를 수행하기 전에 확인이 필요한 작업은 다음과 같습니다. 
* 기존 Search Engine Service Cluster 정보확인 (Cent Linux 설치 버전)
* 신규 생성한 Search Engine Service Cluster 정보확인 (Rocky Linux 설치 버전)


##  Custer 전환 순서 

### 신규로 생성한 Cluster로 이전하는 순서를 가이드 합니다. 
1. 하단의 가이드에 따라 VPC Server생성, LogStash 설치 및 적용, ACG설정을 완료합니다. 
2. 신규로 생성한 Cluster의 데이터가 LogStash를 설치한 Server를 통하여 정상적으로 복제 되는지 index 정보를 검색/검증 합니다. 
3. Cluster의 저장된 데이터를 검색하는 Application Server를 먼저 신규로 생성한 Cluster로 EndPopint 를 변경합니다. 
4. Cluster에 데이터를 저장하는 Application Server를 신규로 생성한 Cluster로 EndPoint를 변경합니다. 
5. Application Server의 EndPoint 변경이 완료되면 기존클러스터와 신규클러스터의 index와 문서수를 비교하여 이전이 완료 되었는지 확인/검증 합니다. 
6. LogStash를 설치한 VPC Server를 제거합니다. 


## VPC Server 생성
### STEP 1. 서버 생성 
LogStash 를 설치할 서버를 생성합니다. 

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Compute** > **Server** 메뉴를 차례대로 클릭해 주십시오.
2. [서버생성] 버튼을 클릭하여 서버를 생성합니다. ([서버생성 가이드](https://guide-fin.ncloud-docs.com/release-20260723/docs/server-create-vpc)) 
3. 서버생성시 Subnet 의 종류는 Cluster의 ManagerNode와 동일하거나 같은 타입(Private, Public)의 Subnet 으로 생성합니다. 
4. 생성된 서버의 SSH로 접속하여 LogStash 설치를 준비합니다. [서버접속 가이드](https://guide-fin.ncloud-docs.com/release-20260723/docs/server-access-vpc) 

## LogStash 설치
Server에 LogStash를 설치하는 예제를 소개합니다. \
설치과정에서 ElasticeSearch 또는 OpenSearch의 과정이 포함되어 있습니다. \
사용하는 버전에 맞춰서 설치해야 정상적인 테스트가 가능합니다. 

 
### STEP 1. java 설치
1. 다음 명령어를 입력하여 java를 설치해 주십시오
```
sudo yum install java-devel -y
```

### STEP 2. LogStash설치
LogStash를 설치하는 방법은 다음과 같습니다. 
LogStash는 호환성을 위하여 이용하는 Elasticsearch 또는 OpenSearch 의 버전에 맞춰 설치하여야 합니다.

#### 1. 다음 명령어를 입력하여 /root 경로에 LogStash 를 다운로드합니다.
```
# Elasticsearch 버전인 경우(OSS 버전 설치)
wget https://artifacts.elastic.co/downloads/logstash/logstash-oss-7.7.0.rpm

# OpenSearch 버전인 경우
wget https://artifacts.opensearch.org/logstash/logstash-oss-with-opensearch-output-plugin-7.16.3-linux-x64.tar.gz
```

#### 2. 다운로드한 파일을 설치하기 위한 명령어입니다. 
```
# Elasticsearch 버전인 경우
rpm -ivh logstash-oss-7.7.0.rpm

# OpenSearch 버전인 경우
tar -zxvf logstash-oss-with-opensearch-output-plugin-7.16.3-linux-x64.tar.gz
```

#### 3. 다음의 명령어와 설정파일을 참고하여 LogStash가 수행할 역할을 정의합니다. 

* ElasticSearch 버전인 경우  
```
mv /etc/logstash/logstash-sample.conf /etc/logstash/conf.d/logstash.conf
vi /etc/logstash/conf.d/logstash.conf
```

* ElasticSearch버전 LogStash.conf
```
input {
  elasticsearch {
    hosts => ["http://A-cluster-address:9200"]
    index => "your-index-*"
  }
}

output {
  elasticsearch {
    hosts => ["http://B-cluster-address:9200"]
    index => "%{[index]}"
  }
}
```

* OpenSearch 버전인 경우  
```
# /root/ 에 설치하는 경우 {설치경로}는 /root/logstash-7.16.3 입니다.
mv {설치경로}/config/logstash-sample.conf {설치경로}/config/logstash.conf
vi {설치경로}/config/logstash.conf
```

* OpenSearch버전 LogStash.conf
```
input {
  opensearch {
    hosts => ["http://A-cluster-address:9200"]
    index => "your-index-*"
    user => ${userID}
    password => ${password}
    ssl_certificate_verification => false
  }
}

output {
  opensearch {
    hosts => ["http://B-cluster-address:9200"]
    index => "%{[index]}"
    user => ${userID}
    password => ${password}
    ssl_certificate_verification => false
  }
}
```

* LogStash 각 항목별 설명
```
["http://A-cluster-address:9200"] - 현재 이용 중인 Cluster의 정보를 입력합니다. 
["http://B-cluster-address:9200"] - 신규로 생성한 Cluster의 정보를 입력합니다.
"your-index-*" - 현재 이용중인 Cluster에서 복제할 index 이름입니다. 
"%{[index]}" - 현재 이용중인 Cluster의 복제한 index 이름을 변수로 정의합니다.
${userID} - Cluster에 등록된 사용자 ID 입니다. 
${password} - Cluster에 등록된 사용자 PASSWORD 입니다. 
ssl_certificate_verification => false - OpenSearch 접속시 사설인증서 통과를 위한 설정입니다.
```

#### 4. LogStash 실행
LogStash를 실행하는 명령어 예제는 다음과 같으며, 상황에 따라 다르게 적용될 수도 있습니다. 
```
# Elasticsearch 버전인 경우
systemctl start logstash

# OpenSearch 버전인 경우
# 백그라운드 실행을 위해 nohup 을 사용합니다.
# -f 옵션을 사용하여 logstash.conf 의 경로를 지정해 주셔야 합니다.
nohup {설치경로}/bin/logstash -f ~{설치경로}/config/logstash.conf &
```


## 네트워크 설정
### STEP 1. ACG 설정
Search Engine Service Cluster 2개 모두 LogStash 가 설치된 서버에서 9200번 포트로 접근 할 수 있도록 ACG를 설정하는 방법은 다음과 같습니다. 

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Big Data & Analytics** > **Search Engine Service** 메뉴를 차례대로 클릭해 주십시오.
2. Cluster 를 선택 후 매니저노드ACG 옆의 새창열기 버튼을 클릭합니다. 
3. 매니저노드ACG 의 이름과 동일한 ACG를 선택 후, 상단의 [ACG 설정] 버튼을 클릭합니다. 
4. inboud 탭에서 아래의 정보를 입력 후 [추가] 버튼을 클릭합니다.
   * 프로토콜: TCP
   * 접근소스: Logstash가 실행될 서버의 IP
   * 허용포트: 9200
5. 하단의 [적용] 버튼을 클릭합니다. 

동일한 방법으로 현재 이용 중인 클러스터와 변경할 클러스터 모두 동일하게 ACG를 등록합니다.