Você está na página 1de 207

DMVIEW 11.

2 – INSTALAÇÃO
MANUAL DE INSTALAÇÃO

204.0119.47 – OUTUBRO/2022
DmView – Instalação GARANTIA

GARANTIA

Sistema de Gestão da Qualidade


certificado pela DQS de acordo
com ISO9001 Nº de registro (287097 QM)

Apesar de terem sido tomadas todas as precauções na elaboração deste documento, a empresa não assume
qualquer responsabilidade por eventuais erros ou omissões, bem como nenhuma obrigação é assumida por
danos resultantes do uso das informações contidas neste manual. As especificações fornecidas neste manual
estão sujeitas a alterações sem aviso prévio e não são reconhecidas como qualquer espécie de contrato.

DATACOM 204.0119.47 – OUTUBRO/2022 2


DmView – Instalação CONTATOS

CONTATOS

Para contatar o suporte técnico, enviar sugestões, novas funcionalidades, críticas ou falar com o setor de
vendas, seguem os telefones e/ou e-mails:

• Suporte:
• E-mail: suporte@datacom.com.br
• Fone: +55 51 3933-3122
• Sugestões:
• E-mail: contato.dmview@datacom.com.br
• Comercial
• E-mail: comercial@datacom.com.br
• Fone: +55 51 3933-3000
• Fax: +55 51 3933-3003
• Internet
• www.datacom.com.br

• Endereço
• DATACOM
• Rua América, 1000 – Eldorado do Sul, RS - Brasil
• CEP: 92990-000

DATACOM 204.0119.47 – OUTUBRO/2022 3


DmView – Instalação CONVENÇÕES

CONVENÇÕES

Para facilitar o entendimento, foram adotadas, ao longo deste manual, as seguintes convenções:

hyperlink - Indica um endereço na internet ou um endereço de e-mail.

Comando ou Botão - Sempre que for referido algum comando, botão ou menu de algum software,
esta indicação estará em itálico.

#Comandos e mensagens de telas de terminal são apresentados como texto sem formatação,
precedidos de # (sustenido).

Ícone Tipo Descrição

Nota As notas explicam melhor algum detalhe apresentado no texto.

Esta formatação indica que o texto aqui contido tem grande


Cuidado importância e há risco de danos. Deve ser lido com cuidado e pode
evitar grandes dificuldades.

DATACOM 204.0119.47 – OUTUBRO/2022 4


DmView – Instalação MANUAIS

MANUAIS

Os manuais do DmView estão divididos em 13 partes, com o objetivo de melhor organizá-los, são eles:

• 204.0119.47 - DmView - Manual de Instalacao

• 204.0327.06 - DmView - Quick Installation Guide_PT

• 204.0313.09 - DmView - Upgrade Guide_PT

• 204.0220.44 - DmView - Manual de Operacao Geral

• 204.0221.44 - DmView - Manual de Gerencia Ethernet Switches

• 204.0222.44 - DmView - Manual de Gerencia PDH-SDH

• 204.0118.44 - DmView - Manual do Portal Web de Relatórios

• 204.0297.14 - DmView - Web Maestro User Guide_PT

• 204.0296.14 - DmView - CLI Template User Guide_PT

• 184.0010.03 – DmView – DM4600 User Guide

• 204.0238.25 - DmView - Alta Disponilidade

• 204.0319.05 - DmView - Database HA_PT

• 204.0354.01 - DmView - API Northbound_PT

Após a instalação do DmView, os manuais estarão na pasta \DmView\doc. Caso necessite de algum
destes manuais separadamente, eles também podem ser solicitados ao suporte.

DATACOM 204.0119.47 – OUTUBRO/2022 5


DmView – Instalação SUMÁRIO

SUMÁRIO

GARANTIA ..................................................................................................................................................................................... 2
CONTATOS ................................................................................................................................................................................... 3
CONVENÇÕES .............................................................................................................................................................................. 4
MANUAIS ....................................................................................................................................................................................... 5
SUMÁRIO....................................................................................................................................................................................... 6
1 Introdução ........................................................................................................................................................................ 11
1.1 Apresentação do DmView .................................................................................................................................... 11
1.2 Versões do DmView................................................................................................................................................ 12
2 Requisitos de instalação ................................................................................................................................................ 13
2.1 Permissões e acessos de usuário ....................................................................................................................... 13
2.2 Software e hardware requeridos pelo DmView ............................................................................................... 14
2.2.1 Hardware ............................................................................................................................................................. 14
2.2.2 Softwares requeridos ........................................................................................................................................ 15
2.3 Banco de dados ...................................................................................................................................................... 17
2.3.1 Oracle 11g/18c Express Edition ...................................................................................................................... 17
2.3.2 Oracle Standard/Enterprise Edition 11g/12c/18c/19c .............................................................................. 17
2.3.3 MongoDB ............................................................................................................................................................. 18
2.4 Java (SUN JDK 1.8.0_121)..................................................................................................................................... 18
2.4.1 Alterando o caminho do Java após a instalação do DmView .................................................................. 21
2.5 Zabbix ....................................................................................................................................................................... 21
2.5.1 Integração DmView x Zabbix ........................................................................................................................... 22
2.6 Softwares complementares ................................................................................................................................. 22
2.6.1 Microsoft SNMP Agent ...................................................................................................................................... 22
2.6.2 Web browser ....................................................................................................................................................... 23
2.6.3 Microsoft Terminal Service/Remote Desktop (opcional) .......................................................................... 23
2.6.4 CentOS Minimal ................................................................................................................................................. 23
2.7 Suporte a ambientes virtuais ............................................................................................................................... 24
2.8 Resolução mínima de vídeo................................................................................................................................. 24
2.9 Latência de rede ..................................................................................................................................................... 24
2.10 DmView console ..................................................................................................................................................... 24

DATACOM 204.0119.47 – OUTUBRO/2022 6


DmView – Instalação SUMÁRIO

2.11 Certificados.............................................................................................................................................................. 24
2.11.1 Visualizando certificados usados pelo DmView ..................................................................................... 25
2.11.2 Importando um certificado......................................................................................................................... 26
2.11.3 Importando um certificado digital (.p12) para o DmView Web (Maestro) ........................................ 26
2.11.4 Importando um certificado digital (.p12) para o servidor ACS (NMS ACS)........................................ 27
2.11.5 Removendo certificados utilizados pelo DmView.................................................................................. 30
2.11.6 Gerando uma private key ............................................................................................................................ 31
2.11.7 Gerando o CSR (Certificate Signing Request).......................................................................................... 31
2.11.8 Certificados registrados antes do upgrade para a versão 9.7 (ou superior) ..................................... 32
2.12 DmView listening ports ......................................................................................................................................... 32
2.13 Configuração de Firewall ...................................................................................................................................... 33
2.13.1 Exemplo de topologia de servidores do ambiente DmView ................................................................ 33
2.13.2 Application Server > Network Devices ...................................................................................................... 34
2.13.3 Network Devices > Application Server ...................................................................................................... 35
2.13.4 Application Server ou Application Console > Oracle Database/Mongo Database ......................... 35
2.13.5 Application Console > Application Server ............................................................................................... 36
2.13.6 Application Server > Application Console................................................................................................ 37
2.13.7 Application Console > Network Devices................................................................................................... 37
2.13.8 Workstations > Application Console ......................................................................................................... 38
2.13.9 Application Console > LDAP Server ........................................................................................................... 38
2.13.10 Application Server > LDAP Server .............................................................................................................. 38
2.13.11 Workstations > LDAP Server ........................................................................................................................ 38
2.13.12 Workstations > Application Server (Portal Web/Interface Web) ......................................................... 39
3 Instalação do Oracle XE ................................................................................................................................................. 39
3.1 Instalação e configuração do Oracle 11g XE em Windows............................................................................ 39
3.2 Instalação e configuração do Oracle 18c XE em Windows ............................................................................ 44
3.2.1 Configuração do Oracle 18c XE para NÃO CONTAINER ............................................................................. 47
3.3 Upgrade de Oracle 11g XE para Oracle 18c XE ................................................................................................. 61
3.3.1 Exportação dos dados do Oracle 11g XE ...................................................................................................... 61
3.3.2 Verificação do arquivo dmp ............................................................................................................................ 61
3.3.3 Desinstalação do Oracle 11g XE e instalação do Oracle 18c XE .............................................................. 62
3.3.4 Importação dos dados do Oracle 11g XE no Oracle 18c XE ...................................................................... 62
3.4 Exportando backup da base de dados DmView .............................................................................................. 63
DATACOM 204.0119.47 – OUTUBRO/2022 7
DmView – Instalação SUMÁRIO

3.4.1 Windows .............................................................................................................................................................. 63


3.4.2 Linux ..................................................................................................................................................................... 65
3.5 Importando backup da base de dados ............................................................................................................. 66
3.6 Exportando/Importando usuários da base de dados .................................................................................... 71
3.7 Utilizando o RMAN para realizar backup do Oracle ........................................................................................ 73
3.7.1 Windows .............................................................................................................................................................. 73
3.7.2 Linux ..................................................................................................................................................................... 75
3.8 Utilizando o RMAN para realizar o restore do Oracle ..................................................................................... 77
4 Instalação do Mongo Database .................................................................................................................................... 78
4.1 Instalação do MongoDB em Windows ............................................................................................................... 78
4.2 Instalação do MongoDB em Linux ...................................................................................................................... 81
4.3 Backup do Mongo Database ................................................................................................................................ 81
5 Instalação do DmView .................................................................................................................................................... 84
5.1 Instalação do DmView em Windows .................................................................................................................. 84
5.1.1 Pré-requisitos ..................................................................................................................................................... 84
5.1.2 Tipos de instalação ........................................................................................................................................... 84
5.1.3 Enterprise Server................................................................................................................................................ 85
5.1.4 Enterprise Console .......................................................................................................................................... 102
5.1.5 Poller Server ...................................................................................................................................................... 107
5.1.6 Web Server ........................................................................................................................................................ 111
5.1.7 Database Server ............................................................................................................................................... 116
5.2 Instalação do DmView em Linux ....................................................................................................................... 130
5.2.1 Pré-requisitos ................................................................................................................................................... 130
5.2.2 Configuração de open files ............................................................................................................................ 130
5.2.3 Instalação DmView .......................................................................................................................................... 131
5.3 Logando no DmView ........................................................................................................................................... 139
5.3.1 Windows ............................................................................................................................................................ 139
5.3.2 Linux ................................................................................................................................................................... 140
5.4 Upgrade de versão em Windows e Linux ........................................................................................................ 140
5.4.1 Antes de realizar a atualização ..................................................................................................................... 140
5.4.2 Atualizando o DmView.................................................................................................................................... 141
5.4.3 Certificados registrados ................................................................................................................................. 143
6 Instalação e configuração de ferramentas para acesso remoto ao DmView ................................................... 143
DATACOM 204.0119.47 – OUTUBRO/2022 8
DmView – Instalação SUMÁRIO

6.1 Windows (workstation) x Linux (DmView)....................................................................................................... 143


6.1.1 Xming.................................................................................................................................................................. 143
6.1.2 X2GO ................................................................................................................................................................... 152
6.1.3 XManager ........................................................................................................................................................... 161
7 Configuração do DmView ............................................................................................................................................ 167
7.1 Hierarquia de diretórios ...................................................................................................................................... 167
7.2 Janela About ......................................................................................................................................................... 168
7.2.1 Licenciamento do DmView ............................................................................................................................ 169
7.3 Arquivo “nms.conf” .............................................................................................................................................. 173
7.3.1 General ............................................................................................................................................................... 173
7.3.2 Server NMS ........................................................................................................................................................ 173
7.3.3 Trap/Event Configuration .............................................................................................................................. 178
7.3.4 Server Database ............................................................................................................................................... 178
7.3.5 Fault Systems ................................................................................................................................................... 178
7.3.6 Web ..................................................................................................................................................................... 178
7.3.7 User Preferences e Database Pool Conection ........................................................................................... 178
7.3.8 Provisioning ...................................................................................................................................................... 179
7.3.9 Application Server Configuration ................................................................................................................. 180
7.3.10 LDAP ............................................................................................................................................................... 182
7.3.11 NES Device Cache ....................................................................................................................................... 182
7.3.12 Status Device Cache ................................................................................................................................... 182
7.3.13 CLI Template ................................................................................................................................................ 182
7.3.14 Portal Web .................................................................................................................................................... 186
7.4 Serviços do DmView ............................................................................................................................................ 187
7.4.1 Serviços instalados em Windows ................................................................................................................. 187
7.4.2 Iniciando os serviços do DmView em Windows ........................................................................................ 187
7.4.3 START SERVICES em Windows...................................................................................................................... 188
7.4.4 STOP SERVICES em Windows ....................................................................................................................... 188
7.4.5 Serviços instalados em Linux ........................................................................................................................ 189
7.4.6 Iniciando os serviços do DmView em Linux ............................................................................................... 189
7.4.7 NMS ALLSERVICES START em Linux ............................................................................................................ 190
7.4.8 NMS ALLSERVICES STOP em Linux .............................................................................................................. 190
7.4.9 Memória utilizada pelos serviços ................................................................................................................. 191
DATACOM 204.0119.47 – OUTUBRO/2022 9
DmView – Instalação SUMÁRIO

7.4.10 Memória utilizada pela Login ................................................................................................................... 192


7.5 Logs do DmView ................................................................................................................................................... 194
7.5.1 Configuração do log ........................................................................................................................................ 194
7.5.2 Capturando os logs do DmView com o script generateTroubleshootingLogs................................... 195
7.5.3 Capturando os logs do DmView com o script generateTroubleshootingLogsWithMaskedIps ...... 195
7.6 Credenciais de acesso aos bancos de dados Oracle e MongoDB.............................................................. 198
8 Configurações complementares ................................................................................................................................ 200
8.1 Configuração do Polling Agendado ................................................................................................................. 200
8.2 Configuração do Poller Distribuído .................................................................................................................. 200
8.2.1 Configuração de uma instância de poller distribuído ............................................................................. 201
8.3 Inicialização automática do DmView............................................................................................................... 202
8.3.1 Windows ............................................................................................................................................................ 202
8.3.2 Linux ................................................................................................................................................................... 205
8.4 Configuração da senha do ACS Server ............................................................................................................ 206

DATACOM 204.0119.47 – OUTUBRO/2022 10


DmView – Instalação Introdução

1 INTRODUÇÃO

1.1 APRESENTAÇÃO DO DMVIEW

DmView é o Sistema Integrado de Gerência de Rede e de Elemento desenvolvido para supervisionar e configurar
os equipamentos Datacom, disponibilizando funções para gerência de supervisão, falhas, configuração,
desempenho, inventário e segurança. O sistema pode ser integrado a outras plataformas de gerência ou pode
operar de forma independente. Também é possível utilizar diferentes arquiteturas de gerência, desde a
operação em campo via notebook até um projeto centralizado com servidores de aplicação redundantes e
múltiplos servidores de terminal para acesso remoto.

O sistema disponibiliza o acesso às suas funcionalidades através de uma Interface gráfica amigável e fácil de
ser utilizada. Ele permite o acesso simultâneo de múltiplos usuários em estações de gerência distintas,
possibilitando que operadores diferentes possam gerenciar a mesma rede de equipamentos Datacom. Os
usuários do sistema operam com níveis de acesso distintos, sendo possível restringir a operação por tipo de
equipamento ou localidade. Entre as principais funcionalidades do DmView, é possível citar:

• Visualização e monitoração dos equipamentos gerenciados, suas interfaces e CPUs, permitindo


identificação do estado operacional e alarmes ativos;

• Recepção e tratamento dos eventos gerados pelos equipamentos, com notificação automática da
ocorrência de falhas e opção para executar ação específica quando determinado evento é recebido;

• Execução de ações de diagnóstico e visualização de parâmetros e contadores de desempenho;

• Completa configuração dos equipamentos Datacom, inclusive com cadastro de dados de identificação
e localidade;

• Backup programável e rotação do armazenamento da configuração dos elementos gerenciados;

• Ferramentas para localização de equipamentos e suas interfaces, incluindo localização por estado
operacional, localidade, cliente atendido, etc;

• Visualização dos equipamentos Datacom através de mapas topológicos, com facilidade para criação
de localidades e de links;

• Ferramentas para provisionamento de circuitos ponto a ponto entre diferentes elementos, permitindo
a criação, alteração e localização de circuitos existentes na rede;

• Correlação de eventos por porta e por circuito customizável;

• Logs de auditoria para ações de usuários;

• Relatórios via interface Web, exportável para os formatos HTML, PDF, XLS, XLSX e CSV, com envio
configurável por e-mail e possibilidade de criar favoritos;

DATACOM 204.0119.47 – OUTUBRO/2022 11


DmView – Instalação Introdução

• Suporte a servidores redundantes operando em cluster para alta disponibilidade automática;

• Suporte a diferentes sistemas operacionais (Microsoft Windows e Linux CentOS) e bases de dados
(Oracle);

• Monitoração de CPU/memória, potência ótica, trafego e pacotes com erro/descartados/unknown/uni-


multi-broadcast via integração com o Zabbix.*

*Tráfego e pacotes com erro/descartados/unknown/uni-multi-broadcast (in e out) –


DmOS, DM1200, DM2500, DM2290, DM1105, DM1205.

CPU e memória – Todos os Switches, Routers e OLTs, seja DmOS ou não. Exibidos mesmo
sem a integração com o Zabbix.

Tráfego (in e out) e potência ótica (Rx e Tx) de ONUs – DmOS.

1.2 VERSÕES DO DMVIEW

O DmView é disponibilizado nas seguintes versões atualmente.

• Enterprise Server: É a versão sem restrições, sendo a solução mais completa de gerência DmView que
pode ser disponibilizada, incluindo todas as ferramentas disponíveis no sistema.

• Enterprise Console: Instala somente a console de administração, utilizado para a comunicação entre a
console e o servidor. Esta opção é utilizada quando existe um servidor e deseja-se administrá-lo através
de outras máquinas.

• Web Server: Esta opção é apenas para instalar a versão Web Server aonde será possível gerar relatórios
com informações dos equipamentos, circuitos, links, usuários, etc. Esta opção destina-se aos clientes
que preferiram instalar em ambientes separados Web Server e Enterprise Server ou não selecionaram
o pacote web no momento da instalação Enterprise Server.

• Database Server: Este modo é apenas para configuração do banco de dados do usuário, podendo
escolher entre a criação do banco (create); criação de tablespaces, usuários de administração e o banco
de dados do DmView (setup and create) ou a atualização do banco existente (update). Nesta opção
Database Server, o DmView não será instalado.

Todas estas versões estão presentes em um único instalador, basta selecionar a opção desejada durante a
instalação como será mostrado nas seções seguintes.

DATACOM 204.0119.47 – OUTUBRO/2022 12


DmView – Instalação Requisitos de instalação

2 REQUISITOS DE INSTALAÇÃO
Este capítulo apresentará os requisitos para a instalação do DmView em ambientes que utilizam o sistema
operacional Linux e Windows.
• Permissões e acessos de usuário;

• Configuração mínima de hardware e softwares requeridos;

• Softwares complementares;

• MongoDB;

• Suporte a ambientes virtuais;

• Banco de dados;

• Java (SUN JDK 1.8.0_121);

• Resolução mínima de vídeo;

• Latência de rede;

• DmView console;

• Certificados;

• Configuração de firewall.

2.1 PERMISSÕES E ACESSOS DE USUÁRIO


Para realizar a instalação do DmView e softwares requieridos/complementares, é necessário um usuário
pertencente ao grupo administrador local (Windows) ou root (Linux) com permissão de escrita em toda a
unidade de disco que serão realizadas as instalações.

No Windows, os instaladores devem ser executados como administrador, clicando com o botão direito e
selecionando a opção “Executar como administrador”.

Para instalações de consoles de DmView no Windows 7 é recomendado desabilitar a opção


de controle de contas do usuário. Para realizar tal tarefa, basta acessar:

“Painel de controle → Contas de Usuário → Alterar configurações de controle de conta do


usuário”.

Habilite a opção: “nunca me notificar” e clique em “OK”.

DATACOM 204.0119.47 – OUTUBRO/2022 13


DmView – Instalação Requisitos de instalação

A tabela abaixo relaciona as ações com as permissões necessárias para o uso do DmView.
Ação Permissão necessária

Instalação do DmView Usuário pertencente ao grupo de administratores local (Windows) ou root


(Linux)

Parar/Iniciar os serviços do DmView Usuário pertencente ao grupo de administratores local (Windows) ou root
(Linux)

Fazer login no DmView Permissão de “Modify” para o grupo “Users” ou para usuários específicos no
diretório "C:\Program Files\DmView" (Windows) ou “/opt/DmView” (Linux) e seus
subdiretórios.

Geração dos logs do DmView Permissão de “Modify” para o grupo “Users” ou para usuários específicos no
diretório "C:\Program Files\DmView" (Windows) ou “/opt/DmView” (Linux) e seus
subdiretórios.

Tabela 1 – Ação x Permissão necessária

2.2 SOFTWARE E HARDWARE REQUERIDOS PELO DMVIEW

2.2.1 HARDWARE
Os requisitos mínimos listados abaixo são válidos para uma instalação de DmView com até 15 equipamentos
gerenciados e 2 usuários simultâneos (Desktop).

• Processador com 4 cores ou mais:


 Intel:
o Intel Core I3 8ª geração ou superior;
o Intel Core I5 7ª geração ou superior;
o Intel Core I7 3ª geração ou superior.
 AMD:
o AMD Ryzen 3 1ª geração ou superior.
• Memória:
 Mínimo requerido: 8 GB RAM.
• HD:
 Espaço disponível:
o Mínimo requerido: 10 GB;
o Mínimo recomendado: 20 GB.

DATACOM 204.0119.47 – OUTUBRO/2022 14


DmView – Instalação Requisitos de instalação

A limitação de usuários simultâneos se refere exclusivamente à interface Desktop (legado). Esse limite não afeta
a quantidade de usuários simultâneos na interface Web (Maestro).
Caso o número de elementos a serem gerenciados ou o número de acessos simultâneos ao software (Desktop)
seja superior, a especificação de hardware deverá ser dimensionada analisando a quantidade e modelos de
equipamentos que serão gerenciados, o número de acessos simultâneos (Desktop) e as condições de
disponibilidade/redundância desejadas. Entre em contato com a Datacom para que seja feita uma análise de
todo o ambiente e uma especificação de hardware para suportá-lo.

2.2.2 SOFTWARES REQUERIDOS


Esta seção contém informações a respeito dos sistemas operacionais em que é possível utilizar o DmView e os
softwares necessários (Banco de Dados Oracle, MongoDB e Java).
Sobre os sistemas operacionais, o DmView é homologado nas seguintes versões:

• Servidor:
 Windows 7 64 bits (Professional, Enterprise e Ultimate);
 Windows 8.1 64 bits (Professional e Enterprise);
 Windows 10 64 bits (Professional e Enterprise);
 Windows 11 64 bits (Professional e Enterprise);
 Windows Server 2008 R2 SP1 64 bits;
 Windows Server 2012 R2 64 bits;
 Windows Server 2016 64 bits;
 Windows Server 2019 64 bits;
 CentOS 6 (a partir da 6.5) 64 bits;
 CentOS 7 (a partir da 7.3) 64 bits;
 Red Hat Enterprise Linux 8 64 bits.

• Console:
 Windows 7 64 bits (Professional, Enterprise e Ultimate);
 Windows 8.1 64 bits (Professional e Enterprise);
 Windows 10 64 bits (Professional e Enterprise);
 Windows 11 64 bits (Professional e Enterprise);
 Windows Server 2008 R2 SP1 64 bits;
 Windows Server 2012 R2 64 bits;
 Windows Server 2016 64 bits;
 Windows Server 2019 64 bits;
 CentOS 6 (a partir da 6.5) 64 bits;*
 CentOS 7 (a partir da 7.3) 64 bits;*
 Red Hat Enterprise Linux 8 64 bits.
*Os softwares Xming e X2GO estão homologados como software de acesso remoto via Windows ao servidor de
console Linux.

DATACOM 204.0119.47 – OUTUBRO/2022 15


DmView – Instalação Requisitos de instalação

• Banco de Dados:
 Windows 7 64 bits (Professional, Enterprise e Ultimate);
 Windows 8.1 64 bits (Professional e Enterprise);
 Windows 10 64 bits (Professional e Enterprise);
 Windows 11 64 bits (Professional e Enterprise);
 Windows Server 2008 R2 SP1 64 bits;
 Windows Server 2012 R2 64 bits;
 Windows Server 2016 64 bits;
 Windows Server 2019 64 bits;
 Oracle Linux Server 7.2 (ou superior) 64 bits (Unbreakable);**
 CentOS 6 (a partir da 6.5) 64 bits;
 CentOS 7 (a partir da 7.3) 64 bits;
 Red Hat Enterprise Linux 8 64 bits.
**Utilizar esta distribuição do Linux apenas quando os bancos de dados forem instalados em servidores
dedicados para esta função

Recomendamos a atualização de todos os patches do Windows, através da ferramenta


Windows Update, antes da instalação dos pré-requistos e do DmView.

Os Softwares adicionais requeridos pelo DmView são os listados abaixo:

• Oracle
• Oracle Standard/Enterprise Edition 11g R2 64 bits (não incluído na instalação do DmView);
• Sistemas operacionais requeridos: Windows e Linux
• Oracle Standard/Enterprise Edition 12c R1 64 bits (não incluído na instalação do DmView)*;
• Sistemas operacionais requeridos: Windows e Linux
• Oracle Standard/Enterprise Edition 18c 64 bits (não incluído na instalação do DmView)*;
• Sistemas operacionais requeridos: Windows e Linux
• Oracle Standard/Enterprise Edition 19c 64 bits (não incluído na instalação do DmView)*;
• Sistemas operacionais requeridos: Windows e Linux
• Oracle Express Edition 11g R2 (XE) 64 bits (não incluído na instalação do DmView).
• Sistemas operacionais requeridos: Windows e Linux
• Oracle Express Edition 18c (XE) 64 bits (não incluído na instalação do DmView)*.
• Sistemas operacionais requeridos: Windows e Linux
• *As versões do Oracle 12c (SE/EE), Oracle 18c (SE/EE/XE) e Oracle 19c (SE/EE) são suportadas somente
no modo não-container.

• Java
• SUN JDK 1.8.0_121 (Java já vem embarcado na instalação do DmView, portanto não é
necessário instalá-lo separadamente).

DATACOM 204.0119.47 – OUTUBRO/2022 16


DmView – Instalação Requisitos de instalação

• MongoDB
• MongoDB 3.2 ou 3.4 (não incluído na instalação do DmView).
• Zabbix
• Zabbix 3.4, 4.0, 4.2, 5.0 ou 5.2 (não obrigatório e não incluído na instalação do DmView).

2.3 BANCO DE DADOS

O DmView tem como pré-requisito a utilização dos bancos de dados Oracle e MongoDB. Serão descritos nos
próximos tópicos, as versões e diferenças destes bancos de dados.

2.3.1 ORACLE 11G/18C EXPRESS EDITION

2.3.1.1 ORACLE 11 XE

O Oracle 11g Express Edition, trata-se da versão gratuita de banco de dados da Oracle, ela pode ser instalada
em Linux ou Windows 64bits. Esta versão possui os seguintes limites:

• Limite de 11gb de banco de dados (datafiles - disco);


• Limite de um processador na máquina (ou seja, se o servidor possui dois processadores um dos
processadores será ignorado pelo banco);
• Máximo de 1GB de memória RAM (mesmo que o servidor tenha mais memória, o excedente será
ignorado).

2.3.1.2 ORACLE 18 XE
O Oracle 18c Express Edition, é a última versão gratuita do Oracle e pode ser instalada em Linux ou Windows 64
bits. Esta versão possui os seguintes limites:

• Limite de 12gb de banco de dados (datafiles - disco);


• Limite de dois processadores na máquina (ou seja, se o servidor possui dois processadores um dos
processadores será ignorado pelo banco);
• Máximo de 2GB de memória RAM (mesmo que o servidor tenha mais memória, o excedente será
ignorado).
• Até três bancos de dados conectáveis.
*A versão do Oracle 18c XE é suportada somente no modo não-container.

2.3.2 ORACLE STANDARD/ENTERPRISE EDITION 11G/12C/18C/19C

O banco de dados Oracle Standard/Enterprise Edition 11g/12c/18c/19c 64 bits é recomendado para um alto
volume de dados, no qual é necessário um alto processamento e memória ou para quando é preciso
redundância e alta disponibilidade do ambiente.

O Oracle Standard Edition é licenciado por processador e não possui limite de memória e disco a ser utilizado.
Com o Oracle Standard Edition é possível criar um RAC (Real Application Cluster) de até duas instâncias para
trabalhar com um storage, criando assim um ambiente redundante e de alta disponibilidade. Outra limitação
da licença do Oracle Standard Edition refere-se ao número de processadores físicos do servidor que deve ser

DATACOM 204.0119.47 – OUTUBRO/2022 17


DmView – Instalação Requisitos de instalação

no máximo de 4 processadores, para servidores com mais de 4 processadores, deve-se adquirir a licença
Enterprise.

Para ambientes com mais de duas instâncias de RAC, é necessária a licença do Oracle Enterprise Edition, que
conta ainda com outras opções como o Dataguard, uma ferramenta de disaster recovery utilizado para fazer
replicação online entre sites diferentes.
*As versões do Oracle 12c (SE/EE), Oracle 18c (SE/EE/XE) e Oracle 19c (SE/EE) são suportadas somente no modo
não-container.

2.3.3 MONGODB
MongoDB é um banco de dados de documentos que fornece alto desempenho, alta disponibilidade, e fácil
escalabilidade.
O MongoDB é um pré-requisito de instalação do DmView, utilizado principalmente pelo DmView Web e estão
homologadas as versões 3.2 ou 3.4 (assim como qualquer versão minoritária dessas versões).

2.4 JAVA (SUN JDK 1.8.0_121)

Um dos pré-requisitos para a instalação do DmView em Windows é a utilização do SUN JDK 1.8.0_121. O
software Java é instalado durante a instalação ao marcar o checkbox JDK 1.8.0_121, portanto não é necessária
a instalação prévia.

Verifique no diretório de instalação, deverá existir uma nova pasta com o nome jdk1.8.0_121.

Figura 1 - JDK 1.8.0_121

DATACOM 204.0119.47 – OUTUBRO/2022 18


DmView – Instalação Requisitos de instalação

Se existir outro java instalado na máquina, este será ignorado pelo DmView que utilizará o Jdk 1.8.0_121.

Durante a instalação do DmView, se o checkbox do JDK 1.8.0_121 for desmarcado, o Java não será instalado e
ao clicar “Next”, a próxima tela da instalação solicitará o preenchimento do caminho do Java que já deve ter
sido instalado previamente na máquina, conforme exibido pelas figuras abaixo.

Figura 2: Desmarcada a instalação do Java

DATACOM 204.0119.47 – OUTUBRO/2022 19


DmView – Instalação Requisitos de instalação

Figura 3: Caminho de instalação do Java

Após a instalação do DmView no Windows, a variável de ambiente “NMS_JAVA_HOME” será criada com o
caminho do Java configurado.

Figura 4: Variável de ambiente do Java no Windows

No Linux o caminho do Java estará configurado no arquivo “/etc/default/nms.default” na variável


“NMS_JAVA_HOME”. Abra o arquivo em um editor de texto para visualizar o conteúdo.

Figura 5: Caminho do Java no Linux

DATACOM 204.0119.47 – OUTUBRO/2022 20


DmView – Instalação Requisitos de instalação

2.4.1 ALTERANDO O CAMINHO DO JAVA APÓS A INSTALAÇÃO DO DMVIEW

2.4.1.1 WINDOWS
Para fazer a alteração do Java utilizado pelo DmView no Windows, pare todos os serviços do DmView utilizando
o atalho “Stop Services” do menu iniciar e altere a variável de ambiente “NMS_JAVA_HOME” no Windows
colocando o caminho do Java desejado.

Figura 6: Alterando o caminho do Java no Windows

Após alterar a variável de ambiente “NMS_JAVA_HOME” no Windows, execute o script changeJavaNMS.bat.


Todos os arquivos de configuração do DmView serão alterados apontando o Java para o novo caminho
configurado na variável de ambiente. Inicie os serviços do DmView utilizando o atalho “Start Services” do menu
iniciar do Windows.

2.4.1.2 LINUX
Para realizar a alteração do Java utilizado pelo DmView no Linux, pare todos os serviços do DmView através do
comando “/etc/init.d/nms.allservices stop”, abra o arquivo “/etc/default/nms.default” em um editor de textos e
altere a variável “NMS_JAVA_HOME” colocando o caminho do Java desejado. Inicie os serviços do DmView
utilizando o comando “/etc/init.d/nms.allservices start”.

Figura 7: Alterando o caminho do Java no Linux

2.5 ZABBIX
O Zabbix é uma ferramenta de monitoramento de redes, servidores e serviços, desenvolvida para monitorar a
disponibilidade, experiência de usuário e qualidade de serviços.

O Zabbix permite monitoramento agentless (sem agentes) para diversos protocolos e conta com funções de
auto-discovery (descoberta automática de itens) e low level discovery (descoberta de métricas em itens
monitorados).

O servidor Zabbix mantém histórico dos dados coletados em banco de dados (Oracle, MySQL e PostgreSQL), de
onde são gerados gráficos, painéis de acompanhamento e slide-shows que mostram informações de forma
alternada.

DATACOM 204.0119.47 – OUTUBRO/2022 21


DmView – Instalação Requisitos de instalação

O DmView pode ser configurado para utilizar o Zabbix para coletar informações dos equipamentos de trafego,
CPU e memória.

2.5.1 INTEGRAÇÃO DMVIEW X ZABBIX

2.5.1.1 ZABBIX 5.0 OU INFERIOR


Para integração entre o DmView e o Zabbix versão 5.0 ou inferior, basta seguir os passos descritos no item
“Configuração Zabbix” do manual Web Maestro User Guide_PT.

2.5.1.2 ZABBIX 5.2


