Ubuntu (우분투) 에 OpenSearch (오픈서치) 설치하기

운영환경이 Ubuntu로 픽스되어 해당 운영체제에 Opensearch를 설치를 하게 되었습니다.

apt-get을 통해 손쉽게 다운로드 할 수 있는 상황도 있겠으나, 저는 배포판(tar)를 다운받아 설치하는 방법을 알아보려 합니다.

운영체제 환경은 위와 같습니다.

Ubuntu 20.04.4 LTS 버전이 깔려있군요..22버전으로 업그레이드를 했어도 됐으나 이미 설치되어있으니 그냥 해보죠.

 

우선 Opensearch를 다운받아야겠지요?

아래 사이트로 접속합니다.

Opensearch 2.11.1

살짝 아래로 내려보면 OpenSearch를 다운로드 받는 버튼이 보이며 플랫폼과 패키지를 선택 후 다운로드 해주면 됩니다.

저는 .tar.gz으로 다운로드 하였습니다.

다운로드가 완료되었네요. 다운로드 받는 김에 OpenSearch Dashboard도 다운로드 받았습니다. 우선 이번 글에선 OpenSearch만 설치하도록 하겠습니다. 받은 압축을 풀어줍니다.

그럼 폴더 내부에 opensearch-tar-install.sh이 실행하고 싶게끔 생겼습니다.

shell을 실행해보겠습니다. 에러가 발생합니다!

[OpenSearch] Accessdenied Exception: opensearch.keystore 오류 해결하기!

OpenSearch의 경우 install 시 root 권한으로 실행하면 설치가 되지 않습니다.

권한을 변경해줍니다.

> chown -R 사용자:사용자 [폴더이름]

 

변경완료 후 다시 한번 shell을 실행해줍니다.

...(생략)...
Node 'Workstation' initialized

설치가 완료되었습니다.

 

로컬에서는 접속이 가능한 상황입니다. localhost에 9200번으로 접근해봅니다.

외부에서 접속을 해볼까요? 해당 리눅스 서버로 9200번 포트에 접근을 해봅니다.

에러가 발생합니다. 확인해보니 외부 접속에 대한 설정을 해놓지 않았군요.

외부 접속에 대한 설정은 아래 게시글을 참고해주시면 됩니다 😁

[OpenSearch] OpenSearch 설치 오류 : discovery.seed_hosts, discovery.seed_providers, cluster.initial_cluster_manager_nodes /

 

설치가 완료되었습니다. 이제 외부에서 접근을 해보겠습니다.

외부 접근 완료! OpenSearch를 활용할 수 있는 준비는 끝났습니다.

 

만약 OpenSearch를 사용하실 때 data나 logs폴더를 변경하고 싶으시다면 아래 opensearch.yml파일에서 paths의 data와 logs 경로를 수정해주시면 됩니다!

// 경로는 opensearch 폴더 내 config/ 안에 있는 opensearch.yml입니다.
...(생략)...
# ----------------------------------- Paths ------------------------------------
#
# Path to directory where to store the data (separate multiple locations by comma):
#
path.data: /data/opensearch/data
#
# Path to log files:
#
path.logs: /data/opensearch/logs
...(생략)...

 

원래는 위에 .data와 .logs의 경로가 주석처리가 되어있습니다.

그대로 사용하면 opensearch가 설치된 폴더 내에 data폴더와 logs폴더가 생기며 그쪽으로 데이터가 적재되어 용량을 차지하게 됩니다.

파티션이 분할된 리눅스 환경이라면 해당 경로를 확인하시어 수정하시면 됩니다~!

 

참고로 Opensearch 설정 완료 후에 구동하시다 아래와 같은 오류를 만나실 수도 있습니다🤔

ERROR: [1] bootstrap checks failed
[1]: max virtual memory areas vm.max_map_count [65530] is too low, increase to at least [262144]
ERROR: OpenSearch did not exit normally - check the logs at /home/user/opensearch/opensearch-2.11.1/logs/opensearch.log

자세하게 오류 내용을 읽어보니 'vm.max_map_count'의 크기가 너무 작다고 하는군요!

이걸 Opensearch에서 원하는 크기인 262144로 맞춰줍니다.

> sudo sysctl -w vm.max_map_count=262144

다시 Opensearch를 다시 구동해보시면 정상적으로 뜨는 것을 확인할 수 있습니다 😆

 

이제 대시보드를 설치해보죠!