Windows ZIP 설치

Windows .zip 아카이브를 사용하여 Windows에 Elasticsearch를 설치할 수 있습니다. 이 아카이브에는 elasticsearch-service.bat 명령이 포함되어 있으며, 이 명령으로 Elasticsearch를 서비스로 실행하도록 설정할 수 있습니다.

이 패키지에는 무료 기능과 구독 기능이 모두 포함되어 있습니다. 모든 기능을 사용해 보려면 30일 평가판을 시작하세요.

최신 안정 버전의 Elasticsearch는 Elasticsearch 다운로드 페이지에서 확인할 수 있습니다. 다른 버전은 이전 릴리스 페이지에서 확인할 수 있습니다.

Elasticsearch를 설치하기 전에 다음을 수행하세요.

• 지원되는 운영 체제를 검토하고 Elasticsearch를 설치할 가상 또는 물리적 호스트를 준비합니다.

  Elasticsearch는 목록에 있는 플랫폼에서 테스트되었지만 다른 플랫폼에서도 작동할 수 있습니다.

• 중요 시스템 구성 지침에 따라 운영 체제를 구성합니다.

elasticsearch-9.5.1
		

cd C:\Program Files\elasticsearch-9.5.1
		

cd C:\Program Files\elasticsearch-<SPECIFIC.VERSION.NUMBER>
		

일부 기능은 Elasticsearch 내에 인덱스를 자동으로 생성합니다. 기본적으로 Elasticsearch는 인덱스 자동 생성을 허용하도록 구성되어 있으므로 추가 단계가 필요하지 않습니다. 그러나 Elasticsearch에서 인덱스 자동 생성을 비활성화한 경우 action.auto_create_index를 elasticsearch.yml에서 구성하여 기능이 다음 인덱스를 생성할 수 있도록 해야 합니다.

action.auto_create_index: .monitoring*,.watches,.triggered_watches,.watcher-history*,.ml*
		

Logstash 또는 Beats를 사용하는 경우 action.auto_create_index 설정에 추가 인덱스 이름이 필요할 가능성이 높으며, 정확한 값은 로컬 구성에 따라 달라집니다. 환경에 맞는 올바른 값을 모르는 경우 모든 인덱스의 자동 생성을 허용하는 *로 설정하는 방안을 고려할 수 있습니다.

Elasticsearch를 처음 시작하면 보안 자동 구성 프로세스가 HTTP 계층을 0.0.0.0에 바인딩하지만 전송 계층은 localhost에만 바인딩합니다. 이는 추가 구성 없이 기본적으로 보안이 활성화된 단일 노드 클러스터를 시작할 수 있도록 의도된 동작입니다.

새 노드를 등록하기 전에 프로덕션 클러스터에서는 일반적으로 localhost 이외의 주소에 바인딩하거나 부트스트랩 검사를 충족하는 등의 추가 작업이 필요합니다. 그동안 자동 생성된 등록 토큰이 만료될 수 있으므로 등록 토큰은 자동으로 생성되지 않습니다.

추가 구성 없이는 같은 호스트의 노드만 클러스터에 참여할 수 있습니다. 다른 호스트의 노드를 클러스터에 참여시키려면 인스턴스에 접근할 수 있도록 해야 합니다.

클러스터 구성 프로세스에 대한 자세한 내용은 검색 및 클러스터 구성을 참조하세요.

• 여러 호스트에 걸친 다중 노드 클러스터의 첫 번째 노드를 설치하는 경우 다른 호스트가 연결할 수 있도록 노드를 구성해야 합니다.

• 클러스터에 추가 노드를 설치하는 경우 등록 토큰을 생성하고 Elasticsearch를 처음 시작할 때 전달해야 합니다.

다른 호스트가 연결할 수 있도록 이 첫 번째 노드의 elasticsearch.yml 설정을 편집하여 Elasticsearch 구성을 업데이트합니다.

1. 텍스트 편집기에서 elasticsearch.yml을 엽니다.

2. 다중 노드 Elasticsearch 클러스터에서는 모든 Elasticsearch 인스턴스의 이름이 같아야 합니다.

   구성 파일에서 #cluster.name: my-application 줄의 주석을 해제하고 Elasticsearch 인스턴스에 원하는 이름을 지정합니다.

   cluster.name: elasticsearch-demo
   		

