API Connectivity Manager 설치 또는 업그레이드 하기
해당 포스트는 NGINX Management Suite API Connectivity Manager 를 설치하거나 업그레이드 하는 방법을 가이드합니다.
목차
1. 보안 고려사항
2. API Connectivity Manager 설치 전제조건
3. Instance Manager와의 종속성
4. API Connectivity Manager 설치
4-1. 설치 후 단계
4-2. 웹 인터페이스에 액세스
4-3. 라이선스 추가
5. API Connectivity Manager 업그레이드
1. 보안 고려사항
NGINX Management Suite 배포가 안전하게 유지되도록 하려면 이 목차의 권장 사항을 따르세요.
- NGINX Management Suite 및 해당 모듈을 전용 머신(BareMetal, 컨테이너, 클라우드 또는 가상 머신)에 설치하세요.
- 동일한 머신에서 다른 서비스가 실행되지 않도록 확인하세요.
- 머신이 인터넷에서 접근할 수 없도록 하세요.
- 머신이 방화벽 뒤에 있는지 확인하세요.
2. API Connectivity Manager 설치 전제조건
주의!
이 모듈을 설치하기 전에 시스템에 NGINX와 ClickHouse가 설치되어 있어야 합니다. 또한, NGINX Management Suite 저장소를 추가해야 합니다.
3. Instance Manager와의 종속성
API Connectivity Manager는 Instance Manager의 플랫폼 기능에 의존합니다. 다음 표는 API Connectivity Manager에 필요한 최소 버전을 나열합니다.
| API Connectivity Manager | Instance Manager Dependency |
|---|---|
| 1.9.0 – 1.9.1 | 2.13.0 and later |
| 1.8.0 | 2.12.0 and later |
| 1.6.0-1.7.0 | 2.10.0–2.10.1 and later |
| 1.5.0 | 2.9.0 and later |
| 1.4.0–1.4.1 | 2.7.0 and later |
| 1.3.0–1.3.1 | 2.6.0 and later |
| 1.1.0–1.2.0 | 2.4.0 and later |
| 1.0.0 | 2.3.0 and later |
4. API Connectivity Manager 설치
CentOS, RHEL, RPM 기반
1. 최신 버전의 API Connectivity Manager를 설치하려면 다음 명령을 실행하세요.
sudo yum install -y nms-api-connectivity-manager2. NGINX Management Suite 서비스를 활성화하고 시작하세요.
sudo systemctl enable nms nms-core nms-dpm nms-ingestion nms-integrations nms-acm --now이 방식으로 시작된 NGINX Management Suite 구성 요소는 기본적으로 설치 중에 생성되는 nms 그룹 내의 루트가 아닌 nms 사용자로 실행됩니다.
3. NGINX 웹 서버를 재시작 하세요.
sudo systemctl restart nginxDebian, Ubuntu, Deb 기반
1. 최신 버전의 API Connectivity Manager를 설치하려면 다음 명령을 실행하세요.
sudo apt-get update
sudo apt-get install nms-api-connectivity-manager
2. NGINX Management Suite 서비스를 활성화하고 시작하세요.
sudo systemctl enable nms nms-core nms-dpm nms-ingestion nms-integrations nms-acm --now
이 방식으로 시작된 NGINX Management Suite 구성 요소는 기본적으로 설치 중에 생성되는 nms 그룹 내의 루트가 아닌 nms 사용자로 실행됩니다.
3. NGINX 웹 서버를 재시작 하세요.
sudo systemctl restart nginx4-1. 설치 후 단계
다음 단계는 설치 구성에 따라 선택적으로 수행할 수 있습니다.
- (선택 사항) ClickHouse 설치 시 사용자 정의 주소, 사용자 이름 또는 비밀번호를 사용하거나 TLS를 활성화한 경우, Configure ClickHouse 가이드의 단계를 따라 /etc/nms/nms.conf 파일을 업데이트하세요. 그렇지 않으면 NGINX Management Suite가 ClickHouse에 연결할 수 없습니다.
- (선택 사항) Vault를 사용하는 경우, Configure Vault 가이드의 단계를 따라 /etc/nms/nms.conf 파일을 업데이트하세요. 그렇지 않으면 NGINX Management Suite가 Vault에 연결할 수 없습니다.
- (선택 사항) SELinux를 사용하는 경우, Configure SELinux 가이드의 단계를 따라 NGINX Management Suite와 관련된 파일 및 디렉토리에 대한 SELinux Context(restorecon)를 복원하세요.
4-2. 웹 인터페이스에 액세스
NGINX Management Suite 웹 인터페이스에 액세스하려면 웹 브라우저를 열고 https://<NMS_FQDN>으로 이동하세요. https://<NMS_FQDN>을 NGINX Management Suite 호스트의 완전한 도메인 이름으로 대체하세요.
기본 관리자 사용자 이름은 admin이며, 설치 중 터미널에 표시된 생성된 비밀번호입니다.
4-3. 라이선스 추가
API Connectivity Manager 의 모든 기능을 완전히 활용하려면 유효한 라이선스가 필요합니다. Trial 라이선스, 구독 라이선스 또는 유연한 사용 프로그램 라이선스를 다운로드하고 적용하세요.
5. API Connectivity Manager 업그레이드
주의!
업그레이드를 확인하면, 업그레이드 프로세스는 필요에 따라 Instance Manager를 포함한 종속 패키지를 자동으로 업그레이드합니다. 업그레이드하기 전에 NGINX Management Suite를 백업하려는 경우, Prompt가 표시될 때 업그레이드를 취소할 수 있습니다.
CentOS, RHEL, RPM 기반
1. 최신 버전의 API Connectivity Manager로 업그레이드하려면 다음 명령을 실행하세요
sudo yum update -y nms-api-connectivity-manager2. NGINX Management Suite 플랫폼 서비스를 재시작하세요.
sudo systemctl restart nms이 방식으로 시작된 NGINX Management Suite 구성 요소는 기본적으로 설치 중에 생성된 nms 그룹 내의 루트가 아닌 nms 사용자로 실행됩니다.
3. API Connectivity Manager 서비스를 재시작하세요.
sudo systemctl restart nms-acm4. NGINX 웹 서버를 재시작하세요.
sudo systemctl restart nginx5. (선택 사항) SELinux를 사용하는 경우, “SELinux 환경에서 NGINX Management Suite 구성” 가이드의 단계를 따라 NGINX Management Suite와 관련된 파일 및 디렉토리에 대한 SELinux 기본 레이블(restorecon)을 복원하세요.
Debian, Ubuntu, Deb 기반
1. 최신 버전의 API Connectivity Manager로 업그레이드하려면 다음 명령을 실행하세요
sudo apt-get update
sudo apt-get install -y --only-upgrade nms-api-connectivity-manager2. NGINX Management Suite 플랫폼 서비스를 재시작하세요.
sudo systemctl restart nms이 방식으로 시작된 NGINX Management Suite 구성 요소는 기본적으로 설치 중에 생성된 nms 그룹 내의 루트가 아닌 nms 사용자로 실행됩니다.
3. API Connectivity Manager 서비스를 재시작하세요.
sudo systemctl restart nms-acm4. NGINX 웹 서버를 재시작하세요.
sudo systemctl restart nginx5. (선택 사항) SELinux를 사용하는 경우, “SELinux 환경에서 NGINX Management Suite 구성” 가이드의 단계를 따라 NGINX Management Suite와 관련된 파일 및 디렉토리에 대한 SELinux 기본 레이블(restorecon)을 복원하세요.
아래 뉴스레터를 구독하고 NGINX와 NGINX STORE의 최신 정보들을 빠르게 전달 받아보세요.
