본문으로 건너뛰기

매니저 설치

와탭 NMS(Network Management System) 에이전트인 NMS Manager 설치 방법을 안내합니다. 설치를 진행하기 전에 아래 사항을 반드시 확인해주세요.

주의

매니저 설치 전, 와탭 회원 가입과 프로젝트 생성이 완료되어야 합니다. 자세한 내용은 시작하기 문서를 참고하시기 바랍니다.

  • 시스템 요구 사항은 지원 환경 문서에서 확인할 수 있습니다.

매니저 설치​

프로젝트 액세스 키 확인​

액세스 키는 와탭 서비스 활성화를 위한 고유 ID입니다. 액세스 키를 자동으로 발급받은 후 다음 단계를 진행합니다.

  1. 설치 안내 섹션에서 프로젝트 액세스 키 발급받기 버튼을 클릭하세요.

  2. 발급된 액세스 키를 복사 버튼을 클릭해 복사합니다. 액세스 키는 재확인 할 수 있습니다.

팁

프로젝트를 생성한 후, 자동으로 에이전트 설치 페이지로 이동합니다. 에이전트 설치 페이지로 이동하지 않는다면 화면 왼쪽 메뉴에서 관리 > 매니저 설치를 선택하세요.

설치 명령어 실행​

관리 > 매니저 설치 안내 섹션에서 프로젝트 액세스 키 확인 후 순서대로 운영체제에 맞는 설치를 진행하세요.

Red Hat–based Linux​

노트

WhaTap Network Management System은 Rocky, Redhat Linux 환경을 지원합니다.

  1. 다음 명령어를 실행하여 와탭 리포지토리를 등록하세요.

    sudo rpm --import https://repo.whatap.io/centos/release.gpg
    sudo rpm -ivh https://repo.whatap.io/centos/5/noarch/whatap-repo-1.0-1.noarch.rpm

  2. 다음 명령어를 실행하여 패키지를 설치하세요.

    sudo dnf install -y whatap-nms

  3. 다음 명령어를 실행하세요. 액세스 키를 입력하고 와탭 서버 호스트를 설정합니다.

    $ sudo wtinitset -a xxxxxxx-xxxxxxxx-xxxxxxx -s 192.168.10.100

    $ sudo wtinitset --help
    usage: wtinitset [-h] -a LICENSE -s HOST [-v]

    Whatap-nms access key manager tool

    optional arguments:
    -h, --help            show this help message and exit
    -a LICENSE, --accesskey LICENSE
    Access key for project
    -s HOST, --server HOST
    Whatap host ip address for data transfer
    -v, --view            View current configuration

    example:
    # wtinitset -a znun32arkonto-76rbkt4ftlrwh9-s0dywogeww1lhs -s 192.168.10.100
    # wtinitset -a znun32arkonto-76rbkt4ftlrwh9-s0dywogeww1lhs -s 10.10.10.10/10.10.10.20

  4. 설치가 완료된 후 다음 명령어를 실행하여 NMS 매니저가 정상적으로 실행 중인지 확인하세요.

    sudo service uvicorn status
    sudo service nmscore status
    sudo service icmptcphealthd status

Debian-based Linux​

노트

WhaTap Network Management System은 Ubuntu 환경을 지원합니다.

  1. 다음 명령어를 실행하여 와탭 리포지토리를 등록하세요.

    curl -s https://repo.whatap.io/debian/release.gpg | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/whatap-release.gpg > /dev/null
    echo "deb [signed-by=/etc/apt/trusted.gpg.d/whatap-release.gpg] https://repo.whatap.io/debian unstable/" | sudo tee /etc/apt/sources.list.d/whatap.list

  2. 다음 명령어를 실행하여 패키지를 설치하세요.

    sudo apt-get update
    sudo apt-get install -y whatap-nms

  3. 다음 명령어를 실행하세요. 액세스 키를 입력하고 와탭 서버 호스트를 설정합니다.

    $ sudo wtinitset -a xxxxxxx-xxxxxxxx-xxxxxxx -s 192.168.10.100

    $ sudo wtinitset --help
    usage: wtinitset [-h] -a LICENSE -s HOST [-v]

    Whatap-nms access key manager tool

    optional arguments:
    -h, --help            show this help message and exit
    -a LICENSE, --accesskey LICENSE
    Access key for project
    -s HOST, --server HOST
    Whatap host ip address for data transfer
    -v, --view            View current configuration

    example:
    # wtinitset -a znun32arkonto-76rbkt4ftlrwh9-1234ogeww1lhs -s 192.168.10.100
    # wtinitset -a znun32arkonto-76rbkt4ftlrwh9-1234wogeww1lhs -s 10.10.10.10/10.10.10.20

  4. 설치가 완료된 후 다음 명령어를 실행하여 NMS 매니저가 정상적으로 실행 중인지 확인하세요.

    sudo service uvicorn status
    sudo service nmscore status
    sudo service icmptcphealthd status
정보

매니저 업데이트·제거 섹션을 새로 추가했습니다. 설치 화면 Red Hat 탭에는 업데이트 명령어와 exclude=whatap-nms* 트러블슈팅, 제거 명령어가 있는데 독스에는 없었습니다. 화면 내용을 그대로 옮겼습니다.

확인 요청: Debian 계열의 업데이트 명령어는 화면에 없어 넣지 않았습니다. apt update && apt install --only-upgrade whatap-nms 형태로 안내해도 되는지 확인 부탁합니다.

매니저 업데이트​

Red Hat 계열 Linux에서는 다음 명령어로 NMS 매니저를 업데이트합니다.

sudo dnf makecache
sudo dnf upgrade -y whatap-nms
노트

업그레이드가 진행되지 않는 경우

/etc/dnf/dnf.conf 파일에 다음 설정이 있으면 dnf upgrade 또는 dnf upgrade whatap-nms 명령을 실행해도 패키지가 업데이트되지 않습니다.

exclude=whatap-nms*

정상적인 업그레이드를 위해 파일을 열어 exclude 항목을 제거하거나 주석 처리하세요.

sudo vi /etc/dnf/dnf.conf
/etc/dnf/dnf.conf
[main]
gpgcheck=1
installonly_limit=3
clean_requirements_on_remove=True
best=True
skip_if_unavailable=False
# exclude=whatap-nms*

매니저 제거​

  • Red Hat 계열 Linux

    sudo dnf remove whatap-nms

  • Debian 계열 Linux

    sudo apt purge whatap-nms

NMS 서비스 접속​

설치가 완료되면 https://service.whatap.io에 접속하여 NMS 모니터링을 시작합니다.

최종 수정: