virtualbox ubuntu 22.04에 elastic search 설치 후 원격 요청 테스트

설치 환경) virtual box - ubuntu 22.04 (cpu2, memory 4g)
 

설치 파일 다운로드

Elastic 설치 파일 링크를 확인하기 위해 Elastic Search 공식 홈페이지에 접속합니다.
https://www.elastic.co/kr/downloads/past-releases#elasticsearch

Past Releases of Elastic Stack Software

저는 8.13.4 버전 다운로드를 클릭하고 deb 파일의 링크를 복사했습니다. 
https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-8.13.4-amd64.deb

우분투 설치파일은 DEB 사용

 
이제 서버에 접속해서 링크를 사용해서 파일을 다운로드합니다.

wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-8.13.4-amd64.deb

설치 진행

sudo dpkg -i elasticsearch-8.13.4-amd64.deb

 
설치가 완료되면 초기 elastic user의 비밀번호가 생성됩니다.

elastic(superuser)의 비밀번호를 메모해 놓지 않은 경우 `/usr/share/elasticsearch/bin/elasticsearch-reset-password -u elastic` 명령어로 비밀번호를 초기화 할 수 있습니다.
 

방화벽 설정

기본 포트인 9200 포트를 허용합니다. (`sudo apt install firewalld`로 설치 후 진행)

sudo firewall-cmd --permanent --zone=public --add-port=9200/tcp
sudo firewall-cmd --reload
sudo firewall-cmd --list-ports

서비스 실행

es 유저 생성

서비스 실행에 앞서 root 권한을 가진 유저로는 elastic search 실행이 불가능하여 es라는 유저를 생성하여 진행했습니다.

# root 계정으로 전환 (이미 root 계정이면 불필요)
sudo su -
# root 계정에서 실행
useradd -m es

elastic search에 필요한 폴더들의 권한을 es로 변경합니다.

# elaticsearch 관련 디렉터리의 소유자를 es로 변경
chown -R es:es /var/log/elasticsearch
chown -R es:es /var/lib/elasticsearch
chown -R es:es /usr/share/elasticsearch
chown -R es:es /etc/elasticsearch
chown -R es:es /etc/default/elasticsearch

서비스 작성

서비스를 es 사용자에서 실행되도록 작성합니다. User와 Group 에 es를 표기합니다.

vi /etc/systemd/system/elasticsearch.service

[Unit]
Description=Elasticsearch
Documentation=https://www.elastic.co
Wants=network-online.target
After=network-online.target

[Service]
Environment=ES_HOME=/usr/share/elasticsearch
Environment=ES_PATH_CONF=/etc/elasticsearch
Environment=PID_DIR=/var/run/elasticsearch
Environment=ES_SD_NOTIFY=true
EnvironmentFile=-/etc/default/elasticsearch

WorkingDirectory=/usr/share/elasticsearch

User=es
Group=es

ExecStart=/usr/share/elasticsearch/bin/elasticsearch -p ${PID_DIR}/elasticsearch.pid --quiet
ExecReload=/bin/kill -HUP $MAINPID

TimeoutStopSec=0
KillMode=process
KillSignal=SIGQUIT
SendSIGKILL=no
SuccessExitStatus=143

LimitNOFILE=65535
LimitNPROC=4096
LimitAS=infinity
LimitFSIZE=infinity
TimeoutStartSec=75
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

서비스 파일 권한 설정 및 서비스 활성화

sudo chmod 644 /etc/systemd/system/elasticsearch.service
sudo systemctl daemon-reload
sudo systemctl enable elasticsearch.service

서비스 실행

sudo systemctl start elasticsearch.service
sudo systemctl status elasticsearch.service

 
여기서 간헐적으로 재시동 되는 경우 로그를 확인합니다. (root 계정에서 확인)

tail -100 /var/log/elasticsearch/elasticsearch.log
tail -100 /var/log/elasticsearch/gc.log

저의 경우 vm의 사양이 낮아 Elasticsearch의 힙 메모리 설정을 조정하였습니다.
(주석처리 되어있던 부분 -Xms1g, -Xmx1g 로 수정)

# root 계정에서 실행
systemctl stop elasticsearch
vi /etc/elasticsearch/jvm.options
systemctl start elasticsearch

 
그럼에도 불구하고 에러가 나서 로그를 확인하니 /var/run/elasticsearch 폴더에 권한이 없어서 에러가 발생했습니다.
서비스를 다시 종료하고 권한을 부여해서 정상적으로 실행되었습니다.

systemctl stop elasticsearch
chown -R es:es /var/run/elasticsearch
systemctl start elasticsearch

원격 접속 테스트

위에 작업까지 하면 설치와 정상 실행까지 완료되고, 이제 원격 테스트를 해보겠습니다.
로컬 터미널을 하나 더 열어서 localhost로 정상작동하는지 테스트합니다.

curl -X GET -k -u elastic:[password] https://localhost:9200

같은 로컬 네트워크가 아닌 원격 접속을 허용하기 위해서는 config 파일을 수정해야 합니다. 
config 폴더 내의 elasticsearch.yml 파일 수정 - network.host 를 0.0.0.0으로 수정합니다.

# config 폴더 내의 elasticsearch.yml 파일 수정
vi /etc/elasticsearch/elasticsearch.yml

수정 후 서비스를 재기동합니다.

service elasticsearch restart

 
vm 서버 밖 (윈도우 로컬) 에서 curl 요청시 정상적으로 작동하는 것을 확인할 수 있습니다.

curl -X GET -k -u elastic:[password] https://[vm ip]:9200

 
저는 vm 네트워크 포트포워딩 설정에서 9200 포트를 추가해주었습니다. (vm 네트워크 포트포워딩 으로 검색하여 나온 게시글들을 참고하여 설정)

 
여기까지 elastic search를 virtual box에 설치해보고 외부에서 호출하는 테스트까지 수행해보았습니다.
감사합니다.