3. 기본적으로 Elasticsearch는 localhost에서 실행됩니다. 다른 노드의 Elasticsearch 인스턴스가 클러스터에 참여하려면 라우팅 가능한 외부 IP 주소에서 Elasticsearch가 실행되도록 설정해야 합니다.

   #network.host: 192.168.0.1 줄의 주석을 해제하고 기본 주소를 0.0.0.0으로 바꿉니다. 0.0.0.0 설정을 사용하면 Elasticsearch가 사용 가능한 모든 네트워크 인터페이스에서 연결을 수신합니다. 프로덕션 환경에서는 고정 IP 주소나 다른 값(예: 호스트의 네트워크 인터페이스 참조)을 사용할 수 있습니다.

   network.host: 0.0.0.0
   		

4. Elasticsearch가 다른 외부 호스트의 연결을 수신할 수 있도록 설정해야 합니다.

   #transport.host: 0.0.0.0 줄의 주석을 해제합니다. 0.0.0.0 설정을 사용하면 Elasticsearch가 사용 가능한 모든 네트워크 인터페이스에서 연결을 수신합니다. 프로덕션 환경에서는 고정 IP 주소나 다른 값(예: 호스트의 네트워크 인터페이스 참조)을 사용할 수 있습니다.

   transport.host: 0.0.0.0
   		

   팁

   network.host 및 transport.host 설정에 대한 자세한 내용은 Elasticsearch 네트워킹 설정 참조에서 확인할 수 있습니다.

5. 변경 사항을 저장하고 편집기를 닫습니다.

클러스터에 새 노드를 등록하려면 클러스터의 기존 노드에서 elasticsearch-create-enrollment-token 도구로 등록 토큰을 생성합니다. 그런 다음 --enrollment-token 매개변수로 새 노드를 시작하여 기존 클러스터에 참여시킬 수 있습니다.

1. 텍스트 편집기를 사용하여 cluster.name을 elasticsearch.yml에서 클러스터의 다른 노드와 일치하도록 업데이트합니다.

   참고

   이 값을 업데이트하지 않고 기존 클러스터에 참여하려고 하면 다음 오류와 함께 연결에 실패합니다.

   handshake failed: remote cluster name [cluster-to-join] does not match local cluster name [current-cluster-name]
   		

2. Elasticsearch가 실행 중인 터미널과 별도의 터미널에서 Elasticsearch 설치 디렉터리로 이동한 후 elasticsearch-create-enrollment-token 도구를 실행하여 새 노드의 등록 토큰을 생성합니다.

   .\bin\elasticsearch-create-enrollment-token -s node
   		

   Elasticsearch 클러스터에 새 노드를 등록할 때 사용할 등록 토큰을 복사합니다.

   등록 토큰의 유효 시간은 30분입니다. 추가하는 새 노드마다 새 등록 토큰을 생성해야 합니다.

3. 새 노드의 설치 디렉터리에서 Elasticsearch를 시작하고 --enrollment-token 매개변수로 등록 토큰을 전달합니다.

   .\bin\elasticsearch --enrollment-token <enrollment-token>
   		

   Elasticsearch는 다음 디렉터리에 인증서와 키를 자동으로 생성합니다.

   config\certs
   		

클러스터에 추가하려는 각 Elasticsearch 노드에 대해 이 단계를 반복할 수 있습니다.

검색 및 샤드 할당에 대한 자세한 내용은 검색 및 클러스터 구성과 클러스터 수준 샤드 할당 및 라우팅 설정을 참조하세요.

Elasticsearch를 시작하는 방법은 여러 가지입니다.

• 명령줄에서 실행
• 서비스로 설치 및 실행

기존 클러스터에 등록할 노드를 시작하는 경우 기존 클러스터에 노드 등록을 참조하세요.

명령줄에서 Elasticsearch를 시작하려면 다음 명령을 실행합니다.

.\bin\elasticsearch.bat
		

기본적으로 Elasticsearch는 로그를 콘솔(STDOUT)과 <cluster name>.log 파일(로그 디렉터리 내)에 출력합니다. Elasticsearch는 시작 중에 일부 정보를 기록하지만 초기화가 끝나면 포그라운드에서 계속 실행되며 기록할 만한 일이 발생할 때까지 추가 로그를 남기지 않습니다. Elasticsearch가 실행 중일 때 기본적으로 9200 포트에 있는 HTTP 인터페이스를 통해 상호 작용할 수 있습니다.

