RPM 설치

Elasticsearch용 RPM 패키지는 웹사이트에서 다운로드 하거나 RPM 저장소에서 다운로드할 수 있습니다. 이 패키지는 openSUSE, SUSE Linux Enterprise Server(SLES), CentOS, Red Hat Enterprise Linux(RHEL), Oracle Linux와 같은 모든 RPM 기반 시스템에 Elasticsearch를 설치하는 데 사용할 수 있습니다.

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

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

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

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

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

• 다음 중요 시스템 구성 지침을 사용하여 운영 체제를 구성하세요.

모든 패키지는 다음 지문을 가진 Elasticsearch 서명 키(PGP 키 D88E42B4이며 https://pgp.mit.edu)로 서명됩니다.

4609 5ACC 8548 582C 1A26 99A9 D27D 666C D88E 42B4
		

공개 서명 키를 다운로드하고 설치합니다.

rpm --import https://artifacts.elastic.co/GPG-KEY-elasticsearch
		

Elasticsearch RPM 패키지를 설치하는 방법은 두 가지입니다.

• RPM 저장소에서 설치
• 수동 설치

1. Elasticsearch 저장소를 정의합니다.

[elasticsearch]
name=Elasticsearch repository for 9.x packages
baseurl=https://artifacts.elastic.co/packages/9.x/yum
gpgcheck=1
gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch
enabled=0
type=rpm-md
		

[elasticsearch]
name=Elasticsearch repository for 9.x packages
baseurl=https://artifacts.elastic.co/packages/9.x/yum
gpgcheck=1
gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch
enabled=0
autorefresh=1
type=rpm-md
		

2. 앞에서 정의한 저장소에서 Elasticsearch를 설치합니다.

sudo dnf install --enablerepo=elasticsearch elasticsearch
		

sudo dnf install elasticsearch-<SPECIFIC.VERSION.NUMBER>
		

sudo yum install --enablerepo=elasticsearch elasticsearch
		

sudo zypper modifyrepo --enable elasticsearch && \
  sudo zypper install elasticsearch; \
  sudo zypper modifyrepo --disable elasticsearch
		

sudo zypper modifyrepo --enable elasticsearch && \
  sudo zypper install elasticsearch-<SPECIFIC.VERSION.NUMBER>; \
  sudo zypper modifyrepo --disable elasticsearch
		

1. 다음 명령으로 Elasticsearch RPM을 다운로드하고 설치합니다.

wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-9.5.1-x86_64.rpm
wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-9.5.1-x86_64.rpm.sha512
shasum -a 512 -c elasticsearch-9.5.1-x86_64.rpm.sha512
sudo rpm --install elasticsearch-9.5.1-x86_64.rpm
		

wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-<SPECIFIC.VERSION.NUMBER>-x86_64.rpm
wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-<SPECIFIC.VERSION.NUMBER>-x86_64.rpm.sha512
shasum -a 512 -c elasticsearch-<SPECIFIC.VERSION.NUMBER>-x86_64.rpm.sha512
sudo rpm --install elasticsearch-<SPECIFIC.VERSION.NUMBER>-x86_64.rpm
		

2. 설치 명령의 터미널 출력을 로컬 파일에 복사하세요. 특히 기본 제공 elastic 슈퍼유저 계정의 비밀번호가 필요합니다. 출력에는 Elasticsearch를 서비스로 실행하도록 활성화하는 명령도 포함되어 있습니다.

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

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

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

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

• 클러스터에 추가 노드를 설치하는 경우 등록 토큰을 생성한 다음 새 노드가 기존 클러스터에 참여하도록 재구성해야 합니다.

단일 노드 클러스터를 실행하는 경우 다음 단계로 건너뛰세요.

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

다른 호스트가 첫 번째 노드에 연결할 수 있도록 다음 파일의 설정을 편집하여 Elasticsearch 구성을 업데이트하세요. elasticsearch.yml:

1. 다음 파일을 elasticsearch.yml 텍스트 편집기에서 여세요.

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

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

   cluster.name: elasticsearch-demo
   		

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

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

   network.host: 0.0.0.0
   		

4. Elasticsearch가 다른 외부 호스트의 연결을 수신하도록 활성화해야 합니다.

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

   transport.host: 0.0.0.0
   		

   팁

   network.host 및 transport.host 설정에 대한 자세한 내용은 Elasticsearch 네트워킹 설정 참조를 확인하세요.

5. 변경 사항을 저장하고 편집기를 닫으세요.

Elasticsearch를 설치하면 설치 프로세스가 기본적으로 단일 노드 클러스터를 구성합니다. 노드를 기존 클러스터에 참여시키려면 새 노드를 처음 시작하기 전에 기존 노드에서 등록 토큰을 생성하세요.

1. 기존 클러스터의 아무 노드에서나 노드 등록 토큰을 생성합니다.

   /usr/share/elasticsearch/bin/elasticsearch-create-enrollment-token -s node
   		

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

2. 터미널에 출력된 등록 토큰을 복사합니다.

3. 새 Elasticsearch 노드에서 등록 토큰을 다음 elasticsearch-reconfigure-node 도구에 매개변수로 전달합니다.

   /usr/share/elasticsearch/bin/elasticsearch-reconfigure-node --enrollment-token <enrollment-token>
   		

   다음 Do you want to continue 프롬프트에 yes (y)로 응답하세요. 새 Elasticsearch 노드가 재구성됩니다.

4. 새 Elasticsearch 인스턴스의 elasticsearch.yml 파일을 텍스트 편집기에서 여세요.

   다음 elasticsearch-reconfigure-node 도구가 여러 설정을 업데이트했습니다. 예:

   • 다음 transport.host: 0.0.0.0 설정은 이미 주석이 해제되어 있습니다.
   • 다음 discovery_seed.hosts 설정에는 지금까지 클러스터에 추가된 다른 Elasticsearch 노드의 IP 주소와 포트가 있습니다. 새 Elasticsearch 노드를 클러스터에 추가할 때마다 discovery_seed.hosts 설정에는 이전에 클러스터에 추가된 각 Elasticsearch 노드에 연결할 IP 주소와 포트 번호의 배열이 포함됩니다.

5. 구성 파일에서 다음 줄의 주석을 해제하고 #cluster.name: my-application 첫 번째 Elasticsearch 노드에 지정한 이름과 일치하도록 설정하세요.

   cluster.name: elasticsearch-demo
   		

6. 첫 번째 Elasticsearch 노드와 마찬가지로 Elasticsearch를 라우팅 가능한 외부 IP 주소에서 실행하도록 설정해야 합니다.

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

   network.host: 0.0.0.0
   		

7. 변경 사항을 저장하고 편집기를 닫으세요.

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

일부 기능은 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를 시작하고 중지할 수 있습니다.

sudo systemctl start elasticsearch.service
sudo systemctl stop elasticsearch.service
		

이 명령은 Elasticsearch가 성공적으로 시작되었는지에 대한 피드백을 제공하지 않습니다. 대신 이 정보는 /var/log/elasticsearch/에 있는 로그 파일에 기록됩니다.

Elasticsearch 키 저장소를 비밀번호로 보호한 경우 로컬 파일과 systemd 환경 변수를 사용하여 systemd 에 키 저장소 비밀번호를 제공해야 합니다. 이 로컬 파일은 존재하는 동안 보호해야 하며 Elasticsearch가 실행되면 안전하게 삭제할 수 있습니다.

echo "keystore_password" > /path/to/my_pwd_file.tmp
chmod 600 /path/to/my_pwd_file.tmp
sudo systemctl set-environment ES_KEYSTORE_PASSPHRASE_FILE=/path/to/my_pwd_file.tmp
sudo systemctl start elasticsearch.service
		

시스템 부팅 시 Elasticsearch가 자동으로 시작되도록 구성하려면 다음 명령을 실행하세요.

sudo /bin/systemctl daemon-reload
sudo /bin/systemctl enable elasticsearch.service
		

기본적으로 Elasticsearch 서비스는 systemd 저널에 정보를 기록하지 않습니다. journalctl 로깅을 활성화하려면 --quiet 파일의 ExecStart 명령줄에서 elasticsearch.service 옵션을 제거해야 합니다.

다음 systemd 로깅을 활성화하면 다음 journalctl 명령으로 로깅 정보를 확인할 수 있습니다.

저널을 실시간으로 확인하려면 다음을 실행합니다.

sudo journalctl -f
		

elasticsearch 서비스의 저널 항목을 나열하려면 다음을 실행합니다.

sudo journalctl --unit elasticsearch
		

지정된 시간 이후의 elasticsearch 서비스 저널 항목을 나열하려면 다음을 실행합니다.

sudo journalctl --unit elasticsearch --since  "2016-10-30 18:17:16"
		

더 많은 명령줄 옵션은 man journalctl 또는 https://www.freedesktop.org/software/systemd/man/journalctl.html 에서 확인하세요.

[2022-01-31T01:22:31,077][INFO ][o.e.n.Node               ] [instance-0000000123] starting ...
...
[2022-01-31T01:37:15,077][INFO ][o.e.n.Node               ] [instance-0000000123] stopping ...
[2022-01-31T01:37:15,079][INFO ][o.e.n.Node               ] [instance-0000000123] closing ...
[2022-01-31T01:37:15,080][INFO ][o.e.n.Node               ] [instance-0000000123] closed
		

Jan 31 01:22:30 debian systemd[1]: Starting Elasticsearch...
Jan 31 01:37:15 debian systemd[1]: elasticsearch.service: Start operation timed out. Terminating.
Jan 31 01:37:15 debian systemd[1]: elasticsearch.service: Main process exited, code=killed, status=15/TERM
Jan 31 01:37:15 debian systemd[1]: elasticsearch.service: Failed with result 'timeout'.
Jan 31 01:37:15 debian systemd[1]: Failed to start Elasticsearch.
		

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

• 다음에 사용할 TLS 인증서를 생성합니다. 전송 및 HTTP 계층
• 다음에 TLS 구성 설정을 적용합니다. elasticsearch.yml
• Kibana를 Elasticsearch에 안전하게 연결할 등록 토큰을 생성합니다.

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

Elasticsearch는 터미널이 아닌 systemd 에서 실행되므로 Elasticsearch를 처음 시작할 때 elastic 슈퍼유저 비밀번호가 출력되지 않습니다. 다음 elasticsearch-reset-password 도구를 사용하여 사용자의 비밀번호를 설정하세요. 클러스터에서 한 번만 수행하면 되며 첫 번째 노드가 시작되는 즉시 수행할 수 있습니다.

bin/elasticsearch-reset-password -u elastic
		

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

export ELASTIC_PASSWORD="your_password"
		

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

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

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

curl --cacert /etc/elasticsearch/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"
}
		

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

