Skip to content

Migrando da v1.6.x para v2.x.x

João Ribeiro edited this page Dec 28, 2021 · 13 revisions

O que mudou?

A partir da versão 2.0.0 o projeto sofreu uma atualização lógica em sua forma de funcionamento, foi realizada a separação de front-end e back-end possibilitando maior organização, facilidade de manutenção e maior agilidade e escalabilidade.

Com base nessa atualização foram aplicadas técnicas mais modernas de desenvolvimento, por conta disso, a API funcional do projeto foi alterada, fazendo com que não exista mais compatibilidade entre v1.6.x e v2.x.x.

Quais alterações necessárias?

Para migrar para versão v2.x.x a partir de uma versão v1.6.x são necessárias algumas intervenções, tendo em vista a alteração na forma de funcionamento, sendo elas:

  • O padrão de indicação da latitude e longitude dos hosts:

Onde antes se configurava:

latlng: 66.174082,-13.119136

Deve ser alterado para:

<latlng>66.174082,-13.119136</latlng>

ATENÇÃO: essa informação deve continuar na linha de 'notes', a linha deve ficar dessa forma:

notes       <latlng>66.174082,-13.119136</latlng>
  • Arquivo de configurações:

O arquivo de configurações foi alterado, agora ao invés de utilizar variáveis separada para cada opção é utilizado um array único para todas as definições. Dessa forma o antigo arquivo de configuração não é compatível com essa nova versão.

Fazendo necessário transcrever suas configurações para o novo formato. Para ajudar nessa tarefa, foi criada a Ferramenta de Migração, que transcreve o arquivo de configuração, salvando suas opções e evitando a transcrição manual.

Após o acesso, basta colar suas configurações atuais e pressionar migrar para que a configuração no novo padrão seja gerada.

Você deve notar que algumas opções mudaram de nome, algumas foram removidas e outras adicionadas, segue o comparativo entre as opções da v1.6.x e v2.x.x:

v1.6.x v2.x.x
$nagios_cfg_file general.cfg_file
$nagios_status_dat_file general.status_file
$nagMapR_Debug general.debug
$nagMapR_IsNagios X
$nagMapR_MapAPI X (Google Maps removido devido pouco uso)
$nagMapR_MapCentre map.centre
$nagMapR_MapZoom map.zoom
$nagMapR_LeafletStyle map.style
$nagMapR_MapType X
$nagMapR_Mapkey X
$nagMapR_Lang ngreborn.language
$nagMapR_FilterHostgroup ngreborn.filter_hostgroup
$nagMapR_FilterService ngreborn.filter_service
$nagMapR_ChangesBar X (Incorporado no 'mode')
$nagMapR_ChangesBarMode ngreborn.changes_bar.mode
$nagMapR_ChangesBarSize ngreborn.changes_bar.size
$nagMapR_FontSize ngreborn.changes_bar.font_size
$nagMapR_BarFilter ngreborn.changes_bar.filter
X ngreborn.priorities.unknown
X ngreborn.priorities.up
X ngreborn.priorities.warning
X ngreborn.priorities.critical
X ngreborn.priorities.down
$nagMapR_DateFormat X (Agora é baseado na linguagem)
$nagMapR_PlaySound ngreborn.play_sound
X ngreborn.update_animation
$nagMapR_IconStyle ngreborn.default_icon_style
$nagMapR_Lines ngreborn.lines
$nagMapR_TimeUpdate ngreborn.time_update
$nagMapR_Reporting ngreborn.reporting
$nagMapR_key security.key
X security.allow_overwrite
$nagMapR_useAuth security.use_auth
$nagMapR_User security.user
$nagMapR_UserKey security.user_pass

*A explicação para cada opção esta disponível no arquivo config.php.example

Principais novidades

Junto com todas as melhorias tecnológicas também foram implementadas algumas funcionalidades novas.

Além da nova interface feita do zero e melhor desempenho do back-end, outras novidades que vale destacar são:

  • Novos estilos de ícones foram adicionados, agora com símbolos wi-fi e roteadores, para melhor representar o que esta sendo monitorado;
  • A possibilidade de criar estilos de ícones personalizados de forma nativa, você pode acompanhar aqui um tutorial;
  • Agora é possível fazer a sobrescrita de parâmetros através da URL, assim provendo uma forma facilitada para quando se usa mais de um monitor ou monitora hostgroups diferentes ao mesmo tempo, você encontra um tutorial aqui;

João Carlos.

See here in English.