Mikrotik의 TR-069. RouterOS의 자동 구성 서버로 Freeacs 테스트

이번 글에서는 훌륭한 프로젝트의 테스트 서버를 설치하는 과정을 단계별로 설명하려고 합니다. 프리악스 완전한 기능 상태로 만들고 mikrotik 작업을 위한 실용적인 기술(매개변수를 통한 구성, 스크립트 실행, 업데이트, 추가 모듈 설치 등)을 보여줍니다.

이 기사의 목적은 동료들이 Dude, Ansible 등 자체 작성 스크립트 형태로 끔찍한 갈퀴와 목발을 사용하여 네트워크 장치 관리를 거부하도록 강요하는 것입니다. 사각형.

0. 선택

왜 genie-ac가 아닌 freeac이 언급되었는가? 미크로틱위키얼마나 더 살아있지?
mikrotik과 함께 genie-acs에 대한 스페인어 간행물이 있기 때문입니다. 여기 있습니다 PDF и 비디오 작년 MUM부터요. 슬라이드에 자동만화도 멋지지만 스크립트를 작성하고, 스크립트를 실행하고, 스크립트를 실행하는 개념에서 벗어나고 싶습니다...

1. 프리악스 설치

우리는 Centos7을 설치할 예정인데, 기기들이 많은 양의 데이터를 전송하고, ACS가 데이터베이스를 적극적으로 활용하고 있기 때문에 리소스에 욕심을 내지는 않을 것입니다. 편안한 작업을 위해 CPU 코어 2개, RAM 4GB, 빠른 스토리지 SSD raid16 10GB를 선택하겠습니다. Proxmox VE lxc 컨테이너에 freeac를 설치해 드리며, 귀하에게 편리한 도구로 작업하실 수 있습니다.
ACS가 있는 시스템에서 정확한 시간을 설정하는 것을 잊지 마십시오.

시스템은 테스트용이므로 당황하지 말고 친절하게 제공된 설치 스크립트를 있는 그대로 사용하십시오.

wget https://raw.githubusercontent.com/freeacs/freeacs/master/scripts/install_centos.sh
chmod +x install_centos.sh
./ install_centos.sh

스크립트가 완료되자마자 admin/freeacs 자격 증명을 사용하여 머신의 IP를 통해 웹 인터페이스에 즉시 들어갈 수 있습니다.

여기에 정말 멋지고 미니멀한 인터페이스가 있으며, 모든 것이 얼마나 멋지고 빠른지 보여줍니다.

2. 프리악스 초기 설정

ACS의 기본 제어 단위는 단위 또는 CPE(Customer Premises Equipment)입니다. 그리고 가장 중요한 것은 유닛을 관리하는 데 필요한 것은 유닛 유형입니다. 장치와 해당 소프트웨어에 대해 구성 가능한 매개변수 세트를 정의하는 하드웨어 모델입니다. 하지만 새로운 유닛 유형을 올바르게 얻는 방법을 알 때까지는 검색 모드를 켜서 유닛 자체에 이에 대해 물어보는 것이 가장 좋습니다.

프로덕션에서는 이 모드를 사용하는 것이 절대 불가능하지만, 가능한 한 빨리 엔진을 시작하고 시스템 기능을 확인해야 합니다. 모든 기본 설정은 /opt/freeacs-*에 저장됩니다. 그러므로 우리는

 vi /opt/freeacs-tr069/config/application-config.conf 

, 우리는 찾는다

discovery.mode = false

그리고로 변경

discovery.mode = true

또한, nginx와 mysql이 작동할 수 있는 최대 파일 크기를 늘리고 싶습니다. mysql의 경우 /etc/my.cnf에 해당 행을 추가하십시오.

max_allowed_packet=32M

, nginx의 경우 /etc/nginx/nginx.conf에 추가하세요.

client_max_body_size 32m;

http 섹션으로. 그렇지 않으면 1M 이하의 펌웨어로 작업할 수 있습니다.

