ТР-069 код Микротика. Тестирање Фрееацс-а као сервера за аутоматско подешавање за РоутерОС

У овом чланку покушаћу да опишем корак по корак процес инсталирања тест сервера одличног пројекта фрееацс у потпуно функционално стање, и приказати практичне технике рада са микротиком: конфигурисање кроз параметре, извршавање скрипте, ажурирање, инсталирање додатних модула итд.

Сврха чланка је да натера колеге да одбију да управљају мрежним уређајима користећи страшне грабуље и штаке, у виду самописних скрипти, Дуде, Ансибле, итд. И, овом приликом, да изазову ватромет и масовно весеље у квадрата.

КСНУМКС. Избор

Зашто фрееацс а не гение-ацс поменути у микротик-викиколико живље?
Зато што постоје шпанске публикације о гение-ацс са микротиком. Ево их pDF и видео са прошлогодишњег МУМ-а. Ауто цртани филмови на слајдовима су кул, али бих волео да се удаљим од концепта писања скрипти, покретања скрипти, покретања скрипти...

1. Фрееацс инсталација

Инсталираћемо у Центос7, а пошто уређаји преносе много података, а АЦС активно ради са базом података, нећемо бити похлепни за ресурсима. За удобан рад, изабраћемо 2 ЦПУ језгра, 4ГБ РАМ-а и 16ГБ брзог складиштења ссд раид10. Инсталираћу фрееацс у Прокмок ВЕ лкц контејнер, а ви можете да радите у било ком алату који вам одговара.
Не заборавите да подесите тачно време на машини са АЦС-ом.

Систем ће бити пробни, па немојмо бити паметни, и само користимо љубазно достављену инсталациону скрипту, каква јесте.

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

Чим се скрипта заврши, можете одмах да уђете у веб интерфејс преко ип-а машине, са акредитивима админ/фрееацс

Ево тако лепог минималистичког интерфејса и како је све испало кул и брзо

2. Фрееацс почетно подешавање

Основна јединица управљања за АЦС је јединица или ЦПЕ (Цустомер Премисес Екуипмент). И што је најважније, оно што нам је потребно за управљање јединицама је њихов тип јединице, тј. хардверски модел који дефинише скуп конфигурабилних параметара за јединицу и њен софтвер. Али док не знамо како да исправно покренемо нови тип јединице, најбоље би било да питамо саму јединицу о томе укључивањем режима откривања.

У производњи, овај режим је апсолутно немогуће користити, али морамо што пре покренути мотор и видети могућности система. Сва основна подешавања се чувају у /опт/фрееацс-*. Стога, отварамо

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

, налазимо

discovery.mode = false

и промените у

discovery.mode = true

Поред тога, желели бисмо да повећамо максималну величину датотека са којима ће нгинк и мискл радити. За мискл, додајте ред у /етц/ми.цнф

max_allowed_packet=32M

, а за нгинк, додајте у /етц/нгинк/нгинк.цонф

client_max_body_size 32m;

у одељак хттп. У супротном, моћи ћемо да радимо са фирмвером не више од 1М.

Поново покрећемо систем и спремни смо за рад са уређајима.

А у улози уређаја (ЦПЕ) имаћемо бебу радохоличара хАП АЦ лите.

Пре пробне везе, препоручљиво је да ручно конфигуришете ЦПЕ на минималну радну конфигурацију тако да параметри које желите да конфигуришете у будућности не буду празни. За рутер, можете минимално омогућити дхцп клијент на етхер1, инсталирати тр-069цлиент пакет и поставити лозинке.

3. Повежите Микротик

Пожељно је повезати све јединице користећи важећи серијски број као логин. Тада ће вам све бити јасно у логовима. Неко саветује да користите ВАН МАЦ - немојте веровати. Неко користи заједнички пар логин/пасс за све - заобиђите их.

Отварање дневника тр-069 за праћење "преговора"

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

Отворите винбок, ставка менија ТР-069.
АЦ УРЛ: http://10.110.0.109/tr069/prov (замените својим ИП-ом)
Корисничко име: 9249094Ц26ЦБ (копирај серијски из система>рутербоард)
Лозинка: 123456 (није потребна за откривање, али да буде)
Не мењамо период периодичних информација. Ово подешавање ћемо издати преко нашег АЦС-а

Испод су подешавања за даљинску иницијализацију везе, али нисам успео да натерам микротик да ради са њим једним потезом. Иако даљински захтев ради из кутије са телефонима. Мораће то да схватим.

Након притиска на дугме Примени, подаци ће се разменити у терминалу, а у Фрееацс веб интерфејсу можете видети наш рутер са аутоматски креираним Унит Типе „хАПацлите“.

Рутер је повезан. Можете погледати аутоматски генерисани тип јединице. Отварамо Easy Provisioning > Unit Type > Unit Type Overview > hAPaclite. Чега нема! Чак 928 параметара (шпијунирао сам шкољку). Много или мало - схватићемо касније, али за сада ћемо само на брзину погледати. То значи Тип јединице. Ово је листа подржаних опција са кључевима, али без вредности. Вредности су постављене на нивоима испод - Профили и јединице.

4. Конфигуришите Микротик

Време је за преузимање водич за веб интерфејс Овај водич за 2011. је као боца доброг, одлежаног вина. Хајде да га отворимо и пустимо да дише.

И сами, у веб интерфејсу, кликните на оловку поред наше јединице и идите у режим конфигурације јединице. изгледа овако:

Хајде да укратко анализирамо шта је занимљиво на овој страници:

Блок конфигурације јединице

• Профил: Ово је профил унутар типа јединице. Хијерархија је оваква: UnitType > Profile > Unit. То јест, можемо креирати, на пример, профиле hAPaclite > hotspot и hAPaclite > branch, али у оквиру модела уређаја

Блоцк Провисионинг са дугмадима
Савети наговештавају да сва дугмад у блоку Провисионинг могу тренутно применити конфигурацију преко ЦоннецтионРекуестУРЛ-а. Али, као што сам рекао горе, ово не функционише, тако да након притиска на дугмад, мораћете поново да покренете тр-069 клијент на микротику да бисте ручно покренули провизију.

• Фрек/Спреад: Колико пута недељно испоручити конфигурацију ± % да бисте смањили оптерећење сервера и комуникационих канала. Подразумевано кошта 7/20, тј. сваки дан ± 20% и наговештај како је у секундама. За сада нема смисла мењати учесталост испоруке, јер. биће додатне буке у евиденцији и не увек очекиване примене подешавања

Блок историје обезбеђивања (последњих 48 сати)

• По изгледу, прича је као прича, али кликом на наслов долазите до погодног алата за претрагу базе података са регекпом и делицијама

Параметерс Блоцк

Највећи и најважнији блок, где се, у ствари, постављају и читају параметри за ову јединицу. Сада видимо само најважније системске параметре, без којих АЦС не може да ради са јединицом. Али сећамо се да их имамо у типу јединице - 928. Хајде да видимо све вредности и одлучимо са чиме Микротик једе.

4.1 Очитавање параметара

У блоку Добављање кликните на дугме Прочитај све. Блок има црвени натпис. На десној страни ће се појавити колона ЦПЕ (тренутна) вредност. Промењен режим обезбеђивања у РЕАДАЛЛ у системским подешавањима.

И… ништа се неће догодити осим поруке у Систем.Кс_ФРЕЕАЦС-ЦОМ.ИМ.Мессаге Kick failed at....

Поново покрените ТР-069 клијент или поново покрените рутер и наставите да освежавате страницу претраживача док не добијете параметре у веселим сивим оквирима са десне стране
Ако неко жели да отпије гутљај старог искусног, овај режим је у приручнику описан као 10.2 Режим прегледа. Укључује се и ради мало другачије, али суштина је прилично описана

Режим РЕАДАЛЛ ће се сам искључити након 15 минута, а ми ћемо покушати да схватимо шта је овде корисно, а шта се може исправити у ходу док смо у овом режиму.

Можете да промените ИП адресе, омогућите/онемогућите интерфејсе, правила заштитног зида, који су са коментарима (иначе потпуни неред), Ви-Фи и тако даље по ситницама.

То јест, још увек није могуће разумно конфигурисати микротик користећи само ТР-069 алате. Али можете врло добро пратити. Доступне су статистике о интерфејсима и њиховом статусу, слободној меморији итд.

4.2 Параметри испоруке

