FORMATO

Manual de Usuario

CDIGO

FOR.EP.PRO-007

VERSIN

2
26/11/07

FECHA

USO INTERNO

Pg. 1 de 15

Nota Importante: Si el manual ser publicado en la Intranet, es necesario solicitar a Metodologa y Procesos de Sistemas el
cdigo que le corresponde antes de gestionar las firmas

AAA.BB.CCC-001
Ttulo del Documento
CUADRO DE CONTROL DE FIRMAS
FIRMAS
REVISIN SISTEMAS

APROBACIN REA USUARIA

LDER DE PROYECTO

LDER USUARIO

Nombre y firma

Nombre y firma

DISTRIBUCIN

ARCHIVO

Gerencia de Calidad,
Procesos y Medio
Ambiente

Especialista de Calidad,
Procesos y Medio
Ambiente del rea
Tcnica

ACTUALIZACIN

NIVEL DE ACCESO

Especialista de Calidad, INTERNO

Procesos y Medio
Acceso a nivel interno
Ambiente del rea
Tcnica
EXTERNO
Este documento es de
carcter confidencial

INFORMACIN PROPIEDAD DE TELEFNICA MXICO

Todos los derechos reservados

FORMATO
Manual de Usuario

CDIGO

FOR.EP.PRO-007

VERSIN

2
26/11/07

FECHA

USO INTERNO

Pg. 2 de 15

VERSION

10

FECHA

dd/mm/aa

HOJA RESUMEN DE MODIFICACIONES

VERSIN 2, FECHA 05/12 /2011
PUNTO

CAMBIOS RESPECTO DE LA VERSIN ANTERIOR

Se agregan modificaciones para script equipos y se anexa configuracin para crontab

INFORMACIN PROPIEDAD DE TELEFNICA MXICO

Todos los derechos reservados

FORMATO
Manual de Usuario
USO INTERNO

CDIGO

FOR.EP.PRO-007

VERSIN

FECHA

26/11/07

Pg. 3 de 15

NDICE

1
2
3
4
4.1

OBJETIVO............................................................................................................... 3
MBITO DE APLICACIN..........................................................................................3
GLOSARIO DE TRMINOS Y ACRNIMOS...................................................................3
DESARROLLO......................................................................................................... 3
Conceptos generales................................................................................................................ 3

4.2
Componentes........................................................................................................................... 3
5
TAREAS................................................................................................................. 3
5.1

Mantenimiento de equipos (/usr/local/sbin/utilExtras/equipos.py)..............................................3

5.2

Mantenimiento de usuarios (/usr/local/sbin/utilExtras/usuarios.py)............................................3

5.3

Lectura de CDRs (/usr/local/sbin/utilExtras/leerCdr.py)..............................................................3

5.4....................................................................................................................................................... 3
5.5

Interfaces de provisin (/usr/local/sbin/utilExtras/verInterProv.py)..............................................3

5.6....................................................................................................................................................... 3
5.7

Verificar acceso de red (/usr/local/sbin/utilExtras/verSnmp.py)..................................................3

5.8....................................................................................................................................................... 3
5.9

Listado de archivos generados (/usr/local/sbin/utilExtras/verificar.py)........................................3

5.10..................................................................................................................................................... 3
5.11

Listado de archivos generados (/usr/local/sbin/utilExtras/verificar.py)........................................3

5.12..................................................................................................................................................... 3
6
TAREAS PROGRAMADAS..........................................................................................3
6.1

Generar catalogo de interfaces (genCatInter.py )......................................................................3

6.2

Generar catalogo de interfaces (genCdrDia.sh).........................................................................3

6.3....................................................................................................................................................... 3
6.4

Generar catalogo de interfaces (actualiza.py)...........................................................................3

6.5....................................................................................................................................................... 3
6.6

Generar catalogo de interfaces (enviarInfoInter.py)...................................................................3

6.7

Generar catalogo de interfaces (enviarInfo.py)..........................................................................3

6.8
Generar catalogo de interfaces (actInterProv.py )......................................................................3
7
ANEXOS................................................................................................................ 3
7.1

Anexo A.................................................................................................................................... 3

7.2

Anexo B.................................................................................................................................... 3
INFORMACIN PROPIEDAD DE TELEFNICA MXICO
Todos los derechos reservados

FORMATO
Manual de Usuario
USO INTERNO

INFORMACIN PROPIEDAD DE TELEFNICA MXICO

Todos los derechos reservados

CDIGO

FOR.EP.PRO-007

VERSIN

FECHA

26/11/07

Pg. 4 de 15

FORMATO
Manual de Usuario
USO INTERNO

CDIGO

FOR.EP.PRO-007

VERSIN

FECHA

26/11/07

Pg. 5 de 15

1 OBJETIVO
Este documento describe en forma detallada el como mantener en operacin la plataforma de cricket
ptimamente.

2 MBITO DE APLICACIN
Debido que es una aplicacin en donde el usuario es el personal de operaciones el manual
trabajara sobre los aspectos tcnicos y de soporte de cricket

