Mudanças entre as edições de "Controllr/Aplicativos/Backup/Backup Mikrotik"

De BrByte Wiki
 
(28 revisões intermediárias por 5 usuários não estão sendo mostradas)
Linha 1: Linha 1:
Configuração do serviço de emissão e envio de backups de clientes do ISP Controllr para o Mikrotik
+
Configuração do serviço de emissão e envio de [[BrbOS/Aplicativos/Sistema/Backups | backups]] de clientes do ISP Controllr para o Mikrotik
  
1.== Gerar token no ISP Controllr ==
+
Com o backup MikroTik configurado, caso venha a perder comunicação entre o Mikrotik e o Controllr as secrets serão automaticamente ativas deixando seus clientes navegando sem problemas.
 +
 
 +
Isto serve também para manutenção no Controllr. Segue o passo a passo.
 +
 
 +
 
 +
==Gerar token no ISP Controllr==
  
 
Abrir aplicativo Configurações do Controllr > Endereços do servidor e clicar sobre o botão para gerar uma nova chave.
 
Abrir aplicativo Configurações do Controllr > Endereços do servidor e clicar sobre o botão para gerar uma nova chave.
[[Arquivo:bkp_mikrotik1.png]]
+
 
 +
[[Arquivo:Controllr_backup_mikrotik1.png]]
 +
 
 +
 
 +
 
 +
==Montar URL para obter as informações conforme sua necessidade==
 +
 
 +
''Como a URL deve ser montada:''
 +
 
 +
http://IPDOCONTROLLR:8083/service/mikrotik/index?parametro1=valor&parametro2=valor…
 +
 
 +
''Exemplo de URL para gerar o backup de Clientes PPPoE sem controle de Access­List.''
 +
 
 +
 
 +
<nowiki>http://192.168.140.198:8083/service/mikrotik/index?key</nowiki>='''XXXXXXXXXXXXXX(SUACHAVE)'''&local_address='''XXXXXXXXX(gateway)'''&remote_address='''XXXXXXXXXX(nome_pool)'''
 +
 
 +
[[Arquivo:Controllr_backup_mikrotik2.png]]
 +
 
 +
 
 +
 
 +
==Inserir script no Mikrotik==
 +
 
 +
No Mikrotik, entrar no menu System > Scripts e adicionar um novo script. Nomeie o script e no campo source, altere conforme o exemplo de script a baixo:
 +
 
 +
<blockquote><pre>
 +
############################################################
 +
 
 +
:global IPCONTROLLR "IPLOCALDOCONTROLLR";
 +
:global KEY "SUACHAVE";
 +
:global DEVICE "0";
 +
:global PPPOE "1";
 +
:global HOTSPOT "0";
 +
:global LOCALADDRESS "192.168.1.1";
 +
:global REMOTEADDRESS "pool-pppoe";
 +
:global DNSSERVER1 "8.8.8.8";
 +
:global DNSSERVER2 "8.8.4.4";
 +
:global done "";
 +
:log warning "Importando PPPoE";
 +
/tool fetch mode=http url="http://$IPCONTROLLR:8083/service/mikrotik/index?key=$KEY&device=$DEVICE&local_address=$LOCALADDRESS&remote_address=$REMOTEADDRESS&pppoe=$PPPOE&hotspot=$HOTSPOT&dns_server1=$DNSSERVER1&dns_server2=$DNSSERVER2" src-path=mikrotik.php dst-path=clientsctrl.rsc;
 +
:set done "true";
 +
:if ( [/file find name=clientsctrl.rsc] != "" ) do={
 +
:log warning "Importando PPPoE2";
 +
/import clientsctrl.rsc;
 +
/file remove clientsctrl.rsc
 +
#/ppp secret unset [find where comment=controllr] remote-address;
 +
/ppp secret set caller-id="" [find comment="controllr"]
 +
}
 +
 
 +
###################################################
 +
 
 +
</pre></blockquote>
 +
 
 +
 
 +