Elasticsearch를 중지하려면 Ctrl-C를 누릅니다.

첫 번째 Elasticsearch 노드를 처음 시작하면 다음 보안 설정이 자동으로 수행됩니다.

• TLS 인증서를 전송 및 HTTP 계층용으로 생성
• elasticsearch.yml에 TLS 구성 설정 적용
• elastic 슈퍼유저의 비밀번호 설정
• Kibana를 Elasticsearch에 안전하게 연결하기 위한 등록 토큰 생성

그런 다음 Kibana를 시작하고 30분 동안 유효한 등록 토큰을 입력할 수 있습니다. 이 토큰은 Elasticsearch 클러스터의 보안 설정을 자동으로 적용하고, 기본 제공 kibana 서비스 계정으로 Elasticsearch에 인증하며, 보안 구성을 kibana.yml에 기록합니다.

elastic 사용자의 비밀번호와 Kibana의 등록 토큰이 터미널에 출력됩니다.

elastic 비밀번호를 셸의 환경 변수로 저장하는 것이 좋습니다. 예:

$ ELASTIC_PASSWORD="your_password"
		

Elasticsearch 키 저장소를 비밀번호로 보호한 경우 키 저장소의 비밀번호를 입력하라는 메시지가 표시됩니다. 자세한 내용은 보안 설정을 참조하세요.

이 비밀번호를 재설정하는 방법은 자체 관리형 클러스터에서 네이티브 및 기본 제공 사용자의 비밀번호 설정을 참조하세요.

Elasticsearch는 기본적으로 다음 위치에서 구성을 로드합니다.

%ES_HOME%\config\elasticsearch.yml
		

이 구성 파일의 형식은 Elasticsearch 구성에 설명되어 있습니다.

구성 파일에 지정할 수 있는 모든 설정은 다음과 같이 -E 구문을 사용하여 명령줄에서도 지정할 수 있습니다.

.\bin\elasticsearch.bat -Ecluster.name=my_cluster -Enode.name=node_1
		

Elasticsearch를 백그라운드에서 실행하거나 사용자 개입 없이 부팅 시 자동으로 시작되는 서비스로 설치할 수 있습니다.

1. Elasticsearch를 서비스로 설치합니다. 설치 중에 서비스 이름과 ES_JAVA_HOME 값이 표시됩니다.

   .\bin\elasticsearch-service.bat install
   		

   응답:

   Installing service      :  "elasticsearch-service-x64"
   Using ES_JAVA_HOME (64-bit):  "C:\jvm\jdk1.8"
   The service 'elasticsearch-service-x64' has been installed.
   		

   ES_JAVA_HOME은 서비스를 실행할 JVM의 설치 디렉터리입니다. 환경 변수를 사용하여 이 값을 변경할 수 있습니다.

   참고

   Elasticsearch 서비스에 JRE를 사용할 수 있지만 권장하지 않으며 JRE를 사용하면 경고가 발생합니다. 장기 실행 애플리케이션에 더 나은 성능을 제공하는 서버 JVM과 달리 클라이언트 VM을 사용하기 때문입니다.

2. Elasticsearch를 서비스로 시작합니다. Elasticsearch가 시작되면 기본적으로 인증이 활성화됩니다.

   .\bin\elasticsearch-service.bat start
   		

   참고

   Elasticsearch를 서비스로 시작할 때 TLS는 활성화되거나 구성되지 않습니다.

3. elastic 사용자의 비밀번호를 elasticsearch-reset-password 도구로 생성합니다. 비밀번호는 명령줄에 출력됩니다.

   .\bin\elasticsearch-reset-password -u elastic
   		

elasticsearch-service.bat 스크립트(bin\ 폴더에 위치)를 사용하여 명령줄에서 서비스를 설치, 제거, 관리, 시작 또는 중지합니다. 시작 및 중지는 서비스가 이미 설치된 경우에만 사용할 수 있습니다.

사용법:

elasticsearch-service.bat install|remove|start|stop|manager [SERVICE_ID]
		

스크립트에는 하나의 매개변수(실행할 명령)가 필요하며, 그 뒤에 서비스 ID를 나타내는 선택적 매개변수를 지정할 수 있습니다(여러 Elasticsearch 서비스를 설치할 때 유용).

사용 가능한 명령은 다음과 같습니다.

