Proceso de actualización de modulos OMK para NMIS9

  •  Módulos OPMANTEK.

Para realizar la instalación de  NMIS9 y módulos compatibles,  es necesario descargarlos de la página oficial https://opmantek.com/network-management-download/

En su defecto contactar a su representante local solicitando la ultima versión de los modulos disponibles. A continuación se muestra el proceso para subir los paquetes al servidor y la asignación de permisos de ejecución para su correcta instalación.

NOTA:

De no poder utilizar el comando wget, el paquete puede ser agregado al servidor mediante sftp 

modulos y permisos
[root@localhost ~]# mkdir Modulos_update_nmis9
[root@localhost ~]# cd Modulos_update_nmis9/
[root@localhost Modulos_update_nmis9]# ll
total 103684
-rw-r--r-- 1 root root   4419277 ene 17 21:31 nmis9-9.1.1-1.run
-rw-r--r-- 1 root root 101751643 ene 17 21:32 opEvents-Linux-x86_64-3.2.2 (1).run
[root@localhost Modulos_update_nmis9]#
[root@localhost Modulos_update_nmis9]# chmod +x *.*
[root@localhost Modulos_update_nmis9]# ll
total 103684
-rwxr-xr-x 1 root root   4419277 ene 17 21:31 nmis9-9.1.1-1.run
-rwxr-xr-x 1 root root 101751643 ene 17 21:32 opEvents-Linux-x86_64-3.2.2 (1).run
[root@localhost Modulos_update_nmis9]#


  • Respaldo de información de operación OMK.

Este paso es necesario ya que se realizara el respaldo del la configuracion realizada por el cliente en los modulos, por ejemplo, mapas, servicios de negocios, tableros, etc., para esto requerimos exportar la información antes de iniciar con la actualizacion de los modulos.

BKP Contenido opCharts
/usr/local/omk/bin/opcharts-cli.exe act=export-{charts|maps|dashboards|business|pollers|collector}

[root@localhost tmp]#
[root@localhost tmp]# mkdir opCharts
[root@localhost tmp]# cd opCharts/
[root@localhost opCharts]# mkdir dashboards
[root@localhost opCharts]# cd dashboards/
[root@localhost dashboards]#
[root@localhost dashboards]# /usr/local/omk/bin/opcharts-cli.exe act=export-dashboards name="prueba 336" file="/tmp/opCharts/dashboards/prueba 336_$(hostname)_$(date +%Y%m%d)_dashboards.json"
[root@localhost dashboards]# /usr/local/omk/bin/opcharts-cli.exe act=export-dashboards name="prueba 338" file="/tmp/opCharts/dashboards/prueba 338_$(hostname)_$(date +%Y%m%d)_dashboards.json"
[root@localhost dashboards]# /usr/local/omk/bin/opcharts-cli.exe act=export-dashboards name="prueba v335" file="/tmp/opCharts/dashboards/prueba v335_$(hostname)_$(date +%Y%m%d)_dashboards.json"
[root@localhost dashboards]# /usr/local/omk/bin/opcharts-cli.exe act=export-dashboards name="tablero 335" file="/tmp/opCharts/dashboards/tablero 335_$(hostname)_$(date +%Y%m%d)_dashboards.json"
[root@localhost dashboards]#
[root@localhost dashboards]#cd ..
[root@localhost opCharts]# mkdir maps
[root@localhost opCharts]# cd maps/
--Snip--
--Snip--


  • Inicio de instalador de Modulos OMK.

Para la instalacion de los modulos OMK (opCharts, opEvents, opConfig, opReports, opFlow, opHA) es de vital importancia validar las configuraciones realizadas en cada modulo.

Para comenzar con la instalacion de los modulos requerimos detener los servicios de cada modulo, esto para evitar errores durante la actualizacion:

Servicios
service mongod stop
service omkd stop
service httpd stop
service opflowd stop
service opeventsd stop
service opchartsd stop
service opconfigd stop


Una vez detenido los servicios procedemos a renombrar la carpeta /usr/local/omk esto para realizar una instalacion limpia, con esto evitaremos conflictos entre paquetes, servicios, funciones, etc.

Renombrar directorio OMK
[root@localhost usr]# cd /usr/local/
[root@localhost local]# mv omk omk_BKP
[root@localhost local]# 


Procedemos con la instalación de los modulos, en este ejemplo se inicio con opCharts, para esto tenemos que aceptar las opciones del instalador.

Instalacion de opCharts
[root@localhost Modulos_update_nmis9]# ./opCharts-Linux-x86_64-4.1.3.run
Verifying archive integrity... All good.
Uncompressing opCharts 4.1.3  100%
detected OS flavour RedHat/CentOS


++++++++++++++++++++++++++++++++++++++++++++++++++++++
opCharts (4.1.3) Installation script
++++++++++++++++++++++++++++++++++++++++++++++++++++++

This installer will install opCharts into /usr/local/omk.
To select a different installation location please rerun the
installer with the -t option.

Ok to proceed with installation?
Type 'y' or <Enter> to accept, or 'n' to decline: y


++++++++++++++++++++++++++++++++++++++++++++++++++++++
performing pre-installation steps
++++++++++++++++++++++++++++++++++++++++++++++++++++++


Al finalizar la instalacion se procede a validar la GUI en la vista de modulos, como el siguinte ejemplo:

GUI OMK


GUI opCharts


Se procede a instalar el modulo opEvents.