Depois que substituir os campos corretos clique em Aplly e depois Run Script.
 +
 
 +
Logo após rodar o Script, copie-o e cole em System > Scheduler, marque em Start Time : startup e Interval: 24:00:00
 +
 
 +
Netwatch via script
 +
 
 +
<blockquote><pre>
 +
/tool netwatch
 +
add comment=CTLR-BACKUP down-script=":log warning \"IP do Controllr off habilitando as secrets\"\r\
 +
    \n/ppp secret set [find comment=controllr] disabled=no" host=192.168.10.5 interval=2m up-script=":log warning \"Desabilitando as Secrets do Controllr\"\r\
 +
    \n/ppp secret set [find comment=controllr] disabled=yes\r\
 +
    \n:delay 3m\r\
 +
    \n:log warning \"Removendo Secrets com o Comentario controllr\"\r\
 +
    \n/ppp active remove [find where comment=controllr]"
 +
</pre></blockquote>
 +
 
 +
 
 +
[https://pastebin.com/wnJG9DJ3 '''Download do script''' pode ser efetuado '''clicando aqui!''']
 +
 
 +
 
 +
==Crie o Scheduler==
 +
 
 +
Logo após rodar o Script, copie-o e cole em System > Scheduler, marque em Start Time : startup e Interval: 24:00:00
 +
 
 +
 
 +
 
 +
==Criar Netwatch no Mikrotik==
 +
 
 +
A ferramenta netwatch tem como função realizar ping a um determinado endereço e executar um script quando "conseguir" o ping (UP) e executando outro script quando "não conseguir" (DOWN).
 +
Entendendo a regra:
 +
Nesta regra realizamos ping no servidor Controllr em caso de estar "UP" as secrets encontram-se 'desabilitadas' (disable=yes) quando o Controllr estiver sem comunicação (DOWN) as secrets são 'habilitadas' (disable=no).
 +
 
 +
No Mikrotik, abra o terminal e execute os comandos abaixo:
 +
 
 +
Obs: Substitua apenas o '''campo ip''', conforme os parâmetros disponíveis e sua necessidade.
 +
 
 +
''Para PPPoE:''
 +
 
 +
/tool netwatch add down-­script="/ppp secret set [find comment=controllr] disabled=no" host=192.168.140.198 interval=5s up-­script="/ppp secret set [find comment=controllr] disabled=yes"
 +
 
 +
''Para HOTSPOT:''
 +
 
 +
/tool netwatch add down­-script="/ip hotspot user set [find comment=controllr] disabled=no host=192.168.140.198 interval=5s up-­script="/ip hotspot user set [find comment=controllr] disabled=yes"
 +
 
 +
[https://youtu.be/51ZValbwhA4 '''Video aula, backup do Controllr no mikrotik''']
 +
 
 +
 
 +
=Video=
 +
 
 +
<div class="video-container">
 +
{{#ev:youtube|https://youtu.be/51ZValbwhA4}}
 +
</div>
 +
 
 +
__NOEDITSECTION__
 +
[[Category:Backup Mikrotik]]
 +
[[Category:Backup]]
 +
[[Category:Controllr]]

Edição atual tal como às 09h26min de 9 de março de 2023

Configuração do serviço de emissão e envio de backups de clientes do ISP Controllr para o Mikrotik

Com o backup MikroTik configurado, caso venha a perder comunicação entre o Mikrotik e o Controllr as secrets serão automaticamente ativas deixando seus clientes navegando sem problemas.

Isto serve também para manutenção no Controllr. Segue o passo a passo.


Gerar token no ISP Controllr

Abrir aplicativo Configurações do Controllr > Endereços do servidor e clicar sobre o botão para gerar uma nova chave.

Controllr backup mikrotik1.png


Montar URL para obter as informações conforme sua necessidade

Como a URL deve ser montada:

http://IPDOCONTROLLR:8083/service/mikrotik/index?parametro1=valor&parametro2=valor…

Exemplo de URL para gerar o backup de Clientes PPPoE sem controle de Access­List.


http://192.168.140.198:8083/service/mikrotik/index?key=XXXXXXXXXXXXXX(SUACHAVE)&local_address=XXXXXXXXX(gateway)&remote_address=XXXXXXXXXX(nome_pool)

Controllr backup mikrotik2.png


Inserir script no Mikrotik

No Mikrotik, entrar no menu System > Scripts e adicionar um novo script. Nomeie o script e no campo source, altere conforme o exemplo de script a baixo:

############################################################

:global IPCONTROLLR "IPLOCALDOCONTROLLR";
:global KEY "SUACHAVE";
:global DEVICE "0";
:global PPPOE "1";
:global HOTSPOT "0";
:global LOCALADDRESS "192.168.1.1";
:global REMOTEADDRESS "pool-pppoe";
:global DNSSERVER1 "8.8.8.8";
:global DNSSERVER2 "8.8.4.4";
:global done "";
:log warning "Importando PPPoE";
/tool fetch mode=http url="http://$IPCONTROLLR:8083/service/mikrotik/index?key=$KEY&device=$DEVICE&local_address=$LOCALADDRESS&remote_address=$REMOTEADDRESS&pppoe=$PPPOE&hotspot=$HOTSPOT&dns_server1=$DNSSERVER1&dns_server2=$DNSSERVER2" src-path=mikrotik.php dst-path=clientsctrl.rsc;
:set done "true";
:if ( [/file find name=clientsctrl.rsc] != "" ) do={
:log warning "Importando PPPoE2";
/import clientsctrl.rsc;
/file remove clientsctrl.rsc
#/ppp secret unset [find where comment=controllr] remote-address;
/ppp secret set caller-id="" [find comment="controllr"]
}

###################################################


Depois que substituir os campos corretos clique em Aplly e depois Run Script.

Logo após rodar o Script, copie-o e cole em System > Scheduler, marque em Start Time : startup e Interval: 24:00:00

Netwatch via script

/tool netwatch
add comment=CTLR-BACKUP down-script=":log warning \"IP do Controllr off habilitando as secrets\"\r\
    \n/ppp secret set [find comment=controllr] disabled=no" host=192.168.10.5 interval=2m up-script=":log warning \"Desabilitando as Secrets do Controllr\"\r\
    \n/ppp secret set [find comment=controllr] disabled=yes\r\
    \n:delay 3m\r\
    \n:log warning \"Removendo Secrets com o Comentario controllr\"\r\
    \n/ppp active remove [find where comment=controllr]"


Download do script pode ser efetuado clicando aqui!


Crie o Scheduler

Logo após rodar o Script, copie-o e cole em System > Scheduler, marque em Start Time : startup e Interval: 24:00:00


Criar Netwatch no Mikrotik

A ferramenta netwatch tem como função realizar ping a um determinado endereço e executar um script quando "conseguir" o ping (UP) e executando outro script quando "não conseguir" (DOWN). Entendendo a regra: Nesta regra realizamos ping no servidor Controllr em caso de estar "UP" as secrets encontram-se 'desabilitadas' (disable=yes) quando o Controllr estiver sem comunicação (DOWN) as secrets são 'habilitadas' (disable=no).

No Mikrotik, abra o terminal e execute os comandos abaixo:

Obs: Substitua apenas o campo ip, conforme os parâmetros disponíveis e sua necessidade.

Para PPPoE:

/tool netwatch add down-­script="/ppp secret set [find comment=controllr] disabled=no" host=192.168.140.198 interval=5s up-­script="/ppp secret set [find comment=controllr] disabled=yes"

Para HOTSPOT:

/tool netwatch add down­-script="/ip hotspot user set [find comment=controllr] disabled=no host=192.168.140.198 interval=5s up-­script="/ip hotspot user set [find comment=controllr] disabled=yes"

Video aula, backup do Controllr no mikrotik


Video