Para integração entre o DmView e o Zabbix versão 5.2 é necessário realizar a importação do template
disponibilizado em nosso portal de suporte, após esta ação, basta seguir os passos descritos no item
“Configuração Zabbix” do manual Web Maestro User Guide_PT.

2.6 SOFTWARES COMPLEMENTARES


Além dos softwares da seção anterior, o DmView requer outros para a correta instalação/utilização. Eles devem
ser instalados antes de iniciar a instalação do DmView:
• Microsoft SNMP Agent (este item se torna opcional caso o serviço utilizado para as traps seja a versão
em java);

• Web Browser;

• Microsoft Terminal Service/Remote Desktop (ferramenta opcional, utilizada para exportar as telas do
servidor do DmView para as máquinas desktop dos operadores do DmView).

• Xming (ferramenta opcional, utilizada para exportar as telas do servidor do DmView com SO Linux para
as máquinas desktop dos operadores do DmView com SO Windows).

• X2GO (ferramenta opcional, utilizada para exportar as telas do servidor do DmView com SO Linux para
as máquinas desktop dos operadores do DmView com SO Windows).

• XManager (ferramenta opcional em que deve ser adquirida licença de uso, utilizada para exportar as
telas do servidor do DmView com SO Linux para as máquinas desktop dos operadores do DmView com
SO Windows).

2.6.1 MICROSOFT SNMP AGENT


O serviço de SNMP do Windows deve estar instalado no servidor antes de iniciar a instalação do DmView, para
tanto, deve-se seguir os seguintes passos:
1.Clicar no botão Iniciar da barra de tarefas e selecionar “Configurações/Painel de Controle”;

2.No Painel de Controle, selecione “Adicionar/Remover Programas”;

3.Em Adicionar/Remover Programas, selecione “Adicionar/Remover Componentes do Windows”;

4.Em Componentes do Windows, selecione Ferramentas de gerenciamento e monitoramento. Clique em


Detalhes e selecione “Simple Network Management Protocol”;

5.Clique no botão “OK”;

DATACOM 204.0119.47 – OUTUBRO/2022 22


DmView – Instalação Requisitos de instalação

6.Quando solicitado, insira o CD de instalação do Windows e clique em OK;

7.O próximo passo basta clicar em “Finalizar” nos “Componentes do Windows”.

2.6.2 WEB BROWSER


O Web browser deve ser instalado, pois é utilizado para acessar o Portal de Relatórios e o DmView Maestro.
Abaixo a relação de Web browsers que podem ser utilizados:
• Google Chrome (A partir da versão 51.0)

• https://www.google.com.br/chrome/browser/desktop/

Ao utilizar uma funcionalidade que possui link com um endereço web, será aberto o browser padrão do sistema
operacional Windows ou Linux. No Linux o comando executado é “xdg-open”.

2.6.3 MICROSOFT TERMINAL SERVICE/REMOTE DESKTOP (OPCIONAL)


O Remote Desktop já vem instalado por default ao instalar o sistema operacional. Nos sistemas operacionais
Windows desktop (Windows 7, 8.1, 10 e 11) é possível apenas um usuário por vez conectar ao computador
remotamente e nos sistemas operacionais Windows Server (Windows Server 2008/2012/2016 e 2019) vem com
uma licença gratuita de 2 usuários simultâneos. Para aumentar o número de acessos simultâneos ao servidor,
no caso do Windows Server 2008/2012/2016 e 2019, é necessário adquirir licenças junto à Microsoft.

2.6.4 CENTOS MINIMAL


Para a instalação do DmView em Linux, é necessário a instalação do pacote CentOS Minimal Desktop. A
instalação deste pacote pode ser realizada selecionando-o durante a instalação do sistema operacional ou
após a instalação do SO, executando os passos a seguir.

1. Install CentOS-7 - Minimal (First entry point in list)

2. yum groupinstall "X Window System"

3. yum install gnome-classic-session gnome-terminal nautilus-open-terminal

control-center liberation-mono-fonts

4. unlink /etc/systemd/system/default.target

5. ln -sf /lib/systemd/system/graphical.target

/etc/systemd/system/default.target

6. reboot

DATACOM 204.0119.47 – OUTUBRO/2022 23


DmView – Instalação Requisitos de instalação

2.7 SUPORTE A AMBIENTES VIRTUAIS


O DmView é suportado para instalação em ambientes virtuais como VmWare e VirtualBox, sendo que deve ser
alocado para esta máquina virtual a configuração de memória, processamento, disco, recomendada pela
DATACOM mediante uma análise prévia que levará em conta o número de elementos a serem gerenciados, os
modelos de equipamentos, quais as opções extras do DmView que serão instaladas/licenciadas, o número de
usuários simultâneos, a disponibilidade/redundância desejada e etc... .

2.8 RESOLUÇÃO MÍNIMA DE VÍDEO


O DmView foi desenvolvido para ser utilizado com a resolução mínima de vídeo de 1280x1024. Caso seja
utilizada uma resolução inferior, por exemplo, 800x600, algumas janelas poderão não ser visualizadas de acordo
com o esperado, podendo existir cortes na janela ou opções que não poderão ser acessadas.

2.9 LATÊNCIA DE REDE


A latência de rede tem um impacto alto na performance do DmView. É recomendado que a latência entre
servidores de console, servidores principais e servidores de banco de dados seja de no máximo 1 ms
(ummilisegundo). A partir disso, o tempo necessário para as operações do DmView começa a aumentar
consideravelmente. Em redes com latência de até 1 ms, a performance do sistema é adequada para a operação
dos usuários.

2.10 DMVIEW CONSOLE


O DmView Console é a forma de instalação que permite ao usuário acessar as funcionalidades Desktop do
DmView, em servidor separado do servidor principal, que executa todos os serviços do DmView (ex.: polling dos
equipamentos, ativações de configuração, realização de backups, etc).

O requisito mínimo de memória por usuário logado ao DmView Console é de 1 GB de memória.

É recomendado que não seja instalado o DmView Console nas estações de trabalho dos usuários. Em geral, em
estações de trabalho é menos comum o atendimento a requisitos de hardware e de rede (latência de até 1 ms
com os servidores principais e de banco de dados). Esse tipo de instalação, em geral, irá prejudicar muito o
desempenho do DmView, degradando o trabalho do usuário e a usabilidade do produto. Esse tipo de instalação
também prejudica situações de atualização de versão do DmView, pois é necessário atualizar cada estação de
trabalho.

É recomendado que seja sempre instalado um ou mais servidores de console centralizados, e que os usuários
acessem o mesmo a partir de suas estações de trabalho através de softwares de conexão remota (ex.: Windows
Remote Desktop, X2Go e XMing).

2.11 CERTIFICADOS
Os certificados auto-assinados usados por padrão pelo DmView são o utilizados pelo DmView Web Portal e
DmView Web.

Estes certificados estão armazenado nos arquivo key.keystore, localizado no diretório "conf" do diretório de
instalação DmView (NMS_HOME/conf).

DATACOM 204.0119.47 – OUTUBRO/2022 24


DmView – Instalação Requisitos de instalação

Não existe funcionalidade para configurar esse arquivo via DmView. No entanto, é possível configurar este
arquivo keystore através de linha de comando em Windows CMD ou Terminal Linux.

Além do certificado usado pelo DmView Web Portal e DmView Web, é possível importar certificados utilizados
nos equipamentos de forma a garantir a segurança na comunicação DmView x Equipamento. Para maiores
informações sobre este recurso, consulte o Manual de Operação no capítulo Management Protocol
Configuration:HTTP/HTTPS.

Também podem ser importados outros certificados confiáveis de autoridades certificadoras.

Abaixo estão as operações que podem ser executadas para ver, remover, gerar e importar certificados.

2.11.1 VISUALIZANDO CERTIFICADOS USADOS PELO DMVIEW


Para listar todos os certificados gravados no arquivo "key.keystore", execute o seguinte comando:

Linux Terminal:

$NMS_HOME/jdk1.8.0_121/bin/keytool -list -keystore %NMS_HOME%/conf/key.keystore

Windows CMD:

"%NMS_HOME%\jdk1.8.0_121\bin\keytool" -list -keystore "%NMS_HOME%\conf\key.keystore"

Depois de rodar este commando, a senha do keystore será solicitada. A senha default para o keystore é
'changeit'.

Segue abaixo um exemplo de saída do comando:

tomcat, 05/10/2015, PrivateKeyEntry,

Certificate fingerprint (SHA1): 88:7F:6C8:C2:05:1A:47:A5:12:9A:A8:9B:5E1:

DC:AB:82:6C:B3

DATACOM 204.0119.47 – OUTUBRO/2022 25


DmView – Instalação Requisitos de instalação

2.11.2 IMPORTANDO UM CERTIFICADO


Para importar um certificado, execute o comando abaixo, trocando o “<ca-alias>” por um nome que você deseja
identificar o certificado e o “<complete/path/to/ca/certificate.crt>” pelo caminho completo do arquivo.

Linux Terminal:

$NMS_HOME/jdk1.8.0_121/bin/keytool -import -trustcacerts -alias <ca-alias> -file


<complete/path/to/ca/certificate.crt> -keystore %NMS_HOME%/conf/key.keystore

Windows CMD:

"%NMS_HOME%\jdk1.8.0_121\bin\keytool" -import -trustcacerts -alias <ca-alias> -file


“<complete\path\to\ca\certificate.crt>” –keystore "%NMS_HOME%\conf\key.keystore"

Você precisa da senha do keystore para importar (o padrão é ‘changeit’).

Recomendamos importar apenas certificados de autoridades certificadoras (CA)


confiáveis. Para a comunicação via protocolo HTTPS funcionar adequadamente, o
certificado instalado no equipamento deve ser assinado por uma autoridade certificadora
cujo certificado deve ser importado no arquivo chaveiro. Também não é recomendado
importar diretamente no arquivo chaveiro o certificado instalado no equipamento, apenas
o da CA que assinou esse certificado.

2.11.3 IMPORTANDO UM CERTIFICADO DIGITAL (.P12) PARA O DMVIEW WEB (MAESTRO)


Ao acessar o DmView Web (Maestro) via https, é exibida uma mensagem de conexão não segura no browser do
usuário. Para resolver este problema, é necessário importar um certificado digital (arquivo .p12) que contém a
chave pública e a chave privada no mesmo arquivo criptografado e protegido por senha.

Comando:

keytool -importkeystore -deststorepass "<password>" -destkeystore "%NMS_HOME%\conf\key.keystore" -


srckeystore “<complete\path\to\ca\certificate.p12>” -srcstoretype PKCS12

Exemplo:

keytool -importkeystore -deststorepass changeit -destkeystore key.keystore -srckeystore


datacom.com.br.p12 -srcstoretype PKCS12

Importante: A senha do arquivo “.p12” utilizado, deve ser a mesma do arquivo “key.kestore”, que por padrão é
“changeit”.

DATACOM 204.0119.47 – OUTUBRO/2022 26


DmView – Instalação Requisitos de instalação

Após a execução do comando, será solicitada a senha do arquivo “.p12” que deve ser a mesma do arquivo
“key.kestore”, entre com a senha e será exibida a mensagem informando que foi importado com sucesso.

Execute o comando abaixo para verificar se o certificado foi importado é listado.

keytool –list –keystore key.keystore

Figura 8: Importando o certificado (.p12) e listando os certificados importados

Caso você não tenha o arquivo “.p12”, pode gera-lo com os arquivos “.crt” (certificado) e “.key” (chave privada),
utilizando o comando a seguir.

Comando:

openssl pkcs12 -export -in datacom.com.br.crt -inkey datacom.com.br-private.key -name *datacom.com.br


-out datacom.com.br.p12

2.11.4 IMPORTANDO UM CERTIFICADO DIGITAL (.P12) PARA O SERVIDOR ACS (NMS ACS)
Para estabelecer uma conexão segura entre CPE e ACS, utilizando https e um certificado válido, deve-se
importar um certificado no servidor ACS e configurar o CPE com o arquivo da CA (autoridade certificadora)
utilizada no certificado.

Para importar o certificado no servidor ACS, utilize os mesmos passos descritos no capítulo IMPORTANDO UM
CERTIFICADO DIGITAL (.P12) PARA O DMVIEW WEB (MAESTRO), pois o serviço NMS ACS busca os certificados
deste mesmo arquivo “key.keystore”.

DATACOM 204.0119.47 – OUTUBRO/2022 27


DmView – Instalação Requisitos de instalação

Após importar o certificado no servidor ACS, é necessário configurar o equipamento CPE importando o arquivo
da autoridade certificadora. Acesse o equipamento através da página de configuração em um browser e
encontre o menu para a importação de certificados. Como exemplo, será utilizada uma ONU Datacom DM985-
424, mas cada CPE pode ter uma forma de configuração diferente. Para mais detalhes, consulte o manual do
equipamento.

Figura 9: Importando o arquivo de CA no CPE

DATACOM 204.0119.47 – OUTUBRO/2022 28


DmView – Instalação Requisitos de instalação

Depois de importar no CPE o arquivo com a autoridade certificadora utilizada no certificado que foi importado
no NMS ACS, deve-se habilitar o uso do certificado na conexão CPE > ACS, para isso, marque o checkbox “Enable
Certificate”. Neste exemplo, está sendo utilizada uma ONU Datacom DM985-424, mas cada CPE pode ter uma
forma de configuração diferente. Para mais detalhes, consulte o manual do equipamento.

Figura 10: Habilitando certificado

DATACOM 204.0119.47 – OUTUBRO/2022 29


DmView – Instalação Requisitos de instalação

Após realizar estas configurações no servidor ACS e no CPE, a comunicação entre CPE > ACS será feita de forma
segura, com https e utilizando o certificado válido. Os informs do CPE devem ser recebidos com sucesso no
servidor ACS e exibidos no DmView Maestro.

Figura 11: Informs recebidos utilizando certificado válido

2.11.5 REMOVENDO CERTIFICADOS UTILIZADOS PELO DMVIEW


Para remover um certificado a partir do arquivo de keystore, é necessário saber o nome (alias) que foi registrado
para o certificado. No exemplo abaixo o certificado tem o nome (alias) “tomcat”.

Linux Terminal:

$NMS_HOME/jdk1.8.0_121/bin/keytool -delete -alias tomcat -keystore %NMS_HOME%/conf/key.keystore

Windows CMD:

"%NMS_HOME%\jdk1.8.0_121\bin\keytool" -delete -alias tomcat -keystore


“%NMS_HOME%\conf\key.keystore"

DATACOM 204.0119.47 – OUTUBRO/2022 30


DmView – Instalação Requisitos de instalação

2.11.6 GERANDO UMA PRIVATE KEY


Para gerar um CSR (Certificate Signing Request), primeiro você precisa criar uma private key no arquivo de
keystore, e então exportar o CSR a partir da key criada.

Para criar uma private key, utilize os comandos a seguir:

Linux Terminal:

$NMS_HOME/jdk1.8.0_121/bin/keytool -genkey -alias <customer-alias> -keyalg RSA -keysize 2048 -keystore


%NMS_HOME%/conf/key.keystore

Windows CMD:

"%NMS_HOME%\jdk1.8.0_121\bin\keytool" -genkey -alias <customer-alias> -keyalg RSA -keysize 2048 -


keystore "%NMS_HOME%\conf\key.keystore"

Um exemplo de <customer-alias> poderia ser algo como 'tomcat-server'. No entanto, qualquer nome fornecido
pelo seu cliente pode ser usado.

Depois de introduzir esta linha de comando, você será solicitado a fornecer alguns dados que serão exibidos no
certificado. As perguntas são sobre Common Name, Organizational Unit, Organization, Locality, State and
Country Code. Finalmente, escolha uma senha para o CSR criado.

A linha de comando anterior deve ter criado a entrada da private key no arquivo key.keystore, usando o nome
fornecido no parâmetro <customer-alias>.

Você pode verificar esta entrada da private key através da mesma linha de comando usado na Seção 1.

2.11.7 GERANDO O CSR (CERTIFICATE SIGNING REQUEST)


Para exportar a CSR da private key criada, execute o comando:

Linux Terminal:

$NMS_HOME/jdk1.8.0_121/bin/keytool -certreq -alias <customer-alias> -file <complete/path/to/file.csr> -


keystore %NMS_HOME%/conf/key.keystore

Windows CMD:

"%NMS_HOME%\jdk1.8.0_121\bin\keytool" -certreq -alias <customer-alias> -file


"<complete\path\to\file.csr>" -keystore "%NMS_HOME%\conf\key.keystore"

Será solicitada a senha da private key.

A saída deste commando é um arquivo com a extensão ".csr".


DATACOM 204.0119.47 – OUTUBRO/2022 31
DmView – Instalação Requisitos de instalação

Após registrar o certificado utilizado pelo DmView Web Portal será necessário reiniciar o
serviço “NMS Apache Tomcat” para o DmView Web Portal exibir o certificado criado em seu
internet browser.

2.11.8 CERTIFICADOS REGISTRADOS ANTES DO UPGRADE PARA A VERSÃO 9.7 (OU SUPERIOR)
A partir da versão 9.7, os certificados mudaram de localização (antes estavam em:
“NMS_HOME\jdk1.8.0_121\jre\lib\security”) passando para os arquivos “cacerts” e “key.keystore” localizados no
diretório “NMS_HOME\conf” (Windows: “C:\Program Files\DmView\conf” ou Linux: “/opt/DmView/conf”). Assim,
se algum certificado foi registrado anteriormente, este deverá ser registrado novamente nestes arquivos.
Consulte os certificados usados no caminho antigo e registre-os no caminho novo.

2.12 DMVIEW LISTENING PORTS


O DmView (servidor de aplicação) recebe e responde requisições nas portas listadas abaixo. Assim, quando os
serviços do DmView são iniciados, estas portas ficarão com o estado listening.

No. Port Number Protocol Protocol Family Purpose

1 162 SNMP Traps UDP SNMP Traps.

2 81 HTTP TCP DmView Web Portal.

3 8443 HTTPS TCP DmView Web Portal.

4 8100 HTTP/WS TCP Covers the NMS Services and


WebSocket.

5 8101 HTTPS/WS TCP Covers the NMS Services and


WebSocket.

6 8082 Provisioning TCP Perform configurations on


devices and automatic circuit
provisioning.

7 61616 JMS TCP ActiveMQ API used by DmView for


exchange messages between the
server/console.

8 7547 TR-069 (CPE WAN Management Protocol) TCP Used for communication between
NMS ACS and CPE via TR-069 over
HTTPS.

9 7546 TR-069 (CPE WAN Management Protocol) TCP Used for communication between
NMS ACS and CPE via TR-069 over
HTTP.

Tabela 2 – Listening ports

DATACOM 204.0119.47 – OUTUBRO/2022 32


DmView – Instalação Requisitos de instalação

2.13 CONFIGURAÇÃO DE FIREWALL

Para o funcionamento do DmView, acesso aos equipamentos, banco de dados, servidores de aplicações e
servidores de terminal, é necessária a liberação de portas do Firewall, veja o exemplo da figura abaixo e as
portas do firewall que devem ser liberadas.

2.13.1 EXEMPLO DE TOPOLOGIA DE SERVIDORES DO AMBIENTE DMVIEW

Figura 12 – Firewall - Topologia de servidores

DATACOM 204.0119.47 – OUTUBRO/2022 33


DmView – Instalação Requisitos de instalação

2.13.2 APPLICATION SERVER > NETWORK DEVICES

Portas a serem abertas no firewall FW3 de acordo com a figura da topologia exemplo.
No. Port Number Protocol Protocol Family Purpose

1 22 SSH TCP Command line access to device.

2 23 Telnet TCP Interactive text-oriented


communication facility.

3 161 SNMP (V1, V2, V3) UDP SNMP access.

4 443 HTTPS (Poller) TCP Monitor, configure and maintain


the management devices.

5 69 TFTP TCP Firmware update.

6 80 HTTP TCP Monitor, configure and maintain


the management devices.

7 5554 Poller (Datacom protocol) TCP Monitor, configure and maintain


the management devices.

8 5555 Poller (Secure Datacom protocol) TCP Monitor, configure and maintain
the management devices.

9 3221 Junos XML protocol TCP Junos XML Management Protocol is


used to request information from
and manage the configuration on
routing, switching, and security
devices running Junos OS.

10 830 NETCONF protocol TCP NETCONF protocol is used to


configure DmOS devices.

11 7547 TR-069 (CPE WAN Management TCP Used for communication between
Protocol) NMS ACS and CPE via TR-069 over
HTTPS.

12 7546 TR-069 (CPE WAN Management TCP Used for communication between
Protocol) NMS ACS and CPE via TR-069 over
HTTP.

13 58000 TR-069 (CPE WAN Management TCP Used for connection requests from
Protocol) NMS ACS to CPE via TR-069 over
HTTP/HTTPS.

Tabela 3 – Firewall - Application Server > Network Devices


DATACOM 204.0119.47 – OUTUBRO/2022 34
DmView – Instalação Requisitos de instalação

2.13.3 NETWORK DEVICES > APPLICATION SERVER

Portas a serem abertas no firewall FW0 de acordo com a figura da topologia exemplo.

No. Port Number Protocol Protocol Family Purpose

1 162 SNMP Traps UDP SNMP Traps.

2 7547 TR-069 (CPE WAN Management Protocol) TCP Used for communication
between NMS ACS and CPE via
TR-069 over HTTPS.

3 7546 TR-069 (CPE WAN Management Protocol) TCP Used for communication
between NMS ACS and CPE via
TR-069 over HTTPS.

Tabela 4 – Firewall - Network Devices > Application Server

2.13.4 APPLICATION SERVER OU APPLICATION CONSOLE > ORACLE DATABASE/MONGO DATABASE

Portas a serem abertas no firewall FW2 de acordo com a figura da topologia exemplo.

No. Port Number Protocol Protocol Family Purpose

1 22 SSH TCP Command line access to system.

2 161 SNMP UDP SNMP access.

3 443 HTTPS TCP Administration Console (web interface).

4 1521 Oracle Database TCP Default Oracle Database connection port.

5 1514 TCP Syslog over SSL TCP Analyzer access to traffic log.

6 4560 DBFW internal protocol TCP Incoming syslog messages from external web
application firewall.

7 4600:4680 DBFW internal protocol TCP Incoming traffic captures from Remote Monitor.

8 5514:5593 Syslog TCP Incoming WAF (F5) violation alerts.

9 27017 Mongo Database TCP Default Mongo Database connection port.

Tabela 5 – Firewall - Application Server > Oracle Database/Mongo Database

DATACOM 204.0119.47 – OUTUBRO/2022 35


DmView – Instalação Requisitos de instalação

2.13.5 APPLICATION CONSOLE > APPLICATION SERVER

Portas a serem abertas no firewall FW0 de acordo com a figura da topologia exemplo.

No. Port Number Protocol Protocol Family Purpose

1 20 FTP TCP DmView Web Portal.

2 22 SSH TCP Troubleshooting directly in network device.

3 23 Telnet TCP Troubleshooting directly in network device.

4 69 TFTP TCP Firmware update.

5 81 HTTP TCP DmView Web Portal.

6 8443 HTTPS TCP DmView Web Portal.

7 8100 HTTP/WS TCP Covers the NMS Services and WebSocket.

8 8101 HTTPS/WS TCP Covers the NMS Services and WebSocket.

9 6002 Provisioning TCP Perform configurations on devices and automatic circuit


provisioning.

10 8082 Provisioning TCP Perform configurations on devices and automatic circuit


provisioning.

11 1099 JMX TCP Monitoring the application memory allocation, threads usage,
input and output operations, CPU consumption and processing
time for requests.

12 5557 JMX TCP Monitoring the application memory allocation, threads usage,
input and output operations, CPU consumption and processing
time for requests.

13 5554 Poller TCP Monitor, configure and maintain the management devices.
(Datacom
protocol)

14 5555 Poller TCP Monitor, configure and maintain the management devices.
(Secure
Datacom
protocol)

15 61616 JMS TCP ActiveMQ API used by DmView for exchange messages between
the server/console.

Tabela 6 – Firewall - Application Console > Application Server

DATACOM 204.0119.47 – OUTUBRO/2022 36


DmView – Instalação Requisitos de instalação

2.13.6 APPLICATION SERVER > APPLICATION CONSOLE

Portas a serem abertas no firewall FW1 de acordo com a figura da topologia exemplo.

No. Port Number Protocol Protocol Family Purpose

1 61616 JMS TCP ActiveMQ API used by DmView for exchange messages between the
server/console.

Tabela 7 – Firewall - Application Server > Application Console

2.13.7 APPLICATION CONSOLE > NETWORK DEVICES

Portas a serem abertas no firewall FW3 de acordo com a figura da topologia exemplo.

No. Port Number Protocol Protocol Family Purpose

1 22 SSH TCP Command line access to device.

2 23 Telnet TCP Interactive text-oriented communication facility.

3 161 SNMP (V1, V2, V3) UDP SNMP access.

4 443 HTTPS (Poller) TCP Monitor, configure and maintain the management
devices.

5 69 TFTP TCP Firmware update.

6 80 HTTP TCP Monitor, configure and maintain the management


devices.

7 3221 Junos XML protocol TCP The Junos XML Management Protocol is used to request
information from and manage the configuration on
routing, switching, and security devices running Junos
OS.

8 830 NETCONF protocol TCP NETCONF protocol is used to configure DmOS devices.

Tabela 8 – Firewall - Application Console > Network Devices

DATACOM 204.0119.47 – OUTUBRO/2022 37


DmView – Instalação Requisitos de instalação

2.13.8 WORKSTATIONS > APPLICATION CONSOLE

Portas a serem abertas no firewall FW1 de acordo com a figura da topologia exemplo.

No. Port Number Protocol Protocol Family Purpose

1 3389 RDP TCP Windows Remote Desktop access.

Tabela 9 - Firewall - Workstations > Application Console

2.13.9 APPLICATION CONSOLE > LDAP SERVER

Portas a serem abertas no firewall FW4 de acordo com a figura da topologia exemplo.

No. Port Number Protocol Protocol Family Purpose

1 389 LDAP TCP e UDP Ldap authentication.

Tabela 10 – Firewall - Application Console > LDAP Server

2.13.10 APPLICATION SERVER > LDAP SERVER

Portas a serem abertas no firewall FW4 de acordo com a figura da topologia exemplo.

No. Port Number Protocol Protocol Family Purpose

1 389 LDAP TCP e UDP Ldap authentication.

Tabela 11 – Firewall - Application Server > LDAP Server

2.13.11 WORKSTATIONS > LDAP SERVER

Portas a serem abertas no firewall FW4 de acordo com a figura da topologia exemplo.

No. Port Number Protocol Protocol Family Purpose

1 389 LDAP TCP e UDP Ldap authentication.

Tabela 12 – Firewall - Workstations > LDAP Server

DATACOM 204.0119.47 – OUTUBRO/2022 38


DmView – Instalação Instalação do Oracle XE

2.13.12 WORKSTATIONS > APPLICATION SERVER (PORTAL WEB/INTERFACE WEB)

Portas a serem abertas no firewall FW0 de acordo com a figura da topologia exemplo.

No. Port Number Protocol Protocol Family Purpose

1 81 HTTP TCP DmView Web Portal.

2 8443 HTTPS TCP DmView Web Portal.

3 8100 HTTP/WS TCP Covers the NMS Services and WebSocket.

4 8101 HTTPS/WS TCP Covers the NMS Services and WebSocket.

Tabela 13 – Firewall - Workstations > Application Server (Portal Web/Interface Web)

3 INSTALAÇÃO DO ORACLE XE
Esta seção descreve os procedimentos para a instalação do Oracle XE em
ambiente Windows, bem como as configurações iniciais que devem ser realizadas no SGBD
para que ele esteja apto a funcionar como servidor de banco de dados para o Sistema de
Gerencia. Caso o usuário queira instalar a versão do Oracle Standard/Enterprise, favor entrar em contato com
o suporte da Datacom.

Antes de iniciar a instalação do Oracle, certifique-se que você está logado com um usuário
local e pertencente ao grupo de administradores locais da máquina ou que não existe
nenhuma restrição de domínio para este usuário.

3.1 INSTALAÇÃO E CONFIGURAÇÃO DO ORACLE 11G XE EM WINDOWS


Execute o instalador do Oracle XE (setup.exe) e aguarde enquanto os
arquivos de instalação são descompactados. A seguir, clique em “Próximo” para iniciar o procedimento.

DATACOM 204.0119.47 – OUTUBRO/2022 39


DmView – Instalação Instalação do Oracle XE

Figura 13 – Oracle XE - Tela inicial de instalação

Leia os termos do contrato de licença. Concordando com os termos de licença, escolha


“Aceito os termos do acordo de licença” e depois clique em “Próximo”.

Figura 14 - Oracle XE - Contrato de licença


DATACOM 204.0119.47 – OUTUBRO/2022 40
DmView – Instalação Instalação do Oracle XE

Mantenha a pasta padrão para instalação do Oracle XE (C:\oraclexe) e clique em


“Próximo” para avançar.

Figura 15 - Oracle XE - Pasta de instalação

Especifique a senha para os usuários administrativos do banco de dados (SYS e


SYSTEM) e clique em “Próximo”. Por padrão, recomendamos a senha “nms” (sem as
aspas).

Figura 16 - Oracle XE - Senha do Sys/System

DATACOM 204.0119.47 – OUTUBRO/2022 41


DmView – Instalação Instalação do Oracle XE

Nesta tela, será apresentado um resumo dos parâmetros de instalação. Clique em


“Instalar” para executar a instalação.

Figura 17 - Oracle XE – Resumo

Aguarde a instalação do banco de dados. No final do processo, os serviços instalados


para o Oracle XE serão iniciados automaticamente. Clique em “Concluir”.

Figura 18 - Oracle XE - Concluir instalação

DATACOM 204.0119.47 – OUTUBRO/2022 42


DmView – Instalação Instalação do Oracle XE

Verifique se no Path do Windows, foi incluído o caminho para o diretório bin do Oracle. Caso não tenha sido
adicionado, adicione: "C:\oraclexe\app\oracle\product\11.2.0\server\bin\".

Figura 19 - Oracle XE - Path do sistema operacional

Verifique se o Oracle está funcionando corretamente, abra um prompt de comando do Windows, digite: “sqlplus
sys/[password] as sysdba” substituindo o [password] pela senha configurada e rode o sql “select status, logins
from v$instance;”. O resultado deve ser STATUS=OPEN e LOGINS=ALLOWED.

Figura 20 - Oracle XE – Status e Logins

DATACOM 204.0119.47 – OUTUBRO/2022 43


DmView – Instalação Instalação do Oracle XE

3.2 INSTALAÇÃO E CONFIGURAÇÃO DO ORACLE 18C XE EM WINDOWS


Execute o instalador do Oracle XE (setup.exe) e aguarde enquanto os
arquivos de instalação são descompactados. A seguir, clique em “Próximo” para iniciar o procedimento.

Figura 21 – Oracle 18c XE - Tela inicial de instalação

Leia os termos do contrato de licença. Concordando com os termos de licença, escolha


“Aceito os termos do acordo de licença” e depois clique em “Próximo”.

Figura 22 – Oracle 18c XE - Contrato de licença

DATACOM 204.0119.47 – OUTUBRO/2022 44


DmView – Instalação Instalação do Oracle XE

Mantenha a pasta padrão para instalação do Oracle 18c XE (C:\app\Administrador\product\18.0.0\) e clique em


“Próximo” para avançar.

Figura 23 - Oracle 18c XE - Pasta de instalação

Especifique a senha para os usuários administrativos do banco de dados (SYS e


SYSTEM) e clique em “Próximo”. Por padrão, recomendamos a senha “nms” (sem as
aspas).

Figura 24 - Oracle 18c XE - Senha do Sys/System

DATACOM 204.0119.47 – OUTUBRO/2022 45


DmView – Instalação Instalação do Oracle XE

Nesta tela, será apresentado um resumo dos parâmetros de instalação. Clique em


“Instalar” para executar a instalação.

Figura 25 – Oracle 18c XE – Resumo

Aguarde a instalação do banco de dados. No final do processo, os serviços instalados


para o Oracle 18c XE serão iniciados automaticamente. Clique em “Concluir”.

Figura 26 – Oracle 18c XE – Instalando

DATACOM 204.0119.47 – OUTUBRO/2022 46


DmView – Instalação Instalação do Oracle XE

Figura 27 – Oracle 18c XE – Concluir instalação

3.2.1 CONFIGURAÇÃO DO ORACLE 18C XE PARA NÃO CONTAINER


Após realizar a instalação padrão do Oracle 18c XE, o banco de dados estará configurado em modo container.
Para utilizarmos o Oracle 18c XE com o DmView, é necessário que o banco seja configurado para não-container.
Assim, o banco de dados deve ser excluído e recriado novamente como não container.

3.2.1.1 EXCLUINDO O BANCO DE DADOS CONTAINER


Abra um prompt de comando do Windows e digite “dbca”.

Figura 28 – Oracle 18c XE – Prompt de comando

DATACOM 204.0119.47 – OUTUBRO/2022 47


DmView – Instalação Instalação do Oracle XE

O assistente de configuração de banco de dados do Oracle será iniciado.

Figura 29 – Oracle 18c XE – Iniciando DBCA

Para configurar o banco de dados como não container, inicialmente o banco configurado como padrão deve
ser excluído. Para isso, selecione a opção “Excluir banco de dados” e clique “Próximo”.

Figura 30 – Oracle 18c XE – Excluir banco de dados

DATACOM 204.0119.47 – OUTUBRO/2022 48


DmView – Instalação Instalação do Oracle XE

Selecione a instância a ser excluída e preencha a senha do usuário “SYS”.

Figura 31 – Oracle 18c XE – Selecionar banco de dados de origem

Mantenha o checkbox “Cancelar Registro no EM” desmarcado e clieque em “Próximo”.

DATACOM 204.0119.47 – OUTUBRO/2022 49


DmView – Instalação Instalação do Oracle XE

Figura 32 – Oracle 18c XE – Selecionar opção de gerenciamento