설치 전에는 환경 변수를 사용하고, 설치 후에는 관리자 GUI를 사용하여 서비스 설정을 사용자 지정할 수 있습니다.

elasticsearch-service.bat는 서비스를 설치하기 위해 Apache Commons Daemon 프로젝트를 사용합니다. 서비스 설치 전에 설정된 환경 변수는 복사되어 서비스 수명 주기 동안 사용됩니다. 따라서 설치 후 변경한 내용은 서비스를 다시 설치하지 않으면 반영되지 않습니다.

elasticsearch-service.bat manager
		

• 기본적으로 Elasticsearch는 노드의 역할과 전체 메모리를 기준으로 JVM 힙 크기를 자동 조정합니다. 대부분의 프로덕션 환경에서는 이 기본 크기 조정을 권장합니다. 필요한 경우 힙 크기를 수동으로 설정하여 기본 크기를 재정의할 수 있습니다.

  Windows에서 Elasticsearch를 처음 서비스로 설치하거나 명령줄에서 실행할 때 JVM 힙 크기를 설정할 수 있습니다. 이미 설치된 서비스의 힙 크기를 조정하려면 관리자 GUI를 사용하세요.

• 서비스는 Elasticsearch 실행 시 사용할 비공개 임시 디렉터리를 자동으로 구성합니다. 이 비공개 임시 디렉터리는 설치를 실행하는 사용자의 비공개 임시 디렉터리 아래의 하위 디렉터리로 구성됩니다. 서비스를 다른 사용자로 실행할 경우 서비스 설치를 실행하기 전에 환경 변수 ES_TMPDIR을 원하는 위치로 설정하여 서비스에서 사용할 임시 디렉터리 위치를 구성할 수 있습니다.

• 시스템 환경 변수 ES_JAVA_HOME은 서비스에서 사용할 JDK 설치 경로로 설정해야 합니다. JDK를 업그레이드할 때 서비스를 다시 설치할 필요는 없지만 시스템 환경 변수 ES_JAVA_HOME의 값을 새 JDK 설치 경로로 설정해야 합니다. JVM 유형 간 업그레이드(예: JRE와 SE 간)는 지원되지 않으며 서비스를 다시 설치해야 합니다.

9200 포트(localhost)로 HTTPS 요청을 보내 Elasticsearch 노드가 실행 중인지 테스트할 수 있습니다.

curl --cacert %ES_HOME%\config\certs\http_ca.crt
-u elastic:$ELASTIC_PASSWORD https://localhost:9200
		

1. --cacert: HTTP 계층용으로 생성된 http_ca.crt 인증서의 경로입니다.
2. $ELASTIC_PASSWORD를 elastic 슈퍼유저 비밀번호로 바꿉니다. 호출에 https를 사용해야 하며, 그렇지 않으면 요청이 실패합니다.

호출은 다음과 같은 응답을 반환합니다.

{
  "name" : "Cp8oag6",
  "cluster_name" : "elasticsearch",
  "cluster_uuid" : "AT69_T_DTp-1qgIJlatQqA",
  "version" : {
    "number" : "9.0.0-SNAPSHOT",
    "build_type" : "tar",
    "build_hash" : "f27399d",
    "build_flavor" : "default",
    "build_date" : "2016-03-30T09:51:41.449Z",
    "build_snapshot" : false,
    "lucene_version" : "10.0.0",
    "minimum_wire_compatibility_version" : "1.2.3",
    "minimum_index_compatibility_version" : "1.2.3"
  },
  "tagline" : "You Know, for Search"
}
		

다중 노드 클러스터를 배포하는 경우 등록 프로세스는 새로 등록된 각 노드의 discovery.seed_hosts 설정에 모든 기존 노드를 추가합니다. 그러나 클러스터의 각 노드가 예상대로 다시 시작하고 클러스터에 다시 참여할 수 있도록 클러스터의 모든 노드로 돌아가 편집해야 합니다.

클러스터의 각 노드에서 다음 단계를 수행합니다.

1. 텍스트 편집기에서 elasticsearch.yml을 엽니다.
2. cluster.initial_master_nodes 설정이 있으면 주석 처리하거나 제거합니다.
3. discovery.seed_hosts 값에 클러스터 내 마스터 적격 Elasticsearch 노드 각각의 IP 주소와 포트가 포함되도록 업데이트합니다. 클러스터의 첫 번째 노드에는 discovery.seed_hosts 설정을 수동으로 추가해야 합니다.
4. 선택적으로 Elasticsearch 서비스를 다시 시작하여 구성 변경 사항을 검증합니다.