클러스터의 각 노드에서 다음 단계를 수행하세요.

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

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

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

다음 /etc/elasticsearch 디렉터리에는 Elasticsearch의 기본 런타임 구성이 있습니다. 패키지 설치 시 이 디렉터리와 포함된 모든 파일의 소유권은 root:elasticsearch 로 설정됩니다.

다음 setgid 플래그는 Elasticsearch가 포함된 모든 파일과 하위 디렉터리를 읽을 수 있도록 /etc/elasticsearch 디렉터리에 그룹 권한을 적용합니다. 모든 파일과 하위 디렉터리는 root:elasticsearch 소유권을 상속합니다. 이 디렉터리나 하위 디렉터리에서 다음과 같은 명령을 실행하려면 elasticsearch-keystore 도구에 root:elasticsearch 권한이 필요합니다.

Elasticsearch는 기본적으로 /etc/elasticsearch/elasticsearch.yml 파일에서 구성을 로드합니다. 이 구성 파일의 형식은 Elasticsearch 구성에서 설명합니다.

RPM 패키지에는 다음 경로에 시스템 구성 파일도 있습니다.

/etc/sysconfig/elasticsearch
		

이 파일에서 다음 매개변수를 설정할 수 있습니다.

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

/etc/elasticsearch/certs/http_ca.crt
		

이 인증서의 16진수 인코딩 SHA-256 지문도 터미널에 출력됩니다. 다음 Elasticsearch 클라이언트, Beats, 독립 실행형 Elastic Agent, Logstash 등 Elasticsearch에 연결하는 모든 클라이언트는 Elasticsearch가 HTTPS에 사용하는 인증서를 신뢰하는지 검증해야 합니다. Fleet Server 및 Fleet 관리형 Elastic Agent는 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 노드의 다음 디렉터리에 생성됩니다.

/etc/elasticsearch/certs/http_ca.crt
		

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

RPM은 구성 파일, 로그, 데이터 디렉터리를 RPM 기반 시스템의 적절한 위치에 배치합니다.

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

• Elasticsearch를 구성하는 방법을 알아보세요.
• 중요한 Elasticsearch 설정을 구성하세요.
• 다음을 설치하세요: Kibana. 모든 Elastic 솔루션을 위한 사용자 인터페이스입니다.

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

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