Хајде сада да покушамо да испоручимо параметре рутеру, преко тр-069, на „природан“ начин. Прва жртва ће бити Девице.ДевицеИнфо.Кс_МИКРОТИК_СистемИдентити. Налазимо га у параметрима јединице Алл. Као што видите, није подешено. То значи да свака јединица сама по себи може имати било који Идентитет. Доста је ово трпети!
Гурамо дау у колону креирања, постављамо име Мр.Вхите и гурамо дугме Ажурирај параметре. Шта ће бити даље, већ сте погодили. На следећој сесији комуникације са седиштем, рутер мора да промени свој идентитет.

Али ово нам није довољно. Параметар као што је Идентитет је добро увек имати при руци када тражите праву јединицу. Убацујемо у име параметра и тамо стављамо поља за потврду Дисплаи (Д) и Сеарцхабле (С). Кључ параметра је промењен у РВСД (запамтите, имена и кључеви су постављени на највиши ниво типа јединице)

Вредност сада није приказана само на општој листи претраге, већ је доступна и за претрагу Support > Search > Advanced form

Покрећемо провизију и посматрамо Идентитет. Здраво Мр.Вхите! Сада нећете моћи сами да промените свој идентитет док тр-069цлиент ради

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}

Поново покрените АЦС и идите право на Files & Scripts.

Али оно што се код нас отвара сада припада Типу јединице, тј. глобално за све хАП ац лите рутере, било да се ради о рутеру гране, хотспот-у или цапсман-у. Још нам није потребан тако висок ниво, стога, пре рада са скриптама и датотекама, требало би да направите профил. Можете га назвати и сами, као "позиција" уређаја.

Направимо од наше бебе сервер времена. Пристојан положај са посебним софтверским пакетом и малим бројем параметара. Идемо у Easy Provisioning > Profile > Create Profile и креирајте профил у Унит Типе:хАПацлите временски сервер. Нисмо имали никакве параметре у подразумеваном профилу, тако да нема шта да се копира Копирај параметре из: "не копирај..."

Овде још увек нема параметара, али биће могуће подесити оне које касније желимо да видимо на нашим временским серверима обликованим од хАПацлите-а. На пример, опште адресе НТП сервера.
Идемо на конфигурацију јединице и преместимо је на профил сервера времена

Коначно идемо у Files & Scripts, направите скрипте, а овде нас чекају невероватно згодне лепиње.

Да бисмо извршили скрипту на јединици, морамо да изаберемо Тип:ТР069_СЦРИПТ а Име и Таргет Наме мора имати проширење .алтер
Истовремено, за скрипте, за разлику од софтвера, можете или да отпремите готову датотеку, или једноставно да је напишете / уредите у пољу Садржај. Хајде да покушамо да пишемо управо тамо.

И да бисте одмах видели резултат - додајте влан рутер у етхер1

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

Возимо, притискамо отпремање и готово. Наш сценарио vlan1.alter чекајући у крилима.

Па, идемо? Не. Такође морамо да додамо групу за наш профил. Групе нису укључене у хијерархију опреме, али су потребне за тражење јединица у УнитТипе или Профиле и потребне су за извршавање скрипте путем Адванцед Провисионинг. Обично су групе повезане са локацијама и имају угнежђену структуру. Хајде да направимо групу Русија.

Замислите да смо управо сузили претрагу са „Сви сервери светског времена на хАПацлите-у“ на „Сви сервери руског времена на хАПацлите-у“. Још увек постоји огроман слој свега занимљивог са групама, али немамо времена. Уђимо у скрипте.

Advanced Provisioning > Job > Create Job

Пошто смо у напредном режиму, ипак, овде можете да наведете гомилу различитих услова за почетак задатка, понашање грешке, понављања и тајмауте. Препоручујем да прочитате све ово у приручницима или да о томе разговарате касније када га имплементирате у производњу. За сада, само да поставимо н1 на Стоп правила тако да задатак престане чим се заврши на нашој 1. јединици.

Попуњавамо неопходно, а остаје само да покренемо!

Притисните СТАРТ и сачекајте. Сада ће бројач уређаја које је уништила скрипта са недостатком грешака брзо радити! Наравно да не. Такви задаци се дају дуго, и то је њихова разлика од скрипти, Ансибле-а и тако даље. Јединице се саме пријављују за задатке по распореду или како се појављују на мрежи, АЦС прати које јединице су већ примиле задатке и како су се завршили и то уписује у параметре јединице. У нашој групи има 1 јединица, а да их је 1001, админ би започео овај задатак и отишао на пецање