Será exibido um resumo das alterações que serão realizadas no banco de dados, clique “Finalizar”.

Figura 33 – Oracle 18c XE – Resumo


DATACOM 204.0119.47 – OUTUBRO/2022 50
DmView – Instalação Instalação do Oracle XE

Será exibida uma mensagem para a confirmação da exclusão das instâncias do banco de dados, clique “Sim”
para continuar.

Figura 34 – Oracle 18c XE – Confirmação

Será exibido o andamento da exclusão solicitada.

Figura 35 – Oracle 18c XE – Excluindo instâncias

DATACOM 204.0119.47 – OUTUBRO/2022 51


DmView – Instalação Instalação do Oracle XE

Banco de dados excluído.

Figura 36 – Oracle 18c XE – Banco de dados excluído

3.2.1.2 CRIANDO O BANCO DE DADOS NÃO CONTAINER


Depois do banco de dados container ser excluído, deve ser criado o banco de dados não container, para isso,
abra um prompt de comando do Windows e digite “dbca”.

Figura 37 – Oracle 18c XE – Prompt de comando

DATACOM 204.0119.47 – OUTUBRO/2022 52


DmView – Instalação Instalação do Oracle XE

Para configurar o banco de dados como não container, selecione a opção “Criar um banco de dados” e clique
“Próximo”.

Figura 38 – Oracle 18c XE – Criar um banco de dados

Selecione “Configuração avançada” e clique em “Próximo”.

Figura 39 – Oracle 18c XE – Configuração avançada

DATACOM 204.0119.47 – OUTUBRO/2022 53


DmView – Instalação Instalação do Oracle XE

Mantenha o tipo de banco de dados de uma única instância e clique em “Próximo”.

Figura 40 – Oracle 18c XE – Tipo de banco de dados

Digite o nome do banco de dados global, SID, desmarque o checkbox “Criar como Banco de Dados Contêiner” e
clique em “Próximo”.

Figura 41 – Oracle 18c XE – Identificação de banco de dados

DATACOM 204.0119.47 – OUTUBRO/2022 54


DmView – Instalação Instalação do Oracle XE

Selecione a opção “Usar as opções a seguir para os atributos de armazenamento do banco de dados” e clique
“Próximo”.

Figura 42 – Oracle 18c XE – Opção de armazenamento

Desmarque as opções “Especificar Área de Recuperação Rápida” e “Ativar arquivamento” e clique “Próximo”.

Figura 43 – Oracle 18c XE – Opção de recuperação rápida

DATACOM 204.0119.47 – OUTUBRO/2022 55


DmView – Instalação Instalação do Oracle XE

Dermarque a opção “Criar um novo listener” e mantenha marcado o checkbox do listener.

Figura 44 – Oracle 18c XE – Configuração de rede

Desmarque as opções “Configurar Oracle Database Vault” e “Configurar Oracle Label Security”.

Figura 45 – Oracle 18c XE – Opção de Data Vault


DATACOM 204.0119.47 – OUTUBRO/2022 56
DmView – Instalação Instalação do Oracle XE

Configure a memória para utilizar o máximo permitido pela versão XE, que é de 2048 MB.

Figura 46 – Oracle 18c XE – Opçoes de configuração

Mantenha marcado o checkbox “Configurar EM” e clique em “Próximo”.

Figura 47 – Oracle 18c XE – Opçoes de configuração


DATACOM 204.0119.47 – OUTUBRO/2022 57
DmView – Instalação Instalação do Oracle XE

Preencha a senha para as contas “SYSTEM” , “SYS” e clique em “Próximo”.

Figura 48 – Oracle 18c XE – Credenciais do Usuário

Poderá ser exibida uma mensagem de confirmação caso a senha não esteja de acordo com os padrões
recomendados pela Oracle. Clique “Sim” para continuar.

Figura 49 – Oracle 18c XE – Confirmação de senha

DATACOM 204.0119.47 – OUTUBRO/2022 58


DmView – Instalação Instalação do Oracle XE

Selecione os checkboxes “Criar banco de dados”, “Gerar scripts de criação de banco de dados” e clique em
“Próximo”.

Figura 50 – Oracle 18c XE – Opção de Criação

Será exibido o resumo da instalação, clique “Finalizar” para continuar.

Figura 51 – Oracle 18c XE – Resumo

DATACOM 204.0119.47 – OUTUBRO/2022 59


DmView – Instalação Instalação do Oracle XE

A instalação iniciará.

Figura 52 – Oracle 18c XE – Andamento da instalação

Instalação finalizada com sucesso.

Figura 53 – Oracle 18c XE – Instalação finalizada

DATACOM 204.0119.47 – OUTUBRO/2022 60


DmView – Instalação Instalação do Oracle XE

3.3 UPGRADE DE ORACLE 11G XE PARA ORACLE 18C XE


Não existe upgrade direto da versão 11g XE para a 18c XE, a forma de fazer isso é utilizando a ferramenta de
exportação (expdp) e importação (impdp) dos dados do banco de dados. Para isso, siga os passos abaixo.

3.3.1 EXPORTAÇÃO DOS DADOS DO ORACLE 11G XE


Pare os serviços do DmView utilizando o menu “Programas → DmView → Stop Services” e abra um prompt de
comando do Windows para executar os comandos necessários para a exportação dos dados do banco de dados
Oracle 11g.

1. Crie um diretório no sistema operacional, ex: “C:\dmp”.


2. Faça login no Oracle com o usuário “SYS”:

sqlplus / as sysdba
ou

sqlplus sys/nms as sysdba


3. Crie um diretório no Oracle, apontando para o diretório do sistema operacional criado previamente.

create directory DUMP as ‘C:\dmp’;

4. Execute o comando de exportação dos dados do Oracle 11g XE para um arquivo “.dmp”.

expdp system/nms full=Y EXCLUDE=SCHEMA:\"LIKE \'APEX_%\'\",SCHEMA:\"LIKE \'FLOWS_%\'\"


directory=DUMP dumpfile=DB11G.dmp logfile=expdpDB11G.log

5. Deverá ser criado o arquivo “DB11G.dmp” no diretório criado, ex: “C:\dmp”.

3.3.2 VERIFICAÇÃO DO ARQUIVO DMP


Após realizar a exportação dos dados do Oracle 11g XE, é prudente fazer um teste de importação do arquivo
antes de desinstalar o Oracle 11g XE e instalar o Oracle 18c XE, para isso, siga os passos abaixo.

1. Abra um prompt de comando do Windows e execute o comando:

impdp system/nms remap_schema=NMS:NMS_BKP directory=DUMP


dumpfile=DB11G.dmp schemas=NMS

2. Os dados exportados para o arquivo “DB11G.dmp”, serão importados para o usuário/schema


“NMS_BKP” que será criado no Oracle.
3. Após a importação dos dados, edite o arquivo “dbcredentials.txt” do DmView, utilizado para especificar
o usuário que será utilizado para conectar no banco de dados Oracle, localizado no diretório
“C:\Program Files\DmView\conf\dbcredentials.txt”. Edite o arquivo e preencha-o com o novo usuário
que foi criado para fazer o teste de importação do banco:

db.username=nms_bkp

DATACOM 204.0119.47 – OUTUBRO/2022


db.password=nms 61
DmView – Instalação Instalação do Oracle XE

4. Inicie novamente os serviços do DmView utilizando o menu “Programas → DmView → Start Services”.
5. Faça login no DmView e verifique se os equipamentos, circuitos, usuários, eventos estão como estavam
antes de fazer o backup.
6. Pare novamente os serviços do DmView utilizando o menu “Programas → DmView → Stop Services”.
7. Edite novamente o arquivo “dbcredentials.txt” do DmView, preenchendo-o com o usuário/senha
utilizado anteriormente, ex: db.username=nms e db.password=nms.

3.3.3 DESINSTALAÇÃO DO ORACLE 11G XE E INSTALAÇÃO DO ORACLE 18C XE


Após verificar que o arquivo “.dmp” está funcionando corretamente, o próximo passo para substituir o Oracle
11g XE pelo Oracle 18c XE é desinstalar o Oracle 11g XE.

1. Abra o painel de controle do Windows, selecione o menu “Desinstalar um programa”, selecione na lista
o “Oracle Database 11g Express Edition” e clique “Desinstalar”.
2. Será exibida uma mensagem de confirmação para a remoção da aplicação e todas as funções, clique
em “Sim” para confirmar.
3. O Oracle 11g XE será desinstalado. Ao final da desinstalação, clique em “Concluir”.

Após a desinstalação do Oracle 11g XE, deve ser instalado o Oracle 18c XE, seguindo os passos do capítulo:
Instalação e configuração do Oracle 18c XE em Windows.

3.3.4 IMPORTAÇÃO DOS DADOS DO ORACLE 11G XE NO ORACLE 18C XE


Após instalar o Oracle 18c XE, o próximo passo é importar os dados que estavam no Oracle 11g XE e foram
exportados para o arquivo “.dmp”, para isso, siga os passos abaixo.

1. Faça login no Oracle com o usuário “SYS”:

sqlplus / as sysdba
ou

sqlplus sys/nms as sysdba


2. Crie um diretório no Oracle, apontando para o diretório do sistema operacional criado previamente.

create directory DUMP as ‘C:\dmp’;

3. Execute o comando de importação dos dados do Oracle 11g XE que foram exportados para o arquivo
“.dmp” para serem importados para o Oracle 18c XE.

impdp system/nms full=Y EXCLUDE=SCHEMA:\"LIKE \'APEX_%\'\",SCHEMA:\"LIKE


\'FLOWS_%\'\" directory=DUMP dumpfile=DB11G.dmp logfile=impdpDB11G.log

4. Após a importação dos dados, verifique se o arquivo “dbcredentials.txt” do DmView, utilizado para
especificar o usuário que será utilizado para conectar no banco de dados Oracle e localizado no
diretório “C:\Program Files\DmView\conf\dbcredentials.txt”, está com o username e password corretos.
DATACOM 204.0119.47 – OUTUBRO/2022 62
DmView – Instalação Instalação do Oracle XE

db.username=nms

db.password=nms

5. Inicie novamente os serviços do DmView utilizando o menu “Programas → DmView → Start Services”.
6. Faça login no DmView e verifique se os equipamentos, circuitos, usuários, eventos estão como estavam
quanto o Oracle 11g XE era utilizado.

3.4 EXPORTANDO BACKUP DA BASE DE DADOS DMVIEW

