Contrail Insights 설치(Standalone)를 위한 설치
요구 사항
Contrail Insights 엔터티를 검색할 관리 플랫폼(예: OpenStack) 없이 독립형 클러스터에서 호스트 및 네트워크 디바이스를 모니터링할 수 있습니다. 이 주제는 독립형 버전의 소프트웨어를 설치하는 Contrail Insights.
하드웨어 및 소프트웨어 요구 사항은 Contrail Insights 를 참조하세요.
-
참고:
업그레이드 공지: Contrail Insights 3.2.6에서 시작하여 라이선스 파일에 대한 요구 사항이 제거됩니다. 3.2.6보다 일찍 버전을 설치하는 경우 설치 전에 라이선스가 필요합니다.
라이선스 키를 에서 얻을 수 mailto:APPFORMIX-KEY-REQUEST@juniper.net. 요청 시 다음과 같은 정보를 제공합니다.
Group name: Target customers or use: Cluster type: Standalone Number of hosts: Number of instances:
설치
독립형 Contrail Insights 환경에서 Contrail Insights 설치하려면 다음을 제공합니다.
주니 Contrail Insights 다운로드에서 Juniper 파일을 다운로드하고 Ansible이 실행될 호스트에 다음 파일을 복사합니다.
contrail-insights-<version>.tar.gz contrail-insights-platform-images-<version>.tar.gz contrail-insights-dependencies-images-<version>.tar.gz contrail-insights-network_device-images-<version>.tar.gz
3.2.6보다 일찍 버전을 설치하는 경우 Contrail Insights 플랫폼 노드에 Contrail Insights 라이선스 파일을 복사합니다.
다음 명령을 실행하여 Ansible을 설치합니다. Ansible은 Docker와
docker-pyappformix_controller에 설치됩니다. 이를 통해 Ansible은 설치 노드와 노드 간에 실행될 수appformix_controller있습니다.Ubuntu # sudo apt-get install python-pip python-dev build-essential libssl-dev libffi-dev # sudo easy_install pyOpenSSL # sudo pip install ansible==2.1.2 markupsafe httplib2 For ansible 2.3 # sudo pip install ansible==2.3 markupsafe httplib2 cryptography==1.5RHEL/CentOS # sudo yum install epel-release #Enable EPEL repository In case the above command does not work, manually download and install the epel-release package with one of the below commands, depending on your system’s version. sudo yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm sudo yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm # sudo yum groupinstall 'Development Tools' #Install development tools # sudo yum install python-pip python-devel gcc gcc-c++ make openssl-devel libffi-devel # sudo yum install openssl-devel libffi libffi-devel #Dependencies # sudo yum install python-pip python-devel #Install Pip # sudo pip install ansible==2.3.0 #Install Ansible 2.3 # sudo pip install markupsafe httplib2 requests #Dependencies참고:RHEL의 경우 포트 9000에 액세스하려면 다음과 같은 IPtables 규칙이 필요합니다.
# sudo iptables -t filter -A IN_public_allow -p tcp --dport 9000 -j ACCEPT
Ansible이 설치 노드와 노드 간에 실행될 수 있도록 Python과
python-pipappformix_controller그에appformix_controller설치합니다.Ubuntu # sudo apt-get install -y python python-pipRHEL/CentOS # sudo yum install -y python python-pip에이전트가 실행되는 호스트에 Contrail Insights
python-pip설치합니다.Ubuntu # apt-get install -y python-pipRHEL/CentOS # yum install -y python-pipAnsible에 의해 Contrail Insights 플랫폼에 암호 없는 로그인을 활성화하려면, Ansible 플레이북이 실행되는 노드에서 SSH 공용 키를 만든 다음 키를
appformix_controller에 복사합니다.$ ssh-keygen -t rsa #Creates Keys $ ssh-copy-id -i ~/.ssh/id_rsa.pub <target_host> #Copies key from the node to appformix_controller node
또는 다음 인벤토리 예에서와 같이
ansible_connection=local사용할 수 있습니다.[appformix_controller] 172.16.70.119 ansible_connection=local
이름 있는 디렉토리를 생성하고 해당 디렉토리에서 파일을 편집하여 Ansible 인벤토리를
inventoryinventory/hosts생성합니다. 예를 들면 다음과 같습니다.# List all hosts which needs to be monitored by Contrail Insights [bare_host] 172.16.70.5 172.16.70.17 # Contrail Insights Platform host [appformix_controller] 172.16.70.119 # List of all hosts which will do network telemetry collection. You can use same hosts from other tags such [bare_host], [appformix_controller] [appformix_network_agents] 172.16.70.119 172.16.70.5 172.16.70.6
그룹에 나열된 호스트는
appformix_controller필수입니다. 이 호스트는 Contrail Insights 플랫폼이 설치될 호스트입니다. 선택적으로 이 섹션에 나열하여 추가 호스트를 모니터링할 수bare_host있습니다. 아래에 나열된 모든 호스트는 네트워크 디바이스 원격 분석 수집을 위해 컬렉터로appformix_network_agents사용됩니다. 에 나열된 호스트 간에 워크로드가 고등하게appformix_network_agents분산됩니다. 네트워크 디바이스를 추가하면 Contrail Insights 수집을 수행하려면 추가 호스트를 추가해야 할 수 있습니다. 텔레메티컬 수집을 수행하려면 설치 후 UI에서 호스트를 집계할 수appformix_network_agents있습니다.인벤토리 디렉토리에서 명명된 하위 간접를 만든 다음 이 하위 디렉토리 내부에 파일을
inventory/group_varsinventory/groups_vars/all생성합니다.$ mkdir inventory/group_vars $ touch inventory/group_vars/all
파일에 다음과 같은 구성 매개 변수를
all추가합니다.appformix_docker_images: - path/to/contrail-insights-platform-images-<version>.tar.gz - path/to/contrail-insights-dependencies-images-<version>.tar.gz - path/to/contrail-insights-network_device-images-<version>.tar.gz appformix_kvm_instance_discovery: true # For enabling prerequisites for package installation. appformix_network_device_monitoring_enabled: true # For running the appformix-network-device-adapter network_device_discovery_enabled: true appformix_plugins: '{{ appformix_network_device_factory_plugins }}' # After 3.1, SNMP Traps can be enabled also so appformix_plugins can be specified as below: # appformix_plugins: '{{ appformix_network_device_factory_plugins }} + {{ appformix_snmp_trap_factory_plugins }}'3.2. Contrail Insights 6보다 일찍 버전을 설치하는 경우
group_vars/allappformix_license: path/to/<contrail-insights-license-file>.sig
참고:appformix_docker_images필수 항목입니다. 또한 SN JTI MP, Contrail Insights Native 및 gRPC 네트워크 디바이스 모니터링 플러그인을 변수가 있는 파일에groups_vars/allappformix_plugins추가하십시오. 디렉토리에는 20개 이상의 내장 플러그인이certified_plugins/있습니다. 위의 예는 모든 내장 네트워크 디바이스 플러그인을 활성화하는 방법을 보여줍니다.네트워크 디바이스를 추가하는 방법은 두 가지가 있습니다. 모니터링을 위해 디바이스를 추가하기 위한 한 가지 방법을 선택해야 합니다.
TAR Contrail Insights 파일을 풀어 생성된 디렉토리로 변경합니다.
$ tar xzf contrail-insights-<version>.tar.gz $ cd contrail-insights-<version>
참고:나머지 단계는 디렉토리 내에서
contrail-insights-<version>/실행됩니다. 제품 이름이 "AppFormix"에서 "Contrail Insights"로 변경됐지만, UI 및 내부 명령 경로는 계속 AppFormix 표시되고 나중에 새 이름을 반영합니다.6단계 및 7단계에서 생성된 디렉토리에 대한 경로를 사용하여 Ansible을
inventory실행합니다. 예를 들어:$ ansible-playbook -i ../inventory appformix_standalone.yml
플레이북을 사용자로 실행하면
root이 단계를 건너뛸 수 있습니다. 예를 들어 "ubuntu" 같은 비 루트 사용자로 사용자 "ubuntu"는 사용자 그룹에docker액세스해야 합니다. 다음 명령을 실행하여 그룹에 사용자를docker추가합니다.sudo usermod -aG docker ubuntu
Auth Service를 위한 Contrail Insights 토큰을 찾으시다가 Contrail Insights 호스트의 다음 Contrail Insights.
$ cat /opt/appformix/etc/appformix_token.rst
데프문(Deprecation Notice) : 이전에는 2.19.5에서 시작된 매개 변수가 Contrail Insights 이제 더 이상 appformix_mongo_cache_size_gb Contrail Insights 3.2.0에서 지원되지 않습니다. Mongo는 Contrail Insights 3.2.0 버전에서부터 Contrail Insights 플랫폼 노드에서 최대 40%의 가용 메모리를 사용하도록 구성됩니다.
독립형 Contrail Insights 업그레이드
Contrail Insights 플레이북을 실행하여 손쉽게 appformix_standalone.yml 업그레이드할 수 있습니다. 설치와 동일한 절차를 따르며,
독립형에서 Contrail Insights 제거
모든 데이터를 제거하고 Contrail Insights 제거하려는 경우 다음 명령을 실행합니다.
ansible-playbook -i <inventory_file> clean_appformix_standalone.yml