이 단계를 수행하지 않으면 하나 이상의 노드가 다시 시작될 때 검색 구성 부트스트랩 검사에 실패합니다.

자세한 내용은 검색 및 클러스터 구성을 참조하세요.

Elasticsearch를 처음 시작하면 HTTP 계층에 TLS가 자동으로 구성됩니다. CA 인증서가 생성되어 다음 디스크 위치에 저장됩니다.

%ES_HOME%\config\certs\http_ca.crt
		

이 인증서의 16진수로 인코딩된 SHA-256 지문도 터미널에 출력됩니다. Elasticsearch Clients, Beats, 독립 실행형 Elastic Agents, Logstash 등 Elasticsearch에 연결하는 모든 클라이언트는 Elasticsearch가 HTTPS에 사용하는 인증서를 신뢰하는지 검증해야 합니다. Fleet Server와 Fleet에서 관리하는 Elastic Agents는 CA 인증서를 신뢰하도록 자동 구성됩니다. 다른 클라이언트는 CA 인증서의 지문이나 CA 인증서 자체를 사용하여 신뢰를 설정할 수 있습니다.

자동 구성 프로세스가 이미 완료된 경우에도 보안 인증서의 지문을 얻을 수 있습니다. CA 인증서를 시스템에 복사하고 클라이언트에서 사용하도록 구성할 수도 있습니다.

Elasticsearch가 시작될 때 터미널에 출력되는 지문 값을 복사하고, 클라이언트가 Elasticsearch에 연결할 때 이 지문을 사용하여 신뢰를 설정하도록 구성합니다.

자동 구성 프로세스가 이미 완료된 경우에도 다음 명령을 실행하여 보안 인증서의 지문을 얻을 수 있습니다. 이 경로는 HTTP 계층용으로 자동 생성된 CA 인증서를 가리킵니다.

openssl x509 -fingerprint -sha256 -in config/certs/http_ca.crt
		

명령은 지문을 포함한 보안 인증서를 반환합니다. issuer는 Elasticsearch security auto-configuration HTTP CA여야 합니다.

issuer= /CN=Elasticsearch security auto-configuration HTTP CA
SHA256 Fingerprint=<fingerprint>
		

라이브러리에서 지문을 검증하는 방법을 지원하지 않는 경우 자동 생성된 CA 인증서는 각 Elasticsearch 노드의 다음 디렉터리에 생성됩니다.

%ES_HOME%\config\certs\http_ca.crt
		

http_ca.crt 파일을 시스템에 복사하고 클라이언트가 Elasticsearch에 연결할 때 이 인증서를 사용하여 신뢰를 설정하도록 구성합니다.

.zip 패키지는 완전히 자체 포함되어 있습니다. 기본적으로 모든 파일과 디렉터리는 아카이브 압축을 풀 때 생성되는 디렉터리인 %ES_HOME% 내에 포함됩니다.

Elasticsearch를 사용하기 위해 디렉터리를 만들 필요가 없고 %ES_HOME% 디렉터리를 제거하는 것만으로 쉽게 Elasticsearch를 제거할 수 있어 매우 편리합니다. 그러나 나중에 중요한 데이터를 삭제하지 않도록 구성 디렉터리, 데이터 디렉터리 및 로그 디렉터리의 기본 위치를 변경하는 것이 좋습니다.

이제 테스트 Elasticsearch 환경이 설정되었습니다. 본격적인 개발을 시작하거나 Elasticsearch를 프로덕션 환경에 배포하기 전에 몇 가지 추가 설정을 수행해야 합니다.

• Elasticsearch 구성 방법을 알아봅니다.
• 중요한 Elasticsearch 설정을 구성합니다.
• 모든 Elastic 솔루션의 사용자 인터페이스인 Kibana를 설치합니다.

다음 작업도 수행할 수 있습니다.

• 추가 Elastic Stack 구성 요소 설치를 고려합니다.
• Elasticsearch로 데이터를 수집하는 방법을 알아봅니다.
• 프로덕션 고려 사항을 알아봅니다.
• 다른 주제를 살펴보고 클러스터를 보호하고 관리하는 방법을 알아봅니다.