3.4.1 WINDOWS
Pré-requisitos:

 Instalação do 7zip (download em http://www.7-zip.org/);

Para exportar um backup da sua base de dados são necessários dois arquivos localizados no diretório
“bin\scripts\database_scripts” da instalação DmView, o script “doDbBackup-Oracle.bat” e o arquivo
“oracle_dmview_backup.par”.

Abra o arquivo “doDbBackup-Oracle.bat” em um software de edição de texto para editá-lo. Segue abaixo o
conteúdo do arquivo:

DATACOM 204.0119.47 – OUTUBRO/2022 63


DmView – Instalação Instalação do Oracle XE

@echo off
setlocal enableDelayedExpansion

rem ##### Starts the MyDateTime variable. ################################################################


set MyDateTime=

rem ##### Extracts the date in YYYYMMDD_hhmmss format for the VDATETIME variable. ########################
for /f "skip=1" %%x in ('wmic os get localdatetime') do if not defined MyDateTime set MyDateTime=%%x

set VDATE=%MyDateTime:~0,8%
set VTIME=%MyDateTime:~8,6%
set VDATETIME=%VDATE%_%VTIME%

rem #################################### VARIABLES CONFIGURATION #########################################


rem ##### The BACKUPFILE_PATH variable determines the directory where the backup file will be saved. #####
rem ##### The variable LOGFILE_PATH determines the directory where the backup file will be saved. ########
rem ##### Use paths without spaces. ######################################################################
rem ##### Do not put a slash at the end of the path. #####################################################
rem ##### EXAMPLE: C:\temp - DO NOT USE: C:\temp\ ########################################################

set BACKUPFILE_PATH=C:\temp
set LOGFILE_PATH=C:\temp

rem ##### ORACLE EXPORT COMMAND ##########################################################################


exp parfile=oracle_dmview_backup.par file=%BACKUPFILE_PATH%\oracle_dmview_bkp.%VDATETIME%.dmp
log=%LOGFILE_PATH%\export.%VDATETIME%.log consistent=y

rem ##### 7ZIP COMMAND ###################################################################################


IF EXIST "%PROGRAMFILES%\7-zip\7z.exe" (
set program_folder=%PROGRAMFILES%
goto exec
) ELSE (
goto 7zNotPresent
)

:7zNotPresent
IF EXIST "%PROGRAMFILES(X86)%\7-zip\7z.exe" (
set program_folder="%PROGRAMFILES(X86)%"
set program_folder=!program_folder:"=!
echo %program_folder%
GOTO exec
) ELSE (
echo Could not compress logs because could not locate 7-zip
echo at "%PROGRAMFILES%\7-zip\7z.exe"
echo or "%PROGRAMFILES(X86)%\7-zip\7z.exe"
)
goto:eof

:exec
echo %program_folder%
"%program_folder%\7-zip\7z.exe" a -tzip %BACKUPFILE_PATH%\oracle_dmview_bkp.%VDATETIME%.dmp.zip
%BACKUPFILE_PATH%\oracle_dmview_bkp.%VDATETIME%.dmp
echo;
echo Folder compressed succesfully
del %BACKUPFILE_PATH%\oracle_dmview_bkp.%VDATETIME%.dmp
echo unziped dmp file deleted
goto:eof

DATACOM 204.0119.47 – OUTUBRO/2022 64


DmView – Instalação Instalação do Oracle XE

 A variável “BACKUPFILE_PATH” pode ser configurada com o caminho do diretório que se deseja salvar
o arquivo de backup.
 A variável “LOGFILE_PATH” pode ser configurada com o caminho do diretório que se deseja salvar o
arquivo de log do backup. Recomenda-se utilizar o mesmo diretório em que o arquivo de backup será
salvo.

Copie estes arquivos para uma mesma pasta no servidor de banco de dados e execute o arquivo “doDbBackup-
Oracle.bat” para iniciar o processo de backup da database Oracle. Ao final do processo de exportação, o arquivo
dump resultante estará salvo e compactado no diretório “C:\Temp” (padrão) ou no diretório configurado no
“doDbBackup-Oracle.bat” do servidor.

3.4.2 LINUX
Para exportar um backup da sua base de dados são necessários dois arquivos localizados no diretório
bin\scripts\database_scripts da instalação DmView, o script “oracle_dmview_backup.sh” e o “rotorfile.sh”.
Copie estes arquivos para uma mesma pasta no servidor de banco de dados e edite o arquivo
oracle_dmview_backup.sh para configurar os parâmetros conforme a sua instalação. As variáveis a serem
editadas são as seguintes:

• ORACLE_HOME= Deve conter o caminho da instalação do oracle, exemplo:


"/opt/oracle/product/10.2.0/db";
• ORACLE_SID= SID do banco Oracle utilizado, exemplo: "datacom" ou “XE”;
• BACKUP_DIR= Diretório em que o arquivo de backup “dmp” será salvo, exemplo:
"/u02/backup/oracle/dumps";
• BACKUP_LOG= Diretório em que o arquivo de log da exportação será salvo, exemplo:
"/u02/backup/oracle/dumps";
• USER_PASS= Usuário e senha utilizado pelo DmView para realizar a conexão com o banco de
dados, exemplo: "nms/nms";
• RSYNC_IP= IP do servidor que se deseja fazer uma cópia de segurança do backup, exemplo:
"10.13.118.50";
• ROTOR_FILE= Diretório aonde se encontra o arquivo de rotorfile, exemplo:
"/usr/bin/rotorfile.sh";
• DAYS= Número de dias em que os backups serão mantidos, exemplo: "7";

O arquivo “rotorfile.sh” realiza o rotacionamento dos arquivos de backup, deixando somente os arquivos de
backup com o número de dias configurado (parâmetro “DAYS”) com o objetivo de apagar os arquivos mais
antigos e não encher o disco.

DATACOM 204.0119.47 – OUTUBRO/2022 65


DmView – Instalação Instalação do Oracle XE

3.5 IMPORTANDO BACKUP DA BASE DE DADOS


A importação de um backup do DmView deve ser realizada em um usuário/schema novo, que não possua
nenhuma tabela.

Assim, para realizar a importação, deve ser criado um usuário novo com nome “NMS” que é o padrão utilizado
pelo DmView. Se já existe um usuário com nome “NMS” e você deseja importar o banco utilizando este mesmo
usuário, será necessário deletá-lo antes, utilizando o comando exibido abaixo.

Antes de deletar o usuário “NMS” tenha certeza que o arquivo de backup “.dmp” está
íntegro. Como sugestão, crie um outro usuário, faça a importação neste e veja se o
processo foi realizado com sucesso.

Comandos utilizados para deletar o usuário:

C:\sqlplus sys/nms as sysdba

SQL> drop user nms cascade;

Figura 54 - Oracle XE – Drop user nms

Execute o comando abaixo para verificar se o usuário não existe no banco de dados.

SQL> select * from dba_users where username='NMS';

no rows selected

DATACOM 204.0119.47 – OUTUBRO/2022 66


DmView – Instalação Instalação do Oracle XE

Após confirmar que não existe o usuário ‘NMS’, crie-o utilizando os comandos abaixo.

create user NMS


identified by nms
default tablespace TS_NMS_D
temporary tablespace TEMP
profile DEFAULT;

GRANT CONNECT, RESOURCE TO NMS;


GRANT CREATE SESSION to NMS WITH ADMIN OPTION;
GRANT role_dmview_tables TO NMS WITH ADMIN OPTION;
GRANT CREATE USER TO NMS;
GRANT ALTER USER TO NMS;
GRANT DROP USER TO NMS;
GRANT CREATE VIEW TO NMS;
GRANT CREATE TABLE TO NMS;
grant create procedure to NMS;
grant create public synonym to NMS;
grant drop public synonym to NMS;
grant drop user to NMS;
grant unlimited tablespace to NMS;

grant select on SYS.VIEW_DMVIEW_OCCUPATION to NMS;


grant select on SYS.VIEW_SESSION_COUNT to NMS;
grant select on SYS.VIEW_PROCESS_COUNT to NMS;
grant select on SYS.VIEW_DBA_BLOCKERS to NMS;
grant select on SYS.VIEW_ACTIVE_SERVICES to NMS;
grant select on SYS.VIEW_PGA_STAT to NMS;
grant select on SYS.view_shared_server_monitor to NMS;

grant read on directory DATA_PUMP_DIR to NMS;

grant dba to NMS;

DATACOM 204.0119.47 – OUTUBRO/2022 67


DmView – Instalação Instalação do Oracle XE

Figura 55 - Oracle XE – Create user nms

DATACOM 204.0119.47 – OUTUBRO/2022 68


DmView – Instalação Instalação do Oracle XE

Execute o comando abaixo para verificar se o usuário foi criado no banco de dados.

SQL> select username, created from dba_users where


username='NMS';

USERNAME CREATED
------------------------------ ---------
NMS 11-JAN-17

Após a confirmação da criação do usuário, o processo de importação pode ser iniciado.

O processo de importação de um arquivo de dmp é igual tanto para Windows como para Linux, bastando
acessar o local onde está o arquivo “.dmp” no sistema operacional via Windows command prompt ou Linux
Terminal executando o comando de importação abaixo.

• O item file recebe o nome do arquivo dmp a ser importado;


• O item fromuser faz referência ao usuário de conexão do Dmview com a base de dados, que foi
exportado com seus dados;
• O item touser faz referência ao usuário de conexão do Dmview com a base de dados, ao qual
serão importados com seus dados;
• O comando de importação deve ser preenchido conforme abaixo:
o imp system/nms file=oracle_dmview_bkp.<date>.dmp fromuser=nms touser=nms

DATACOM 204.0119.47 – OUTUBRO/2022 69


DmView – Instalação Instalação do Oracle XE

Figura 56 - Oracle XE – Importing backup

DATACOM 204.0119.47 – OUTUBRO/2022 70


DmView – Instalação Instalação do Oracle XE

3.6 EXPORTANDO/IMPORTANDO USUÁRIOS DA BASE DE DADOS


Para realizar a exportação dos usuários, será necessário o arquivo “export_ users.sql” localizado no diretório
“bin\scripts\database_scripts” da instalação DmView. Caso o servidor de banco de dados esteja em uma
máquina diferente, copie estes arquivos para um diretório deste servidor. Utilizando um prompt de comando
ou terminal, navegue até este diretório.

Abra o arquivo “export_ users.sql” em um editor de texto. O conteúdo do arquivo está exibido abaixo.
spool 'C:\Program Files\DmView\bin\scripts\database_scripts\output_users.sql';
set heading off;
SET SERVEROUTPUT ON;
set long 200
set linesize 200
set longchunksize 200
Select 'Create User '||u.username||' identified by values '
||REGEXP_SUBSTR(DBMS_METADATA.get_ddl ('USER',USERNAME), '''[^'']+''')||' Default
tablespace USERS '
||' Temporary tablespace TEMP;'||chr(10)
from dba_users u
where lock_date is null
and
USERNAME not in (
'SYS',
'SYSTEM',
'DBSNMP',
'MDSYS',
'OLAPSYS',
'ORDSYS',
'OUTLN',
'SYSMAN',
'WKSYS',
'WMSYS',
'ANONYMOUS',
'DIP',
'DMSYS',
'EXFSYS',
'MDDATA',
'MDSYS',
'NMS',
'ORDPLUGINS',
'TSMSYS',
'WMSYS',
'XDB');
select 'grant ' || privilege || ' to ' || grantee || ';'
from dba_sys_privs D
where
exists
(select
U.USERNAME
from
NMS.USERS U
where
U.USERNAME = D.GRANTEE);
select 'grant ' || granted_role || ' to ' || grantee || ';'
from dba_role_privs D
where
exists
(select
U.USERNAME
from
NMS.USERS U
where
U.USERNAME = D.GRANTEE);

DATACOM 204.0119.47 – OUTUBRO/2022 71


DmView – Instalação Instalação do Oracle XE

select 'alter user '||username||' identified by values '


||REGEXP_SUBSTR(DBMS_METADATA.get_ddl ('USER',USERNAME), '''[^'']+''')||';'
from dba_users
where lock_date is null
and USERNAME not in (
'SYS',
'SYSTEM',
'DBSNMP',
'MDSYS',
'OLAPSYS',
'ORDSYS',
'OUTLN',
'SYSMAN',
'WKSYS',
'WMSYS',
'ANONYMOUS',
'DIP',
'DMSYS',
'EXFSYS',
'MDDATA',
'MDSYS',
'NMS',
'ORDPLUGINS',
'TSMSYS',
'WMSYS',
'XDB');
select 'exit;' from dual;
spool off;
exit;

A primeira linha do arquivo: “spool 'C:\Program Files\DmView\bin\scripts\database_scripts\output_users.sql';”,


indica o caminho onde o arquivo resultante da execução do script será salvo. Edite com o caminho desejado.

Execute o Export Users:

• sqlplus system/nms @export_users.sql


Será gerado um arquivo output_users.sql no mesmo diretório configurado. Para importar os usuários, basta
copiar o arquivo output_users.sql para a máquina backup e rodar o comando abaixo:

• sqlplus system/nms @output_users.sql


Os usuários já existentes serão atualizados e os usuários não existentes serão criados.

OBS: Durante a execução do script podem ocorrer alguns erros devido a já existir o usuário. Neste caso o usuário
não será recriado, somente a sua senha será atualizada.

DATACOM 204.0119.47 – OUTUBRO/2022 72


DmView – Instalação Instalação do Oracle XE

3.7 UTILIZANDO O RMAN PARA REALIZAR BACKUP DO ORACLE


RMAN (Recovery Manager) é uma ferramenta de backup e recover de banco de dados, criada e fornecida pela
Oracle; a mesma oferece opções de backup, restauração e recuperação. Esta ferramenta é recomendada pela
Oracle como seu método preferencial de backup e recuperação.

3.7.1 WINDOWS
Após realizar a instalação do DmView, acesse o diretório “C:\Program
Files\DmView\bin\scripts\database_scripts\RMAN\Script_Backup_Rman_Windows”. Neste diretório estão
presentes os arquivos necessários para configurar o backup do Oracle através do RMAN.

Devem existir os seguintes arquivos:

• backup_rman.bat;
• backup_rman.txt;
• read_me.txt;

O arquivo read_me.txt descreve os passos para realizar as pré-configurações necessárias para conseguir utilizar
a script de backup do RMAN. Estes passos serão descritos a seguir:

1- Acesse o servidor que tem o Oracle instalado, copie e cole a pasta “Script_Backup_Rman_Windows“ que
contém os arquivos backup_rman.bat e backup_rman.txt dentro do diretório “C:\app\Administrator”;
2- Crie os diretórios “backup” e “rman” para existir o caminho “C:\app\Administrator\backup\rman”;
3- Faça login no Oracle como sysdba e habilite o modo de Archivelog:

sqlplus / as sysdba
SQL> shutdown immediate
SQL> startup mount
SQL> alter database archivelog;
SQL> alter database open;
SQL> quit

4- Acesse o RMAN e configurar as opções abaixo:

rman target /
RMAN>SHOW ALL;
RMAN>CONFIGURE CONTROLFILE AUTOBACKUP ON;
RMAN>CONFIGURE RETENTION POLICY TO RECOVERY WINDOW OF 1
DAYS;
RMAN>quit

5- Abra um prompt de comando do Windows e execute o backup_rman.bat que está no diretório


“C:\app\Administrator\Script_Backup_Rman_Windows”.

DATACOM 204.0119.47 – OUTUBRO/2022 73


DmView – Instalação Instalação do Oracle XE

Figura 57 - Oracle XE – backup com RMAN

6- Os arquivos de backup serão criados no diretório “C:\app\Administrator\backup\rman”.

Figura 58 - Oracle XE – arquivos gerados pelo RMAN

7- Este script pode ser agendado no Windows através do Agendador de Tarefas para ser executado
automaticamente em um horário configurado.

DATACOM 204.0119.47 – OUTUBRO/2022 74


DmView – Instalação Instalação do Oracle XE

3.7.2 LINUX
Após realizar a instalação do DmView, acesse o diretório
“/opt/DmView/bin/scripts/database_scripts/RMAN/Script_Backup_Rman_Linux”. Neste diretório estão
presentes os arquivos necessários para configurar o backup do Oracle através do RMAN.

Devem existir os seguintes arquivos:

• bkp_full_rman.sh;
• read_me.txt;

O arquivo read_me.txt descreve os passos para realizar as pré-configurações necessárias para conseguir utilizar
a script de backup do RMAN. Estes passos serão descritos a seguir:

1- Acesse o servidor que tem o Oracle instalado e copie e cole a pasta “Script_Backup_Rman_Linux“ que
contém os arquivos backup_rman.bat e backup_rman.txt dentro do diretório “/u01/app/oracle”;
2- Crie os diretórios “/u02/backup/oracle/rman/” e “/u02/backup/oracle/logs/”;
3- Faça login no Oracle como sysdba e habilite o modo de Archivelog:

sqlplus / as sysdba
SQL> shutdown immediate
SQL> startup mount
SQL> alter database archivelog;
SQL> alter database open;
SQL> quit

4- Acesse o RMAN e configurar as opções abaixo:

rman target /
RMAN>SHOW ALL;
RMAN>CONFIGURE CONTROLFILE AUTOBACKUP ON;
RMAN>CONFIGURE RETENTION POLICY TO RECOVERY WINDOW OF 1
DAYS;
RMAN>quit

5- Execute o bkp_full_rman.sh que está no diretório “/u01/app/oracle Script_Backup_Rman_Linux”.


6- O log do script será gravado no arquivo datacom_bkp_rman_full.log dentro do diretório
“/u02/backup/oracle/logs”.

DATACOM 204.0119.47 – OUTUBRO/2022 75


DmView – Instalação Instalação do Oracle XE

Figura 59 - Oracle XE – log de execução do RMAN

7- Os arquivos de backup serão criados no diretório “/u02/backup/oracle/rman”.

Figura 60 - Oracle XE – arquivos gerados pelo RMAN

Este script pode ser agendado no Linux através da Cron do sistema operacional para ser executado
automaticamente em um horário configurado.

DATACOM 204.0119.47 – OUTUBRO/2022 76


DmView – Instalação Instalação do Oracle XE

3.8 UTILIZANDO O RMAN PARA REALIZAR O RESTORE DO ORACLE


Caso seja necessário fazer um restore do banco de dados Oracle, certifique-se que de estar utilizando os
arquivos com a data certa, evitando assim a perda de dados.

Com posse dos arquivos gerados pelo script de backup do RMAN, acesse o servidor de banco de dados e execute
os comandos abaixo.

1- Faça login no Oracle como sysdba;

sqlplus / as sysdba

2- Faça shutdown no banco e execute os demais comandos abaixo;

shutdown immediate;

startup nomount;

restore controlfile from 'C:\app\Administrator\backup\rman\XE_CONTROLBKP.CTL';

alter database mount;

catalog start with ‘C:\app\Administrator\backup\rman\' noprompt;

crosscheck backup;

crosscheck archivelog all;

restore database;

catalog start with 'C:\oraclexe\app\oracle\fast_recovery_area\XE\ARCHIVELOG' noprompt;

recover database;

O caminho do diretório que contém os arquivos gerados pelo script de backup do RMAN
deve ser ajustado antes de executar os comandos de restore.

DATACOM 204.0119.47 – OUTUBRO/2022 77


DmView – Instalação Instalação do Mongo Database

4 INSTALAÇÃO DO MONGO DATABASE


Este capítulo guia os passos para instalação do MongoDB. Recomenda-se que este programa seja instalado no
mesmo servidor onde se encontra o banco de dados Oracle e que o sistema possua pelo menos 3 GB livres em
disco. As versões 3.2 e 3.4 do MongoDB são homologadas para utilização com o DmView.

4.1 INSTALAÇÃO DO MONGODB EM WINDOWS


Executando o instalador do MongoDB disponibilizado, será exibida a tela de “Welcome”, clique em “Next”.

Figura 61 - MongoDB - Tela inicial de instalação

A seguir o “MongoDB License Agreement” é exibido, clique no checkbox para aceitar e clique em “Next”.

Figura 62 - MongoDB - Contrato de licença

DATACOM 204.0119.47 – OUTUBRO/2022 78


DmView – Instalação Instalação do Mongo Database

Clique em “Complete”, para selecionar a instalação completa do MongoDB.

Figura 63 - MongoDB - Tipo de instalação

Para instalar em uma partição diferente de “C:\” o usuário dele escolher a opção “Custom”.

Clique em “Install” para iniciar o processo de instalação.

Figura 64 - MongoDB - Iniciar instalação

DATACOM 204.0119.47 – OUTUBRO/2022 79


DmView – Instalação Instalação do Mongo Database

Figura 65 - MongoDB - Instalando o MongoDB

Ao fim do processo de instalação, a mensagem de que a instalação foi concluída com sucesso é exibida. Clique
em “Finish” para finalizar o processo de instalação do MongoDB.

Figura 66 - MongoDB - Instalação realizada com sucesso

DATACOM 204.0119.47 – OUTUBRO/2022 80


DmView – Instalação Instalação do Mongo Database

4.2 INSTALAÇÃO DO MONGODB EM LINUX


Esta instalação é realizada através de um arquivo zip que contém todo o conteúdo para configuração do
MongoDB. Siga os seguintes passos:
1. A partir do terminal (console), copie o arquivo zip para o diretório “/opt” e extraia o conteúdo do
arquivo:
• cp mongodb-linux-x86_64-rhel70-3.4.13.tgz /opt
• tar -zxvf mongodb-linux-x86_64-rhel70-3.4.13.tgz

2. Renomeie a pasta extraída e defina permissão de execução na pasta:


• mv mongodb-linux-x86_64-rhel70-3.4.13 mongodb
• chmod –R 777 mongodb

Neste exemplo o diretório de instalação ficou com o path: /opt/mongodb

3. Garanta que os arquivos binários da pasta bin estão presentes na variável de ambiente PATH. Para
manter a variável sempre atualizada, adicione a linha abaixo no arquivo de sistema “/etc/bashrc”:
• export PATH=<mongodb-install-directory>/bin:$PATH
• Exemplo: export PATH=/opt/mongodb/bin:$PATH
4. Crie links simbólicos para garantir o acesso ao MongoDB por todos os usuários do sistema operacional:
• ln -s <mongodb-install-directory>/bin/* /usr/bin
• Exemplo: ln -s /opt/mongodb/bin/* /usr/bin
5. Antes de iniciar o MongoDB pela primeira vez, crie um diretório para ser utilizado para escrita pelo
processo MongoDB. Por default, o diretório utilizado pelo processo é o /data/db.
• mkdir -p /data/db
6. Garanta que o usuário que está efetuando a configuração do MongoDB tem as permissões de leitura e
escrita no diretório.
7. Verifique o processo de inicialização do MongoDB executando o comando:
• mongod

4.3 BACKUP DO MONGO DATABASE


Para fazer um backup do mongo, pode ser gerado um arquivo dump. Para isso inicie o mongod server.
Assumindo que seu mongod server está rodando no localhost e a porta seja 27017, abra prompt de comando e
acesse o diretório bin de onde o mongo está instalado, como por exemplo: “C:\Program
Files\MongoDB\Server\3.2\bin”, e digite o comando mongodump.

>mongodump

Se o MongoDB estiver rodando com a autenticação ativada, o comando mongodump deve ser executado com
os parâmetros ‘username’, ‘password’ e ‘authenticationDatabase’, como no exemplo abaixo.

>mongodump.exe --username nms --password nms --authenticationDatabase nms

DATACOM 204.0119.47 – OUTUBRO/2022 81


DmView – Instalação Instalação do Mongo Database

O comando irá conectar ao servidor que está rodando na máquina localhost através da porta 27017 e guardará
o backup do servidor no diretório “/bin/dump/”. O resultado do comando é mostrado abaixo.

Figura 67 - MongoDB - Output do comando 'mongodump'

Este comando fará o backup apenas do banco de dados específico da pasta selecionada. Porem há uma lista
de opções disponíveis que podem ser usadas com o comando mongodump.

Syntax Description Example

mongodump --host Este comando irá fazer o


backup de todas as databases mongodump --host localhost --port
<HOST_NAME> --port
de uma instância específica do 27017
<PORT_NUMBER> mongod.

Este comando irá fazer o


mongodump --dbpath <DB_PATH> backup de todas as databases
mongodump --dbpath /data/db/ --out
localizadas em um diretório
--out <BACKUP_DIRECTORY> /data/backup/
específico do mongod, e salvar
o resultado em outro diretório.

Este comando fará o backup


mongodump --collection COLLECTION --db apenas de uma collection
mongodump --collection mycol --db test
DB_NAME específica e de uma database
específica.
Tabela 14 - MongoDB - Parâmetros do comando 'mongodump'

DATACOM 204.0119.47 – OUTUBRO/2022 82


DmView – Instalação Instalação do Mongo Database

Para recuperar este backup de dados, deve ser usado o comando mongorestore. Este comando recuperará
todos os dados do backup salvo no diretório bin.

1) Primeiro execute o comando para excluir a base existente:

>mongo localhost/nms --eval db.dropDatabase()

Se o MongoDB estiver rodando com a autenticação ativada, o comando para excluir a base existente deve ser
executado com os parâmetros ‘username’, ‘password’ e ‘authenticationDatabase’, como no exemplo abaixo.

>mongo localhost/nms --u nms --p nms --authenticationDatabase nms --eval db.dropDatabase()

2) Depois execute o comando para restaurar o banco:

>mongorestore

Se o MongoDB estiver rodando com a autenticação ativada, o comando mongorestore deve ser executado com
os parâmetros ‘username’, ‘password’ e ‘authenticationDatabase’, como no exemplo abaixo.

>mongorestore.exe --username nms --password nms --authenticationDatabase nms

E o resultado no prompt será:

Figura 68 - MongoDB - Output do comando 'mongorestore'

DATACOM 204.0119.47 – OUTUBRO/2022 83


DmView – Instalação Instalação do DmView

5 INSTALAÇÃO DO DMVIEW

5.1 INSTALAÇÃO DO DMVIEW EM WINDOWS

5.1.1 PRÉ-REQUISITOS
• Instalação do Oracle XE;
• Instalação do MongoDB;

5.1.2 TIPOS DE INSTALAÇÃO


O software será disponibilizado através de um link para download pela Datacom. Para iniciar o processo de
instalação, basta dar um duplo clique sobre o arquivo de instalação.

Figura 69 - Arquivo de Instalação

O arquivo de instalação tem o nome composto pelo código do produto “010.0001.99” a versão “DmView-
Enterprise-11.1.0-0”, o sistema operacional suportado pelo instalador “linux” e o build ou data de criação deste
instalador “20211218122842”.

Depois de ler o termo de licenciamento, deve-se especificar o path onde o software de gerência será instalado.
Após, serão disponibilizados os tipos de instalação, Enterprise Server, Enterprise Console e Database Server.
Cada tipo de instalação será explanado a seguir.

A escolha desta opção deve ser baseada na função que a máquina onde está sendo instalado o DmView
executará, Servidor, Console da Aplicação, Poller Server, Servidor Web ou somente Database Server.

Figura 70 - Seleção do tipo de instalação


DATACOM 204.0119.47 – OUTUBRO/2022 84
DmView – Instalação Instalação do DmView

• Enterprise Server: Modo servidor, permite a instalação da console de administração, todos os serviços
necessários para o funcionamento do DmView, portal de relatórios web e criação do banco de dados.
• Enterprise Console: Console de administração do DmView. Esta opção é utilizada quando existe um
servidor e deseja-se administrá-lo através de outras máquinas, assim se instala o DmView em modo
console. Nesta opção, não é instalado nenhum serviço no sistema operacional, somente a login.
• Poller Server: Se o usuário já tem o DmView instalado e gostaria de ter mais uma instância instalada em
outra máquina, selecionar esta opção.
• Web Server: Portal de relatórios do DmView, deve ser selecionado caso se deseje instalá-lo. Pode ser
instalado posteriormente em outro servidor.
• Database Server: Deve ser selecionado para configurar/criar/atualizar o banco de dados que será
utilizado pelo DmView. O Oracle deve ter sido previamente instalado. Pode ser instalado
posteriormente em outro servidor.

5.1.3 ENTERPRISE SERVER


Essa seção explicará todas as opções do instalador ao selecionar o “Install Type” como “Enterprise Server”.

5.1.3.1 PATH DE INSTALAÇÃO PADRÃO


O diretório de instalação padrão do DmView para Windows é “C:\Program Files\DmView” e para Linux é
“/opt/DmView”, caso desejado, o diretório de instalação deve ser modificado neste passo da instalação.

Figura 71 - Path de instalação

Caso o diretório de instalação seja modificado, para um futuro Upgrade de versão, ele
deverá ser informado corretamente para que o instalador identifique a versão instalada.

DATACOM 204.0119.47 – OUTUBRO/2022 85


DmView – Instalação Instalação do DmView

5.1.3.2 MODULES
Depois de selecionar o install type Enterprise Server e clicar “Next”, as opções da figura abaixo serão exibidas.
Clique “Next” para instalar todas as opções. Se você deseja instalar o banco em outro servidor, desmarque a
opção “Database Server” agora e instale depois no outro servidor que terá o banco de dados somente com a
opção de “Database Server”.

Figura 72 - Configuração dos pacotes a serem instalados

5.1.3.3 REQUIREMENTS
No passo requirements serão realizadas as verificações de pré-requisitos de hardware e software. Estes pré-
requisitos podem ser consultados no capítulo Software e Hardware requeridos pelo DmView.

Figura 73 – Verificação de requisitos mínimos


DATACOM 204.0119.47 – OUTUBRO/2022 86
DmView – Instalação Instalação do DmView

O tipicon de cada um dos itens descreve quais os requisitos necessários para continuar a instalação.

Figura 74 – Tipicon

Cada item será verificado e deve ter um dos símbolos exibidos na tabela abaixo para informar ao usuário se o
requisito foi atendido.

Símbolo Significado
Requisito mínimo atendido com sucesso.
Requisito mínimo atendido com restrição.
Requisito mínimo não atendido.
Tabela 15 – Símbolos na verificação de requisitos

O botão “Next” do instalador só ficará disponível quando todos os requisitos forem atendidos.

5.1.3.4 ESPECIFICANDO NMS_JAVA_HOME


Esta etapa é para especificar o local de instalação do Java para o uso do DmView. Por padrão, o caminho
especificado é o da versão java incluída dentro do DmView, mas caso o usuário deseje utilizar outra versão
instalada em um diretório diferente é necessário alterar o caminho da variável NMS_JAVA_HOME (lembrando
que o DmView necessita da versão java “jdk1.8.0_121”). Com o diretório selecionado, clique em “Next”.

Figura 75 - Especificando NMS_JAVA_HOME

DATACOM 204.0119.47 – OUTUBRO/2022 87


DmView – Instalação Instalação do DmView

5.1.3.5 DATABASE SELECTION


Nesta etapa é apresentada a possibilidade de se criar o banco de dados do MongoDB e Oracle Database iniciais.
Lembrando que ambos os bancos de dados já devem ter sido instalados previamente à instalação do DmView.

Figura 76 - Selecionando o banco de dados

5.1.3.6 CONFIGURING ORACLE


O banco de dados Oracle, deve ser instalado antes de iniciar a instalação do DmView, pois neste passo serão
realizadas as verificações de disponibilidade, Status e Version. Será exibida a mensagem “Verifying” ao lado do
campo “Availability”.

Figura 77 - Verifying

Campos de preenchimento:

 Port: Porta aonde o Oracle foi configurado para subir, por padrão é a porta 1521;
 SID: Oracle SID, no Oracle Express Edition (XE) o padrão é “XE”, para Oracle Standard/Enterprise deve
ser preenchido com o SID que foi configurado durante a instalação do Oracle;
 SYS Password: Senha do usuário SYS do Oracle, configurado durante a instalação do Oracle;

Campos de verificação:

 Availability: Disponibilidade do Oracle na porta digitada no campo “Port”;


 Status: Status do Oracle;
 Version: Versão instalada do Oracle.

DATACOM 204.0119.47 – OUTUBRO/2022 88


DmView – Instalação Instalação do DmView

O tipicon de cada um dos itens descreve o significado e os resultados esperados das verificações.

Figura 78 – Tipicon

Cada item será verificado e deve ter um dos símbolos exibidos na tabela abaixo para informar ao usuário se o
requisito foi atendido.

Símbolo Significado
Requisito mínimo atendido com sucesso.
Requisito mínimo atendido com restrição.
Requisito mínimo não atendido.
Tabela 16 – Símbolos na verificação de requisitos

O botão “Next” do instalador só ficará disponível quando todos os requisitos forem atendidos.

5.1.3.6.1 Oracle não instalado


Quando o Oracle não está instalado, ao final da verificação será exibida a mensagem “No Oracle installation
found” e o botão “Install Oracle” será exibido.

Figura 79 – No Oracle installation found

Clique no botão “Install Oracle” e selecione o instalador do Oracle para instalar. Siga os passos da seção
Instalação do Oracle XE para realizar a instalação.

Antes de iniciar a instalação do Oracle, certifique-se que você está logado com um usuário
local e pertencente ao grupo de administradores locais da máquina ou que não existe
nenhuma restrição de domínio para este usuário.

DATACOM 204.0119.47 – OUTUBRO/2022 89


DmView – Instalação Instalação do DmView

5.1.3.6.2 Verificação do Oracle - Mensagens de erro, possíveis causas e possíveis ações


A tabela abaixo lista as mensagens de erro possíveis em cada verificação, as possíveis causas e possíveis ações
para resolver o problema. Caso o problema persista, entre em contato com o suporte técnico.

Campo Mensagem de erro Possíveis causas Possíveis ações


No Oracle installation found. Oracle não está instalado. Instale o Oracle.
Oracle not available, but Porta errada. Verifique a porta que o Oracle está
possible installation found. iniciando através do comando "lsnrctl
Please verify Port or contact status" e configure o campo com a porta
Availability
technical support. correta.
Serviços do Oracle parados. Inicie os serviços.
Firewall bloqueando a Desative o firewall.
porta.
Error connecting. Please verify Listener do Oracle iniciou Verifique se o SID do banco já está com o
SID and SYS Password. há pouco tempo e o SID status "READY" através do comando
configurado ainda não está "lsnrctl status".
disponível.
SID errado. Configure o SID corretamente.
SYS password errado. Configure o password corretamente.
Tente logar no Oracle usando o comando
"sqlplus sys/[password] as sysdba" para
verificar se a senha está correta e se o
usuário está logando.
Banco fechado (shutdown), Reinicie os serviços do Oracle. Caso não
deve estar OPEN. resolva o problema, entre em contato
Status com o suporte.
NOMOUNT. Database must be Banco em estado Reinicie os serviços do Oracle. Caso não
open and allowing login NOMOUNT, deve estar resolva o problema, entre em contato
attempts. Please contact OPEN. com o suporte.
technical support.
MOUNTED. Database must be Banco em estado MOUNT, Reinicie os serviços do Oracle. Caso não
open and allowing login deve estar OPEN. resolva o problema, entre em contato
attempts. Please contact com o suporte.
technical support.
RESTRICTED. Database must be Logins restritos Reinicie os serviços do Oracle. Caso não
open and allowing login (RESTRICTED) ao Oracle, resolva o problema, entre em contato
attempts. Please contact devem ser permitidos com o suporte.
technical support. (ALLOWED).
Oracle Database 10g Express Versão do Oracle instalada Instale uma das versões do Oracle
Version Edition (10.2.0.1.0) - not não é homologada. homologadas.
homologated version.
Tabela 17 – Verificação do Oracle - Mensagens de erro, possíveis causas e possíveis ações

DATACOM 204.0119.47 – OUTUBRO/2022 90


DmView – Instalação Instalação do DmView

5.1.3.7 DATABASE OPERATION


A janela de configuração de “Database Parameters” será exibida durante a instalação se o módulo “Database
Server” foi selecionado (ver a seção Modules). Através da configuração dos “Database Parameters”, é possível
criar as tablespaces e o schema do DmView no Oracle (Setup and Create), criar somente o schema do DmView
no Oracle (Create) ou fazer a atualização de um schema de versão antiga do DmView no Oracle (Update). As
opções “Create”, “Setup and Create” e “Update” só podem ser executadas quando o instalador está rodando no
próprio servidor (localhost) que está instalado o Oracle.

Figura 80 - Configuração do banco de dados

Create: Cria ou sobrescreve, se já tiver sido criado anteriormente, um schema do DmView no Oracle instalado
na máquina local e importa um banco vazio (sem dados). É necessário que o Oracle já tenha sido instalado
previamente e criadas as tablespaces de sistema e do DmView, ou seja, se o “Setup and Create” já foi rodado
anteriormente, o “Create” poderá ser rodado. Deve ser executado localmente no servidor que possui o Oracle
instalado.

Setup and Create: Cria as tablespaces de sistema do Oracle e do DmView, configura os parâmetros de sistema,
cria o schema do DmView e importa um banco vazio (sem dados) do DmView. Deve ser executado localmente
no servidor que possui o Oracle instalado.

Update: Atualiza o schema do DmView no Oracle instalado na máquina local para a versão que está sendo
instalada. É necessário que o Oracle já tenha sido instalado previamente e já tenham sido criadas as
tablespaces de sistema e do DmView, ou seja, se o “Setup and Create” já foi rodado anteriormente. Deve ser
executado localmente no servidor que possui o Oracle instalado.

DATACOM 204.0119.47 – OUTUBRO/2022 91


DmView – Instalação Instalação do DmView

Após selecionar uma das opções (Create, Setup and Create ou Update) e clicar “Next”, será realizada uma
verificação no Oracle pelo instalador do DmView para saber se a opção selecionada possui os pré-requisitos
para rodar e se não irá sobreescrever os dados já existentes. Será exibida uma mensagem para o usuário
informando o problema encontrado. Abaixo está um exemplo de quando o usuário seleciona a opção “Create”
ou “Update”, mas não possui as tablespaces padrão necessárias para o DmView, ou seja, o usuário deveria
selecionar a opção “Setup and Create”.

Figura 81 – Tablespaces não foram criadas

5.1.3.8 ORACLE DATABASE PARAMETERS


Tela para a configuração que será utilizada para fazer a conexão e/ou criação do banco de dados.

Figura 82 - Configuração do banco de dados

DATACOM 204.0119.47 – OUTUBRO/2022 92


DmView – Instalação Instalação do DmView

Database URL: Deve ser preenchido com a string de conexão do banco de dados Oracle. Em caso de “Create”,
“Setup and Create” ou “Update” deve ser sempre localhost, pois só podem ser executadas localmente. Se o
Oracle é “XE” (Express Edition), a string deverá ser “jdbc:oracle:thin:@localhost:1521:XE”, se o Oracle for Standard
ou Enterprise, a string deverá ser "jdbc:oracle:thin:@localhost:1521:datacom" se o Oracle SID for “datacom”.

Schema: Nome do usuário que se deseja criar/atualizar o schema no banco de dados.

Database password: Senha que será atribuída ao usuário do schema do banco de dados na criação do banco
ou que já é utilizada pelo DmView para a conexão com o banco de dados, em caso de Update da base.

Retype password: Repetir a senha para confirmá-la.

As opções de criação e atualização do banco de dados devem ser rodadas localmente no


servidor que possui o banco de dados instalado.

Quando o target escolhido no passo “Database Operation” foi Update, será exibido um botão para realizar o
teste de conexão com o banco de dados Oracle, com as credenciais preenchidas.

Figura 83 – Test Oracle connection

DATACOM 204.0119.47 – OUTUBRO/2022 93


DmView – Instalação Instalação do DmView

Se a opção selecionada no passo “Database Operation” foi “Setup and Create”, será necessário indicar o
diretório utilizado para salvar os tablespaces do Oracle. O caminho preenchido automaticamente pelo
instalador é o diretório padrão da instalação do Oracle 11g XE(“C:\oraclexe\app\oracle\oradata\xe”), conforme
figura 84.

Figura 84 – Tablespace folder Oracle 11g XE

Caso seja utilizado o Oracle 18c XE o diretório padrão deve ser alterado para
“C:\app\"usuário_de_instalação"\product\18.0.0\oradata\XE”, conforme a figura 84.1. Este caminho pode ser
alterado via botão Browser ou inserindo o caminho absoluto manualmente.

Figura 84.1 – Tablespace folder Oracle 18c XE

DATACOM 204.0119.47 – OUTUBRO/2022 94


DmView – Instalação Instalação do DmView

5.1.3.9 MONGO DATABASE PARAMETERS


O banco de dados MongoDB, deve ser instalado antes de iniciar a instalação do DmView, pois neste passo serão
realizadas as verificações da instalação. Será exibida a mensagem “Verifying” ao lado do campo “Installation”.

Figura 85 – Verifying

O item “Installation” será verificado e deve ter um dos símbolos exibidos na tabela abaixo para informar ao
usuário se o requisito foi atendido.

Símbolo Significado
Requisito mínimo atendido com sucesso.
Requisito mínimo não atendido.
Tabela 18 – Símbolos na verificação de requisitos

O tipicon exibe as versões de MongoDB homologadas.

5.1.3.9.1 Verificação do MongoDB - Mensagens de erro, possíveis causas e possíveis ações


A tabela abaixo lista as mensagens de erro possíveis da verificação “Installation”do MongoDB, as possíveis
causas e possíveis ações para resolver o problema. Caso o problema persista, entre em contato com o suporte
técnico.

Campo Mensagem de erro Possíveis causas Ação


No MongoDB installed. MongoDB não está instalado. Instale o MongoDB.
Please install it from the
same folder of NMS
installer.
MongoDB not available, Pastas "data\log" e "data\db" Crie as pastas e clique no botão
but possible installation não existem. Windows = "Refresh" do instalador.
found. Please contact "C:\data\log" e "C:\data\db".
technical support. Linux = "/data/log" e
"/data/db".
Pastas "data\log" e "data\db" Verifique e ajuste as permissões
Installation não possuem permissão de das pastas.
escrita para o usuário que
está rodando o instalador.
Problema na inicialização do Acesse via prompt ou terminal o
Mongo. diretório de instalação do
MongoDB (ex: "C:\Program
Files\MongoDB\Server\3.4\bin") e
digite "mongod". Verifique qual é o
problema indicado e corrija-o.
Entre em contato com o suporte
caso necessário.

DATACOM 204.0119.47 – OUTUBRO/2022 95


DmView – Instalação Instalação do DmView

Porta errada. Verifique a porta que o MongoDB


está iniciando acessando via
prompt ou terminal o diretório de
instalação do MongoDB (ex:
"C:\Program
Files\MongoDB\Server\3.4\bin") e
digite "mongod" ou "mongo".
Confira se a porta digitada no
instalador está correta.
Database Folder errado. Verifique se o database folder
selecionado está correto.
MongoDB já está rodando Pare o MongoDB que está rodando
com o modo de autenticação com autenticação e suba
Could not create user.
habilitado. novamente sem autenticação.
Please be sure that
DmView já estava instalado Volte o instalador até o passo
mongod is running with
anteriormente e foi “Database Operation” e selecione
authentication disabled.
selecionada a opção “Create” “Update” ao invés de “Create”.
ao invés de “Update”.
Tabela 19 – Verificação do MongoDB - Mensagens de erro, possíveis causas e possíveis ações

5.1.3.9.2 Create/update MongoDB Database


CREATE:

Quando o target escolhido no passo “Database Operation” foi Create ou SetupAndCreate, será criado um novo
banco de dados do DmView no MongoDB e será apresentada a tela abaixo.

Figura 86 - Configuração do MongoDB

DATACOM 204.0119.47 – OUTUBRO/2022 96


DmView – Instalação Instalação do DmView

Mongo Database Folder: Diretório onde o Mongo Database foi/será instalado. Por padrão, este campo já vem
previamente preenchido com o diretório default da versão 3.4, porém se a instalação foi realizada em outro
diretório este campo deve ser alterado (Seleciona-se sempre o caminho completo até o diretório bin da
instalação do MongoDB).

Port: Porta padrão 27017 utilizada pelo MongoDB, se a porta foi modificada, este campo deve ser atualizado. A
porta também pode ser alterada pelo usuário após a instalação do DmView no arquivo de configuração
“mongo.conf”, localizado na pasta “conf”.

Schema: Usuário que será configurado no banco MongoDB para a criação dos dados do DmView. Por padrão
vem preenchido com o valor “nms”.

Database Password: Senha do usuário que será configurado no banco MongoDB para a criação dos dados do
DmView. Por padrão vem preenchido com o valor “nms”.

Retype Password: Confirmação da senha do usuário do banco MongoDB configurado.

Create User: A partir da versão 10.2, o MongoDB passou a ser configurado pelo instalador do DmView com a
autenticação ativada, aumentando a segurança do banco de dados. Assim, é necessário clicar no botão para
criar o usuário e senha no MongoDB que será utilizado pelo DmView para realizar a conexão.

UPDATE:

Quando o target escolhido no passo “Database Operation” foi Update, o upgrade do DmView é de uma versão
inferior a 10.2.0-0 para uma versão igual ou superior a 10.2.0-0 e o MongoDB estava rodando sem autenticação
habilitada, serão exibidos os botões “Set User Roles” e “Test Connection”. O botão “Set User Roles” irá
configurar as permissões necessárias para o usuário e o botão “Test Connection” irá realizar o teste de conexão
com o banco de dados MongoDB, com as credenciais preenchidas.

Quando o upgrade do DmView é de uma versão inferior a 10.2.0-0 para uma versão igual ou superior a 10.2.0-0
e o Mongo já estiver com autenticação habilitada, o usuário deve parar o MongoDB com autenticação e iniciar
novamente sem autenticação. Assim, serão exibidos os botões “Set User Roles” e “Test Connection”.

Quando o upgrade do DmView é de uma versão igual ou superior a 10.2.0-0 para uma versão superior a 10.2.0-
0, o Mongo já vai estar com autenticação habilitada, logo, só será exibido o botão “Test Connection”.

DATACOM 204.0119.47 – OUTUBRO/2022 97


DmView – Instalação Instalação do DmView

Figura 87 - Configuração do MongoDB - Update

Figura 88 - Configuração do MongoDB - Update

DATACOM 204.0119.47 – OUTUBRO/2022 98


DmView – Instalação Instalação do DmView

5.1.3.10 START SERVICES


Durante a instalação é possível configurar para iniciar os serviços do DmView manualmente ou
automaticamente quando a máquina for reiniciada, selecione a opção desejada e clique “Next” para continuar.

Figura 89 – Start Services

Os bancos de dados (Oracle e MongoDB), caso estejam em máquinas diferentes de onde o


DmView está instalado, devem ser iniciados antes de iniciar os serviços do DmView.

5.1.3.11 SETUP SHORTCUTS


Configuração dos atalhos do DmView. Eles podem ser criados para todos os usuários ou somente para o
usuário que está efetuando a instalação.

Figura 90 - Escolha dos atalhos


DATACOM 204.0119.47 – OUTUBRO/2022 99
DmView – Instalação Instalação do DmView

5.1.3.12 SUMMARY
Resumo das opções selecionadas para a instalação.

Figura 91 - Resumo da instalação

5.1.3.13 COPYING, PROCESSING E FINISHING


Exibem o progresso da instalação, detalhando os pacotes e operações que estão sendo feitas durante a
instalação.

Figura 92 - Copiando os arquivos de instalação


DATACOM 204.0119.47 – OUTUBRO/2022 100
DmView – Instalação Instalação do DmView

Figura 93 - Processando as opções selecionadas pelo usuário

Figura 94 - Instalação completa com sucesso

Após a instalação do DmView ser realizada com sucesso, pode-se iniciar os serviços deixando marcada a opção
“Start services”.

Os bancos de dados (Oracle e MongoDB), caso estejam em máquinas diferentes de onde o


DmView está instalado, devem ser iniciados antes de iniciar os serviços do DmView.

DATACOM 204.0119.47 – OUTUBRO/2022 101


DmView – Instalação Instalação do DmView

5.1.4 ENTERPRISE CONSOLE


Console: Instala somente a console de administração. Esta opção é utilizada quando existe um servidor e
deseja-se administrá-lo através de outras máquinas, assim se instala o DmView em modo console. Nesta opção,
o único tipo de banco que pode ser utilizado é o Oracle.

Figura 95 - Selecionando a opção no modo console

5.1.4.1 MODULES
No “Install Type” “Enterprise Console”, todos os módulos a serem instalados são de sistema e obrigatórios.

Figura 96 - Escolha dos pacotes a serem instalados


DATACOM 204.0119.47 – OUTUBRO/2022 102
DmView – Instalação Instalação do DmView

5.1.4.2 REQUIREMENTS
No passo requirements serão realizadas as verificações de pré-requisitos de hardware e software. Estes pré-
requisitos podem ser consultados no capítulo Software e Hardware requeridos pelo DmView.

Figura 97 – Verificação de requisitos mínimos

O tipicon de cada um dos itens descreve quais os requisitos necessários para continuar a instalação.

Figura 98 – Tipicon

Cada item será verificado e deve ter um dos símbolos exibidos na tabela abaixo para informar ao usuário se o
requisito foi atendido.

Símbolo Significado
Requisito mínimo atendido com sucesso.
Requisito mínimo atendido com restrição.
Requisito mínimo não atendido.
Tabela 20 – Símbolos na verificação de requisitos

O botão “Next” do instalador só ficará disponível quando todos os requisitos forem atendidos.

DATACOM 204.0119.47 – OUTUBRO/2022 103


DmView – Instalação Instalação do DmView

5.1.4.3 ESPECIFICANDO NMS_JAVA_HOME


Esta etapa é para especificar o local de instalação do Java para o uso do DmView. Por padrão, o caminho
especificado é o da versão java incluída dentro do DmView, mas caso o usuário deseje utilizar outra versão
instalada em um diretório diferente é necessário alterar o caminho da variável NMS_JAVA_HOME (lembrando
que o DmView necessita da versão java “jdk1.8.0_121”). Com o diretório selecionado, clique em “Next”.

Figura 99 - Especificando NMS_JAVA_HOME

5.1.4.4 SELECT SERVERS


Nesta parte da instalação, devem ser configurados os parâmetros para a conexão da console com o servidor de
aplicação do DmView (Nms Services), servidor de banco de dados (Database URL) e servidor de relatórios web
(Web Server URL).

DATACOM 204.0119.47 – OUTUBRO/2022 104


DmView – Instalação Instalação do DmView

Figura 100 - Configuração do banco de dados, NMS Services, Portal Web e Standalone Services

Database URL: Deve ser preenchido com a string de conexão do banco de dados Oracle utilizado pelo Enterprise
Server.

Schema: Nome do usuário que foi utilizado para criar o schema no banco de dados ao instalar o DmView
Enterprise no servidor.

Database password: Senha que foi utilizada para criar o schema no banco de dados ao instalar o DmView
Enterprise no servidor.

Retype password: Repetir a senha para confirmá-la.

NMS Services: Deve ser configurado com o IP do servidor do DmView que se deseja conectar.

Web Server URL: Deve ser preenchido com o endereço de acesso ao portal de relatórios do DmView. Se o
servidor foi instalado com todas as opções, o IP do Web Server é o mesmo do NMS Services.

DATACOM 204.0119.47 – OUTUBRO/2022 105


DmView – Instalação Instalação do DmView

5.1.4.5 MONGO DATABASE PARAMETERS


Neste passo de instalação é necessário configurar os parâmetros de conexão com o MongoDB.

Figura 101 - Configuração do banco de dados MongoDB

Hostname: O IP do servidor onde o MongoDB foi configurado.

Port: Porta padrão 27017 utilizada pelo MongoDB. Pode ser alterada pelo usuário no arquivo de configuração
“mongo.conf”, localizado na pasta “conf” da instalação DmView.

Schema: O usuário do banco MongoDB configurado no servidor. Por padrão vem preenchido com o valor
“nms”. Pode ser alterada pelo usuário no arquivo de configuração “mongo.conf”, localizado na pasta “conf” da
instalação DmView.

Database Password: A senha do usuário do banco MongoDB configurada no servidor. Por padrão vem
preenchido com o valor “nms”. Pode ser alterada pelo usuário no arquivo de configuração “mongo.conf”,
localizado na pasta “conf” da instalação DmView.

Retype Password: Confirmação da senha do usuário do banco MongoDB configurado.

A partir deste ponto, a instalação apresenta os mesmos passos como no modo de instalação Enterprise Server,
são eles:

• Setup Shortcuts: Configuração dos atalhos do DmView. Eles podem ser criados para todos os usuários
ou somente para o usuário que está efetuando a instalação.
• Summary: Resumo das opções selecionadas para a instalação.

DATACOM 204.0119.47 – OUTUBRO/2022 106


DmView – Instalação Instalação do DmView

• Copying, Processing e Finishing: Exibe o progresso da instalação, detalhando os pacotes, operações


que estão sendo feitas durante a instalação e, ao final, finalizando a instalação.

5.1.5 POLLER SERVER


Poller: O usuário deve selecionar esta opção caso já tenha o DmView instalado e gostaria de ter mais uma
instância configurada em uma máquina diferente. Esta opção é apenas para instalar o serviço Poller. Maiores
detalhes do funcionamento e configuração podem ser consultados no capítulo Configuração do Poller
Distribuído.

Figura 102 - Install Type Poller Server

5.1.5.1 MODULES
No “Install Type” “Poller Server”, todos os módulos a serem instalados são de sistema e obrigatórios.

Figura 103 - Escolha dos pacotes a serem instalados

DATACOM 204.0119.47 – OUTUBRO/2022 107


DmView – Instalação Instalação do DmView

5.1.5.2 REQUIREMENTS
No passo requirements serão realizadas as verificações de pré-requisitos de hardware e software. Estes pré-
requisitos podem ser consultados no capítulo Software e Hardware requeridos pelo DmView.

Figura 104 – Verificação de requisitos mínimos

O tipicon de cada um dos itens descreve quais os requisitos necessários para continuar a instalação.

Figura 105 – Tipicon

Cada item será verificado e deve ter um dos símbolos exibidos na tabela abaixo para informar ao usuário se o
requisito foi atendido.

Símbolo Significado
Requisito mínimo atendido com sucesso.
Requisito mínimo atendido com restrição.
Requisito mínimo não atendido.
Tabela 21 – Símbolos na verificação de requisitos

O botão “Next” do instalador só ficará disponível quando todos os requisitos forem atendidos.

DATACOM 204.0119.47 – OUTUBRO/2022 108


DmView – Instalação Instalação do DmView

5.1.5.3 ESPECIFICANDO NMS_JAVA_HOME


Esta etapa é para especificar o local de instalação do Java para o uso do DmView. Por padrão, o caminho
especificado é o da versão java incluída dentro do DmView, mas caso o usuário deseje utilizar outra versão
instalada em um diretório diferente é necessário alterar o caminho da variável NMS_JAVA_HOME (lembrando
que o DmView necessita da versão java “jdk1.8.0_121”). Com o diretório selecionado, clique em <Next>.

Figura 106 - Especificando NMS_JAVA_HOME

5.1.5.4 SELECT SERVERS


Nesta parte da instalação, devem ser configurados os parâmetros para a conexão da console com o servidor de
aplicação do DmView (Nms Services), servidor de banco de dados (Database URL), servidor de relatórios web
(Web Server URL) e NMS Services.

Figura 107 - Configuração do banco de dados e NMS Services

DATACOM 204.0119.47 – OUTUBRO/2022 109


DmView – Instalação Instalação do DmView

Database URL: Deve ser preenchido com a string de conexão do banco de dados Oracle.

Schema: Nome do usuário que foi utilizado para criar o schema no banco de dados ao instalar o DmView
Enterprise no servidor.

Database password: Senha que foi utilizada para criar o schema no banco de dados ao instalar o DmView
Enterprise no servidor.

Retype password: Repetir a senha para confirmá-la.

NMS Services: Deve ser configurado com o IP do servidor do DmView que se deseja conectar.

5.1.5.5 MONGO DATABASE PARAMETERS


Neste passo de instalação é necessário configurar os parâmetros de conexão com o MongoDB.

Figura 108 - Configuração do banco de dados MongoDB

Hostname: O IP do servidor onde o MongoDB foi configurado.

Port: Porta padrão 27017 utilizada pelo MongoDB. Pode ser alterada pelo usuário no arquivo de configuração
“mongo.conf”, localizado na pasta “conf” da instalação DmView.

Schema: O usuário do banco MongoDB configurado no servidor. Por padrão vem preenchido com o valor
“nms”. Pode ser alterada pelo usuário no arquivo de configuração “mongo.conf”, localizado na pasta “conf” da
instalação DmView.

DATACOM 204.0119.47 – OUTUBRO/2022 110


DmView – Instalação Instalação do DmView

Database Password: A senha do usuário do banco MongoDB configurada no servidor. Por padrão vem
preenchido com o valor “nms”. Pode ser alterada pelo usuário no arquivo de configuração “mongo.conf”,
localizado na pasta “conf” da instalação DmView.

Retype Password: Confirmação da senha do usuário do banco MongoDB configurado.

A partir deste ponto, a instalação apresenta os mesmos passos como no modo de instalação Enterprise Server,
são eles:

• Setup Shortcuts: Configuração dos atalhos do DmView. Eles podem ser criados para todos os usuários
ou somente para o usuário que está efetuando a instalação.
• Summary: Resumo das opções selecionadas para a instalação.
• Copying, Processing e Finishing: Exibe o progresso da instalação, detalhando os pacotes, operações
que estão sendo feitas durante a instalação e, ao final, finalizando a instalação.

5.1.6 WEB SERVER


Esta opção é apenas para instalar a versão Web Server aonde será possível gerar relatórios com informações
dos equipamentos, circuitos, links, usuários, etc. Esta opção destina-se aos clientes que preferiram instalar em
ambientes separados Web Server e Enterprise ou não selecionaram o pacote web no momento da instalação
Enterprise.

Figura 109 - Web Server

DATACOM 204.0119.47 – OUTUBRO/2022 111


DmView – Instalação Instalação do DmView

5.1.6.1 MODULES
No “Install Type” “Web Server”, todos os módulos a serem instalados são de sistema e obrigatórios.

Figura 110 - Escolha dos pacotes a serem instalados

5.1.6.2 REQUIREMENTS
No passo requirements serão realizadas as verificações de pré-requisitos de hardware e software. Estes pré-
requisitos podem ser consultados no capítulo Software e Hardware requeridos pelo DmView.

Figura 111 – Verificação de requisitos mínimos

DATACOM 204.0119.47 – OUTUBRO/2022 112


DmView – Instalação Instalação do DmView

O tipicon de cada um dos itens descreve quais os requisitos necessários para continuar a instalação.

Figura 112 – Tipicon

Cada item será verificado e deve ter um dos símbolos exibidos na tabela abaixo para informar ao usuário se o
requisito foi atendido.

Símbolo Significado
Requisito mínimo atendido com sucesso.
Requisito mínimo atendido com restrição.
Requisito mínimo não atendido.
Tabela 22 – Símbolos na verificação de requisitos

O botão “Next” do instalador só ficará disponível quando todos os requisitos forem atendidos.

5.1.6.3 ESPECIFICANDO NMS_JAVA_HOME


Esta etapa é para especificar o local de instalação do Java para o uso do DmView. Por padrão, o caminho
especificado é o da versão java incluída dentro do DmView, mas caso o usuário deseje utilizar outra versão
instalada em um diretório diferente é necessário alterar o caminho da variável NMS_JAVA_HOME (lembrando
que o DmView necessita da versão java “jdk1.8.0_121”). Com o diretório selecionado, clique em “Next”.

Figura 113 - Especificando NMS_JAVA_HOME

DATACOM 204.0119.47 – OUTUBRO/2022 113


DmView – Instalação Instalação do DmView

5.1.6.4 SELECT SERVERS


Nesta parte da instalação, devem ser configurados os parâmetros para a conexão da console com o servidor de
aplicação do DmView (Nms Services), servidor de banco de dados (Database URL), servidor de relatórios web
(Web Server URL) e Standalone Services.

Figura 114 - Configuração do banco de dados, Application Server e Portal Web

Database URL: Deve ser preenchido com a string de conexão do banco de dados Oracle.

Schema: Nome do usuário que foi utilizado para criar o schema no banco de dados ao instalar o DmView
Enterprise no servidor.

Database password: Senha que foi utilizada para criar o schema no banco de dados ao instalar o DmView
Enterprise no servidor.

Retype password: Repetir a senha para confirmá-la.

NMS Services: Deve ser configurado com o IP do servidor do DmView que se deseja conectar.

DATACOM 204.0119.47 – OUTUBRO/2022 114


DmView – Instalação Instalação do DmView

5.1.6.5 MONGO DATABASE PARAMETERS


Neste passo de instalação é necessário configurar os parâmetros de conexão com o MongoDB.

Figura 115 - Configuração do banco de dados MongoDB

Hostname: O IP do servidor onde o MongoDB foi configurado.

Port: Porta padrão 27017 utilizada pelo MongoDB. Pode ser alterada pelo usuário no arquivo de configuração
“mongo.conf”, localizado na pasta “conf” da instalação DmView.

Schema: O usuário do banco MongoDB configurado no servidor. Por padrão vem preenchido com o valor
“nms”. Pode ser alterada pelo usuário no arquivo de configuração “mongo.conf”, localizado na pasta “conf” da
instalação DmView.

Database Password: A senha do usuário do banco MongoDB configurada no servidor. Por padrão vem
preenchido com o valor “nms”. Pode ser alterada pelo usuário no arquivo de configuração “mongo.conf”,
localizado na pasta “conf” da instalação DmView.

Retype Password: Confirmação da senha do usuário do banco MongoDB configurado.

A partir deste ponto, a instalação apresenta os mesmos passos como no modo de instalação Enterprise Server,
são eles:

• Setup Shortcuts: Configuração dos atalhos do DmView. Eles podem ser criados para todos os usuários
ou somente para o usuário que está efetuando a instalação.
• Summary: Resumo das opções selecionadas para a instalação.
DATACOM 204.0119.47 – OUTUBRO/2022 115
DmView – Instalação Instalação do DmView

• Copying, Processing e Finishing: Exibe o progresso da instalação, detalhando os pacotes, operações


que estão sendo feitas durante a instalação e, ao final, finalizando a instalação.

5.1.7 DATABASE SERVER


Este modo é apenas para configuração do banco de dados do DmView, podendo escolher entre a criação do
banco (Create), criação de tablespaces, usuários de administração e o banco de dados do DmView (Setup and
Create) ou a atualização do banco existente (Update). Nesta opção “Database Server”, o DmView não será
instalado.
Importante salientar que quando já existir um banco e o usuário optar pelo modo “Create” ou “Setup and
Create”, para ter mais um banco em seu sistema, as credenciais do novo banco devem ser diferentes do antigo
para não apagar as informações existentes.

Figura 116 - Database Server

DATACOM 204.0119.47 – OUTUBRO/2022 116


DmView – Instalação Instalação do DmView

5.1.7.1 MODULES
No “Install Type” “Database Server”, todos os módulos a serem instalados são de sistema e obrigatórios.

Figura 117 - Escolha dos pacotes a serem instalados

5.1.7.2 REQUIREMENTS
No passo requirements serão realizadas as verificações de pré-requisitos de hardware e software. Estes pré-
requisitos podem ser consultados no capítulo Software e Hardware requeridos pelo DmView.

Figura 118 – Verificação de requisitos mínimos

DATACOM 204.0119.47 – OUTUBRO/2022 117


DmView – Instalação Instalação do DmView

O tipicon de cada um dos itens descreve quais os requisitos necessários para continuar a instalação.

Figura 119 – Tipicon

Cada item será verificado e deve ter um dos símbolos exibidos na tabela abaixo para informar ao usuário se o
requisito foi atendido.

Símbolo Significado
Requisito mínimo atendido com sucesso.
Requisito mínimo atendido com restrição.
Requisito mínimo não atendido.
Tabela 23 – Símbolos na verificação de requisitos

O botão “Next” do instalador só ficará disponível quando todos os requisitos forem atendidos.

5.1.7.3 ESPECIFICANDO NMS_JAVA_HOME


Esta etapa é para especificar o local de instalação do Java para o uso do DmView. Por padrão, o caminho
especificado é o da versão java incluída dentro do DmView, mas caso o usuário deseje utilizar outra versão
instalada em um diretório diferente é necessário alterar o caminho da variável NMS_JAVA_HOME (lembrando
que o DmView necessita da versão java “jdk1.8.0_121”). Com o diretório selecionado, clique em “Next”.

Figura 120 - Especificando NMS_JAVA_HOME

DATACOM 204.0119.47 – OUTUBRO/2022 118


DmView – Instalação Instalação do DmView

5.1.7.4 DATABASE SELECTION


Nesta etapa é apresentada a possibilidade de se criar o banco de dados do MongoDB e Oracle Database iniciais.
Lembrando que ambos banco de dados já deve ter sido instalados previamente à instalação do DmView.

Figura 121 - Selecionando o banco de dados

5.1.7.5 CONFIGURING ORACLE


O banco de dados Oracle, deve ser instalado antes de iniciar a instalação do DmView, pois neste passo serão
realizadas as verificações de disponibilidade, Status e Version. Será exibida a mensagem “Verifying” ao lado do
campo “Availability”.

Figura 122 - Verifying

Campos de preenchimento:

 Port: Porta aonde o Oracle foi configurado para subir, por padrão é a porta 1521;
 SID: Oracle SID, no Oracle Express Edition (XE) o padrão é “XE”, para Oracle Standard/Enterprise deve
ser preenchido com o SID que foi configurado durante a instalação do Oracle;
 SYS Password: Senha do usuário SYS do Oracle, configurado durante a instalação do Oracle;

Campos de verificação:

 Availability: Disponibilidade do Oracle na porta digitada no campo “Port”;


 Status: Status do Oracle;
 Version: Versão instalada do Oracle.

DATACOM 204.0119.47 – OUTUBRO/2022 119


DmView – Instalação Instalação do DmView

O tipicon de cada um dos itens descreve o significado e os resultados esperados das verificações.

Figura 123 – Tipicon

Cada item será verificado e deve ter um dos símbolos exibidos na tabela abaixo para informar ao usuário se o
requisito foi atendido.

Símbolo Significado
Requisito mínimo atendido com sucesso.
Requisito mínimo atendido com restrição.
Requisito mínimo não atendido.
Tabela 24 – Símbolos na verificação de requisitos

O botão “Next” do instalador só ficará disponível quando todos os requisitos forem atendidos.

5.1.7.5.1 Oracle não instalado


Quando o Oracle não está instalado, ao final da verificação será exibida a mensagem “No Oracle installation
found” e o botão “Install Oracle” será exibido.

Figura 124 – No Oracle installation found

Clique no botão “Install Oracle” e selecione o instalador do Oracle para instalar. Siga os passos da seção
Instalação do Oracle XE para realizar a instalação.

Antes de iniciar a instalação do Oracle, certifique-se que você está logado com um usuário
local e pertencente ao grupo de administradores locais da máquina ou que não existe
nenhuma restrição de domínio para este usuário.

DATACOM 204.0119.47 – OUTUBRO/2022 120


DmView – Instalação Instalação do DmView

5.1.7.5.2 Verificação do Oracle - Mensagens de erro, possíveis causas e possíveis ações


A tabela abaixo lista as mensagens de erro possíveis em cada verificação, as possíveis causas e possíveis ações
para resolver o problema. Caso o problema persista, entre em contato com o suporte técnico.

Campo Mensagem de erro Possíveis causas Possíveis ações


No Oracle installation found. Oracle não está instalado. Instale o Oracle.
Oracle not available, but Porta errada. Verifique a porta que o Oracle está
possible installation found. iniciando através do comando "lsnrctl
Please verify Port or contact status" e configure o campo com a porta
Availability
technical support. correta.
Serviços do Oracle parados. Inicie os serviços.
Firewall bloqueando a Desative o firewall.
porta.
Error connecting. Please verify Listener do Oracle iniciou Verifique se o SID do banco já está com o
SID and SYS Password. há pouco tempo e o SID status "READY" através do comando
configurado ainda não está "lsnrctl status".
disponível.
SID errado. Configure o SID corretamente.
SYS password errado. Configure o password corretamente.
Tente logar no Oracle usando o comando
"sqlplus sys/[password] as sysdba" para
verificar se a senha está correta e se o
usuário está logando.
Banco fechado (shutdown), Reinicie os serviços do Oracle. Caso não
deve estar OPEN. resolva o problema, entre em contato
Status com o suporte.
NOMOUNT. Database must be Banco em estado Reinicie os serviços do Oracle. Caso não
open and allowing login NOMOUNT, deve estar resolva o problema, entre em contato
attempts. Please contact OPEN. com o suporte.
technical support.
MOUNTED. Database must be Banco em estado MOUNT, Reinicie os serviços do Oracle. Caso não
open and allowing login deve estar OPEN. resolva o problema, entre em contato
attempts. Please contact com o suporte.
technical support.
RESTRICTED. Database must be Logins restritos Reinicie os serviços do Oracle. Caso não
open and allowing login (RESTRICTED) ao Oracle, resolva o problema, entre em contato
attempts. Please contact devem ser permitidos com o suporte.
technical support. (ALLOWED).
Oracle Database 10g Express Versão do Oracle instalada Instale uma das versões do Oracle
Version Edition (10.2.0.1.0) - not não é homologada. homologadas.
homologated version.
Tabela 25 – Verificação do Oracle - Mensagens de erro, possíveis causas e possíveis ações

DATACOM 204.0119.47 – OUTUBRO/2022 121


DmView – Instalação Instalação do DmView

5.1.7.6 DATABASE OPERATION


A janela de configuração de “Database Parameters” será exibida durante a instalação se o módulo “Database
Server” foi selecionado (ver a seção Modules). Através da configuração dos “Database Parameters”, é possível
criar as tablespaces e o schema do DmView no Oracle (Setup and Create), criar somente o schema do DmView
no Oracle (Create) ou fazer a atualização de um schema de versão antiga do DmView no Oracle (Update). As
opções “Create”, “Setup and Create” e “Update” só podem ser executadas quando o instalador está rodando no
próprio servidor (localhost) que está instalado o Oracle.

Figura 125 - Configuração do banco de dados

Create: Cria ou sobrescreve, se já tiver sido criado anteriormente, um schema do DmView no Oracle instalado
na máquina local e importa um banco vazio (sem dados). É necessário que o Oracle já tenha sido instalado
previamente e criadas as tablespaces de sistema e do DmView, ou seja, se o “Setup and Create” já foi rodado
anteriormente, o “Create” poderá ser rodado. Deve ser executado localmente no servidor que possui o Oracle
instalado.

Setup and Create: Cria as tablespaces de sistema do Oracle e do DmView, configura os parâmetros de sistema,
cria o schema do DmView e importa um banco vazio (sem dados) do DmView. Deve ser executado localmente
no servidor que possui o Oracle instalado.

Update: Atualiza o schema do DmView no Oracle instalado na máquina local para a versão que está sendo
instalada. É necessário que o Oracle já tenha sido instalado previamente e já tenham sido criadas as
tablespaces de sistema e do DmView, ou seja, se o “Setup and Create” já foi rodado anteriormente. Deve ser
executado localmente no servidor que possui o Oracle instalado.

DATACOM 204.0119.47 – OUTUBRO/2022 122


DmView – Instalação Instalação do DmView

Após selecionar uma das opções (Create, Setup and Create ou Update) e clicar “Next”, será realizada uma
verificação no Oracle pelo instalador do DmView para saber se a opção selecionada possui os pré-requisitos
para rodar e se não irá sobreescrever os dados já existentes. Será exibida uma mensagem para o usuário
informando o problema encontrado. Abaixo está um exemplo de quando o usuário seleciona a opção “Create”
ou “Update”, mas não possui as tablespaces padrão necessárias para o DmView, ou seja, o usuário deveria
selecionar a opção “Setup and Create”.

Figura 126 – Tablespaces não foram criadas

5.1.7.7 ORACLE DATABASE PARAMETERS


Tela para a configuração que será utilizada para fazer a conexão e/ou criação do banco de dados.

Figura 127 - Configuração do banco de dados

Database URL: Deve ser preenchido com a string de conexão do banco de dados Oracle. Em caso de “Create”,
“Setup and Create” ou “Update” deve ser sempre localhost, pois só podem ser executadas localmente. Se o
Oracle é “XE” (Express Edition), a string deverá ser “jdbc:oracle:thin:@localhost:1521:XE”, se o Oracle for Standard
ou Enterprise, a string deverá ser "jdbc:oracle:thin:@localhost:1521:datacom" se o Oracle SID for “datacom”.

DATACOM 204.0119.47 – OUTUBRO/2022 123


DmView – Instalação Instalação do DmView

Schema: Nome do usuário que se deseja criar/atualizar o schema no banco de dados.

Database password: Senha que será atribuída ao usuário do schema do banco de dados na criação do banco
ou que já é utilizada pelo DmView para a conexão com o banco de dados, em caso de Update da base.

Retype password: Repetir a senha para confirmá-la.

As opções de criação e atualização do banco de dados devem ser rodadas localmente no


servidor que possui o banco de dados instalado.

Quando o target escolhido no passo “Database Operation” foi Update, será exibido um botão para realizar o
teste de conexão com o banco de dados Oracle, com as credenciais preenchidas.

Figura 128 – Test Oracle connection

DATACOM 204.0119.47 – OUTUBRO/2022 124


DmView – Instalação Instalação do DmView

Se a opção selecionada no passo “Database Operation” foi “Setup and Create”, será necessário indicar o
diretório utilizado para salvar os tablespaces do Oracle. O caminho preenchido automaticamente pelo
instalador é o diretório padrão da instalação do Oracle 11g XE(“C:\oraclexe\app\oracle\oradata\xe”),
conforme figura 129.

Figura 129 – Tablespace folder Oracle 11g XE

Caso seja utilizado o Oracle 18c XE o diretório padrão deve ser alterado para
“C:\app\"usuário_de_instalação"\product\18.0.0\oradata\XE”, conforme a figura 129.1. Este caminho pode ser
alterado via botão Browser ou inserindo o caminho absoluto manualmente.

Figura 129.1 – Tablespace folder Oracle 18c XE

DATACOM 204.0119.47 – OUTUBRO/2022 125


DmView – Instalação Instalação do DmView

5.1.7.8 MONGO DATABASE PARAMETERS


O banco de dados MongoDB, deve ser instalado antes de iniciar a instalação do DmView, pois neste passo serão
realizadas as verificações da instalação. Será exibida a mensagem “Verifying” ao lado do campo “Installation”.

Figura 129 – Verifying

O item “Installation” será verificado e deve ter um dos símbolos exibidos na tabela abaixo para informar ao
usuário se o requisito foi atendido.

Símbolo Significado
Requisito mínimo atendido com sucesso.
Requisito mínimo não atendido.
Tabela 26 – Símbolos na verificação de requisitos

O tipicon exibe as versões de MongoDB homologadas.

5.1.7.8.1 Verificação do MongoDB - Mensagens de erro, possíveis causas e possíveis ações


A tabela abaixo lista as mensagens de erro possíveis da verificação “Installation”do MongoDB, as possíveis
causas e possíveis ações para resolver o problema. Caso o problema persista, entre em contato com o suporte
técnico.

Campo Mensagem de erro Possíveis causas Ação


No MongoDB installed. MongoDB não está instalado. Instale o MongoDB.
Please install it from the
same folder of NMS
installer.
MongoDB not available, Pastas "data\log" e "data\db" Crie as pastas e clique no botão
but possible installation não existem. Windows = "Refresh" do instalador.
found. Please contact "C:\data\log" e "C:\data\db".
technical support. Linux = "/data/log" e
"/data/db".
Pastas "data\log" e "data\db" Verifique e ajuste as permissões
Installation não possuem permissão de das pastas.
escrita para o usuário que
está rodando o instalador.
Problema na inicialização do Acesse via prompt ou terminal o
Mongo. diretório de instalação do
MongoDB (ex: "C:\Program
Files\MongoDB\Server\3.4\bin") e
digite "mongod". Verifique qual é o
problema indicado e corrija-o.
Entre em contato com o suporte
caso necessário.

DATACOM 204.0119.47 – OUTUBRO/2022 126


DmView – Instalação Instalação do DmView

Porta errada. Verifique a porta que o MongoDB


está iniciando acessando via
prompt ou terminal o diretório de
instalação do MongoDB (ex:
"C:\Program
Files\MongoDB\Server\3.4\bin") e
digite "mongod" ou "mongo".
Confira se a porta digitada no
instalador está correta.
Database Folder errado. Verifique se o database folder
selecionado está correto.
MongoDB já está rodando Pare o MongoDB que está rodando
com o modo de autenticação com autenticação e suba
Could not create user.
habilitado. novamente sem autenticação.
Please be sure that
DmView já estava instalado Volte o instalador até o passo
mongod is running with
anteriormente e foi “Database Operation” e selecione
authentication disabled.
selecionada a opção “Create” “Update” ao invés de “Create”.
ao invés de “Update”.
Tabela 27 – Verificação do MongoDB - Mensagens de erro, possíveis causas e possíveis ações

5.1.7.8.2 Create/update MongoDB Database


CREATE:

Quando o target escolhido no passo “Database Operation” foi Create ou SetupAndCreate, será criado um novo
banco de dados do DmView no MongoDB e será apresentada a tela abaixo.

Figura 130 - Configuração do MongoDB

DATACOM 204.0119.47 – OUTUBRO/2022 127


DmView – Instalação Instalação do DmView

Mongo Database Folder: Diretório onde o Mongo Database foi/será instalado. Por padrão, este campo já vem
previamente preenchido com o diretório default da versão 3.4, porém se a instalação foi realizada em outro
diretório este campo deve ser alterado (Seleciona-se sempre o caminho completo até o diretório bin da
instalação do MongoDB).

Port: Porta padrão 27017 utilizada pelo MongoDB, se a porta foi modificada, este campo deve ser atualizado. A
porta também pode ser alterada pelo usuário após a instalação do DmView no arquivo de configuração
“mongo.conf”, localizado na pasta “conf”.

Schema: Usuário que será configurado no banco MongoDB para a criação dos dados do DmView. Por padrão
vem preenchido com o valor “nms”.

Database Password: Senha do usuário que será configurado no banco MongoDB para a criação dos dados do
DmView. Por padrão vem preenchido com o valor “nms”.

Retype Password: Confirmação da senha do usuário do banco MongoDB configurado.

Create User: A partir da versão 10.2, o MongoDB passou a ser configurado pelo instalador do DmView com a
autenticação ativada, aumentando a segurança do banco de dados. Assim, é necessário clicar no botão para
criar o usuário e senha no MongoDB que será utilizado pelo DmView para realizar a conexão.

UPDATE:

Quando o target escolhido no passo “Database Operation” foi Update, o upgrade do DmView é de uma versão
inferior a 10.2.0-0 para uma versão igual ou superior a 10.2.0-0 e o MongoDB estava rodando sem autenticação
habilitada, serão exibidos os botões “Set User Roles” e “Test Connection”. O botão “Set User Roles” irá
configurar as permissões necessárias para o usuário e o botão “Test Connection” irá realizar o teste de conexão
com o banco de dados MongoDB, com as credenciais preenchidas.

Quando o upgrade do DmView é de uma versão inferior a 10.2.0-0 para uma versão igual ou superior a 10.2.0-0
e o Mongo já estiver com autenticação habilitada, o usuário deve parar o MongoDB com autenticação e iniciar
novamente sem autenticação. Assim, serão exibidos os botões “Set User Roles” e “Test Connection”.

Quando o upgrade do DmView é de uma versão igual ou superior a 10.2.0-0 para uma versão superior a 10.2.0-
0, o Mongo já vai estar com autenticação habilitada, logo, só será exibido o botão “Test Connection”.

DATACOM 204.0119.47 – OUTUBRO/2022 128


DmView – Instalação Instalação do DmView

Figura 131 - Configuração do MongoDB - Update

Figura 132 - Configuração do MongoDB – Update

DATACOM 204.0119.47 – OUTUBRO/2022 129


DmView – Instalação Instalação do DmView

A partir deste ponto, a instalação apresenta os mesmos passos como no modo de instalação Enterprise Server,
são eles:

• Setup Shortcuts: Configuração dos atalhos do DmView. Eles podem ser criados para todos os usuários
ou somente para o usuário que está efetuando a instalação.
• Summary: Resumo das opções selecionadas para a instalação.
• Copying, Processing e Finishing: Exibem o progresso da instalação, detalhando os pacotes, operações
que estão sendo feitas durante a instalação e, ao final, finalizando a instalação.

5.2 INSTALAÇÃO DO DMVIEW EM LINUX


A distribuição do Linux em que o DmView será instalado e atualmente suportada é o CentOS 6.5 ou 7.3.

5.2.1 PRÉ-REQUISITOS
• Instalação do Oracle XE;
• Instalação do MongoDB;
• Para a instalação do DmView, é necessário a instalação do Java 8 (ou superior) para que seja possível a
execução do instalador.

5.2.2 CONFIGURAÇÃO DE OPEN FILES


Para a utilização de algumas funcionalidades do DmView como a Connectivity Monitor, é recomendado
aumentar o número máximo de open files do sistema operacional Linux onde estará instalado o DmView.

Para isso, execute o comando ‘ulimit –a’ para consultar o valor configurado atualmente.

Figura 133 - Configuração de open files default

Para alterar esta configuração, siga os passos abaixo:

1) Edite o arquivo ‘/etc/security/limits.conf’ (sudo vim), adicione as linhas abaixo no final do arquivo e salve
as alterações.

# 'max number of open files' for all users


* soft nofile 131072
* hard nofile 131072

DATACOM 204.0119.47 – OUTUBRO/2022 130


DmView – Instalação Instalação do DmView

2) Deslogue da sessão atual e logue novamente com o usuário ‘root’.


3) Verifique se as alterações foram executadas com sucesso rodando o comando ‘ulimit –a’ novamente.

Figura 134 - Configuração de open files alteradas

5.2.3 INSTALAÇÃO DMVIEW


Copie o arquivo de instalação do DmView (ex: 010.0001.99-DmView-10.1.0-4-linux-20180808130157.jar) para
algum diretório e execute o comando: “Java –jar 010.0001.93-DmView-10.1.0-4-linux-20180808130157.jar –
console” para iniciar a instalação (sem ambiente gráfico), como mostra a figura abaixo:

Figura 135 - Arquivo de instalação do DmView

Se você não estiver utilizando o usuário “root”, utilize o comando “sudo” para ter as
permissões necessárias para a instalação.

Digite “1” para continuar.

Figura 136 - Executando instalador do DmView

DATACOM 204.0119.47 – OUTUBRO/2022 131


DmView – Instalação Instalação do DmView

Será apresentado o contrato de licença do DmView, tecle “Enter” para continuar até o final do contrato.

Figura 137 - Contrato de licença

Digite “1” para aceitar o contrato de licença.

Figura 138 - Contrato de licença

Será apresentado o diretório aonde o DmView será instalado, tecle “Enter” para manter o diretório sugerido ou
digite o caminho do diretório desejado, depois digite “1” para continuar.

Figura 139 - Diretório de instalação do DmView

Será apresentada a primeira opção de tipo de instalação Enterprise Server, digite “Y” para aceitar ou “N” para
passar para próxima opção. Os outros tipos são: Enterprise Console, Web Server e Database Server, digite “1”
para aceitar.

• Enterprise Server: Modo servidor permite a instalação da console de administração, todos os serviços
necessários para o funcionamento do DmView, portal de relatórios web e criação do banco de dados.

DATACOM 204.0119.47 – OUTUBRO/2022 132


DmView – Instalação Instalação do DmView

A escolha desta opção deve ser baseada na função que a máquina onde está sendo instalado o DmView
executará, Servidor, Console da Aplicação, Servidor Web ou somente Database Server.
• Enterprise Console: Trata-se da console do DmView para instalação em uma máquina servidor de
consoles ou no desktop do usuário. Quando a opção Enterprise Server é selecionada, a console é
instalada automaticamente.
• Database Server: Deve ser selecionado para configurar/criar o banco de dados que será utilizado pelo
DmView. O Oracle deve ter sido previamente instalado. Pode ser instalado posteriormente em outro
servidor.
• Web Server: Portal de relatórios do DmView, deve ser selecionado caso se deseje instalá-lo. Pode ser
instalado posteriormente em outro servidor.
• Poller Server: Se o usuário já tem o DmView instalado e gostaria de ter mais uma instância instalada em
outra máquina, ele deve selecionar esta opção.

Figura 140 - Opções de instalação do DmView

Após aceitar o modo Enterprise Server, os módulos JDK, Web Server e Database Server serão disponibilizados
para seleção e instalação. Digite “Y” para cada módulo e digite “1” para continuar.

Figura 141 - Opções de instalação do DmView

DATACOM 204.0119.47 – OUTUBRO/2022 133


DmView – Instalação Instalação do DmView

Será apresentada mensagem para especificação do local onde será configurada a variável de ambiente
“NMS_JAVA_HOME” a ser utilizada pelo DmView. Tecle <Enter> para aceitar o valor default, ou digite o local
onde a instalação Java será utilizada. Digite “1” para continuar.

Figura 142 - Especificando a variável NMS_JAVA_HOME

Será apresentada mensagem para seleção do tipo de banco de dados a ser utilizado. São apresentadas duas
opções, “Oracle” e “MongoDB”. Digite 1 para selecionar cada database a ser configurada.

Figura 143 - Opções de instalação do DmView

Preencha os dados para conexão ao Oracle:

Figura 144 – Configuração do Oracle

• SID: Oracle SID, no Oracle Express Edition (XE) o padrão é “XE”, para Oracle Standard/Enterprise deve
ser preenchido com o SID que foi configurado durante a instalação do Oracle;
• SYS Password: Senha do usuário SYS do Oracle, configurado durante a instalação do Oracle;

DATACOM 204.0119.47 – OUTUBRO/2022 134


DmView – Instalação Instalação do DmView

• Port: Porta aonde o Oracle foi configurado para subir, por padrão é a porta 1521;

Selecione o modo de criação do banco Oracle:

• Create – Se já existem tablespaces criadas, ou seja, já existia anteriormente um banco do DmView neste
servidor Oracle.
• Setup and Create – Está sendo feita uma instalação nova do DmView e neste banco nunca existiu uma
base do DmView. Serão criadas as tablespaces e os datafiles utilizados pelo DmView automaticamente.
• Update – Será feito uma atualização de versão da base do DmView que já existe.

Escolha uma das opções acima, de acordo com a necessidade e digite o número correspondente: “0”, “1” ou
“2”.

Figura 145 - Configuração do banco de dados

Será apresentada a URL de conexão do banco default “jdbc:oracle:thin:@localhost:1521:xe” digite “Enter” para
aceitá-la ou digite a URL de banco desejado. Não se esqueça de digitar a instância do banco corretamente, pois
pode ser xe (quando o Oracle é a versão XE) ou o nome da instância configurada no Oracle (ex: datacom) caso
seja Standard ou Enterprise. OBS: Recomendamos que as opções de database sejam executadas localmente
na máquina que possui o banco de dados Oracle instalado.

Figura 146 – Configuração do banco de dados Oracle

DATACOM 204.0119.47 – OUTUBRO/2022 135


DmView – Instalação Instalação do DmView

Será apresentado o nome do Schema do Oracle default como “nms”, digite “Enter” para aceitar ou digite o
nome do schema desejado para alterá-lo. Digite e repita a senha que será utilizada. Digite “1” para continuar.

Será realizada uma verificação no banco de dados Oracle para saber se a opção selecionada não irá
sobreescrever dados já existentes e irá informar o usuário se for o caso.

Figura 147 – Verificação do Oracle

Caso a opção escolhida for SetupAndCreate, o Tablespace Folder do Oracle XE 11 será exibido como sendo o
valor default, digite “Enter” para aceitar ou digite o caminho correto. Digite “1” para continuar.

O Mongo Database deve ser instalado antes de iniciar a instalação do DmView, pois a janela de configuração do
“Mongo Database Parameters” será exibida durante a instalação se o módulo “Database Server” foi
selecionado. Através da configuração do “Mongo Database Parameters” é possível indicar para o DmView onde
se encontram seus arquivos de configuração.

Figura 148 - Configuração do MongoDB

Hostname: O IP do servidor onde o MongoDB foi configurado (default localhost).

Port: Porta padrão 27017 utilizada pelo MongoDB. Pode ser alterada pelo usuário no arquivo de configuração
mongo.conf, localizado na pasta “conf” da instalação DmView.

Schema: O usuário do banco MongoDB configurado. Por padrão vem preenchido com o valor “nms”. Pode ser
alterada pelo usuário no arquivo de configuração mongo.conf, localizado na pasta “conf” da instalação
DmView.
DATACOM 204.0119.47 – OUTUBRO/2022 136
DmView – Instalação Instalação do DmView

Database Password: A senha do usuário do banco MongoDB configurado. Por padrão vem preenchido com o
valor “nms”. Pode ser alterada pelo usuário no arquivo de configuração mongo.conf, localizado na pasta
“conf” da instalação DmView.

Retype Password: Confirmação da senha do usuário do banco MongoDB configurado.

Digite 1 após finalizar a configuração do Mongo.

Também pode ser configurado durante o processo de instalação o start automático dos serviços quando a
máquina for reiniciada.

Figura 149 – Start services

O processo de instalação iniciará, mostrando o log de cada uma das operações que está sendo realizada.

Figura 150 – Processo de instalação do DmView

DATACOM 204.0119.47 – OUTUBRO/2022 137


DmView – Instalação Instalação do DmView

Ao final da instalação deverá aparecer a mensagem “Installation was successful” indicando que a instalação foi
concluída com sucesso.

Figura 151 - Instalação finalizada com sucesso

Após o final do processo de instalação, os serviços do DmView podem ser iniciados. Para isso, execute o
comando: “/etc/init.d/nms.allservices start”.

Figura 152 - Iniciando os serviços do DmView

Os serviços do DmView serão iniciados:

Figura 153 - Serviços do DmView sendo iniciados

DATACOM 204.0119.47 – OUTUBRO/2022 138


DmView – Instalação Instalação do DmView

Verifique se os serviços foram iniciados com sucesso usando o comando “/etc/init.d/nms.allservices status”.

Figura 154 - DmView services status

Após o início dos serviços do DmView, a login do usuário pode ser aberta através do comando:
"/opt/DmView/bin/startLogin.sh”.

Figura 155 - Abrindo o login do DmView

5.3 LOGANDO NO DMVIEW

5.3.1 WINDOWS
Para abrir a janela Login Window através de Iniciar →Programas →DmView →Enterprise →DmView Login, os
serviços do DmView já devem estar iniciados, conforme capítulo anterior. Para logar-se, basta fornecer um
Username e Password válidos e clicar em Login. Este procedimento fará com que a janela Network Manager seja
aberta, maiores detalhes sobre este tópico serão abordados neste documento.
Quando o DmView é instalado, um usuário administrator com senha administrator é criado. Depois de se logar
pela primeira vez, é recomendada a troca da senha para garantir a segurança no uso da gerência. O usuário
datacom com senha datacom também é criado, recomenda-se trocar a senha.

DATACOM 204.0119.47 – OUTUBRO/2022 139


DmView – Instalação Instalação do DmView

A figura abaixo mostra a janela Login Window depois de ser realizado um login com sucesso:

Figura 156 - Abrindo o login do DmView

Caso ao abrir o login ocorra o erro "O Windows não pode encontrar '\bin\javaw'. Certifique-
se de que o nome foi digitado corretamente e tente novamente.", faça logoff/ login no
Windows e tente novamente.

5.3.2 LINUX
Para fazer login no DmView usando o sistema operacional Linux, execute o arquivo “startLogin.sh”, caso o
DmView esteja instalado em “/opt/DmView”, o comando fica assim:

• /opt/DmView/bin/startLogin.sh

5.4 UPGRADE DE VERSÃO EM WINDOWS E LINUX


O upgrade de versão tem como escopo somente a atualização do DmView de uma versão antiga para uma
versão mais nova. O modo upgrade não suporta instalar uma versão mais antiga que a atual.

Consulte o DmView – Upgrade Guide, este guia descreve como realizar o upgrade passo a passo, os pré-
requisitos necessários, como garantir a segurança dos dados fazendo os backups antes da atualização e o que
fazer em caso de falha da atualização.

5.4.1 ANTES DE REALIZAR A ATUALIZAÇÃO


Antes de realizar a atualização do DmView, é recomendado que seja feito um backup das bases de dados e
arquivos de instalação da versão atual. Para isso, execute os passos dos tópicos: Exportando backup da base
de dados do DmView, Exportando usuários do DmView, Backup do Mongo Database.

Além disso, faça uma cópia do diretório de instalação do DmView (Ex: “C:\Program Files\DmView” ou
“/opt/DmView”).

DATACOM 204.0119.47 – OUTUBRO/2022 140


DmView – Instalação Instalação do DmView

5.4.2 ATUALIZANDO O DMVIEW


Caso o desejado seja fazer um upgrade de versão, o usuário deverá rodar o instalador da mesma forma que
faria a instalação como mostrado anteriormente. Para que tudo funcione corretamente, todos os serviços do
DmView devem estar parados, com exceção do NMS MongoDB. O usuário deve seguir os passos de acordo com
as seções anteriores e escolher a pasta de instalação em que o DmView encontra-se instalado. Se o diretório ou
a unidade de disco usados não foram os padrões, o usuário deve editar o path de instalação passando o
caminho correto.

Ao realizar um upgrade de versão do DmView, os valores customizados nos arquivos de


configuração, como configuração de memória dos serviços (Veja Memória utilizada pelos
serviços), configurações do LDAP, regex customizadas para uso com a funcionalidade de
CLI Template, voltarão para os valores de fábrica. Após a realização do upgrade, será salvo
um arquivo ”.zip” no diretório “C:\Program Files\DmView\backup\” ou
“/opt/DmView/backup” com todos os arquivos de configuração de antes do upgrade.
Verifique os valores que foram configurados anteriormente e refaça as configurações.

Figura 157 - Path de instalação do DmView

DATACOM 204.0119.47 – OUTUBRO/2022 141


DmView – Instalação Instalação do DmView

Neste passo, o instalador reconhecerá o software e a versão instalada e informará ao usuário que uma
atualização será feita, como mostra a figura abaixo:

Figura 158 - Upgrade de versão

Após clicar em next, proceder como nas instalações anteriores, as telas serão as mesmas.

Para o banco de dados, as três opções aparecerão: “Create”, “Setup and Create” e “Update”. Para que os dados
da base não sejam perdidos, o usuário deve escolher a opção “Update“.

Figura 159 - Upgrade de versão – database

DATACOM 204.0119.47 – OUTUBRO/2022 142


DmView – Instalação Instalação e configuração de ferramentas para acesso
remoto ao DmView

Caso o banco de dados esteja instalado em outra máquina, recomendamos que o instalador seja executado
localmente para que seja feita a atualização do banco de dados, ou seja, não seja executado o update da base
utilizando uma “Database URL” de um servidor remoto.

Caso ocorra qualquer problema na atualização, recomendamos que sejam seguidos os passos do tópico
Capturando os logs do DmView com o script generateTroubleshootingLogs e os logs sejam enviados para o
suporte Datacom realizar uma análise.

5.4.3 CERTIFICADOS REGISTRADOS


Se foi realizado um upgrade de uma versão anterior a 9.7.0-0 para uma versão superior ou igual a 9.7.0-0,
consulte a seção Certificados registrados antes do upgrade para a versão 9.7 (ou superior).

6 INSTALAÇÃO E CONFIGURAÇÃO DE FERRAMENTAS PARA ACESSO REMOTO AO


DMVIEW

6.1 WINDOWS (WORKSTATION) X LINUX (DMVIEW)


Abaixo serão apresentadas algumas ferramentas que podem ser utilizadas para a abertura de um login do
DmView, instalado em Linux, em um Windows.

6.1.1 XMING
O Xming é um tipo de software mais conhecido como um display server. É um servidor X que está em circulação
desde 2007, sendo de domínio público (gratuito) e funciona no Windows como um programa standalone, o que
significa que você não precisa de um emulador.

6.1.1.1 PRÉ-REQUISITOS
Para que seja possível a utilização do Xming para a exportação de telas de login do DmView do servidor Linux
para o Windows, é necessário que o pacote de servidor X esteja previamente instalado no Linux.

Durante a instalação do sistema operacional Linux é possível selecionar o pacote Xserver.

6.1.1.2 INSTALAÇÃO NO CLIENTE WINDOWS


Faça o download do instalador ou solicite para o suporte DATACOM (suporte@datacom.com.br).

DATACOM 204.0119.47 – OUTUBRO/2022 143


DmView – Instalação Instalação e configuração de ferramentas para acesso
remoto ao DmView

1- Execute o instalador, será exibida a mensagem de boas vindas do software, clique Next para continuar.

Figura 160 – Xming – Welcome

2- Escolha o diretório de instalação. O Xming necessita de no mínimo 4,7 MB de espaço em disco livre para
ser instalado. Clique Next para continuar.

Figura 161 – Xming – Select Destination Location

DATACOM 204.0119.47 – OUTUBRO/2022 144


DmView – Instalação Instalação e configuração de ferramentas para acesso
remoto ao DmView

3- Componentes a serem instalados. Selecione Full Installation e clique Next para continuar.

Figura 162 – Xming – Select Components

4- Criação de atalho no menu Iniciar do Windows. Clique Next para continuar.

Figura 163 – Xming – Start Menu shortcut

DATACOM 204.0119.47 – OUTUBRO/2022 145


DmView – Instalação Instalação e configuração de ferramentas para acesso
remoto ao DmView

5- Tarefas adicionais. Se você deseja criar atalhos no desktop, selecione as opções e clique Next.

Figura 164 – Xming – Additional tasks

6- Resumo das opções selecionadas. Clique Install para instalar.

Figura 165 – Xming – Ready to Install

DATACOM 204.0119.47 – OUTUBRO/2022 146


DmView – Instalação Instalação e configuração de ferramentas para acesso
remoto ao DmView

7- Instalando Xming.

Figura 166 – Xming – Installing

8- Xming instalado com sucesso. Clique Finish para finalizar a instalação e abrir Xming. Verifique se o

símbolo aparece no canto direito do Windows, ao lado do relógio.

Figura 167 – Xming – Installed

DATACOM 204.0119.47 – OUTUBRO/2022 147


DmView – Instalação Instalação e configuração de ferramentas para acesso
remoto ao DmView

Figura 168 – Xming – Started

6.1.1.3 CONFIGURAÇÃO NO CLIENTE WINDOWS


1- Para configurar um atalho para abrir diretamente a login do DmView que está no Linux, execute o
XLaunch em ”Iniciar →Programas →Xming →XLaunch”.

2- Será exibida a janela abaixo. Selecione Multiple Windows para possibilitar a abertura das várias janelas
do DmView e clique Next.

Figura 169 – Xming – Display settings

DATACOM 204.0119.47 – OUTUBRO/2022 148


DmView – Instalação Instalação e configuração de ferramentas para acesso
remoto ao DmView

3- Selecione Start a program pois será configurado o caminho de execução do login do DmView, clique
Next.

Figura 170 – Xming – Session type

4- Digite o caminho do login do DmView no campo Start Program. Selecione Using Putty, preencha o
campo Connect to computer com o IP ou hostname do computador que tem o DmView instado e
preencha os campos de login e password do usuário. Clique Next.
• Start program = /opt/DmView/bin/startLogin.sh

Figura 171 – Xming – Start program


DATACOM 204.0119.47 – OUTUBRO/2022 149
DmView – Instalação Instalação e configuração de ferramentas para acesso
remoto ao DmView

5- Parâmetros Adicionais. Deixe em branco os campos e clique Next.

Figura 172 – Xming – Additional parameters

6- Clique em Save Configuration para salvar um atalho com as configurações que foram definidas. Clique
Finish para finalizar a configuração.

Figura 173 – Xming – Finish configuration

DATACOM 204.0119.47 – OUTUBRO/2022 150


DmView – Instalação Instalação e configuração de ferramentas para acesso
remoto ao DmView

7- Será criado um atalho no local escolhido pelo usuário.

Figura 174 – Xming – Xming shortcut

Se for mudar o nome do atalho, mantenha o “.xlaunch” no final do nome para manter o
vínculo com o Xming.

6.1.1.4 INICIANDO O LOGIN DO DMVIEW PELO XMING CLIENTE WINDOWS


Para iniciar o login do DmView pelo Xming, basta clicar duas vezes no atalho criado. A janela abaixo será exibida
solicitando a confirmação do password do usuário. Preencha o password e clique em Finish, o login será
iniciado.

Figura 175 – Xming – Starting DmView Login

DATACOM 204.0119.47 – OUTUBRO/2022 151


DmView – Instalação Instalação e configuração de ferramentas para acesso
remoto ao DmView

6.1.2 X2GO
X2Go é um software de desktop remoto de código aberto para Linux que usa o protocolo de tecnologia NX. O
X2Go fornece acesso remoto à interface gráfica do usuário do Linux em um desktop Windows ou Linux através
de sessões remotas seguras via ssh. O pacote do servidor deve ser instalado em um host Linux e os pacotes de
cliente podem ser executados em Windows ou Linux.

6.1.2.1 INSTALAÇÃO NO SERVIDOR LINUX COM ACESSO A INTERNET


Rodar os comandos abaixo.

sudo yum install epel-release

sudo yum install x2goserver

Figura 176 – X2GO – Yum install epel-release

DATACOM 204.0119.47 – OUTUBRO/2022 152


DmView – Instalação Instalação e configuração de ferramentas para acesso
remoto ao DmView

Figura 177 – X2GO – Yum install x2goserver

Instalação realizada com sucesso.

Figura 178 – X2GO – Yum install x2goserver - sucesso

DATACOM 204.0119.47 – OUTUBRO/2022 153


DmView – Instalação Instalação e configuração de ferramentas para acesso
remoto ao DmView

6.1.2.2 INSTALAÇÃO NO SERVIDOR LINUX SEM ACESSO A INTERNET


Mover os arquivos abaixo para um diretório exclusivo e executar o comando:

rpm -ivhf --nodeps *

• compat-glibc-2.5-46.2.x86_64.rpm
• compat-glibc-headers-2.5-46.2.x86_64.rpm
• fuse-2.8.3-5.el6.x86_64.rpm
• fuse-libs-2.8.3-5.el6.i686.rpm
• fuse-sshfs-2.4-1.el6.x86_64.rpm
• gd-2.0.35-11.el6.i686.rpm
• gd-2.0.35-11.el6.x86_64.rpm
• glibc-headers-2.12-1.192.el6.x86_64.rpm
• glibc-static-2.12-1.192.el6.x86_64.rpm
• glibc-utils-2.12-1.192.el6.x86_64.rpm
• libNX_X11-3.5.0.32-3.el6.x86_64.rpm
• libNX_Xau-3.5.0.32-3.el6.x86_64.rpm
• libNX_Xcomposite-3.5.0.32-3.el6.x86_64.rpm
• libNX_Xdamage-3.5.0.32-3.el6.x86_64.rpm
• libNX_Xdmcp-3.5.0.32-3.el6.x86_64.rpm
• libNX_Xext-3.5.0.32-3.el6.x86_64.rpm
• libNX_Xfixes-3.5.0.32-3.el6.x86_64.rpm
• libNX_Xinerama-3.5.0.32-3.el6.x86_64.rpm
• libNX_Xpm-3.5.0.32-3.el6.x86_64.rpm
• libNX_Xrandr-3.5.0.32-3.el6.x86_64.rpm
• libNX_Xrender-3.5.0.32-3.el6.x86_64.rpm
• libNX_Xtst-3.5.0.32-3.el6.x86_64.rpm
• libXcomp-3.5.0.32-3.el6.x86_64.rpm
• libXcompext-3.5.0.32-3.el6.x86_64.rpm
• libXcompshad-3.5.0.32-3.el6.x86_64.rpm
• libXpm-3.5.10-2.el6.x86_64.rpm
• lsof-4.82-5.el6.x86_64.rpm
• nxagent-3.5.0.32-3.el6.x86_64.rpm
• nx-libs-3.5.0.32-3.el6.x86_64.rpm
• perl-Capture-Tiny-0.23-1.el6.noarch.rpm
• perl-Config-Simple-4.59-5.1.el6.noarch.rpm
• perl-DBD-Pg-2.15.1-4.el6_3.x86_64.rpm
• perl-DBD-SQLite-1.27-3.el6.x86_64.rpm
• perl-DBI-1.609-4.el6.x86_64.rpm
• perl-File-BaseDir-0.03-13.el6.noarch.rpm
• perl-File-Which-1.09-2.el6.noarch.rpm

DATACOM 204.0119.47 – OUTUBRO/2022 154


DmView – Instalação Instalação e configuração de ferramentas para acesso
remoto ao DmView

• perl-Try-Tiny-0.11-4.el6.noarch.rpm
• PostgreSQL-libs-8.4.20-6.el6.x86_64.rpm
• pwgen-2.07-1.el6.x86_64.rpm
• x2goagent-3.5.0.32-3.el6.x86_64.rpm
• x2goserver-4.0.1.19-3.el6.x86_64.rpm
• x2goserver-fmbindings-4.0.1.19-3.el6.x86_64.rpm
• x2goserver-printing-4.0.1.19-3.el6.x86_64.rpm
• x2goserver-xsession-4.0.1.19-3.el6.x86_64.rpm
• xorg-x11-fonts-misc-7.2-11.el6.noarch.rpm
• xorg-x11-font-utils-7.2-11.el6.x86_64.rpm

6.1.2.3 INSTALAÇÃO NO CLIENTE WINDOWS


1- Faça o download do X2GO client for Windows no link:
• http://wiki.x2go.org/doku.php/doc:installation:x2goclient
2- Execute o instalador, a janela abaixo será exibida. Clique OK para continuar.

Figura 179 – X2GO – Select language

3- Licença de uso do software, leia e clique I agree se aceitar e quiser continuar a instalação.

Figura 180 – X2GO – License agreement


DATACOM 204.0119.47 – OUTUBRO/2022 155
DmView – Instalação Instalação e configuração de ferramentas para acesso
remoto ao DmView

4- Componentes para a instalação. Mantenha o tipo de instalação Recommended e clique Next.

Figura 181 – X2GO – Choose components

5- Local de instalação. Escolha o local que deseja instalar o software e clique Next.

Figura 182 – X2GO – Choose install location

DATACOM 204.0119.47 – OUTUBRO/2022 156


DmView – Instalação Instalação e configuração de ferramentas para acesso
remoto ao DmView

6- Escolha a pasta no menu iniciar do Windows. Clique Install para iniciar a instalação.

Figura 183 – X2GO – Choose start menu folder

7- Instalação em andamento.

Figura 184 – X2GO – Installing

DATACOM 204.0119.47 – OUTUBRO/2022 157


DmView – Instalação Instalação e configuração de ferramentas para acesso
remoto ao DmView

8- Instalação realizada com sucesso. Clique Finish.

Figura 185 – X2GO – Finish

6.1.2.4 INICIANDO O LOGIN DO DMVIEW PELO X2GO CLIENTE WINDOWS


1- Execute o atalho do X2GO Client.

Figura 186 – X2GO – Shortcut

2- Será exibida a janela abaixo. Preencha os campos:


• Aba Session:
o Session name: <colocar um nome>;
o Host: <servidor de console do DmView>;
o Login: <login para logar na máquina de console>;
o Session Type: Escolher <Single Application> e em command: sudo
/opt/DmView/bin/startLogin.sh;
o Deixar os outros campos com os valores padrões;

DATACOM 204.0119.47 – OUTUBRO/2022 158


DmView – Instalação Instalação e configuração de ferramentas para acesso
remoto ao DmView

• Aba Media:
o Desabilitar o checkbox "Client side printing support";
• Demais abas: Manter a configuração padrão.

Figura 187 – X2GO – New session

DATACOM 204.0119.47 – OUTUBRO/2022 159


DmView – Instalação Instalação e configuração de ferramentas para acesso
remoto ao DmView

3- Clique OK. Será exibida a janela abaixo. Clique na conexão criada, será solicitada a senha do usuário,
preencha e clique OK, o status passará para Connecting e depois Running e a login do DmView deverá
abrir para o usuário.

Figura 188 – X2GO – Session

Figura 189 – X2GO – Password

DATACOM 204.0119.47 – OUTUBRO/2022 160


DmView – Instalação Instalação e configuração de ferramentas para acesso
remoto ao DmView

Figura 190 – X2GO – Connecting

Figura 191 – X2GO – Running

6.1.3 XMANAGER
XManager é uma solução de integração entre plataformas que está no mercado desde 1997 e permite que os
clientes controlem sistemas e aplicativos remotos. O Xmanager funciona no Windows como um programa
standalone, não requer nenhuma instalação adicional do lado do servidor e apenas pequenas ou nenhuma
mudança são necessárias para sua infra-estrutura de TI existente. Diferentemente das ferramentas Xming e
X2GO, o XManager não é uma ferramenta open source (gratuita) e devem ser adquiridas licenças de uso junto
aos seus revendedores autorizados.

6.1.3.1 INSTALAÇÃO NO CLIENTE WINDOWS


Faça o download do instalador.

1- Execute o instalador, será exibida a mensagem de boas vindas do software, clique “Next” para
continuar.

DATACOM 204.0119.47 – OUTUBRO/2022 161


DmView – Instalação Instalação e configuração de ferramentas para acesso
remoto ao DmView

Figura 192 - XManager - Welcome

2- Leia o contrato de licença, selecione “I accept the terms of the license agreemente” e clique “Next” para
continuar.

Figura 193 - XManager - License Agreement

DATACOM 204.0119.47 – OUTUBRO/2022 162


DmView – Instalação Instalação e configuração de ferramentas para acesso
remoto ao DmView

3- Digite o seu nome, o nome da empresa e clique “Next”.

Figura 194 - XManager - Customer Information

4- Verifique o diretório em que o software será instalado, altere caso desejado e clique “Next”.

Figura 195 - XManager - Destination Location

DATACOM 204.0119.47 – OUTUBRO/2022 163


DmView – Instalação Instalação e configuração de ferramentas para acesso
remoto ao DmView

5- Selecione o tipo de instalação “Typical” e clique “Next”.

Figura 196 - XManager - Setup Type

6- Mantenha o diretório em que os atalhos serão criados e clique “Next”.

Figura 197 - XManager - Program Folder

DATACOM 204.0119.47 – OUTUBRO/2022 164


DmView – Instalação Instalação e configuração de ferramentas para acesso
remoto ao DmView

7- A instalação será iniciada, irá fazer a copia dos arquivos necessário, as configurações e será finalizada.

Figura 198 - XManager - Configuring XManager

Figura 199 - XManager - Installation Complete

DATACOM 204.0119.47 – OUTUBRO/2022 165


DmView – Instalação Instalação e configuração de ferramentas para acesso
remoto ao DmView

6.1.3.2 CONFIGURAÇÃO NO CLIENTE WINDOWS


1- Para configurar um atalho para abrir diretamente a login do DmView que está no Linux, execute o XStart
em ”Iniciar →Programas →XManager →XStart”.

2- Será exibida a janela abaixo. Clique em “New” para configurar uma nova sessão e digite o nome
desejado.

Figura 200 - XManager - New Session

3- Digite o IP do servidor no campo “Host”, selecione o protocolo “SSH”, digite o username para realizar a
conexão e no campo “command” digite “sudo /opt/DmView/bin/startLogin.sh”.

Figura 201 - XManager - DmView session

DATACOM 204.0119.47 – OUTUBRO/2022 166


DmView – Instalação Configuração do DmView

4- Clique em “Save” para salvar a nova configuração de sessão.


5- Clique no botão “Run”. A tela de login do DmView deverá ser exibida.

7 CONFIGURAÇÃO DO DMVIEW

7.1 HIERARQUIA DE DIRETÓRIOS


O DmView é composto pela seguinte hierarquia de diretórios:

Diretório Descrição

/activemq Binários e configuração do servidor de mensagens.

/backup Utilizada para armazenamento das configurações DCB de equipamentos

/bin Binários da aplicação e scripts que interagem com binários.

/conf Configurações de logs e serviços.

/data Diretório em que reside o nmspatch (arquivo utilizado para criação e


setup do banco de dados do DmView)

/doc Documentação.

/jdk 1.8.0_121 Java utilizado pelo DmView.

/lib Bibliotecas utilizadas pelo DmView.

/log Arquivos de log do DmView.

/services Diretório que contém o binário utilizado pelo NMS Services,


responsável pelas funcionalidades de importação, discovery, inventory,
license, merge, profiles, nes, status e cli template do DmView.

/temp Arquivos temporários criados pelo DmView.

/tomcat Servidor Web utilizado para disponibilizar os relatórios.

/uninstall Arquivos necessários para desinstalação da aplicação.


Tabela 28 - Hierarquia de diretórios

DATACOM 204.0119.47 – OUTUBRO/2022 167


DmView – Instalação Configuração do DmView

7.2 JANELA ABOUT


A janela de About do DmView pode ser acessada de duas formas:
1. Sem efetuar login no DmView, acessar: “Iniciar→ Programas→ DmView→ Enterprise→ DmView About”.
2. Após fazer o login no DmView, acessar: “Help→ About”.

Figura 202 - About

A janela About indica informações de sistema como a versão do sistema operacional que está instalado, a
versão do java, o diretório de instalação do DmView e o número do processo.

Em Version são exibidas as informações referentes a versão do DmView que está sendo utilizada, como SW-
Version, Build-On, Database Version e License (Demo ou Enterprise).

A box Managed Devices exibe o número de devices que estão adicionados ao DmView e número máximo de
devices que a licença inserida suporta.

Os botões Save Info e Feature Details são utilizados no licenciamento do DmView e serão apresentados a seguir.

A aba Contact exibe os contatos para sugestões, suporte e venda.

DATACOM 204.0119.47 – OUTUBRO/2022 168


DmView – Instalação Configuração do DmView

Figura 203 – Contact

7.2.1 LICENCIAMENTO DO DMVIEW

7.2.1.1 TIPOS DE LICENÇAS


Existem 2 tipos de licenças do DmView:
1. Licença do tipo Server (Demo/Lite):
• Máximo 15 equipamentos;
• Máximo de 5 usuários simultâneos;
• Máximo de 2000 CPEs TR-069 Datacom;
• Máximo de 100 CPEs TR-069 Multivendor;
• Features:
• CLI Template Multivendor desabilitada;
• High Availability desabilitada;
• Com ou sem limite de tempo de uso conforme exibido pela janela de About.
2. Licença do tipo Server (Enterprise):
• Número de equipamentos e CPEs de acordo com o adquirido;
• Número de usuários simultâneos de acordo com o adquirido;
• Com ou sem limite de tempo de uso conforme exibido pela janela de About;
DATACOM 204.0119.47 – OUTUBRO/2022 169
DmView – Instalação Configuração do DmView

• Features de acordo com o adquirido (CLI Template Multivendor, High Availability);


• Licença específica para a máquina ou liberada para instalar em outras máquinas.

7.2.1.2 RESTRIÇÕES DA LICENÇA


Quando o número de Equipamentos ou CPEs TR-069 (Datacom ou Multivendor) chega no número máximo
permitido pela licença, não é possível adicionar mais equipamentos/CPEs TR-069.
Se a licença for substituída por uma outra licença que permite menos equipamentos/CPEs TR-069 do que já
estão adicionados (o que inclui, por exemplo, a ausência de arquivo de licença, que corresponde à licença
Demo), os serviços do DmView não serão iniciados.
Se a licença for expirável, ou seja, existe uma data limite de validade, após passar desta data, não será possível
logar no DmView Desktop, DmView Web Maestro ou Portal de relatórios. Além disso, os serviços serão parados
automaticamente quando a licença expirar, não sendo mais possível iniciá-los. Será exibida uma mensagem de
alerta ao fazer login no DmView Desktop, DmView Web Maestro ou Portal de relatórios quando faltarem 15 ou
menos dias para a licença expirar. Após a expiração da licença, para continuar utilizando o DmView, será
necessário entrar em contato com a Datacom e solicitar uma nova licença.
Para as consoles serem utilizadas, não é necessário licença.

Para aumentar o número de elementos a serem gerenciados e aumentar o número de acessos remotos, deve
ser gerada uma licença para este fim. Para tanto, os seguintes passos são necessários:

• Salvar o arquivo contendo os dados da licença e enviar para a DATACOM;


• Importar o arquivo disponibilizado pela DATACOM;
• Reiniciar os serviços do DmView.

7.2.1.3 COMO GERAR O ARQUIVO PARA GERAÇÃO DE LICENÇA

7.2.1.3.1 Salvar arquivo com dados da licença via DmView About


1. Clicar em “Iniciar→ Programas→ DmView→ Enterprise→ DmView About” Abrirá a janela About
do DmView.
2. Na janela About, deve-se clicar em Save Info, a qual gerará um arquivo zip contendo as
informações da instalação do DmView desta máquina.
3. Este arquivo deverá ser enviado à DATACOM para ser liberada a licença.

7.2.1.3.1.1 Salvar arquivo com dados da licença via script


A geração do arquivo com dados da licença deve ser realizada via script caso os serviços do DmView estejam
indisponíveis pela ocorrência de uma das situações abaixo:

• Licença atual com válidade expirada;


• Número de equipamentos existentes na base de dados maior que o permitido pela licença atual;
• Reinstalação do DmView em um novo servidor;
• Migração da VM(Virtual Machine) para um novo servidor hospedeiro.

DATACOM 204.0119.47 – OUTUBRO/2022 170


DmView – Instalação Configuração do DmView

7.2.1.3.1.1.1 Gerando o arquivo com dados da licença via script em Windows.

1. Localizar o script “printLicenseInfo.bat” em “C:\Program Files\DmView\bin\admin”;


2. Executar o script “printLicenseInfo.bat” através de um duplo clic do mouse sobre o arquivo.

7.2.1.3.1.1.2 Gerando o arquivo com dados da licença via script em Linux


.

1. Localizar o script “printLicenseInfo.sh” em “/opt/DmView/bin/admin” através do comando:

# ls -l /opt/DmView/bin/admin | grep printLicenseInfo.sh

1. Executar o script “printLicenseInfo.sh” através do commando:

# /opt/DmView/bin/admin/printLicenseInfo.sh

7.2.1.3.2 Importando o arquivo disponibilizado pela DATACOM


• A DATACOM deve disponibilizar o arquivo da licença, o qual deve ser salvo no diretório de instalação
do DmView (Windows: “C:\Program Files\DmView\” ou Linux: “/opt/DmView”), com o nome de
license.dat.
• Depois confira o número de elementos que podem ser gerenciados através de “Iniciar→
Programas→ DmView→ Enterprise→ DmView About” na seção Managed Devices e as funcionalidades
licenciadas através de Feature Details.

DATACOM 204.0119.47 – OUTUBRO/2022 171


DmView – Instalação Configuração do DmView

7.2.1.4 FEATURES A SEREM LICENCIADAS


As features a serem licenciadas, disponíveis no DmView, podem ser acessadas através de “Iniciar→
Programas→ DmView→ Enterprise→ DmView About→ Feature Details”, quando o login do DmView não estiver
iniciado, ou através do menu “Help→ About→ Feature Details”, com o login do DmView aberto.

Figura 204 - Feature Details

CLI Template: Permite o uso da ferramenta CLI Template, utilizada para enviar templates de comandos (CLI)
para um ou vários equipamentos DATACOM.
CLI Template Multivendor: Permite o uso da ferramenta CLI Template, utilizada para enviar templates de
comandos (CLI) para um ou vários equipamentos de outros fabricantes de equipamentos.
High Availability: Permite a utilização do recurso de alta disponibilidade do DmView.

A partir do DmView 11.1, os modelos de equipamentos foram retirados da licença, sendo


permitido o gerenciamento de qualquer modelo de equipamento em qualquer licença
Demo ou Enterprise Server.

DATACOM 204.0119.47 – OUTUBRO/2022 172


DmView – Instalação Configuração do DmView

7.3 ARQUIVO “NMS.CONF”


O DmView possui um arquivo chamado “nms.conf” onde podemos especificar alguns parâmetros importantes
ao software. Este arquivo se encontra no diretório de instalação do DmView (Windows: “C:\Program
Files\DmView” ou Linux: “/opt/DmView”.
Esta seção mostrará a estrutura do arquivo, os parâmetros que podem ser configurados e seus possíveis
valores.F

7.3.1 GENERAL
O início do arquivo é composto pela seção General, conforme vemos abaixo:

#General
Version=Enterprise-11.2.0-0
LicenseType=Enterprise-Server

• Version: é um parâmetro informativo, contendo a versão do DmView;


• LicenseType: especifica se a aplicação é o servidor do DmView ou Console [Enterprise-Server /
Enterprise-Console].

7.3.2 SERVER NMS

#Server NMS
Server=localhost
nms.global.services.address=dmviewbase.ped.datacom.ind.br
provisioning.port=8082
provisioning.timeout=600000
nms.ha.enabled=false
nms.poller.scheduled.enabled=true
nms.poller.distributed.enabled=false
##
# Cron format for defining the scheduled polling frequency.
# The pattern is a list of five single space-separated fields: minute, hour, day,
month, weekday.
# Month and weekday names can be given as the first three letters of the English
names.
#
# Example patterns:
#
# 0 * * * * = the top of every hour of every day.
# 0 8-10 * * * = 8, 9 and 10 o'clock of every day.
# 0/30 8-10 * * * = 8:00, 8:30, 9:00, 9:30 and 10 o'clock every day.
# 0 9-17 * * MON-FRI = on the hour nine-to-five weekdays
# 0 0 25 12 ? = every Christmas Day at midnight
##
nms.poller.scheduled.cron.expression=0 */6 * * *
#time unit: minutes
nms.poller.pollingMaxIdleTime=15
nms.poller.genericMessageReceiverPoolSize=10
nms.poller.pollingMessageReceiverPoolSize=10

• Server: Nome ou IP do servidor de aplicação do DmView.


• nms.global.services.address: Nome ou IP do servidor aonde estão instalados os serviços standalone.
• provisioning.port: Porta utilizada pelo serviço de provisionamento.
• provisioning.timeout: Timeout para o serviço de provisionamento.

DATACOM 204.0119.47 – OUTUBRO/2022 173


DmView – Instalação Configuração do DmView

• nms.ha.enabled: Configuração para habilitar/desabilitar a alta disponibilidade do DmView (H.A.). Para


maiores informações, consulte o documento DmView - Manual de Alta Disponibilidade.
• nms.poller.scheduled.enabled: Configuração para habilitar/desabilitar o polling agendado.
• nms.poller.distributed.enabled: Configuração para ativar o poller distribuído. Para mais informações
sobre esta feature, verifique a seção Configuração do Poller Distribuído.
• nms.poller.scheduled.cron.expression: Configuração do agendamento do polling distribuído. Para
maiores detalhes de configuração leia a seção Configuração do Poller Distribuído.
• nms.poller.pollingMaxIdleTime: Máximo de tempo (em minutos) que o polling de equipamento pode
ficar em execução. Depois deste tempo o polling do equipamento é removido, pois possivelmente ele
estava travado.
• nms.poller.genericMessageReceiverPoolSize: Quantidade de mensagens genericas que podem ser
recebidas em paralelo pela poller.
• nms.poller.pollingMessageReceiverPoolSize: Quantidade de mensagens de polling feedback que
podem ser recebidas em paralelo pela poller.

Parâmetros ocultos:

Além destes parâmetros listados acima que já existem por padrão no arquivo “nms.conf”, existem os
parâmetros:

• nms.login.maxConcurrentPollingPerUser: Determina o número de pollings simultâneos máximo que


cada usuário pode solicitar. Por exemplo, para configurar esse parâmetro para permitir no máximo 15
pollings simultâneos por usuário, basta inserir a linha: “nms.login.maxConcurrentPollingPerUser=15” na
seção “Server NMS” do “nms.conf”.

• nms.login.pollingOnStatusWindowOpen.enabled: Realiza, automaticamente no intervalo de minutos


configurado pelo parâmetro “nms.login.pollingOnStatusWindowOpen.intervalMinutes”, o polling ao
abrir o bayface ou qualquer janela de status do equipamento. O valor padrão deste parâmetro é true,
ou seja, só será necessário incluir este parâmetro no “nms.conf” caso o desejado seja desabilitar esta
funcionalidade. Para desabilitar, deve ser incluída a linha
“nms.login.pollingOnStatusWindowOpen.enabled=false” na seção “Server NMS” do “nms.conf”.

• nms.login.pollingOnStatusWindowOpen.intervalMinutes: Determina o intervalo de minutos entre os


pedidos de polling ao abrir uma janela de status de equipamento, como um bayface. Exemplo: Depois
de abrir um bayface de equipamento e disparar um polling automático, se o bayface for fechado e
aberto novamente antes do intervalo configurado por este parâmetro, o polling não será realizado
automaticamente novamente. O valor padrão deste parâmetro é de 5 minutos. Para alterar este valor
padrão para 10 minutos, por exemplo, deve ser incluída a linha
“nms.login.pollingOnStatusWindowOpen.intervalMinutes=10” na seção “Server NMS” do “nms.conf”.

• nms.login.pollingOnTrapOnStatusWindow.enabled: Realiza, automaticamente, o polling ao receber


uma trap e existir uma janela de status do equipamento aberta. Se não existir nenhuma janela de status
de equipamento aberta, o polling não será realizado no equipamento. O valor padrão deste parâmetro
é “true”, ou seja, só será necessário incluir este parâmetro no “nms.conf” caso o desejado seja desabilitar

DATACOM 204.0119.47 – OUTUBRO/2022 174


DmView – Instalação Configuração do DmView

esta funcionalidade. Para desabilitar, deve ser incluída a linha


“nms.login.pollingOnTrapOnStatusWindow.enabled=false” na seção “Server NMS” do “nms.conf”.

• nms.login.pollingOnTrap.enabled: Habilita o polling automático dos equipamentos quando uma trap


for recebida. O padrão deste parâmetro é “true”. A diferença entre este parâmetro e o
"nms.login.pollingOnTrapOnStatusWindow.enabled" é a seguinte:
o nms.login.pollingOnTrap.enabled: Realiza polling no equipamento se receber uma trap,
independente se existe uma janela de status aberta.
o nms.login.pollingOnTrapOnStatusWindow.enabled: Realiza polling no equipamento se
receber trap e somente se uma janela de status estiver aberta.

• nms.login.pollingOnTrap.hysteresisSeconds: Tempo esperado, em segundos, para iniciar o polling no


equipamento. Se chegar uma nova trap neste período de tempo, este novo pedido de trap será
descartado. O padrão deste parâmetro é 10 segundos. Para alterar este valor padrão para 20 segundos,
por exemplo, deve ser incluída a linha “nms.login.pollingOnTrap.hysteresisSeconds=20” na seção “Server
NMS” do “nms.conf”.

• nms.login.pollingOnTrap.waitTimeMinutes: Determina o intervalo de minutos entre os pedidos de


polling disparados pela chegada de uma trap. Para funcionar, o parâmetro
“nms.login.pollingOnTrap.scheduled.enabled” deve estar habilitado, caso contrário, o polling não será
executado ao final do tempo configurado. Quando uma trap chegar durante este intervalo, o polling
será agendado para o final deste tempo de espera. Exemplo: O tempo de espera foi configurado para
25 minutos e um polling iniciou às 10h00 em um equipamento específico. Se uma nova trap chegou
para este mesmo equipamento às 10h10, o novo polling será agendado para 10h25, que é quando o
tempo de espera termina. Para alterar este valor para 25 minutos, por exemplo, deve ser incluído o
parâmetro “nms.login.pollingOnTrap.waitTimeMinutes=25” na seção “Server NMS” do “nms.conf”. O valor
de tempo de espera padrão, caso o parâmetro “nms.login.pollingOnTrap.waitTimeMinutes” não esteja
presente no “nms.conf”, é de 15 minutos. Esse tempo é calculado por equipamento, ou seja, cada
equipamento terá o seu tempo de espera independente. OBS: Este parâmetro não é válido para
equipamentos DmOS.

• nms.login.pollingOnTrap.bufferedPollingRequestInterval: Determina o intervalo em segundos que os


pedidos de polling por trap ficarão armazenados em um buffer antes de dispararem os pollings nos
equipamentos relacionados. O valor padrão do parâmetro é 5 segundos, ou seja, a cada 5 segundos
todos os pedidos de polling por trap serão disparados nos equipamentos relacionados. Caso tenha
sido recebida mais de uma trap para um mesmo equipamento, somente um polling será disparado no
equipamento. Para alterar este tempo para, por exemplo, 20 segundos, basta adicionar ou editar no
“nms.conf” o parâmetro “nms.login.pollingOnTrap.bufferedPollingRequestInterval=20”. OBS: Este
parâmetro tem como pré-requisito que o parâmetro “nms.login.pollingOnTrap.pollingAskerType” esteja
configurado como “BUFFERED”, que é o valor padrão.

• nms.login.pollingOnTrap.pollingAskerType: Tem como valor padrão “BUFFERED”, ou seja, todos os


pedidos de polling por trap recebidos no DmView serão armazenados pelo tempo configurado no
parâmetro “nms.login.pollingOnTrap.bufferedPollingRequestInterval” para depois dispararem os
pollings nos equipamentos relacionados. Este parâmetro pode ser configurado para “UNBUFFERED”,
DATACOM 204.0119.47 – OUTUBRO/2022 175
DmView – Instalação Configuração do DmView

assim, os pedidos de polling por trap não serão armazenados e os pollings serão disparados
imediatamente nos equipamentos relacionados (caso o parâmetro nms.login.pollingOnTrap.enabled
esteja “true”). Para configurar o parâmetro para “UNBUFFERED”, adicione ou edite no arquivo “nms.conf”
o parâmetro “nms.login.pollingOnTrap.bufferedPollingRequestInterval=UNBUFFERED”.

• nms.login.pollingOnTrap.scheduled.enabled: Quando habilitado, caso receba uma nova trap, agenda


um novo polling para o final do tempo configurado pelo parâmetro
"nms.login.pollingOnTrap.waitTimeMinutes". Possui como pré-requisito estar com o parâmetro
"nms.login.pollingOnTrap.enabled=true". O valor padrão do parâmetro
"nms.login.pollingOnTrap.scheduled.enabled" é "true". Para desabilitar, deve ser incluída a linha
“nms.login.pollingOnTrap.scheduled.enabled=false” na seção “Server NMS” do “nms.conf”.

• nms.jmx.remote.enabled: Quando habilitado, é possível utilizar o Jconsole para monitorar o DmView


via JMX. O padrão deste parâmetro é “False”. Para habilitar, deve ser incluída a linha
“nms.jmx.remote.enabled=true” na seção “Server NMS” do “nms.conf”.

• nms.data.collector.polling.interval: Parâmetro relativo ao intervalo de tempo que a janela Transceiver


Manager irá consultar e atualizar os dados do equipamento. Deve ser configurado com um valor em
segundos, ex: nms.transceiver.collector.polling.interval=240. O valor default é 60 segundos.

• nms.discovery.netconf.enable: Parâmetro polling do DmOS para passar a ser feito sem necessidade do
SNMP estar habilitado no equipamento, sendo suficiente apenas o equipamento estar acessível via
NETCONF. Por default valor esta configurado em true. Recomenda-se utilizar este parâmetro em false
caso sua gerência não possua equipamentos DmOS.

• nms.discovery.netconf.general.timeout: O timeout padrão do protocolo NETCONF no pré-polling é


configurado na Management Protocol Configuration, mas é possível configurar um timeout geral
específico para o pré-polling através desta propriedade.

• nms.device.log.collector.cron.expression: Parâmetro que configura o tempo de coleta dos logs dos


equipamentos SDH (DM705 CPU128 com FW >= 14 e DM880 MPU10G com FW >= 25.1). Deve ser
configurado utilizando uma expressão do cron, ex: “nms.device.log.collector.cron.expression=0 0/15 *
* * *” significa que os logs serão coletados a cada 15 minutos. Para maiores informações, consulte o
Manual de Operação Geral no capítulo Device Logs.

• nms.data.collector.monitoring.service.path: Caminho utilizado na URL para direcionar as chamadas


HTTP. No caso do zabbix, o valor é "api_jsonrpc.php", que é o valor configurado por padrão.

• nms.data.collector.monitoring.service.status.path: Parâmetro que configura o path para a API de


Status para consulta de dados de monitoração. No caso do zabbix, o valor é "jsrpc.php", que é o valor
configurado por padrão.

• nms.data.collector.monitoring.client.jsonRpc.timeout: Parâmetro que configura o tempo de timeout


da conexão HTTP na comunicação via JSON-RPC. O tempo padrão é de 10 segundos, logo, por
exemplo, para alterar para um timeout de 20 segundos, a linha
“nms.data.collector.monitoring.client.jsonRpc.timeout=20” deve ser incluída no nms.conf.

DATACOM 204.0119.47 – OUTUBRO/2022 176


DmView – Instalação Configuração do DmView

• nms.data.collector.monitoring.client.jsonRpc.trustSelfSignedCertificates: Parâmetro que configura se,


na comunicação HTTP devem ser aceitos certificados auto-assinados (true) ou não (false). A
configuração padrão é true, para alterar para false a linha
“nms.data.collector.monitoring.client.jsonRpc.trustSelfSignedCertificates=false” deve ser incluída no
nms.conf.

• nms.security.csrf.enable: Parâmetro que habilita a proteção contra ataques CSRF/XSRF. A configuração


padrão é true, para alterar para false a linha “nms.security.csrf.enable=false” deve ser incluída no
nms.conf.

• nms.device.window.refresh.intervalMinutes: Parâmetro que configura o tempo de refresh automático


em minutos do DmView Web (Maestro). O tempo padrão é de 5 minutos. Para alterar, deve ser inserido
no “nms.conf” o parâmetro acompanhado do novo valor em minutos, ex:
“nms.device.window.refresh.intervalMinutes=2” muda para 2 minutos o tempo de refresh automático.

Figura 205 – Refresh interval minutes

• nms.nes.dcb.lock.retry.max.attempts: Parâmetro utilizado pela janela de backups de equipamentos


(DCB) e que configura a quantidade máxima de tentativas (retries) de fazer o backup de um
equipamento em caso de lock por alguma outra funcionalidade. Ex:
“nms.nes.dcb.lock.retry.max.attempts=5”.
• nms.nes.dcb.lock.retry.backoff.seconds: Parâmetro utilizado pela janela de backups de equipamentos
(DCB) e que configura o intervalo em segundos entre as tentativas de fazer backup configuradas no
parâmetro “nms.nes.dcb.lock.retry.max.attempts” em caso de lock por alguma outra funcionalidade.
Ex: “nms.nes.dcb.lock.retry.backoff.seconds=10”.

A Configuração que mantém somente uma janela de bayface aberta por equipamento é o
comportamento padrão do DmView e não pode ser desabilitada.

DATACOM 204.0119.47 – OUTUBRO/2022 177


DmView – Instalação Configuração do DmView

7.3.3 TRAP/EVENT CONFIGURATION


nms.event.store.interval=1

• nms.event.store.interval: Tempo em segundos utilizado para a gravação dos eventos no banco de


dados.

7.3.4 SERVER DATABASE


DatabaseType=oracle
JdbcUrl=jdbc:oracle:thin:@localhost:1521:xe
nms.global.db.jdbcUrl=${JdbcUrl}
nms.global.db.driverClass=oracle.jdbc.driver.OracleDriver

• DatabaseType: SGBD utilizado [oracle];


• nms.global.db.jdbcUrl: URL do banco de dados utilizada pelos serviços standalone;
• nms.global.db.driverClass: Driver do banco de dados oracle;
• JdbcUrl: URL que descreve a localização do banco de dados a ser utilizado. Se a base de dados fosse
Oracle Standard/Enterprise o valor seria:

jdbc:oracle:thin:@localhost:1521:datacom

7.3.5 FAULT SYSTEMS

#Fault Systems
KeepAlive=disable
IntegratedFaultSystems=
KeepAliveRate=20

• KeepAlive: Habilita serviço interno que envia uma trap para sistema de falhas de nível superior a cada
“KeepAliveRate” segundos informando que serviços do DmView estão operando corretamente. Usar em
conjunto com “KeepAliveRate”.
• IntegratedFaultSystems: Nome(s) ou IP(s) e porta TCP dos sistemas de falhas de nível superior para
onde DmView deve encaminhar traps recebidas [ex.: 192.168.0.2|162|192.168.0.2|162]
• KeepAliveRate: Tempo em segundos entra cada envio de trap do DmView informando sua correta
operação. Usar em conjunto com “KeepAlive”.

7.3.6 WEB

ServerWWW=https://localhost:8443/nms/

• Server WWW: Endereço https base para serviço NMS Apache Tomcat (Portal Web de relatórios do
DmView). Caso o servidor do Portal Web de relatórios do DmView tenha sido instalado em outro
servidor, esta URL deve ser modificada.

7.3.7 USER PREFERENCES E DATABASE POOL CONECTION


## User preferences 31
# time unit: hours 32
user.preferences.cache.expire=720

DATACOM 204.0119.47 – OUTUBRO/2022 178


DmView – Instalação Configuração do DmView

Parâmetros de configuração de banco de dados e de sua pool de conexões (somente altere estes valores caso
possua conhecimento, caso contrário contate o nosso suporte):

##
# Legacy database related configuration
##
# DBMS pool type possible values (c3p0,none)
database.DbmsPoolType=c3p0
database.DbmsPoolOnGuiEnabled=false
database.enableUniqueConnectionOnAutoProv=true
database.enableUniqueConnectionOnLogin=true
database.enableUniqueConnectionOnWeb=true
database.monitor.limits.maxPreparedStatementBatching=500000
##
# <> C3P0 Connection pool configuration <>
##
database.pool.c3p0.acquireIncrement=5
database.pool.c3p0.acquireRetryAttempts=9
# in milliseconds
database.pool.c3p0.acquireRetryDelay=5000
# in milliseconds
database.pool.c3p0.checkoutTimeout=0
# in seconds
database.pool.c3p0.idleConnectionTestPeriod=0
database.pool.c3p0.minPoolSize=15
database.pool.c3p0.initialPoolSize=15
database.pool.c3p0.maxPoolSize=150
database.pool.c3p0.maxIdleTime=0
database.pool.c3p0.maxStatementsPerConnection=0
database.pool.c3p0.statementCacheNumDeferredCloseThreads=0
database.pool.c3p0.numHelperThreads=3
# Enable database connection leak handling/detection
# in seconds
database.pool.c3p0.unreturnedConnectionTimeout=0
# enable to debug abandoned open connections
database.pool.c3p0.debugUnreturnedConnectionStackTraces=false
# To be enabled when the network experiences loss of connectivity
database.pool.c3p0.testConnectionOnCheckout=false
database.pool.c3p0.testConnectionOnCheckin=false
database.pool.c3p0.idleConnectionTestPeriod=0
##

7.3.8 PROVISIONING
Seção referente ao serviço de provisionamento (somente altere estes valores caso possua conhecimento, caso
contrário contate o nosso suporte).

##
# Provisioning Server
##
provisioning.base.uri=http://${Server}:${provisioning.port}

##
# Connection pool configuration properties.
##

DATACOM 204.0119.47 – OUTUBRO/2022 179


DmView – Instalação Configuração do DmView

provisioning.db.pool.acquire.increment=5
provisioning.db.pool.acquire.retry.attempts=5
provisioning.db.pool.acquire.retry.delay=2000
provisioning.db.pool.checkout.timeout=0
provisioning.db.pool.idle.connection.test.period=60
provisioning.db.pool.min.pool.size=2
provisioning.db.pool.max.pool.size=20
provisioning.db.pool.max.idle.time=120
provisioning.db.pool.num.helper.threads=3

7.3.8.1 PROVISIONING SEGURO


Para ativar o serviço de provisionamento em modo seguro, adicione o parâmetro abaixo na seção “#
Provisioning Server”.

provisioning.ssl.enabled=true

Além disso, substitua os parâmetros “provisioning.base.uri” e “provisioning.uri” pelos parâmetros abaixo.

provisioning.base.uri=https://${Server}:${provisioning.port}

provisioning.uri=https://${Server}:${provisioning.port}/service

Reinicie o serviço “NMS Provisioning”.

7.3.9 APPLICATION SERVER CONFIGURATION

##
# Application Server Configuration
##
nms.standalone.services.base.url=https://${nms.global.services.address}:8101
nms.standalone.services.websocket.uri=wss://${nms.global.services.address}:8101
nms.acs.https.port=7547
nms.acs.uri=https://${nms.global.services.address}:${nms.acs.https.port}
nms.data.collector.client.http.connection.pool.size=20
nms.inventory.client.http.connection.pool.size=20
##

# Services URIs
##
importation.uri=${nms.standalone.services.base.url}
provisioning.uri=http://${Server}:${provisioning.port}/service
nms.discovery.url=${nms.standalone.services.base.url}
nms.inventory.url=${nms.standalone.services.base.url}
license.uri=${nms.standalone.services.base.url}
merge.uri=${nms.standalone.services.base.url}
nms.profiles.uri=${nms.standalone.services.base.url}
nms.nes.uri=${nms.standalone.services.base.url}
nms.status.uri=${nms.standalone.services.base.url}
nms.data.collector.uri=${nms.standalone.services.base.url}
DATACOM 204.0119.47 – OUTUBRO/2022 180
DmView – Instalação Configuração do DmView

nms.dynamic.device.config.uri=${nms.standalone.services.base.url}
nms.template.client.uri=${nms.standalone.services.base.url}
device.management.web.uri=${nms.standalone.services.base.url}

# Dynamic device config front-end URI


nms.dynamic.device.config.client.uri=${nms.standalone.services.base.url}

##
# Services' web socket base URIs
##
nms.nes.websocket.uri=${nms.standalone.services.websocket.uri}

• nms.standalone.services.base.url: URL em que os serviços standalone estão instalados.


• nms.standalone.services.websocket.uri: URL em que está o websocket dos serviços standalone.
• nms.acs.uri: URL em que o serviço de ACS está instalado e disponível.
• nms.acs.https.port: Porta HTTPS utilizada para o serviço ACS. O valor padrão é “7547”.
• importation.uri: URL utilizada para contatar o serviço standalone de importation.
• provisioning.uri: URL utilizada para contatar o serviço de provisionamento.
• nms.discovery.url: URL utilizada para contatar o serviço standalone de discovery.
• license.uri: URL utilizada para contatar o serviço standalone de license.
• merge.uri: URL utilizada para contatar o serviço standalone de merge.
• nms.profiles.uri: URL utilizada para contatar o serviço standalone de profile.
• nms.nes.uri: URL utilizada para contatar o serviço standalone de nes.
• nms.status.uri: URL utilizada para contatar o serviço standalone de status.
• nms.template.client.uri: URL utilizada para contatar o serviço standalone de cli-template-client-web e
cli-template-server-web.

Parâmetros ocultos:

• nms.acs.http.port: Porta utilizada pelo serviço ACS para receber requisições HTTP. O valor padrão é
“7546”. Ex: “nms.acs.http.port=7546”. As requisições HTTP podem ser redirecionadas para HTTPS ao
habilitar o parâmetro “nms.acs.http.port.redirect=true”, conforme descrito abaixo.
• nms.acs.http.port.redirect: Parâmetro de configuração de redirect de HTTP para HTTPS. O valor padrão
é “false”, mas pode ser habilitado configurando o parâmetro para “true”, assim, as requisições HTTP
que chegarem no ACS serão redirecionadas para HTTPS. Ex: “nms.acs.http.port.redirect=true”.
• nms.template.client.apply.uri: URL utilizada para contatar o serviço standalone de template-client-web
e template-server-web. O valor padrão é “${nms.standalone.services.base.url}”. Esse parâmetro estava
listado no nms.conf até a versão 11.0, na versão 11.1 virou parâmetro oculto.

DATACOM 204.0119.47 – OUTUBRO/2022 181


DmView – Instalação Configuração do DmView

7.3.10 LDAP

##
# LDAP Conf
##
ldap.enable=false

Caso o LDAP seja habilitado, deverá ser alterado também o arquivo ldap.conf, localizado na pasta DmView/conf.
Para maiores informações, consulte a seção LDAP do documento DmView - Manual de Operação Geral.

7.3.11 NES DEVICE CACHE


Seção referente a funcionalidade NES (somente altere estes valores caso possua conhecimento, caso contrário
contate o nosso suporte).

##
# NES Device Cache configuration
##
nes.device.cache.expire.time=6
nes.device.cache.expire.unit=HOURS
nes.device.cache.size=200

7.3.12 STATUS DEVICE CACHE


Seção referente a funcionalidade de status (somente altere estes valores caso possua conhecimento, caso
contrário contate o nosso suporte).
##

# Status Device Cache configuration

##

status.device.cache.expire.time=6

status.device.cache.expire.unit=HOURS

status.device.cache.size=200

7.3.13 CLI TEMPLATE


Seções referentes a funcionalidade cli-template (somente altere estes valores caso possua conhecimento, caso
contrário contate o nosso suporte).
##
# Client Managed Device Cache Configuration
##
client.device.cache.expireTime=360
client.device.cache.maximumSize=50

# Text Based Protocol Prompts configuration


DATACOM 204.0119.47 – OUTUBRO/2022 182
DmView – Instalação Configuração do DmView

# Default values:
# >\\s?\\s?$ : matches the char > followed by either one,
two or no white space char [\r\n\t\f ] at the end of the string
# \\r?\\n\\w+#\\s?$ : matches the char # preceded by a line break
and alphanumeric character and then followed by one optional white space char
[\r\n\t\f ] at the end of the string
# ^[\\w-\\[\\]@.:~)(\\/]+#\\s?$ : matches the char ^ asserts position at start
of a line,
# \w matches any word character (equal to [a-
zA-Z0-9_]),
# - matches the character '-' , \[ matches the
character '[', \] matches the character ']'
# @.:~)(\/ matches a single character in the
list @.:~)(/ (case sensitive)
# \s? matches any whitespace character (equal
to [\r\n\t\f\v ])
# d:(?![\\w\\W]) : matches the chars d: at the end of the entire
input
# uses a negative lookahead to make sure that
no any word character and any non-word character exist after the required match
# \\$\\s$ : matches the char $ followed by one white space
char [\r\n\t\f ] at the end of the string
# -?bash.*\\$\\s?$ : matches the value bash followed by any
character and then $, and accepting one optional white space char [\r\n\t\f ] at
the end of the string
# Password:\\s : matches the value "Password: "
# DO NOT POWER OFF... : matches the value "DO NOT POWER OFF THE DEVICE
UNTIL UPGRADE IS COMPLETE"
# (\\r\\n|^)\\[(?!edit\\]).*\\]\\s?$ : matches the char [ at the start of the
string or after a line break, then accept any
# character until a ] (except the sequence
'edit]') and accepting one optional white space
# char [\r\n\t\f] at the end of the string
# ^\\S*:~\\$\\s?$ : matches any char followed by the sequence :~$
and accepting one optional white space char [\r\n\t\f ] at the end of the string
cli.output.prompt.regex[0]=>\\s?\\s?$
cli.output.prompt.regex[1]=\\r?\\n\\w+#\\s?$
cli.output.prompt.regex[2]=^[\\w-\\[\\]@.:~)(\\/]+#\\s?$
cli.output.prompt.regex[3]=d:(?![\\w\\W])
cli.output.prompt.regex[4]=^\\[?\\S*@\\S*\\s?~\\]?\\$\\s?$
cli.output.prompt.regex[5]=-?bash.*\\$\\s?$
cli.output.prompt.regex[6]=Password:\\s
cli.output.prompt.regex[7]=DO NOT POWER OFF THE DEVICE UNTIL UPGRADE IS COMPLETE
cli.output.prompt.regex[8]=(\\r\\n|^)\\[(?!edit\\]).*\\]\\s?$
cli.output.prompt.regex[9]=^\\S*:~\\$\\s?$

