Server Developer

1. 설치

설치한 버전은 작성일(22.8.18)기준으로 가장 최신버전인 8.3.3 이다.

설치 참고(https://www.elastic.co/guide/en/kibana/8.3/targz.html)

curl -O https://artifacts.elastic.co/downloads/kibana/kibana-8.3.3-linux-x86_64.tar.gz
curl https://artifacts.elastic.co/downloads/kibana/kibana-8.3.3-linux-x86_64.tar.gz.sha512 | shasum -a 512 -c -
tar -xzf kibana-8.3.3-linux-x86_64.tar.gz

설치 방식은 Elasticsearch와 유사 하다.

압축을 푼 후 생성되는 폴더는 kibana-8.3.3으로 해당 디렉토리는 $KIBANA_HOME이 된다.

구성은 아래와 같다.

bin  config  data  LICENSE.txt  logs  node  node_modules  NOTICE.txt  package.json  plugins  README.txt  src  x-pack

2. 기본 설정 및 파일 수정

외부 접근을 허용해 주기 위해 다음과 같이 진행하였다.

cd kibana-8.3.3
vi config/kibana.yml

kibana.yml 파일 수정

server.port: 5601
server.host: "0.0.0.0"

server.host의 값이 기본 세팅이 localhost로 되어 있는데 해당 값을 "0.0.0.0"으로 수정되어야 한다.

3. 키바나 실행

초반 키바나 설치 삭제만 여러번하고 나서 오류들을 찾아보던 중 ELK가 생각보다 높은 사양으로 돌아가고 현재 사용하던 AWS서버의 사양에 돌아가지 않는다는 것을 깨달았다....

권장 사양 참조 : https://www.google.com/search?q=elasticsearch+%EA%B6%8C%EC%9E%A5+%EC%82%AC%EC%96%91

또한 OS별로 지원되는 ES와 Kibana 사양이 다르니 참고 해야한다. (https://www.elastic.co/kr/support/matrix)

위에 내용대로 새로운 AWS 서버에 설치하고 나니 Elasticsearch와 키바나가 실행되었다.

실행하고 아래 주소 접근하면 된다.

1. http://(ip주소):5601

2. 또는 키바나는 실행했을 때 뜨는 링크(http://(ip주소):5601/?code=(랜덤6자리))로 접속해도 된다.

위의 링크로 접근이 되지 않으면 먼저 방화벽을 확인해보아야한다. 해당 포트인 5601포트가 열려 있어야한다. 포트여는 내용은 생략한다.

접속하면 토큰값을 입력하라는 안내문구를 볼 수 있다. 해당 토큰은 Elasticsearch를 처음 실행했을 때 뜨는 토큰을 넣어주면 된다.

ℹ️  Configure Kibana to use this cluster:
• Run Kibana and click the configuration link in the terminal when Kibana starts.
• Copy the following enrollment token and paste it into Kibana in your browser (valid for the next 30 minutes):
<kibana token>

1번으로 접근했을 때는 6자리 숫자를 입력해주는 단계를 한번 더 거친다. 해당값은 키바나 창에서 볼 수 있다.

위의 토큰 문구에서 확인할 수 있듯 토큰값을 입력하는 제한시간이 30분이므로 주의하자.

필자는 키바나 설치하고 다른 테스트 중에 다시 압축을 풀어서 config 폴더의 kibana.yml 파일을 덮어씌워버리는 실수를 해버렸다.. 복사를 해두던가 했어야 했는데 그대로 날려서 토큰을 재발급 받았어야했다.... 관련내용은 다음 글에 작성하려한다.

위에 과정 후 로그인이 뜨는데 처음에 생성된 사용자 값은 Elasticsearch에서 복사해두었던 토큰값과 같이 있다.

ℹ️  Password for the elastic user (reset with `bin/elasticsearch-reset-password -u elastic`):
<암호>

위내용은 id(user name): elastic pw:<암호> 가 된다.

해당값으로 접근하면 아래와 같이 확인할 수 있다.

검색엔진 시스템을 구축하기 위해 사용한 Elasticsearch의 설치 과정을 기록한다.

Elasticsearch 공식 홈페이지에서 한글판 가이드를 보았는데, 버전이 5.4 였다..

해당 버전 가이드를 보면서 JDK 부터 설치해야 한다고 하길래 검색하던 중 Elasticsearch 7.0 버전부터는 필요한 open-jdk가 포함되어있어 설치를 먼저 진행하지 않아도 된다고 한다. (권장 JDK 버전 정보 : https://www.elastic.co/kr/support/matrix#matrix_jvm )

가이드를 찾아보니 최신 버전의 가이드는 영어로 버전 8.3까지 나와있다. [ 링크 https://www.elastic.co/guide/en/elasticsearch/reference/current/targz.html ]

해당 글을 작성할 때 v8.3.2로 나와있어 해당 버전으로 작업하였다.

추가적으로 Elastic 가이드북( https://esbook.kimjmin.net/02-install/2.2/2.2.1-download-install )을 참고하여 실행파일을 만들어 사용하였다.

1. 설치

압축파일 설치

$ wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-8.3.2-linux-x86_64.tar.gz

2. 해시 검증

- 해당 과정은 파일이 제대로 받아졌는지 확인하는 기능이라고 보면 된다.

$ wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-8.3.2-linux-x86_64.tar.gz.sha512
$ shasum -a 512 -c elasticsearch-8.3.2-linux-x86_64.tar.gz.sha512
-- 결과
elasticsearch-8.3.2-linux-x86_64.tar.gz: OK

3. 압축 풀기

tar -xzf elasticsearch-8.3.2-linux-x86_64.tar.gz

4. 실행

cd elasticsearch-8.3.2/
./bin/elasticsearch

여기서 elasticsearch-8.3.2 폴더는 $ES_HOME이다.

실행 종료는 Ctrl+C

4.1. 백그라운드 실행

-- 실행
$ ./bin/elasticsearch -d

-- 백그라운드로 실행중인 Elaticsearch 프로세스 검색
$ ps -ef | grep elasticsearch

-- 로그
$ head logs/elasticsearch.log

-- 종료
$ kill {프로세스ID}

종료 시 사용하는 프로세스 ID는 프로세스를 검색했을 때 확인할 수 있다.

-p {파일명} 을 사용하면 실행한 프로세스 ID를 특정 파일에 저장할 수 있다. 이를 이용하여 실행파일, 종료 파일을 만들 수 있다.

-- 백그라운드 실행 후 프로세스 ID 저장
$ ./bin/elasticsearch -d -p es.pid
-- 파일 내용확인
$ cat es.pid

실행 파일 start.sh

./bin/elasticsearch -d -p es.pid

종료 파일 stop.sh

kill `cat es.pid`

위 두 파일의 권한은 실행할 수 있도록 755로 변경해둔다.

$ echo './bin/elasticsearch -d -p es.pid' > start.sh
$ echo 'kill `cat es.pid`' > stop.sh
$ chmod 755 start.sh stop.sh

주의!!

Elasticsearch를 처음 실행했을 때 토큰값이 여러가지 뜬다. 해당 값을 복사해두자. 없으면 나중에 새로 발급받고 수정해야해서 복잡해진다..!