Windows에서 Elasticsearch, Kibana 설치하기(8.7.1버전)

 

엘라스틱서치, 키바나 다운로드

 

https://www.elastic.co/kr/downloads/elasticsearch

Download Elasticsearch

 

https://www.elastic.co/kr/downloads/kibana

Download Kibana Free | Get Started Now

 

 

Windows를 클릭하면 zip 파일을 받을 수 있다. Docker image로 설치해도 된다.

 

그리고 원하는 경로에 압축을 풀어주자.

 

이때 버전을 선택하는 것은 매우 중요하다.

 

버전에 따라서 호환이 안되는 경우가 많기 때문에 꼭 자신이 사용하려는 프레임워크에서 지원하는 버전을 다운받자.

 

스프링같은 경우는 아래와 같다. 참고로 필자는 8.7.1 버전을 다운받았다.

 

그리고 엘라스틱서치 8 버전부터는 HTTPS에서 SSL/TLS 인증이 디폴트로 설정되어있다는 점을 참고하자.

 

 

엘라스틱서치 설치 방법

 

압축을 풀어준 뒤에, cmd 창을 열고 아래와 같이 명령어를 입력하자.

 

bin/elasticsearch

 

그럼 설치가 시작될 것이다.

 

이때 처음 설치한다면, password, fingerprint, enrollment token에 대한 로그가 나오는데, 꼭 복사해놓자.

 

아래처럼 health가 green으로 되면 성공이다.

 

그리고 https://localhost:9200으로 접속해서 사용자 이름 elastic(디폴트)과 아까 복사해놓은 비밀번호를 입력한다.

 

아래와 같이 나오면 성공이다.

 

 

리눅스 터미널에 curl -k https://localhost:9200 -u elastic 명령어를 치고, 비밀번호를 입력해도

 

똑같이 확인해볼 수 있다.

 

curl 명령어는 기본적으로 https 사이트의 SSL 인증서를 검증한다.

 

-k 옵션을 사용하면 https 사이트를 SSL 검증없이 연결할 수 있다.

 

 

키바나 설치 방법

 

cmd 창을 하나 더 열고, 아래와 같이 명령어를 입력하자

 

bin/kibana

 

설치 중이다. 처음이면 kibana가 설정이 되지 않았다고 뜬다.

 

아래 링크로 들어가자.

 

그럼 이런 화면이 나오는데, 아까 복사해준 enrollment token을 입력해주자.

 

만약, 미리 복사해두지 않았다면 아래와 같은 명령어를 elastic cmd에 입력해서 새로 받을 수 있다.

 

enrollment-token 재 생성

 

elasticsearch-create-enrollment-token -s kibana

 

비밀번호 재 생성

 

elasticsearch-reset-password -u elastic

 

커맨드 라인 보기

 

https://www.elastic.co/guide/en/elasticsearch/reference/current/commands.html

Command line tools | Elasticsearch Guide [8.8] | Elastic

 

Configuring 하고 있는 화면

 

username과 password를 입력하자.

 

아래와 같이 kibana에 접속되면 성공이다.

 

vm.max_map_count 이슈

 

설치하면서 많은 실패를 겪었는데, 처음에 docker image로 다운받으면서 아래와 같은 error가 발생했다.

 

vm.max_map_count가 65530으로 설정되어 있는데, 262144 이상으로 수정이 필요하다는 내용인데.

 

엘라스틱서치는 대량의 데이터를 처리하기 위해 Lucene 인덱스를 사용하는데, 이를 위해 많은 수의 가상 메모리 매핑이 필요하다.

 

따라서 Elasticsearch 실행 전에 Elasticsearch의 설정 파일(elasticsearch.yml)에 등록된 값과 로컬 시스템의 가상 메모리 매핑 제한(vm.max_map_count)을 비교하는데, 이것을 bootstrap check라고 한다.

 

vm.max_map_count  해결 방법

 

가상 메모리 매핑 제한을 올려주기 위해서,

 

ubuntu를 실행해주고,

 

sudo vi /etc/sysctl.conf

 

비밀번호 입력

 

vi 편집기에서 i (입력 모드)를 입력

 

vm.max_map_count=262144 입력

 

sudo sysctl -p 로 정상적으로 바뀌었는지 확인할 수 있다.

 

이제 vm.max_map_count 값이 영구적으로 변경되었다. 시스템이 재부팅되더라도 설정은 유지된다.