##
# Terminal Paging
##
# Matches here will NOT be shown on output
# \\s?[-]+\\s?More\\s?[-]+ :
matches the indication of the existence of more pages
# -- more --, next page: Space, continue: g, quit: \\^C :
same as above
# \.+press ENTER to next line, SPACE key to next page, Q or other key to quit\.+
: same as above
# \.+press ENTER to next line, CTRL_C to quit, other key to next page\.+
: same as above
# -- \\[Q quit\\|D dump\\|.*?\\] :
same as above
# \\(END\\) :
matches the end of a terminal command
# \\r\\n:\\x1B\\[. :
matches an ":" at the beginning of a new line, followed by some ASCII sequence
cli.output.terminal-paging.regex[0]=\\s?[-]+\\s?More\\s?[-]+
cli.output.terminal-paging.regex[1]=\\(END\\)
cli.output.terminal-paging.regex[2]=\\r\\n:\\x1B\\[.

DATACOM 204.0119.47 – OUTUBRO/2022 183


DmView – Instalação Configuração do DmView

cli.output.terminal-paging.regex[3]=-- more --, next page: Space, continue: g,


quit: \\^C
cli.output.terminal-paging.regex[4]=\.+press ENTER to next line, SPACE key to
next page, Q or other key to quit\.+
cli.output.terminal-paging.regex[5]=\.+press ENTER to next line, CTRL_C to quit,
other key to next page\.+
cli.output.terminal-paging.regex[6]=-- \\[Q quit\\|D dump\\|.*?\\]

##
# Confirmation
##
# Matches confirmations of type Y/n, y/N, y/n
# between <>, () or [], e.g. <Y/n>, (y/N), [y/n]
# and gives y as a response
cli.output.confirmation.regex[0]=[\\[\\(<][yY]\\/[nN][>\\)\\]]
cli.output.confirmation.response[0]=y
cli.output.confirmation.regex[1]=[\\[\\(<](?:no|NO|yes|YES)[\\/,](?:yes|YES|no|
NO)[>\\)\\]]
cli.output.confirmation.response[1]=yes
cli.output.confirmation.regex[2]=\\(Yes\\/No\\) \\[No\\]
cli.output.confirmation.response[2]=Yes
cli.output.confirmation.regex[3]=\\[Yes\\/No\\] \\[Yes\\]
cli.output.confirmation.response[3]=Yes

##
# Error Results
##
cli.output.error.regex[0]=% \\d+:?
cli.output.error.regex[1]=%Error:?
cli.output.error.regex[2]=syntax error:
cli.output.error.regex[3]=aborted:
cli.output.error.regex[4]=Uncommitted changes found, commit them\\?
\\[yes\\/no\\/CANCEL\\]
cli.output.error.regex[5]=% Invalid word detected at
cli.output.error.regex[6]=% No such interface type
cli.output.error.regex[7]=Invalid parameter
cli.output.error.regex[8]=This MEP is not enabled
cli.output.error.regex[9]=^(?!.*Current).*Error:
cli.output.error.regex[10]=% Incomplete command
cli.output.error.regex[11]=failed: Bad file permissions
cli.output.error.regex[12]=File not found\\.
cli.output.error.regex[13]=Operation timed out\\.
cli.output.error.regex[14]=% EVC
cli.output.error.regex[15]=Waiting for firmware update to complete
cli.output.error.regex[16]=% Cold reload in progress, please stand by\\.
cli.output.error.regex[17]=% Invalid input detected
cli.output.error.regex[18]=The ping source is invalid\\.
cli.output.error.regex[19]=Authentication Denied\\. Invalid user credentials!
cli.output.error.regex[20]=Authentication Failed\\. Invalid authentication
method configuration!
cli.output.error.regex[21]=Incorrect input
cli.output.error.regex[22]=Incorrect password!
cli.output.error.regex[23]=Invalid user name\\. User name can be up to
cli.output.error.regex[24]=Error!
cli.output.error.regex[25]=while clearing the ARP Cache
cli.output.error.regex[26]=Command not found
cli.output.error.regex[27]=Failure Information
cli.output.error.regex[28]=Value is out of range
cli.output.error.regex[29]=Aborted:
cli.output.error.regex[30]=% Cannot set a port-channel member
cli.output.error.regex[31]=already exists
cli.output.error.regex[32]=Set failed
cli.output.error.regex[33]=Cannot exit
cli.output.error.regex[34]=Invalid command
cli.output.error.regex[35]=System error
cli.output.error.regex[36]=is not valid
cli.output.error.regex[37]=% Unknown command\\.
cli.output.error.regex[38]=bad command.*\\(line \\d column \\d\\)

DATACOM 204.0119.47 – OUTUBRO/2022 184


DmView – Instalação Configuração do DmView

cli.output.error.regex[39]=failure:

##
# Clean characters from commands
##
# (\\x1B7)?(\\x9B|\\x1B\\[)[0-?]*[ -\\/]*[@-~](\\x1B[=>]\\r?)* : matches
possible ASCII Escape Sequences
# .\\x08 \\x08 : matches backspace sequence found in
some devices ("<firstleter>\b \b")
cli.output.clean.regex[0]=(\\x1B7)?(\\x9B|\\x1B\\[)[0-?]*[ -\\/]*[@-
~](\\x1B[=>]\\r?)*
cli.output.clean.regex[1]=.\\x08 \\x08

#
# Replace the matching sequence pattern with a response value.
# (\\r+ +\\r?| +\\r+ +\\r) : matches a special characters sequence in some devices
(e.g: \r\r \r)
#
cli.output.replace.regex[0]=(\\r+ +\\r?| +\\r+ +\\r)
cli.output.replace.response[0]=\\\n

As seções “Text Based Protocol Prompts configuration”, “Terminal Paging”, “Confirmation” e “Error Results”,
foram incluídas recentemente, segue abaixo um resumo sobre cada uma delas.

• Text Based Protocol Prompts configuration: Suporte aos caracteres do prompt de comando de
qualquer equipamento, baseado nos parâmetros “cli.output.prompt.regex” cadastrados. Tem como
objetivo identificar, de acordo com as regex cadastradas, quando o equipamento está pronto para
receber os comandos e quando finalizou a execução dos mesmos. Caso existam novos caracteres de
prompt de comando, basta cadastrar uma nova regex com os mesmos.
o cli.output.prompt.exclusion: Parâmetro que configura exceções de prompt por comando.
Exemplo:
 cli.output.prompt.exclusion[0][0]=show log.*
 cli.output.prompt.exclusion[0][1]=show tech-support.*

O primeiro número, é o índice do prompt configurado que será desconsiderado para o


comando referido. O segundo número é sequencial, para tornar possível a configuração de uma
lista de comandos referente a um mesmo índice de prompt.

• Terminal Paging: Suporte a terminal paging nos equipamentos. Antes, quando o resultado de um
comando executado por um CLI Template era maior que uma tela, ficava travado aguardando uma
ação do usuário para continuar a rolagem resultante das configurações aplicadas. Agora, todo o
resultado pode ser apresentado direto, de acordo com as expressões regulares configuradas neste
parâmetro.
• Confirmation: Suporte a comandos de confirmação. Antes, quando o resultado de um comando
executado por um CLI Template necessitava de uma confirmação do usuário, ficava travado
aguardando uma ação do usuário para continuar a aplicação das configurações. Agora, pode ser
configurado para quando, por exemplo, for solicitada uma confirmação do tipo “(y/n)”, seja preenchido
com “y” automaticamente. As expressões regulares deste parâmetro irão identificar os comandos
esperados durante a execução dos comandos e a resposta padrão para eles.

DATACOM 204.0119.47 – OUTUBRO/2022 185


DmView – Instalação Configuração do DmView

• Error Results: Suporte à validação (erro de uma aplicação) por regex (expressões regulares) conhecidas
para saber de forma clara e correta se uma aplicação de template foi bem-sucedida ou não. Caso uma
nova mensagem de erro seja implementada no equipamento, ela pode ser incluída na forma de
expressão regular neste parâmetro.

Parâmetros ocultos:

• nms.cli.activation.service.protocols: Protocolos utilizados para realizar a conexão nos equipamentos e


envio dos comandos de um template CLI. A ordem dos protocolos no parâmetro também é
considerada. O valor padrão é “SSH, TELNET”.
• nms.template.application.pool-size: Número máximo de aplicações de templates simultâneos. O valor
padrão é “50”.
• nms.template.device.options.pool-size: Número máximo de extração de variáveis simultâneas em uma
aplicação de template. O valor padrão é “100”.
• nms.template.device.options.timeout-in-minutes: Tempo máximo (timeout) em minutos para
carregamento das variáveis de uma aplicação de template. O valor padrão é “2”.
• nms.security.crypto.passphrase: Utilizado para encriptar senhas salvas no banco de dados. O valor
padrão é “password”.

7.3.14 PORTAL WEB

# Portal Web

##

# Define the field delimiter for all CSV reports in the Web Portal

# Values Accepted: Any char, but must be different from CSV text enclosure
char

# Default Value: ,

#nms.web.portal.report.csv.field.delimiter=,

# Define the text enclosure for all CSV reports in the Web Portal

# Values Accepted: Any char, but must be different from CSV field delimiter
char

# Default Value: "

#nms.web.portal.report.csv.text.enclosure="

A partir da versão 9.4, é possível configurar quais os caracteres desejados para fazer a separação de dados dos
relatórios quando gerados em formato “.CSV”. Desta forma, é possível configurar os parâmetros:

• nms.web.portal.report.csv.field.delimiter: Deve ser configurado com o caractere desejado para separar


os dados de cada coluna, exemplo: "Device ID","Device Model","Slot","Port","Port Model". O valor
padrão deste parâmetro é “,”.

DATACOM 204.0119.47 – OUTUBRO/2022 186


DmView – Instalação Configuração do DmView

• nms.web.portal.report.csv.text.enclosure: Deve ser configurado com o caractere desejado para


delimitar o início e fim de um dado de uma coluna, exemplo: "Device ID". O valor padrão deste
parâmetro é “.

7.4 SERVIÇOS DO DMVIEW

7.4.1 SERVIÇOS INSTALADOS EM WINDOWS


Os serviços instalados pelo DmView são os seguintes:
• NMS ACS: Serviço ACS (Auto Configuration Server), monitora e gerencia remotamente os CPEs
habilitados para TR-069;
• NMS Apache Tomcat: É o servidor Web, utilizado para fazer a interface entre o Web browser do usuário e
o DmView, a fim de serem gerados os relatórios;
• NMS DCB: Serviço de backup de configuração dos equipamentos;
• NMS Event: Serviço utilizado para recebimento de traps dos elementos e tradução para um evento do
DmView;
• NMS JMS: Servidor de mensagens do DmView;
• NMS MongoDB: Serviço que inicia o MongoDB utilizado pelo DmView;
• NMS Poller: Serviço responsável pelo polling nos equipamentos;
• NMS Probe: Serviço que faz a coleta de dados de performance dos equipamentos;
• NMS Provisioning: Serviço responsável pelo provisionamento automático de circuitos;
• NMS Services: Serviço responsável pelas ferramentas web CLI Template e Device Config, merge de
circuitos, descoberta de equipamentos utilizado pela janela "Add/Delete Multiple Devices", importação
de circuitos do tipo "Nx2M" e "EFM G.SHDSL", carregamento da licença do DmView, atualização dos
equipamentos "DmOS" e "DM2300", "GPON Profile Management", provisionamento "GPON" e device
information, mapas, alarmes e outras janelas de status dos equipamentos “DmOS” e “DM2300”.

A partir do DmView 9.3, os serviços Apache DS, TrapD e XML-RPC foram descontinuados. A
partir do DmView 9.4, os serviços Activation Service, Circuit Merge, CLI Template, Device
Discovery, Dynamic Device Config Client Web, Importation, Inventory, License Server, NES,
Profile e Status foram substituídos pelo único serviço “NMS Services”.

7.4.2 INICIANDO OS SERVIÇOS DO DMVIEW EM WINDOWS


Antes de iniciar os serviços do DmView, os pré-requisitos abaixo devem ter sido instalados.
• Instalação do Oracle XE;
• Instalação do MongoDB;

Para iniciar os serviços do DmView em Windows, acesse “Iniciar→ Programas→ DmView→


Enterprise→Services”. Será exibida a janela de serviços do Windows, todo os serviços que iniciam com “NMS”
são serviços do DmView. Para iniciar um serviço, basta clicar com o botão direito em cima do serviço e
selecionar “Start”.
DATACOM 204.0119.47 – OUTUBRO/2022 187
DmView – Instalação Configuração do DmView

Os serviços do DmView possuem uma ordem para serem iniciados, além de também
possuírem dependências entre eles, logo, para iniciar os serviços de forma e ordem correta,
siga os passos da seção START SERVICES em Windows.

7.4.3 START SERVICES EM WINDOWS


Depois de o DmView estar instalado e configurado, conforme as seções anteriores, e os pré-requisitos iniciados,
basta iniciar o DmView através de “Iniciar→ Programas→ DmView→ Enterprise→Start Services”.
Os serviços iniciados pelo “Start Services” são os seguintes:
• NMS ACS;
• NMS Apache Tomcat;
• NMS DCB;
• NMS Event;
• NMS JMS;
• NMS Poller;
• NMS Probe;
• NMS Provisioning;
• NMS Services;

Verifique que o serviço “NMS MongoDB” (serviço utilizado pelo MongoDB) esta iniciado
antes de iniciar de executar o start services através da janela de Serviços do Windows. Caso
o mesmo esteja desligado, deverá ser iniciado manualmente.

7.4.4 STOP SERVICES EM WINDOWS


Para parar todos os serviços do DmView, acesse “Iniciar→ Programas→ DmView→ Enterprise→Stop Services”.
Os serviços parados pelo “Stop Services” são os seguintes:
• NMS ACS;
• NMS Apache Tomcat;
• NMS DCB;
• NMS Event;
• NMS JMS;
• NMS NES;
• NMS Poller;
• NMS Probe;
• NMS Provisioning;
• NMS Services;

O serviço “NMS MongoDB” (serviço utilizado pelo MongoDB) não é parado pelo “Stop
Services”.

DATACOM 204.0119.47 – OUTUBRO/2022 188


DmView – Instalação Configuração do DmView

7.4.5 SERVIÇOS INSTALADOS EM LINUX


Os serviços instalados pelo DmView são os seguintes:
• nms.acs: Serviço ACS (Auto Configuration Server), monitora e gerencia remotamente os CPEs
habilitados para TR-069.
• nms.web: É o servidor Web, utilizado para fazer a interface entre o Web browser do usuário e o DmView,
a fim de serem gerados os relatórios;
• nms.dcb: Serviço de backup de configuração dos equipamentos;
• nms.event: Serviço utilizado para recebimento de traps dos elementos e tradução para um evento do
DmView;
• nms.jms: Servidor de mensagens do DmView;
• nms.mongo: Serviço que inicia o MongoDB utilizado pelo DmView;
• nms.poller: Serviço responsável pelo polling nos equipamentos;
• nms.probe: Serviço que faz a coleta de dados de performance dos equipamentos;
• nms.provisioning: Serviço responsável pelo provisionamento automático de circuitos;
• nms.services: Serviço responsável pelas ferramentas web CLI Template e Device Config, merge de
circuitos, descoberta de equipamentos utilizado pela janela "Add/Delete Multiple Devices", importação
de circuitos do tipo "Nx2M" e "EFM G.SHDSL", carregamento da licença do DmView, atualização dos
equipamentos "DmOS" e "DM2300", "GPON Profile Management", provisionamento "GPON" e device
information, mapas, alarmes e outras janelas de status dos equipamentos “DmOS” e “DM2300”.

A partir do DmView 9.3, os serviços Apache DS, TrapD e XML-RPC foram descontinuados. A
partir do DmView 9.4, os serviços Activation Service, Circuit Merge, CLI Template, Device
Discovery, Dynamic Device Config Client Web, Importation, Inventory, License Server, NES,
Profile e Status foram substituídos pelo único serviço “NMS Services”.

7.4.6 INICIANDO OS SERVIÇOS DO DMVIEW EM LINUX


Antes de iniciar os serviços do DmView, os pré-requisitos abaixo devem ter sido instalados.

• Instalação do Oracle XE;


• Instalação do MongoDB;

Para se trabalhar com serviços é necessário estar logado como usuário root. Todos os serviços do DmView são
acessados através da linha de comando:

/etc/init.d/nms.<serviço> <comando>

Em que:

• <serviço> pode ser substituído por: jms, poller, event, web, probe, dcb.
• <comando> pode ser substituído por: start, stop e status.

Para se iniciar o serviço jms, como root se deve digitar:

DATACOM 204.0119.47 – OUTUBRO/2022 189


DmView – Instalação Configuração do DmView

/etc/init.d/nms.jms start

Vale notar que NUNCA é necessário colocar um “e” comercial (&) no final do comando pois
o prompt é liberado assim que o serviço subir.

7.4.7 NMS ALLSERVICES START EM LINUX


Depois do DmView estar instalado e configurado, conforme as seções anteriores, e os pré-requisitos iniciados,
basta iniciar o DmView através de “/etc/init.d/nms.allservices start”.

Os serviços iniciados pelo “nms.allservices start” são os seguintes:


• nms.acs;
• nms.poller;
• nms.event;
• nms.provisioning;
• nms.dcb;
• nms.probe;
• nms.web;
• nms.jms;
• nms.services.

O “NMS MongoDB” (serviço utilizado pelo MongoDB) deve ser iniciado manualmente, antes
dos serviços do DmView, através do comando “/etc/init.d/nms.mongo start”.

7.4.8 NMS ALLSERVICES STOP EM LINUX


Para parar todos os serviços do DmView, utilize o comando “/etc/init.d/nms.allservices stop”.
Os serviços parados pelo “nms.allservices stop” são os seguintes:
• nms.acs;
• nms.poller;
• nms.event;
• nms.provisioning;
• nms.dcb;
• nms.probe;
• nms.web;
• nms.jms;
• nms.services.

DATACOM 204.0119.47 – OUTUBRO/2022 190


DmView – Instalação Configuração do DmView

O serviço “NMS MongoDB” (serviço utilizado pelo MongoDB) não é parado pelo
“nms.allservices stop”.

7.4.9 MEMÓRIA UTILIZADA PELOS SERVIÇOS


Após instalar o DmView, os serviços estarão configurados por padrão com a memória máxima de acordo com
a tabela abaixo:

Serviço Memória máxima Nome do arquivo em “\DmView\conf”

NMS ACS 512 MB wrapperNMSACS.conf

NMS Apache Tomcat 1024 MB wrapperTomcat.conf

NMS DCB 512 MB wrapperDcb.conf

NMS Event 512 MB wrapperEvent.conf

NMS JMS 512 MB wrapperJMS.conf

NMS MongoDB ** **

NMS Poller 768 MB wrapperPoller.conf

NMS Probe 256 MB wrapperProbe.conf

NMS Provisioning 512 MB wrapperProvisioning.conf

NMS Services 512 MB wrapperNMSServices.conf

NMS Unack Events* 1024 MB wrapperUnackEvents.conf

*O serviço “NMS Unack Events” não é instalado por padrão.

**O serviço “NMS MongoDB” é apenas um atalho para iniciar o MongoDB, utilizando as configurações de
memória realizadas no MongoDB.

Para editar os valores de memória a serem utilizados, edite o arquivo correspondente ao serviço (listado na
tabela acima) e altere os valores “wrapper.java.initmemory” (memória inicial) e “wrapper.java.maxmemory”
(memória máxima):

wrapper.java.initmemory=100

wrapper.java.maxmemory=128

DATACOM 204.0119.47 – OUTUBRO/2022 191


DmView – Instalação Configuração do DmView

Ao realizar um upgrade de versão do DmView de uma versão anterior a 9.6 para uma versão
posterior ou igual a 9.6, os valores de memória customizados nos arquivos listados acima,
voltarão para os valores de fábrica. Após a realização do upgrade, será salvo um arquivo
”.zip” no diretório “C:\Program Files\DmView\backup\” ou “/opt/DmView/backup” com
todos os arquivos de configuração de antes do upgrade.

7.4.9.1 AJUSTE DE MEMORIA PARA O SERVIÇO NMS ACS


O serviço NMS ACS (Auto Configuration Server) é utilizado para monitorar e gerenciar remotamente os CPEs
habilitados para TR-069. Por padrão, na instalação do DmView, a configuração de memória deste serviço é de
512 MB, permitindo o gerenciamento de até 10000 CPEs (somatório de CPEs Datacom e Multivendor).

Para gerenciar um número maior de CPEs, a configuração de memória do serviço deve estar de acordo com a
tabela abaixo.

Número de CPEs TR-069 (Datacom + Multivendor) Memória


Até 10000 512 MB
De 10001 a 20000 1024 MB
De 20001 a 30000 1536 MB
Mais de 30001 Consultar a Datacom

Para alterar a configuração de memória do serviço NMS ACS, edite o arquivo “wrapperNMSACS.conf”, localizado
no diretório “conf” da instalação do DmView (“C:\Program Files\DmView\conf” – diretório padrão de instalação
no Windows ou “/opt/DmView/conf” – diretório padrão de instalação no Linux).

#Application Memory Parameters

wrapper.java.initmemory=64

wrapper.java.maxmemory=512

Altere o parâmetro “wrapper.java.maxmemory” colocando o número de memória de acordo com o número de


CPEs TR-069 a serem gerenciados. Exemplo: Para gerenciar 15000 CPEs, “wrapper.java.maxmemory=1024”.

Após alterar o parâmetro e salvar o arquivo, reinicie o serviço NMS ACS para que a alteração seja efetivada.

7.4.10 MEMÓRIA UTILIZADA PELA LOGIN


Após instalar o DmView, o login do usuário estará configurado por padrão com a memória máxima de 1GB.

A partir da versão 9.6, para alterar a memória máxima utilizada pela login, edite o arquivo “C:\Program
Files\DmView\bin\login.properties”.

O conteúdo do arquivo para Windows é:

DATACOM 204.0119.47 – OUTUBRO/2022 192


DmView – Instalação Configuração do DmView

LOGIN_INITMEMORY=256

LOGIN_MAXMEMORY=1024

Para alterar a memória a ser utilizada, basta alterar o número após os parâmetros “LOGIN_INITMEMORY” e
“LOGIN_MAXMEMORY”. O “LOGIN_INITMEMORY” é o valor inicial de memória que o login do DmView irá iniciar e
vai ir aumentando a memória quando necessário até chegar no valor configurado no “LOGIN_MAXMEMORY”.
Caso seja necessária mais memória que o valor configurado em “LOGIN_MAXMEMORY”, a operação que estiver
sendo realizada no momento que o valor máximo for atingido poderá não ser concluída e será registrado um
erro no log de login do usuário. Exemplo:

• Login com memória inicial de 1024MB e memória máxima de 2048MB =


LOGIN_INITMEMORY=1024
LOGIN_MAXMEMORY=2048

*O parâmetro para configuração da memória não aceita vírgula nem ponto, logo, para configurar 1,5GB deve
ser usado 1500M.

Ao realizar um upgrade de versão do DmView de uma versão anterior a 9.6 para uma versão
posterior ou igual a 9.6, o valor de memória customizado no login, voltará para os valores
de fábrica. Após a realização do upgrade, será salvo um arquivo ”.zip” no diretório
“C:\Program Files\DmView\backup\” com todos os arquivos de configuração de antes do
upgrade. Verifique os valores que foram configurados anteriormente e refaça as
configurações.

Caso o upgrade seja de uma versão posterior ou igual a 9.6 para uma versão posterior, as
configurações de memória customizadas serão mantidas.

7.4.10.1 EM CASO DE UPGRADE DE UMA VERSÃO ANTERIOR A 9.6 PARA UMA VERSÃO POSTERIOR OU IGUAL A 9.6
Nas versões anteriores a 9.6, os parâmetros de memória de login eram configurados no arquivo "C:\Program
Files\DmView\bin\StartMenu_Login.bat", logo, se foi realizado um upgrade de uma versão anterior a 9.6 para
uma versão superior ou igual a 9.6, o arquivo a ser consultado para reconfigurar os parâmetros de memória é
este, que após a realização do upgrade, ficará salvo no arquivo ”.zip” no diretório “C:\Program
Files\DmView\backup\” com todas as configurações de antes do upgrade.

Exemplo de conteúdo do arquivo “StartMenu_Login.bat”:

@echo off

cd %~dp0

call StartNms login –Xmx2G "-XX:MaxPermSize=128m"

DATACOM 204.0119.47 – OUTUBRO/2022 193


DmView – Instalação Configuração do DmView

O número após o parâmetro “-Xmx” determina a memória configurada para a login na versão anterior a 9.6 e
equivale ao valor de “LOGIN_MAXMEMORY” da versão posterior ou igual a 9.6, logo, altere o arquivo “C:\Program
Files\DmView\bin\login.properties” do DmView após o upgrade, substituindo os valores de memória.

LOGIN_INITMEMORY=1024

LOGIN_MAXMEMORY=2048

7.5 LOGS DO DMVIEW


Os logs do DmView são salvos, por padrão, no diretório “C:\Program Files\DmView\log” no Windows ou
“/opt/DmView/log” no Linux.

Neste diretório será criado um subdiretório para cada serviço do DmView, contendo os logs referentes ao
mesmo.

Os logs são muito importantes para realizar a análise de um problema que está ocorrendo no DmView, logo, ao
abrir um chamado com o suporte Datacom os logs serão necessários.

7.5.1 CONFIGURAÇÃO DO LOG

7.5.1.1 NÍVEL DOS LOGS


A configuração de qual o nível de logs (INFO, WARN, ERROR, FATAL, TRACE, DEBUG) serão registrados, está no
arquivo “logback.xml”, localizado no diretório “conf” da instalação do DmView.

Para alterar, basta trocar o nível (level) que o log está configurado para o nível desejado e esperar em torno de
20 segundos para a configuração ser aplicada e o log ser registrado com o novo nível configurado.

Ex:

<root level="${rootLevel:-DEBUG}">

7.5.1.2 LOG DE TR-069 FILTRANDO A ONU PELO IP/HOSTNAME


Para gerar um log detalhado de TR-069 de uma ONU em específico, pode-se fazer uma configuração no
“logback.xml”.

Adicione a propriedade abaixo no “logback.xml”:

<property name="nms.tr-069-acs.filter.cpeIdentifier" value="<ip/hostname TR-069 da ONU>" />

Ex:

<property name="nms.tr-069-acs.filter.cpeIdentifier" value="172.25.144.105" />

DATACOM 204.0119.47 – OUTUBRO/2022 194


DmView – Instalação Configuração do DmView

E configure o log “nms.tr069” para o nível de “DEBUG” (por padrão é “WARN”):

<logger name="nms.tr069" level="DEBUG" />

Salve o arquivo. Após 20 segundos, abra o log “tr-069-acs.log” localizado na pasta “log\tr-069-acs”. Deve ser
[2020-05-14 10:52:13,446] [qtp895599632-27] [nms.tr069.acs.cpe.session.CwmpSessions] DEBUG:
|172.25.144.105/WAITING_INFORM| Returning CWMP session.

exibido o log em DEBUG filtrando pelo hostname configurado:

Após fazer a captura de logs desejada da ONU usando o modo “DEBUG”, configure
novamente o nível de log para “WARN” e comente a linha da propriedade referente à ONU
colocando o caracter “#” na frente da linha no arquivo “logback.xml”, assim, evita-se a
geração de logs desnecessários que estarão ocupando espaço em disco do servidor.

7.5.2 CAPTURANDO OS LOGS DO DMVIEW COM O SCRIPT GENERATETROUBLESHOOTINGLOGS


A partir da versão 9.5 foi adicionada a instalação do DmView o script “generateTroubleshootingLogs.bat”,
localizado na pasta “C:\Program Files\DmView\bin” do Windows ou o script “generateTroubleshootingLogs.sh”
localizado na pasta “/opt/DmView/bin” do Linux.

Este script tem como objetivo coletar todos os logs do DmView, salvar na pasta “C:\Program
Files\DmView\troubleshooting_logs” no Windows ou “/opt/DmView/troubleshooting_logs” no Linux e gerar um
arquivo “.zip” no diretório “C:\Program Files\DmView\” no Windows ou “/opt/DmView/” no Linux. O arquivo
“.zip” terá no nome o formato “troubleshooting_logs_yyyy-MM-dd_HH-mm-ss.zip” onde yyyy=ano, MM=mês,
dd=dia, HH=hora, mm=minuto, ss=segundo, exemplo: “troubleshooting_logs_2017-06-21_12-33-39.zip”.

A cada execução do script, a pasta “\DmView\troubleshooting_logs” será sobrescrita, mas os arquivos “.zip”
antigos serão mantidos, cada um com a sua data e hora de geração.

Para que o script consiga realizar a compactação do diretório “troubleshooting_logs”, é


necessário ter instalado no Windows o software “7zip” ou no Linux o pacote “zip”. Se os
softwares de compactação não estiverem instalados no sistema operacional (Windows ou
Linux) o arquivo “.zip” não será gerado e a pasta “troubleshooting_logs” será sobrescrita,
perdendo os logs gerados na execução anterior do script.

7.5.3 CAPTURANDO OS LOGS DO DMVIEW COM O SCRIPT


GENERATETROUBLESHOOTINGLOGSWITHMASKEDIPS
O script “generateTroubleshootingLogsWithMaskedIps” funciona exatamente da mesma forma que o
“generateTroubleshootingLogs”, com a diferença que será feita uma substituição dos primeiros três octetos de
todos os IPs contidos nos arquivos de logs por X.Y.Z, ou seja, um IP com valor “192.168.0.1” será mudado para

DATACOM 204.0119.47 – OUTUBRO/2022 195


DmView – Instalação Configuração do DmView

“X.Y.Z.1”. Esta funcionalidade foi desenvolvida para ser utilizada por clientes que desejam confidencialidade
nos IPs que utilizam para os seus equipamentos/servidores.

No Windows o script tem o nome “generateTroubleshootingLogsWithMaskedIps.bat” e está localizado no


diretório “C:\Program Files\DmView\bin”. No Linux o script tem o nome
“generateTroubleshootingLogsWithMaskedIps.sh” e está localizado no diretório “/opt/DmView/bin”.

7.5.3.1 MASCARANDO PARÂMETROS EXTRAS DO LOG

7.5.3.1.1 Executando o script passando por parâmetro as palavras que se deseja substituir
Além de mascarar os IPs contidos nos logs, pode-se mascarar outros parâmetros, basta digitá-los após a
chamada do script:

• Ex: “generateTroubleshootingLogsWithMaskedIps.bat hostname W2008DMVIEW-02”. Neste exemplo, as


palavras “hostname” e “W2008DMVIEW-02”, seriam substituídas por “XXXXX1”, “XXXXX2”,
respectivamente.

Figura 206 – Mascaramento de parâmetros extras 1

Também podem ser mascaradas palavras com espaço, basta utilizar as aspas (“”) para juntar várias
palavras/caracteres a serem substituídas.

Figura 207 – Mascaramento de parâmetros extras 2

DATACOM 204.0119.47 – OUTUBRO/2022 196


DmView – Instalação Configuração do DmView

O número de parâmetros extras máximo é de 8000 caracteres.

7.5.3.1.2 Executando o script passando por parâmetro um arquivo de texto


Também pode-se passar por parâmetro, um arquivo de texto com todas as strings que se deseja substituir, para
isso, basta executar o comando como no exemplo abaixo.

• Ex: “generateTroubleshootingLogsWithMaskedIps.bat /f TextToReplace.txt”. Neste exemplo, todas as


palavras contidas no arquivo TextToReplace.txt, serão substituídas por “XXXXX1”, “XXXXX2”, “XXXXX3” e
assim sucessivamente.

Figura 208 – Mascaramento de parâmetros extras por arquivo

Ao final da execução, serão exibidas todas as substituições de palavras realizadas, como na imagem abaixo.

Figura 209 – Mascaramento de parâmetros extras por arquivo – final da execução


DATACOM 204.0119.47 – OUTUBRO/2022 197
DmView – Instalação Configuração do DmView

7.6 CREDENCIAIS DE ACESSO AOS BANCOS DE DADOS ORACLE E MONGODB


Os arquivos utilizados pelo DmView para realizar o acesso aos bancos de dados Oracle e MongoDB são
respectivamente: “dbcredentials.txt” e “mongo.conf”, ambos localizados no subdiretório conf do diretório de
instalação do DmView (Ex: “C:\Program Files\DmView\conf”).

Ao abrir os arquivos com um editor de textos, os campos de usuário e senha estarão criptografados, conforme
os exemplos abaixo.

Exemplo do conteúdo criptografado do arquivo “dbcredentials.txt”:

db.username=ENC(FZyu+VgtdfPoJ1FDkOFWQA==)
db.password=ENC(jVVmV4TLvjIMrql7gG8idw==)

Exemplo do conteúdo criptografado do arquivo “mongo.conf”:

#Server Mongo Database


nms.db.mongodb.hosts=localhost
nms.db.mongodb.default.port=27017
nms.db.mongodb.dbname=ENC(0WOX3mELL7aadpNYgf+18g==)
nms.db.mongodb.user=ENC(reGwqp+TOgBinUmDxTfgsg==)
nms.db.mongodb.password=ENC(lNiGFHt/tkqNKSX0MFyW+A==)

Para visualizar o conteúdo descriptografado destes arquivos e editar, deve ser utilizada a ferramenta
“runCredentialsEditor.bat” para Windows ou “runCredentialsEditor.sh” para Linux, localizada no subdiretório
“bin\admin” do diretório de instalação do DmView (Ex: “C:\Program Files\DmView\bin\admin”). Para acessar este
diretório é necessário a permissão de administrador do sistema operacional Windows ou Linux.

DATACOM 204.0119.47 – OUTUBRO/2022 198


DmView – Instalação Configuração do DmView

Figura 210 – Acesso ao editor de credenciais

Ao executar como administrador o arquivo “runCredentialsEditor.bat” para Windows ou


“runCredentialsEditor.sh” para Linux, será exibida a janela “Database Credentials” com as credenciais utilizadas
para realizar as conexões com os bancos Oracle e MongoDB. O checkbox “Show Password” pode ser marcado
para exibir as senhas.

Figura 211 – runCredentialsEditor

DATACOM 204.0119.47 – OUTUBRO/2022 199


DmView – Instalação Configurações complementares

Além de visualizar as credenciais que estão sendo utilizadas para realizar as conexões de bancos de dados,
pode-se editá-las, caso tenham sido alteradas e configuradas previamente corretamente nos bancos de dados
(Oracle e/ou MongoDB). Para alterar, basta substituir os campos desejados e clicar no botão “Save”,
automaticamente será criado um novo valor criptografado, substituindo o valor antigo, nos arquivos
(“dbCredentials.txt” e/ou “mongo.conf”) correspondentes.

Antes de realizar a alteração das credenciais de conexão do Oracle e/ou MongoDB, deve
ter sido feita a alteração destas credenciais no próprio banco de dados, realizando a
criação/cópia/clone dos dados usados pelo DmView para essas novas credenciais. Caso
não tenha sido realizado este procedimento prévio e as credenciais forem alteradas, o
DmView ficará inoperante. Consulte o suporte da Datacom antes de fazer essas alterações.

8 CONFIGURAÇÕES COMPLEMENTARES

8.1 CONFIGURAÇÃO DO POLLING AGENDADO


O polling passou a ter flexibilidade de configuração por agendamento. Nas versões anteriores, era possível
definir o intervalo entre pollings na rede (exemplo: de 6 em 6 horas); agora passa a ser possível definir
horários/datas específicas (exemplo: todo dia a partir das 01h00). A forma de configurar é a mesma do sistema
Cron do Linux.
O formato Cron é o utilizado para definir a frequência por agendamento do polling. É uma lista de cinco campos
individuais separados por espaços: minuto, hora, dia, mês, dia da semana. Mês e nomes de segunda a sexta
pode ser dado como as três primeiras letras em inglês.

Exemplo de uso:

0**** No começo de cada hora de todos os dias.

0 8-10 * * * 8, 9 e 10 horas de cada dia.

0/30 8-10 * * * 8:00, 8:30, 9:00, 9:30 e 10 horas de cada dia.

0 9-17 * * MON-FRI Das 9 às 17h dias de semana.

0 0 25 12 ? Todo dia de Natal à meia noite.

8.2 CONFIGURAÇÃO DO POLLER DISTRIBUÍDO


Com a funcionalidade de polling distribuído, é possível ter mais de uma instância de poller ativa, visando
distribuir a execução de pollings entre estas instâncias, aliviando assim a carga dos servidores que rodam a
poller. Quando houver mais de uma instância de poller rodando, a primeira instância que subiu será
considerada a instância master. Alguns serviços somente serão inicializados por esta instância, pois necessitam
de somente um ponto de entrada. Um exemplo é a execução dos pollings agendados na aplicação: ela é

DATACOM 204.0119.47 – OUTUBRO/2022 200


DmView – Instalação Configurações complementares

disparada na instância master e as requisições de pollings decorrentes são distribuídas entre as outras
instâncias.
Se a instância master cair, uma das instâncias remanescentes então assumirá este papel.
As configurações do poller distribuído são realizadas no arquivo hazelcast.conf localizado na pasta conf da
instalação DmView. Este arquivo possui as seguintes informações:
• hazelcast.jmx=false
Habilita/desabilita a monitoração de MBeans do Hazelcast.

• hazelcast.group.name=nms
• hazelcast.group.password=nms
Credenciais do cluster (não tem relação com as credencias do banco).

• hazelcast.network.port=5701
Configuração da porta que será utilizada pelo Hazelcast para comunicação com o cluster.

• hazelcast.network.outbound.ports=38001-38010
Portas outbound que serão utilizadas (também para comunicação com o cluster).

• hazelcast.network.join.tcp-ip.members=127.0.0.1:5701
• hazelcast.network.join.tcp-ip.connection-timeout-seconds=10
Configuração dos membros do cluster (endereço IPv4) e timeout a ser utilizado durante a negociação de um
novo nodo para entrada no cluster. Na opção members todas as máquinas que serão membros do cluster
devem estar especificadas. Para isso, devem-se colocar todos os endereços IP e respectivas portas
(<IP>:<porta>), separados por vírgula (por exemplo, um valor válido para esse campo é considerando três
máquinas com os endereços 1.1.1.1, 1.1.1.2 e 1.1.1.3) seria:
hazelcast.network.join.tcp-ip.members=1.1.1.1:5701,1.1.1.2:5701,1.1.1.3:5701

É altamente recomendável que TODOS os arquivos hazelcast.conf das máquinas que farão parte do cluster
tenham a mesma configuração. Isso evitará problemas tais como:

• Diferenças na identificação do cluster; em outras palavras, parâmetros hazelcast.group.name e


hazelcast.group.password diferentes em cada arquivo hazelcast.conf;
• Conflito na definição de porta a ser utilizada pelo Hazelcast, ou seja, parâmetros hazelcast.network.port
diferentes;
• Conflito na definição dos membros do cluster, principalmente no parâmetro
hazelcast.network.join.tcp-ip.members.

8.2.1 CONFIGURAÇÃO DE UMA INSTÂNCIA DE POLLER DISTRIBUÍDO


Foi adicionado um parâmetro de configuração no arquivo nms.conf presente na raiz da instalação DmView,
chamado nms.poller.distributed.enabled cujo valor será true ou false.

Altere o parâmetro nms.poller.distributed.enabled para true.


DATACOM 204.0119.47 – OUTUBRO/2022 201
DmView – Instalação Configurações complementares

Edite o arquivo hazelcast.conf localizado na pasta conf da instalação DmView, atualizando-o com a informação
dos outros servidores configurados como Slave, conforme elucidado acima.

Inicie o serviço NMS Poller. Na pasta de logs do DmView, dentro de poller será criado um arquivo chamado
hazelcast.log. Este arquivo contém todas as informações sobre as instâncias conectadas no servidor. A cada
queda ou nova conexão este arquivo é atualizado com a seguinte informação:

Members [1] {

Member [172.23.5.200]:5701 this

Com a entrada de novas instâncias do Poller, esta mensagem é incrementada. Exemplo:

Members [3] {

Member [172.23.5.201]:5701 this

Member [172.23.5.202]:5701

Member [172.23.5.203]:5701

8.3 INICIALIZAÇÃO AUTOMÁTICA DO DMVIEW


A partir da versão 9.7 é possível configurar o DmView para iniciar automaticamente com o sistema operacional
em Windows e Linux.

Antes de realizar as configurações para o DmView iniciar automaticamente, é importante verificar se o DmView
está inciando e funcionando no modo padrão (manual). Siga os passos da seção Serviços do DmView.

8.3.1 WINDOWS
Acesse “Iniciar→ Programas→ DmView→ Enterprise→ Services”. Os serviços “NMS Apache Tomcat, NMS DCB,
NMS Event, NMS JMS, NMS MongoDB, NMS Poller, NMS Probe, NMS Provisioning e NMS Services” são os serviços
utilizados pelo DmView e devem ser configurados com o tipo de inicialização automática.

DATACOM 204.0119.47 – OUTUBRO/2022 202


DmView – Instalação Configurações complementares

Figura 212 – Serviços

Selecione cada um dos serviços, clique com o botão direito e selecione “Propriedades”.

Figura 213 - Serviços – Propriedades

DATACOM 204.0119.47 – OUTUBRO/2022 203


DmView – Instalação Configurações complementares

Selecione o tipo de inicialização automática para todos os serviços.

Figura 214 - Serviços - Inicialização automática

Todos os serviços devem estar com o tipo de inicialização automática.

Figura 215 - Serviços - Inicialização automática

Após a reinicialização do sistema operacional, o DmView deve iniciar automaticamente.

DATACOM 204.0119.47 – OUTUBRO/2022 204


DmView – Instalação Configurações complementares

8.3.2 LINUX
A configuração de inicialização automática do DmView no Linux será realizada usando a ferramenta
“Chkconfig”.

Antes de realizar a configuração, digite “sudo chkconfig –list” para verificar os serviços que já estão configurados
para a inicialização automática.

Figura 216 - Chkconfig list

Ao lado do nome do serviço, existem os números “0,1,2,3,4,5 e 6” e a configuração “on” ou “off”. Os números são
relacionados ao runlevel do sistema operacional segundo a tabela abaixo.

Tabela 29 - Chkconfig levels

Run Level Mode Action


0 Halt Shuts down system.
1 Single-User Mode Does not configure network interfaces, start daemons, or allow non-
root logins.
2 Multi-User Mode Does not configure network interfaces or start daemons.
3 Multi-User Mode with Starts the system normally.
Networking
4 Undefined Not used/User-definable
5 X11 As runlevel 3 + display manager(X)
6 Reboot Reboots the system

Para configurar os serviços do DmView para iniciarem com o sistema operacional Linux, navegue até o diretório
de instalação do DmView “/opt/DmView/bin” (default) e execute “sudo ./auto_start_services.sh”.

Figura 217 - Auto start services

DATACOM 204.0119.47 – OUTUBRO/2022 205


DmView – Instalação Configurações complementares

Digite novamente “sudo chkconfig –list” para verificar os serviços do DmView foram configurados para a
inicialização automática. Os serviços do DmView devem estar configurados como “on” nos levels de 2 a 5.

Figura 218 - Chkconfig dos serviços do DmView

8.4 CONFIGURAÇÃO DA SENHA DO ACS SERVER


A partir da versão 11.0 do DmView, o serviço NMS ACS foi incluído na instalação do DmView. O serviço ACS (Auto
Configuration Server) é utilizado para monitorar e gerenciar remotamente os CPEs habilitados para TR-069.

O serviço NMS ACS pode ser instalado em uma máquina separada do restante dos serviços do DmView. Para
realizar esta instalação, entre em contato com o suporte da Datacom (suporte@datacom.com.br).

O usuário e senha padrão para conexão ao serviço NMS ACS é “administrator/administrator”. Para alterar esta
senha, siga os passos:

1. No servidor onde o serviço NMS ACS está instalado, abra um browser e digite a URL:
“https://127.0.0.1:7547/changeSysPassword?newPass={novasenha}“ substituindo “{novasenha}” pela
senha que você deseja alterar. Será solicitado o usuário/senha atual, que tem como padrão
“administrator/administrator”. Após a alteração deve ser exibida a mensagem: “Password updated
successfully for the user administrator”. OBS: Não é possível alterar o usuário de conexão, ele sempre
será “administrator”.
2. Depois de alterar a senha do NMS ACS, é necessário fazer a alteração da senha que é utilizada pelos
outros serviços do DmView para conectar no NMS ACS. Para isso, execute o “runCredentialEditor.bat”
localizado em “C:\Program Files\DmView\bin\admin”. Será exibida uma tela com as credenciais

DATACOM 204.0119.47 – OUTUBRO/2022 206


DmView – Instalação Configurações complementares

utilizadas pelo DmVIew. Altere a senha do TR-069 ACS para a mesma configurada no NMS ACS,
procedimento realizado no passo 1, e clique no botão “Save”.
3. Acesse a tela TR-069 ACS no DmView Maestro através do menu “Administração → TR-069 ACS” e clique
no botão “Atualizar Status”. Se as alterações de senhas foram feitas com sucesso, o status deve ser
“online”.

Rua América, 1000 | 92990-000 | Eldorado do Sul | RS | Brasil


+55 51 3933 3000
comercial@datacom.com.br
suporte@datacom.com.br
www.datacom.com.br

DATACOM 204.0119.47 – OUTUBRO/2022 207

Você também pode gostar