재부팅하면 장치 작업 준비가 완료됩니다.

그리고 장치(CPE)의 역할에서 우리는 일 중독자 아기를 갖게 될 것입니다. HAP AC 라이트.

연결을 테스트하기 전에 나중에 구성하려는 매개변수가 비어 있지 않도록 CPE를 최소 작동 구성으로 수동으로 구성하는 것이 좋습니다. 라우터의 경우 ether1에서 최소한 dhcp 클라이언트를 활성화하고 tr-069client 패키지를 설치하고 비밀번호를 설정할 수 있습니다.

3. 미크로틱 연결

유효한 일련번호를 로그인으로 사용하여 모든 장치를 연결하는 것이 바람직합니다. 그러면 로그에서 모든 것이 명확해질 것입니다. 누군가 WAN MAC을 사용하라고 조언합니다. 믿지 마세요. 누군가는 모든 사람을 위한 공통 로그인/패스 쌍을 사용합니다. 이를 우회합니다.

"협상"을 모니터링하기 위해 tr-069 로그 열기

tail -f /var/log/freeacs-tr069/tr069-conversation.log

Winbox를 열고 메뉴 항목 TR-069를 엽니다.
AC URL: http://10.110.0.109/tr069/prov (귀하의 IP로 대체)
사용자 이름: 9249094C26CB(시스템>라우터보드에서 일련 번호 복사)
비밀번호: 123456(검색에는 필요하지 않지만 검색에는 필요함)
주기적 알림 간격은 변경되지 않습니다. ACS를 통해 이 설정을 발행합니다.

다음은 연결의 원격 초기화를 위한 설정이지만 mikrotik이 급습하여 작업하도록 할 수 없습니다. 원격 요청은 전화를 사용하여 즉시 사용할 수 있습니다. 그것을 알아내야 할 것이다.

적용 버튼을 누르면 터미널에서 데이터가 교환되고 Freeacs 웹 인터페이스에서 자동으로 생성된 장치 유형 "hAPaclite"가 있는 라우터를 볼 수 있습니다.

라우터가 연결되었습니다. 자동으로 생성된 Unit Type을 확인할 수 있습니다. 우리는 연다 Easy Provisioning > Unit Type > Unit Type Overview > hAPaclite. 거기에 무엇이 없습니까! 최대 928개의 매개변수(셸을 염탐했습니다). 많거나 적음 - 나중에 알아내겠지만 지금은 간단히 살펴보겠습니다. 이것이 바로 단위 유형의 의미입니다. 다음은 키는 있지만 값은 없는 지원되는 옵션 목록입니다. 값은 프로필 및 단위 아래 수준에서 설정됩니다.

4. 미크로틱 구성

이제 다운로드할 시간입니다 웹 인터페이스 가이드 이번 2011년 가이드는 마치 잘 숙성된 와인 한 병과 같습니다. 열어서 숨을 쉬도록 합시다.

그리고 웹 인터페이스에서 우리 장치 옆에 있는 연필을 클릭하고 장치 구성 모드로 이동합니다. 다음과 같습니다:

이 페이지의 흥미로운 내용을 간략하게 분석해 보겠습니다.

유닛 구성 블록

• 프로필: 단위 유형 내의 프로필입니다. 계층 구조는 다음과 같습니다. UnitType > Profile > Unit. 즉, 예를 들어 프로필을 만들 수 있습니다. hAPaclite > hotspot и hAPaclite > branch, 그러나 기기 모델 내에서는

블록 프로비저닝 버튼으로
프로비저닝 블록의 모든 버튼이 ConnectionRequestURL을 통해 구성을 즉시 적용할 수 있다는 힌트를 제공합니다. 하지만 위에서 말했듯이 이것은 작동하지 않으므로 버튼을 누른 후 수동으로 프로비저닝을 시작하려면 mikrotik에서 tr-069 클라이언트를 다시 시작해야 합니다.

