Elasticsearch(엘라스틱서치) bootstrap check failed 해결

 

Elasticsearch(엘라스틱서치)를 테스트 환경이 아닌 운영에서 실행 할때 Bootstrap check를 실시하게 된다. 

 

elasticsearch.yml > network.host: "site" 지정 하면 외부로 서비스가 되면서 bootstrap이 발동하고 > 에러가 발생하게 된다.

 

 

자주 만나게 되는 체크 항목은 아래와 같다.

 

1) max file descriptors

2) max virtual memory areas

3) [1] of [1]: memory locking requested for elasticsearch process but memory is not locked

ERROR: [2] bootstrap checks failed. You must address the points described in the following [2] lines before starting Elasticsearch.
bootstrap check failure [1] of [2]: max file descriptors [4096] for elasticsearch process is too low, increase to at least [65535]
bootstrap check failure [2] of [2]: max virtual memory areas vm.max_map_count [65530] is too low, increase to at least [262144]
ERROR: Elasticsearch did not exit normally - check the logs at /home/server1/elasticsearch-7.15.0/logs/es-cluster.log

 

3가지 Boostrap check의 해결 방법을 살펴보자.

 

1) max file descriptors

• sudo vi /etc/security/limits.conf > server1 - nofile 65535 설정
• server1은 자새

 

• id 커맨드로 사용자(user) 확인

• 참고문서: File Descriptors

File Descriptors | Elasticsearch Guide [7.15] | Elastic

 

만약 sudo vi /etc/security/limits.conf > server1 - nofile 65535 설정을 해도 open files의 값이 변경이 안될 때는 Ubuntu OS의 버그일 수도 있다. 그럴 땐 아래와 같이 설정을 해주고 다시 시도해 본다.

Edit /etc/systemd/user.conf for the soft limit, and add DefaultLimitNOFILE=1048576.
Edit /etc/systemd/system.conf for the soft limit, and add DefaultLimitNOFILE=2097152.

- 참고문서: https://unix.stackexchange.com/questions/366352/etc-security-limits-conf-not-applied

/etc/security/limits.conf not applied

 

2) max virtual memory areas

• sudo vi /etc/sysctl.conf > vm.max_map_count=262144 세팅(sudo 관리자로 해야함)
  • 참고: https://www.elastic.co/guide/en/elasticsearch/reference/current/vm-max-map-count.html

3) [1] of [1]: memory locking requested for elasticsearch process but memory is not locked

• sudo vi /etc/security/limits.conf 
• server1 soft memlock unlimited / server1  hard memlock unlimited 설정