Instalacion de opEvents
[root@localhost Modulos_update_nmis9]# ./opEvents-Linux-x86_64-3.1.0-1.run
Verifying archive integrity... All good.
Uncompressing opEvents 3.1.0  100%
detected OS flavour RedHat/CentOS


++++++++++++++++++++++++++++++++++++++++++++++++++++++
opEvents (3.1.0) Installation script
++++++++++++++++++++++++++++++++++++++++++++++++++++++

This installer will install opEvents into /usr/local/omk.
To select a different installation location please rerun the
installer with the -t option.

Ok to proceed with installation?
Type 'y' or <Enter> to accept, or 'n' to decline: y


++++++++++++++++++++++++++++++++++++++++++++++++++++++
performing pre-installation steps
++++++++++++++++++++++++++++++++++++++++++++++++++++++

Downgrading of Opmantek applications is not supported.

The backups made during this installation of opEvents ()
must be used for rollbacks and downgrades back to this version.

Do you want to perform a backup of your installation directory?
Type 'y' or <Enter> to accept, or 'n' to decline: y


Al finalizar la instalacion se procede a validar la GUI en la vista de modulos.


GUI opEvents

opEvents


El procedimiento para instalar los modulos faltantes es similar, se requiere de aceptar cada opción del instalador hasta concluir, de esta forma podremos tener el Sistema de monitoreo NMIS actualizado asi mismo los Modulos OMK, en la siguinte imagen se visualizan los modulos instalados correctamente en el servidor. 

Validación GUI OMK


  • Estandarización de configuración OMK.

Para tener operando correctamente los modulos es necesario reemplazar, editar y actualizar los archivos pertenecientes al directorio /usr/local/omk/..

En este caso se realiza la modificación manual del archivo opCommon.json de los parámetros diferentes comparado con el opCommon.nmis de la versión NMIS8.

La siguiente lista ejemplo, muestra los cambios que se hacen en el archivo y los parámetros pueden cambiar de acuerdo a las configuraciones de cada cliente:

/usr/local/omk/conf/opCommon.json
++++++++++++++++++++++++++++++++++++++++++++++++++++++
//-- /usr/local/omk/conf/opCommon.json
**	CONFIG	**
'auth_login_motd' => 'Customer',
 
'auth_token_maxage' => 'duracion_de_tokens' #milisegundos
 
"auth_token_key" : [
#colocar todos los tokens que existen
],
 
'auth_method_1' => 'token',
'auth_method_2' => 'htpasswd',
'auth_method_3' => 'openaudit',
 
'opcharts_custom_map_icons' => {
#colocar las rutas de los iconos personalizados si existen
},
 
"opcharts_header_logo" : "/ruta/al/logo.png",
 
"opflow_url_base" : "http://x.x.x.x/"
"opevents_url_base" : "http://x.x.x.x/",
"nmis_host_base" : "http://x.x.x.x",
"opflowsp_url_base" : "http://x.x.x.x",
"opreports_url_base" : "http://x.x.x.x/",
"opreports_opcharts_url_base" : "http://x.x.x.x:8042",
"opconfig_url_base" : "http://x.x.x.x/",
"opconfig_audit_import_url_base" : "http://x.x.x.x:8042/omk/open-audit/",
"opflow_url_base" : "http://x.x.x.x/",
"opevents_url_base" : "http://x.x.x.x/",
 
"<nmis9_dir>" : "/usr/local/nmis9",
"nmis9_dir" : "/usr/local/nmis9",
"nmis9_cgi_url_base" : "/cgi-nmis9",
"<nmis9_logs>" : "/usr/local/nmis9/logs"
      "load_applications" : [ #asegurarse que los módulos que se colocan aquí, sean los instalados
         "opCharts",
         "opEvents",
         "opConfig",
         "opReports",
         "opHA"
      ],
"db_name" : "omk_shared",
"omkd_max_requests" : 10000,


Con estos cambios garantizamos la funcionalidad correcta de los modulos.


  • Customización de mapas opCharts OMK.

Para poder visualizar la información generada por el cliente es necesario importar los archivos, con esto lograremos ver los mapas, tableros, pollers, etc..

importado de contenido opCharts
/usr/local/omk/bin/opcharts-cli.exe act=import-{charts|maps|dashboards|business|pollers|collector}

######################################################
Importado de Datos
######################################################
[root@localhost maps]# ll
total 1564
/tmp/opCharts/maps/1_01.cnoc.lab.com_20200929_maps.json
/tmp/opCharts/maps/inte_01.cnoc.lab.com_20200929_maps.json
/tmp/opCharts/maps/interfaces1_01.cnoc.lab.com_20200929_maps.json
/tmp/opCharts/maps/interfaces_01.cnoc.lab.com_20200929_maps.json
--Snip--
--Snip--
[root@localhost maps]# /usr/local/omk/bin/opcharts-cli.exe act=import-maps name="inte" file="/tmp/opCharts/maps/inte_01.cnoc.lab.com_20200929_maps.json" force=true
[root@localhost maps]# /usr/local/omk/bin/opcharts-cli.exe act=import-maps name="interfaces1" file="/tmp/opCharts/maps/interfaces1_01.cnoc.lab.com.com_20200929_maps.json" force=true
[root@localhost maps]#


  • Validación Modulós OMK. 

Acceder a la GUI para validar la funcionalidad de los archivos importados.


Validación mapas


Validacion Mapas