• Freq/Spread: 서버 및 통신 채널의 부하를 줄이기 위해 일주일에 몇 번 구성을 ± %로 전달합니다. 기본적으로 비용은 7/20입니다. 매일 ± 20%이며 초 단위로 어떻게 진행되는지 힌트를 줍니다. 지금까지는 배송 빈도를 변경하는 데 아무런 의미가 없습니다. 로그에 추가 노이즈가 있으며 설정이 항상 예상되는 것은 아닙니다.

프로비저닝 기록 블록 (지난 48시간)

• 겉보기에 스토리는 스토리와 비슷하지만 제목을 클릭하면 정규 표현식과 상품이 포함된 편리한 데이터베이스 검색 도구가 표시됩니다.

매개변수 블록

실제로 이 장치의 매개변수가 설정되고 판독되는 가장 크고 가장 중요한 블록입니다. 이제 우리는 가장 중요한 시스템 매개변수만 볼 수 있으며, 이 매개변수가 없으면 ACS가 장치와 함께 작동할 수 없습니다. 하지만 우리는 그것이 단위 유형에 있다는 것을 기억합니다. 928. 모든 가치를 살펴보고 Mikrotik이 무엇과 함께 먹는지 결정해 봅시다.

4.1 매개변수 읽기

프로비저닝 블록에서 모두 읽기 버튼을 클릭합니다. 블록에는 빨간색 비문이 있습니다. 오른쪽에 열이 나타납니다 CPE(현재) 가치. 시스템 설정에서 ProvisioningMode를 READALL로 변경했습니다.

그리고... System.X_FREEACS-COM.IM.Message의 메시지 외에는 아무 일도 일어나지 않습니다. Kick failed at....

TR-069 클라이언트를 다시 시작하거나 라우터를 재부팅하고 오른쪽의 밝은 회색 상자에 매개변수를 얻을 때까지 브라우저 페이지를 계속 새로 고칩니다.
묵은지 한 모금 마시고 싶은 분들을 위해 매뉴얼에는 10.2 검사 모드로 설명되어 있습니다. 켜지고 약간 다르게 작동하지만 본질은 상당히 설명되어 있습니다.

READALL 모드는 15분 후에 자동으로 꺼지며 여기서 유용한 것이 무엇인지, 이 모드에 있는 동안 즉시 수정할 수 있는 것이 무엇인지 알아내려고 노력할 것입니다.

IP 주소를 변경하고, 인터페이스를 활성화/비활성화하고, 설명이 포함된 방화벽 규칙(그렇지 않으면 완전히 엉망이 됨), Wi-Fi 등의 사소한 작업을 수행할 수 있습니다.

즉, TR-069 도구만 사용하여 mikrotik을 제대로 구성하는 것은 아직 불가능합니다. 하지만 모니터링은 매우 잘 할 수 있습니다. 인터페이스 및 해당 상태, 여유 메모리 등에 대한 통계를 사용할 수 있습니다.

4.2 매개변수 전달

이제 "자연스러운" 방식으로 tr-069를 통해 매개변수를 라우터에 전달해 보겠습니다. 첫 번째 피해자는 Device.DeviceInfo.X_MIKROTIK_SystemIdentity입니다. All 유닛의 매개변수에서 이를 찾을 수 있습니다. 보시다시피 설정되지 않았습니다. 이는 모든 유닛이 그 자체로 어떠한 아이덴티티도 가질 수 있음을 의미합니다. 이것만 참으면 충분해요!
생성 열에 커서를 찔러서 Mr.White라는 이름을 설정하고 매개변수 업데이트 버튼을 누릅니다. 다음에 무슨 일이 일어날지 이미 짐작하셨을 겁니다. 본사와의 다음 통신 세션에서 라우터는 ID를 변경해야 합니다.

