Mudanças entre as edições de "Controllr/Aplicativos/Backup/Backup Mikrotik"
(27 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 |
− | + | 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: | + | [[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¶metro2=valor… | ||
+ | |||
+ | ''Exemplo de URL para gerar o backup de Clientes PPPoE sem controle de AccessList.'' | ||
+ | |||
+ | |||
+ | <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.
Índice
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.
Montar URL para obter as informações conforme sua necessidade
Como a URL deve ser montada:
http://IPDOCONTROLLR:8083/service/mikrotik/index?parametro1=valor¶metro2=valor…
Exemplo de URL para gerar o backup de Clientes PPPoE sem controle de AccessList.
http://192.168.140.198:8083/service/mikrotik/index?key=XXXXXXXXXXXXXX(SUACHAVE)&local_address=XXXXXXXXX(gateway)&remote_address=XXXXXXXXXX(nome_pool)
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