3 GLOSARIO DE TRMINOS Y ACRNIMOS

SNMP

CSV

4 DESARROLLO
4.1

Conceptos generales
El cricket es una plataforma que combina varios elementos de software y de hardware que permiten
recolectar estadsticas de trafico del Core para almacenarlas, graficarlas y generar CDRs que sern enviadas
a Jntex para su tarificacin.
Esta funciona sobre un cluster activo pasivo y un storage compartido donde reside la informacin de
trafico y el software de cricket.
En cuanto a software contamos con 4 elemento principales:

Cricket
Apache Server
SFTP Server
Python Scripting

Cricket es un elemento dentro de la red de Core que realiza consultas snmp cada 5 minutos a los elementos
registrados en el, con el fin de recolectar informacin del trafico generado por cada una de sus interfaces. Esta
informacin es almacena en archivos rrd para su posterior tratamiento.
Los binarios, configuracin y datos de cricket estn alojados en el storage, solamente los scripts de control
de cluster y herramientas de operacin se encuentran en cada disco.
Cricket se ejecuta como un demonio controlado por Sun Cluster (cricket-rg) que en caso de fail-over
designara el control del cluster al otro nodo.
INFORMACIN PROPIEDAD DE TELEFNICA MXICO
Todos los derechos reservados

FORMATO
Manual de Usuario

CDIGO

FOR.EP.PRO-007

VERSIN

FECHA

USO INTERNO

4.2

Componentes

5 TAREAS
5.1

Mantenimiento de equipos (/usr/local/sbin/utilExtras/equipos)

INFORMACIN PROPIEDAD DE TELEFNICA MXICO

Todos los derechos reservados

26/11/07

Pg. 6 de 15

FORMATO
Manual de Usuario
USO INTERNO

1) Permite agregar un equipo al control de cricket.

INFORMACIN PROPIEDAD DE TELEFNICA MXICO

Todos los derechos reservados

CDIGO

FOR.EP.PRO-007

VERSIN

FECHA

26/11/07

Pg. 7 de 15

FORMATO
Manual de Usuario
USO INTERNO

2) Permite eliminar un equipo al control de cricket.

3) Actualiza un equipo para agregar interfaces o quitarlas.

INFORMACIN PROPIEDAD DE TELEFNICA MXICO

Todos los derechos reservados

CDIGO

FOR.EP.PRO-007

VERSIN

FECHA

26/11/07

Pg. 8 de 15

FORMATO
Manual de Usuario
USO INTERNO

4) Cambia la etiqueta de grupo para un equipo

INFORMACIN PROPIEDAD DE TELEFNICA MXICO

Todos los derechos reservados

CDIGO

FOR.EP.PRO-007

VERSIN

FECHA

26/11/07

Pg. 9 de 15

FORMATO
Manual de Usuario

CDIGO

FOR.EP.PRO-007

VERSIN

FECHA

USO INTERNO

5.2

26/11/07

Pg. 10 de 15

Mantenimiento de usuarios (/usr/local/sbin/utilExtras/usuarios.py)

1) Permite agregar un usuario de acceso web a cricket.

1) Solo se agrega el mrt / mrn de usuario a la BBDD de cricket. No se almacenan contraseas, ya que
esto es validado directamente con active directory.
2) Elimina usuarios web de cricket

5.3

Lectura de CDRs (/usr/local/sbin/utilExtras/leerCdr)

5.4

1) Despliega informacin del CDR generado por Jntex para la fecha indicada como argumento en el formato
DDMMYY.
2) El formato del archivo original es de texto separado por | y de ancho fijo.

5.5

Interfaces de provisin (/usr/local/sbin/utilExtras/verInterProv.py)

INFORMACIN PROPIEDAD DE TELEFNICA MXICO

Todos los derechos reservados

FORMATO
Manual de Usuario

CDIGO

FOR.EP.PRO-007

VERSIN

FECHA

USO INTERNO

26/11/07

Pg. 11 de 15

5.6

1) Imprime la lista de las interfaces que actualmente se encuentran generando CDRs

5.7

Verificar acceso de red (/usr/local/sbin/utilExtras/verSnmp.py)

5.8

1) Proporciona una forma sencilla y automtica de verificar acceso a los equipos, validando existencia del
equipo en el archivo /etc/hosts, comprobando por medio de un ping y que se pueda acceder por
SMNP
1) Los
equipos
a
verificar
tendrn
que
ser
indicados
en
el
archivo
/usr/local/sbin/utilExtras/conf/equipos.list
2) Este script se tiene que ejecutar con el usuario root

INFORMACIN PROPIEDAD DE TELEFNICA MXICO

Todos los derechos reservados

FORMATO
Manual de Usuario
USO INTERNO

5.9

CDIGO

FOR.EP.PRO-007

VERSIN

2
26/11/07

FECHA

Pg. 12 de 15

Listado de archivos generados (/usr/local/sbin/utilExtras/verificar.py)

5.10