그러나 이것은 우리에게 충분하지 않습니다. 올바른 단위를 찾을 때 ID와 같은 매개변수를 항상 가까이에 두는 것이 좋습니다. 매개변수 이름을 입력하고 거기에 표시(D) 및 검색 가능(S) 확인란을 선택합니다. 매개변수 키가 RWSD로 변경됩니다(이름과 키는 가장 높은 장치 유형 수준에서 설정된다는 점을 기억하세요).

이제 해당 값은 일반 검색 목록에만 표시되는 것이 아니라 다음에서도 검색할 수 있습니다. Support > Search > Advanced form

프로비저닝을 시작하고 ID를 살펴봅니다. 안녕하세요 화이트 씨! 이제 tr-069client가 실행되는 동안에는 자신의 신원을 직접 변경할 수 없습니다.

4.3 스크립트 실행

그것들 없이는 길이 없다는 것을 알았으니, 그것들을 이행합시다.

하지만 파일 작업을 시작하기 전에 지시문을 수정해야 합니다. public.url 파일에 /opt/freeacs-tr069/config/application-config.conf
결국 우리는 여전히 하나의 스크립트로 설치된 테스트 구성을 가지고 있습니다. 잊지 않았나요?

# --- Public url (used for download f. ex.) ---
public.url = "http://10.110.0.109"
public.url: ${?PUBLIC_URL}

ACS를 재부팅하고 바로 다음으로 이동합니다. Files & Scripts.

그러나 우리에게 공개되는 것은 이제 단위 유형에 속합니다. 지점 라우터, 핫스팟 또는 캡스맨 등 모든 hAP ac 라이트 라우터에 전 세계적으로 적용됩니다. 아직은 그렇게 높은 수준이 필요하지 않으므로 스크립트 및 파일 작업을 수행하기 전에 프로필을 만들어야 합니다. 장치의 "위치"라고 직접 부를 수 있습니다.

우리 아기를 시간 서버로 만들어 보자. 별도의 소프트웨어 패키지와 적은 수의 매개변수로 적절한 위치를 차지합니다. 가자 Easy Provisioning > Profile > Create Profile 유닛 유형: hAPaclite에서 프로필을 생성합니다. 타임 서버. 기본 프로필에는 매개변수가 없으므로 복사할 것이 없습니다. 매개변수 복사: "복사하지 마세요..."

여기에는 아직 매개변수가 전혀 없지만 나중에 hAPaclite로 제작된 시간 서버에서 보고 싶은 매개변수를 설정할 수 있습니다. 예를 들어 NTP 서버의 일반 주소입니다.
장치 구성으로 이동하여 타임서버 프로필로 이동해 보겠습니다.

마침내 우리는 간다 Files & Scripts, 스크립트를 작성하면 놀랍도록 편리한 빵이 기다리고 있습니다.

유닛에서 스크립트를 실행하려면 다음을 선택해야 합니다. 유형:TR069_SCRIPT а 성함 и 대상 이름 .alter 확장자가 있어야 합니다.
동시에 스크립트의 경우 소프트웨어와 달리 완성된 파일을 업로드하거나 현장에서 간단히 작성/편집할 수 있습니다. 함유량. 바로 거기에 글을 써보자.

결과를 즉시 볼 수 있도록 VLAN 라우터를 ether1에 추가하십시오.

/interface vlan
add interface=ether1 name=vlan1 vlan-id=1

우리는 운전하고, 우리는 누른다 가이드라가 그리고 끝났다. 우리의 스크립트 vlan1.alter 날개에서 기다리고 있습니다.

자, 가자? 아니요. 또한 프로필에 대한 그룹을 추가해야 합니다. 그룹은 장비 계층에 포함되지 않지만 UnitType 또는 Profile에서 유닛을 검색하는 데 필요하며 Advanced Provisioning을 통한 스크립트 실행에 필요합니다. 일반적으로 그룹은 위치와 연관되며 중첩된 구조를 갖습니다. 러시아 그룹을 만들어 봅시다.

