Elasticsearch MacOS 로컬 설치 및 환경설정 방법

Elastic Search를 Mac 환경에서 로컬 설치해보자. 설치 방법은 크게 두가지 있다.

1. Elasticsearch 공식 홈페이지에서 tar.gz 다운로드 받아 설치
2. mac OS brew command로 설치

1. 파일 다운로드

Elasticsearch 공식 홈페이지에서 제공하는 다운로드 페이지 접속해서 choose platform macOS 선택하고 다운로드 받는다.

다운로드 페이지

Download Elasticsearch

 

Choose platform에서 macOS 선택란이 아래와 같이 두 가지가 있는데 내 맥북 환경에 맞는걸 선택하여 다운로드 한다.

• macOS x86_64 : CPU Intel 칩
• macOS aarch64 : CPU M1/M2 칩

직접 확인해보려면 터미널에

arch

입력해보면 알 수 있다. 내 맥북은 M1칩에 arch command 결과로 arm64가 나왔다.

 

2. 압축 해제

다운로드 받은 tar.gz 파일을 압축을 풀고자 하는 디렉토리에 이동 후 아래 커맨드로 압축 해제.

tar -xvf elasticsearch-8.7.0-darwin-aarch64.tar.gz

 

3. Elasticsearch 수행

./elasticsearch-8.7.0/bin/elasticsearch

 

위와 같이 뜨면 성공

 

수행 중 ElasticsearchException

수행하였을 때, 아래와 같은 ERROR가 발생했을 경우에는

[2022-10-05T17:00:49,525][ERROR][o.e.i.g.GeoIpDownloader  ] [AL02273438.local] exception during geoip databases updateorg.elasticsearch.ElasticsearchException: not all primary shards of [.geoip_databases] index are active
    at org.elasticsearch.ingest.geoip@8.4.2/org.elasticsearch.ingest.geoip.GeoIpDownloader.updateDatabases(GeoIpDownloader.java:134)
    at org.elasticsearch.ingest.geoip@8.4.2/org.elasticsearch.ingest.geoip.GeoIpDownloader.runDownloader(GeoIpDownloader.java:274)
    at org.elasticsearch.ingest.geoip@8.4.2/org.elasticsearch.ingest.geoip.GeoIpDownloaderTaskExecutor.nodeOperation(GeoIpDownloaderTaskExecutor.java:102)
    at org.elasticsearch.ingest.geoip@8.4.2/org.elasticsearch.ingest.geoip.GeoIpDownloaderTaskExecutor.nodeOperation(GeoIpDownloaderTaskExecutor.java:48)
    at org.elasticsearch.server@8.4.2/org.elasticsearch.persistent.NodePersistentTasksExecutor$1.doRun(NodePersistentTasksExecutor.java:42)

See logs for more details.

elasticsearch.yml 파일 하단에 ingest.geoip.downloader.enabled: false 옵션 설정

vim ~/config/elasticsearch.yml

[https://localhost:9200](https://localhost:9200) 접속하면 user, password 뜨는 란이 있는데 이건 초기화하거나 xpack.security.enabled: false 을 주면 [http://localhost:9200](http://localhost:9200) 접근가능.

➜ curl -XGET 127.0.0.1:9200
{
  "name" : "local",
  "cluster_name" : "elasticsearch",
  "cluster_uuid" : "KaXzu4oJRj-QcAmu8zr5WQ",
  "version" : {
    "number" : "8.4.2",
    "build_flavor" : "default",
    "build_type" : "tar",
    "build_hash" : "89f8c6d8429db93b816403ee75e5c270b43a940a",
    "build_date" : "2022-09-14T16:26:04.382547801Z",
    "build_snapshot" : false,
    "lucene_version" : "9.3.0",
    "minimum_wire_compatibility_version" : "7.17.0",
    "minimum_index_compatibility_version" : "7.0.0"
  },
  "tagline" : "You Know, for Search"
}

정상적으로 생성됨을 확인