1) Imprime una lista de todos los archivos generados por la plataforma y los enviados por Jntex
1) Los archivos listados, sern los que en ese momento se encuentres fsicamente en el disco

5.11

Listado de archivos generados (/usr/local/sbin/utilExtras/verificar.py)

5.12

2) Imprime una lista de todos los archivos generados por la plataforma y los enviados por Jntex
1) Los archivos listados, sern los que en ese momento se encuentres fsicamente en el disco

INFORMACIN PROPIEDAD DE TELEFNICA MXICO

Todos los derechos reservados

FORMATO
Manual de Usuario
USO INTERNO

CDIGO

FOR.EP.PRO-007

VERSIN

2
26/11/07

FECHA

Pg. 13 de 15

6 TAREAS PROGRAMADAS
6.1

Generar catalogo de interfaces (genCatInter.py )

Este script genera el archivo del catalogo de interfaces y lo actualiza en la BBDD de cricket en la
tabla interfaces.
Para esto el script escanea la carpeta /cricketdata/datos de forma recursiva, buscando los archivos
de la interfaces que actualmente se estn recolectando, excluyendo las que contengan en su nombre de
archivo la siguientes cadenas: "device", "chassis", "qos", "cpu", "layer", "output", "atm.
Si el archivo de la interface no existe fsicamente, se elimina de la tabla y si existe fsicamente y no
esta en la tabla, se inserta con un valor de 0 en el campo generar. El archivo es un cvs con los campos
router, interface
Hora de ejecucin:
Una vez al da a las 00:00 hrs.

6.2

Generar catalogo de interfaces (genCdrDia.sh)

6.3
Este script genera el CDR que ser enviado a Jntex y que contiene la informacin del trafico
generada por las interfaces marcadas para tarificacin. El CDR contiene informacin del da anterior a la
ejecucin del script y contiene los siguientes campos: Fecha-hora, Router, Interface, In, Out en formato csv
Los CDRs se se almacena en las carpetas:
/cricketdata/ftp/historico/envios (CDRs se eliminaran una ves enviados)
/cricketdata/ftp/historico/respaldo (Son los CDRs de respaldo)
Hora de ejecucin:
Una vez al da a las 05:00 hrs.

6.4

Generar catalogo de interfaces (actualiza.py)

6.5
Este script actualiza en la BBDD de cricket el campo de location de la tabla routers. El valor se
obtiene haciendo una consulta SNMP al campo sysLocation del equipo a donde pertenece la interface.
Hora de ejecucin:
Una vez al da a las 00:00 hrs.

INFORMACIN PROPIEDAD DE TELEFNICA MXICO

Todos los derechos reservados

FORMATO
Manual de Usuario
USO INTERNO

6.6

CDIGO

FOR.EP.PRO-007

VERSIN

FECHA

26/11/07

Pg. 14 de 15

Generar catalogo de interfaces (enviarInfoInter.py)

Este script envia el catalogo de interfaces a Jntex via SFTP.

El catalogo de interfaces es un archivo de texto plano csv con pares tipo: router, interface. Este
archivo es generado por el script genCatInter.py
Hora de ejecucin:
Cada 30 minutos de 01:00 hrs. A 06:00 hrs.
6.7

Generar catalogo de interfaces (enviarInfo.py)

Este script envia los CDRs de trafico generado por el script genCdrDia.sh a Jntex via SFTP.
Si los CDRs por alguna razon o problema no pudieron ser enviados el dia que le corresponde, se
enviaran al dia siguiente.
Hora de ejecucin:
Cada 30 minutos de 05:30 hrs. A 09:00 hrs.
6.8

Generar catalogo de interfaces (actInterProv.py )

Este script se encarga de leer el archivo generado por Jntex el cual es un archivo cvs con pares
tipo router, interface, marcarlo para facturacin en la BBDD de cricket.
Es importante mencionar que el script marca al inicio todas las interfaces de la BBDD con un 0 (no
facturacin) y con un 1 (facturacin) las que estn listadas en el archivo.
Hora de ejecucin:
Cada 30 minutos de 00:30 hrs. A 05:00 hrs.

INFORMACIN PROPIEDAD DE TELEFNICA MXICO

Todos los derechos reservados

FORMATO
Manual de Usuario

CDIGO

FOR.EP.PRO-007

VERSIN

FECHA

USO INTERNO

6.9

26/11/07

Pg. 15 de 15

Verifica que el demonio de alertas de CPU este en funcionamiento (cpuDaemon.sh)

Verifica que el demonio encargado de procesar las alertas de cpu y de memoria, se este ejecutando, en
caso contrario lo lanza nuevamente
Hora de ejecucin:
Cada 5 minutos durante todo el da.

7 ANEXOS
7.1

7.2

Anexo A
< Adjuntar y/o referenciar informacin relevante relacionada con
documento >

el contenido del presente

Anexo B
< Adjuntar y/o referenciar informacin relevante relacionada con el contenido del presente documento >

INFORMACIN PROPIEDAD DE TELEFNICA MXICO

Todos los derechos reservados