검색 범위를 "haPAclite의 모든 세계 시간 서버"에서 "haPAclite의 모든 러시아 시간 서버"로 좁혔다고 상상해 보세요. 그룹과 관련하여 흥미로운 모든 것의 거대한 계층이 여전히 있지만 시간이 없습니다. 스크립트로 들어가 보겠습니다.

Advanced Provisioning > Job > Create Job

우리는 고급 모드에 있으므로 여기에서 작업 시작, 오류 동작, 반복 및 시간 초과에 대한 다양한 조건을 지정할 수 있습니다. 매뉴얼에서 이 모든 내용을 읽어보거나 나중에 프로덕션 환경에서 구현할 때 논의하는 것이 좋습니다. 지금은 첫 번째 단위에서 작업이 완료되자마자 작업이 중지되도록 n1을 중지 규칙으로 설정하겠습니다.

필요한 사항을 작성하고 출시만 남았습니다!

START를 누르고 기다리세요. 이제 디버깅되지 않은 스크립트에 의해 종료된 장치의 카운터가 빠르게 실행됩니다! 당연히 아니지. 이러한 작업은 오랫동안 주어지며 이것이 스크립트, Ansible 등과의 차이점입니다. 장치 자체는 일정에 따라 또는 네트워크에 나타나는 작업에 적용됩니다. ACS는 어떤 장치가 이미 작업을 받았는지, 어떻게 완료했는지 추적하고 이를 장치의 매개변수에 기록합니다. 우리 그룹에는 1개의 유닛이 있고, 그 중 1001개가 있다면 관리자는 이 작업을 시작하고 낚시를 하러 갈 것입니다.

어서 해봐요. 라우터를 이미 재부팅하거나 TR-069 클라이언트를 다시 시작하세요. 모든 일이 순조롭게 진행될 것이며 Mr.White는 새로운 VLAN을 갖게 될 것입니다. 중지 규칙 작업은 PAUSED 상태가 됩니다. 즉, 여전히 다시 시작하거나 변경할 수 있습니다. FINISH를 누르면 작업이 아카이브에 기록됩니다.

4.4 소프트웨어 업데이트

Mikrotik 펌웨어는 모듈식이므로 이는 매우 중요한 점입니다. 그러나 모듈을 추가해도 장치의 전체 펌웨어 버전이 변경되지는 않습니다. 우리 ACS는 정상이며 이에 익숙하지 않습니다.
이제 Quick & Dirty 스타일로 NTP 모듈을 일반 펌웨어에 바로 푸시하겠습니다. 하지만 장치에서 버전이 업데이트되자마자 같은 방식으로 다른 모듈을 추가할 수는 없습니다.
프로덕션에서는 이러한 트릭을 사용하지 않고 스크립트로만 Unit Type에 선택적인 모듈을 설치하는 것이 좋습니다.

따라서 가장 먼저 해야 할 일은 필요한 버전과 아키텍처의 소프트웨어 패키지를 준비하고 이를 사용 가능한 웹 서버에 배치하는 것입니다. 테스트를 위해 Mr.White에 연락할 수 있는 사람은 누구나 갈 것이며, 생산을 위해서는 웹에 올리는 것이 두렵지 않은 필요한 소프트웨어의 자동 업데이트 미러를 구축하는 것이 좋습니다.
중요한! 업데이트에 항상 tr-069client 패키지를 포함하는 것을 잊지 마세요!

결과적으로 패킷 경로의 길이는 매우 중요합니다! 내가 같은 것을 사용하려고 할 때 http://192.168.0.237/routeros/stable/mipsbe/routeros-mipsbe-6.45.6.npk, mikrotik은 리소스와의 순환 연결에 빠져 반복적으로 TRANSFERCOMPLETE 로그를 tr-069로 보냈습니다. 그리고 무엇이 잘못되었는지 알아내려고 일부 신경 세포를 낭비했습니다. 따라서 루트에 넣는 동안 명확해질 때까지