Хајде. Поново покрените рутер или поново покрените ТР-069 клијент. Све би требало да иде глатко и Мр.Вхите ће добити нови влан. А наш задатак правила за заустављање ће прећи у статус ПАУЗИРАНА. То јест, још увек се може поново покренути или променити. Ако притиснете ФИНИСХ, задатак ће бити отписан у архиву

4.4 Ажурирање софтвера

Ово је веома важна тачка, пошто је Микротик фирмвер модуларан, али додавање модула не мења укупну верзију фирмвера уређаја. Наш АЦС је нормалан и није навикао на ово.
Сада ћемо то урадити у стилу брзог и прљавог, и одмах убацити НТП модул у општи фирмвер, али чим се верзија ажурира на уређају, нећемо моћи да додамо још један модул на исти начин .
У производњи је боље да не користите такав трик и инсталирате модуле који су опциони за Тип јединице само са скриптама.

Дакле, прво што треба да урадимо је да припремимо софтверске пакете потребних верзија и архитектуре и ставимо их на неки расположиви веб сервер. На тест ће ићи свако ко може да дође до нашег Мр.Вхите-а, а за производњу је боље направити огледало потребног софтвера за аутоматско ажурирање, који није страшно ставити на веб
Важно! Не заборавите да увек укључите пакет тр-069цлиент у ажурирања!

Како се испоставило, дужина пута до пакета је веома важна! Када покушам да користим нешто попут http://192.168.0.237/routeros/stable/mipsbe/routeros-mipsbe-6.45.6.npk, микротик је пао у цикличну везу са ресурсом, шаљући поновљене евиденције ТРАНСФЕРЦОМПЛЕТЕ на тр-069. И потрошио сам неке нервне ћелије покушавајући да схватим шта није у реду. Стога, док га стављамо у корен, до разјашњења

Дакле, требало би да имамо три нпк датотеке доступне преко хттп. Имам га овако

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

Сада ово треба да се форматира у кмл датотеку са ФилеТипе = "1 Фирмваре Упграде Имаге", коју ћемо послати Микротику. Нека име буде рос.кмл

Радимо према упутствима од микротик-вики:

<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 да бисте приступили серверу за преузимање. Можете покушати да га унесете као у параграфу А.3.2.8 тр-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>

Или питајте директно службенике Микротика, као и о максималној дужини пута до * .нпк

Идемо до познатих Files & Scripts, и тамо креирајте СОФТВЕРСКИ фајл са ime:рос.кмл, Име циља:рос.кмл и Верзија:6.45.6
Пажња! Верзија мора бити наведена овде тачно у формату у којем је приказана на уређају и прослеђена у параметру System.X_FREEACS-COM.Device.SoftwareVersion.

Одабрамо нашу км датотеку за учитавање и готови сте.

Сада имамо много начина да ажурирамо уређај. Преко Чаробњака у главном менију, преко Адванцед Провисионинг и задатака са типом СОФТВЕР, или једноставно идите на конфигурацију јединице и кликните на Надогради. Хајде да изаберемо најлакши начин, иначе је чланак натечен.

Притиснемо дугме, покренемо провизију и готови сте. Програм тестирања је завршен. Сада можемо више са микротиком.

5. Закључак

Када сам почео да пишем, желео сам прво да опишем везу ип-телефона и да на његовом примеру објасним колико може бити цоол када тр-069 ради лако и без напора. Али онда, док сам напредовао и копао по материјалима, помислио сам да за оне који су повезали Микротик, ниједан телефон неће бити застрашујући за самостално учење.

У принципу, Фрееацс, који смо тестирали, већ може да се користи у производњи, али за ово морате да конфигуришете безбедност, ССЛ, потребно је да конфигуришете микротику за аутоконфигурацију након ресетовања, потребно је да отклоните грешке у исправном додавању типа јединице, раставите рад веб сервиса и фузионе шкољке и још много тога. Пробајте, измислите и напишите наставак!

Сви, хвала на пажњи! Биће ми драго исправкама и коментарима!

Списак коришћених материјала и корисних линкова:

Нит на форуму на коју сам наишао када сам почео да претражујем ову тему
ТР-069 ЦПЕ ВАН протокол управљања амандман-6
фрееацс вики
Параметри тр-069 у Микротику и њихова кореспонденција са командама терминала

Извор: ввв.хабр.цом