MKsolutions
Este documento tem como objetivo apresentar as principais informações sobre a importação de dados entre MKsolutions e OZmap, bem como disponibilizar um formulário pré-importação.
Descrição
A importação entre MKsolutions e OZmap acontece via banco de dados, nós realizamos as consultas no banco de dados do MK, nas tabelas necessárias para realizar a importação dos elementos no OZmap.
Resumo das funcionalidades
Importações de Tipos
Funcionalidade | Descrição |
---|---|
Importação de Tipos de Caixas | Importar para o OZmap os tipos de caixas existentes no MKsolutions. Necessário para importar caixas. |
Importação de Tipos de Cabos | Importar para o OZmap os tipos de cabos existentes no MKsolutions. Necessário para importar cabos. |
Importação de Tipos de Splitters | Importar para o OZmap os tipos de splitters existentes no MKsolutions. Necessário para importar splitters. |
Importação de Elementos
Funcionalidade | Descrição |
---|---|
Importação de Projetos | É criado um projeto pai e tudo será criado dentro dele. Os demais projetos no MK também são importados, porém vazios, apenas herdando elementos e configurações do projeto pai. |
Importação de Postes | Importar todos os postes do MK. |
Importação de Caixas | Importar todas as caixas do MK. |
Importação de POPs, Armários e OLTs | Importar todas as POPs do MK. É criado apenas um armário e uma OLT por POP. |
Importação de OLTs | É importada apenas uma OLT por POP, por conta da disponibilidade do MK. |
Importação de Splitters | Importar todos os splitters do MK. |
Importação de Cabos | Importar todos os cabos do MK. |
Importação de Condomínios | Importar todos os condomínios do MK. |
Importação de Clientes | Importar todos os clientes do MK. |
Importação de Conexões dos Splitters | Faz as conexões dos splitters aos clientes e cabos de rede que passam dentro da caixa. |
Importação de Conexão dos Cabos | Faz a conexão das fibras entre si dentro das caixas. |
Importação de Conexões DIO | Faz a conexão dos DIO com as POPs. |
Funcionalidades
Abaixo serão descritas as funcionalidades do serviço de importação OZmap apresentadas no resumo de forma a entender como funciona o fluxo de importação.
Importação de Tipos
As importações de tipos são feitas para permitir que os dados que as utilizam (Cabos, Caixas, Splitters) possam ser criados no OZmap corretamente. As importações ocorrem da seguinte forma:
Tipos de caixas: Os tipos de caixas são importados do MK para o OZmap. Caso o tipo já exista no OZmap com o mesmo nome, ele então não será criado novamente.
Utilizamos o nome do tipo no MK como nome do tipo no OZmap.
Utilizamos como reserva técnica padrão 50m.
Utilizamos a cor da borda padrão como “#3388FF”, que é um azul.
Tipos de cabos: Os tipos de cabos são importados do MK para o OZmap. Caso o tipo já exista no OZmap com o mesmo nome, ele então não será criado novamente.
Utilizamos o nome do tipo do MK para colocar o nome do tipo no OZmap.
Utilizamos a mesma quantidade de fibras do MK para colocar no OZmap.
Utilizamos a mesma cor de cabo que temos do MK para colocar no OZmap. Caso no MK o cabo não tenha cor, utilizamos a cor padrão do cabo como "#ff6600", que é um laranja.
Tipos de splitters: Os tipos de splitters são importados do MK para o OZmap. Caso o tipo já exista no OZmap com o mesmo nome, ele então não será criado novamente.
Utilizamos o nome do tipo do MK para colocar o nome do tipo no OZmap.
Utilizamos a mesma quantidades de portas no MK para colocar a quantidade de portas no OZmap.
Utilizamos o indice de perda, se ele é ou não balanceado e a atenuação das portas do MK para calcular e colocar como atenuação no OZmap em dB.
Importação de Elementos
As importações de elementos do MK é feita com o objetivo de replicar os elementos de documentação, total ou parcial. As importações de elementos do MK para o OZmap ocorrem da seguinte forma:
Projetos: Vamos criar um único projeto para importação de todos os elementos, podendo ser chamado de projeto pai. O padrão de nomenclatura para esse projeto será: “Nome do cliente - MKsolutions”.
Além do projeto pai, teremos a importação dos projetos existentes no MK, porém, todos vão estar vazios, apenas herdando os elementos do projeto pai.
Postes: Todos os postes do MK serão importados no OZmap.
Postes são elementos que não possuem projeto no OZmap, então ao importar novos postes, eles vão ficar disponíveis para todos os demais projetos.
Utilizamos o mesmo nome que ele tem no MK quando trazemos o poste para o OZmap.
Utilizamos a mesma latitude e longitude que ele tem no MK quando trazemos o poste para o OZmap.
Utilizamos o tipo comum quando criamos o poste no OZmap.
Caixas: Por padrão, importamos uma caixa por poste. Porém isso pode ser personalizado. Todos os elementos são importados sempre em uma única caixa do poste.
Utilizamos o mesmo poste que ela se encontra no MK quando trazemos a caixa para o OZmap.
Utilizamos o mesmo nome que esta no MK quando trazemos a caixa para o OZmap.
Utilizamos as mesmas observações que a caixa tem no MK quando trazemos a caixa para o OZmap.
No modelo padrão de importação de uma única caixa, somente uma caixa vai ser importada por poste e todos os elementos do MK presentes no poste serão importados na mesma caixa (Splitters, conexões, cabos). O nome dessa caixa será o nome da primeira caixa do poste no MK.
Esse comportamento pode ser modificado pela configuração “Criação de várias caixas por poste”, onde cada elemento do poste MK será criado como caixa no OZmap, mas mesmo assim os elementos como splitters, cabos e conexões serão todos criados na primeira caixa do poste.
POPs, Armários e OLTs: Todas as pops serão importadas do MK.
Utilizamos o mesmo nome que a POP tem no MK quando trazemos ela para o OZmap.
Utilizamos o mesmo poste que a POP tem no MK quando trazemos ela para o OZmap.
Utilizamos o tipo comum para a POP quando trazemos ela para o OZmap.
Utilizamos a POP que acabou de ser criada para armazenar os armários que serão criados no OZmap.
Utilizamos o tipo comum para os armários quando são criados dentro das POPs no OZmap.
Utilizamos o mesmo nome da POP para nomear os armários no OZmap.
Utilizamos o armário que acabou de ser criado para armazenar a OLT que será criada no OZmap.
Utilizamos o mesmo nome da POP para nomear a OLT quando trazemos ela para o OZmap, junto com o código que a POP tem no MK.
Utilizamos um tipo criado no momento importação chamado “Tipo Básico de OLT - MK” que é utilizado para as OLTs criadas no OZmap.
Por conta da disponibilidade do MK, é criado apenas um armário e uma OLT por POP com base nas informações da POP.
Splitters: Todos os splitters serão importados do MK. Todos os splitters serão importadas na mesma caixa, assim como os demais elementos.
Utilizamos a mesma caixa que o splitter pertence no MK caso seja apenas uma caixa no poste para o OZmap. Caso seja mais de uma caixa no poste, iremos importar todos eles na mesma caixa.
Utilizamos o mesmo tipo do splitter no MK quando trazemos ele para o OZmap.
Utilizamos o mesmo nome que o splitter tem no MK quando trazemos ele para o OZmap.
Cabos: Todos os cabos serão importados do MK.
Utiizamos as coordenadas que vem com o cabo para importar para o OZmap, o mesmo caminho que ele tem no MK.
Utilizamos o mesmo nome para o cabo que ele tem no MK quando trazemos ele para o OZmap.
Utilizamos o mesmo tipo que ele tem no MK quando trazemos ele para o OZmap.
Condomínios Verticais: Todos os condomínios são importados do MK.
As informações de conexão do condomínio com os clientes vão estar nas observações de condomínio. (Nome do cliente, descrição, código da conexão)
Utilizamos a mesma localização que ele tem no MK quando importamos ele no OZmap.
Utilizamos o mesmo nome que ele tem no MK quando importamos ele no OZmap.
Utilizamos a mesma observação que ele tem no MK quando importamos ele no OZmap.
Clientes: Todos os clientes são importados do MK.
O código único do cliente será o seu username no MK. Porém pode ser modificado pela configuração “Código único do cliente”.
Por padrão nas observações do cliente no OZmap, vai o seu código de conexão no MK. Porém isso é algo que pode ser modificado pela configuração “Template para observações do cliente”.
Utilizamos o mesmo nome que ele tem no MK quando importamos ele no OZmap.
Utilizamos o mesmo endereço que ele tem no MK quando importamos ele no OZmap.
Utilizamos a mesma caixa que ele tem no MK quando importamos ele no OZmap.
Utilizamos as mesmas observações que ele tem no MK quando importamos ele no OZmap.
Utilizamos as mesmas coordenadas que ele tem no MK quando importamos ele no OZmap.
Utilizamos como “onu” as seguintes informações quando importamos ele no OZmap:
Serial: O “onu_serial” que ele tem no MK.
User PPPoE: O “username” que ele tem no MK.
Endereço MAC: O “mac_address” que ele tem no MK.
Utilizamos a mesma caixa e mesma porta e conexão de splitters que ele tem no MK quando importamos ele no OZmap.
Os clientes de condomínios do MK são criados dentro dos condomínios verticais do OZmap no formato padrão da documentação OZmap.
Conexão dos splitters: Vai fazer a conexão dos splitters aos clientes e aos cabos que passam por dentro da caixa.
Iremos replicar as conexões dos splitters com clientes e com cabos.
Conexão dos cabos: Faz a conexão dos cabos entre si por dentro das caixas.
Iremos replicar as conexões dos cabos com clientes e com outros cabos.
Conexão dos DIOS: Faz a conexão dos dios com as POPs.
Iremos replicar as conexões dos DIOS com cabos e OLTs.
Configurações Base
Configurações e Personalizações
Parâmetro | Descrição | Padrão |
---|---|---|
Código único do cliente | Informação do MK utilzada como código único para os clientes no OZmap. | Username. |
Criação de várias caixas por poste | Cria todos os elementos de poste no MK como caixas no OZmap. Ex: NAP, HUB, Diagrama. | Desativado. |
Template para observações do cliente | Criar um texto que vai puxar informações para colocarmos nas observações do cliente no OZmap, como o username dele no MK. | Código de conexão. |
Dados de acesso
Formulário de Importação MKsolutions
Dados de acesso necessários para buscar as informações do banco de dados do MK e importar no OZmap. (Estes dados devem ser fornecidos no questionário inicial).
Informações OZmap e MK
Parâmetro | Descrição | Exemplo |
---|---|---|
URL do OZmap | URL que usaremos para acessar a base do cliente no OZmap. | |
URL do MKsolutions | URL que usaremos para acessar a interface do MKsolutions para validações da importação. | |
Usuário de leitura ao sistema | Usuário usado para acessar a interface do MKsolutions. | userozmap |
Senha do usuário de leitura ao sistema | Senha usada para acessar a interface do MKsolutions. | passwordozmap |
Endereço do banco de dados MKsolutions | Endereço do banco de dados que iremos acessar para fazer as importações. | 123.456.78.91 |
Porta de acesso ao banco de dados MKsolutions | Porta para acesso ao banco de dados de importação. | 5432 |
Usuário para acesso ao banco de dados MKsolutions | Usuário disponível para acesso ao banco de dados. | username |
Senha do usuário para acesso ao banco de dados MKsolutions | Senha do usuário para acesso ao banco de dados. | password |
Versão do banco de dados MKsolutions | Versão que se encontra o banco de dados MKsolutions para importação. | mkData3.0 |
Liberação de ips
Para importação, tanto em validação quanto em produção, é necessário a liberação de alguns IPs por parte do cliente no MK:
Ip da nossa VPN: 54.207.162.199
Ip da máquina de importação: Será enviado pelo time de importação quando o serviço for confirmado.
Ip da máquina do cliente no OZmap (ping https://cliente.ozmap.com.br:9994)
Dúvidas frequentes
Pergunta | Resposta | Funcionalidade |
---|---|---|
É possível não importar algo que esta na lista de elementos? | Sim. | Caso o elemento a deixar de ser importado não interfira na importação de outros, podemos deixar de importar sim. |