따라서 http를 통해 사용할 수 있는 세 개의 npk 파일이 있어야 합니다. 이렇게 받았어요

http://192.168.0.241/routeros-mipsbe-6.45.6.npk
http://192.168.0.241/routeros/stable/mipsbe/ntp-6.45.6-mipsbe.npk
http://192.168.0.241/routeros/stable/mipsbe/tr069-client-6.45.6-mipsbe.npk

이제 이것은 FileType = "1 Firmware Upgrade Image"인 xml 파일로 형식화되어야 하며, 이를 Mikrotik에 제공합니다. 이름을 ros.xml로 하세요.

우리는 지시에 따라 수행합니다. 미크로틱위키:

<upgrade version="1" type="links">
    <config />
    <links>
        <link>
            <url>http://192.168.0.241/routeros-mipsbe-6.45.6.npk</url>
        </link>
        <link>
            <url>http://192.168.0.241/ntp-6.45.6-mipsbe.npk</url>
        </link>
        <link>
            <url>http://192.168.0.241/tr069-client-6.45.6-mipsbe.npk</url>
        </link>
    </links>
</upgrade>

부족한 점이 눈에 띈다 Username/Password 다운로드 서버에 접속하려면 tr-3.2.8 프로토콜의 A.069 단락과 같이 입력을 시도할 수 있습니다.

<link>
<url>http://192.168.0.237/routeros/stable/mipsbe/ntp-6.45.6-mipsbe.npk</url>
<Username>user</Username>
<Password>pass</Password>
</link>

또는 Mikrotik 관계자에게 직접 문의하거나 *.npk의 최대 경로 길이를 문의하세요.

우리는 알려진 곳으로 간다 Files & Scripts, 거기에 소프트웨어 파일을 생성하십시오 이름:ros.xml, 대상 이름:ros.xml 및 버전 :6.45.6
주목! 버전은 장치에 표시되고 매개변수에 전달되는 형식으로 정확하게 여기에 지정되어야 합니다. System.X_FREEACS-COM.Device.SoftwareVersion.

로드할 xm 파일을 선택하면 완료됩니다.

이제 장치를 업데이트하는 방법이 많이 있습니다. 기본 메뉴의 마법사, 고급 프로비저닝 및 소프트웨어 유형 작업을 통해 또는 장치 구성으로 이동하여 업그레이드를 클릭하세요. 가장 쉬운 방법을 선택하자. 그렇지 않으면 기사가 부풀어 오른다.

버튼을 누르고 프로비저닝을 시작하면 완료됩니다. 테스트 프로그램이 완료되었습니다. 이제 mikrotik으로 더 많은 일을 할 수 있습니다.

5. 결론

글을 쓰기 시작했을 때 먼저 IP 전화 연결을 설명하고 그 예를 사용하여 tr-069가 쉽고 쉽게 작동할 때 얼마나 멋진지 설명하고 싶었습니다. 그러다가 점점 자료를 파헤쳐가면서 미크로틱을 연결한 분들에게는 독학하기에는 어떤 휴대폰도 두렵지 않을 것 같다는 생각이 들었습니다.

원칙적으로 우리가 테스트한 Freeacs는 이미 프로덕션에서 사용할 수 있지만 이를 위해서는 보안, SSL을 구성해야 하고, 재설정 후 자동 구성을 위해 마이크로틱을 구성해야 하며, 단위 유형의 올바른 추가를 디버깅하고, 분해해야 합니다. 웹 서비스 및 퓨전 셸 작업 등. 속편을 시도하고, 발명하고, 작성해보세요!

여러분, 관심을 가져주셔서 감사합니다! 수정과 댓글을 환영합니다!

사용된 재료 목록 및 유용한 링크:

주제를 검색하기 시작했을 때 발견한 포럼 스레드
TR-069 CPE WAN 관리 프로토콜 수정안-6
프리악스 위키
Mikrotik의 매개변수 tr-069 및 터미널 명령과의 대응

출처 : habr.com