Installing OpenSearch Dashboards on Debian
출처: 문서
본문
{% comment %} The following liquid syntax declares a variable, major_version_mask, which is transformed into "N.x" where "N" is the major version number. This is required for proper versioning references to the Yum repo. {% endcomment %} {% assign version_parts = site.opensearch_major_minor_version | split: "." %} {% assign major_version_mask = version_parts[0] | append: ".x" %}
Debian에 OpenSearch Dashboards 설치
APT(Advanced Packaging Tool) 패키지 관리자를 사용해 OpenSearch Dashboards를 설치하면 Tarball 방식에 비해 절차가 훨씬 간단해요. 예를 들어 패키지 관리자는 설치 경로, 설정 파일 위치, systemd가 관리하는 서비스 생성 같은 여러 기술적인 고려 사항을 알아서 처리해 줘요.
이 가이드는 Linux 명령줄 인터페이스(CLI)에서 작업하는 데 익숙하다고 가정해요. 명령어 입력, 디렉터리 간 이동, 텍스트 파일 편집 방법을 알고 있어야 해요. 일부 예제 명령어에서는 vi 텍스트 편집기를 언급하지만, 사용할 수 있는 어떤 텍스트 편집기를 써도 괜찮아요.
{:.note}
사전 요구 사항
OpenSearch를 설치하세요. 자세한 내용은 Debian에 OpenSearch 설치를 참고하세요.
패키지로 OpenSearch Dashboards 설치
-
원하는 버전의 Debian 패키지를 OpenSearch 다운로드 페이지{:target='_blank'}에서 직접 다운로드하세요. Debian 패키지는 x64와 arm64 아키텍처 모두에 대해 다운로드할 수 있어요.
-
CLI에서
dpkg를 사용해 설치하세요.x64:
sudo dpkg -i opensearch-dashboards-{{site.opensearch_dashboards_version}}-linux-x64.deb{% include copy.html %}
arm64:
sudo dpkg -i opensearch-dashboards-{{site.opensearch_dashboards_version}}-linux-arm64.deb{% include copy.html %}
OpenSearch Dashboards 3.7 이상을 새로 설치하는 경우, 설치 명령 앞에
env키워드를 붙여DISABLE_SECURITY_DASHBOARDS_PLUGIN=true환경 변수를 추가하면 Security Dashboards 플러그인을 비활성화할 수 있어요:sudo env DISABLE_SECURITY_DASHBOARDS_PLUGIN=true dpkg -i opensearch-dashboards-{{site.opensearch_dashboards_version}}-linux-x64.deb{% include copy.html %}
-
설치가 완료되면
systemd매니저 설정을 다시 불러오세요:sudo systemctl daemon-reload{% include copy.html %}
-
OpenSearch Dashboards를 서비스로 활성화하세요:
sudo systemctl enable opensearch-dashboards{% include copy.html %}
-
OpenSearch Dashboards 서비스를 시작하세요:
sudo systemctl start opensearch-dashboards{% include copy.html %}
-
OpenSearch Dashboards가 올바르게 실행됐는지 확인하세요:
sudo systemctl status opensearch-dashboards{% include copy.html %}
-
웹 브라우저에서
http://localhost:5601로 이동한 뒤, OpenSearch를 설치할 때 설정한 커스텀 관리자 비밀번호를 사용해admin사용자로 로그인하세요. OpenSearch Dashboards가 원격 호스트에서 실행 중이라면localhost를 해당 호스트의 IP 주소나 DNS 이름으로 바꾸세요. 자세한 내용은 OpenSearch Dashboards 접근하기를 참고하세요.
지문(fingerprint) 검증
Debian 패키지는 서명되어 있지 않아요. 지문을 검증하고 싶다면, OpenSearch Project에서 GNU Privacy Guard(GPG)로 사용할 수 있도록 .sig 파일과 .deb 패키지를 함께 제공해요.
-
원하는 Debian 패키지를 다운로드하세요:
curl -SLO https://artifacts.opensearch.org/releases/bundle/opensearch-dashboards/{{site.opensearch_dashboards_version}}/opensearch-dashboards-{{site.opensearch_dashboards_version}}-linux-x64.deb{% include copy.html %}
-
대응하는 서명 파일을 다운로드하세요:
curl -SLO https://artifacts.opensearch.org/releases/bundle/opensearch-dashboards/{{site.opensearch_dashboards_version}}/opensearch-dashboards-{{site.opensearch_dashboards_version}}-linux-x64.deb.sig{% include copy.html %}
-
GPG 키를 다운로드해 임포트하세요:
curl -o- https://artifacts.opensearch.org/publickeys/opensearch-release.pgp | gpg --import -{% include copy.html %}
-
서명을 검증하세요:
gpg --verify opensearch-dashboards-{{site.opensearch_dashboards_version}}-linux-x64.deb.sig opensearch-dashboards-{{site.opensearch_dashboards_version}}-linux-x64.deb{% include copy.html %}
APT 저장소에서 OpenSearch Dashboards 설치
Debian 기반 운영 체제의 대표적인 패키지 관리 도구인 APT를 사용하면 APT 저장소에서 Debian 패키지를 다운로드해 설치할 수 있어요.
-
필요한 패키지를 설치하세요:
sudo apt-get update && sudo apt-get -y install lsb-release ca-certificates curl gnupg2{% include copy.html %}
-
keyrings 디렉터리가 아직 없다면 새로 만드세요:
sudo mkdir -p /etc/apt/keyrings{% include copy.html %}
-
공개 GPG 키를 임포트하세요. 이 키는 APT 저장소가 서명되었는지 검증하는 데 사용돼요.
curl -o- https://artifacts.opensearch.org/publickeys/opensearch-release.pgp | sudo gpg --dearmor --batch --yes -o /etc/apt/keyrings/opensearch-release-keyring{% include copy.html %}
-
OpenSearch Dashboards용 APT 저장소를 만드세요:
echo "deb [signed-by=/etc/apt/keyrings/opensearch-release-keyring] https://artifacts.opensearch.org/releases/bundle/opensearch-dashboards/{{major_version_mask}}/apt stable main" | sudo tee /etc/apt/sources.list.d/opensearch-dashboards-{{major_version_mask}}.list{% include copy.html %}
-
저장소가 성공적으로 생성됐는지 확인하세요:
sudo apt-get update{% include copy.html %}
-
(선택 사항) 2024년 5월 22일부로 APT 저장소의
Origin과Label값이 이 변경 사항의 일환으로 업데이트됐어요. 이 날짜 이전에 APT 저장소를 생성했다면, 다음 명령어를 실행해 업데이트된 릴리스 정보를 수락하세요:sudo apt-get update --allow-releaseinfo-change{% include copy.html %}
-
저장소 정보가 추가되면, 사용 가능한 OpenSearch Dashboards 버전을 모두 나열해 보세요:
sudo apt list -a opensearch-dashboards{% include copy.html %}
-
설치하려는 OpenSearch Dashboards 버전을 선택하세요:
- 별도로 지정하지 않으면 사용 가능한 최신 버전의 OpenSearch Dashboards가 설치돼요:
sudo apt-get install opensearch-dashboards{% include copy.html %}
- 특정 버전의 OpenSearch Dashboards를 설치하려면 패키지 이름 뒤에 버전 번호를 붙이세요:
sudo apt-get install opensearch-dashboards={{site.opensearch_dashboards_version}}{% include copy.html %}
-
완료되면 OpenSearch Dashboards를 활성화하세요:
sudo systemctl enable opensearch-dashboards{% include copy.html %}
-
OpenSearch Dashboards를 시작하세요:
sudo systemctl start opensearch-dashboards{% include copy.html %}
-
OpenSearch Dashboards가 올바르게 실행됐는지 확인하세요:
sudo systemctl status opensearch-dashboards{% include copy.html %}
-
웹 브라우저에서
http://localhost:5601로 이동한 뒤, OpenSearch를 설치할 때 설정한 커스텀 관리자 비밀번호를 사용해admin사용자로 로그인하세요. OpenSearch Dashboards가 원격 호스트에서 실행 중이라면localhost를 해당 호스트의 IP 주소나 DNS 이름으로 바꾸세요. 자세한 내용은 OpenSearch Dashboards 접근하기를 참고하세요.
(선택 사항) 다른 호스트에서의 접근 허용
기본적으로 OpenSearch Dashboards는 OpenSearch와 마찬가지로 처음 설치할 때 localhost에 바인딩돼요. 따라서 설정을 업데이트하지 않으면 원격 호스트에서 OpenSearch Dashboards에 접근할 수 없어요.
-
opensearch_dashboards.yml파일을 여세요:sudo vi /etc/opensearch-dashboards/opensearch_dashboards.yml{% include copy.html %}
-
OpenSearch Dashboards가 바인딩할 네트워크 인터페이스를 지정하세요. 사용 가능한 모든 인터페이스에 바인딩하려면
0.0.0.0을 사용하세요:server.host: 0.0.0.0{% include copy.html %}
-
저장하고 종료하세요.
-
설정 변경 사항을 적용하려면 OpenSearch Dashboards를 재시작하세요:
sudo systemctl restart opensearch-dashboards{% include copy.html %}
새 버전으로 업그레이드
dpkg나 apt-get으로 설치한 OpenSearch Dashboards 인스턴스는 더 새로운 버전으로 업그레이드할 수 있어요.
OpenSearch Dashboards를 업그레이드하기 전에 먼저 OpenSearch 클러스터를 업그레이드하세요. OpenSearch Dashboards는 연결되는 클러스터와 같은 버전으로 실행되어야 하고, 설치된 플러그인도 해당 버전과 일치해야 해요. 자세한 내용은 플러그인 호환성을 참고하세요. {: .important}
업그레이드를 위한 호스트 준비
opensearch-dashboards 패키지는 다른 Debian 패키지에 대한 의존성을 선언하지 않아요. 따라서 의존성이 해결되지 않았다는 이유로 업그레이드가 실패한다면, 그 원인은 OpenSearch Dashboards 자체가 아니라 호스트의 APT 설정에 있다는 뜻이에요. 업그레이드 명령을 실행하기 전에 다음 단계를 완료하세요.
-
APT가 HTTPS를 통해 OpenSearch Dashboards 저장소를 읽는 데 필요한 패키지를 설치하세요:
sudo apt-get update && sudo apt-get -y install lsb-release ca-certificates curl gnupg2{% include copy.html %}
-
설정을 백업해 두세요. 패키지는 다음 파일들을 설정 파일로 등록하며,
dpkg는 그중 사용자가 편집한 파일마다 유지할지 교체할지 물어봐요:/etc/opensearch-dashboards/opensearch_dashboards.yml/etc/opensearch-dashboards/node.options/etc/default/opensearch-dashboards/etc/init.d/opensearch-dashboards
기본 설정 파일을 백업하려면 다음 명령어를 실행하세요:
sudo cp /etc/opensearch-dashboards/opensearch_dashboards.yml /etc/opensearch-dashboards/opensearch_dashboards.yml.bak{% include copy.html %}
이 프롬프트에 직접 응답할 수 있도록 대화형 셸에서 업그레이드를 실행하세요. 무인 업그레이드는 프롬프트에서 멈추거나, 호스트의
Dpkg::Options에 설정된 기본 답변을 적용해 버려요. {: .note} -
패키지 목록을 새로 고치고, 더 새로운 버전이 있는지 확인하세요:
sudo apt-get update && sudo apt list -a opensearch-dashboards{% include copy.html %}
apt-get update가 공개 키를 사용할 수 없다고 보고하거나, 목록에 표시된 최신 버전이 이미 사용 중인 버전과 같다면 메이저 버전 간 업그레이드를 참고하세요.
dpkg를 사용한 수동 업그레이드
업그레이드하려는 버전의 Debian 패키지를 OpenSearch Project 다운로드 페이지{:target='_blank'}에서 직접 다운로드하세요.
배포 패키지가 들어 있는 디렉터리로 이동한 뒤 다음 명령어를 실행하세요:
sudo dpkg -i opensearch-dashboards-{{site.opensearch_dashboards_version}}-linux-x64.deb
{% include copy.html %}
이 방법은 패키지 파일을 직접 읽고 APT 저장소를 사용하지 않기 때문에, 메이저 버전 간 업그레이드에도 사용할 수 있어요. {: .tip}
apt-get을 사용한 업그레이드
사용 가능한 최신 버전의 OpenSearch Dashboards로 업그레이드하려면 다음 명령어를 실행하세요:
sudo apt-get install --only-upgrade opensearch-dashboards
{% include copy.html %}
버전 번호를 지정해서 특정 OpenSearch Dashboards 버전으로 업그레이드할 수도 있어요:
sudo apt-get install opensearch-dashboards=<version>
{% include copy.html %}
apt-get upgrade 서브커맨드는 호스트에 설치된 모든 패키지를 대상으로 동작하며 패키지를 설치하거나 제거할 수 없어요. 그래서 APT가 보류 중인 관련 없는 패키지 하나 때문에 OpenSearch Dashboards 업그레이드가 중단될 수 있어요. --only-upgrade 옵션은 작업 대상을 opensearch-dashboards 패키지로 한정해 줘요.
{: .note}
메이저 버전 간 업그레이드
설치 과정에서 만드는 저장소 정의는 하나의 메이저 버전에 고정되어 있어서, 다른 메이저 버전으로 이동하려고 해도 APT는 더 새로운 버전을 찾지 못해요. 또한 메이저 버전이 다른 저장소들은 서로 다른 GPG 키로 서명되어 있기 때문에, 기존 키링으로 새 저장소를 읽으면 APT가 공개 키가 없다고 보고해요.
-
새 저장소용 공개 GPG 키를 임포트하세요:
curl -o- https://artifacts.opensearch.org/publickeys/opensearch-release.pgp | sudo gpg --dearmor --batch --yes -o /etc/apt/keyrings/opensearch-release-keyring{% include copy.html %}
OpenSearch Dashboards 2.x 저장소는
https://artifacts.opensearch.org/publickeys/opensearch.pgp에 게시된 키로 서명되어 있어요. 2.x 저장소 정의를 제거할 때까지는 이 키의 키링을 그대로 유지하세요. 그렇지 않으면apt-get update가 2.x 저장소를 읽는 도중 실패해요. {: .note} -
새 메이저 버전용 저장소를 추가하세요:
echo "deb [signed-by=/etc/apt/keyrings/opensearch-release-keyring] https://artifacts.opensearch.org/releases/bundle/opensearch-dashboards/{{major_version_mask}}/apt stable main" | sudo tee /etc/apt/sources.list.d/opensearch-dashboards-{{major_version_mask}}.list{% include copy.html %}
-
이전 메이저 버전의 저장소 정의를 제거하세요. 이때
<previous-major-version>은2.x같은 값으로 바꿔 주세요:sudo rm /etc/apt/sources.list.d/opensearch-dashboards-<previous-major-version>.list{% include copy.html %}
-
패키지 목록을 새로 고치고 새 버전이 나타나는지 확인하세요:
sudo apt-get update && sudo apt list -a opensearch-dashboards{% include copy.html %}
-
새 버전을 설치하세요:
sudo apt-get install opensearch-dashboards=<version>{% include copy.html %}
패키지 업그레이드 후 서비스 자동 재시작
패키지 업그레이드 후 OpenSearch Dashboards가 자동으로 재시작되도록 하려면, systemd를 통해 opensearch-dashboards.service를 활성화하세요:
sudo systemctl enable opensearch-dashboards.service
{% include copy.html %}