VIVAitwiki - Contribuciones del usuario [es]

Portal de administración VIVAit

2018-12-18T10:21:30Z

Imatarrubias: /* Destinos externos */

{| class="wikitable"
|-
! '''Producto: '''!! '''''VIVA'''''it Call
'''''VIVA'''''it Suite

|-
|}



== Introducción ==
El '''''portal de administración de la plataforma ''VIVA''it ''''' proporciona a administradores un interfaz gráfico basado en web, para la gestión y configuración de los productos '''''VIVA'''''it Call y '''''VIVA'''''it Suite.
El portal está dividido en cinco secciones:
* '''General''': Este apartado permite la gestión y configuración general de la plataforma.
* '''''VIVA''it Call''': combina las funciones típicas de las centralitas tradicionales para entornos corporativos con el mundo IP y las aplicaciones. Se gestionan todos los cambios y las configuraciones orientados a la telefonía corporativa (rutas, aprovisionamiento, facilidades, dispositivos...).
* '''''VIVA''it Response''': pestaña orientada a la configuración de las locuciones y música en espera.
* '''''VIVA''it Suite ACD+''': gestiona la solución para Contact Center. En este apartado se administran todos los parámetros de configuración (colas, VDNs, monitores, campañas...) del producto '''''VIVA'''''it Suite.
* '''''VIVA''it Record''': En este apartado gestionaremos los servicios de grabación de la plataforma, típicamente asociados a producto '''''VIVA'''''it Suite.

Para acceder al '''''portal de administración de la plataforma ''VIVA''it''''' se hace a través de un navegador con un enlace de la siguiente forma:

http://servidor:8180/Vivait-Call/

donde "servidor" será el nombre o dirección IP de la ubicación del portal de usuario.

=== Búsquedas ===

En el '''''portal de administración de la plataforma ''VIVA''it ''''' existen dos tipos de búsqueda:

* '''Búsqueda con filtros''': sirven para restringir las búsquedas sobre la base de datos y mostrar los datos concretos que cumplan las condiciones según los campos de filtrado rellenados. Si no se rellena ningún campo mostrará el contenido apropiado con todos los resultados almacenados en la base de datos según la ventana en la que nos encontremos.

En algunas ventanas aparece el botón [[File:Boton-Filtros.jpg]] que permite ampliar los campos disponibles para realizar la búsqueda.

[[File:Mas-Filtros-Desplegada.jpg]]

Escribimos el valor que queremos buscar y pulsamos el botón [[File:Boton-Buscar.jpg]]

Si pulsamos "buscar" sin especificar valores en los campos se presentarán todos los registros de la Base de Datos.
Cuando los botones están disponibles y hay datos en pantalla cualquier valor en los campos de búsqueda realizará una búsqueda sobre los resultados mostrados.

* '''Búsqueda sobre resultados''': restringe aun más la búsqueda concreta que hagamos sobre los resultados mostrados tras una búsqueda previa con filtro.

[[Archivo:0 Ejemplo busquedas.png|950px|center]]

Observaciones sobre ambas búsquedas:

* No distingue mayúsculas de minúsculas

* No distingue acentos (tildes).

* No permite la búsqueda mediante expresiones regulares.

=== Borrado de Datos ===

Cuando se realiza un borrado (masivo o no) de los datos correspondientes a varios registros (objetos) en una ventana, no son eliminados físicamente en ese momento, sino que se marcan como ocultos, de forma que se considera que no se deben utilizar más en la base de datos. Esto es así en la mayoría de los casos, podríamos necesitar los datos generados por los objetos borrados. Por ejemplo, si borramos varias extensiones, en un futuro, podríamos necesitarlas, saber que usuario la tenía asignadas, si estuvo asignada en varios terminales, etc.

Si tiene los permisos necesarios [[#Permisos_a_Usuarios| ver sección Permisos]], podrá visualizar en la parte superior derecha de la ventana abierta un botón llamado "Borrar". En caso contrario, no podrá realizar el borrado de datos.

Los pasos a seguir para un borrado de datos, son los siguientes:

* '''Realizar una [[#Búsquedas | búsqueda]] de aquel registro de la base de datos que se desee eliminar:''' En nuestro ejemplo, seria el usuario llamado "Borrado".
[[Archivo:BorradoSeleccion.png|center|750px]]

* '''Marcar los registros que deseamos borrar:''' con el ratón hacer un solo click sobre el registro a borrar o Control+click para seleccionar varios, y pulsar el botón "Borrar" nos saltara el siguiente aviso:

[[File:mensajeBorrado2.png|300px|center]]
:En el caso que no se seleccione nada mostrar el siguiente mensaje de aviso:

[[File:mensajeSeleccionBorrado2.png|300px|center]]

* '''Confirmar la eliminación del registro:''' Una vez confirmado, se resaltará con color rosáceo el registro eliminado en los resultados de busqueda.

[[Archivo:BorradoDatos.png|center|750px]]

==== Recuperación Masiva de datos ====
Si tiene los permisos necesarios [[#Permisos_a_Usuarios| ver sección Permisos]], seleccionando los registros borrados (rosáceo) , podrá visualizar en la parte superior derecha de la ventana abierto un botón llamado "Recuperar". En caso contrario, no podrá realizar la recuperación de datos.

[[Archivo:BorradoDatos.png|center|950px]]

Una vez seleccionado los registros borrados que deseamos recuperar, pulsando el botón "Recuperar" aparecerá el siguiente mensaje de aviso:

[[File:RecuperadoDatosBorrado2.png|center]]
La confirmación de la recuperación, hará que el registro deje de estar oculto para la base de datos, y además se visualizará como el resto de registros en la ventana. Como se visualiza en la siguiente imagen:

[[Archivo:RecuperadoDatosBorrado.png|center|950px]]

[[#Borrado_de_Datos | Volver arriba]]
[[wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit]]

=== Duplicado de Datos ===
Nuestra plataforma ofrece la posibilidad de hacer una copia de un objeto. Esto se debe a la necesidad que surge a veces de crear objetos que contengan sino igual, la mayoría, de los datos de otro objeto existente.

Si tiene los permisos necesarios ([[#Permisos_a_Usuarios| ver sección Permisos]]), podrá visualizar en la parte superior derecha de la ventana abierta un botón llamado "Duplicar". En caso contrario, no podrá realizar el duplicado de datos.

Los pasos a seguir para un duplicado de datos, son los siguientes:
* '''Realizar una [[#Búsquedas | búsqueda]] de aquel registro de la base de datos que se desee duplicar.'''
[[Archivo:CapturaBotonDuplicar.png|center|800px]]

* '''Marcar registro que deseamos duplicar: '''con el ratón hacer un solo click sobre el registro a duplicar y pulsar el botón "Duplicar" nos mostrarla la ventana de crear un nuevo objeto, teniendo relleno aquellos campos del objeto original a duplicar, y añadiendo el texto "(Copia)" delante de aquellos campos donde sea necesario para crear el nuevo objeto duplicado :
[[Archivo:CapturaDuplicado.png|center]]
:En el caso que no se seleccione nada mostrar el siguiente mensaje de aviso:

[[File:DuplicarAvisoSeleccion2.png|center]]
* '''Rellenar los datos del objeto duplicado necesarios y pulsar el botón "Guardar".'''
{|
|-
|
'''Nota: la plataforma interpreta la copia como un objeto totalmente distinto al original duplicado, diferenciándose principalmente por su campo id.'''
|}

==== '''Campos clave cuando duplicamos datos''' ====

Es importante tener en cuenta que cuando duplicamos datos en el portal y éstos tienen campo de clave (usuarios, extensiones, buzones, Salas de Meet,...) combiene volver a teclear la clave y no conformarnos con pulsar la tecla intro.

[[#Duplicado_de_Datos | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

== General ==
El contenido de la pestaña General es el siguiente:

[[File:PestañaGeneral2.png|center]]

[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver arriba]
=== Configuración LDAP ===

LDAP (“Lightweight Directory Access Protocol”), Protocolo de Acceso Ligero a Directorios es un protocolo de tipo cliente-servidor para acceder a un servicio de directorio. Este se encuentra condensado en el estándar de Internet, el RFC 1777.

LDAP no es una base de datos en absoluto, sino un protocolo utilizado para acceder a información almacenada en un directorio de información (también conocido como un directorio LDAP).

Un servidor LDAP es utilizado para procesar consultas y actualizaciones a un directorio de información LDAP.

Un directorio de información LDAP es un tipo de base de datos, pero no es una base de datos relacional.

Y a diferencia de una base de datos que está diseñada para procesar cientos o miles de cambios por minuto – como los sistemas de Procesamiento de Transacciones En Linea (OLTP por sus siglas en ingles) los directorios LDAP están fuertemente optimizados para el rendimiento en lectura.

La mayor ventaja de LDAP es que tu empresa puede acceder al directorio LDAP desde casi cualquier plataforma de computación, desde cualquier numero creciente de aplicaciones fácilmente disponibles para LDAP.

El protocolo LDAP es utilizable por distintas plataformas y está basado en estándares, de ese modo las aplicaciones no necesitan preocuparse por el tipo de servidor en que se hospeda el directorio. De hecho, LDAP está encontrando una más amplia aceptación a causa de ese estatus como estándar de Internet.

Ventajas en el uso de LDAP.

Un directorio LDAP destaca sobre los demás tipos de bases de datos por las siguientes características:

– Es muy rápido en la lectura de registros

– Permite replicar el servidor de forma muy sencilla y económica

– Muchas aplicaciones de todo tipo tienen interfaces de conexión a LDAP y se pueden integrar fácilmente

– Dispone de un modelo de nombres globales que asegura que todas las entradas son únicas

– Usa un sistema jerárquico de almacenamiento de información.

– Permite múltiples directorios independientes

– Funciona sobre TCP/IP y SSL

– La mayoría de aplicaciones disponen de soporte para LDAP

– La mayoría de servidores LDAP son fáciles de instalar, mantener y optimizar.

Este apartado sirve para configurar los parámetros de conexión de LDAP para poder acceder a los directorios del servicio '''''VIVA'''''it Call y gestionar su base de datos.

Si pulsamos en la pestaña ''General'' y vamos a ''Configuración LDAP'' aparece la siguiente ventana:
[[Archivo:5 Configurar LDAP.jpg|center]]
Las opciones con las que podemos encontrarnos son las siguientes:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Activar servidor LDAP'''
| | Indicar si queremos funcionar con LDAP.
| style="text-align: center;" | Si / No
|-
| font-weight: bold;" | '''Servidor'''
| | IP o nombre del host donde está el servidor LDAP.
||
|-
| font-weight: bold;" | '''Puerto'''
| | Puerto de escucha del servidor LDAP.
| | 389 por defecto
|-
| font-weight: bold;" | '''Dominio'''
| | Nombre de dominio base del LDAP.
||
|-
| font-weight: bold;" | '''Cuenta'''
| | Nombre de usuario creado en el servidor LDAP para verificar acceso.
||
|-
| font-weight: bold;" | '''Contraseña'''
| | contraseña del usuario del servidor LDAP.
||
|}

[[#Configuración LDAP | Volver a Configuración LDAP]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

=== Configuración común ===
La '''''configuración común''''' sirve para realizar la configuración general o común de la plataforma '''''VIVA'''''it. Permite definir de forma general ciertos valores para todos los usuarios de la plataforma, independientemente del nivel de acceso que tenga asignado, es decir, para la configuración de los ejes, podremos definir el nombre de cada eje hasta un máximo de 4, pero esto no quiere decir que todos los usuarios puedan ver estos ejes y puedan posteriormente configurarlos.

[[File:6COMConfiguracion.png|center]]

Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Etiqueta Cod. Cliente'''
| | Nombre dado al código del cliente.
|| Dependiendo del cliente puede ser msisdn u otra cosa.
|-
| font-weight: bold;" | '''Etiqueta 1'''
| | Denominación de primera etiqueta; su uso se limita a entornos de Contact Center.
||
|-
| font-weight: bold;" | '''Etiqueta 2'''
| | Denominación de segunda etiqueta; su uso se limita a entornos de Contact Center.
||
|-
| font-weight: bold;" | '''Versión BD'''
| | Versión de la base de datos utilizada en la plataforma.
||
|-
| font-weight: bold;" | '''Periodos comunicados(seg)'''
| | Tiempo que tardan en recibirse los comunicados enviados por los supervisores del contact center.
||
|-
| font-weight: bold;" | '''URL Sincronización'''
| | URL donde se encuentra la aplicación GeneraConf.
||
|-
| font-weight: bold;" | '''Nº Días de validez de la clave'''
| | Número de días de la clave de acceso del usuario. Actualmente no tiene funcionalidad, pero se prevee en versiones futuras.
||
|-
| font-weight: bold;" | '''Confiar en el usuario del S.O.'''
| | Es una forma de emplear el usuario del S.O para la plataforma, es decir, confiar en el usuario del sistema operativo para el registro en las diferentes aplicaciones del entorno Microsoft Windows sin pedirle la contraseña.
| | Si / No.
|-
| font-weight: bold;" | '''Expresión VDN'''
| | Expresiones regulares para establecer una numeración común a cada elemento. [[#Enlaces_de_interés | Para mas información ver Enlaces de interes ]]
||
|-
| font-weight: bold;" | '''Expresión grupos y operadoras'''
| | Expresiones regulares para establecer una numeración común a cada elemento. [[#Enlaces_de_interés | Para mas información ver Enlaces de interes ]]
||
|-
| font-weight: bold;" | '''Expresión Agente'''
| | Expresiones regulares para establecer una numeración común a cada elemento. [[#Enlaces_de_interés | Para mas información ver Enlaces de interes ]]
||
|-
| font-weight: bold;" | '''Expresión facilidad'''
| | Expresiones regulares para establecer una numeración común a cada elemento.Para mas información
[[#Enlaces_de_interés | ver Enlaces de interes ]]
||
|-
| font-weight: bold;" | '''Expresión Usuario'''
| | Expresiones regulares para establecer una numeración común a cada elemento. Para mas información [[#Enlaces_de_interés | ver Enlaces de interes ]]
||
|-
| font-weight: bold;" | '''Expresión Conferencia'''
| | Expresiones regulares para establecer una numeración común a cada elemento. Para mas información [[#Enlaces_de_interés | ver Enlaces de interés ]]
||
|-
| font-weight: bold;" | '''Nombre Eje1'''
| | Definir el nombre de eje1. [[#Ejes | Para mas información ver sección Ejes]]
||
|-
| font-weight: bold;" | '''Nombre Eje2'''
| | Definir el nombre de eje2. [[#Ejes | Para mas información ver sección Ejes]]
||
|-
| font-weight: bold;" | '''Nombre Eje3'''
| | Definir el nombre de eje3. [[#Ejes | Para mas información ver sección Ejes]]
||
|-
| font-weight: bold;" | '''Nombre Eje4'''
| | Definir el nombre de eje4. [[#Ejes | Para mas información ver sección Ejes]]
||
|-
|}

[[#Configuración común | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

=== Sedes ===

Las sedes son cada una de las dependencias en las que un cliente tenga desplegada la plataforma '''''VIVA'''''it; en una consideración más técnica, deberíamos considerar una sede como aquel entorno en el que queremos hacer control de número de llamadas simultáneas hacia el resto de la plataforma.

Una vez ingresemos a esa pantalla de "Sedes" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])
[[Archivo:1 Busqueda en General - Sedes.png|750 px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) una nueva "sede" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:7 Sedes.png|center]]

Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre de la sede (Obligatorio)
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección de la sede.
|-
| font-weight: bold;" | '''C.P.'''
| | Código Postal de la sede.
|-
| font-weight: bold;" | '''Localidad'''
| | Localidad de la sede.
|-
| font-weight: bold;" | '''Provincia'''
| | Provincia de la sede.
|-
| font-weight: bold;" | '''Ancho de Banda'''
| | El campo "ancho de banda" expresa una magnitud que dividida por el valor de la variable BA_CONSUMO_LLAMADA del dialplan del nodo dará como resultado el número máximo de llamadas simultáneas de esa sede.
Puede considerarse esa magnitud como (por ejemplo) Kbit/s...de esta forma en la sede estaríamos indicando el ancho de banda disponible en Kbit/s para cursar voz entre esa sede y el resto, y en la variable BA_CONSUMO_LLAMADA estaríamos expresando el consumo de ancho de banda en Kbit/s de cada llamada que cursemos

'''Nº llamadas = Ancho de banda / BA_CONSUMO_LLAMADA'''

Configuraremos el ancho de banda por sede en el portal de administración y el consumo que hace cada llamada en la variable '''AB_CONSUMO_LLAMADA''' del fichero '''ext_MDtel_particular.conf''' de cada nodo de conmutación; el valor por defecto es 32
|-
| font-weight: bold;" | '''Dpto'''
| | Elegir un eje (Obligatorio) . Para mas información [[#Ejes | ver sección Ejes]]
|}

[[#Sedes | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

=== Nodos ===
Los '''nodos''' son cada uno de los servidores de la plataforma '''''VIVA'''''it que encontramos en una instalación y que contienen elementos de procesamiento de voz (Centralita IP).
Existen tres tipos de nodos:

:* Nodo corporativo: para centralitas tradicionales con entornos corporativos IP y las aplicaciones.
:* Nodo call center: para los servicios típicos de call center.
:* Nodo Vivait Meet: para proporcionar servicios de Meet.

En el portal de administración de '''''VIVA'''''it solo daremos de alta nodos de estos tipos.
En un entorno grande, y pensando en términos de organización de una arquitectura ([[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Arquitectura_VIVAit Véase Arquitecturas]]) realizaremos una división funcional de nodos del estilo de:
:* Nodo de procesamiento de telefonía corporativa (en portal es nodo Corporativo)
:* Nodo de procesamiento de call center (en portal es nodo de call center)
:* Nodo gateway (en portal es nodo GW)
:* Nodo de administración: No se da de alta en el portal como nodo; contiene procesos auxiliares no relacionados directamente con la conmutación telefónica de llamadas
:* Nodo de Base de datos: No se da de alta en el portal. En entornos especialmente grandes, en los que diferenciemos en un nodo dedicado (compuesto de un servidor o de un clúster de dos servidores) la base de datos de tiempo real aparecerá este nodo

'''Funcionalidad en Nodos'''

Este apartado sirve para crear y gestionar los diferentes nodos del entorno (GW, corporativo, call center, Vivait-Meet o Corporativo+Vivait-Meet).

Una vez ingresemos a esa pantalla de "Nodos" aparecerá la búsqueda con filtros y algunos botones laterales (Borrar, Nuevo , Editar y Duplicar) que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])
[[Archivo:2 Busqueda en General - Nodos.png|800 px| center]]

La explicación de funcionalidad del botón “Borrar” está explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” está explicado genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) un nuevo "Nodo" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:


[[File:8Nodos.png|center]]

Las opciones con las que podemos encontrarnos son las siguientes:

{| class="wikitable" style= "margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;"| '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del nodo (Obligatorio).
||
|-
| font-weight: bold;" | '''Descripción'''
| | Descripción del nodo
||
|-
| font-weight: bold;" | '''Tipo de nodo'''
| | Seleccionar el tipo de nodo (Obligatorio).
| GW
Corporativo

Call center

Vivait-Meet

Corporativo + Vivait-Meet
|-
| font-weight: bold;" | '''Dirección de red'''
| | Dirección de red del nodo (Obligatorio).
||
|-
| font-weight: bold;" | '''Sede'''
| | Seleccionar la sede a la que pertenece el nodo (Obligatorio).

Para más información [[#Sedes | ver sección Sedes]].
||
|-
| font-weight: bold;" | '''Cti Host'''
| | Dirección de red donde esté el demonio '''''VIVA'''''it-cti corriendo.
||
|-
| font-weight: bold;" | '''Cti Puerto'''
| | Puerto de escucha del demonio '''''VIVA'''''it-cti.
| por defecto es el 4500.
|-
| font-weight: bold;" | '''Usuario CTI'''
| | Usuario con el que corre el demonio CTI.
||
|-
| font-weight: bold;" | '''Clave CTI'''
| | Contraseña del usuario anterior.
||
|-
| font-weight: bold;" | '''Usuario SSH'''
| | Usuario para conexión SSH.
||
|-
| font-weight: bold;" | '''Clave SSH'''
| | Clave SSH del usuario anterior.
||
|-
| font-weight: bold;" | '''Log Host'''
| | Dirección IP del host donde queremos que se almacenen los logs.
||
|-
|| ''' Log puerto '''
|| El puerto de escucha para el log.
||
|-
|| '''Log facilidad'''
|| Logs de facilidad.
||
|-
| font-weight: bold;" | '''Rastreo Host'''
| | La cadena de rastreo de host que toma nuestra conexión hasta el servidor de hosting.
||
|-
| font-weight: bold;" | '''Rastreo Puerto'''
| | EL Puerto del Host para el rastreo.
||
|-
| font-weight: bold;" | '''Rastreo Facilidad'''
| | El puerto del rastreo de facilidad.
||
|-
| font-weight: bold;" | '''Plantilla E. Interior'''
| | La plantilla del enlace interior que deben usar el resto de nodos para configurar el enlace interior este nodo.
||
|-
| font-weight: bold;" | '''Plantilla Sip'''
| | Seleccione la plantilla según el tipo de nodo, ACO o no ACD.
||
|-
| font-weight: bold;" | '''Tipo dispositivo E. Interior'''
| | Clase de dispositivos que reconocerá el nodo interior.
||
|-
| font-weight: bold;" | '''Qualify'''
| | Se envía mensajes "notify" entre nodos para ver si están vivos los otros nodos; como inconveniente están haciendo polling cada cierto tiempo.Si el valor es "si" el qualify que se tiene que poner al nodo que esta creando el peer.
| Si / No.
|-
| font-weight: bold;" | '''N. Qualify'''
| | Poner el qualify en todos los enlaces interiores.
||
|-
| font-weight: bold;" | '''Es ACD'''
| | Si el tipo de nodo es Call Center el campo debería estar a Si. En caso contrario No.
| Si / No.
|-
| font-weight: bold;" | '''Es Tracker'''
| | Indica si el nodo tiene instalado el portal VIVAit-Tracker
| Si / No.
|-
| font-weight: bold;" | '''Grabador'''
| | Indica si el nodo tiene la capacidad para grabar
| Si / No.
|-
| font-weight: bold;" | '''Grabar enrutamiento'''
| | Este campo define si van a grabar las llamadas que se enruten para este "Nodo".
||Sin grabación

Grabación sin beep periódico

Grabación con beep periódico

Descartar grabación
|-
| font-weight: bold;" | '''Modo de grabación de la infraestructura'''
| | Este campo define como está la infraestructura configurada para poder configurar la grabación bajo demanda.
| |'''Sin grabación en la infraestructura:''' no se graba nada de lo que se rute en ese nodo.

'''Graba todo:''' se graba todo.

'''Graba por petición:''' El nodo se configura para darle la capacidad de que grabe bajo demanda)
|-
| font-weight: bold;" | '''RecordCentral:'''
| Define que instancia del recordCentral es la encargada de tratar las grabaciones de este nodo.
||
|-
| font-weight: bold;" | '''Host'''
| | Si configuramos el Chat, aqui debe aparecer la direccion IP del nodo ACD
||
|-
| font-weight: bold;" | '''Puerto'''
| | Si configuramos el Chat, aqui debe aparecer el puerto de escucha del chan_sit.
| | Por defecto es el 8888
|-
|}

[[#Nodos | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

=== Ejes ===

Los ejes representan típicamente la estructura organizativa de una compañía en la plataforma VIVAit. Todo objeto existente en la plataforma tiene asignado de uno a cuatro ejes organizativos.

Los Ejes son considerados como una política de permisos para los diferentes usuarios y aplicaciones. Un usuario que pertenezca a un eje puede hacer todo lo que ese eje permita y lo que permitan sus ejes hijos (subejes). Y a su vez un objeto solo puede ser inspeccionado o usado por un usuario que tenga permisos iguales o superiores sobre todos los ejes a los que el objeto pertenece. Para ello los ejes se clasificamos en:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
|-
| Nivel General ó nivel 0 (Nivel departamental)

:Nivel 0.1 (Nivel de operaciones)

::'''SubNivel 0.1.1(*)''' ( Nivel SAT)

:::Sub-Subnivel 0.1.1.1( Nivel Reparaciones)

:::Sub-Subnivel 0.1.1.2( Nivel de consultas técnicas)

::SubNivel 0.1.2 (Nivel Instalaciones)

:Nivel 0.2 (Nivel de ventas)

::Subnivel 0.2.2 ( Nivel de servicios)

:Nivel 0.3 ( Nivel Financiero)

:Nivel 0.4 ( Nivel de desarrollo)
|}

<big>
'''(*)En la instalación de sistemas nuevos se recomienda configurar el primer eje empezando en el tercer nivel (0.1.1., 0.1.2., 0.2.2.,.....). Esta configuración permitirá ampliar la jerarquia de ejes hacía arriba sin tener que reconfigurar todo el sistema.'''</big>

<big>Los ejes definen la situación de los elementos del sistema dentro del árbol jerárquico establecido.</big>

* '''¿Quién soy?''' --> Indica el nivel jerárquico de los elementos que tienen ejes: usuarios, extensiones, grupos de salto, VDN, grupos ACD, etc...

Para realizar la gestión del sistema es necesario configurar usuarios '''(Administradores de la plataforma ó Supervisores para Contact Center)'''.

El nivel de gestión de los '''administradores y supervisores''' se configura con el eje que se asigne a los permisos de cada aplicación.

* '''¿Qué veo?''' --> Se establece en la ventana ''general-usuarios-permisos'', para cada aplicación un '''administrador / supervisor''' puede tener un permiso distinto, éste indica el nivel de gestión que le hemos asignado. (Gestiona los elementos incluídos en su eje y los ejes inferiores).



Una vez ingresemos a esa pantalla de "Ejes" aparecerá la estructura de la compañía que tenemos en la plataforma '''''VIVA''''it con algunos botones laterales( Borrar, Nuevo , Editar y Duplicar) dependiendo del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]]). Un ejemplo seria:


[[File:9Ejes.png|800px|center]]

La explicación de la funcionalidad del botón “Borrar” está explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

Para crear un eje nuevo, es necesario '''seleccionar en que parte de la estructura se debe introducir''' y pulsar el botón “Nuevo”
[[Archivo:10 Crear Subeje.jpg|center]]

Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre identificativo para el eje.
|-
| font-weight: bold;" | '''Descripción'''
| | Nombre que mostrará en el árbol jerárquico (Obligatorio).
|}
[[#Ejes | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

=== Usuarios ===

Un usuario es cualquier persona que utiliza alguno de los servicios de VIVAit. Los usuarios acceden al sistema a través de una interfaz en la que tienen que identificarse con una cuenta y una contraseña.

En la plataforma '''''VIVA'''''it cualquier persona que vaya a usar el sistema necesita estar dado de alta como usuario.

Los tipos de usuarios que podemos crear son:

'''En telefonía corporativa'''
:* Personas con buzón de voz
:* Personas con extensión y uso de movilidad
:* Personas con derechos de reserva de salas de conferencia

'''En contact center'''
:* Agentes
:* Supervisores

'''En ambos entornos'''
:* Administradores

{| class="wikitable"
|-
|'''Si no asignamos permisos al usuario aunque este exista no se le permitirá iniciar sesión en ninguna en la plataforma '''''VIVA'''''it[[#Permisos_a_Usuarios | ver Permisos a Usuarios]].'''
|}

La ruta para la creación y administración de permisos de los usuario se muestra en la siguiente imagen:


[[File:11PestañaGeneralUsuarios2.png|center]]

==== Administrar Usuarios ====
Una vez ingresemos a esa pantalla de "Administrar Usuarios" aparecerá la búsqueda con filtros y algunos botones laterales (Borrar, Nuevo , Editar y Duplicar) que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])


[[File:3Busqueda en General - Usuarios - Administrar usuarios2.png|750px|center]]

Al pulsar sobre "+ Filtros" entre los otros filtros que incluye ésta opción añade los siguientes filtros '''''Login Numerico, Es Agente y Login centralita''''' como podemos ver:


[[File:3.1 Busqueda en General - usuarios - Administrar usuarios2.png|750px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se puede encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) un nuevo "Usuario" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:


[[File:12 Nuevo usuario - Pestaña Usuario2.png|center]]

===== Pestaña Usuario =====


[[File:12 Nuevo usuario - Pestaña Usuario3.png|center]]

Las opciones de la pestaña Usuario se explican en la siguiente tabla:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del usuario (Obligatorio).
||
|-
| font-weight: bold;" | '''Primer apellido'''
| | Primer apellido del usuario.
||
|-
| font-weight: bold;" | '''Segundo apellido'''
| | Segundo apellido del usuario.
||
|-
| font-weight: bold;" | '''DNI/CIF'''
| | Documento identificativo del usuario.
||
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección del usuario.
||
|-
| font-weight: bold;" | '''Código Postal'''
| | Código postal del usuario.
||
|-
| font-weight: bold;" | '''Localidad'''
| | Localidad del usuario.
||
|-
| font-weight: bold;" | '''Correo electrónico'''
| | Correo electrónico del usuario. Útil para recibir notificaciones de mensajes de voz en el buzón de correo. (Siempre configurando un servicio de correo en asterisk).
||
|-
| font-weight: bold;" | '''Idioma'''
| | Idioma del usuario.
||
|-
| font-weight: bold;" | '''Validación'''
||Si indicamos ambas primero consulta a LDAP y si no a la BD de '''''VIVA'''''it.
| | Autenticación '''''VIVA'''''it Suite

Autenticación LDAP

Ambas
|-
| font-weight: bold;" | '''Usuario'''
| | Nombre de la cuenta de registro del usuario (Obligatorio).
||
|-
| font-weight: bold;" | '''Clave'''
| | Clave de la cuenta (Obligatorio).
||
|-
| font-weight: bold;" | '''Depurar'''
| |Es necesario activar este campo para guardar un rastreo de las acciones del usuario en la tabla DAT_LOG

||Si / No

|-
| font-weight: bold;" | '''Dpto'''
| | Elegir un eje (Obligatorio). Para mas información [[#Ejes | ver sección Ejes]]
||
|}

[[#Pestaña_Usuario | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

===== Pestaña ACD =====
{|
{| class="wikitable"
| Nota: Si no activamos el rastreo BBDD sobre el agente no obtendremos ningún dato sobre este agente en la aplicación de rastreo.
|}

La siguiente Pestaña ACD tiene el siguiente aspecto:
[[Archivo:13 Nuevo Usuario - Pestaña ACD.png|center]]

Las opciones de la pestaña ACD se explican en la siguiente tabla:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Es Agente'''
| | Establece si el usuario creado es agente o no.
| | Si / No.
|-
| font-weight: bold;" | '''Perfil'''
| | Perfil al que pertenece el agente. Obligatorio si “Es Agente” -> “Si”. Para mas información [[#Perfiles | ver sección '''''VIVA'''''it Suite ACD+ - Perfiles ]]
||
|-
| font-weight: bold;" | '''Rastreo BBDD'''
| | Habilita o no el rastreo del agente en BBDD.
| | Si / No.
|-
| font-weight: bold;" | '''Rastreo Syslog'''
| | Habilita o no el rastreo del agente en syslog.
| | Si / No.
|-
| font-weight: bold;" | '''Permitir Login Telefónico'''
| | Permitir si el usuario (si es agente ) pueda iniciar sesión desde el teléfono
| | Si / No.
|-
| font-weight: bold;" | '''Grabar Todo'''
| | Grabar todos los segmentos de tipo agente generados por ese agente.
| | Si / No.
|-
| font-weight: bold;" | '''Clave'''
| | Clave usada para el login numérico. Obligatorio si “Es Agente” -> “Si”.
||
|-
| font-weight: bold;" | '''Login Numérico'''
| | Conjunto de números que distinguen al agente.
||
|-
| font-weight: bold;" | '''Número de Líneas'''
| | Número de líneas telefónicas que tiene el agente en su teléfono.
||
|-
| font-weight: bold;" | '''Modo Entrada'''
| | El agente puede tener un perfil que le permita cambiar el modo en el
que el sistema vuelve al estado “preparado”
||Automático

Manual

Agente
|-
| font-weight: bold;" | '''Nodo trabajo'''
| | Nodo donde el usuario esta trabajando (Obligatorio).
Para más información [[#Nodos | ver sección Nodos]].
||
|}

[[#Pestaña_ACD | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

===== Pestaña Centralita =====

La siguiente Pestaña Centralita tiene el siguiente aspecto:
[[Archivo:14 Nuevo Usuario - Pestaña Centralita.png|center]]

Las opciones de la pestaña Centralita se explican en la siguiente tabla:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Nombre mostrar'''
| | Nombre que mostrara el usuario cuando llame.
||
|-
| font-weight: bold;" | '''Desvío no login mensa'''
| | Desvía la llamada al buzón de voz cuando el agente no esta registrado en el teléfono.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío no login'''
| | Número del desvío cuando el agente no esta registrado en el teléfono.
||
|-
| font-weight: bold;" | '''Desvío no contesta mensa'''
| | Desvía la llamada al buzón de voz cuando el agente no contesta.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío no contesta'''
| | Número del desvío cuando el agente no contesta.
||
|-
| font-weight: bold;" | '''Desvío ocupado mensa'''
| | Desvía la llamada al buzón de voz cuando el agente esta ocupado.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío ocupado'''
| | Número del desvío cuando el agente esta ocupado.
||
|-
| font-weight: bold;" | '''Desvío incondicional mensa'''
| | Desvía todas las llamadas que recibe el agente al buzón de voz.
|| Si / No.
|-
| font-weight: bold;" | '''Desvío incondicional'''
| | Número del desvío incondicional.
||
|-
| font-weight: bold;" | '''Número llamada externa'''
| | Número con el que realizan las llamadas al exterior.
||
|-
| font-weight: bold;" | '''Número login'''
| | Número de login del usuario.
||
|-
| font-weight: bold;" | '''Clave login'''
| | Clave del login del usuario.
||
|-
| font-weight: bold;" | '''Comunicaciones personales'''
| | Funcionalidad pendiente de versión. Servirá para indicar a través de uso de calendarios y horarios, a que hora pueden llamar al usuario.

|| Si / No.
|-
| font-weight: bold;" | '''Grabar enrutamiento'''
| | Modo de grabación del usuario.
|| Sin grabación
Grabación sin beep periódico

Grabación con beep periódico

Descartar grabación.
|-
| font-weight: bold;" | '''Categoría'''
| | Indicar el contexto en el cual puede realizar la llamada. Para más información [[#Categorías | ver sección '''''VIVA'''''it Call - Categorías]].
||
|-
| font-weight: bold;" | '''Desvío categoría'''
| | Indicar el contexto de como se tratara la llamada de desvío.

Para más información [[#Categorías | ver sección '''''VIVA'''''it Call - Categorías]].
||
|}
[[#Pestaña_Centralita | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

===== Pestaña Aprovisionamiento =====
La siguiente Pestaña Aprovisionamiento tiene el siguiente aspecto:

[[Archivo:15 Nuevo Usuario - Pestaña Aprovisionamiento.png|center]]

Se añadirán los campos que pueda necesitar un teléfono asignado al usuario para aprovisionarse. Un ejemplo seria añadir campos para configurar un BLF al teléfono del usuario.



===== Pestaña Mensajería =====

La siguiente Pestaña Mensajería tiene el siguiente aspecto:

[[Archivo:16 Nuevo Usuario - Pestaña Mensajeria.png|center]]
Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Buzón'''
| | Indica el numero de buzón en el que el usuario recibirá los mensajes de voz.
Para más información [[#Buzón de voz | ver sección '''''VIVA'''''it Call - Servicios usuarios - Buzones]].
||
|-
| font-weight: bold;" | '''Comunicaciones personales'''
| | Funcionalidad pendiente de versión. Servirá para indicar a través de uso de calendarios y horarios, a que hora pueden llamar al usuario.

| | Si / No.
|}
Al pulsar sobre el campo buzón nos aparece la siguiente pantalla:
[[Archivo:16_1 Nuevo Usuario - Pestaña Mensajeria- Seleccionar Buzon.png|center]]

Se podrá visualizar todos los buzones existentes, porque es posible compartir un buzón entre varios usuarios. Pero solo podremos seleccionar uno.

===== Pestaña Extensiones =====

La siguiente Pestaña Extensiones tiene el siguiente aspecto:
[[File:VentanaUsuarioExtensiones.png|center]]

Esta ventana nos informa de las extensiones la que es propietario un usuario o de la extensión en la que se encuentra movido

[[#Administrar_Usuarios | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

==== Permisos a Usuarios ====

Una vez ingresemos a esa pantalla de "Permisos a Usuarios" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación dados por un usuario administrador superior)
[[Archivo:4 Busqueda en General - Usuarios - Permisos a usuarios.png| 800px|center]]

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]].

La explicación de funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

===== Asignación de Permisos de Usuario por Administrador =====

Pueden darse permisos para crear, duplicar o borrar objetos del portal de administración, hacer ciertos ajustes, archivos... pero no todos, porque algunas partes del sistema están prohibidas hasta para el administrador. En el caso de un administrador normal que pueda crear y dar permisos a usuarios, podemos tener el siguiente caso:
[[Archivo:17_1Pestaña Genera - Usuarios - Explicacion permisos.png|800px|center]]
Si el usuario pepe de la imagen anterior, tuviera solo los permisos de aplicación común a nivel Alto, podría asignar permisos de Usuario. Pero la imagen a dar el botón "Nuevo" seria diferente al que puede ver un administrador como vemos:
[[Archivo:17 Pestaña General - Usuarios- Permisos a Usuarios.png|center]]
Fijándose, nuestro usuario fue creado por otro administrador que solo nos asigno el eje "Dpto". Por tanto, en el momento de dar permisos al usuario "Pepe" solo podrá darse permisos el eje "Dpto" (o los subejes) como vemos en la imagen anterior. La explicación de los campos se explica en una tabla posteriormente.

Finalmente, creado el usuario "Pepe" y este usuario iniciando sesión en el portal de administración podemos observar que en la pestaña de Ejes nuestro usuario "Pepe" solo verá los ejes asignados:

[[File:PermisosUsuarios2.png|800px|center]]

Las opciones de los permisos de los usuarios se explican en la siguiente tabla:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Usuario'''
| | Escoger un usuario existente.
|-
| font-weight: bold;" | '''Aplicación'''
| | Las aplicaciones nos permiten acceder a las distintas pestañas de la plataforma.
| | '''Aplicación Común:''' Permite visualizar únicamente la pestaña [[#General|'''''General''''']], que nos permite tener control de la Organización y de los usuarios.

'''Aplicación Centralita:''' Permite visualizar las pestañas [[#VIVAit Call|'''''VIVA''it Call''''']] y [[#VIVAit Response|'''''VIVA''it Response''''']], que nos tener el control de la telefonía corporativa, las locuciones (MOH entre otras) y su mantenimiento.

'''Aplicación Call-Center:''' Permite visualizar las pestañas [[#VIVAit Call|'''''VIVA''it Call''''']],[[#VIVAit_Response|'''''VIVA''it Response''''']] y [[#VIVAit Suite ACD+|'''''VIVA''it Suite ACD+''''']] para tener control tanto del Contact Center, telefonía corporativa, las locuciones (MOH entre otras) y su mantenimiento.

'''Aplicación Grabación:''' Permite visualizar únicamente en el portal la pestaña [[#VIVAit Record|'''''VIVA''it Record''''']] para el control de las grabaciones.
|-
| font-weight: bold;" | '''Nivel administracion'''
| | Como ya hemos comentado, a cada aplicación se la puede asignar un nivel que corresponde con el permiso de acción sobre la plataforma en las distintas ventanas.
| | '''Bajo o ninguno:''' Permite acceder a las opciones como buscar con el filtro y permite ver la información de la cantidad de los objetos, es decir, ver solamente el listado sin poder ver mas datos de los objetos. No hay botones para operar.

'''Medio:''' Permite acceder a las opciones como buscar con el filtro , visualizar la información (lectura) de un objeto y poder modificarlo (editarlo). Se habilitara para poder operar el botón '''''Editar'''''.

'''Alto:''' Permite acceder a las opciones como buscar con filtro y además permite crear nuevos, duplicar, borrar y recuperar los objetos. Se habilitara para poder operar los botones '''''Nuevo''''', '''''Duplicar''''' , '''''Editar''''', '''''Borrar'''''y '''''Recuperar''''' .
Para mas información [[#Duplicado de Datos|ver Duplicado de Datos ]], [[#Borrado de Datos |Borrado de Datos ]] y [[#Recuperación de datos| Recuperación de datos]].

|-
| font-weight: bold;" | '''Nivel usuario'''
| | Referente a los permisos que tiene el usuario sobre su portal de usuario
| | '''Bajo o ninguno:''' Permite acceder a las opciones como buscar con el filtro y permite ver la información de la cantidad de los objetos, es decir, ver solamente el listado sin poder ver mas datos de los objetos. No hay botones para operar.

'''Medio:''' Permite acceder a las opciones como buscar con el filtro , visualizar la información (lectura) de un objeto y poder modificarlo (editarlo). Se habilitara para poder operar el botón '''''Editar'''''.

'''Alto:''' Permite acceder a las opciones como buscar con filtro y además permite crear nuevos, duplicar, borrar y recuperar los objetos. Se habilitara para poder operar los botones '''''Nuevo''''', '''''Duplicar''''' , '''''Editar''''', '''''Borrar'''''y '''''Recuperar''''' .
Para mas información [[#Duplicado de Datos|ver Duplicado de Datos ]], [[#Borrado de Datos |Borrado de Datos ]] y [[#Recuperación de datos| Recuperación de datos]].

|-
| font-weight: bold;" | '''Ejes'''
| | Los ejes a los que podemos acceder según la configuración común tendrá un nombre determinado. En el caso por ejemplo para un administrador hay cuatro ejes y en el caso de un usuario el numero de ejes asignado. Para más información [[#Ejes | ver sección Ejes]]||
|}
[[#Permisos_a_Usuarios | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

=== Calendarios ===

Los calendarios nos permiten crear eventos puntuales o repetitivos con un horario determinado.
Posteriormente, la plataforma '''''VIVA'''''it, a través de configuración de Dialplan podrá consultar el estado de un calendario en un momento determinado, obteniendo como resultado un "libre" o un "ocupado" y realizándose un diferente tratamiento en función del resultado.
Usos típicos de los calendarios son:
* Comprobar si se está dentro o fuera del horario de oficina con el objeto de desviar llamada a contestador o a operadora
* Establecer diferentes perfiles a agentes de contact center en función del día de la semana (agentes de fin de semana)
{|
|-
|
Nota: Debido a un bug detectado, el proceso requerirá la realización de una sincronización
manual de la sección "mdcal" desde el portal de administración.
|}

Como regla general, en los calendarios configuraremos (y en ese orden):

* '''Servicios''': Se hace referencia a un servicio de calendarios; estos servicios podrán ser por ejemplo
:::* Servicio interno de plataforma '''''VIVA'''''it.
:::* Servicio de calendarios corporativo del cliente
:::* Servicio de calendarios de google...
* '''Cuentas''': Login y clave asociado a un servicio (por ejemplo usuario y clave para acceder al servicio de calendarios de google)
* '''Calendarios''': Calendarios '''internos''' de la plataforma '''''VIVA'''''it que deseemos crear

La gestión de los calendarios, incluyendo altas, bajas y modificaciones de eventos se realiza actualmente desde el propio portal de administración como se puede ver en la siguiente imagen:

[[File:PantallaCalendarios2.png|center]]

==== Servicios ====
Esta ventana sirve para especificar donde está el servidor de calendarios y de qué tipo es (protocolo utilizado).

Una vez ingresemos a esa pantalla de "Servicios" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])
[[Archivo:5 Busqueda en General - Calendarios - Servicios.png|800px|center]]

La explicación de funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) un nuevo "Servicio" en la plataforma VIVAit pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:19 Calendarios - Nuevo Servicio.png|center]]

Las opciones de los servicios de los calentarios se explican en la siguiente tabla:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Realm'''
| | El nombre que se le va a dar el servicio (Obligatorio).
|-
| font-weight: bold;" | '''URL'''
| | Se trata de la dirección de red (URL) para realizar el acceso al servidor de calendarios (Obligatorio).
|| Ejemplo: <nowiki> http://${HOST}/dav/html/cal.php/calendars/${CUENTA}/${CALENDARIO} </nowiki>
|-
| font-weight: bold;" | '''Servidor'''
| | Dirección de red donde está ubicado el servidor de calendario, normalmente será localhost (Obligatorio).
|-
| font-weight: bold;" | '''Protocolo'''
| | Elegir el protocolo empleado para sincronizar los calendarios
| | CalDav
iCal

Exchange

Iws
|-
| font-weight: bold;" | '''Externo'''
| | Indicar si el servidor de calendarios es externo o no.
||Si / No.
|-
| font-weight: bold;" | '''Dpto'''
| | Elegir un eje (Obligatorio) . Para más información [[#Ejes | ver sección Ejes]]
||
|}

[[#Servicios | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

==== Cuentas ====

{| class="wikitable"
|-
| No confundir el nombre de usuario de la plataforma '''''VIVA'''''it, con el nombre de usuario para calendarios. Son objetos diferentes, por eso es necesario crearse una cuenta para manejar los calendarios.
|}

Una vez ingresemos a esa pantalla de "Cuentas" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])
[[Archivo:6 Busqueda en General - Calendarios - Cuentas.png|800px|center]]

La explicación de funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) una nueva "Cuenta" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:20 Calendarios - Nueva Cuenta.jpg|center]]

Las opciones de cuentas de calendarios se explican en la siguiente tabla:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Orden'''
| | Orden de uso de la cuenta (Obligatorio).
|-
| font-weight: bold;" | '''Cuenta'''
| | Nombre de usuario (Obligatorio)
|-
| font-weight: bold;" | '''Clave'''
| | Clave de usuario (Obligatorio)
|-
| font-weight: bold;" | '''Usuario'''
| |Usuario ACD (Obligatorio). Para más información [[#Usuarios | ver sección Usuarios ]]
|-
| font-weight: bold;" | '''Servicio'''
| | Servicio al que se le asignará la cuenta (Obligatorio) . Para más información [[#Servicios | ver sección Servicios]]
|}

[[#Cuentas | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

==== Configuración (General - Calendarios) ====

En esta ventana establecemos el periodo de refresco y de cache de los calendarios por defecto. Ambos son en minutos.

[[Archivo:21 Calendarios - Configuracion.png|center]]

Las opciones de la pestaña Usuario se explican en la siguiente tabla:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Refresco (min)'''
| | Cada cuantos minutos actualizamos el calendario.
|-
| font-weight: bold;" | '''Periodo en cache (min)'''
| | EL rango de tiempo en minutos que traemos en cada refresco.
|}
[[#Configuración_(General_-_Calendarios) | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

==== Calendarios (General - Calendarios) ====
Una vez ingresemos a esa pantalla de "Calendarios" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])
[[Archivo:7 Busqueda en General - Calendarios - Calendarios.png|800px|center]]

La explicación de funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) un "Calendario" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

Nota.- Cada Calendario debe asociarse a un nodo y a una cuenta.

[[Archivo:22 Calendarios - Nuevo Calentario.png|center]]

Las opciones de crear un nuevo calendario se explican en la siguiente tabla:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del calendarios (Obligatorio).
||
|-
| font-weight: bold;" | '''Descripción'''
| | Descripción del calendario.
||
|-
| font-weight: bold;" | '''Zona horaria'''
| | Zona horaria empleada.
| | El formato es el siguiente: Europe/Madrid
|-
| font-weight: bold;" | '''Refresco'''
| | Periodo de refresco en minutos. Si omitimos la configuración por defecto que tenemos en [[#Configuración_(General_-_Calendarios) | ver Configuración Calendarios]]
||
|-
| font-weight: bold;" | '''Periodo en caché'''
| | Periodo en cache en minutos.Si omitimos la configuración por defecto que tenemos en [[#Configuración_(General_-_Calendarios) | ver Configuración Calendarios]].
||
|-
| font-weight: bold;" | '''Datos asterisk'''
| | Declara la función a emplear por el asterisk .
||Sin uso

MD Calendario

Asterisk

MD Calendario y asterisk.
|-
| font-weight: bold;" | '''Ocupado'''
| | Poner ocupado un evento. Por defecto será No.
||Si / No
|-
| font-weight: bold;" | '''Nodo'''
| | Asignar un nodo (Obligatorio).
Para más información [[#Nodos | ver sección Nodos]].
||
|-
| font-weight: bold;" | '''Cuentas'''
| | Asignar una cuenta creada anteriormente al calendario (Obligatorio).
Para más información[[#Cuentas | ver sección Cuentas]]
||
|}

[[#Calendarios_(General_-_Calendarios) | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

=== Campos ===
En esta pestaña aparecen los campos de asterisk para los ficheros de configuración del dialplan, demonios, etc.

Solo se utiliza la búsqueda sobre resultados, es decir, muestra directamente todos los registros de la base de datos, y sobre esos datos hace una búsqueda [[#Introducción |véase Introducción]].

La explicación de funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

Para dar de alta o modificar (Editar) un "Campo" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:23 Pestaña General - Campos - Nuevo Campo.png|center]]

Las opciones de los servicios de los calendarios se explican en la siguiente tabla:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del campo (Obligatorio).
||
|-
| font-weight: bold;" | '''Nombre común'''
| | Nombre común del campo (Obligatorio).
||
|-
| font-weight: bold;" | '''Descripción'''
| | Descripción del campo.
||
|-
| font-weight: bold;" | '''Personalizado'''
| | Un valor no por defecto.
||
|-
| font-weight: bold;" | '''Valor por Defecto'''
| |Valor del campo por defecto.
||
|-
| font-weight: bold;" | '''Tipo Campo'''
| | El tipo de valor del campo.
| |Alfanumérico
Numérico

Lógico

Fecha

Personalizado.
|-
| font-weight: bold;" | '''Clase Campo'''
| | El tipo de campo que es.
| |Buzón

Grupo ACD

SIP

Sala de conferencia

General ACD

General sala de conferencia

General SIP

General Buzones

MOH

General

PJSIP

Aprovisionamiento

Enlace Exterior

Enlace Interior
|}

[[#Campos | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

=== Plantillas ===

En esta pestaña están las plantillas de configuración para los diferentes dispositivos, son un medio para evitar secciones repetitivas en los archivos de configuración de Asterisk como extensions.conf, sip.conf o iax.conf. Las plantillas no debe confundirse con macros en extensions.conf.

Una vez ingresemos a esa pantalla de "Plantillas" aparecerá la búsqueda con filtros y algunos botones laterales(Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])
[[Archivo:8 Busqueda en General - Plantillas.png|800 px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) una "Plantilla" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:
[[Archivo:24 Pestaña General - Plantillas- Nuevo Plantilla.png|center]]

Las opciones para crear una nueva plantilla se explican en la siguiente tabla:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre de la plantilla (Obligatorio).
||
|-
| font-weight: bold;" | '''Clase Plantillas'''
| | Conjuntos de valores asociados a los distintos elementos de la plataforma.
||Buzón
Grupo ACD

Enlace Exterior

Enlace interior

Perfil extensión

Música en espera

Sala conferencia

General ACD

General conferencias

General SIP

General buzones

VDN

General VIVAit-cti

General recordGWd

General recordProcesad
|-
| font-weight: bold;" | '''Valor'''
| | Valor de la plantilla (Obligatorio).
||
|-
| font-weight: bold;" | '''Añadir campos buzones'''
| | Si hay creados tipo de campos Buzones se mostraran para añadir y darles valores. Para más información [[#Campos | ver sección Campos]]
||
|}

[[#Plantillas | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

=== Licencias ===
En proceso de desarrollo , tendrá una funcionalidad en el futuro.

[[Archivo:25 Pestaña General - Licencias.jpg|800px|center]]


[[#Licencias | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

=== Sincronización manual ===
Para generar manualmente una sincronización de los diferentes archivos de configuración de la plataforma.

[[File:SincronizadoManual.png|center]]

[[#Sincronización_manual | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

==''VIVA''it Call ==
Esta pestaña ofrece al usuario la gestión y configuración de la telefonía corporativa (rutas, aprovisionamiento, facilidades, dispositivos...). Está formada por los siguientes submenús:

[[File:Vivait-Call3.png|center]]

[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver arriba]
=== Servicios usuarios ===
El contenido de la pestaña '''''''VIVA'''''it Call - Servicios Usuarios'' es el siguiente:


[[File:Vivait-Call-Servicios-Usuarios2.png|center]]

==== Conferencias ====
Esta pestaña sirve para crear y modificar las conferencias de los usuarios. Una vez ingresemos a esa pantalla de "Conferencias" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]]).
[[Archivo:9 Busqueda en VIVAit Call - Servicios usuarios - Conferencias.png|800px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) una "Conferencia" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:29 Pestaña ViVAit Call - Servicios Usuarios - Nueva Conferencia.png|center]]

Las opciones de la ventana de conferencias se explican en la tabla siguiente:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Número'''
| | Número de la sala de conferencia (Obligatorio).
||
|-
| font-weight: bold;" | '''Descripción'''
| | Descripción de la sala de conferencias.
||
|-
| font-weight: bold;" | '''PIN'''
| |PIN de acceso a la sala de conferencia.
||
|-
| font-weight: bold;" | '''PIN admin'''
| | PIN del administrador de la sala de conferencias.
||
|-
| font-weight: bold;" | '''Plantilla'''
| |Plantilla que debe usarse.
Para más información[[#Plantillas | ver sección General - Plantillas ]]
||
|-
| font-weight: bold;" | '''Nodo'''
| | A que nodo está asociada la sala de conferencia .
Para más información [[#Nodos | ver sección Nodos]].
||
|-
| font-weight: bold;" | '''Grabar enrutamiento'''
| | Este campo define si van a grabar las llamadas que se enruten para esta "Sala de conferencias".
||Sin grabación

Grabación sin beep periódico

Grabación con beep periódico.
|}

[[#Conferencias | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

==== Buzón de voz ====
Ofrece la posibilidad de dejar un mensaje vocal que podrá escucharse más tarde,cuando llamen al usuario y este se encuentre ocupado, tenga un desvío a mensajería o simplemente cuando no quiera contestar a una llamada.

Una vez ingresemos a esa pantalla de "Buzón de voz" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]]).
[[Archivo:9_1 Busqueda en VIVAit Call - Servicios usuarios - Buzones de voz.png|800px|center]]
La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) un "Buzón de voz" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:30 Pestaña ViVAit Call - Servicios Usuarios - Nueva Buzon de voz.png|center]]
Las opciones de la pestaña Usuario se explican en la siguiente tabla:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Número'''
| | Número del Buzón (Obligatorio) .
||
|-
| font-weight: bold;" | '''Nodo'''
| | A que nodo esta asociado el buzón de voz(Obligatorio) .
Para más información [[#Nodos | ver sección General - Nodos]].
||
|-
| font-weight: bold;" | '''Usuario'''
| | Usuario propietario del buzón .
||
|-
| font-weight: bold;" | '''Plantilla'''
| | Plantilla asociada al buzón (Obligatorio). Para más información[[#Plantillas | ver sección General - Plantillas ]]
||
|-
| font-weight: bold;" | '''Clave'''
| | Clave de acceso al buzón de voz.
||
|-
| font-weight: bold;" | '''Archivo adjunto'''
| | Se trata de adjuntar un audio a un correo electrónico.
||Si / No
|}

[[#Buzón_de_voz| Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

=== Dispositivos ===
El contenido de la pestaña '''''''VIVA'''''it Call - Dispositivos'' es el siguiente:


[[File:Dispositivos2.png|center]]

[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver arriba]
==== Clases de Dispositivos ====
Una vez ingresemos a esa pantalla de "Clases de Dispositivos" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]]).
[[Archivo:10 Busqueda en VIVAit Call - Dispositivos - Clases de dispositivos.png|800px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) una "Clase de Dispositivo" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:32 Pestaña ViVAit Call - Dispositivos - Nueva clase de dispositivo.png|center]]

Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre de la Clase de dispositivos (Obligatorio).
||
|-
| font-weight: bold;" | '''Clase'''
| | Especifica de que tipo es la clase de dispositivo.
|| Enlace interior

Enlace Exterior

Extensión
|-
| font-weight: bold;" | '''Subclase'''
| | La subclase a la que pertenece la clase de dispositivos . 
||
|-
| font-weight: bold;" | '''Driver'''
| | Pendiente de versión.
||
|-
| font-weight: bold;" | '''Formato'''
| | Formato de marcación en el dial que va a tener la clase de dispositivo .
||
|}

[[#Clases_de_Dispositivos | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

==== Enlace exterior ====
Este apartado permite crear los troncales para conectar los dispositivos con exterior.

Una vez ingresemos a esa pantalla de "Enlace exterior" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]]).
[[Archivo:11 Busqueda en Vivait Call - Dispositivos - Enlace Exterior.png|800px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) un "Enlace exterior" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:33 Pestaña ViVAit Call - Dispositivos - Nueva enlace exterior.png|center]]

Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre enlace exterior (Obligatorio).
||
|-
| font-weight: bold;" | '''Plantilla'''
| | Plantilla empleada en el enlace exterior (Obligatorio). Para más información[[#Plantillas | ver sección General - Plantillas ]]
||
|-
| font-weight: bold;" | '''Datos asterisk'''
| | Se trata del contexto del dialplan donde se especifica la cadena de marcado ver archivo ''ext_MARCAR_Externo_Particular.conf'' (Obligatorio).
||
|-
| font-weight: bold;" | '''Sede'''
| | A que sede pertenece el enlace exterior (Obligatorio). Para más información [[#Sedes | ver sección General - Sedes]].
||
|-
| font-weight: bold;" | '''Nodo'''
| | A que nodo pertenece el enlace exterior (Obligatorio). Para más información [[#Nodos | ver sección General - Nodos]].
||
|-
| font-weight: bold;" | '''Dispositivo'''
| | A que dispositivo aplica el enlace exterior (Obligatorio).
||
|-
| font-weight: bold;" | '''Categoría'''
| | Categoría de llamadas (Obligatorio). Para más información [[#Categorías | ver sección '''''VIVA'''''it Call - Categorías]]
||
|-
| font-weight: bold;" | '''Dpto'''
| | Elegir un eje (Obligatorio) . Para más información [[#Ejes | ver sección General - Ejes]]
||
|-
| font-weight: bold;" | '''Grabar enrutamiento'''
| | Este campo define si van a grabar las llamadas que se enruten para este “Enlace exterior".
||Sin grabación

Grabación sin beep periódico

Grabación con beep periódico.
|}

[[#Enlace_exterior | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

==== Extensiones ====
Esta pestaña sirve para crear y modificar las extensiones de la centralita.

Una vez ingresemos a esa pantalla de "Extensiones" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]]).
[[Archivo:12 Busqueda en VIVAit Call - Dispositivos - Extensiones.png|800px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) una "Extensión" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:34 Pestaña ViVAit Call - Dispositivos - Nueva extension.png|center]]

Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Número'''
| | Número de la extensión (Obligatorio).
||
|-
| font-weight: bold;" | '''Nombre mostrar'''
| | Nombre que presentara la extensión al llamar el usuario.
||
|-
| font-weight: bold;" | '''Prioridad'''
| | Representa la prioridad de la extensión. Cuanto más baja, más prioritaria es.
||
|-
| font-weight: bold;" | '''Plantilla'''
| | Plantilla empleada para la extensión (Obligatorio). Para más información[[#Plantillas | ver sección General - Plantillas ]]
||
|-
| font-weight: bold;" | '''Usuario de movilidad'''
| | Es un campo de solo lectura, en el que indica que usuario se ha movido a esa extensión.
||
|-
| font-weight: bold;" | '''Usuario propietario'''
| | Se asigna el usuario propietario de la extensión. Para más información[[#Usuarios | ver sección Usuarios ]]
||
|-
| font-weight: bold;" | '''Hay movilidad'''
| | Habilita la movilidad en la extensión para que un usuario se pueda mover a dicha extensión.
||Si / No.
|-
| font-weight: bold;" | '''Teléfono'''
| | El modelo de teléfono donde va a estar configurada la extensión. Para más información[[#Módelos de teléfonos | ver sección '''''VIVA'''''it Call - Aprovisionamiento - Modelos de teléfonos]]
||
|-
| font-weight: bold;" | '''Hay movilidad'''
| | Habilita la movilidad en la extensión para que un usuario se pueda mover a dicha extensión. '''NECESITA DAR PERMISOS DE CENTRALITA AL USUARIO.'''
||Si / No.
|-
| font-weight: bold;" | '''Desvío incondicional'''
| | Introducir un número al que se desvían las llamadas de dicha extensión.
||
|-
| font-weight: bold;" | '''Desvío incondicional a mensa'''
| | Desvía todas las llamadas a un buzón de voz.
||Si / No.
|-
| font-weight: bold;" | '''Desvío no contesta'''
| | Introducir un número al que se desvían las llamadas si la extensión no contesta.
||
|-
| font-weight: bold;" | '''Desvío no contesta a mensa'''
| | Si la extensión no contesta, la llamada se va al buzón de voz.
||Si / No.
|-
| font-weight: bold;" | '''Desvío por ocupado'''
| | Introducir un número al que se desvían las llamadas si la extensión está ocupada.
||
|-
| font-weight: bold;" | '''Desvío por ocupado a mensa'''
| | Si la extensión está ocupada, la llamada se va al buzón de voz.
||Si / No.
|-
| font-weight: bold;" | '''Desvío por fuera de servicio'''
| | Número al que se desvían las llamadas si la extensión está fuera de servicio.
||
|-
| font-weight: bold;" | '''Desvío por fuera de servicio a mensa'''
| | Si la extensión está fuera de servicio, las llamadas se van al buzón de voz.
||Si / No.
|-
| font-weight: bold;" | '''Comunicaciones Personales'''
| | Indica a través de calendarios y horarios cuando el usuario de la extensión tendrá disponibilidad. Para más información[[#Calendarios | ver sección General - Calendarios]]
||Si / No.
|-
| font-weight: bold;" | '''Num. mostrar exterior'''
| | Número con el que se identifica la llamada al exterior.
||
|-
| font-weight: bold;" | '''Música en espera'''
| | Música en espera que tendrá la extensión si retiene una llamada en la cola esperando a ser contestada.
||
|-
| font-weight: bold;" | '''Música en retenciones'''
| | Música en retenciones que tendrá la extensión si retiene una llamada una vez contestada.
||
|-
| font-weight: bold;" | '''Clave registro'''
| | Clave para el registro de la extensión en el asterisk.
||
|-
| font-weight: bold;" | '''Buzón'''
| | Buzón de voz asociado a la extensión. Para más información[[#Buzón de voz | ver sección '''''VIVA'''''it Call - Buzón de voz]].
||
|-
| font-weight: bold;" | '''Categoría de desvío'''
| | Categoría que tienen las llamadas desviadas (Obligatorio). Para más información [[#Categorías | ver sección '''''VIVA'''''it Call - Categorías]].
||
|-
| font-weight: bold;" | '''Sede'''
| | Sede a la que pertenece la extensión (Obligatorio). Para más información [[#Sedes | ver sección General - Sedes]].
||
|-
| font-weight: bold;" | '''Nodo'''
| | Nodo donde está registrada la extensión. Para más información [[#Nodos | ver sección General - Nodos]].
||
|-
| font-weight: bold;" | '''Nodo Secundario'''
| | Nodo de registro de la extensión si por alguna razón no se puede registrar en el Nodo Principal. Para más información [[#Nodos | ver sección General - Nodos]].
||
|-
| font-weight: bold;" | '''Dpto'''
| | Elegir un eje (Obligatorio) . Para más información [[#Ejes | ver sección General - Ejes]].
||
|-
| font-weight: bold;" | '''Grabar enrutamiento'''
| | Este campo define si van a grabar las llamadas que se enruten para esta "Extensión".
||Sin grabación

Grabación sin beep periódico

Grabación con beep periódico.
|-
| font-weight: bold;" | '''Puesto'''
| | Asocia la extensión a un puesto (Nombre del PC).
||
|-
| font-weight: bold;" | '''Categoría'''
| | Categoría de llamadas (Obligatorio).
||
|-
| font-weight: bold;" | '''Dispositivo'''
| | Clase de dispositivo de tipo Extensión (Obligatorio). Para más información[[#Clases de dispositivos | ver sección '''''VIVA'''''it Call - Dispositivos - Clases de dispositivos ]]
||
|}

[[#Extensiones | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

=== Agendas ===
Aquellos contactos creados (nuevo datos agenda) o importados que serán comunes para todos los usuarios o contactos corporativos.

Existen diferencias entre Agendas de Corporativo y Call Center.



Esta pestaña sirve para rellenar los datos del propietario de la agenda e importar el fichero con los contactos.

Una vez ingresemos a esa pantalla de "Agendas" aparecerá la búsqueda con filtros y algunos botones laterales(Importar Contactos, Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]]).
[[Archivo:13_0 Busqueda en Vivait Call - Agendas.png|800 px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) una "Agenda" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:


[[File:Agenda.png|center]]

Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del propietario de la agenda (Obligatorio)
|-
| font-weight: bold;" | '''Primer Apellido'''
| | Primer apellido del propietario de la agenda.
|-
| font-weight: bold;" | '''Segundo Apellido '''
| | Segundo apellido del propietario de la agenda.
|-
| font-weight: bold;" | '''Empresa'''
| | Empresa donde trabaja el propietario.
|-
| font-weight: bold;" | '''Nombre en Pantalla'''
| | Nombre con el que aparece la agenda por la pantalla (Obligatorio)
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección
|-
| font-weight: bold;" | '''Cod. Postal'''
| | Código postal.
|-
| font-weight: bold;" | '''Localidad'''
| | Localidad.
|-
| font-weight: bold;" | '''Provincia'''
| | Provincia.

|-
| font-weight: bold;" | '''Dpto'''
| | Elegir un eje (Obligatorio) . Para más información [[#Ejes | ver sección Ejes]]
|-
|font-weight: bold;" | '''Teléfonos de la agenda'''
|| Si queremos añadir numero de teléfonos adicionales. Se pulsa sobre el botón "Nuevo Teléfono" nos aparecerá dos campos: uno a rellenar el numero de teléfono y otro para seccionar el tipo.
El botón "Borrar teléfono" solo borrara el ultimo teléfono adicional añadido a la agenda.
|-
|font-weight: bold;" | '''C_CAMPO1'''
|| Parámetro opcional 1 de la agenda
|-
|font-weight: bold;" | '''C_CAMPO2'''
|| Parámetro opcional 1 de la agenda
|}

==== Importación de contactos con un fichero ====
El '''''portal de administración de la plataforma ''VIVA''it''''' permite la importación de un archivo csv donde puedes importar tu agenda. Una vez accedemos a la pestaña ''''''VIVA'''''it Call - Agendas' pulsando el botón "Importar Contactos" aparece la siguiente ventana:
[[Archivo:35_1 Pestaña ViVAit Call - Agendas - Nueva agenda_Importada.png|center]]

==== Formato del CSV para la Agenda ====
El CSV debe tener el siguiente formato personalizado, para ello puedes crearlo desde aplicaciones de hojas de calculo que permitan guardar la tabla como CSV.
{| class="wikitable sortable"
|- style="font-style: italic; color: blue;"
| - || - || APELLIDO 1|| APELLIDO 2 || EMPRESA || NOMBRE EN PANTALLA || DIRECCIÓN || CP || LOCALIDAD || PROVINCIA
|-
|style="font-style: italic; color: green;"| AGENDA || '''Texto con el nombre del contacto en la AGENDA '''||''' Texto para APELLIDO 1'''|| '''Texto para APELLIDO 2 '''||''' Texto para EMPRESA'''||''' Texto para NOMBRE EN PANTALLA '''||''' Texto para DIRECCIÓN '''||''' Texto para CP''' ||''' Texto para LOCALIDAD''' || '''Texto para PROVINCIA'''
|-
|style="font-style: italic; color:#e76700;"| TELEFONO || '''Texto numérico con Numero de teléfono Opcional''' || - || - || -|| -|| - || -|| - || -
|-
|style="font-style: italic; color: green;"| OPCIONAL|| '''Texto campo NOTAS''' || -|| - || - || - || -|| -|| -||-
|}
'''Notas:'''
*'''Se debe de tener las opciones AGENDA, TELEFONO (sin tilde), OPCIONAL en la primera columna y a partir de la segunda fila después deben ir los datos en orden.'''
*'''Los campos color azul deben existir solamente una vez y en la primera fila.'''

*'''Los campos de texto verde solo puede aparecer una vez por contacto.'''

*'''Los campos de texto naranja varias veces como números adicionales se desea añadir al contacto, pero nunca en la misma fila.'''
*'''Los campos de texto en negrita son para rellenar los datos del contacto.'''

Otras consideraciones a tener en cuenta:

* El Departamento y los ejes serán los mismos que tenga el usuario que los crea. Si se desean cambiar debe hacerse manualmente desde el portal de administración.

* El tipo de teléfono no puede cambiarse manualmente desde el CSV. Si se desean cambiar debe hacerse manualmente desde el portal de administración.

* Si faltan campos se insertarán vacíos y si sobran no se importarán.

[[#Agendas | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

=== Categorías ===

Una categoría es una colección de prerutas existentes,se les suele dar el nombre de interna, local, nacional e internacional(en caso aislados), y siguiendo el orden cada uno incluye al anterior, agregando así un grado mas de permisos. La idea es que al configurar cada usuario en nuestro sistema, limitemos los accesos que cada uno tenga, sabiendo que cada uno solo puede marcar estrictamente a lo que nosotros le permitimos y que camino que debe seguir la llamada.

'''Recomendación''': Crear primero una categoría y todas sus prerutas, luego al crear el resto podemos duplicar las prerutas de una categoría existente, ahorrando mucho tiempo de configuración.

Una vez ingresemos a esa pantalla de "Categorías" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]]).
[[Archivo:13_1 Busqueda en Vivait Call - Categorias.png|800 px |center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) una "Categoría" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:
[[Archivo:36 Pestaña ViVAit Call - Categorias - Nueva categoria.jpg|center]]

Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre de la categoría (Obligatorio) .
|-
| font-weight: bold;" | '''Descripción'''
| | Descripción de la categoría.
|-
| font-weight: bold;" | '''Dpto'''
| | Elegir un eje (Obligatorio) . Para más información [[#Ejes | ver sección Ejes]]
|-
| font-weight: bold;" | '''Duplicar rutas'''
| | Si queremos duplicar las prerutas de una categoriza existente, ahorraremos mucho tiempo de configuración. Para más información[[#Prerutas | ver sección '''''VIVA'''''it Call - Prerutas]]
|}

[[#Categorías | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

=== Facilidades ===

Esta pestaña, por la comodidad de usuarios, permite crear las marcaciones cortas para leer un buzón, capturar una extensión, activar retrollamada, cancelar retrollamada, etc.

Una vez ingresemos a esa pantalla de "Facilidades" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]]).
[[Archivo:13 Busqueda en Vivait Call - Facilidades.png|800 px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) una "Facilidad" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:
[[Archivo:37 Pestaña ViVAit Call - Facilidades - Nueva facilidad.png|center]]

Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Número para marcar la facilidad (Obligatorio) .
||
|-
| font-weight: bold;" | '''Tipo'''
| | El tipo de facilidad
|| Leer buzón

Capturar extensión

Activar retrollamada

Cancelar retrollamada

Login movilidad

Logout movilidad

Desvío extensión incondicional

Desvío extensión incondicional a mensajería

Desvío extensión por no contesta

Desvío extensión por no contesta a mensajería

Desvío extensión por ocupado

Desvío extensión por ocupado a mensajería

Desvío extensión por fuera de servicio

Desvío usuario incondicional

Desvío usuario incondicional a mensajería

Desvío usuario por no contesta

Desvío usuario por no contesta a mensajería

Desvío usuario por ocupado

Desvío usuario por ocupado a mensajería

Desvío usuario por fuera de servicio

Login en grupos corporativos

Logout en grupos corporativos

Pausa en grupos corporativos

Despausa en grupos corporativos

Facilidad JS.
|-
| font-weight: bold;" | '''Grabar enrutamiento'''
| | Este campo define si van a grabar las llamadas que se enruten para esta Facilidad.
||Sin grabación
Grabación sin beep periódico

Grabación con beep periódico

Descartar grabación.
|}
[[#Facilidades | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

=== VDN (VIVAit Call)===

VDN ('''V'''ector '''D'''irectory '''N'''umber) se utiliza para asignar un número externo a una extensión de la red interna. Cada VDN tiene asociado un vector el cual se encarga de enlutar el VDN creado con la extensión

Una vez ingresemos a esa pantalla de "VDN" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]]).
[[Archivo:14 Busqueda en VIVAit call - VDN.png|800 px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) un "VDN" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:
[[Archivo:38 Pestaña ViVAit Call - VDN - Nuevo VDN.jpg|center]]

Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre que tiene el VDN.
||
|-
| font-weight: bold;" | '''Nombre mostrar'''
| | Nombre que podrá presentar el VDN.
||
|-
| font-weight: bold;" | '''Descripción'''
| | Descripción breve sobre el VDN Corporativo.
||
|-
| font-weight: bold;" | '''Notas'''
| | Agregar una nota adicional sobre el VDN.
||
|-
| font-weight: bold;" | '''Nodo'''
| | Indicar a que nodo se aplica el VDN (obligatorio). Para más información [[#Nodos | ver sección General - Nodos]].
||
|-
| font-weight: bold;" | '''Grabar enrutamiento'''
| | Este campo define si van a grabar las llamadas que se enruten para este VDN.
||Sin grabación

Grabación sin beep periódico

Grabación con beep periódico

Descartar grabación.
|-
| font-weight: bold;" | '''Dpto.'''
| | Elegir un eje (Obligatorio) . Para más información [[#Ejes | ver sección Ejes]].
||
|}

En un futuro se contempla que pueda usarse una plantilla personalidad para un grupo VDN del dialplan.

[[#VDN_(VIVAit_Call) | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

=== Grupos ===
Los grupos de '''''VIVA'''''it Call y de '''''VIVA'''''it Suite comparten numeración en una solución VIVAit, pero son diferentes entidades que se gestionan en diferentes entradas del portal

El contenido de la pestaña '''''''VIVA'''''it Call - Grupos'' es el siguiente:


[[File:Gruposcorporativos.png|center]]
[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver arriba]
==== Grupos de salto ====

Una vez ingresemos a esa pantalla de "Grupos de salto" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]]).
[[Archivo:15 Busqueda en VIVAit Call - Grupos - Grupos de Salto.png|820px|center]]
La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) un "Grupo de salto " en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:
[[Archivo:51 Pestaña ViVAit Call - Grupos - Nuevo grupo de salto - Pestaña Grupo.jpg|center]]
Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Numero'''
| | Numero asociado al grupo de salto (obligatorio).
||
|-
| font-weight: bold;" | '''Nombre a mostrar'''
| | Nombre que presentara el grupo al llamante.
||
|-
| font-weight: bold;" | '''Descripción'''
| | Descripción breve sobre el grupo de salto.
||
|-
| font-weight: bold;" | '''Nodo'''
| | Nodo al que pertenece el grupo de salto (obligatorio). Para más información [[#Nodos | ver sección General - Nodos]].
||
|-
| font-weight: bold;" | '''Plantilla'''
| | Plantilla empleada para el grupo de salto (obligatorio). Para más información[[#Plantillas | ver sección General - Plantillas ]].
||
|-
| font-weight: bold;" | '''Grabar enrutamiento'''
| | Este campo define si van a grabar las llamadas que se enruten para este/a “Objeto”.
||Sin grabación

Grabación sin beep periódico

Grabación con beep periódico

Descartar grabación.
|-
| font-weight: bold;" | '''Música'''
| | Musica en espera que se oirá al entrar en la cola del grupo de salto.
||
|-
| font-weight: bold;" | '''Tiempo admin. de centralita'''
| | Son los segundos que se dejan al agente para realizar algún tipo de gestión una vez finalizada la llamada.
||
|-
| font-weight: bold;" | '''Categoría'''
| | Categoría de llamadas (Obligatorio). Para más información [[#Categorías | ver sección '''''VIVA'''''it Call - Categorías]].
||
|-
| font-weight: bold;" | '''Dpto'''
| | Elegir un eje (Obligatorio) . Para más información [[#Ejes | ver sección Ejes]].
||
|}

Al pulsar el botón "Agregar campo" podremos añadir una serie de campos para configurar el funcionamiento del grupo de salto.
Entre los campos disponibles se encuentra el de "estrategia" que va a influir en el modo en que las llamadas al grupo de salto se van distribuyendo entre las extensiones.

Alguna de las estrategias disponibles son:

'''Ringall''': Llama simultáneamente a todos los dispositivos disponibles hasta que uno conteste.

'''Roundrobin''': Se turna llamado a cada dispositivo disponible.

'''Leastrecent''': Llama al dispositivo que hace más tiempo que colgó una llamada en esta cola.

'''Fewestcalls''': llama al que tenga menos llamadas completas de esta cola.

'''Random''': Llama a uno de los dispositivos disponibles, de forma aleatoria.

'''rrmemory''': round robin con memoria, recuerda el dispositivo que recibió la última llamada.



En la pestaña Extensiones al asignar una extensión aparecerá la siguiente ventana:

[[File:Campo-orden.jpg]]

Las explicación de las opciones estan en la siguiente tabla:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Extensión'''
| | Número de una extensión (obligatorio). Para más información[[#Extensiones | ver sección '''''VIVA'''''it Call - Dispositivos - Extensiones]].
||
|-
| font-weight: bold;" | '''Prioridad'''
| | Representa la prioridad de la extensión. Cuanto más baja más prioritaria es. Las extensiones identificadas con la prioridad menor recibirán las llamadas siempre y las extensiones identificadas con prioridad mayor solo recibirán llamadas cuando las de prioridad inferior estén ocupadas.
||
|-
| font-weight: bold;" | '''Permanente'''
| | Si el valor es "No" ofrece la posibilidad al usuario al que pertenece la extensión, podrá desunirse del grupo. En caso contrario, aunque el usuario marque la desunión a los grupos seguirá perteneciendo al mismo grupo de salto.
|| Sí / No.
|-
| font-weight: bold;" | '''Orden'''
| | El campo “orden” indica la posición que cada extensión ocupa dentro del grupo de salto. De esta forma las llamadas al grupo de salto se irán recibiendo en las extensiones en función del “nº de orden asignado” (una extensión con nº de orden 1 recibirá la llamada antes que una extensión con nº de orden 2, siempre que no esté ocupada).
||
|}

Para que el nº de orden determine la extensión en la que se recibe la llamada en un grupo de salto es imprescindible que la estrategia indicada en el grupo sea “linear”.
En cualquier otro caso será la estrategia la que determine la extensión en la que se recibe la llamada

Si una extensión no tiene nº de orden asignado será la primera en recibir las llamadas del grupo de salto.

[[#Grupos_de_salto | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

==== Grupos de operadoras ====

Una vez ingresemos a esa pantalla de "Grupos de operadoras" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]]).
[[Archivo:16 Busqueda en VIVAit Call - Grupos - Grupos de operadoras.png|800 px|center]]
La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) un "Grupo de operadora" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:53 Pestaña ViVAit Call - Grupos - Nuevo grupo de operadoras - Pestaña Grupo.png|center]]
Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Numero'''
| | Numero asociado al Grupo de operadoras (obligatorio).
||
|-
| font-weight: bold;" | '''Nombre a mostrar'''
| | Nombre que presentara el grupo al llamante.
||
|-
| font-weight: bold;" | '''Descripción'''
| | Descripción breve sobre el grupo de operadoras .
||
|-
| font-weight: bold;" | '''Nodo'''
| | Nodo al que pertenece el grupo de operadoras (obligatorio). Para más información [[#Nodos | ver sección General - Nodos]].
||
|-
| font-weight: bold;" | '''Plantilla'''
| | Plantilla empleada para el grupo de operadoras (obligatorio). Para más información[[#Plantillas | ver sección General - Plantillas ]].
||
|-
| font-weight: bold;" | '''Grabar enrutamiento'''
| | Este campo define si van a grabar las llamadas que se enruten para este Grupo de operadoras.
||Sin grabación

Grabación sin beep periódico

Grabación con beep periódico

Descartar grabación.
|-
| font-weight: bold;" | '''Música'''
| | Musica en espera que se oirá al entrar en la cola del grupo de operadoras.
||
|-
| font-weight: bold;" | '''Tiempo admin. de centralita'''
| | Son los segundos que se dejan al agente para realizar algún tipo de gestión una vez finalizada la llamada.
||
|-
| font-weight: bold;" | '''Categoría'''
| | Categoría de llamadas (Obligatorio). Para más información [[#Categorías | ver sección '''''VIVA'''''it Call - Categorías]].
||
|-
| font-weight: bold;" | '''Dpto'''
| | Elegir un eje (Obligatorio) . Para más información [[#Ejes | ver sección Ejes]]
||
|}

En la pestaña Extensiones al asignar una extensión aparecerá:
[[Archivo:54 Pestaña ViVAit Call - Grupos - Nuevo grupo de operadoras - Pestaña Extensiones - Nueva extension.jpg|center]]
Las explicación de las opciones estan en la siguiente tabla:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Extensión'''
| | Número de una extensión (obligatorio). Para más información[[#Extensiones | ver sección '''''VIVA'''''it Call - Dispositivos - Extensiones]]
||
|-
| font-weight: bold;" | '''Prioridad'''
| | Representa la prioridad de la extensión.
||
|-
| font-weight: bold;" | '''Permanente'''
| | Si el valor es "No" ofrece la posibilidad al usuario al que pertenece la extensión, podrá desunirse del grupo. En caso contrario, aunque el usuario marque desunirse de los grupos seguirá perteneciendo al mismo grupo de salto.
|| Sí / No.
|}

Nota.- A un valor más alto, existe una mayor prioridad

[[#Grupos_de_operadoras | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

==== Grupos ACD centralita ====

El '''''VIVA'''''it Call permite la creación de sencillos grupos ACD, concebidos como punto de distribución de llamadas en el que en función del criterio elegido para la asignación de llamadas a extensiones pertenecientes al grupo (existen diferentes estrategias) estas son atendidas

Las extensiones pueden ser fijas (pertenecen al grupo ACD siempre) o dinámicas (se registran y se desvinculan de un grupo ACD mediante facilidades telefónicas)

Los grupos ACD de centralita no disponen de herramientas de supervisión ni reporting.

Una vez ingresemos a esa pantalla de "Grupos ACD centralita" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]]).
[[Archivo:17 Busqueda en VIVAit Call - Grupos - Grupos ACD de centralita.png|800 px|center]]
La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) un "Grupo ACD centralita" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:55 Pestaña ViVAit Call - Grupos - Nuevo grupo ACD centrailita - Pestaña Grupo.png|center]]
Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Numero'''
| | Numero asociado al Grupo ACD centralita (obligatorio).
||
|-
| font-weight: bold;" | '''Nombre a mostrar'''
| | Nombre que presentara el grupo ACD centralita.
||
|-
| font-weight: bold;" | '''Descripción'''
| | Descripción breve sobre el grupo ACD centralita.
||
|-
| font-weight: bold;" | '''Nodo'''
| | Nodo al que pertenece el grupo ACD centralita (obligatorio). Para más información [[#Nodos | ver sección General - Nodos]].
||
|-
| font-weight: bold;" | '''Plantilla'''
| | Plantilla empleada para el grupo ACD centralita (obligatorio). Para más información[[#Plantillas | ver sección General - Plantillas ]].
||
|-
| font-weight: bold;" | '''Grabar enrutamiento'''
| | Este campo define si van a grabar las llamadas que se enruten para este grupo ACD centralita.
||Sin grabación

Grabación sin beep periódico

Grabación con beep periódico

Descartar grabación.
|-
| font-weight: bold;" | '''Música'''
| | Musica en espera que se oirá al entrar en la cola del grupo ACD centralita.
||
|-
| font-weight: bold;" | '''Tiempo admin. de centralita'''
| | Son los segundos que se dejan al agente para realizar algún tipo de gestión una vez finalizada la llamada.
||
|-
| font-weight: bold;" | '''Categoría'''
| | Categoría de llamadas (Obligatorio). Para más información [[#Categorías | ver sección '''''VIVA'''''it Call - Categorías]].
||
|-
| font-weight: bold;" | '''Dpto'''
| | Elegir un eje (Obligatorio) . Para más información [[#Ejes | ver sección Ejes]].
||
|}

En la pestaña Extensiones al asignar una extensión aparecerá:
[[Archivo:56 Pestaña ViVAit Call - Grupos - Nuevo grupo ACD centralita - Pestaña Extensiones - Nueva extension.jpg|center]]
Las explicación de las opciones estan en la siguiente tabla:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Extensión'''
| | Número de una extensión (obligatorio). Para más información[[#Extensiones | ver sección '''''VIVA'''''it Call - Dispositivos - Extensiones]].
||
|-
| font-weight: bold;" | '''Prioridad'''
| | Representa la prioridad de la extensión.
||
|-
| font-weight: bold;" | '''Permanente'''
| | Si el valor es "No" ofrece la posibilidad al usuario al que pertenece la extensión, podrá desvincularse del grupo. En caso contrario, aunque el usuario marque la facilidad para la desvinculación de grupos seguirá perteneciendo al mismo grupo de salto.
|| Sí / No.
|}

[[#Grupos_ACD_centralita | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

==== Grupos de captura ====

'''Nota.- Los grupos de captura son solo para extensiones; no se pueden incluir usuarios en grupos de captura'''

Podemos observar que aparecen diferentes pantallas que en los demás grupos, pues consideramos que se debe entender como una funcionalidad que da permisos a una extensión. Donde el grupo de captura establece un conjunto de extensiones entre las cuales se puede, fácilmente, contestar desde una extensión llamadas dirigidas a otra del mismo.

Una vez ingresemos a esa pantalla de "Grupos de captura" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]]).
[[Archivo:18 Busqueda en VIVAit Call - Grupos - Grupos de Captura.png|800px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) un "Grupo de captura" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:
[[Archivo:57 Pestaña ViVAit Call - Grupos - Nuevo grupo de captura - Pestaña Grupo.jpg|center]]

Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre que asignamos al grupo de captura (obligatorio).
|-
| font-weight: bold;" | '''Descripción'''
| | Descripción breve del grupo de captura.
|-
| font-weight: bold;" | '''Nodo'''
| | Nodo en el que se aplicara el grupo de captura (obligatorio). Para más información [[#Nodos | ver sección General - Nodos]].
|-
| font-weight: bold;" | '''Dpto'''
| | Elegir un eje (Obligatorio) . Para más información [[#Ejes | ver sección Ejes]]
|}

En la pestaña Extensiones al asignar una extensión aparecerá:
[[Archivo:58 Pestaña ViVAit Call - Grupos - Nuevo grupo de captura - Pestaña Extensiones - Nueva extension.png|center]]
Las explicación de las opciones estan en la siguiente tabla:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Extensión'''
| | Número de una extensión (obligatorio). Para más información[[#Extensiones | ver sección '''''VIVA'''''it Call - Dispositivos - Extensiones]].
||
|-
| font-weight: bold;" | '''Prioridad'''
| | Representa la prioridad de la extensión.
||
|-
| font-weight: bold;" | '''Rol de captura'''
| | Indica como funcionara la extensión cuando entre una llamada en el grupo de captura.
|| Puede capturar y ser capturado.

Puede ser capturado.

Puede capturar.
|}

[[#Grupos_de_captura | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

=== Aprovisionamiento ===
Aprovisionar un teléfono es el proceso de configuración automático de teléfonos IP para su uso con una Centralita Telefónica de forma remota. Una vez que aprovisione un teléfono, el teléfono automáticamente se configurará correctamente y podrá administrar los teléfonos de forma centralizada y remota, sin tener que iniciar sesión en la interfaz web de cada uno de los teléfonos.

El aprovisionamiento de teléfono facilita enormemente la administración cotidiana de los teléfonos IP. Esto hace que sea fácil de cambiar las contraseñas de extensión,realizar desvíos de llamadas, nombre a mostrar, mensajería y demás configuraciones, ya que puede hacerlo de forma centralizada para todos los teléfonos desde el portal de administración y luego transferir los cambios al teléfono.

El contenido de la pestaña ''V'''''VIVA'''''it Call - Aprovisionamiento' es el siguiente:

[[File:Aprovisionamiento.png|center]]

[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver arriba]
==== Teléfonos ====

Una vez ingresemos a esa pantalla de "Teléfonos" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]]).
[[Archivo:40 Pestaña ViVAit Call - Aprovisionamiento - Teléfonos.jpg|800px| center]]
La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) un "Teléfono" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:41 Pestaña ViVAit Call - Aprovisionamiento - Nuevo Teléfono.jpg|center]]
Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Modelo de Teléfono'''
| | Modelo del teléfono que estamos creando (Obligatorio). Para más información[[#Módelos de teléfonos | ver sección '''''VIVA'''''it Call - Aprovisionamiento - Módelos de teléfonos ]].
||
|-
| font-weight: bold;" | '''Extensión'''
| | Extensión asociada al dicho teléfono. Para más información[[#Extensiones | ver sección '''''VIVA'''''it Call - Dispositivos - Extensiones]].
||
|-
| font-weight: bold;" | '''MAC'''
| | Dirección física del teléfono (Obligatorio).
||
|-
| font-weight: bold;" | '''Núm. serie'''
| | Número de serie del teléfono.
||
|-
| font-weight: bold;" | '''Dirección de red'''
| | Indicar el nodo de registro .
||
|-
| font-weight: bold;" | '''Usado puerto PC'''
| | Si utiliza un puerto del PC
| | Sí / No.
|-
| font-weight: bold;" | '''POE'''
| | Si el terminal telefónico usa Power Over Ethernet (POE)
| | Sí / No.
|-
| font-weight: bold;" | '''Ubicación'''
| | Ubicación del teléfono.
||
|-
| font-weight: bold;" | '''Notas'''
| | Comentarios adicionales sobre el teléfono.
||
|}

===== Importación de MACs de teléfonos con un fichero =====
El registro uno a uno de teléfonos que pertenecen a una determinado fabricante puede hacer que la persona encargada emplee demasiado tiempo en esta tarea, el portal de administración ofrece la posibilidad de registrar teléfonos por su MAC que pertenezcan al mismo fabricante utilizando un archivo con formato csv.

Una vez ingresemos a esa pantalla de "Teléfonos" al pulsar el botón "Importar MACS" aparece la siguiente ventana:

[[Archivo:40_1 Pestaña ViVAit Call - Aprovisionamiento - Teléfonos_Importar.png| center]]

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Modelo de Teléfono'''
| | Modelo del teléfono que estamos creando (Obligatorio).Para más información[[#Módelos de teléfonos | ver sección '''''VIVA'''''it Call - Aprovisionamiento - Módelos de teléfonos ]]
|-
| font-weight: bold;" | '''Fichero'''
| | Fichero CVS que contendra las MACS de los telefonos a aprovisionar.

|}

===== Formato del CSV para aprovisionar teléfonos =====

El CSV debe tener el siguiente formato personalizado, para ello puedes crearlo desde aplicaciones de hojas de calculo que permitan guardar la tabla como CSV.
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
|-
! Columna 1
|-
| dirección MAC del teléfono 1
|-
| dirección MAC del teléfono 2
|}
Nota:

* '''El valor de las direcciones MACs de los teléfonos en el fichero CSV deben ser de una forma adecuado. Por ejemplo, si tenemos la dirección MAC de un teléfono 00:17:4F:08:5F:69, debemos convertirlo en 00174F085F69.'''
* '''Podemos introducir tantas direcciones MACS para un modelo determinado como teléfonos tengamos pero siempre en la primera columna sin encabezado.'''

[[#Teléfonos | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

==== Módelos de teléfonos ====

Una vez ingresemos a esa pantalla de "Módelos de teléfonos" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]]).
[[Archivo:20 Busqueda en VIVAit Call - Aprovisionamiento - Modelos de teléfonos.png|800 px|center]]
La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) un "Módelo de teléfono" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:42 Pestaña ViVAit Call - Aprovisionamiento - Nuevo Modelo de Teléfono.png|center]]

Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Modelo del teléfono (Obligatorio).
||
|-
| font-weight: bold;" | '''Descripción'''
| | Breve descripción del teléfono.
||
|-
| font-weight: bold;" | '''Prefijo Plantilla MAC'''
| | Determinar el fabricante a partir de su dirección MAC.
||
|-
| font-weight: bold;" | '''Tipo reset'''
| | Comando para permitir al modelo buscar su configuración en el servidor y que actualice el teléfono con la nueva configuración.
||Ninguno

Reset SIP Notify
|-
| font-weight: bold;" | '''Notificas Notificar reajuste'''
| | Comando para reiniciar el teléfono de manera remota .
||
|}

[[#Módelos_de_teléfonos | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

=== Rutas ===
El contenido de la pestaña '''''VIVA'''''it Call - Rutas' es el siguiente:
[[Archivo:43 Pestaña ViVAit Call - Rutas_2.jpg|center]]

==== Enfoque inicial ====

'''Datos básicos importantes para las prerutas:'''

* Número de entidad origen (inicialmente el llamante)
* Número de entidad destino (inicialmente el llamado)
* Categoria entrante

'''PASO 1.- ELECCION DE CANDIDATAS'''

Se eligen todas las prerutas candidatas a partir de:

1.- Para que la preruta sea candidata es imprescindible que corresponda la categoría entrante
2.- El número destino ha de coincidir con el campo "Prefijo entidad destino", coincidiendo con EL INICIO DEL CAMPO
3.- Se usa el "Porcentaje de llamadas", siendo el valor 0 equivalente a deshabilitar la preruta

A partir de aqui, VIVAit obtiene un subconjunto de posibles prerutas válidas

'''PASO 2.- ORDENACIÓN DE CANDIDATAS'''

El subconjunto obtenido se ordena siguiendo los criterios:

1.- Longitud de "prefijo entidad destino"--> La que tenga mejor coincidencia
2.- A misma longitud de "Prefijo entidad destino" --> La que tenga mejor coincidencia en campo "Prefijo entidad origen"
3.- Por porcentaje de llamadas

Estos criterios dan como resultado una lista ordenada de prerutas

'''PASO 3.- ELECCION DE MEJOR PRERUTA'''

De esta lista ordenada, y empezando de la primera hacia abajo, se elegirá la primera que cumpla el resto de campos.

==== Prerutas ====

Para todas las llamadas entrantes ( tanto internas, como externas) o salientes se desarrolla en el sistema un "prerouting", es decir, la fase de preenrutamiento se usa para toda llamada entrante/saliente en el sistema que implica que exista una preruta y que debe cumplir las reglas de la preruta. En caso de no cumplir una regla origen/destino la llamada se cuelga, es decir, si no se encuentra ninguna entrada adecuada, se considerara que es una llamada prohibida y lo tratara como destino inexistente.

Ante una nueva llamada en el sistema, se comprueban las prerutas que tengan '''''LA MISMA CATEGORIA''''' que el dispostivo origen.
De entre todas las prerutas de esa categoría, serán válidas todas las que cumplan las condiciones de origen y destino
De entre todas las válidas se utilizará la más restrictiva.

La preruta utilizada define el tipo de destino para esa llamada

[[Archivo:Funcionamiento prerutas.png|800px]]

Ejemplos de prerutas tipicamente necesarias:
* Una para todo el rango de extensiones y para cada categoría; por ejemplo si tenemos extensiones del 3000 al 3099 y categoría local y nacional, y queremos que ambas categorías llamen a las extensiones, entonces tendremos que crear dos prerutas

* Para cada "destino tipico saliente" (fijos, moviles, internacional....) existirá al menos una preruta para cada categoría que pueda utilizarlo

* Las facilidades del sistema (desvios, intrusiones, retrollamadas...) tendrán una preruta para cada categoría que pueda utilizarlo

* Otros servicios tales como salas de reuniones, VDN's, grupos de centralita, grupos de operadora...deberán tener una preruta para categoría que pueda utilizarlo

Un sistema con una configuración típica podría tener.
* Una preruta para las extensiones
* Una preruta para salida al exterior (sin limitaciones de llamadas por categorías)
* Una preruta para las facilidades
* Una preruta para el grupo de operadoras
* Una preruta para las salas de reuniones virtuales
* Una preruta con '''ignorar desvío incondicional = SI''' para que la secretaria pueda llamar al jefe pese a su desvío
Si el sistema tuviera diferentes categorías deberían multiplicarse las prerutas en función de los permisos que queramos dar...debe haber una preruta para categoría y destino

Una vez ingresemos a esa pantalla de "Prerutas" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]]).
[[Archivo:21 Busqueda en Vivait Call - Rutas - Pre_rutas.png|800px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) una "Pre Ruta" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá la siguiente ventana que nos muestra la ventana:

[[Archivo:Campos prerutas.png|600px]]

Las opciones con las que podemos encontrarnos son las siguientes:

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Descripción'''
| | Descripción de pre-ruta.
||
|-
| font-weight: bold;" | '''Lista Pre-Rutas'''
| |A que lista va a pertenecer nuestra pre-ruta (Obligatorio). Para más información[[#Lista rutas | ver sección '''''VIVA'''''it Call - Rutas - Lista rutas]].
||
|-
| font-weight: bold;" | '''Categoría entrante'''
| | Categoría asociada a la pre-ruta para una llamada entrante (obligatorio). Para más información [[#Categorías | ver sección '''''VIVA'''''it Call - Categorías]].
||
|-
| font-weight: bold;" | '''Prefijo entidad origen'''
| | Establecer una pre-ruta a un número de origen que cumpla con un determinado prefijo.
|| No debe ser una expresión regular. Ejemplo: 91 para distinguir las llamadas hechas en la comunidad de Madrid.
|-
| font-weight: bold;" | '''Min. Nº dígitos origen'''
| | El mínimo numero de digitos que un número de origen debe tener, es decir, deben ser igual o superior a este valor.
|| No existirá un limite mínimo si no asignamos algún valor o no es superior 0.
|-
| font-weight: bold;" | '''Max. Nº dígitos origen'''
| | El máximo numero de digitos un número de origen debe tener, es decir, deben ser igual o menor a este valor.
||No existirá un limite máximo si no asignamos algún valor o no es superior 0.
|-
| font-weight: bold;" | '''Expresión regular entidad origen'''
| | Alternativa para establecer una pre-ruta a un número de origen que cumpla con un determinado prefijo. Para mas información [[#Enlaces_de_interés | ver Enlaces de interes ]]
| |
|-
| font-weight: bold;" | '''Prefijo entidad destino'''
| | Establecer una pre-ruta a un número de destino que cumpla con un determinado prefijo.
|| No debe ser una expresión regular. Ejemplo: 91 para distinguir las llamadas hechas en la comunidad de Madrid.
|-
| font-weight: bold;" | '''Min. Nº dígitos destino'''
| | El mínimo numero de digitos un número de destino debe tener, es decir, deben ser igual o superior a este valor.
|| No existirá un limite mínimo si no asignamos algún valor o no es superior 0.
|-
| font-weight: bold;" | '''Max. Nº dígitos destino'''
| | El máximo numero de digitos que un número de destino debe tener, es decir, deben ser igual o menor a este valor.
||No existirá un limite máximo si no asignamos algún valor o no es superior 0.
|-
| font-weight: bold;" | '''Expresión regular entidad destino'''
| | Alternativa para establecer una pre-ruta a un número de destino que cumpla con un determinado prefijo. Para mas información [[#Enlaces_de_interés | ver Enlaces de interes ]]
| |
|-
| font-weight: bold;" | '''Caller Name'''
| | Nombre con el que se muestra la llamada.
||
|-
| font-weight: bold;" | '''Caller ID'''
| | Número que mostrara la llamada.
||
|-
| font-weight: bold;" | '''Cod. cliente'''
| | Número de código de cliente.
||
|-
| font-weight: bold;" | '''Categoría saliente'''
| | Categoría asociada a la pre-ruta para una llamada saliente. Para más información [[#Categorías | ver sección '''''VIVA'''''it Call - Categorías]]
||
|-
| font-weight: bold;" | '''Tipo destino saliente 1'''
| | Especifica el tipo de salida de la pre-ruta.
||Ninguno

Ruta externa

Extensión

Facilidad

Usuario

Sala de conferencia

Agente

VDN

Grupo ACD

Dejar mensaje

Dejar mensaje por ocupado

Dejar mensaje por no contesta

Leer buzón, grupo de salto

Grupo de operadoras

Grupo ACD de centralita

VDN corporativos

Extensión o Usuario

Usuario o Extensión

Volver a enrutar.
|-
| font-weight: bold;" | '''Destino saliente 1'''
| | cadena de texto que permite obtener el nuevo destino.
||
Si la cadena comienza por los caracteres que se indican, el significado es especial:

* "=" o cadena vacía, el nuevo destino es igual al de entrada al proceso.
* "+" el nuevo destino es igual al de entrada al proceso, con los caracteres a continuación de "+" como prefijo.
* "-" se quita el número de caracteres que se indica a continuación de "-".
* "_" lo que sigue al carácter es una expresión regular que se aplica al destino de entrada. Dicha expresión regular tiene obligatoriamente que contener una subcadena (definida entre paréntesis, según el estándar de expresiones regulares) que nos da el nuevo destino de salida. Si la expresión regular no se cumpliese, quiere decir que es una llamada prohibida y se encaminará hacia una facilidad por defecto.
* cualquier otro valor del primer carácter determina que es una constante que sustituye el valor a la entrada.
|-
| font-weight: bold;" | '''Tipo destino saliente 2'''
| | Especifica el tipo de salida de la pre-ruta.
||Ninguno

Ruta externa

Extensión

Facilidad

Usuario

Sala de conferencia

Agente

VDN

Grupo ACD

Dejar mensaje

Dejar mensaje por ocupado

Dejar mensaje por no contesta

Leer buzón, grupo de salto

Grupo de operadoras

Grupo ACD de centralita

VDN corporativos

Extensión o Usuario

Usuario o Extensión

Volver a enrutar.
|-
| font-weight: bold;" | '''Destino saliente 2'''
| | cadena de texto que permite obtener el nuevo destino.
||
Si la cadena comienza por los caracteres que se indican, el significado es especial:

* "=" o cadena vacía, el nuevo destino es igual al de entrada al proceso.
* "+" el nuevo destino es igual al de entrada al proceso, con los caracteres a continuación de "+" como prefijo.
* "-" se quita el número de caracteres que se indica a continuación de "-".
* "_" lo que sigue al carácter es una expresión regular que se aplica al destino de entrada. Dicha expresión regular tiene obligatoriamente que contener una subcadena (definida entre paréntesis, según el estándar de expresiones regulares) que nos da el nuevo destino de salida. Si la expresión regular no se cumpliese, quiere decir que es una llamada prohibida y se encaminará hacia una facilidad por defecto.
* cualquier otro valor del primer carácter determina que es una constante que sustituye el valor a la entrada.
|-
| font-weight: bold;" | '''Umbral llamada'''
| | Nos permite modificar el destino de salida como en caso anterior pero con dos particularidades.
||
* Si el valor de actual de "Umbral llam. cambio destino" (antes de incrementarse) supere o sea igual el valor de "Umbral llamada", se usara como destino tras el preenrutamiento, los valores de los campos "Tipo destino saliente 2" y "Destino saliente 2".
* Si el valor de actual de "Umbral llam. cambio destino" es menor o igual a cero; o si "Umbral llam. cambio destino" es inferior a "Umbral llamada", se usa como destino tras el preenrutamiento, los valores de los campos "Tipo destino saliente 1" y "Destino saliente 1".
|-
| font-weight: bold;" | '''Umbral llam. cambio destino'''
| | Un proceso periódico externo debe encargarse de poner a cero o decrementar este valor.
||
|-
| font-weight: bold;" | '''Porcentaje de llamadas'''
| | Se mide en tanto por cien. Indica el porcentaje de llamadas aleatorio que se van a encaminar por esa ruta.
|| Si el valor es 100, se aplica siempre y si es 0 el registro no se usa nunca (deshabilitado)
|-
| font-weight: bold;" | '''Hay segmentos'''
| | Indica al proceso de preenrutamiento que es preciso generar un segmento de tipo "preenrutamiento".
||Si / No.
|-
| font-weight: bold;" | '''Grabar enrutamiento'''
| | Este campo define si van a grabar las llamadas que se enruten para esta Pre-Ruta.
||Sin grabación

Grabación sin beep periódico

Grabación con beep periódico

Descartar grabación.

|-
| font-weight: bold;" | '''Dpto (Solo Eje 1)'''
| | Elegir un eje . Para más información [[#Ejes | ver sección Ejes]]
||
|-
| font-weight: bold;" | '''Ignorar Desvío incondicional '''
| | Habilitar el desvío incondicional para dar funcionalidad para que una secretaria pueda llamar al jefe pese a su desvío.
||Si / No.
|}

[[#Prerutas | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

==== Listas Rutas ====
En este apartado podemos observar todas las pre-rutas creadas anteriormente, etiquetarlas y asignar a cada pre-ruta un eje.

Una vez ingresemos a esa pantalla de "Listas Rutas" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]]).
[[Archivo:22 Busqueda en Vivait Call - Rutas - Lista rutas.png|800px|center]]
La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) una "Lista Ruta" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:
[[Archivo:46 Pestaña ViVAit Call - Rutas - Nueva lista rutas.png|center]]

Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre de la lista de pre-rutas (Obligatorio) .
|-
| font-weight: bold;" | '''Etiqueta1'''
| | Cadena de texto para distinguir los segmentos de preenrutamiento que tengan esta lista de pre-rutas asignada.
|-
| font-weight: bold;" | '''Etiqueta2'''
| | Cadena de texto para distinguir los segmentos de preenrutamiento que tengan esta lista de pre-rutas asignada.
|-
| font-weight: bold;" | '''Dpto'''
| | Elegir un eje (Obligatorio) . Para más información [[#Ejes | ver sección Ejes]]
|}

[[#Listas_Rutas| Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

==== Destinos externos ====

El esquema siguiente muestra el funcionamiento general del proceso de enrutamiento para llamadas que han de salir fuera del sistema; como ya se han indicado ha de entrar previamente en el proceso de preenrutamiento y salir exitosamente de este.

[[Archivo:Funcionamiento enrutamiento llamadas salientes.png|825px]]

Toda la configuración de los elementos reflejados en este esquema se hace desde el portal de administración de la plataforma '''''VIVA'''''it, con la excepción de algunos elementos de los enlaces exteriores.

La creación de enlaces exteriores requiere de la modificación del fichero '''ext_MARCAR_Externo_Particular.conf'''

Una vez ingresemos a esa pantalla de "Destinos externos" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]]).
[[Archivo:23 Busqueda en VIVAit Call - Rutas - Destinos Externos.png|800px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) un "Destino externo" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:
[[Archivo:48 Pestaña ViVAit Call - Rutas - Nuevo destino externo - Pestaña Destinos Externos.png|center]]

Las opciones con las que podemos encontrarnos en la Pestaña Destinos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Descripción'''
| | Descripción de la ruta saliente .
||
|-
| font-weight: bold;" | '''Categoría entrante'''
| | Categoría asociada a categoría saliente de la pre-ruta (obligatorio). Para más información [[#Categorías | ver sección '''''VIVA'''''it Call - Categorías]].
||
|-
| font-weight: bold;" | '''Prefijo entidad destino'''
| | Establecer una pre-ruta a un número de destino que cumpla con un determinado prefijo.
|| No debe ser una expresión regular. Ejemplo: 91 para distinguir las llamadas hechas en la comunidad de Madrid.
|-
| font-weight: bold;" | '''Min. Nº dígitos destino'''
| | El mínimo numero de digitos que un número de destino debe tener, es decir, deben ser igual o superior a este valor.
|| No existirá un limite mínimo si no asignamos algún valor o no es superior 0.
|-
| font-weight: bold;" | '''Máx. Nº dígitos destino'''
| | El máximo numero de digitos un número de destino debe tener, es decir, deben ser igual o menor a este valor.
||No existirá un limite máximo si no asignamos algún valor o no es superior 0.
|-
| font-weight: bold;" | '''Expresión regular ent. destino'''
| | Alternativa para establecer distinguir el número de destino que cumpla con un determinado prefijo para considerarlo destino externo. Para mas información [[#Enlaces_de_interés | ver Enlaces de interés ]]
| | Si tiene un algún valor, los campos los campos "Prefijo entidad Origen", "Min. Nº digitos origen" o "Max. Nº digitos origen" son ignorados.
|}

Un ejemplo podemos indicar que los números que empiecen por 6 y tenga un mínimo de 4 digitos se considera una llamada externa.

{| class="wikitable"
|-
|
Nota: Se necesita tener primero creado un objeto "Destino externo" para luego asignarle las relaciones necesarias.
|}

[[Archivo:49 Pestaña ViVAit Call - Rutas - Nuevo destino externo - Pestaña Relacion.png|center]]
Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Destinos'''
| | Campo de solo lectura. Indica a que destino externo se aplica la relación.
||
|-
| font-weight: bold;" | '''Enlace Exterior'''
| | Establecer cual es el troncal por donde dispositivos contactan al exterior. Para más información[[#Enlace exterior | ver sección '''''VIVA'''''it Call - Dispositivos - Enlace exterior ]].
||
|-
| font-weight: bold;" | '''Prioridad'''
| | Establecer un nivel de prioridad. Cuanto más alto sea el valor más prioritario es el enlace exterior.
||
|-
| font-weight: bold;" | '''Caller Name'''
| |Nombre con el que se mostrara al exterior.
||
|-
| font-weight: bold;" | '''Num. Llamada'''
| | Numero por el que se mostrara al exterior.
||
|-
| font-weight: bold;" | '''Destino Saliente'''
| | Cadena de texto que identifica el destino saliente.
|| Además, si la cadena comienza por los caracteres que se indican, el significado es especial:

* "=" o cadena vacía, el nuevo destino es igual al de entrada al proceso.
* "+" el nuevo destino es igual al de entrada al proceso, con los caracteres a continuación de "+" como prefijo.
* "-" se quita el número de caracteres que se indica a continuación de "-".
* "_" lo que sigue al carácter es una expresión regular que se aplica al destino de entrada. Dicha expresión regular tiene obligatoriamente que contener una subcadena (definida entre paréntesis, según el estándar de expresiones regulares) que nos da el nuevo destino de salida. Si la expresión regular no se cumpliese, se propaga el valor de entrada al proceso.
* cualquier otro valor del primer carácter determina que es una constante sin ninguna modificación.
|}

[[#Destinos_externos | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

== '''''VIVA'''''it Meet ==

=== Configuración ===

Para poder configurar un entorno de '''''VIVA'''''it Meet son imprescindibles los siguientes elementos:

* Nodo tipo Meet.
* Plantillas de meet.
* Trunks.

Para crear un '''nodo tipo Meet''' necesitamos la dirección IP del equipo en el que se ha instalado el Meet.

[[File:Nuevo-Nodo-Meet.jpg|800px]]

Para crear una '''plantilla de Meet''' seleccionaremos como clase '''enlace exterior''' y añadiremos los campos necesarios, tal y como se muestra en la siguiente imagen:

[[File:Platilla-Meet.jpg|800px]]

Por último crearemos un '''TRUNK''' en el menú '''Enlaces Externos''' de la aplicación:

[[File:Trunk-Meet.jpg|800px]]

'''''<big>Consideraciones:</big>'''''

* Al igual que necesitamos una plantilla específica para '''''VIVA'''''it Meet, también necsitaremos otra específica para el futuro '''''MOVE'''''.

[[File:Plantilla-Move.jpg|800px]]

* Para '''''MOVE''''' necesitamos una categoría especial que nos permita controlar las llamadas que se van a poder realizar.
* Para '''''MOVE''''' los Trunk SIP y las extenciones deben llevar el campo INSECURE=NO.

=== Inicio ===

Un administrador de '''''VIVA'''''it Call solo verá el menú '''''VIVA'''''it Meet si tiene permisos de Meet en su usuario. Estos permisos solo son válidos para administrar el Meet en '''''VIVA'''''it Call, no son los necesarios para acceder a las Salas.

[[File:General_Usuarios_Permisos.jpg|800px]]

Para asignar estos permisos a un usuario tendremos que dar permisos al usuario para la aplicación Meet.

[[File:General_Usuarios_Permisos_Nuevo.jpg|800px]]

Cuando un usuario tiene permisos en la aplicación Meet aparecerá una pestaña nueva:

[[File:General_Usuarios_Administrar_Editar_Meet.jpg|800px]]

En el campo Display pondremos el identificador que aparecerá posteriormente en la ventana del portal Web.

Una vez realizada esta configuración previa un administrador de '''''VIVA'''''it Call podrá crear los elementos necesarios para configurar un Meet.

[[File:Barra_VIVAit Call_Meet.jpg|500px]]

=== Explotación de '''''VIVA'''''it Meet ===

'''''VIVA'''''it Meet es una solución de '''''md'''''tel incluida en su aplicación '''''VIVA'''''it Call.

'''''VIVA'''''it Meet permite que los usuarios se conecten a un “espacio” común en el que comparten servicios de chat, comparten fichero de notas y comparten pantallas (aplicaciones o escritorio).

La solución permite el acceso de los usuarios a distintas herramientas, en función del rol con el que acceden a los “espacios” (Salas).

Para configurar el servicio de Meet es necesario disponer de:
* Grupo de Acceso
* Perfil de Sala
* Sala de Meet

El menú en '''''VIVA'''''it Call tiene las siguientes opciones:

[[File:Opciones_Menu_VIVAit Meet.jpg|200px]]

==== Grupo de Acceso ====

En los grupos de acceso se configuran el nodo de audío al que se conectará el grupo así como los números (interno y externo) que se utilizarán para que los asistentes mediante audio puedan acceder a la Sala.

Los campos para configurar un grupo de acceso son los siguientes:

{| class="wikitable"
|-
! Nombre del Campo !! Descripción
|-
| Número || Número del grupo de acceso. Se trata de un campo obligatorio.
|-
| Nombre en pantalla || Nombre que se presentará en pantalla.
|-
| Descripción || Pequeña descripción del grupo de acceso.
|-
| Nodo audio || Nodo de audio al que conectamos el grupo de acceso.
|-
| Número de acceso interno || Será el número interno a través del que nos conectaremos a la Sala cuando asistamos como oyentes.
|-
| Número de acceso externo || Será el número externo a través del que nos conectaremos a la Sala cuando asistamos como oyentes.
|-
| Grabar por enrutamiento || Indica si grabamos el Grupo de acceso, las opciones son: Sin grabación, Grabación sin beep periódico, Grabación con beep periódico y Descartar grabación.
|-
| Dpto. || Campo obligatorio. Indica el eje al que pertenece el grupo de acceso.
|}

==== Perfil de Sala ====

En el perfil de la Sala se configuran algunos parámetros técnicos.

La imagen de la ventana de configuración en la que se muestra a continuación:

[[File:Perfil_de_sala_nuevo.jpg|800px]]

Los campos para configurar un Perfil Sala Meet son los siguientes:

{| class="wikitable"
|-
! Nombre del Campo !! Descripción
|-
| Nombre || Nombre del perfil. Es un campo obligatorio.
|-
| Descripción || Breve descripción del Perfil de Sala Meet.
|-
| Nº Máximo Participantes || Indica el número máximo de personas que pueden emitir. No tiene en cuenta a los oyentes ya que estos no emiten.
|-
| Tasa de bits || Ancho de banda que se consume por usuario.
|-
| Frecuencia FIR || Parámetro técnico.
|-
| Codecs audio || rowspan="3"| Las Salas con acceso telefónico utilizan el codec '''pcma''' y es importante que solo se utilice un codec. Si la Sala no tiene acceso telefónico indicaremos codec '''opus'''.
|-
| Codecs audio_1
|-
| Codecs audio_2
|-
| Codecs video || rowspan="3"| Se recomienda utilizar el codec vp8.
|-
| Codecs video_1
|-
| Codecs video_2
|-
| Paquetes activos audio ||rowspan="2"| Se trata de parámetros técnicos.
|-
| Promedio nivel audio
|-
| Plantilla asunto || rowspan="2"| Se trata de las plantillas que se utilizarán en el correo que el sistema envía cuando se invita a asistentes a la Sala.
|-
| Plantilla cuerpo
|-
| Minutos max. reunión || Indica la duración máxima de la convocatoria. ''Si el número no es mayor de 0 no será posible enviar invitacines desde el portal web a otros usuarios.''
|-
| Minutos antelación || Indica la antelación (en minutos) con la que se puede acceder a la Sala.
|-
| Nivel audio ext.||rowspan="7"|Parámetros técnicos.
|-
| Scalable video coding
|-
| Eventos audio
|-
| Orientación video
|-
| Grabar
|-
| Retrasar la salida
|-
| Documentos compartidos
|}

==== Salas de Meet ====

En este menú prepararemos el "espacio" al que se conectarán los usarios, para ello debemos crear una Sala Meet.

[[File:Salas_Meet_Sala.jpg|800px]]

Los campos para configurar una Sala Meet son los siguientes:

{| class="wikitable"
|-
! Nombre del Campo !! Descripción
|-
| Nº de Sala || Número de la Sala, coincide con el número que pide la locucióon para accesos telefónicos.
|-
| Nombre || Nombre de la Sala. Este campo es obligatorio.
|-
| Nombre en pantalla || Nombre que aparecerá en el portal de Meet.
|-
| Descripción || Pequeña descripción de la Sala.
|-
| Perfil de Sala || Perfil asociado a la Sala (está relacionado con los parámetros técnicos de la Sala).
|-
| Grupo de Acceso Sala || Grupo a través del cual los asistentes se conectarán a la Sala, está relacionado con el acceso telefónico.
|-
| Pin administrador '''(*)''' || Pin de acceso a la Sala para administradores. Éstos acceden a la Sala a través del Grupo de Acceso y una locución les solicita el número de Sala y el pin de acceso.
|-
| Pin participante '''(*)''' || Pin de acceso a la Sala para participantes. Éstos acceden a la Sala a través del Grupo de Acceso y una locución les solicita el número de Sala y el pin de acceso.
|-
| Pin oyente '''(*)''' || Pin de acceso a la Sala para oyentes. Éstos acceden a la Sala a través del Grupo de Acceso y una locución les solicita el número de Sala y el pin de acceso.
|-
| Mail origen invitación || Dirección de email de aparece como remitente cuando enviamos una invitación a una Sala desde la propia Sala. Si el campo no se rellena aparecerá como remitente '''vivait-meet-18-04@mdtel.local'''.
|-
| Nodo || Nodo en el que conectamos la Sala. Debe ser un nodo '''tipo Meet'''.
|-
| Locución || Locución que se utilizará para dar la bienvenida a la Sala cuando un usuario se conecta por audio.
|-
| Dpto. || Campo obligatorio. Indica el eje al que pertenece la Sala.
|}

'''(*)''' Se pueden asignar pines distintos en función del rol del asistente (el pin corresponde a la clave de acceso que solicita la locución telefónica a los asistentes) pero en la práctica un asistente telefónico a una Sala no puede realizar acciones diferentes en función del rol asignado, solo puede escuchar.

[[#Destinos_externos | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

==''VIVA''it Response ==
Esta pestaña ofrece al usuario la gestión y configuración de las locuciones y música en espera. El contenido de la pestaña '''''VIVA'''''it Response' es el siguiente:

[[Archivo:59 Pestaña ViVAit Response.jpg|center]]

[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver arriba]
=== Locuciones ===
Esta pestaña permite al usuario insertar y gestionar sus locuciones.

Una vez ingresemos a esa pantalla de "Locuciones" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])

[[Archivo:24 Busqueda en VIVAit Response - Locuciones.png|700px|center]]

Si pulsamos el boton buscar aparecerán las locuciones disponibles. Pulsando sobre la flecha indicada podremos escuchar su contenido e incluso descargarlas.

[[File:Escuchar_Locuciones.png|600px|centro]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]].

Para dar de alta o modificar (Editar) una "Locución" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:60 Pestaña ViVAit Response- Locuciones - Nueva locucion.jpg|center]]
Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre de la locución (Obligatorio→ no deben utilizase espacios en blanco).
||
|-
| font-weight: bold;" | '''Descripción'''
| | Descripción de la locución.
||
|-
| font-weight: bold;" | '''Nodo'''
| | Nodo donde se va a alojar la locución (Obligatorio). Para más información [[#Nodos | ver sección General - Nodos]].
||
|-
| font-weight: bold;" | '''Tipo Locución'''
| | Indicar de qué tipo es la locución.
||MOH
Sound
|-
| font-weight: bold;" | '''Grupo Locución'''
| | Indicar a que grupo pertenece la locución (obligatorio). Para más información[[#Grupo de Locuciones | ver sección '''''VIVA'''''it Response - Grupo de Locuciones ]]
||
|-
| font-weight: bold;" | '''Archivo adjunto'''
| | Para adjuntar el archivo con la locución. Nuestra plataforma puede importar archivos con extensión '''.wav''' (mono, 8.000 Hez., 16 bits, formato PCM), '''.alaw''' (mono, 8.000 Hez., 16 bits, formato A-Law) y '''.g729'''" (Obligatorio).
||
|}

A partir de la versión 3.2 de '''''VIVA'''''it se pueden subir más de 100 locuciones a través del portal de administración.

[[#Locuciones | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

=== Música en espera ===
Esta pestaña permite al usuario crear y modificar la configuración de música en espera.

Una vez ingresemos a esa pantalla de "Música en espera" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])
[[Archivo:25 Busqueda en VIVAit Response - Música en espera.png|700px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) una "Música en espera" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:
[[Archivo:61 Pestaña ViVAit Response - Musica en espera - Nueva musica en espera.png|center]]
Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre de la MOH (Obligatorio).
|-
| font-weight: bold;" | '''Descripción'''
| | Descripción breve del uso de la MOH (Obligatorio).
|-
| font-weight: bold;" | '''Plantilla'''
| | Selección de la plantilla empleada para la música en espera (Obligatorio). Para más información[[#Plantillas | ver sección General - Plantillas ]]
|-
| font-weight: bold;" | '''Formato del fichero'''
| | Se pueden utilizar ficheros con extensión '''.mp3'''.
|}
[[#Música_en_espera | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

=== Grupo de Locuciones ===

Una vez ingresemos a esa pantalla de "Grupo de Locuciones" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])

[[Archivo:26 Busqueda en VIVAit Response - Grupo Locuciones.png|700px|center]]
La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) un "Grupo de Locución" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:62 Pestaña ViVAit Response- Grupo de Locuciones - Nuevo grupo de locucion.jpg|center]]

Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre asignado para el Grupo de Locuciones (obligatorio).
|-
| font-weight: bold;" | '''Dir. relativo'''
| | Directorio relativo que podemos indicar para almacenar el grupo de locuciones (obligatorio).
|}
[[#Grupo_de_Locuciones | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

==''VIVA''it Suite ACD+ ==

El ACD es una de las funcionalidades más destacadas incorporadas en una solución de Contact Center. Esta solución ofrece funciones avanzadas de cola de espera y enrutamiento de llamadas, para optimizar la gestión de grandes flujos de llamadas entrantes, y mantener al mismo tiempo la calidad de servicio para el llamante.

A continuación se enumeran las funcionalidades y beneficios más importantes de un ACD:

* Aplica inteligencia de negocio al tráfico de llamadas entrantes, asignando las llamadas a colas y distribuyéndolas de forma efectiva a los agentes en espera.
* Agiliza la administración de llamadas con tres algoritmos de routing: circular, lineal y de agentes a grupos de trabajo.
* Incluye mensajes de aviso de espera, que se emiten a intervalos programados para llamadas en espera y a clientes en una cola.
* Soporta un número ilimitado de supervisores.
* Permite una mejor interacción con el cliente y tiempos de aprendizaje reducidos, al proporcionar una supervisión discreta de la actividad de los agentes para garantizar la calidad.

Con esta solución profesional, las pequeñas y medianas empresas pueden mejorar de forma decisiva tanto sus servicios de atención telefónica y de bienvenida, como los relacionados con éstos. A continuación enumeramos ''aspectos importantes'':

* Un ACD mejora de los niveles de servicio al cliente y tiempos de respuesta.
* Permite la reducción de niveles de llamadas no atendidas.
* Acelerar los tiempos de respuesta a las llamadas.

Esta pestaña ofrece al usuario la gestión y configuración de servicios de call center (colas, VDNs, monitores, campañas...). El contenido de la pestaña ''''''VIVA'''''it Suite ACD+' es el siguiente:

[[File:63 Pestaña ViVAit Suite ACD+.jpg|center]]

[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver arriba]
=== Campañas ===

Este apartado sirve para crear, modificar y gestionar las campañas para call center.

Una vez ingresemos a esa pantalla de "Campañas" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])
[[Archivo:27 Busqueda en VIVAit Suite ACD+ - Campañas.png|750px| center]]
La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) una "Campaña" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:64 Pestaña ViVAit Suite ACD+ - Campañas - Nueva Campaña.jpg|800px|center]]

Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre de la campaña (Obligatorio).
||
|-
| font-weight: bold;" | '''Descripción'''
| | Descripción de la campaña (Obligatorio).
||
|-
| font-weight: bold;" | '''Notas'''
| | Notas sobre la campaña. Para Yoigo este campo se usa para representar
en el formulario la categoría que se usará en pregunta abierta .
||
|-
| font-weight: bold;" | '''Datos del formulario '''
| colspan="2" | Este apartado se rellena solo en el caso de tener un formulario personalizado. En el caso contrario es necesario marcar la casilla “Ignorar formulario”. '''''Explicado en una tabla mas abajo'''''.
|-
| font-weight: bold;" | '''Tipo Final'''
| | Se indica el tipo de final elegido para la campaña. Para más información[[#Finales | '''''VIVA'''''it Suite ACD+ - Enumerados - Finales]].

||Genérico : se cargara todos los finales a la campaña que no le fueron asignados.

Especifico : se cargara todos los finales a la campaña que le fueron asignados.
|-
| font-weight: bold;" | '''Tiempo administrativo'''
| | Son los segundos que se dejan al agente para terminar de rellenar el formulario, o realizar otro tipo de gestión una vez finalizada la llamada. Para desactivar esta opción es necesario marcar la casilla “Ignorar tiempo administrativo”.
||
|-
| font-weight: bold;" | '''¿Está activa?'''
| | Sirve para arrancar o parar la campaña y conocer su estado.
| | Si / No.
|-
| font-weight: bold;" | '''Estrategia'''
| | Estrategia empleada por la campaña. Para más información[[#Estrategias | '''''VIVA'''''it Suite ACD+ - Marcador - Estrategias ]]

|| Estrategia-Defecto u otros.
|-
| font-weight: bold;" | '''Categoría'''
| | Categoría de la campaña. Para más información [[#Categorías | ver sección '''''VIVA'''''it Call - Categorías]]
||
|-
| font-weight: bold;" | '''Número saliente'''
| | Número al mostrar en las llamadas salientes.
||
|-
| font-weight: bold;" | '''Nombre saliente'''
| | Nombre al mostrar en las llamadas salientes.
||
|-
| font-weight: bold;" | '''Lista Robinson'''
| | Lista negra de contactos asociada a la campaña. Para más información [[#Listas Robinson |'''''VIVA'''''it Suite ACD+ - Marcador - Listas Robinson ]]
||
|-
| font-weight: bold;" | '''Max. Días reprogramación'''
| | Número de días máximo que se puede reprogramar la campaña.
||
|-
| font-weight: bold;" | '''Fecha max.Reprogramación'''
| | Fecha máxima permitida para reprogramar la campaña.
||

|-
| font-weight: bold;" | '''Máscara reprogramación'''
| |Máscara de reprogramación para el destino.
||

|-
| font-weight: bold;" | '''Modo de grabación'''
| | Indica si un agente ACD puede tener el control de cuando se graba.
|| Sin grabación: no permite tener el control de grabación
Grabación bajo demanda de inicio grabando: permite al agente ACD decidir cuando pausar la grabación.

Grabación bajo demanda de inicio sin grabar: permite al agente ACD iniciar y parar la grabación.

Grabar todo: se graba independientemente de la acción del agente ACD.
|-
| font-weight: bold;" | '''Dpto'''
| |Elegir un eje (Obligatorio) . Para más información [[#Ejes | ver sección Ejes]].
||
|}

'''Datos del formulario'''

Este apartado se rellena solo en el caso de tener un formulario personalizado que se va a usar en la campaña que estemos creando. En el caso contrario es necesario marcar la casilla “Ignorar formulario”.

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Formulario'''
| |Nombre del formulario.
|-
| font-weight: bold;" | '''Tipo formulario'''
| | Seleccionar uno de los formularios existentes. Para más información [[#Formularios | ver sección '''''VIVA'''''it Suite ACD+ - Formularios ]]
|-
| font-weight: bold;" | '''Clase'''
| | Nombre de la clase del formulario cuando es integrado por el cliente.
|-
| font-weight: bold;" | '''Accion'''
| | En este campo se indica la "acción" que el sistema realizará a la vez que se abre el formulario. Es '''necesario''' que el tipo de formulario sea "Creado URL" o "Integrado cliente URL". Si la acción consite en ejecutar un archivo '''.exe''' los posibles parámetros irán '''obligatoriamente''' en los campos '''Param. de cadena 3''' o '''Param. de cadena 4'''.
|-
| font-weight: bold;" | '''Param. númerico 1'''
| | En el caso que el tipo de formulario sea "Creado URL" o "Integrado cliente url" , permite meter un parámetro numérico a la URL si es necesario. En caso contrario no se tienen en cuenta.
|-
| font-weight: bold;" | '''Param. númerico 2'''
| | En el caso que el tipo de formulario sea "Creado URL" o "Integrado cliente url" , permite meter otro parámetro numérico a la URL si es necesario. En caso contrario no se tienen en cuenta.
|-
| font-weight: bold;" | '''Param. de cadena 3'''
| | En el caso que el tipo de formulario sea "Creado URL" o "Integrado cliente url" , permite meter una cadena de texto como parámetro de la '''acción''' indicada. Cuando la acción consiste en ejecutar un archivo '''.exe''' los posibles parámetros habrán de indicarse en este campo o en el siguiente.
|-
| font-weight: bold;" | '''Param. de cadena 4'''
| | En el caso que el tipo de formulario sea "Creado URL" o "Integrado cliente url" , permite meter una cadena de texto como parámetro de la '''acción''' indicada. Cuando la acción consiste en ejecutar un archivo '''.exe''' los posibles parámetros habrán de indicarse en este campo o en el anterior.
|}

A continuación se muestra un ejemplo de campaña con un formulario asignado y una acción que ejecuta un archivo .exe tras la apertura del formulario (los parámetros indicados son de ejemplo).

[[File:Imagen1.jpg|700 px]]

'''Parámetros URL'''

Los parámetros que podemos pasar a la URL son los siguientes:

*colat: colateral
*campanna: Nombre de la campaña
*vdn: Descripción del VDN
*acd: Número del grupo ACD
*nombre: Nombre del contacto
*apell1: Primer apellido del contacto
*apell2: Segundo apellido del contacto
*empresa: Nombre de la empresa del contacto
*email: email del contacto
*opcCad1: Parámetro cadena 1 opcional
*opcCad2: Parámetro cadena 2 opcional
*opcCad3: Parámetro cadena 3 opcional
*opcCad4: Parámetro cadena 4 opcional
*opcCad5: Parámetro cadena 5 opcional
*opcCad6: Parámetro cadena 6 opcional
*opcCad7: Parámetro cadena 7 opcional
*opcCad8: Parámetro cadena 8 opcional
*agnNum: Número de login del agente
*agnCuenta: Nombre de la cuenta de usuario
*codCliente: Código de cliente
*formulario: Nombre del formulario
*par1: Parámetro numérico 1 correspondiente al formulario
*par2: Parámetro numérico 2 correspondiente al formulario
*par3: Parámetro cadena 3 correspondiente al formulario
*par4: Parámetro cadena 4 correspondiente al formulario
[[#Campañas | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

=== VDN (VIVAit Suite ACD+) ===

Una vez ingresemos a esa pantalla de "VDN ('''''VIVA'''''it Suite ACD+)" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])
[[Archivo:28 Busqueda en VIVAit Suite ACD+ - VDN.png|750px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) un "VDN" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:65 Pestaña ViVAit Suite ACD+ - VDN - Nuevo VDN.jpg|center]]
Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Número'''
| | Número de VDN (Obligatorio).
||
|-
| font-weight: bold;" | '''Nombre mostrar'''
| | Nombre que presentara el VDN al llamante.
||
|-
| font-weight: bold;" | '''Descripción'''
| | Descripción del VDN (Obligatorio).
||
|-
| font-weight: bold;" | '''Notas'''
| | Campo Notas del VDN para empleo en los formularios.
||
|-
| font-weight: bold;" | '''Nodo'''
| | Nodo donde va a pertenecer dicho VDN (obligatorio). Para más información [[#Nodos | ver sección General - Nodos]].
||
|-
| font-weight: bold;" | '''Datos del formulario '''
| colspan="2" | Este apartado se rellena solo en el caso de tener un formulario personalizado que se va a usar en el VDN que estamos creando. En el caso contrario es necesario marcar la casilla “Ignorar formulario”. '''''Explicado en una tabla mas abajo'''''
|-
| font-weight: bold;" | '''Tipo Final'''
| | Se indica el tipo de final elegido para la campaña. Para más información[[#Finales | '''''VIVA'''''it Suite ACD+ - Enumerados - Finales]]

||Genérico : se cargara todos los finales a la campaña que no le fueron asignados.

Especifico : se cargara todos los finales a la campaña que le fueron asignados.
|-
| font-weight: bold;" | '''Tiempo administrativo'''
| | tiempo en segundos para los agentes en el VDN. Es un parámetro que indica el tiempo en volver a estar preparado el agente para la aplicación de VIVAit Desk.

Si ignoramos el tiempo administrativo del VND, se tomara el tiempo administrativo dado para el grupo ACD asociado. Para ignorar el tiempo administrativo solo es necesario marcar la casilla “Ignorar tiempo administrativo”.
||
|-
| font-weight: bold;" | '''Cód. Cliente'''
| | Código del cliente.
||
|-
| font-weight: bold;" | '''Modo de grabación'''
| | Indica si un agente ACD puede tener el control de cuando se graba.
|| Sin grabación: no permite tener el control de grabación
Grabación bajo demanda de inicio grabando: permite al agente ACD decidir cuando pausar la grabación.

Grabación bajo demanda de inicio sin grabar: permite al agente ACD iniciar y parar la grabación.

Grabar todo: se graba independientemente de la acción del agente ACD.
|-
|-
| font-weight: bold;" | '''Grabar enrutamiento'''
| | Este campo define si van a grabar las llamadas que se enruten para este VDN.
||Sin grabación

Grabación sin beep periódico

Grabación con beep periódico

Descartar grabación.
|-
| font-weight: bold;" | '''Dpto'''
| | Elegir un eje (Obligatorio) . Para más información [[#Ejes | ver sección Ejes]]
||
|}
'''Datos del formulario'''

Este apartado se rellena solo en el caso de tener un formulario personalizado que se va a usar en el VDN que estamos creando. En el caso contrario es necesario marcar la casilla “Ignorar formulario”.

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Formulario'''
| |Nombre del formulario.

|-
| font-weight: bold;" | '''Tipo formulario'''
| | Seleccionar uno de los tipos de formularios existentes. Para más información[[#Finales | '''''VIVA'''''it Suite ACD+ - Enumerados - Finales]]
|-
| font-weight: bold;" | '''Clase'''
| | Nombre de la clase del formulario cuando es integrado por el cliente.
|-
| font-weight: bold;" | '''Accion'''
| | En este campo se indica la "acción" que el sistema realizará a la vez que se abre el formulario. Es '''necesario''' que el tipo de formulario sea "Creado URL" o "Integrado cliente URL". Si la acción consite en ejecutar un archivo '''.exe''' los posibles parámetros irán '''obligatoriamente''' en los campos '''Param. de cadena 3''' o '''Param. de cadena 4'''.
|-
| font-weight: bold;" | '''Param. númerico 1'''
| | En el caso que el tipo de formulario sea "Creado URL" o "Integrado cliente url" , permite meter un parámetro numérico a la URL si es necesario. En caso contrario no se tienen en cuenta.
|-
| font-weight: bold;" | '''Param. númerico 2'''
| | En el caso que el tipo de formulario sea "Creado URL" o "Integrado cliente url" , permite meter otro parámetro numérico a la URL si es necesario. En caso contrario no se tienen en cuenta.
|-
| font-weight: bold;" | '''Param. de cadena 3'''
| | En el caso que el tipo de formulario sea "Creado URL" o "Integrado cliente url" , permite meter una cadena de texto como parámetro de la '''acción''' indicada. Cuando la acción consiste en ejecutar un archivo '''.exe''' los posibles parámetros habrán de indicarse en este campo o en el siguiente.
|-
| font-weight: bold;" | '''Param. de cadena 4'''
| | En el caso que el tipo de formulario sea "Creado URL" o "Integrado cliente url" , permite meter una cadena de texto como parámetro de la '''acción''' indicada. Cuando la acción consiste en ejecutar un archivo '''.exe''' los posibles parámetros habrán de indicarse en este campo o en el anterior.
|}
En un futuro se contempla que pueda usarse una plantilla personalidad para un grupo VDN del dialplan.

A continuación se muestra un ejemplo de campaña con un formulario asignado y una acción que ejecuta un archivo .exe tras la apertura del formulario (los parámetros indicados son de ejemplo).

[[File:Imagen1.jpg|700 px]]

'''Parámetros URL'''

Los parámetros que podemos pasar a la URL son los siguientes:

*colat: colateral
*campanna: Nombre de la campaña
*vdn: Descripción del VDN
*acd: Número del grupo ACD
*nombre: Nombre del contacto
*apell1: Primer apellido del contacto
*apell2: Segundo apellido del contacto
*empresa: Nombre de la empresa del contacto
*email: email del contacto
*opcCad1: Parámetro cadena 1 opcional
*opcCad2: Parámetro cadena 2 opcional
*opcCad3: Parámetro cadena 3 opcional
*opcCad4: Parámetro cadena 4 opcional
*opcCad5: Parámetro cadena 5 opcional
*opcCad6: Parámetro cadena 6 opcional
*opcCad7: Parámetro cadena 7 opcional
*opcCad8: Parámetro cadena 8 opcional
*agnNum: Número de login del agente
*agnCuenta: Nombre de la cuenta de usuario
*codCliente: Código de cliente
*formulario: Nombre del formulario
*par1: Parámetro numérico 1 correspondiente al formulario
*par2: Parámetro numérico 2 correspondiente al formulario
*par3: Parámetro cadena 3 correspondiente al formulario
*par4: Parámetro cadena 4 correspondiente al formulario

[[#VDN_(VIVAit_Suite_ACD+) | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

=== Grupos ACD ===

Una vez ingresemos a esa pantalla de "Grupos ACD" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])
[[Archivo:29 Busqueda en VIVAit Suite ACD+ - Grupos ACD.png|800px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) un "Grupo ACD" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[File:Portapapeles01.jpg]]

Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Número'''
| | Número del grupo ACD (Obligatorio).
||
|-
| font-weight: bold;" | '''Nombre mostrar'''
| | Nombre que presentara el grupo ACD.
||
|-
| font-weight: bold;" | '''Plantilla'''
| | Plantilla empleada para el grupo ACD.
||
|-
| font-weight: bold;" | '''Música'''
| | Definimos la música que escuchará el llamante cuando está en cola.
||
|-
| font-weight: bold;" | '''Nodo'''
| | Nodo al que va a pertenecer dicha cola (Obligatorio). Para más información [[#Nodos | ver sección General - Nodos]].
||
|-
| font-weight: bold;" | '''Descripción'''
| | Breve descripción sobre el grupo ACD.
||
|-
| font-weight: bold;" | '''Notas'''
| | El campo es empleado por algunos formularios para mostrar cierta información.
||
|-
| font-weight: bold;" | '''Objetivo NS'''
| | Tiempo de nivel de servicio que se debe alcanzar en la cola . Este parámetro indica el tiempo máximo de espera en segundos que debería alcanzar una llamada de entrada en la cola de espera para el grupo ACD.
Siempre que se haga un calculo de prioridad de las llamadas, aquellas colas con valor menor podrán tener una prioridad mayor respecto a las colas con un valor mayor.
Para mas información ver [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit#Mecanismo_de_prioridad_adaptativa | mecanismo de asignación de llamadas en colas a agentes ]].
||

|-
| font-weight: bold;" | '''Peso'''
| | Entre las colas es el nivel de prioridad de la cola.
Para una llamada de entrada es la cantidad o factor de mejora de prioridad en la cola de espera. Siempre que se haga un calculo de prioridad de las llamadas, aquellas colas con valor alto podrán tener una prioridad mayor respecto a las colas con un valor menor.
Para mas información ver [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit#Mecanismo_de_prioridad_adaptativa | mecanismo de asignación de llamadas en colas a agentes ]].
|| 0

1

10

100
|-
| font-weight: bold;" | '''Grabar enrutamiento'''
| | Este campo define si van a grabar las llamadas que se enruten para este Grupo ACD.
||Sin grabación

Grabación sin beep periódico

Grabación con beep periódico

Descartar grabación.
|-
|font-weight: bold;" | '''Datos del formulario '''
| colspan="2" | Este apartado se rellena solo en el caso de tener un formulario personalizado. En el caso contrario es necesario marcar la casilla “Ignorar formulario”. '''''Explicado en una tabla mas abajo'''''
|-
| font-weight: bold;" | '''Tiempo Administrativo'''
| | tiempo en segundos para los agentes en el grupo ACD. Es un parámetro que indica el tiempo en volver a estar preparado el agente para recibir una llamada desde la aplicación de VIVAit Desk.
|-
| font-weight: bold;" | '''Tipo cola'''
| | Elegir el tipo de cola.
||Llamada entrante

Llamada saliente bajo demanda

Llamada saliente vista previa

Llamada saliente progresivo

Llamada saliente predictivo

Backoffice

Backoffice interrumpible
|-
| font-weight: bold;" | '''Id saliente'''
| | El número al mostrar en las llamadas salientes.
||
|-
| font-weight: bold;" | '''Nombre saliente'''
| | El nombre al mostrar en las llamadas salientes.
||
|-
| font-weight: bold;" | '''Tipo Final'''
| | Se indica el tipo de final elegido para el grupo. Para más información[[#Finales | '''''VIVA'''''it Suite ACD+ - Enumerados - Finales]]

||Genérico : se cargara todos los finales a la campaña que no le fueron asignados.

Especifico : se cargara todos los finales a la campaña que le fueron asignados.
|-
| font-weight: bold;" | '''Agente tiempo'''
| | Ofrecer un tiempo administrativo al agente ACD antes de ponerle en estado preparado. El tiempo se le asigna en el campo "Tiempo admin. de centralita".
||Si / No.
|-
| font-weight: bold;" | '''Algoritmo predicativo'''
| | Asociar un algoritmo predicativo a la cola.
||
|-
| font-weight: bold;" | '''Tiempo admin. de centralita'''
| | Tiempo en segundos que asterisk considerara que tiene un agente para "prepararse" al terminar una llamada, y poder esta listo para poder recibir la siguiente llamada. '''Este tiempo debería ser menor que el tiempo administrativo'''.
||
|-
| font-weight: bold;" | '''Modo de grabación'''
| | Indica si un agente ACD puede tener el control de cuando se graba.
|| Sin grabación: no permite tener el control de grabación
Grabación bajo demanda de inicio grabando: permite al agente ACD decidir cuando pausar la grabación.

Grabación bajo demanda de inicio sin grabar: permite al agente ACD iniciar y parar la grabación.

Grabar todo: se graba independientemente de la acción del agente ACD.
|-
| font-weight: bold;" | '''Grabar seg. Cola'''
| | Indica si se graba o no el segmento de cola.
||Si / No.
|-
| font-weight: bold;" | '''Categoría'''
| | Elegir la categoría del grupo ACD (Obligatorio). Para más información [[#Categorías | ver sección '''''VIVA'''''it call - Categorías]]
||
|-
| font-weight: bold;" | '''Dpto'''
| |Elegir un eje (Obligatorio) . Para más información [[#Ejes | ver sección Ejes]]
||
|-
| font-weight: bold;" | '''Agregar campo'''
| | Si queremos añadir mas campos que no estén visibles en esta ventana.
||
|}

'''Datos del formulario'''

Este apartado se rellena solo en el caso de tener un formulario personalizado que se va a usar en el Grupo ACD que estamos creando. En el caso contrario es necesario marcar la casilla “Ignorar formulario”.

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Formulario'''
| |Nombre del formulario.
|-
| font-weight: bold;" | '''Tipo formulario'''
| | Seleccionar uno de los tipos de formularios existentes. Para más información[[#Finales | '''''VIVA'''''it Suite ACD+ - Enumerados - Finales]]
|-
| font-weight: bold;" | '''Clase'''
| | Nombre de la clase del formulario cuando es integrado por el cliente.
|-
| font-weight: bold;" | '''Accion'''
| | En este campo se indica la "acción" que el sistema realizará a la vez que se abre el formulario. Es '''necesario''' que el tipo de formulario sea "Creado URL" o "Integrado cliente URL". Si la acción consite en ejecutar un archivo '''.exe''' los posibles parámetros irán '''obligatoriamente''' en los campos '''Param. numérico 3''' o '''Param. numérico 4'''.
|-
| font-weight: bold;" | '''Param. numérico 1'''
| | En el caso que el tipo de formulario sea "Creado URL" o "Integrado cliente url" , permite meter un parámetro numérico a la URL si es necesario. En caso contrario no se tienen en cuenta.
|-
| font-weight: bold;" | '''Param. numérico 2'''
| | En el caso que el tipo de formulario sea "Creado URL" o "Integrado cliente url" , permite meter otro parámetro numérico a la URL si es necesario. En caso contrario no se tienen en cuenta.
|-
| font-weight: bold;" | '''Param. de cadena 3'''
| | En el caso que el tipo de formulario sea "Creado URL" o "Integrado cliente url" , permite meter una cadena de texto como parámetro de la '''acción''' indicada. Cuando la acción consiste en ejecutar un archivo '''.exe''' los posibles parámetros habrán de indicarse en este campo o en el siguiente.
|-
| font-weight: bold;" | '''Param. de cadena 4'''
| | En el caso que el tipo de formulario sea "Creado URL" o "Integrado cliente url" , permite meter una cadena de texto como parámetro de la '''acción''' indicada. Cuando la acción consiste en ejecutar un archivo '''.exe''' los posibles parámetros habrán de indicarse en este campo o en el anterior.
|}

A continuación se muestra un ejemplo de campaña con un formulario asignado y una acción que ejecuta un archivo .exe tras la apertura del formulario (los parámetros indicados son de ejemplo).

[[File:Imagen1.jpg|700 px]]

'''Parámetros URL'''

Los parámetros que podemos pasar a la URL son los siguientes:

*colat: colateral
*campanna: Nombre de la campaña
*vdn: Descripción del VDN
*acd: Número del grupo ACD
*nombre: Nombre del contacto
*apell1: Primer apellido del contacto
*apell2: Segundo apellido del contacto
*empresa: Nombre de la empresa del contacto
*email: email del contacto
*opcCad1: Parámetro cadena 1 opcional
*opcCad2: Parámetro cadena 2 opcional
*opcCad3: Parámetro cadena 3 opcional
*opcCad4: Parámetro cadena 4 opcional
*opcCad5: Parámetro cadena 5 opcional
*opcCad6: Parámetro cadena 6 opcional
*opcCad7: Parámetro cadena 7 opcional
*opcCad8: Parámetro cadena 8 opcional
*agnNum: Número de login del agente
*agnCuenta: Nombre de la cuenta de usuario
*codCliente: Código de cliente
*formulario: Nombre del formulario
*par1: Parámetro numérico 1 correspondiente al formulario
*par2: Parámetro numérico 2 correspondiente al formulario
*par3: Parámetro cadena 3 correspondiente al formulario
*par4: Parámetro cadena 4 correspondiente al formulario

[[#Grupos_ACD | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

=== Enumerados ===

El contenido de la pestaña ''''''VIVA'''''it Suite ACD+ - Enumerados' es el siguiente:

[[File:67_Pestaña_ViVAit_Suite_ACD+_-_Enumerados.jpg|center]]

[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver arriba]
==== Pausas ====
Esta pestaña permite crear, configurar y editar las pausas para los grupos ACD.

Una vez ingresemos a esa pantalla de "Pausas" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])
[[Archivo:30 Busqueda en VIVAit Suite ACD+ - Enumerados - Pausas.png|800px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) una "Pausa" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:68 Pestaña ViVAit Suite ACD+ - Enumerados - Pausas - Nueva pausa.jpg|center]]

Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre de la pausa (Obligatorio).
||
|-
| font-weight: bold;" | '''Descripción'''
| | Descripción de la pausa.
||
|-
| font-weight: bold;" | '''Pausa'''
| | Número que va a tener la pausa asociado (Obligatorio).
||
|-
| font-weight: bold;" | '''Color'''
| | Color con que se representa la pausa en el vivait-desk.
||Ofrece una paleta de colores a eligir.
|-
| font-weight: bold;" | '''Perfiles'''
| | Perfiles que van a tener la pausa creada. Para mas información [[#Perfiles | ver sección '''''VIVA'''''it Suite ACD+ - Perfiles ]].
||
|-
| font-weight: bold;" | '''Usuarios'''
| | Usuarios que van a tener la pausa creada. Para más información[[#Usuarios | ver sección General - Usuarios ]].
||
|}
[[#Pausas | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al índice]]

==== Finales ====

Se entiende por "Finales" a la calificación /resolución de una llamada cuando esta finaliza. Existe una por cliente y su configuración se realiza en los formularios.
Algunos ejemplos pueden ser:
* Llamada muda
* Llamada cortada
* Teléfono equivocado
* ... etc

Una vez ingresemos a esa pantalla de "Finales" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])
[[Archivo:31 Busqueda en VIVAit Suite ACD+ - Enumerados - Finales.png|800px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) un "Final" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:
[[Archivo:69 Pestaña ViVAit Suite ACD+ - Enumerados - Finales - Nuevo final.png|center]]
Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del final (Obligatorio).
|-
| font-weight: bold;" | '''Descripción'''
| | Descripción del final.
|-
| font-weight: bold;" | '''Tipo'''
| | No asignado (por defecto).
|-
| font-weight: bold;" | '''Final'''
| | Número asociado al final (Obligatorio).
|-
| font-weight: bold;" | '''Cola'''
| | Asignar el final creado a una cola. Para ello la cola tiene que tener como tipo de final especifico. Para más información[[#Grupos ACD | '''''VIVA'''''it Suite ACD+ - Grupos ACD ]]
|-
| font-weight: bold;" | '''VDN'''
| | Asignar el final creado a un VDN. Para ello el VDN tiene que tener como tipo de final especifico. Para más información[[#VDN (VIVAit Suite ACD+) |'''''VIVA'''''it Suite ACD+ - VDN ]]
|-
| font-weight: bold;" | '''Campaña'''
| | Asignar el final creado a una campaña. Para ello la campaña tiene que tener como tipo de final especifico. Para más información[[#Campañas | '''''VIVA'''''it Suite ACD+ - Campañas ]]
|}

[[#Finales | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

==== Motivos Desconexión ====

Existen los siguientes motivos de desconexión:

* Fin jornada
* Despido
* Traslado
* Aplicación
* Supervisor

El agente cerrará su sesión marcando uno de los motivos y finalizará la ejecución del programa.

Una vez ingresemos a esa pantalla de "Motivos Desconexión" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])
[[Archivo:32 Busqueda en VIVAit Suite ACD+ - Enumerados - Mot. Desconexión.png|750px|center]]

La explicación de la funcionalidad del botón “Borrar” estáa explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” está explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) un "Motivo de Desconexión " en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:
[[Archivo:70 Pestaña ViVAit Suite ACD+ - Enumerados - Motivos desconexión - Nuevo Motivo desconexión.jpg|center]]

Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del motivo de desconexión (Obligatorio).
||
|-
| font-weight: bold;" | '''Descripción'''
| | Descripción del motivo de la desconexión.
||
|-
| font-weight: bold;" | '''Desconexión'''
| | Número asociado de desconexión (Obligatorio) .
||
|-
| font-weight: bold;" | '''Perfiles'''
| | Perfiles que van a tener la desconexión asociada. Para mas información [[#Perfiles | ver sección '''''VIVA'''''it Suite ACD+ - Perfiles ]]
|-
| font-weight: bold;" | '''Color'''
| | Color con que se representa la desconexión .
||Ofrece una paleta de colores a eligir.
|}

[[#Motivos_Desconexión | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

=== Config. de Monitores ===

Esta pestaña permite crear y configurar los monitores según las necesidades del cliente.

Una vez ingresemos a esa pantalla de Config. de Monitores"" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])

[[Archivo:33 Busqueda en VIVAit Suite ACD+ - Monitores.png|800 px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) una "configuración de monitor" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:71 Pestaña ViVAit Suite ACD+ - Conf. de Monitores - Editar.png|center]]

Las opciones con las que podemos encontrarnos son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del Monitor (Obligatorio) .
||
|-
| font-weight: bold;" | '''Descripción'''
| | Descripción del Monitor (Obligatorio).
||
|-
| font-weight: bold;" | '''Tipo'''
| | Elegir el nº de posiciones para monitorizar el Call center
| | Call center 8 posiciones

Call center 4 posiciones

Call center Multimonitor
|-
| font-weight: bold;" | '''ACD'''
| | Conjunto de Grupos ACD que se van a monitorizar.
||
|-
| font-weight: bold;" | '''Intervalo'''
| | Tiempo establecido para el intervalo.
||30 / 60 minutos
|-
| font-weight: bold;" | '''Histórico relativo'''
| | Indica el periodo en el que se muestran las llamadas que han sido atendidas en los monitores.Si lo establecemos a “No”, entra en juego el intervalo de histórico.
|| Hoy: desde 00:00 a 23:59.
Este mes: desde el día 1 00:00 al 30-31 a las 23:59.

Este año: desde 1 de enero 00:00 a 31 de diciembre 23:59.
No
|-
| font-weight: bold;" | '''Intervalo de histórico'''
| | Indica un valor del periodo en el que se muestran las llamadas que han sido atendidas en los monitores, distinto al campo "Intervalo".
||
|-
| font-weight: bold;" | '''Tiempo de intervalo histórico'''
| | Como queremos que considere el valor de 'Intervalo de histórico' en unidades de tiempo.
||HORAS
DÍAS

SEMANAS

MESES

AÑOS
|-
| font-weight: bold;" | '''Color por defecto'''
| | Color por defecto del panel si no se han configurado alarmas para dicho panel.
||Ofrece una paleta de colores a eligir.
|-
| font-weight: bold;" | '''Dpto'''
| | Elegir un eje (Obligatorio) . Para más información [[#Ejes | ver sección Ejes]].
||
|}

=== Campos multimonitor ===
Una vez creado el multimonitor lo seleccionamos y la editamos
[[File:Multimonitor-Campos-Editar.jpg|center|800px]]
Aparecerá en la pantalla un nuevo botón "Mostrar Campos"
[[File:Multimonitor-Campos.jpg|center|800px]]
Si lo pulsamos aparecerá una ventana en la que podemos añadir los campos disponibles
[[File:Multimonitor-Campos-Agregar.jpg|center|700px]]
En esta ventana seleccionamos los campos, establecemos alarmas e indicamos la posición que el campo ocupa en el multimonitor.



A continuación se muestran los campos disponibles y su descripción:[[medio:Campos de Multimonitor.pdf|Ver campos]]

[[#Config._de_Monitores | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

=== Marcador ===
El contenido de la pestaña ''''''VIVA'''''it Suite ACD+ - Marcador' es el siguiente.
[[File:72_Pestaña_ViVAit_Suite_ACD+_-_Marcador.jpg|center]]
[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver arriba]
==== Contactos ====
Esta pestaña permite crear y editar los contactos de ACD.

Una vez ingresemos a esa pantalla de "Contactos" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])

[[Archivo:34 Busqueda en VIVAit Suite ACD+ - Marcador - Contactos.png|750px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) un "Contacto" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:73 Pestaña ViVAit Suite ACD+ - Marcador - Contactos - Nuevo Contacto.png|750px|center]]

Las opciones de la pestaña nuevo contacto de ACD se explican en la siguiente tabla:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Lista Contactos'''
| | Lista a la que pertenece el contacto. Para más información [[#Lista de Contactos |ver sección '''''VIVA'''''it Suite ACD+ - Marcador - Listas de contactos ]].
||
|-
| font-weight: bold;" | '''Cod. Cliente'''
| | Nombre de contacto (Obligatorio).
||
|-
| font-weight: bold;" | '''Primer Apellido'''
| | Primer apellido del contacto .
||
|-
| font-weight: bold;" | '''Segundo Apellido '''
| | Segundo apellido del contacto.
||
|-
| font-weight: bold;" | '''Empresa'''
| | Empresa del contacto.
||
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección del contacto.
||
|-
| font-weight: bold;" | '''Dirección alternativa'''
| | Dirección alternativa del contacto.
||
|-
| font-weight: bold;" | '''Código Postal'''
| | Código postal del contacto.
||
|-
| font-weight: bold;" | '''Localidad'''
| | Localidad del contacto.
||
|-
| font-weight: bold;" | '''Provincia'''
| | Provincia del contacto .
||
|-
| font-weight: bold;" | '''País'''
| | País del contacto .
||
|-
| font-weight: bold;" | '''Correo electrónico'''
| | Correo electrónico del contacto .
||
|-
| font-weight: bold;" | '''Añadir Tel. Fijos'''
| | Añade número de teléfonos fijos al contacto .
||
|-
| font-weight: bold;" | '''Añadir Tel. Móvil'''
| | Añade número de teléfonos móviles al contacto .
||
|-
| font-weight: bold;" | '''Edad'''
| | Edad del contacto.
||
|-
| font-weight: bold;" | '''Sexo'''
| | Sexo del contacto.
||Desconocido

Masculino

Femenino
|-
| font-weight: bold;" | '''Idioma'''
| | Idioma hablado del contacto.
||
|-
| font-weight: bold;" | '''Tratamiento'''
| | Cómo dirigirse al contacto de forma correcta.
||Señor

Señora

Don

Doña
|-
| font-weight: bold;" | '''Añadir Opcional num'''
| | Datos numéricos que se asocian al contacto, que pueden usarse en los formularios.
|| Ejemplo queremos que este campos guarde el numero de hijos pues indicamos 1 o 2 o los que tenga el contacto.
|-
| font-weight: bold;" | '''Añadir Opcional cad'''
| | Cadena de texto que se asocian al contacto, que pueden usarse en los formularios.
|| Ejemplo si el contacto tiene el pelo de color rubio, podemos poner el valor "rubio".
|}
[[#Contactos | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

==== Lista de Contactos ====
Esta pestaña permite crear y gestionar las listas de contactos.

Una vez ingresemos a esa pantalla de "Lista de Contactos" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])
[[Archivo:35 Busqueda en VIVAit Suite ACD+ - Marcador - Listas de contactos.png|750px|center]]
La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) una "Lista de Contactos" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:74 Pestaña ViVAit Suite ACD+ - Marcador - Lista de Contactos - Nueva lista de contacto.jpg|center]]
Las opciones de la pestaña Usuario se explican en la siguiente tabla:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre de la lista de contactos (Obligatorio).
|-
| font-weight: bold;" | '''Descripción'''
| | Descripción de la lista de contactos.
|-
| font-weight: bold;" | '''Dpto'''
| | Elegir un eje (Obligatorio). Para más información [[#Ejes | ver sección Ejes]]
|}
[[#Lista_de_Contactos | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

==== Listas Robinson ====

Una lista Robinson es un tipo de ''lista de exclusión'' donde la gente que forma parte de ella ha expresado voluntariamente que quiere dejar de recibir publicidad, bien sea por correo electrónico, por correo postal, por teléfono o por fax. En cada caso los datos de contacto se almacenarán en una lista negra.

Esta pestaña permite crear y gestionar las “listas negras” de ACD.

Una vez ingresemos a esa pantalla de "Listas Robinson" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])
[[Archivo:36 Busqueda en VIVAit Suite ACD+ - Marcador - Listas Robinson.png|750px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) una "Lista Robinson" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:75 Pestaña ViVAit Suite ACD+ - Marcador - Listas Robinson - Nueva lista robinson.jpg|center]]

Las opciones de una lista Robinson se explican en la siguiente tabla:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre de la lista robinson (Obligatorio).
|-
| font-weight: bold;" | '''Descripción'''
| | Descripción de la lista robinson .
|-
| font-weight: bold;" | '''Dpto'''
| | Elegir un eje (Obligatorio) . Para más información [[#Ejes | ver sección Ejes]]
|}
[[#Listas_Robinson | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

==== Contactos Robinson ====
Esta pestaña permite crear y editar los contactos de la “lista negra”.

Una vez ingresemos a esa pantalla de "Contactos Robinson" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])
[[Archivo:37 Busqueda en VIVAit Suite ACD+ - Marcador - Contactos Robinson.png|750px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) un "Contacto Robinson" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:76 Pestaña ViVAit Suite ACD+ - Marcador - Contactos Robinson - Nuevo contacto robinson.jpg|center]]

Las opciones de la pestaña Usuario se explican en la siguiente tabla:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del contacto (Obligatorio) .
|-
| font-weight: bold;" | '''Descripción'''
| | Descripción del contacto
|-
| font-weight: bold;" | '''Lista'''
| | Lista Robinson a la que va a pertenecer el contacto. Para más información [[#Listas Robinson | ver sección '''''VIVA'''''it Suite ACD+ - Marcador - Listas Robinson ]]
|-
| font-weight: bold;" | '''Teléfono'''
| | Número de teléfono del contacto (Obligatorio).
|-
| font-weight: bold;" | '''Inserción'''
| | Fecha de inserción del contacto a la lista Robinson.
|}
[[#Contactos_Robinson | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

==== Listas Click2Call ====

'''Click2Call''' es una forma de comunicación basada en la Web en la que una persona hace clic en un objeto (por ejemplo,botón, imagen o texto) para solicitar una conexión inmediata con otra persona en tiempo real

Esta pestaña permite crear y gestionar las listas Click2Call.

Una vez ingresemos a esa pantalla de "Listas Click2Call" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])

[[Archivo:38 Busqueda en VIVAit Suite ACD+ - Marcador - Listas Click2Call.png|750px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) una "Lista Click2Call" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:77 Pestaña ViVAit Suite ACD+ - Marcador - Listas Click2Call - Nueva lista Cick2Call.jpg|center]]
Las opciones de una lista Click2Call se explican en la siguiente tabla:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre de la lista click2call (Obligatorio).
||
|-
| font-weight: bold;" | '''Descripción'''
| | Descripción de la lista click2call.
||
|-
| font-weight: bold;" | '''Canal'''
| | Elegir la vía por donde puede mostrarse la lista.
| | Telefonía

Backoffice

|-
| font-weight: bold;" | '''Campaña'''
| | Campaña a la que asociaremos la lista click2call. Para más información[[#Campañas |ver sección '''''VIVA'''''it Suite ACD+ - Campañas ]].
||
|-
| font-weight: bold;" | '''Cola '''
| | Asociar el tipo de cola.
|| Llamada entrante

LLamada saliente bajo demanda.

LLamada saliente bajo vista previa.

LLamada saliente progresivo.

LLamada saliente predictivo.

Backoffice.

Backoffice interrumpible.

Sin seleccionar.
|-
| font-weight: bold;" | '''Grupo ACD'''
| | El Grupo ACD al que asociaremos la lista click2call. Para más información[[#Grupos ACD |ver sección '''''VIVA'''''it Suite ACD+ - Grupos ACD ]].
||
|-
| font-weight: bold;" | '''Nº Segs limite'''
| | Numero de segundos limite para que el Agente ACD pueda llamar al contacto (Obligatorio).
||
|-
| font-weight: bold;" | '''Prioridad'''
| | Prioridad de la lista.
||
|-
| font-weight: bold;" | '''Dpto'''
| | Elegir un eje (Obligatorio) . Para más información [[#Ejes | ver sección Ejes]].
||
|}

[[#Listas_Click2Call | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

==== Contactos Click2Call ====

Una vez ingresemos a esa pantalla de "Contactos Click2Call" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])
[[Archivo:39 Busqueda en VIVAit Suite ACD+ - Marcador - Contactos Click2Call.png|750px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) un "Contacto Click2Call" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:78 Pestaña ViVAit Suite ACD+ - Marcador - Contactos Click2Call - Nuevo contacto Cick2Call.png|center]]
Las opciones de la pestaña Usuario se explican en la siguiente tabla:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Hora de inicio'''
| | Inicio del contacto.
||
|-
| font-weight: bold;" | '''Hora de fin'''
| | Fin del contacto.
||
|-
| font-weight: bold;" | '''Lista'''
| | Lista click2call al que se asignara el contacto. Para más información[[#Listas Click2Call | ver sección '''''VIVA'''''it Suite ACD+ - Marcador - Listas Click2Call ]].
||
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del contacto click2call (Obligatorio).
||
|-
| font-weight: bold;" | '''Primer Apellido'''
| | Primer apellido del contacto click2call.
||
|-
| font-weight: bold;" | '''Segundo Apellido'''
| | Segundo apellido del contacto click2call .
||
|-
| font-weight: bold;" | '''Cod. Cliente'''
| | Nombre dado al código del cliente, por defecto msisdn.
||
|-
| font-weight: bold;" | '''Empresa'''
| | Empresa del contacto.
||
|-
| font-weight: bold;" | '''Dirección'''
| | Dirección del contacto.
||
|-
| font-weight: bold;" | '''Dirección alternativa '''
| | Dirección alternativa del contacto.
||
|-
| font-weight: bold;" | '''Código Postal'''
| | Código postal del contacto.
||
|-
| font-weight: bold;" | '''Localidad'''
| | Localidad del contacto.
||
|-
| font-weight: bold;" | '''Provincia'''
| | Provincia del contacto .
||
|-
| font-weight: bold;" | '''País'''
| | País del contacto .
||
|-
| font-weight: bold;" | '''Canal'''
| | Elegir la vía por donde puede mostrarse la lista.
||Telefonía

Backoffice
|-
| font-weight: bold;" | '''Correo electrónico'''
| | Correo electrónico del contacto.
||
|-
| font-weight: bold;" | '''Destino'''
| | Numero de teléfono del destino (obligatorio).
||
|-
| font-weight: bold;" | '''Sexo'''
| | Sexo del contacto .
||Desconocido

Masculino

Femenino
|-
| font-weight: bold;" | '''Idioma'''
| | Idioma hablado del contacto.
||
|-
| font-weight: bold;" | '''Tratamiento'''
| | Cómo dirigirse al contacto de forma correcta
||Desconocido

Señor

Señora

Don

Doña
|-
| font-weight: bold;" | '''Añadir Opcional num'''
| | Datos numéricos que se asocian al contacto click2Call, que pueden usarse en los formularios.
|| Ejemplo queremos que este campos guarde el numero de hijos pues indicamos 1 o 2 o los que tenga el contacto.
|-
| font-weight: bold;" | '''Añadir Opcional cad'''
| | Cadena de texto que se asocian al contacto click2Call, que pueden usarse en los formularios.
|| Ejemplo si el contacto tiene el pelo de color rubio, podemos poner el valor "rubio".
|-
| font-weight: bold;" | '''Añadir Final'''
| | Se indica el final.
||
|-
| font-weight: bold;" | '''Id'''
| | Asociamos al usuario. Para más información[[#Usuarios | ver sección General - Usuarios ]].
||
|-
| font-weight: bold;" | '''Intento'''
| | Indicar si el contacto click2Call puede ser llamado o no.
|| Si / NO

|}

[[#Contactos_Click2Call | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

==== Clases de estrategia ====
Se trata del algoritmo por el cual se regirá la estrategia. Cada Clase de estrategia diferente conlleva
un desarrollo del algoritmo que hay debajo para hacerla funcionas. Diferentes estrategias pueden
compartir una misma clase de estrategia. Para cada estrategia se pueden definir hasta un máximo de 16 opciones con un intervalo de valor mínimo y máximo por cada opción, y además dos cadenas de caracteres.

Una vez ingresemos a esa pantalla de "Clases de estrategia" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])
[[Archivo:40 Busqueda en VIVAit Suite ACD+ - Marcador - Clases de estrategias.png|750px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) un/a "Clase de estrategia" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:79 Pestaña ViVAit Suite ACD+ - Marcador - Clases de estrategias - Nueva clase de estrategia.png|center]]
Las opciones de la pestaña Usuario se explican en la siguiente tabla:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre que tiene la clase de estrategia (obligatorio).
||
|-
| font-weight: bold;" | '''Descripción'''
| | Descripcion breve de la clase de estrategia.
||
|-
| font-weight: bold;" | '''Clase'''
| | Clase de la estrategia (obligatorio).
|| Normalmente, es la ubicación donde podemos encontrar la clase.
|-
| font-weight: bold;" | '''Parámetros del 1 al 16 '''
| | Nombres de los parámetro del algoritmo del 1 al 16. Solo hace falta rellenar los necesarios.
||
|-
| font-weight: bold;" | '''Mínimo parámetro del 1 al 16 '''
| | Establece el valor mínimo de los parámetro del algoritmo del 1 al 16. Solo hace falta rellenar los necesarios.
||
|-
| font-weight: bold;" | '''Mínimo parámetro del 1 al 16 '''
| | Establece el valor máximo de los parámetro del algoritmo del 1 al 16. Solo hace falta rellenar los necesarios.
||
|-
| font-weight: bold;" | '''Parámetros cadena 1 y 2 '''
| | Dos cadenas de texto que podemos pasar como parámetro al algoritmo.
||
|}

[[#Clases_de_estrategia | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

==== Estrategias ====

Esta pestaña permite configurar las estrategias y sus parámetros.

{| class="wikitable"
|-
| '''Nota:''' Crear una nueva estrategia implica que tengamos creada la clase de estrategia previamente.Para más información [[#Clases de estrategia |ver sección '''''VIVA'''''it Suite ACD+ - Marcador - Clases de estrategias ]] La imagen que mostramos pertenece a la estrategia por defecto que desarrollamos en el portal de administración, por tanto si quieres configurar una estrategia propia la explicación de los campos puede ayudarte.
|}

Una vez ingresemos a esa pantalla de "Estrategias" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])
[[Archivo:41 Busqueda en VIVAit Suite ACD+ - Marcador - Estrategias.png|750px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en [[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) una "Estrategia" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:80 Pestaña ViVAit Suite ACD+ - Marcador - Estrategias - Nueva estrategia.png|center]]

Las opciones de la pestaña Usuario se explican en la siguiente tabla:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre de la estrategia (Obligatorio).
||
|-
| font-weight: bold;" | '''Descripción'''
| | Descripción de la campaña.
||
|-
| font-weight: bold;" | '''Clase de Estrategia'''
| | Que clase de estrategia va a usar . Para más información [[#Clases de estrategia |ver sección '''''VIVA'''''it Suite ACD+ - Marcador - Clases de estrategias ]]

| | En la imagen se ve un ejemplo para la clase de estrategia por defecto.
|-
| font-weight: bold;" | '''Parámetros '''
| colspan="2" |Aquellos parámetros que hayamos especificado en la clase de estrategia se nos habilitaran para asignarles un valor entre el rango del minino y máximo especificado en la clase de estrategia. (Obligatorios todos).
|-
| font-weight: bold;" | '''ACD'''
| | Indicar si esta estrategia, cuando se asocia a una campaña se aplica a los grupos ACD. Para más información [[#Grupos ACD |ver sección '''''VIVA'''''it Suite ACD+ - Grupos ACD ]]
|| Sí / No.
|}
[[#Estrategias | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

=== Configuración (VIVAit Suite ACD+) ===
Esta pestaña permite modificar algunos parámetros comunes para los grupos ACD.

[[Archivo:81 Pestaña ViVAit Suite ACD+ - Configuración.jpg|800px|center]]
Las opciones de la pestaña Usuario se explican en la siguiente tabla:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nodo Ucid'''
| | UCID del nodo o equipo donde esta el '''''VIVA'''''it-cti corriendo.
|-
| font-weight: bold;" | '''Nombre Perfil'''
| | Etiqueta usada en los programas para referirse a los perfiles
|-
| font-weight: bold;" | '''Umbral recicla sesión'''
| | En segundos. Periodo durante el cual se recicla la sesión del agente y se permite iniciar sesión al agente desde el mismo puesto.
|-
| font-weight: bold;" | '''Version del desk'''
| | Número de la versión mínima del '''''VIVA'''''it Desk.
|-
| font-weight: bold;" | '''Version DLL del desk'''
| | Número de versión mínima de la DLL del '''''VIVA'''''it Desk.
|-
| font-weight: bold;" | '''Version Form Integrado desk'''
| | Numero de versión mínima del formulario integrado en el VIVAit desk.
|-
| font-weight: bold;" | '''Version de Super'''
| | Numero de versión mínima del '''''VIVA'''''it Supervisor.
|-
| font-weight: bold;" | '''Version de Report'''
| | Numero de versión mínima del '''''VIVA'''''it Reporting.
|-
| font-weight: bold;" | '''Nº segundos de desfase '''
| | Indicar el tiempo de desfase permitido en segundos entre la maquina donde se ejecuten las aplicaciones con respecto a la hora de la BD.
|-
| font-weight: bold;" | '''Nº segundos de refresco de la cola'''
| | Refresco de la información de las colas en el '''''VIVA'''''it Desk.
|-
| font-weight: bold;" | '''Formulario'''
| | Ultimo formulario por si fallan los demás. Para más información [[#Formularios | ver sección VIVAit Suite ACD+ - Formularios ]]
|}

[[#Configuración_(VIVAit_Suite_ACD+) | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

=== Perfiles ===

Se entiende por Perfiles a un grupo de características asociado a un grupo de trabajo/personas. Las acciones a realizar por el agente, estarán sujetas , al perfil que tenga activo(Grupos ACD, Agendas, Finales, Motivos de Desconexión, Supervisor...etc)

Una vez ingresemos a esa pantalla de "Perfiles" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])
[[Archivo:42 Busqueda en VIVAit Suite ACD+ - Perfiles.png|750px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) un "Perfil" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:82 Pestaña ViVAit Suite ACD+ - Perfiles - Nuevo perfil.jpg|center]]

Las opciones de la pestaña Usuario se explican en la siguiente tabla:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del perfil (Obligatorio).
||
|-
| font-weight: bold;" | '''Descripción'''
| | Descripción del perfil.
||
|-
| font-weight: bold;" | '''Sesión'''
| | Permite al agente visualizar las estadísticas de la sesión en curso.
|| Si / No.
|-
| font-weight: bold;" | '''ACD'''
| | Permite al agente ver los grupos ACD a los que está conectado.
|| Si / No.
|-
| font-weight: bold;" | '''Consulta solo de Agenda'''
| | Habilitar o no la consulta de solo la agenda al agente en el '''''VIVA'''''it Desk.
|| Si / No.
|-
| font-weight: bold;" | '''LLamada solo de Agenda'''
| | Habilitar o no las llamadas solo a los contactos de la agenda del '''''VIVA'''''it Desk.
|| Si / No.
|-
| font-weight: bold;" | '''Dest. supervisor'''
| | Número de la extensión telefónica perteneciente del supervisor.
||
|-
| font-weight: bold;" | '''Pausa Inicial'''
| | Para arrancar la aplicación pausada es necesario seleccionar una de las pausas del listado.
||
|-
| font-weight: bold;" | '''Formulario'''
| | Formulario asignado al perfil. Para más información [[#Formularios | ver sección '''''VIVA'''''it Suite ACD+ - Formularios ]].
||
|-
| font-weight: bold;" | '''Pausa el agente no contesta'''
| | Pone al agente en estado “abandonada” si no contesta una llamada y se finaliza por el llamante.
|| Si / No.
|-
| font-weight: bold;" | '''Umbral'''
| | El tiempo en segundos que puede dejar un agente sin contestar la llamada. Sin ningún valor tomara 10seg por defecto.
||
|-
| font-weight: bold;" | '''Nombre Supervisor'''
| | Nombre del supervisor.
||
|-
| font-weight: bold;" | '''Mot. Cierre obligatorio'''
| | Para cerrar sesión es necesario especificar un motivo.
| | Si / No.
|-
| font-weight: bold;" | '''Modo de grabación'''
| | Indica si un agente ACD puede tener el control de cuando se graba.
|| Sin grabación: no permite tener el control de grabación
Grabación bajo demanda de inicio grabando: permite al agente ACD decidir cuando pausar la grabación.

Grabación bajo demanda de inicio sin grabar: permite al agente ACD iniciar y parar la grabación.

Grabar todo: se graba independientemente de la acción del agente ACD.
|-
| font-weight: bold;" | '''Grabar Todo'''
| | Grabación a nivel perfil, en el que afecta a todo las llamadas donde el perfil este activo, independientemente de la configuración del Agente ACD.
|| Si / No.
|-
| font-weight: bold;" | '''Pausas'''
| | Las diferentes pausas que puede ponerse un agente.
Para más información [[#Pausas | ver sección '''''VIVA'''''it Suite ACD+ - Enumerados - Pausas ]].
||
|-
| font-weight: bold;" | '''Mot. desconexión'''
| | Los diferentes motivos de desconexión que puede tener un agente al cerrar sesión de la aplicación. Para más información [[#Mot. desconexion | ver sección '''''VIVA'''''it Suite ACD+ - Enumerados - Mot. desconexión ]].
||
|-
| font-weight: bold;" | '''Perfil Secundario'''
| | Configuremos a un agente ACD, un segundo perfiles dependiendo del Calendario. Por ejemplo para que se activen uno u otro dependiendo si trabaja en días laborales o no (Obligatorio).
||
|-
| font-weight: bold;" | '''Dpto'''
| | Elegir un eje (Obligatorio) . Para más información [[#Ejes | ver sección Ejes]].
||
|}

[[#Perfiles | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

=== Formularios ===
Existe una '''''jerarquía de visualización de los formularios''''' dependiendo de la configuraciones que hagamos en la Campaña, el VDN, los grupos ACD o los perfiles, es decir, nuestros agentes ACD pueden visualizar distinto tipos de formularios.

La '''''jerarquía de prioridades de visualización''''' (de mayor a menor) esta explicada en la siguiente tabla:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Formulario '''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Formulario de Campaña'''
| | Tiene mayor prioridad, es el primer formulario que puede aparecer. Para más información [[#Campañas |ver sección '''''VIVA'''''it Suite ACD+ - Campañas ]].
|-
| font-weight: bold;" | '''Formulario de VND'''
| | Se muestra si "Formulario de Campaña" esta marcado como ignorado. El segundo con mayor prioridad. Para más información [[#VDN (VIVAit Suite ACD+) |ver sección '''''VIVA'''''it Suite ACD+ - VDN ]].
|-
| font-weight: bold;" | '''Formulario de Grupo ACD'''
| | Se muestra si "Formulario de VND" esta marcado como ignorado. El tercero con mayor prioridad. Para más información [[#Grupos ACD |ver sección '''''VIVA'''''it Suite ACD+ - Grupos ACD ]].
|-
| font-weight: bold;" | '''Formulario por defecto'''
| | En el caso que todos los anteriores sean ignorados o muestren error. Este formulario se visualizara. Para más información [[#Configuración (VIVAit Suite ACD+) | ver sección '''''VIVA'''''it Suite ACD+ - Configuración]].
|-
|colspan="2" | '''Nota: Existe un formulario de perfil, que siempre se mostrara a los usuarios cuando la llamada no sea para una Campaña o de un agente ACD. Para mas información [[#Perfiles | ver sección '''''VIVA'''''it Suite ACD+ - Perfiles ]].'''
|}

Una vez ingresemos a esa pantalla de "Formularios" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])

[[Archivo:43 Busqueda en VIVAit Suite ACD+ - Formularios.png|750px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) un "Formulario" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:83 Pestaña ViVAit Suite ACD+ - Formularios - Nuevo formulario.jpg|center]]

Las opciones de la pestaña Usuario se explican en la siguiente tabla:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Tipo Formulario'''
| | El elegir el tipo de formulario.
|| Defecto

Creado

Creado URL

Integrado cliente

Integrado cliente URL
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del formulario (Obligatorio).
||
|-
| font-weight: bold;" | '''Descripción'''
| | Descripción del formulario.
||
|-
| font-weight: bold;" | '''Nombre fichero'''
| | Nombre del fichero insertado. Solo si elegimos como tipo de formulario Creado o Creado URL.
||
|-
| font-weight: bold;" | '''Clase'''
| | Nombre de la clase del formulario cuando es integrado por el cliente.
||
|-
| font-weight: bold;" | '''Inicio oculto'''
| |Iniciar el formulario oculto .
|| Si / No.
|-
| font-weight: bold;" | '''Parar el tiempo de admin'''
| | Indicar el tiempo en segundos. Pasado este tiempo se cierra el formulario automáticamente.
|| Si / No.
|-
| font-weight: bold;" | '''Final opcional'''
| | Habilitar finales opcionales a los formularios .
|| Si / No.
|-
| font-weight: bold;" | '''Ocultar numeración'''
| | Para ocultar numeración al cerrar el formulario
|| Si / No.
|-
| font-weight: bold;" | '''Tiempo Cierre automático'''
| | Indicar el tiempo en segundos. Pasado este tiempo se cierra el formulario automáticamente.
||
|-
| font-weight: bold;" | '''Tabla de negocio'''
| |Tabla de BD de cliente.
||
|-
| font-weight: bold;" | '''Destino encuestas'''
| | Numero para transferir a encuestas si se da al botón de transferencia a encuestas.
||
|}

[[#Formularios | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

=== Puestos ===
Un puesto en la plataforma se utiliza para ubicar la extensión con la que puede trabajar un usuario en su PC. Desde esta pestaña sirve para crear, consultar y modificar y asignar las extensiones a los puestos.

Una vez ingresemos a esa pantalla de "Puestos" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])
[[Archivo:44 Busqueda en VIVAit Call - Puestos.png|750px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) un "Puesto" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:87 Pestaña ViVAit Suite ACD+ - Puestos - Nuevo puesto.png|center]]

Las opciones de la pestaña Usuario se explican en la siguiente tabla:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
|-
| font-weight: bold;" | '''Nombre'''
| | Nombre del puesto, en caso de un ordenador sera su nombre de red (Obligatorio).
|-
| font-weight: bold;" | '''Extensión'''
| | Extensión asociada al puesto.
|}
[[#Puestos | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

=== Chat ===

La documentación se puede consultar en: [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#CHAT_2 enlace]]

[[#Chat | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

=== Valoraciones ===

La plataforma '''''VIVA'''''it permite que un supervisor evalúe las grabaciones de las llamadas de los agentes.

Las grabaciones se evalúan a través de '''''VIVA'''''it Tracker. En esta aplicación el supervisor escucha la grabación de la llamada y rellena el informe de evaluación asociado.

Una vez que las grabaciones son evaluadas su puntuación puede ser tenida en cuenta como parámetro para filtrar la búsqueda de grabaciones.

Para poder realizar esta evaluación es necesario que, a través del portal de administración, se definan una serie de preguntas y éstas se asignen a un informe. El informe se asociará a una campaña,a un VDN,o a un grupo ACD, teniendo en cuenta que el informe asociado a una campaña prevalecerá siempre sobre el informe asociado a un VDN, y el asociado a un VDN sobre el asociado a un grupo ACD.

====Informes====

En el menú de informes podemos buscar informes existentes, recuperar informes, borrarlos, crear nuevos informes y editar los existentes.

[[File:Listado de informes de calidad existentes.jpg|700px]]

En esta imagen aparecen marcados en rojo los informes que se han borrado, podemos seleccionarlos y recuperarlos.

Cuando damos de alta un informe podemos establecer la puntuación mínima que le asignamos a las preguntas, la puntuación máxima y el intervalo de incremento en la evaluación, esta valoración será la misma para todas las preguntas que se incluyan en el informe.

[[File:Edicion de informe de calidad.jpg|700px]]

Al informe de valoración hay que asignarle un eje.

Al informe se asignan las preguntas seleccionándolas de una lista de preguntas disponibles, que se habrán creado con anterioridad.

====Preguntas====

En el menú preguntas definimos las preguntas que queremos formular para evalúar las grabaciones.

[[#Valoraciones| Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

==''VIVA''it Record ==

Esta pestaña ofrece al usuario la gestión y configuración referente al servicio de grabaciones de la plataforma.El contenido de la pestaña ''''''VIVA'''''it Record' es el siguiente.

[[File:84_Pestaña_ViVAit_Record.jpg|center]]

[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver arriba]
=== Configuración (VIVAit Record) ===

Esta pestaña permite modificar la configuración de las grabaciones según las necesidades del cliente.

[[Archivo:85 Pestaña ViVAit Record - Configuración.jpg|center]]

Las opciones de la pestaña Usuario se explican en la siguiente tabla:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Hay llamadas'''
| | Indica si en el entorno hay o no llamadas .
|| Si / No.
|-
| font-weight: bold;" | '''Hay segmentos'''
| | Indica si en el entorno hay o no segmentos.
||Si / No.
|-
| font-weight: bold;" | '''Almacén de grabaciones'''
| | URL de la máquina donde se guardaran las grabaciones.
||
|-
| font-weight: bold;" | '''Espera de escucha en Windows'''
| | Tiempo en segundos.
||
|-
| font-weight: bold;" | '''Espera de escucha en web'''
| | Tiempo en segundos .
||
|-
| font-weight: bold;" | '''Versión del tracker'''
| | versión del traker web .
||
|-
| font-weight: bold;" | '''Nombre Fichero'''
| | Nombre con el que se graba la grabación .
||
|-
| font-weight: bold;" | '''Cifrar'''
| |Método de cifrado de las grabaciones .
|| Cifrado DES

Cifrado CAST5

Cifrado AES-128

Cifrado AES-192

Cifrado AES-256.
|}
En el fichero adjunto se especifican las configuraciones ecesarias para poder realizar grabaciones bajo demanda:
[[medio:Configuración_Graba_Demanda.pdf|Configuración Grabación Bajo Demanda]]

[[#Configuración_(VIVAit_Record) | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

=== Ubicación ===
Esta pestaña permite modificar los parámetros de ubicación de las grabaciones.

Una vez ingresemos a esa pantalla de "Ubicación" aparecerá la búsqueda con filtros y algunos botones laterales( Borrar, Nuevo , Editar y Duplicar que dependerán del nivel de permisos que tengamos para la aplicación [[#Permisos_a_Usuarios| ver sección Permisos]])
[[Archivo:45 Busqueda en VIVAit Record - Ubicación.png|750px|center]]

La explicación de la funcionalidad del botón “Borrar” esta explicada genéricamente en [[#Borrado_de_Datos | Ver Borrado de Datos]] y el botón “Duplicar” esta explicada genéricamente en
[[#Duplicado_de_Datos | ver Duplicado de Datos]].

La explicación de los filtros de la búsqueda, se pueden encontrar en la sección [[#Búsquedas | búsqueda]]. Para dar de alta o modificar (Editar) una "Ubicación" en la plataforma '''''VIVA'''''it pulsamos el botón "Nuevo" o “Editar” y aparecerá una ventana parecida a la siguiente:

[[Archivo:86 Pestaña ViVAit Record - Ubicación.jpg|center]]

Las opciones de la pestaña Usuario se explican en la siguiente tabla:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center style="background-color:#0099ff;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center style="background-color:#0099ff;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Nombre nodo'''
| | Nombre del nodo donde se va a realizar la ubicación (Obligatorio).
||
|-
| font-weight: bold;" | '''Descripción'''
| | Nombre común del nodo.
||
|-
| font-weight: bold;" | '''Dirección de red'''
| | Direccion IP del nodo.
||
|-
| font-weight: bold;" | '''Ubicación'''
| | Elegir un tipo de conexion.
| | Local

Externo https

Externo http

Externo ssh

Externo sftp

Externo ftp
|-
| font-weight: bold;" | '''Puerto '''
| | Puerto de escucha para la conexión.
||
|-
| font-weight: bold;" | '''Usuario'''
| |Usuario para la conexión.
||
|-
| font-weight: bold;" | '''Clave'''
| | Clave de usuario.
||
|-
| font-weight: bold;" | '''Ruta'''
| | Ruta de almacenamiento dentro del nodo .
||
|-
| font-weight: bold;" | '''Param. de cadena 1'''
|| Parámetro que puede darse al nodo para configurarse de tipo texto.
| |Por ejemplo, número UCID.
|-
| font-weight: bold;" | '''Param. de cadena 2'''
|| Parámetro que puede darse al nodo para configurarse de tipo texto.
| |Por ejemplo, Dirección IP del host donde queremos que se almacenen los logs.
|-
| font-weight: bold;" | '''Param. numérico 1'''
|| Parámetro que puede darse al nodo para configurarse de tipo numérico.
| |Por ejemplo, Puerto de escucha.
|-
| font-weight: bold;" | '''Param. numérico 2'''
|| Parámetro que puede darse al nodo para configurarse de tipo numérico.
| |Por ejemplo, Logs de facilidad
|}

[[#Ubicación | Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver al indice]]

== Configuraciones mínimas ==

=== ''VIVA''it Call ===

Una configuración mínima de un sistema '''''VIVA'''''it Call, para telefonía corporativa, en un cliente pequeño, sencillo y mononodo requerirá:

* Existencia de una sede. Para más información [[#Sedes | ver sección General - Sedes]].
* Existencia de un nodo. Para más información [[#Nodos | ver sección General - Nodos]].
* Existencia de una categoría (por defecto existe "nacional"). Para más información [[#Categorías | ver sección '''''VIVA'''''it Call - Categorías]]
* Existencia de extensiones. Para más información [[#Extensiones | ver sección '''''VIVA'''''it Call - Dispositivos - Extensiones]]
* Existencia de una preruta que cumpla la condición de origen de las extensiones; en este punto conseguiremos comunicaciones internas entre extensiones.
* Existencia de una preruta que cumpla la condición de enlace exterior y dirija al destino externo. Para más información [[#Prerutas | ver sección '''''VIVA'''''it Call - Prerutas]].
* Existencia de un enlace exterior; la creación de enlaces exteriores requiere de la modificación del fichero '''ext_MARCAR_Externo_Particular.conf'''. Para más información [[#Enlace exterior | ver sección '''''VIVA'''''it Call - Dispositivos - Enlace exterior ]]

* Existencia de un destino externo. Para más información [[#Destinos externos | ver sección '''''VIVA'''''it Call - Rutas - Destinos externos ]]

[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit Volver arriba]

== Enlaces de interés ==
Muchos de los campos a configurar en la plataforma '''''VIVA'''''it son expresiones regulares; el siguiente enlace corresponde con una herramienta de ayuda y prueba de expresiones regulares

'''[http://www.regexr.com/ Probar y ayuda para expresiones regulares]'''

== CHAT ==

El CHAT es un servicio incuído en la plataforma VIVAit-Suite, que permite la comunicación con la plataforma VIVAit-Call para usuarios.

El esquema del servicio es el siguiente:

[[File:ESQUEMA CHAT.png|750px]]

El CHAT se inicia con una petición de un usuario desde VIVAit-Call y genera la apertura de un formulario de CHAT en la plataforma VIVAit-Suite.

Para que la comunicación se esteblezca es necesario que un agente de VIVAit-Suite esté logado en un grupo ACD al que se le haya asociado un formulario de CHAT.

El servicio permite establecer una comunicación entre un usuario y un agente.

Cuando sea necesario, el supervisor del agente podrá intervenir en la comunicación, ayudando únicamente al agente, o al agente y al usuario a la vez.

El servicio no permite que el supervisor envíe comunicaciones solo al usuario.

Aún cuando la comunicación esté establecida y el agente aparezca en estado ocupado, podrá recibir llamadas entrantes de los grupos ACD en los que está logado.

===Configuración del servicio===

Para configurar el servicio de CHAT es necesario realizar configuraciones a través del Portal de Administración.

# Creamos una clase de dispositivo tipo '''"multicanalidad texto entrada"'''

[[File:1.jpg|800px]]

[[File:2.jpg|800px]]

# A continuación creamos un dispositivo de llamada tipo '''"multicanal texto entrada".'''

[[File:3.jpg|800px]]

[[File:4.jpg|800px]]

En los campos '''servidor''' y '''nodo''' pondremos los datos de la máquina en la que tenemos el webservice del CHAT en el tomcat.

Utilizaremos la plantilla '''"multicanalidad texto entrada"'''.

[[File:5.jpg|800px]]

En los datos del nodo en el que tenemos instalado el tomcat con el webservice del CHAT tenemos que rellenar los datos de multinacalidad, con la IP del nodo ACD y como puerto por defecto 8888.

[[File:6.jpg|800px]]

En la plantilla '''General ACD''' tendremos que indicar dos parámetros nuevos:

multicanalidad=yes
factos_metrica_esfuerzo=0

[[File:7.jpg|800px]]

# En VIVAit Suite ACD + creamos el grupo ACD al que se logará el agente.

[[File:8.jpg|800px]]

Como podemos observar habremos indicado que el formulario es "CHAT" y el tipo de cola "llamada entrante".

# En VIVAit Suite ACD + --> CHAT creamos un servicio nuevo al que le asociamos el '''grupo ACD''' que hemos creado y en el campo canal el '''"multicanal texto entrada"''' que creamos anteriormente.

[[File:9.jpg|800px]]

[[File:10.jpg|800px]]

# De forma manual hay que hacer cambios en el fichero '''etc\asterisk\chan_sit.conf'''

Debe tener la siguiente estructura:

[general]
peer_out_default=out1
esfuerzo_disponible=6
esfuerzo_chat=3
esfuerzo_sms=2
esfuerzo_email=1

[rest]
port=8888

[chat1]
channel_type_in=chat
host_in=172.25.128.92
;host_in=172.25.2.130
context_in=context_sit
;vdn_dest_in=6541
;cidname_in=name_chat1
;cidnum_in=1234
timeout_first_in=60
timeout_next_in=60

[Facebook]
channel_type_in=chat
host_in=172.25.128.92
;host_in=172.25.2.130
context_in=context_sit
;vdn_dest_in=6541
;cidname_in=name_chat1
;cidnum_in=1234
timeout_first_in=60
timeout_next_in=60

[sms1]
channel_type_in=sms
;host_in=10.255.178.46
context_in=context_sit
;vdn_dest_in=6541
;cidname_in=name_sms1
;cidnum_in=1234
timeout_first_in=60
timeout_next_in=60

[email1]
channel_type_in=email
;host_in=10.255.178.46
context_in=context_sit
;vdn_dest_in=6541
;cidname_in=name_email1
;cidnum_in=1234
timeout_first_in=60
timeout_next_in=60

[out1]
netip_out=0.0.0.0
netmsk_out=0.0.0.0
timeout_transfer_out=60
autoanswer_out=yes

En este fichero es imprescindible:

* Indicar los esfuerzos
* Indicar en [rest] el puerto
* configurar los [chat1]... que se hayan creado
* configurar [out1]

===Funcionamiento===

====Agente====

Cuando un agente de VIVAit Suite recibe una solicitud de CHAT se abre en la pantalla un formulario y su estado cambia a acupado.

[[File:Formulario_Chat_Desk.png|250]]

Las comunicaciones enviadas por el usuario aparecen en el área de CHAT.

El agente utiliza el área de escritura de texto para enviar y redacta la respuesta al usuario.

El agente puede utilizar el despleglable con respuestas prediseñadas. Selecciona una respuesta, pulsar el botón para copiar ésta en el área superior y pocede a enviar el texto.

En la parte inferior de la ventana el agente cuenta con un botón para etiquetar la llamada y otro para colgarla.

====Supervisor====

Para acceder al CHAT el Supervisor accede al Menú MC de la barra superior, opción Chat/Activos.

La nueva ventana muestra los CHAT's activos en la aplicación.

El Supervisor selecciona el que desea observar y pulsa el botón, tal y como se indica en la imagen.

El botón central de esta ventana refresca la información respecto a los CHAT's activos en cada momento.

[[File:Acceso_Chat_Supervisor_Suite.png|250]]

La siguiente imagen muestra la ventana de CHAT del supervisor.

[[File:Formulario_Chat_Supervisor.png|250]]

Como puede apreciarse en la imagen el Supervisor puede enviar mensajes de dos formas:
* Al agente
* Al agente y al usuario.

En la pantalla de CHAT el supervisor observará toda la información intercambiada entre el usuario y el agente.

====Usuario de VIVAit Call====

Cuando un usuario de VIVAit Call inicia la sesión se muestra en pantalla un botón de acceso al CHAT.

[[File:Ventana-Inicio.jpg|900px|centro]]

Este botón abre una ventana de solicitud del servicio.

[[File:Entrada a servicio de CHAT.jpg|900px|centro]]

Si el usuario solicita el servicio, y existe un agente logado en VIVAit-Suite, se abre la ventana de CHAT, en la que el usuario establece la comunicación con el agente.

[[File:Servicio de CHAT iniciado.jpg|900px|centro]]

El usuario escribe en la zona de mensaje y cuando pulsa el botón Enviar el texto aparece en la zona central de la ventana. Toda la comunicación que se intercambie entre agente y usuario quedará reflejada en esta zona central.

[[File:Ejemplo de pantalla con mensaje de usuario y agente.jpg|900px|centro]]

Cuando el usuario lo desee puede pulsar el botón cerrar chat para dar por finalizada la comunicación.

Si no hay agentes logados en VIVAit-Suite, el sistema presenta la siguiente pantalla:

[[File:Sin agentes logados.jpg|900px|centro]]

Cuando un agente se logue en un grupo ACD de CHAT se establecerá la comunicación de forma inmediata.

====Configuración del grupo ACD====

Para que entre un usuario y un agente se pueda establecer una comunicación de CHAT es necesario que el grupo ACD al que está logado el agente tenga asignado un formulario de CHAT.

[[File:Configuracion_Grupo_ACD_Desk.png|centro|300px]]

[[File:Configuracion_Grupo_ACD.png|centro|600px]]

[[Category:tecnico]]
[[Category:administrador]]
[[Category:VIVAit Call]]
[[Category:VIVAit Suite]]

Manual de operación plataforma VIVAit

2018-09-25T06:23:19Z

Imatarrubias: /* Calendarios */

{| class="wikitable"
|-
! '''Producto: '''!! '''''VIVA'''''it Call
'''''VIVA'''''it Suite
|-
|}

== Introducción ==

En este documento se describe la arquitectura general de la plataforma '''''VIVA'''''it, detallando aquellos procesos principales que componen cada uno de los elementos del sistema, y sus principales elementos de diagnóstico
Quedan fuera del ámbito de este documento:
* Uso de aplicación de agente ('''''VIVA'''''it Desk)
* Uso de aplicación de supervisor ('''''VIVA'''''it Supervisor), incluyendo sus módulos autónomos ('''''VIVA'''''it reporting, '''''VIVA'''''it Tracker)
* Uso de portal de administración
* Uso de portal de traceo de llamadas y agentes ('''''VIVA'''''it Tracker web)
* Uso de portal de monitorización zabbix

== Arquitectura ==

[[Archivo:Arquitectura plataforma VIVAit.png|center|700px]]

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

== Descripción de los elementos, diagnósticos y operaciones ==
Las siguientes tablas definen los principales elementos software de la plataforma '''''VIVA'''''it, que son detallados en apartados siguientes:

{| class="wikitable"
|-
|+ <big>'''Nivel de sistema operativo'''</big>
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
| Ubuntu Server LTS 64 bits || Uno por servidor|| ||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
|| Actualmente (Oct-2015) 14.04
Bajo proyecto puede cambiarse
|-
| Almacenamiento de grabaciones|| Uno por sistema|| Almacenamiento de las grabaciones, ya sean de entorno corporativo o de contact center||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
|| Típicamente un espacio grande de almacenamiento proporcionado por el cliente y que se monta como un sistema de archivos local en los servidores de la plataforma
Pueden existir sistemas secundarios de almacenamiento de grabaciones
|-
|-
|}

{| class="wikitable"
|-
|+ <big>'''Nivel de conmutación de voz'''</big>
|-
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
|Asterisk 1.4.24 by MDtel||Uno por servidor ACD||Núcleo de conmutación de voz basado en Asterisk 1.4 y modificado por MDtel||'''''VIVA'''''it Suite||Fuertemente modificado por MDtel
En el futuro migrará a Asterisk 13 Certified
|-
|Dialplan ACD by MDtel||Uno por servidor ACD||Configuración de voz||'''''VIVA'''''it Suite||En el futuro se unificará con corporativa
|-
|Asterisk 13 Certified by MDtel||Uno por servidor corporativo/gateway||Núcleo de conmutación de voz basado en Asterisk 13 y modificado por MDtel||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Actualmente asterisk estándar (10/15)
La instalación contempla descargar de la red el más actualizado, siempre CERTIFIED"
|-
|Dialplan corporativo||Uno por servidor corporativo/gateway||Configuración de voz||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||En el futuro se unificará con ACD
|-
|}

{| class="wikitable"
|-
|+ <big>'''Nivel de base de datos'''</big>
|-
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
|MySQL 5.5||Donde haya BBDD de cualquier tipo (incluso zabbix)||Motor de Base de Datos||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||A efectos prácticos va a ser en todos los servidores con casi total seguridad
|-
|BBDD tiempo real||Una por sistema||Base de Datos sobre la que trabaja todo el entorno de tiempo real||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
|-
|BBDD réplica||Una por sistema multinodo||Base de Datos para acceso a información de reporting…y similar||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Bajo proyecto puede existir más de una
En el nodo en el que exista réplica existirá además copia (excepto nodo ACD)
|-
|BBDD copia||Uno por servidor corporativo/gateway||Copias de tablas de configuración para respaldo de la misma||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Local en cada nodo
Los nodos de ACD actualmente no trabajan con copia; en caso de fallo de BBDD TR se usa el modo emergencia
|-
|}

{| class="wikitable"
|-
|+ <big>'''Nivel de procesos ''VIVA''it'''</big>
|-
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
|Intz-Nimitz||Donde haya una BBDD de tiempo real o copia||Interfaz entre el dialplan y la base de datos||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||No donde haya BBDD de réplica
Sistemas grandes pueden contemplar mas de un intz-nimitz central"
|-
|vivait-cti||Uno por servidor ACD||Interfaz entre '''''VIVA'''''it Desk, supervisor y el manager de asterisk||'''''VIVA'''''it Suite||
|-
|myAcdSuperv||Uno por servidor ACD||Recopilador de datos de asterisk y actualiza en la BBDD
Genera llamadas en el marcador
||'''''VIVA'''''it Suite
||
|-
|motorSal||Uno por sistema con ACD||Motor de marcador saliente automático||'''''VIVA'''''it Suite||Solo si hay marcación saliente
Junto a la BBDD de tiempo real
|-
|recordCentral||Uno por sistema||Servidor de grabaciones, se conectan los agentes a el||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Se arrancan varias instancias en función del número de nodos
Debe instalarse en un servidor que tenga el almacenamiento de grabaciones en su sistema de archivos
|-
|recordNodo||Uno por servidor corporativo/gateway||Agente de grabación||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|bdCentral||Uno, en el nodo con la BBDD de tiempo real||Genera la base de datos que se copiará para respaldo a otros nodos||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|bdNodo||En cada nodo con BBDD de copia||Recoge la base de datos del servidor central con el objeto de tener el respaldo||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|Actualizador||Uno por sistema con ACD||Se encarga de proporcionar las versiones actualizadas de las aplicaciones de puesto de trabajo||'''''VIVA'''''it Suite||En el mismo servidor que el portal de administración
|-
|phoneProv-tftp||Uno por sistema||Se encarga del aprovisionamiento masivo de terminales||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||En instalaciones grandes habrá más de uno, quizás uno por sede grande; depende de la infraestructura de DHCP
|-
|borraregistrosnimitz||||||||
|-
|Mover grabaciones a nube||||||||
|-
|}

{| class="wikitable"
|-
|+ <big>'''Administración'''</big>
|-
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
|Tomcat 7||Uno por servidor con portales||Servidor de aplicaciones JAVA||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
|-
|Portal de administración ||Uno por sistema||Portal de administración del sistema||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Bajo proyecto puede existir más de uno
|-
|Portal usuario||Uno por sistema||Portal de usuario, para acceso a buzones, su configuración||'''''VIVA'''''it Call||Bajo proyecto puede existir más de uno
|-
|Tracker web||Uno por sistema||Portal de seguimiento de llamadas||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Debe instalarse en un servidor que tenga los ficheros de grabación montados en su sistema de archivos
Ligado a recordCentral
Bajo proyecto puede existir más de uno
|-
|Monitor||Uno por sistema||Portal de monitores de pared de Call Center||'''''VIVA'''''it Suite||Bajo proyecto puede existir más de uno
|-
|Apache||Uno por servidor de calendarios||Servidor de portales WEB||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|Servidor de calendarios||Uno por sistema||Aloja calendarios para su uso en diferentes entornos de NIMITZ||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Bajo proyecto puede existir más de uno
|-
|}

{| class="wikitable"
|-
|+ <big>'''Monitorización'''</big>
|-
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
|Servidor zabbix||Uno por instalación||Monitorización técnica y de negocio||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Bajo proyecto puede existir más de uno
Tipicamente irá o en BBDD replica o en nodo de gestión en instalaciones grandes
|-
|Templates zabbix||Uno por instalación||Adaptaciones específicas||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|Agente Zabbix||Uno por servidor||Agente de monitorización||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
||Scripts monitorización zabbix||Uno por servidor||Agente de monitorización||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|}
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

===Versiones de módulos===

{| class="wikitable"
|-
! Módulo !! VSuite
V.3.10
! VSuite
V.3.2.0
! VSuite
V.3.3.0
! VIVAit V.3.0.0
(VSuite 3.4+VCall3.0)
! VIVAit V.3.1.0
(VSuite 3.5+VCall3.1)
|-
| Sistema Operativo || || || ||
|| Ubuntu 14.0.4
Server 64 Kb
|-
| Asterisk || 1.4 || 1.4 || 1.4 || 1.4 Nodo ACD
13 resto nodos
|| 1.4 Nodo ACD
13 resto nodos
|-
| Asterisk ACD '''(VS)''' || || || || 3.3.1 || 3.4.1
|-
| Dialplan ACD '''(VS)''' || || || || || 3.5.0
|-
| Asterisk Corp '''(C)''' || || || || 3.3.4 || 3.4.4
|-
| Asterisk Cisco '''(VC)''' || || || || 3.3.4 || 3.4.4
|-
| Dialplan Corp '''(C)''' || || || || 3.3.1 || 3.5.0
|-
| Lazarus común '''(VS)''' || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0 || 3.5.0
|-
| BD '''(C)''' || 3.2.0 || 3.4.0 || 3.5.0 || 3.6.0 || 3.8.0
|-
| Generaconf '''(C)''' || 3.0.0 || 3.0.0 || 3.2.0 || 3.4.0 || 3.5.0
|-
| Instalador '''(C)''' || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0 || 3.5.0
|-
| Intz-nimitz '''(C)''' || 2.6.0 || 3.0.1 || 3.0.3 || 3.4.1 || 3.4.2
|-
| recordgwd '''(C)''' || 1.3.0 || 1.3.0 || 3.1.0 || ----- || -----
|-
| recordNodo '''(C)''' || ----- || ----- || ----- || 4.0.0 || 4.0.0
|-
| recordprocesad '''(C)''' || 1.2.0 ||1.2.0|| 3.0.0 || ----- || -----
|-
| recordCentral '''(C)''' || ----- || ----- || -----|| 4.0.0 || 4.0.1
|-
| MyACDSuperv '''(VS)''' || 5.2.0 || 5.3.0 || 5.3.0 || 5.3.2 || 5.3.2
|-
| Motorsal '''(VS)''' || 1.4.0 || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0
|-
| Vivait-cti '''(VS)''' || 3.0.0 || 3.0.1 || 3.0.1 || 3.0.1 || 3.0.2
|-
| Multimonitorweb '''(VS)''' || 3.0.1 || 3.0.2 || 3.1.0 || 3.1.0 || 3.2.0
|-
| Portal de administración '''(C)''' || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0 || 3.5.0
|-
| Tracker Web '''(C)''' || 3.0.2 || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0
|-
| VIVA supervisor '''(VS)''' || 3.0.0 || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0
|-
| Tracker windows '''(C)''' || 3.0.0 || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0
|-
| VIVA report '''(VS)''' || 1.2.0 || 3.1.0 || 3.2.0 || 3.2.2 || 3.3.0
|-
| VIVA desk '''(VS)''' || 3.0.2 || 3.2.0 || 3.3.0 || 3.4.0 || 3.5.0
|-
| VIVA designer '''(VS)''' || 1.0.23 || 3.0.1 || 3.1.0 || 3.1.0 || 3.2.0
|-
| Preview '''(VS)''' || 1.0.18 || 3.2.0 || 3.3.0 || 3.4.0 || 3.5.0
|-
| Phone_prov '''(C)''' || ------ || ------ || 3.0.1 || 3.0.3 || 3.0.3
|-
| Portal usuario '''(VC)''' || ------ || ------ || ------ || 3.0.0 || 3.1.0
|}

'''(C)''': Módulo común

'''(VC)''': Módulo de VIVAit Call

'''(VS)''': Módulo de VIVAit Suite

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Sistema Operativo ===
Los sistemas operativos de nuestra plataforma se corresponden a las versiones de Ubuntu Server LTS , ya que son las versiones estables, con un soporte continuado y mas estables a actualizaciones desde la salida Ubuntu 14.04.1. En concreto el sistema operativo utilizado para la plataforma '''''VIVA'''''it es Ubuntu Server 14.04.4 LTS. Para más información https://help.ubuntu.com/lts/serverguide/index.html.

[[Archivo:Ubuntu Kernel Release Schedule.png|750px]]

==== Funcionamiento en cluster ====

Un clúster es un grupo de múltiples ordenadores unidos mediante una red de alta velocidad, de tal forma que el conjunto es visto como un único ordenador.

De un clúster se espera que presente combinaciones de los siguientes servicios:

# Alto rendimiento
# Alta disponibilidad
# Balanceo de carga
# Escalabilidad

Tal y como esta definido el cluster de MDtel, este comprueba conectividad con la otra máquina que lo forma y con un punto de confianza. Si la máquina no tiene conectividad con la otra y si con el punto de confianza es que el servidor está vivo, mientas que si no tengo conectividad ni con la otra máquina ni con el punto de confianza es que el muerto soy yo, por lo que balanceo.

Por lo que las máquinas balancean en los casos siguientes:

* Todo lo que tenga que ver con la red, es decir, caída de la tarjeta de red, apagado de la máquina, corte en la red..

Y no balancea en los siguientes:

* No balancea en los demás casos, es decir, todo lo que tenga que ver con procesos de una máquina (caída asterisk, base de datos, intz-nimitz)

El funcionamiento en cluster se basa en:

* Heartbeat: IP flotante entre las dos máquinas que componen el cluster; típicamente este "latido" entre máquinas se realizará mediante conexión directa con cable cruzado para asegurar que no existan problemas de comunicaciones tales como retardo, pérdida de paquetes, etc en este latido y pueda ser causa de un balanceo inadecuado.

{| class="wikitable"
|-
| '''Nota 17-11-2015:''' Se ha realizado en un cliente un cluster distribuido, con dos servidores en diferentes sedes, realizando el heartbeat mediante enlace Gigabit. Si bien la solución no está validada por desarrollo, se está observando el funcionamiento.
|}

* DRBD se encargar de mantener una serie de carpetas totalmente replicadas entre los dos nodos; dichas carpetas son:

El cluster es <big>'''activo/pasivo'''</big>; la máquina activa posee la IP flotante y tiene arrancados los servicios.

==== Configuración del cluster ====
Para montar un cluster de asterisk partimos de la siguiente situación inicial:
* Dos maquinas con '''''VIVA'''''it Call 3.0 instalado.
* El driver bonding de Interfaces de Red en Ubuntu Server.

Los pasos a seguir para la configuración en el Ubuntu Server son los siguientes:
* Instalar ifenslave:
:{|
|-
|
aptitude install ifenslave.
|}
: Finalizada la instalación, comprobamos que la instalación de Bonding se ha configurado para empezar desde el arranque del sistema operativo desde el fichero '''/etc/modules''':
:{|
|-
| vi /etc/modules
# /etc/modules: kernel modules to load at boot time.
#
# This file contains the names of kernel modules that should be loaded
# at boot time, one per line. Lines beginning with "#" are ignored.
# Parameters can be specified after the module name.
lp
rtc
bonding
|}

* Crear o editar el archivo llamado '''/etc/modprobe.d/bonding.conf''' y añadir la siguiente linea en negrita:
:{|
|-
|
echo "alias bond0 bonding"> /etc/modprobe.d/bonding.conf
|}

* Editar el fichero /etc/network/interfaces y añadir lo que esta en negrita:
:{|
|-
|
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).
# The loopback network interface
auto lo
iface lo inet loopback

'''# Bonding'''

'''#em1 ip manual y esclavo en el "bond0" NIC'''
'''auto em1'''
'''iface em1 inet manual'''
'''bond-master bond0'''
'''bond-primary em0'''

'''#em2 ídem, creando así un vínculo de enlace 2.'''
'''auto em2'''
'''iface em2 inet manual'''
'''bond-master bond0'''
'''auto bond0'''
'''iface bond0 inet static'''
'''address 10.255.255.11'''
'''netmask 255.255.255.0'''
'''gateway 10.255.255.254'''
'''bond-mode active-backup'''
'''bond-miimon 100'''
'''bond-slaves none'''

'''# em3 replica entre servidores'''
'''auto em3'''
'''iface em3 inet static'''
'''address 10.255.254.10'''
'''netmask 255.255.255.0'''

'''# em4 gestion'''
'''auto em4'''
'''iface em4 inet static'''
'''address 172.17.47.255'''
'''netmask 255.255.0.0'''
|}

* Reiniciamos el sistema para que el kernel tome los cambios.

* Comprobación que en las dos maquinas el archivo '''/etc/host''' contenga el los nombre de las dos maquinas a vincular. En el ejemplo el archivo en ambas maquinas es:

:{|
|-
|
127.0.0.1 localhost

10.255.255.11 vivaitcall-CL-UAH-1

10.255.255.12 vivaitcall-CL-UAH-2

10.255.255.10 vivaitcall-CL-UAH

10.255.255.10 BDTR

10.255.254.10 vivaitcall-CL-UAH-1-em3

10.255.254.11 vivaitcall-CL-UAH-2-em3
|}

* Creamos dos particiones iguales en ambos ordenadores , usando el comando '''parted'''.
:{|
|-
|
root@vivaitcall-CL-UAH-1:~# '''parted /dev/sda'''
GNU Parted 2.3
Using /dev/sda
Welcome to GNU Parted! Type 'help' to view a list of commands.
(parted) p free
Model: HP LOGICAL VOLUME (scsi)
Disk /dev/sda: 1000GB
Sector size (logical/physical): 512B/512B
Partition Table: gpt
Number Start End Size File system Name Flags
17,4kB 262kB 245kB Free Space

1 262kB 1000MB 1000MB fat32 boot
2 1000MB 201GB 200GB ext4
3 201GB 217GB 16,0GB linux-swap(v1)
4 217GB 237GB 20,0GB ext4
237GB 1000GB 763GB Free Space

(parted) mkpart primary 237GB 1000GB
(parted) p free
Model: HP LOGICAL VOLUME (scsi)
Disk /dev/sda: 1000GB
Sector size (logical/physical): 512B/512B
Partition Table: gpt
Number Start End Size File system Name Flags
17,4kB 262kB 245kB Free Space
1 262kB 1000MB 1000MB fat32 boot
2 1000MB 201GB 200GB ext4
3 201GB 217GB 16,0GB linux-swap(v1)
4 217GB 237GB 20,0GB ext4
5 237GB 1000GB 763GB primary  No File System como ext4
1000GB 1000GB 204kB Free Space
(parted)quit
mkfs.ext4 /dev/sda5
root@vivaitcall-CL-UAH-1:~# '''parted /dev/sda'''
GNU Parted 2.3
Using /dev/sda
Welcome to GNU Parted! Type 'help' to view a list of commands.
(parted) p free
Model: HP LOGICAL VOLUME (scsi)
Disk /dev/sda: 1000GB
Sector size (logical/physical): 512B/512B
Partition Table: gpt
Number Start End Size File system Name Flags
17,4kB 262kB 245kB Free Space
1 262kB 1000MB 1000MB fat32 boot
2 1000MB 201GB 200GB ext4
3 201GB 217GB 16,0GB linux-swap(v1)
4 217GB 237GB 20,0GB ext4
5 237GB 1000GB 763GB primary
1000GB 1000GB 204kB Free Space
(parted) rm 5
(parted) mkpart primary 237GB 1000GB
(parted) p free
Model: HP LOGICAL VOLUME (scsi)
Disk /dev/sda: 1000GB
Sector size (logical/physical): 512B/512B
Partition Table: gpt

Number Start End Size File system Name Flags
17,4kB 262kB 245kB Free Space
1 262kB 1000MB 1000MB fat32 boot
2 1000MB 201GB 200GB ext4
3 201GB 217GB 16,0GB linux-swap(v1)
4 217GB 237GB 20,0GB ext4
5 237GB 1000GB 763GB ext4 primary  Si File Sytem ext4
1000GB 1000GB 204kB Free Space
(parted)quit
|}

* Instalar los paquetes necesarios para el drbd. '''En Ubuntu server 14.04 ya está instalado.'''
:{|
|-
|
aptitude install drbd8-utils
aptitude update (si no instala el drbd8-utils actualizar)
aptitude install drbd8-utils (volver a lanzar)
|}

* Creamos el archivo '''/etc/drbd.conf''' en ambas maquinas:
:{|
|-
|
# You can find an example in /usr/share/doc/drbd.../drbd.conf.example
include "drbd.d/global_common.conf";
include "drbd.d/*.res";
resource MDcluster {
protocol C;
on vivaitcall-CL-UAH-1 {
device /dev/drbd0;
disk /dev/sda5;
address 10.255.254.10:7788;
meta-disk internal;
}
on vivaitcall-CL-UAH-2 {
device /dev/drbd0;
disk /dev/sda5;
address 10.255.254.11:7788;
meta-disk internal;
}
disk {
on-io-error detach;
}
net {
max-buffers 2048;
ko-count 4;
}
syncer {
rate 100M;
al-extents 257;
}
startup {
wfc-timeout 0;
degr-wfc-timeout 120;
}
}
|}

* Reiniciamos el sistema para que el kernel tome los cambios.
* Inicializamos el recurso, para ello primero deberemos crear los recursos DRBD teclearemos en ambas maquinas. Desde /etc.
:{|
|-
|
drbdadm create-md MDcluster (no y yes )
|}

:Si tenemos algún problema porque ya exista sistema de ficheros.
:{|
|-
|
dd if=/dev/zero of=/dev/sda5 bs=1M count=128
drbdadm create-md MDcluster (no y yes )
|}

* Reiniciamos ambas maquinas para que su kernel tome los cambios.
* Levantamos el servicio del DRBD en ambos servidores (nos preguntara que si queremos enviar los datos a los desarrolladores de drbd) tecleando no, no se envían.
:{|
|-
|
service drbd start
/etc/init.d/drbd start
|}

: Ahora ambas maquinas son secundarias.
: Indicar cual de las dos maquinas usaremos como primaria, por tanto en la maquina elegida habra que ejecutar:
:{|
|-
|
drbdadm -- --overwrite-data-of-peer primary all (en una máquina)
:'''Nota:''' La ip virtual que va a estar asignada a la maquina activa es 172.25.129.70.

|}

: Podemos teclear el comando '''''cat''''' para ver si esta sincronizando y su progreso:

:{|
|-
|
cat /proc/drbd
'''Nota:''' El servicio DRBD aparecera como '''''Primary/Secondary''''' si ejecutamos en el primario ;
y aparecerá ''''Secondary/Primary'''' si lo ejecutamos en el secundario. 
|}

* Instalación de los script de arranque:
:{|
|-
|
update-rc.d -f drbd remove (en las dos maquinas)
update-rc.d drbd start 13 2 3 4 5 . stop 87 0 1 6 . (en las dos máquinas)
|}
* Seleccionar la fuente de sincronización.
:Formateamos un disco de la maquina que queramos que funcione como fuente del servicio DRBD, para evitar conflictos:
:{|
|-
|
mkfs.ext4 /dev/drbd0
|}
: Creamos el directorio sobre el que vamos a montar el disco, en ambas maquinas.
:{|
|-
|
mkdir /HDcluster
|}

: Creamos un archivo dentro '''''/HDcluster''''' de que se verá solo cuando el disco no está montado en ambas maquinas.
:{|
|-
|
touch sinMontar
'''Nota:''' Este archivo nos puede servir para monitorizar mediante zabbix, nagios, ... que el disco no está montado.
|}

: En una de las maquinas montamos el disco (desde fuera del directorio HDcluster)
:{|
|-
|
mount /dev/drbd0 /HDcluster
|}
* Procedemos a mover todos los datos que necesitemos en este disco y a crear accesos directos, los directorios que vamos a mover son los siguientes:
:{|
|-
|
/etc/asterisk
/var/lib/asterisk
/usr/lib/asterisk
/usr/spool/asterisk
/var/lib/mysql
/var/tftp/
|}
: El procedimiento que vamos a seguir es el siguiente, en el primer ordenador:
:{|
|-
|
'''Cd /HDcluster'''
'''tar -zcvf etc-asterisk.tgz /etc/asterisk'''
'''tar -zxvf etc-asterisk.tgz'''
'''rm -rf /etc/asterisk'''
'''ln -s /HDcluster/etc/asterisk /etc/asterisk'''
'''tar -zcvf var-lib-asterisk.tgz /var/lib/asterisk'''
'''tar -zxvf var-lib-asterisk.tgz'''
'''rm -rf /var/lib/asterisk'''
'''ln -s /HDcluster/var/lib/asterisk /var/lib/asterisk'''
'''tar -zcvf usr-lib-asterisk.tgz /usr/lib/asterisk'''
'''tar -zxvf usr-lib-asterisk.tgz'''
'''rm -rf /usr/lib/asterisk'''
'''ln -s /HDcluster/usr/lib/asterisk /usr/lib/asterisk'''
'''tar -zcvf var-spool-asterisk.tgz /var/spool/asterisk'''
'''tar -zxvf var-spool-asterisk.tgz'''
'''rm -rf /var/spool/asterisk'''
'''ln -s /HDcluster/var/spool/asterisk /var/spool/asterisk'''
'''tar -zcvf var-lib-mysql.tgz /var/lib/mysql'''
'''tar -zxvf var-lib-mysql.tgz'''
'''rm -rf /var/lib/mysql'''
'''ln -s /HDcluster/var/lib/mysql /var/lib/mysql'''
'''tar -zcvf var-lib-phoneprov-tftp.tgz /var/lib/phoneprov-tftp/'''
'''tar -zxvf var-lib-phoneprov-tftp.tgz'''
'''rm -rf /var/lib/phoneprov-tftp/'''
'''ln -s /HDcluster/var/lib/phoneprov-tftp /var/lib/phoneprov-tftp'''
|}

: En la segunda maquina debemos borrar los directorios y crear los accesos directos.
:{|
|-
|
'''rm -rf /etc/asterisk'''
'''ln -s /HDcluster/etc/asterisk /etc/asterisk'''
'''rm -rf /var/lib/asterisk'''
'''ln -s /HDcluster/var/lib/asterisk /var/lib/asterisk'''
'''rm -rf /usr/lib/asterisk'''
'''ln -s /HDcluster/usr/lib/asterisk /usr/lib/asterisk'''
'''rm -rf /var/spool/asterisk'''
'''ln -s /HDcluster/var/spool/asterisk /var/spool/asterisk'''
'''rm -rf /var/lib/mysql'''
'''ln -s /HDcluster/var/lib/mysql /var/lib/mysql'''
'''rm -rf /var/lib/phoneprov-tftp'''
'''ln -s /HDcluster/var/lib/phoneprov-tftp /var/lib/phoneprov-tftp'''
|}

* Configurar heartbeat para las dos maquinas.
: Instalamos heartbeat en las dos maquinas. '''En UBUNTU Server 14.04 ya está instalado.'''
:{|
|-
|
aptitude install heartbeat
|}
: Debemos modificar 3 ficheros en cada una de las maquinas, estos se encuentran en '''/etc/ha.d'''. El primer fichero a modificar es '''''ha.cf.''''':
:: En la maquina ''vivaitcall-CL-UAH-1'' es:
::{|
|-
|
root@vivaitcall-CL-UAH-1:~# cat /etc/ha.d/ha.cf
'''# Explicacion en /usr/share/doc/heartbeat/ha.cf.gz'''

'''udpport 694'''
'''baud 19200'''
'''auto_failback off'''
'''use_logd yes'''
'''crm no'''

'''# Temporizaciones en segs'''
'''logfacility local0'''
'''keepalive 2'''
'''deadtime 8'''
'''warntime 16'''
'''initdead 64'''
'''deadping 6'''

'''#ucast bond0 vivaitcall-CL-UAH-1'''
'''ucast bond0 vivaitcall-CL-UAH-2'''

'''#ucast em3 vivaitcall-CL-UAH-1-em3'''
'''ucast em3 vivaitcall-CL-UAH-2-em3'''

'''#Ping a puerta de enlace,gw1,gw2,gw3,gw4'''
'''ping_group red_local 10.255.255.12'''

'''respawn hacluster /usr/lib/heartbeat/ipfail'''
'''apiauth ipfail gid=haclient uid=hacluster'''

'''node vivaitcall-CL-UAH-1'''
'''node vivaitcall-CL-UAH-2'''
|}

:: Y en la maquina ''vivaitcall-CL-palacio-2'' es:
::{|
|-
|
root@vivaitcall-CL-UAH-1:~# cat /etc/ha.d/ha.cf
'''# Explicacion en /usr/share/doc/heartbeat/ha.cf.gz'''

'''udpport 694'''
'''baud 19200'''
'''auto_failback off'''
'''use_logd yes'''
'''crm no'''

'''# Temporizaciones en segs'''
'''logfacility local0'''
'''keepalive 2'''
'''deadtime 8'''
'''warntime 16'''
'''initdead 64'''
'''deadping 6'''

'''ucast bond0 vivaitcall-CL-UAH-1'''
'''#ucast bond0 vivaitcall-CL-UAH-2'''

'''ucast em3 vivaitcall-CL-UAH-1-em3'''
'''#ucast em3 vivaitcall-CL-UAH-2-em3'''

'''#Ping a puerta de enlace gw1 gw2 gw3 gw4'''
'''ping_group red_local 10.255.255.12'''

'''respawn hacluster /usr/lib/heartbeat/ipfail'''
'''apiauth ipfail gid=haclient uid=hacluster'''

'''node vivaitcall-CL-UAH-1'''
'''node vivaitcall-CL-UAH-2'''
|}
::'''Nota:''' El parámetro '''auto_failback''' se utiliza para indicar si queremos que al recuperarse una maquina adquiera los recursos sobre los que tiene prioridad.
:El segundo fichero es '''''authkeys''''',, este fichero es el mismo en ambas maquinas:
:{|
|-
|
chmod 600 authkeys '''(importante)'''
auth 1
1 sha1 claveSecretaATope
|}

:El tercer fichero '''haresources''', donde especificaremos en las dos maquinas que deben apuntar a la maquina que queremos que tenga prioridad en la adquisición de los recursos, este fichero es el mismo en las dos maquinas:
:{|
|-
|
MÁQUINA 1 -> vivaitcall-CL-palacio-1 hb_mdtel
MÁQUINA 2-> vivaitcall-CL-palacio-1 hb_mdtel
|}
: Copiaremos en el directorio '''/etc/ha.d/resource.d/''' los scripts de arranque con permisos 755 (lo podemos hacer mediante WINSCP). Los scripts se encuentran en '''''C:\Documents and Settings\javier.gutierrez.MDTEL\Mis documentos\Centrales\Asterisk\Cluster\scripts'''''.
:{|
|-
|
chmod 755 hb_catalina
chmod 755 hb_mdtel
chmod 755 hb_mdtel_firewall
|}
: Deberemos editar el archivo '''hb_mdtel'''
:{|
|-
|
(IP flotante a.b.c.d./mask) 10.255.255.10
CAD_IP_FLOTA=10.255.255.10/24/bond0
|}
:

* Paramos el proceso '''myAcdSuperv'''.
:{|
|-
|
mv /etc/rc2.d/S02myAcdSuperv s02myAcdSuperv
|}
* Reiniciamos ambas maquinas para que su kernel tome los cambios.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== Comprobación de buen funcionamiento del cluster ====
* La maquina activa tiene que tener en HDcluster montado el disco con todos sus directorios y la maquina inactiva no (tenemos que ver el archivo que hemos creado "sinMontar").
* La ip virtual tiene que estar en la maquina activa (ifconfig) y no tiene que estar en la inactiva.
* El asterisk tiene que estar arrancado en la maquina activa y parado en la inactiva.
* Tecleando la ip de la maquina activa en un navegador debemos acceder al portal de vivait-call y en la inactiva no debe de estar activo.
* Para cambiar el cluster manualmente podemos utilizar los siguientes comandos:
:{|
|-
|
/usr/share/heartbeat/hb_takeover
|}
: La maquina desde la que se ejecuta se convierte en la maquina activa
:{|
|-
|
/usr/share/heartbeat/hb_standby
|}
: La maquina desde la que se ejecuta deja de ser la maquina activa

==== Notas para MySQL ====
Si mysql es parte del cluster tenemos que tener en cuenta dos cosas:

* El archivo '''/etc/mysql/debían.cnf''' contiene una clave que debe ser igual en ambas maquinas y debe ser la clave de la máquina de donde cojamos la base de datos. 
:{|
|-
|
# Automatically generated for Debian scripts. DO NOT TOUCH!
[client]
host = localhost
user = debian-sys-maint
password = AI6AdPtnhLUrNm1S
socket = /var/run/mysqld/mysqld.sock
[mysql_upgrade]
user = debian-sys-maint
password = AI6AdPtnhLUrNm1S
socket = /var/run/mysqld/mysqld.sock
basedir = /usr
|} 
* El archivo '''/etc/apparmor.d/usr.sbin.mysqld''' contiene donde pueden estar ubicados los archivos de mysql, al cambiar su ubicación y poner un enlace directo en /var/lib/mysql si no modificamos este archivo mysql no arrancara al no tener la nueva ubicación entre sus localizaciones permitidas. Este es un ejemplo de las líneas que debemos añadir. 
:{|
|-
|
/var/run/mysqld/mysqld.sock w, (copiar después de esta linea)

#//!!
/HDcluster/var/lib/mysql/ r,
/HDcluster/var/lib/mysql/** rwk,
#//!!
|}

==== Notas de desincronización ====
EL servicio del DRBD esta iniciado pero al teclear el comando cat /proc/drbd para ver si esta sincronizando se presenta "'''primary/unknown" y/o secondary/unknown''' ".
* En el nodo primary
:{|
|-
|
drbdadm connect all
|}

* En el nodo secondary
:{|
|-
|
drbdadm disconnect all
drbdadm -- --discard-my-data connect all
|}

==== Adaptar red a cliente ====
Para adaptar la red de los equipos al entorno del cliente hay que editar los siguientes ficheros:
{|
|-
|
/etc/network/interfaces
/etc/resolv.conf
/etc/hosts
/etc/ha.d/resource.d/hb_mdtel
/etc/ha.d/ha.cf
- TFTP:
/etc/inetd.conf (IP del cluster)

|}
Tras la modificaciones oportunas, se debe reiniciar las dos máquinas para cargar las nuevas configuraciones.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Matriz de conmutación ===

Encontramos dos diferentes núcleos de conmutación en la plataforma VIVAit:

* Para los nodos de procesamiento ACD el núcleo de conmutación es asterisk 1.4 RSP con fuertes modificaciones realizadas por MDtel en determinados módulos (queues, chan_spy entre otros)

* Para los nodos que realizan funcionalidad de gateway y/o procesamiento de telefonía corporativa, se utiliza como núcleo de conmutación asterisk 13, versión certified
https://wiki.asterisk.org/wiki/display/AST/Asterisk+13+Documentation

==== Modificaciones realizadas sobre Asterisk 13 certified 2 ====

===== Archivos añadidos por '''MD'''tel =====
Los archivos añadidos son los siguientes:

* '''apps/app_ucid.c'''
* '''apps/app_cli.c'''
* '''apps/app_crash.c'''
* '''apps/app_mdintz.c'''
* '''apps/app_mdintz.exports.in'''
* '''include/asterisk/mdintz.h'''
* '''include/asterisk/ucid.h'''
* '''res/res_mdcal.c'''

'''→ apps/app_mdintz.exports.in '''

Este archivo sirve para la exportación de funciones del mdintz para el uso por aplicaciones externas

===== Modificaciones de archivos =====

Los archivos modificados por '''MD'''tel son los mostrados a continuación:

* '''apps/app_mixmonitor.c'''
* '''res/res_calendar_caldav.c'''
* '''contrib/scripts/safe_asterisk'''
* '''contrib/init.d/rc.debian.asterisk'''
* '''channels/sig_pri.c'''
* '''channels/chan_sip.c'''

'''→ main/audiohook.c''' 

'''audiohook.c''' ha sido modificado para solucionar un crash de asterisk al utilizar en el mixmonitor las opciónes r y t

'''→ app_crash.c '''

Esta nueva aplicación es sólo compatible con '''Asterisk 13'''.

La documentación de la misma se encuentra en el comando: '''"core show application Crash"'''

Esta nueva aplicación ''permite añadir'' al plan de pruebas:

* Generación de una parada de asterisk. (Crash(IwantToGetAnAccessViolation) ó Crash(IwantToGetADoubleFreeMem))
* Verificación de su impacto. Por ejemplo, no deben cortarse las llamadas en curso, si así está previsto por la topología.
* Correcta generación de los "core", comprobando que funciona "backtrace" (bt).

'''Nota.-''' Esta aplicación no debería estar presente en una instalación de '''Asterisk 13'''

'''→ app_mdintz.c y mdintz.h''' 

Esta aplicación sirve como interfaz a entornos (funcionalidades) creados por MDtel

Para mas información consultar la página de [[MDintz|MDintz]].

Las rutas de estos archivos son las siguientes:

'''apps/app_mdintz.c''' 
'''include/asterisk/mdintz.h '''

'''app_mdintz.c''' :

'''app_mdintz.c''' orientada al proceso de enrutamiento a implementar en ''intz-nimitz.''

El archivo '''.c''' es casi igual para asterisk 1.4.24 y asterisk 13.
'''Nota.-''' Cuando se compila para asterisk 13, es necesario comentar la línea que pone '''"#define ASTERISK_OLD".'''

Los cambios implementados son:

* Unificación de código entre las versiones de asterisk
* Nuevo comando "qry"
* Posible resolución de "Mal write" en intz-nimitz (a verificar)

En cuanto al nuevo comando, el formato es:

'''mdintz qry <nHostFijo> <entorno> <servicio> <par1>...<parN>'''

Permite interrogar a un servidor de igual modo que hace el dialplan con '''fines de diagnóstico'''. La única diferencia es que se ha añadido el parámetro '''"nHostFijo"''' que puede tomar como valor '''"*"''' (lo que solicita una interrogación secuencial a todos los servidores definidos, igual a la funcionalidad del dialplan) ó '''"0"''' a '''"3"''' (que solicita un interrogación dirigida el host indicado como hostN, y sólo a él, en archivo de configuración).

Para instalarlo, es necesario copiar:

* '''asterisk/apps/app_mdintz.c'''
* '''asterisk/include/asterisk/mdintz.h'''
* En asterisk 1.4.24 conviene asegurar que se ha actualizado '''"asterisk/apps/app_queue.o"''' y '''"asterisk/apps/app_queue.so"'''
* Luego '''"make", "make install"''' y module '''"unload/load"''' (mejor "stop now" y start)

'''→ scripts y rc.debian.asterisk'''

cambiado contrib/scripts por el modificado por MDtel 
cambiado contrib/init.d/rc.debian.asterisk por el modificado por MDtel

'''→ Carpeta mp3 añadida al directorio addons'''

La carpeta mp3 en addons permite la reproducción desde el diaplan de los mensajes en mp3. En make menuselect hay que marcar el format_mp3 y app_mp3 e instalar el paquete mpg123 de ubuntu

'''→ sig_pri.c'''

Modificado para enviar/recibir el ucid en un primario qsig

Para que se envie el ucis tenemos que habilitar el envio de facilidades en el chan_dahdi.conf

facilityenable = yes

'''→ init.d''' 

* Uno de los archivos modificados ha sido '''init.d''', se encuentra en la ruta: '''/etc/init.d/asterisk'''. La modificación realizada es la siguiente:

{|style="background-color:#ffffcc;" class="wikitable"
|-
|-
| SAFE_ASTEISK=/usr/sbin/safe_asterisk 
if [ -x $SAFE_ASTERISK ] ; then 
:# //!! wkw 
:DAEMON=$SAFE_ASTERISK 
fi
|}



'''→ safe-asterisk'''
* Se encuentra en la siguiente ruta:'''/usr/sbin/safe-asterisk''' .En este archivo se ha modificado MAXFILES=32768

'''→ default'''

* Este fichero podemos encontrarlo en: '''/etc/default/asterisk'''. La finalidad de la modificación de este fichero es poder correr como usuario Asterisk, grupo asterisk y generar cores (descomentar línea)
Las modificaciones realizadas han sido:

{|style="background-color:#ffffcc;" class="wikitable"
|-
|-
| AST_USER="asterisk"
AST_GROUP="asterisk"

COREDUMP=yes
|}

===== Nueva función de asterisk: app_cli.so =====

Esta función permite ejecutar desde el '''dialplan''' un comando de línea de consola de '''asterisk (CLI).''' Su primer uso (y esperamos que no último) será para lanzar los '''notify''' que los teléfonos necesitan para el ''reaprovisionamiento'' desde el portal o desde la facilidad de movilidad de usuario.

Básicamente ejecuta un comando y devuelve su salida. Utiliza un archivo intermedio que puede ser:

* '''/dev/null''' si el campo se deja vacío, por tanto, no se puede recuperar la salida.
* '''TEMP''', en cuyo caso se crea un archivo temporal que se borra antes de finalizar la ejecución de la función.
* Un nombre de fichero que es responsabilidad del dialplan el borrarlo cuando proceda.

Para instalarlo basta copiar '''apps/app_cli.c''' en el directorio ''' "apps" ''' de los fuentes y luego ejecutar '''"make" y "make install".'''

A continuación se pasa el resultado de '''"core show function CLI" '''

'''[Synopsis]'''

Lanza un comando CLI desde dialplan

'''[Description]''' 
- CLI(nomArchSal,cmd) 
- Si 'nomArchSal' está vacio, se usa '/dev/null' y no se recupera resultado 
- Si 'nomArchSal'=TEMP, Se crea un archivo temporal que se borra al final 
- En otro caso, se crea el archivo y no se borra

'''[Syntax]''' 
CLI(nomArchSal,cmd)

'''[Arguments]''' 
'''nomArchSal'''
Archivo de salida (si se omite, /dev/null)
'''cmd'''
Comando a ejecutar via CLI

==== Dialplan ====

El Dialplan podría considerarse la columna vertebral del sistema ''Asterisk''.

Es una colección ordenada de acciones que se llevan a cabo cuando un usuario marca una serie de números. Hace la función de una tabla de enrutamiento de llamadas.

Todas las configuraciones generales de Asterisk están accesibles en la ruta '''/etc/asterisk'''

'''CONCEPTOS BÁSICOS'''

♦ '''EXTENSIONES'''

Una extensión es una marcación en el teclado de un teléfono. Dicha configuración podemos encontrarla en el archivo '''extensions.conf'''

Por ejemplo, un usuario podría marcar “3001” en su teléfono, y eso sería una extensión. También podría marcar un número de teléfono nacional, como por ejemplo “915881000”, y también sería una extensión.

En Asterisk pueden definirse también extensiones como texto, por tanto no debemos relacionar las extensiones únicamente con números.

Algunas reglas que sería interesante conocer serían las siguientes:

{| class="wikitable"
|-
! '''Regla''' !! '''Descripción'''
|-
| '''X''' || Cualquier cifra de 0 a 9
|-
|'''Z'''||Cualquier cifra de 1 a 9
|-
|'''N'''||Cualquier cifra de 2 a 9
|-
|'''[x-y]'''||Cualquier cifra de "x" a "y"
|-
|'''[xyz]'''|| Las cifras "x", "y" o "z"
|-
|'''.'''||Una o más repeticiones del símbolo anterior
|-
|'''!'''||Cero o más repeticiones del símbolo anterior
|}

Estas reglas son necesarias a la hora de definir por ejemplo todos los números de teléfono posibles en España

♦ '''PRIORIDADES'''

En lenguaje scripting, las acciones se van ejecutando de arriba a abajo en orden. En cambio, en Asterisk, el orden en el que se ejecutan las acciones es el indicado mediante números.
Primero se ejecutará la acción 1, luego la 2...así sucesivamente.

Es decir no basta con definir las acciones que se llevarán a cabo, también debemos indicar el orden en el que se llevarán a cabo.

♦ '''CONTEXTOS'''

Es mecanismo que nos permite variar el comportamiento del sistema en función del número que se marque. Su misión es aumentar la seguridad del sistema ofreciendo servicios diferenciados en función del usuario.

La sintaxis típica es el nombre del contexto englobado entre corchetes [nombre_contexto]. Si un dispositivo no tiene un contexto definido se redirige directamente al contexto por defecto.

Los ficheros que conforman el Dialplan se clasifican en:

* '''Generales'''
* '''Particulares'''
* '''Web'''

{| class="wikitable"
|-
! '''Fichero''' !! '''Función'''
|-
| '''Generales''' || Se encuentran los ficheros de propios de MDtel y Asterisk. Es importante remarcar que estos ficheros NO pueden ser modificados por el usuario.
|-
|'''Particular'''||Estos ficheros son los únicos que puede modificar el usuario
|-
|'''Web'''|| Se encierran aquí los archivos generados automáticamente por la plataforma, a través del portal
|}

En función del nodo en el que estemos trabajando, encontraremos dos tipos de dialplan:

'''* Dialplan ACD''' --> Dialplan que aplica a nodos ACD

'''* Dialplan corporativa''' --> Dialplan que aplica a nodos de corporativa o gateways (ya sean de corporativa o ACD)

A continuación se muestran las tablas con los ficheros correspondientes a cada Dialplan.

{| border="1" align="center" bgcolor="FloralWhite"
|+ '''Ficheros de configuración Dialplan Corporativo'''
| '''GENERALES'''
| '''PARTICULARES'''
| '''WEB'''
|-
| ext_Grabaciones.conf ext_InicioLlamada.conf ext_InicioLlamada_Dahdi.conf ext_InicioLlamada_ExtSIP.conf ext_InicioLlamada_TrunkSIP.conf ext_MARCAR_ColaCentralita.conf ext_MARCAR_ColaCentralita_Dial.conf ext_MARCAR_Cola.conf ext_MARCAR_Cola_Dial.conf ext_MARCAR.conf ext_MARCAR_DejarMensaje.conf ext_MARCAR_DejarMensaje_Dial.conf ext_MARCAR_Extension.conf ext_MARCAR_Extension_Dial.conf ext_MARCAR_Externo.conf ext_MARCAR_Externo_Dial.conf ext_MARCAR_Facilidad.conf ext_MARCAR_Facilidad_Dial.conf ext_MARCAR_Facilidad_nimitz.conf ext_MARCAR_Interno.conf ext_MARCAR_LeerMensaje.conf ext_MARCAR_LeerMensaje_Dial.conf ext_MARCAR_Nodo.conf ext_MARCAR_Nodo_Dial.conf ext_MARCAR_SalasConf.conf ext_MARCAR_SalasConf_Dial.conf ext_MARCAR_Servicios.conf ext_MARCAR_VDN.conf MARCAR_VDN_Dial.conf ext_MDtel.conf ext_MDtel_Var.conf ext_Subrutinas_AnchoBanda.conf ext_Subrutinas_BD.conf ext_Subrutinas_BD_Facilidad.conf ext_Subrutinas_BD_Facilidad.conf ext_Subrutinas_Colas.conf ext_Subrutinas.conf ext_Subrutinas_Enrutamiento.conf ext_Subrutinas_finLlamada.conf ext_Subrutinas_Grabacion.conf ext_Subrutinas_nimitz.conf ext_Subrutinas_Varias.conf ext_Subscribe.conf ext_Transfer.conf ext_Transfer_ExtSIP.conf ext_Transfer_TrunkInternos.conf ext_TrunkInternos.conf ext_TrunkInternos_Dial.conf sip_Estatico.conf sip_GENCUST.conf sip_notify.conf queues.conf queues_GENERAL.conf queues_PLANTILLACOLAS.conf 

| ext_Enrutador_Particular.conf ext_InicioLlamada_Dahdi_Particular.conf ext_InicioLlamada_ExtSIP_Particular.conf ext_InicioLlamada_Particular.conf ext_InicioLlamada_TrunkSIP_Particular.conf ext_MARCAR_Extension_Particular.conf ext_MARCAR_Externo_Particular.conf ext_MARCAR_Facilidad_Particular.conf ext_MARCAR_VDN_Particular.conf ext_MDtel_Particular.conf ext_TrunkInternos_Particular.conf 

|asterisk_WEB.conf ext_MDtel_WEB.conf sip_trunkExt_WEB.conf sip_trunkInt_WEB.conf sip_trunk_WEB.conf sip_WEB.conf queues_WEB.conf
|}

{| border="1" align="center" bgcolor="FloralWhite"
|+ '''Ficheros de configuración Dialplan ACD'''
| '''GENERALES'''
| '''PARTICULARES'''
| '''WEB'''
|-
| ext_Enrutador.conf ext_Grabaciones.conf ext_InicioLlamada.conf ext_InicioLlamada_CTI.conf ext_InicioLlamada_Dahdi.conf ext_InicioLlamada_ExtSIP.conf ext_InicioLlamada_Marcador.conf ext_InicioLlamada_TrunkSIP.conf ext_MARCAR_ColaCentralita.conf ext_MARCAR_ColaCentralita_Dial.conf ext_MARCAR_Cola.conf ext_MARCAR_Cola_Dial.conf ext_MARCAR.conf ext_MARCAR_DejarMensaje.conf ext_MARCAR_DejarMensaje_Dial.conf ext_MARCAR_Extension.conf ext_MARCAR_Extension_Dial.conf ext_MARCAR_Externo.conf ext_MARCAR_Externo_Dial.conf ext_MARCAR_Facilidad.conf ext_MARCAR_Facilidad_Dial.conf ext_MARCAR_Facilidad_nimitz.conf ext_MARCAR_LeerMensaje.conf ext_MARCAR_LeerMensaje_Dial.conf ext_MARCAR_Nodo.conf ext_MARCAR_Nodo_Dial.conf ext_MARCAR_SalasConf.conf ext_MARCAR_SalasConf_Dial.conf ext_MARCAR_Servicios.conf ext_MARCAR_VDN.conf ext_MARCAR_VDN_Dial.conf ext_MDtel.conf ext_MDtel_Var.conf ext_Subrutinas_AnchoBanda.conf ext_Subrutinas_BD.conf ext_Subrutinas_BD_Facilidad.conf ext_Subrutinas_Colas.conf ext_Subrutinas.conf ext_Subrutinas_Enrutamiento.conf ext_Subrutinas_finLlamada.conf ext_Subrutinas_Grabacion.conf ext_Subrutinas_nimitz.conf ext_Subrutinas_Varias.conf ext_Subscribe.conf ext_Transfer.conf ext_Transfer_ExtSIP.conf ext_Transfer_TrunkInternos.conf ext_TrunkInternos.conf ext_TrunkInternos_Dial.conf queues_GENERAL.conf queues_PLANTILLACOLAS.conf sip_GENCUST.conf sip_GENERAL.conf sip_notify.conf sip_PLANTILLAEXT.conf sip_supervision.conf 

| ext_Enrutador_Particular.conf ext_InicioLlamada_CTI_Particular.conf ext_InicioLlamada_Dahdi_Particular.conf ext_InicioLlamada_ExtSIP_Particular.conf ext_InicioLlamada_Marcador_Particular.conf ext_InicioLlamada_Particular.conf. ext_InicioLlamada_TrunkSIP_Particular.conf ext_MARCAR_Externo_Particular.conf ext_MARCAR_Facilidad_Particular.conf ext_MARCAR_VDN_Particular.conf ext_MDtel_Particular.conf ext_TrunkInternos_Particular.conf 

|asterisk_WEB.conf ext_MDtel_WEB.conf queues_WEB.conf sip_trunkInt_WEB.conf sip_WEB.conf 
|}
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Servicios networking ===
Son muy importantes las configuraciones adecuadas de los servicios de:

* '''NTP''': El sistema en global ha de estar sincronizado; todos los servidores y puestos de trabajo (en el caso de ''VIVA''it Suite) han de estar perfectamente sincronizados; los servidores de la plataforma se sincronizarán con el NTP del cliente; si el cliente no tiene NTP será necesario que un servidor de la plataforma se sincronice con un NTP externo y este sea el servidor para el resto de la plataforma

* '''DNS''': La configuración de DNS de la plataforma será coherente con el resto de la plataforma IT del cliente

* '''DHCP''': Es necesario coordinar con el cliente la asignación de direcciones para los diferentes elementos de la plataforma '''''VIVA'''''it, fundamentalmente para terminales telefónicos; en este caso además será necesario activa la opción 66 que permitirá definir el servidor TFTP del que los terminales cogerán sus ficheros de aprovisionamiento

=== Bases de datos (BBDD)===

La base de datos del sistema se basa en el motor de base de datos MySQL, es un elemento crítico del sistema, en el que insertan y del que obtiene mucha información múltiples procesos.
Muchas comunicaciones entre procesos se realizan vía Base de Datos (tabla COM_COMUNICADOS). Pueden existir distintas instancias de base de datos que explicadas en las siguientes secciones, nuestra base de datos tiene la siguiente estructura: [[Base de datos|Información completa de la BD]]. Podéis ampliar más información en https://dev.mysql.com/doc/

==== BBDD Tiempo Real ====
En la base de datos de tiempo real insertan información todos los procesos del sistema, y se realizan los cambios en configuración utilizando como herramienta el portal de administración y '''''VIVA'''''it Supervisor

De la base de datos de tiempo real leen los procesos que requieren información, y las aplicaciones:
*'''''VIVA'''''it Supervisor (para reporting de tiempo real)
*PanelWeb
*Datos de sesión de '''''VIVA'''''it Desk
*Monitorización Zabbix
* Otros

El portal de administración se encarga de escribir las configuraciones añadidas o modificadas en la base de datos

Para cuando la BDTR contienen un número masivo de datos, existe un script que borra el contenido de ciertas tablas de la BD (tablas DAT_) dejando solamente datos de un cierto número de días configurable.
Este script se llama borraRegistrosNimitz.pl; para más información consultar el apartado de Howto's.

'''Por defecto, a partir de la versión 3.2.0 de la plataforma, los registros se mantedrán 2 meses.'''

==== BBDD Réplica ====
A efectos de asegurar las prestaciones del sistema, se establece una réplica de la base de datos, sincronizada con la de tiempo real; los procesos y aplicaciones pesados, que realicen consultas a las base de datos que puedan comprometer las prestaciones del sistema atacan a la réplica y nunca a la base de datos de tiempo real

Es posible que en instalaciones pequeñas no exista réplica, en cuyo caso se establece una base de datos unificada sobre la de tiempo real, en la que se añaden índices y procedimientos almacenados que típicamente residen en la de réplica.

Es posible establecer tantas réplicas como sean necesarias si diferentes procesos pesados se penalizan en exceso, si bien una implantación tipo contemplará una sola

Algunos procesos que utilizan la base de datos de réplica son:
*'''''VIVA'''''it Reporting
*'''''VIVA'''''it Tracker
*Histórico en tiempo real de '''''VIVA'''''it Supervisor

'''IMPORTANTE: Ningún proceso, programa, aplicación, etc. escribe en la base de datos de réplica; tan solo se extrae información'''

==== BBDD de copia ====
A efectos de asegurar el funcionamiento y como medida de contingencia ante un problema puntual de comunicación con la BD de tiempo real, en cada nodo disponemos de una BD de copia local. Posiblemente de un tamaño menor que la BD de tiempo real, dependiendo de cuanto tiempo pase hasta la próxima sincronización con la base de tiempo real.Esta base de datos llamada '''nimitzCopia'''.

Solo entrara en funcionamiento,cuando se produzca el problema mencionado, dejando acceder a los datos y poder dar servicio a la empresa mientras se soluciona el problema.

===== Backup y restore =====

Se utilizan dos script, para realizar la copia de seguridad y restaurar en la base de datos de copia local que son:

* El proceso '''bdCentral.sh''' que es el encargado de realizar la copia de seguridad. Tiene un archivo de configuración bdCentral.conf. En este archivo hay un parámetro (IGNORE_TABLAS) que indica las tablas de las que NO se realizará copia de seguridad. Toda tabla que no se indique formará parte de la copia de seguridad. Vuelca los resultados en /var/log/bdCentral.log
* El proceso '''bdNodo.sh''' que es el encargado de descargar la copia de seguridad y restaurarla en local. Tiene un archivo de configuración bdNodo.conf. Vuelca los resultados en /var/log/bdNodo.log. El fichero de backup se copia mediante el usuario sincroniza, que deberá poder acceder sin contraseña al servidor donde reside la copia.

En caso de producirse algún error en alguno de los procesos, marcarán dicho error en el log con una línea que comienza con la cadena "*ERROR".

==== Diagnósticos y operaciones sobre bases de datos ====

=====Comprobación que una base de datos está arrancada=====
Para comprobar si la base de datos está arrancada debemos poner en el terminal : '''ps aux | grep mysql'''

Si la base de datos está arrancada y funcionando correctamente se nos mostrará en el terminal:
[[Archivo:Base_Datos_bien.png‎ |500px|center]]

Por el contrario, si la base de datos presenta algun problema el mensaje mostrado será:

[[Archivo:Base_datos_mal.png |center]]

=====Comprobación que la base de datos de réplica está sincronizada con la base de datos de tiempo real.=====

Si se necesita verificar que la base de réplica está sincronizada con la base de datos en tiempo real basta con acudir al comando : '''show slave status\G'''.

Una vez introducido veremos:

[[Archivo:Replica.png |980px|center]]

Comandos importantes, desde dentro consola de Mysql:

'''show master status''': Realizado desde el master
'''show slave status''': Realizado desde el esclavo; el valor "seconds behind master" nos indica
cuanto está retrasada la réplica con respecto a la base de datos de tiempo real. Si el valor de este campo es elevado nos indicará
que la base de datos real con la réplica no estará sincronizada, por tanto, nos interesa que este valor sea lo más pequeño posible.
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Procesos propios ===

==== bdCentral ====

El proceso ''bdCentral.sh'' es el encargado de realizar la copia de seguridad. Tiene un archivo de configuración ''bdCentral.conf'' el cual puede encontrarse en la ruta '''/etc/MDtel/bdCentral.conf'''. En este archivo hay un parámetro (IGNORE_TABLAS) que indica las tablas de las que NO se realizará copia de seguridad. Toda tabla que no se indique formará parte de la copia de seguridad. Vuelca los resultados en /var/log/bdCentral.log

En caso de producirse algún error, se marcará dicho error en el log con una línea que comienza con la cadena "*ERROR".

Para ejecutar bdCentral:
bdCentral.sh /etc/MDtel/bdCentral.conf

Estos procesos se ejecutan automáticamente. Para ello está copiado el fichero bdCentral a /etc/cron.d.

Por defecto la programación vienen comentada por lo que será necesario activarlo.

Para que se roten los logs hay que copiar el fichero bdCentral.logrotate a /etc/logrotate.d (como bdCentral)
La ruta donde se encuentran los logs es la siguiente: '''/var/log/myAcdSuperv.log'''

Fichero de configuación:

ARCH_LOG=/var/log/bdCentral.log

BDHOST=localhost
BDUSU=adminNimitz
BDCLAVE=imdtelnimitz
BDRUTA=/var/lib/MDtel/backupBDnimitz

IGNORE_TABLAS=(nimitz.DAT_ACD_RASTREO nimitz.DAT_ACUMULADOS_AGENTES nimitz.DAT_ACUMULADOS_AGENTES_COLAS
nimitz.DAT_ACUMULADOS_AGENTES_PAUSAS nimitz.DAT_ACUMULADOS_AGENTES_VDN nimitz.DAT_ACUMULADOS_COLAS
nimitz.DAT_ACUMULADOS_VDN nimitz.DAT_ACUMULADOS_VDN_COLAS nimitz.DAT_CONTACTOS_PREPARADOS
nimitz.DAT_IVR_INTERACCIONES nimitz.DAT_IVR_NODOS nimitz.DAT_IVR_PAGOS_TARJETA nimitz.DAT_IVR_RESULT_ENCUESTAS
nimitz.DAT_LLAMADAS nimitz.DAT_LOG nimitz.DAT_MUESTRAS_COLAS nimitz.DAT_SEGMENTOS nimitz.DAT_SESIONES_AGENTES
nimitz.DAT_SESIONES_AGENTES_COLAS nimitz.DAT_SESIONES_AGENTES_PAUSAS nimitz.DAT_SESIONES_AGENTES_VDN
nimitz.DAT_SINCRONIZA nimitz.DAT_TR_ACD_EXTENSIONES nimitz.DAT_TR_ACD_EXTEN_COLA nimitz.DAT_TR_COLAS
nimitz.DAT_VALORACIONES nimitz.DAT_ACD_RASTREO nimitz.DAT_ACUMULADOS_AGENTES_COLAS
nimitz.DAT_ACUMULADOS_AGENTES_PAUSAS nimitz.DAT_ACUMULADOS_AGENTES_VDN nimitz.DAT_ACUMULADOS_COLAS
nimitz.DAT_ACUMULADOS_VDN nimitz.DAT_LLAMADAS nimitz.DAT_MUESTRAS_COLAS nimitz.DAT_SEGMENTOS
nimitz.DAT_SESIONES_AGENTES nimitz.DAT_SESIONES_AGENTES_COLAS nimitz.DAT_SESIONES_AGENTES_PAUSAS
nimitz.DAT_SESIONES_AGENTES_VDN nimitz.DAT_TR_ACD_EXTENSIONES nimitz.DAT_TR_ACD_EXTEN_COLA nimitz.DAT_TR_COLAS
nimitz.DAT_VALORACIONES)

*A continuación se explica los campos mas relevantes del fichero de configuración bdCentral.conf.
{| class="wikitable"
|-
!Campo !!Descripción !!Posibles valores (si aplica)
|-
|ARCH_LOG|| /RUTA/FICHERO de log del proceso||
|-
|BDHOST||IP o HOST máquina base de datos de tiempo real||
|-
|BDUSU||Usuario acceso Base de datos de tiempo real||
|-
|BDCLAVE||Clave usuario acceso base de datos tiempo real||
|-
|BDRUTA||Ruta donde se depositará el dump de la base de datos||
|-
|IGNORE_TABLAS||Tablas de las que no queramos hacer backup||
|-
|}

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== bdNodo ====
El proceso bdNodo.sh es el encargado de descargar la copia de seguridad y restaurarla en local. Tiene un archivo de configuración bdNodo.conf, este archivo puede encontrarse en la ruta '''/etc/MDtel/bdNodo.conf.''' Vuelca los resultados en /var/log/bdNodo.log. El fichero de backup se copia mediante el usuario sincroniza, que deberá poder acceder sin contraseña al servidor donde reside la copia.

En caso de producirse algún error, se marcará dicho error en el log con una línea que comienza con la cadena "*ERROR".

Para ejecutar bdNodo:

bdNodo.sh /etc/MDtel/bdNodo.conf

Estos procesos se ejecutan automáticamente. Para ello está copiado el fichero bdNodo a /etc/cron.d.

Por defecto la programación vienen comentada por lo que será necesario activarlo.

Para que se roten los logs hay que copiar el fichero bdNodo.logrotate a /etc/logrotate.d (como bdNodo)

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== Intz-Nimitz ====

Permite integrar procesos de asterisk (del dialplan) con la base de datos; por ejemplo es el que graba segmentos, inspecciona donde está registrado un agente…etc. La estabilidad de este proceso es importante para el funcionamiento del sistema, si bien las llamadas entran en caso de no estar disponible.

Para mas información consultar la página de [[intz-nimitz|intz-nimitz]].

Desde un SSH ejecuta el comando “nc ip_maquina 1115”

'''root@vivait-acd:~# nc localhost 1115'''
intz-nimitz sis ver='V02.6' inic='20140401 110116' alarmas=21 ultAlar='20140414 171244'
intz-nimitz gmp msj=942/1024 buf=1024/1024 tarea=16/102
intz-nimitz tmp uptime=1816550 (21d 0h 35m 50s)
intz-nimitz vic identif='cms1' entorno='nimitz' conx=0/128 numConx=1018(0)
intz-nimitz mys curro=80/0/0/0 soli=1012(0) soliErr=6(0) soliEncol=0(0/0)
intz-nimitz cache colas=128/10/0/0 vdn=128/8/0/0 usuExten=10/0/0/0

Donde cada parámetro monitorizado indica:
{| class="wikitable"
|-
!Parámetro!!Descripción
|-
|sis/ver||Versión del proceso
|-
|sis/inic||Fecha de de arranque del proceso
|-
|Sis/alarmas||Alarmas desde arranque
|-
|Sis/ultAlar||Fecha de última alarma
|-
|Gmp/msj||
|-
|Gmp/buf||
|-
|Gmp/tarea||
|-
|Tmp/uptime||Tiempo que lleva el servicio activo
|-
|Vic/identif||Etiqueta de identificación del servicio
|-
|Vic/entorno||Entorno de base de datos
|-
|Vic/conx||Conexiones activas/conexiones máximas
|-
|Vic/numConx||Conexiones totales (último minuto)
|-
|Mys/curro||Número de hilos contra la base de datos
|-
|Mys/soli||Conexiones solicitadas (último minuto)
|-
|Mys/soliErr||Conexiones solicitadas con error (último minuto)
|-
|Mys/soliEncol||Conexiones encoladas
|-
|Cache/cola|| Colas monitorizadas/
|-
|Cache/vdn||VDN’s monitorizados
|-
|Cache/usuExten||
|-
|}

Como complemento a los diagnósticos:

* Podremos examinar el fichero de configuración del proceso en '''/etc/MDtel/intz-nimitz.conf'''
* Podremos examinar los logs del proceso en '''/var/log/intz-nimitz.log'''

'''Fichero de configuración:'''

#
# Los nombres no pueden tener numeros
# Si el valor de una cadena contiene espacios, se pondra entre comillas dobles
# Los valores comentados indican valores por defecto

base
{
cfg
{
soy_demonio = 1
hay_syslog = 0
# Archivo con identificador de proceso: (-: /var/run/intz-nimitz.pid)
archivo_pid = -
# Archivo_traza: (-: stdout o /var/log/intz-nimitz.log si soy_demonio)
# No se usa si se activa hay_syslog
archivo_traza = -
}
cfg_recarga
{
# Nivel_traza: (0: alarma, 1: aviso, 2: info, 3: depuAlto o 4: depuBajo)
nivel_traza = 3
pruebas = 1
hay_flush_traza = 1
}
sis
{
# No se usa. No modificar
subsistema = 0
}
gmp
{
# Numero de mensajes. No modificar
num_msj = 1024
# Numero de buffer. No modificar
num_buf = 1024
}
}

supervision
{
puerto_escucha = 1115
}

supervision_recarga
{
to_periodo = 60
}

cache
{
hay_cache = 1
}

cache_recarga
{
# to_vida = 0, no se almacenan entradas. to_vida > 0 en segundos
colas_to_vida = 300
colas_num_entrada = 128
vdn_to_vida = 300
vdn_num_entrada = 128
}

regexp
{
hay_regexp = 1
}

regexp_recarga
{
num_entradas = 32
inc_entradas = 128
max_entradas = 1024
}

vivaitcall
{
hay_vic = 1
puerto_escucha = 5555
identif = cms1
entorno = nimitz
max_conx = 128
}

vivaitcall_recarga
{
to_solicitud = 3
to_desconexion = 3
ip_valida
{
# Hasta 32 bloques de direcciones validas
todas
{
ip = 0.0.0.0
msk = 0.0.0.0
}
localhost
{
ip = 127.0.0.1
msk = 255.255.255.255
}
}
}

enrutamiento
{
hay_enrutamiento = 1
max_pre_ruta_regs = 4
max_ruta = 4
max_ruta_desvios = 2
# Filtro de informacion de ancho de banda
# MYSDanchoBandaPasoNinguno 0
# MYSDanchoBandaPasoSoloDirectos 1
# MYSDanchoBandaPasoSoloEnPaso 2
# MYSDanchoBandaPasoTodos 3
filtro_ancho_banda = 1
}

mysql
{
hay_mysql = 1
host = BDTR
usuario = nimitz
clave = phikau3iwCe4O0PP5b09ng==
base_datos = nimitz
bd_supervivencia = 0
num_curro = 10
}

mysql_recarga
{
to_resp = 5
}

Los siguientes son los campos del fichero de configuración '''int-nimitz.conf''':

{| class="wikitable"
|-
|Variable a modificar||Comentarios||Posibles valores (si aplica)
|-
|soy_demonio||Si corro como demonio o como proceso||1 demonio – 0 proceso
|-
|hay_syslog||Si hay servidor de syslog||1 lo hay – 0 no lo hay
|-
|archivo_pid||# Archivo con identificador de proceso: (-: /var/run/intz-nimitz.pid)||
|-
|archivo_traza||# Archivo_traza: (-: stdout o /var/log/intz-nimitz.log si soy_demonio)||
|-
|nivel_traza||# Nivel_traza: (0: alarma, 1: aviso, 2: info, 3: depuAlto o 4: depuBajo)||
|-
|pruebas||||
|-
|hay_flush_traza||||
|-
|subsistema||# No se usa. No modificar||
|-
|num_msj||# Numero de mensajes. No modificar||
|-
|num_buf||# Numero de buffer. No modificar||
|-
|puerto_escucha||Puerto de supervisión del demonio||
|-
|to_periodo||Timeout para reconectar||
|-
|hay_cache||si guarda datos o no en cache||1 hay cache – 0 no hay cache
|-
|colas_to_vida||# to_vida = 0, no se almacenan entradas. to_vida > 0 en segundos||
|-
|colas_num_entrada||Número de entradas correspondiente a las colas||
|-
|vdn_to_vida||# to_vida = 0, no se almacenan entradas. to_vida > 0 en segundos||
|-
|vdn_num_entrada||Número de entradas correspondiente a los VDN||
|-
|hay_regexp||||
|-
|num_entradas||||
|-
|inc_entradas||||
|-
|max_entradas||||
|-
|hay_vic||||
|-
|puerto_escucha||Puerto de escucha a nivel de vivait-call||
|-
|identif ||||
|-
|entorno||Nombre base de datos||
|-
|max_conx||Número máximo de conexiones a la base de datos||
|-
|to_solicitud||Timeout de solicitud||
|-
|to_desconexion||Timeout de desconexión||
|-
|ip||Dirección de red de escucha del intz-nimitz||
|-
|msk ||Máscara de red de escucha del intz-nimitz||
|-
|ip||IP localhost||
|-
|msk||Máscara localhost||
|-
|hay_enrutamiento||Hay fase de enrutamiento o no||1 hay enrutamiento – 0 no hay
|-
|max_pre_ruta_regs||Número máximo de prerutas a cargar||
|-
|max_ruta||Número máximo de rutas a cargar||
|-
|max_ruta_desvios||Número máximo de rutas de desvíos a cargar||
|-
|filtro_ancho_banda||Filtrar por ancho de banda||1 filtrar – 0 no filtrar
|-
|hay_mysql||Hay mysql||1 hay -0 no hay
|-
|host||IP o HOST máquina base de datos ||
|-
|usuario||Usuario acceso Base de datos||
|-
|clave||Clave usuario acceso base de datos||
|-
|base_datos||Nombre de la base de datos||
|-
|bd_supervivencia||Hay o no base de datos de supervivencia||1 hay base de datos de supervivencia – 0 no hay
|-
|num_curro||Número de conexiones simultáneas a la base de datos||
|-
|to_resp||Timeout de respuesta||
|-
|}

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== intz-gh ====

intz-gh es un demonio que permite tanto la monitorizacion de extensiones (BLFs), como la activación de retrollamadas entre distintos nodos.

'''Comandos desde consola de asterisk'''

mdgh show

Uso: mdgh show [config | exten <exten_num> | enla <peer>]]

* '''Ejemplo'''

mdgh show config
mdgh Configuracion:

debug=no
retro_hay=yes
subscripcion_hay=yes
rest_red_ip=255.255.255.255
rest_red_msk=255.255.255.255
rest_puerto_escucha=8090
retro_exten_tech=SIP
retro_contexto=Cen_InicioLlamada_GHRetro
retro_to_descolgar=30 s
retro_A_cartel_fmt='retro: %s

mdgh show exten 6146

mdgh Datos de la extension 6146:

Datos en intz-gh:
ESTADO=NOT_INUSE
INUSE=0
RINGING=0
TS=1535609682
HACE=1171

mdgh show en la Trunk_MDtel

mdgh Datos del enlace Trunk_MDtel:

Datos en intz-gh:
INUSE=0
RINGING=0
TS=1535610093
HACE=834

'''Fichero de log'''

/var/log/intz-gh.log

'''Fichero de configuracion'''

/etc/MDtel/intz-gh.conf

'''Campos intz-gh.conf'''

# Los nombres no pueden tener numeros.
# Si el valor de una cadena contiene espacios, se pondra entre comillas dobles.
# Los valores comentados indican valores por defecto.

base

cfg
{
soy_demonio = 1
hay_syslog = 0
# Archivo con identificador de proceso: (-: /var/run/intz-nimitz.pid)
archivo_pid = -
# Archivo_traza: (-: stdout o /var/log/intz-nimitz.log si soy_demonio)
# No se usa si se activa hay_syslog
archivo_traza = -
}
cfg_recarga
{
# Nivel_traza: (0: alarma, 1: aviso, 2: info, 3: depuAlto o 4: depuBajo)
nivel_traza = 3
pruebas = 1
hay_flush_traza = 1
# traza_milisegundos = 1
}
sis
{
# No se usa. No modificar
subsistema = 0
}
gmp
{
# Numero de mensajes. No modificar
num_msj = 256
# Numero de buffer. No modificar
num_buf = 256
}
}

supervision
{
puerto_escucha = 1116
}

supervision_recarga
{
to_periodo = 60
}

regexp
{
hay_regexp = 1
}

regexp_recarga
{
num_entradas = 32
inc_entradas = 128
max_entradas = 1024
}

vivaitcall
{
hay_vic = 1
puerto_escucha = 5556
identif = gh_000
entorno = gh
max_conx = 4
}

vivaitcall_recarga
{
to_solicitud = 10
to_desconexion = 10
ip_valida
{
# Hasta 32 bloques de direcciones validas
todas
{
ip = 0.0.0.0
msk = 0.0.0.0
}
localhost
{
ip = 127.0.0.1
msk = 255.255.255.255
}
}
}

mysql
{
hay_mysql = 1
host = BDTR
usuario = nimitz
clave = phikau3iwCe4O0PP5b09ng==
base_datos = nimitz
}

mysql_recarga
{
to_resp = 5
}

gh1
{
hay_gh1 = 1
# umbrales para el numero de digitos de una extension
# sirve para saber si un peer es una extension o un enlace
exten_min_digi = 3
exten_max_digi = 8
# numero maximo de extensiones soportadas
exten_max = 500
# numero maximo de enlaces soportados
enla_max = 20
# numero maximo de retrollamadas activas concurrentes
retro_max = 50
# numero maximo de retrollamadas activas concurrentes para una extension como destino (max 31)
retro_max_b = 4
}

gh1_recarga
{
# tiempo maximo en segs. para activar una retrollamada tras finalizar llamada
to_retro_candidato = 60
# tiempo maximo en segs. que una retrollamada espera a que las extensiones esten libres
to_retro_activo = 300
# temporizador de limpieza de tablas en segs.
to_limpiar = 10
}

ias
{
hay_ias = 1
url = mdgh_rest
puerto = 8090
}

ias_recarga
{
# tiempo maximo en segs. para conectar con asterisk para comandos
to_conx_cmd = 10
# periodo en horas para actualizar lista de id de nodos y sus direcciones ip
to_lista_nodos = 1
}

==== motorSal ====
Parte fundamental del proceso de marcación saliente, gestiona como hay que llamar a los diferentes contactos asignados a las campañas. Transforma los contactos en intentos de marcación.

A efectos de diagnósticos, desde un SSH ejecuta el comando “nc ip_maquina 1120”

'''root@vivait-acd:~# nc localhost 1120'''
motorSal sis ver='V01.4' inic='20140725 140832' alarmas=1 ultAlar='20140725 140832'
motorSal gmp msj=253/256 buf=256/256 tarea=99/102
motorSal tmp uptime=600165 (6d 22h 42m 45s)
motorSal mtr mys=1 ocup=0% planif=28(0) intento=26(0)

Donde cada parámetro monitorizado indica:

{| class="wikitable"
|-
!Parámetro!!Descripción
|-
|SIS/ver||Versión del proceso
|-
|SIS/inic||Fecha de de arranque del proceso
|-
|SIS/alarmas||Alarmas desde arranque
|-
|SIS/ultAlar||Fecha de última alarma
|-
|Gmp/msj||
|-
|Gmp/buf||
|-
|Gmp/tarea||
|-
|Tmp/uptime||Tiempo que lleva corriendo
|-
|mtr/mys||Si está conectado al MySQL
|-
|mtr/ocup||Porcentaje de ocupación
|-
|mtr/planif||Contactos planificados Totales (Último minuto)
|-
|mtr/intento||Intentos totales (Ültimo minuto)
|-
|}

* Posee un fichero de configuración llamado ''motorSal.conf'' en la ruta '''/etc/MDtel/motorSal.conf''':

#
# Los nombres no pueden tener numeros
# Si el valor de una cadena contiene espacios, se pondra entre comillas dobles
# Los valores comentados indican valores por defecto

base
{
cfg
{
soy_demonio = 1
hay_syslog = 0
# Archivo con identificador de proceso: (-: /var/run/motorSal.pid)
archivo_pid = -
# Archivo_traza: (-: stdout o /var/log/motorSal.log si soy_demonio)
# No se usa si se activa hay_syslog
archivo_traza = -
}
cfg_recarga
{
# Nivel_traza: (0: alarma, 1: aviso, 2: info, 3: depuAlto o 4: depuBajo)
nivel_traza = 2
pruebas = 0
hay_flush_traza = 1
# traza_milisegundos = 1
}
sis
{
# No se usa. No modificar
subsistema = 0
}
gmp
{
# Numero de mensajes. No modificar
num_msj = 256
# Numero de buffer. No modificar
num_buf = 256
}
}

supervision
{
puerto_escucha = 1120
}

supervision_recarga
{
to_periodo = 60
}

mysql
{
hay_mysql = 1
host = localhost
usuario = nimitz
clave = phikau3iwCe4O0PP5b09ng==
base_datos = nimitz
}

motor
{
hay_motor = 1
ciclos_campanna_activa = 30
# Directorio donde se almacenan las librerias dinamicas con las estrategias
# Por defecto = '/usr/lib/motorSal/estrategias'
dir_estrategias = /usr/lib/motorSal/estrategias
}

motor_recarga
{
# Periodo de ejecucion del ciclo del motor
to_ciclo = 10
}

muestreo
{
hay_muestreo = 1
}

Los campos del fichero de configuración son los siguientes:

{| class="wikitable"
|-
!Campo !!Descripción !!Posibles valores (si aplica)
|-
|soy_demonio||Si corro como demonio o como proceso||1 demonio – 0 proceso
|-
|hay_syslog||Si hay servidor de syslog||1 lo hay – 0 no lo hay
|-
|archivo_pid||# Archivo con identificador de proceso: (-: /var/run/motorSal.pid)||
|-
|archivo_traza||# Archivo_traza: (-: stdout o /var/log/motorSal.log si soy_demonio)||
|-
|nivel_traza||# Nivel_traza: (0: alarma, 1: aviso, 2: info, 3: depuAlto o 4: depuBajo)||
|-
|pruebas||||
|-
|hay_flush_traza||||
|-
|traza_milisegundos||||
|-
|subsistema||# No se usa. No modificar||
|-
|num_msj||# Numero de mensajes. No modificar||
|-
|num_buf ||# Numero de buffer. No modificar||
|-
|puerto_escucha||Puerto de supervisión del demonio||
|-
|to_periodo||Timeout para reconectar||
|-
|hay_mysql||Hay mysql||1 hay -0 no hay
|-
|host||IP o HOST máquina base de datos de tiempo real||
|-
|usuario||Usuario acceso Base de datos de tiempo real||
|-
|clave||Clave usuario acceso base de datos de tiempo real||
|-
|base_datos||Nombre de la base de datos||
|-
|hay_motor||Si hay campañas saliente o no||1 hay motor saliente – 0 no hay motor saliente
|-
|ciclos_campanna_activa||||
|-
|dir_estrategias ||# Directorio donde se almacenan las librerias dinámicas con las estrategias||
|-
|to_ciclo||# Periodo de ejecución del ciclo del motor||
|-
|hay_muestreo||||1 hay muestreo – 0 no hay muestreo
|-
|}

* Respecto a los logs del motorSal consultar el siguiente apartado: [[Trazas motorSal]]. Los logs pueden verse en la ruta '''/var/log/motorSal.log'''

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== MyACDSuperv ====
Refleja el estado de las colas de asterisk en la base de datos; tiene sentido a efectos de estadísticas e informes, pero no a efectos de funcionamiento de la conmutación de voz.

Es el responsable de mostrar información en las ventanes de tiempo real del supervisor.

Es también el proceso que genera las llamadas en el marcador automático de '''''VIVA'''''it Suite.

A efectos de diagnósticos, desde un SSH se ejecuta el comando “nc ip_maquina 1112”.

'''root@vivait-acd:~# nc localhost 1112'''
myAcdSuperv SIS ver='04.6' inic='20140416 081613' alarmas=6 ultAlar='20140416 121652'
myAcdSuperv AMI cnx=1 ocup=28% exten=2/2/511 asig=0/11/4095
myAcdSuperv MYSQL cnx=1 ms=316

Donde cada parámetro monitorizado indica:
{| class="wikitable"
|-
!Parámetro!!Descripción
|-
|SIS/ver||Versión del proceso
|-
|SIS/inic||Fecha de de arranque del proceso
|-
|SIS/alarmas||Alarmas desde arranque
|-
|SIS/ultAlar||Fecha de última alarma
|-
|AMI/cnx||Conectado (1) a asterisk
|-
|AMI/ocup||Porcentaje de ocupación de MyACDSuperv
|-
|AMI/exten||Extensiones/Extensiones/Extensiones monitorizadas|-
|-
|AMI/asig||
|-
|MYSQL/cnx||Conectado (1) a MySQL
|-
|MYSQL/ms||Tiempo de última operación en ejecutarse
|-
|}

Como complemento a los diagnósticos:

* Podremos examinar el fichero de configuración del proceso en '''/etc/MDtel/myAcdSuperv.cnf'''
* Podremos examinar los logs del proceso en '''/var/log/myAcdSuperv.log'''

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== Proceso escoba ====
El proceso escoba se encarga de resolver y consolidar todos aquellos segmentos de grabación que han quedado almacenados en los gateways por falta de información o incoherencias. Existen dos tipos de procesos escobas:
# Proceso escoba perteneciente a nodo con agente de grabación (recordNodo) llamado '''''escobaGW.pl'''''.
# Proceso escoba perteneciente o no a un servidor de grabación (recordCentral) llamado '''''escobaGrabsBd.pl'''''.

===== escobaGW.pl =====
Proceso que se ejecuta en los nodos busca en el disco RAM , las grabaciones de segmentos cuya antigüedad sea superior a mas de un día, es decir, si el proceso por ejemplo se ejecuta a la 01:00 a.m. del día 24/03/2016 buscara todas aquellas grabacionesn de segmentos realizadas antes de la 01:00 a.m del día 22/03/2016.
Una vez realizada la busqueda, obtendra el UCID a traves del nombre del fichero, y comprobara su correspondencia con la tabla DAT_LLAMADAS. Si existe una llamada con ese UCID, cambiara el estado de la llamada para que sea procesada correctamente. En caso contrario, es movida a la carpeta ''/var/lib/recordNodo/grabError''.

===== escobaGrabsBd.pl =====
Se ejecuta sobre la base de datos de histórico, normalmente se ejecuta en un servidor de grabación (recordCentral). El proceso hace una búsqueda en dos tablas:
* En DAT_SEGMENTOS obtiene todos aquellos segmentos con grabaciones que dieron error, su estado tendrá valor 120.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]
* En DAT_LLAMADAS obtendremos todos los registros correspondiente al segmentos anteriores.
Después hace una búsqueda en el sistema, usando como ruta el campo D_HORA_INICIO de cada llamada, que indica la ruta entera donde se encuentra el archivo. Una vez encontrado el archivo cambia el estado del segmento que tenia un error a estado de grabación disponible , que tendrá valor 100. Si no encontramos el segmento, no realizara nada.

==== recordCentral ====
Se considera como un servidor de grabaciones. Todas las grabaciones de llamadas son un activo importante y una empresa con Contact Center pueda recibir millones de llamadas que necesitan estar registradas y almacenadas en discos duros con gran capacidad, las máquinas donde suelen alojarse estos servidores poseen discos duros limitados, lo que hace necesario en algunos casos incorporar ''dispositivos NAS''.

Los ''dispositivos NAS'' son dispositivos de almacenamiento conectados a una red que permite el almacenamiento y la recuperación de datos desde una ubicación centralizada, flexibles y escalables, lo que significa que a medida que necesite almacenamiento adicional, puede añadirlo al que tiene. Esto no significa que sea necesario tener ''dispositivos NAS'' para funcionar, sino que puede tomar datos de diferentes sitios.

En '''recordCentral''' pueden existir tres tipos de dispositivos NAS:
* Uno dedicado para las llamadas
* Uno dedicado para los segmentos
* Uno mixto para todas las llamadas y segmentos.

El '''recordCentral''' se encarga de recoger todas las grabaciones de segmentos que tienen de estado proceso(3) en cada nodo gestionado, es decir, coger aquellos segmentos de llamadas marcados como llamadas disponibles, intenta descargar los segmentos de las llamadas y convertirlas al formato adecuado (MP3).
Como una característica particular cada diez minutos, siempre que no tenga ninguna otra tarea, intenta ver si puede establecer conexión con un nodo en cuarentena, para sacarlos de cuarentena y recoger todas las grabaciones de segmentos disponibles, para intentar convertir y descargar todas las grabaciones.

A efectos de diagnósticos, desde un SSH se ejecuta el comando '''''nc ip_maquina 1114''''' en la maquina donde creamos que debe estar ejecutando el proceso recordCentral. Ejemplo:
'''root@smadavacdrecord1:~# nc localhost 1114'''
recordCentral SIS ver='01.2' inic='20140423 094058' alarmas=11041 ultAlar='20140423 160112'
recordCentral MYSQL cnx=1
recordCentral NAS llamadas=1 segmentos=1
recordCentral REC llamNum=24901 llamErr=0 segmNum=38906 segmErr=0 retraso=305
recordCentral NODO fase=0 cuarentena='' descarga='8,6,4,7,10,9' gestion='4,6,7,8,9,10'
La explicación de los campos se muestra en la tabla siguiente:

{| class="wikitable"
|-
! Parámetro !! Descripción
|-
| SIS/ver || Versión del proceso
|-
| SIS/inic || Fecha de arranque del proceso
|-
| SIS/alarmas || Alarmas desde arranque
|-
| SIS/ultAlar || Fecha de última alarma
|-
| MYSQL/cnx || Conectado (1) a MySQL
|-
| NAS/llamadas || Alojamiento en NAS de llamadas activo (grabación de llamada completa en un único archivo)
|-
| NAS/segmentos || Alojamiento en NAS de segmentos activo
|-
| REC/llamNum || Llamadas procesadas
|-
| REC/llamErr || Llamadas con error
|-
| REC/segmNum || Segmentos procesados
|-
| REC/segmErr || Segmentos con error
|-
| NODO/fase || Número de proceso de recordCentral
|-
| NODO/cuarentena || Lista de nodos en cuarentena, separada por comas
|-
| NODO/descarga || Lista de nodos en descarga, separada por comas
|-
| NODO/gestion || Lista de nodos gestionados, separada por comas (cuarentena + descarga = gestión)
|}

Como complemento a los diagnósticos:
* Podremos examinar el fichero de configuración del proceso en '''/etc/MDtel/recordCentral.pconf'''

El fichero es el siguiente:

#
# Configuracion de recordCentral.pl
#
# 0: Solo alarmas en archivo log - 1: alarmas y trazas
$depurar = 1;

# 0: Arranca como proceso - 1: arranca como demonio
$soyDemonio = 1;

# Archivo de log ('': salida estandar)
$logArch = '/var/log/record/recordCentral.log';

# Archivo para el pid (eliminando el .pid final)
$pidArch = '/var/run/record/recordCentral';

# 0: El programa se ejecuta indefinidamente - 1: solo una vez (util en depuracion)
$unaVezSolo = 0;

# Tiempo de espera en segundos cuando no hay conexion o cuando no hay llamadas
$toBucle = 10;

# Bytes por segundo en archivos de grabaciones
$bytesPorSegundo = 16000;

# Bytes a leer en cada accceso a disco
$bytesLeerBuf = 1048576;

# Conexion de base de datos
$db='nimitz';
$dbHost = 'BDTR';
$dbPort = '3306';
$dbUsuario = 'nimitz';
$dbClave = 'ivivanimitz';

# Configuracion de la supervision
$supPort = '1114';

# Configuracion de archivos con grabaciones (Orig en nodo)
$grabHay = 0;
$grabAudioCalidad = 32;
$grabAudioFormato = 'mp3';
$grabAudioExten = 'mp3';
$grabAudioCifrado = 0;
$grabRutaUsaTimestamp = 1;
$grabRutaOrig = '/var/lib/recordNodo/grabaciones';
$grabRutaTmp = '/var/lib/recordProcesad/grabTmp';
$grabRutaDest = '/var/lib/recordProcesad/grabRecord';
$grabRutaError = '/var/lib/recordProcesad/grabError';
$segmHay = 1;
$segmUmbralTiempo = 10;
$segmMargenTiempo = 5;
$segmAudioCalidad = 32;
$segmAudioFormato = 'mp3';
$segmAudioExten = 'mp3';
$segmAudioCifrado = 0;
$segmRutaUsaTimestamp = 1;
$segmRutaTmp = '/var/lib/recordProcesad/segmTmp';
$segmRutaDest = '/var/lib/recordProcesad/segmRecord';
$segmRutaError = '/var/lib/recordProcesad/segmError';

# Seleccion de tipos de segmento a grabar separados por comas ('' = todos)
$tiposSegmentoGrabar = '';

# Indica si se graba ring
$grabarRing = 0;

# Minino numero de segundos para generar segmento externo
$segmExternoMinSegs = 10;

*Los campos del fichero de configuración son los siguientes:

{| class="wikitable"
|-
!Campo !!Descripción !!Posibles valores (si aplica)
|-
|recordCentral.pconf|| ||
|-
|Variable a modificar||Comentarios||
|-
|$depurar||# 0: Solo alarmas en archivo log - 1: alarmas y trazas||
|-
|$soyDemonio||# 0: Arranca como proceso - 1: arranca como demonio||
|-
|$logArch =||# Archivo de log ('': salida estandar)||
|-
|$pidArch||# Archivo para el pid (eliminando el .pid final)||
|-
|$unaVezSolo||# 0: El programa se ejecuta indefinidamente - 1: solo una vez (util en depuracion)||
|-
|$toBucle||# Tiempo de espera en segundos cuando no hay conexion o cuando no hay llamadas||
|-
|$bytesPorSegundo||# Bytes por segundo en archivos de grabaciones||
|-
|$bytesLeerBuf||# Bytes a leer en cada accceso a disco||
|-
|$db||Nombre de la base de datos||
|-
|$dbHost||IP o HOST máquina base de datos de tiempo real||
|-
|$dbPort||Puerto de escucha de mysql||
|-
|$dbUsuario||Usuario acceso Base de datos de tiempo real||
|-
|$dbClave||Clave usuario acceso base de datos de tiempo real||
|-
|$supPort ||Puerto de supervision del demonio||
|-
|$grabHay||Hay fase de enrutamiento o no||
|-
|$grabAudioCalidad||Calidad del audio ||
|-
|$grabAudioFormato||Formato del archivo de grabacion||
|-
|$grabAudioExten||Extensión del archivo de grabacion||
|-
|$grabAudioCifrado||Si el archivo de grabación va cifrado ||
|-
|$grabRutaUsaTimestamp||||
|-
|$grabRutaOrig||# Directorio donde se localizan las grabaciones de llamadas||
|-
|$grabRutaTmp||Directorio temporal de las grabaciones de llamadas||
|-
|$grabRutaDest||# Directorio Destino de las grabaciones de llamadas||
|-
|$grabRutaError||# Directorio de las grabaciones de llamadas con error||
|-
|$segmHay||Hay segmentos||1 hay segmentos – 0 no hay
|-
|$segmUmbralTiempo||||
|-
|$segmMargenTiempo||Tiempo que se coge antes y despues del segmento||
|-
|$segmAudioCalidad||Calidad del audio ||
|-
|$segmAudioFormato||Formato del archivo de grabacion||
|-
|$segmAudioExten||Extensión del archivo de grabación||
|-
|$segmAudioCifrado||Si el archivo de grabación va cifrado ||1 se cifra – 0 no se cifra
|-
|$segmRutaUsaTimestamp||||
|-
|$segmRutaTmp ||Ruta temporal||
|-
|$segmRutaDest = ||Ruta donde se almacenan los archivos de grabación||
|-
|$segmRutaError||Ruta de los archivos de grabación con error||
|-
|$tiposSegmentoGrabar||# Selección de tipos de segmento a grabar separados por comas ('' = todos)||
|-
|$grabarRing||# Indica si se graba ring||1 se graba – 0 no se graba
|-
|$segmExternoMinSegs||# Mínino número de segundos para generar segmento externo||
|-
|}



* Podremos examinar los logs del proceso en '''/var/log/recordCentral.log'''


[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== recordNodo ====
Se considera como proceso con función de agente de grabación para un nodo. Solo debe existir uno por maquina o por nodo (configurado como grabador) en el '''portal de administración de ''VIVA''it'''.

Para su funcionamiento utiliza un ''disco RAM'' por que su tiempo de acceso mejora drásticamente, debido a que la memoria RAM es varios órdenes de magnitud más rápida que las unidades de disco reales, haciendo que la velocidad de procesamiento de las grabaciones sea mucho mas rápida.

Este ''disco RAM'' normalmente ocupa la mitad de la memoria RAM de una maquina pero no es obligatorio pues dependerá de la memoria disponible en cada maquina, y además, se configura con un tamaño no superior a 2GB de memoria RAM. Hay que tener especial cuidado en que no se llene en espacio ni tampoco los i-nodos. Se puede monitorizar a través de la aplicación '''zabbix'''.

El '''''recordNodo''''' se encarga de recoger todas las grabaciones de segmentos que tienen de estado ''proceso(2)'', es decir, aquellos segmentos de llamadas que han sido grabadas pero no están siendo procesadas, moviéndolas del ''disco RAM'' a su carpeta correspondiente.

La forma de obtener la carpeta correspondiente es obteniendo el dato del campo D_HORA_INICIO en la tabla DAT_LLAMADAS para cada segmento,tras un tratamiento del campo creara la subruta correspondientes: /año/mes/dia/hora/min. Entonces, la ruta correcta seria /var/lib/recordNodo/grabaciones/año/mes/dia/hora/min, donde año, mes, dia , hora y min son los valores numéricos obtenidos del campo D_HORA_INICIO.

A efectos de diagnósticos, desde un SSH se ejecuta el comando '''''nc ip_maquina 1113''''' en la maquina donde creamos que debe estar ejecutando el proceso recordNodo:

root@smadavgw5:~#nc localhost 1113
recordNodo SIS ver='04.00.00' inic='20160326 105137' alarmas=2 ultAlar='20160326 105542'
recordNodo MYSQL cnx=1
recordNodo REC grabNum=0 grabErr=0

La explicación de los campos se muestra en la tabla siguiente:
{| class="wikitable"
|-
! Parámetro !! Descripción
|-
| SIS/ver || Versión del proceso
|-
| SIS/inic || Fecha de arranque del proceso
|-
| SIS/amarmas || Alarmas desde arranque
|-
| SIS/ultAlar || Fecha de última alarma
|-
| MYSQL/cnx || Conectado (1) a MySQL
|-
| REC/llamNum || Llamadas procesadas
|-
| REC/llamErr || Llamadas con error
|-
| REC/segmNum || Segmentos procesados
|-
| REC/segmErr || Segmentos con error
|}

Como complemento a los diagnósticos:
* Podremos examinar el fichero de configuración del proceso en '''/etc/MDtel/recordNodo.pconf'''
:Se muestra a continuación el fichero de configuración:

#
# Configuracion de recordNodo.pl
#
# 0: Solo alarmas en archivo log - 1: alarmas y trazas
$depurar = 1;

# 0: Arranca como proceso - 1: arranca como demonio
$soyDemonio = 1;

# Archivo de log ('': salida estandar)
$logArch = '/var/log/record/recordNodo.log';

# Archivo para el pid (eliminando el .pid final)
$pidArch = '/var/run/record/recordNodo';

# 0: El programa se ejecuta indefinidamente - 1: solo una vez (util en depuracion)
$unaVezSolo = 0;

# Tiempo de espera en segundos cuando no hay conexion o cuando no hay llamadas
$toBucle = 5;

# Tiempo de guarda en segundos desde D_HORA_FIN hasta que se procesa llamada
$toProcesar = 30;

# Bytes por segundo en archivos de grabaciones
$bytesPorSegundo = 16000;

# Bytes a leer en cada accceso a disco
$bytesLeerBuf = 1048576;

# Conexion de base de datos
$db='nimitz';
$dbHost = 'BDTR';
$dbPort = '3306';
$dbUsuario = 'nimitz';
$dbClave = 'ivivanimitz';

# Configuracion de la supervision
$supPort = '1113';

# Quien es mi nodo para filtrar grabaciones
$miNodo = 2;

# Directorio donde se localizan las grabaciones
$grabRutaOrig = '/var/spool/asterisk/monitor';
$grabRutaDest = '/var/lib/recordNodo/grabaciones';
$grabRutaError = '/var/lib/recordNodo/grabError';
$grabRutaUsaTimestamp = 1;

# Tiempo en segundos limite a truncar en las grabaciones (0=sin limite)
$grabLimiteSegs = 0;

# Indica si se procesan segmentos de tipo tipoSegmEliminarGrabacion y patron eliminacion
$segmEliminarGrabacionTrato = 1;
$patronEliminarGrabacion = '/etc/MDtel/null.bin';

*A continuación se indican los campos del fichero:

{| class="wikitable"
|-
!Campo !!Descripción !!Posibles valores (si aplica)
|-
|$depurar||# 0: Solo alarmas en archivo log - 1: alarmas y trazas||
|-
|$soyDemonio||# 0: Arranca como proceso - 1: arranca como demonio||
|-
|$logArch||# Archivo de log ('': salida estandar)||
|-
|$pidArch||# Archivo para el pid (eliminando el .pid final)||
|-
|$unaVezSolo||# 0: El programa se ejecuta indefinidamente - 1: solo una vez (util en depuracion)||
|-
|$toBucle||# Tiempo de espera en segundos cuando no hay conexion o cuando no hay llamadas||
|-
|$toProcesar||# Tiempo de guarda en segundos desde D_HORA_FIN hasta que se procesa llamada||
|-
|$bytesPorSegundo||# Bytes por segundo en archivos de grabaciones||
|-
|$bytesLeerBuf||# Bytes a leer en cada accceso a disco||
|-
|$db||Nombre de la base de datos||
|-
|$dbHost||IP o HOST máquina base de datos de tiempo real||
|-
|$dbPort||Puerto de escucha de mysql||
|-
|$dbUsuario||Usuario acceso Base de datos de tiempo real||
|-
|$dbClave||Clave usuario acceso base de datos de tiempo real||
|-
|$supPort||Puerto de supervision del demonio||
|-
|$miNodo||# Quien es mi nodo para filtrar grabaciones||
|-
|$grabRutaOrig||# Directorio donde se localizan las grabaciones||
|-
|$grabRutaDest ||Directorio destino de las grabaciones procesadas||
|-
|$grabRutaError||Directorio destino de las grabacionescon error||
|-
|$grabRutaUsaTimestamp||||
|-
|$grabLimiteSegs||# Tiempo en segundos limite a truncar en las grabaciones (0=sin limite)||
|-
|$segmEliminarGrabacionTrato||# Indica si se procesan segmentos de tipo tipoSegmEliminarGrabacion y patron eliminacion||1 se procesa – 0 no se procesa
|-
|$patronEliminarGrabacion||Patron de eliminacion||
|-
|}


* Podremos examinar los logs del proceso en '''/var/log/recordNodo.log'''

==== Vivait-CTI ====
Permite la comunicación entre la aplicación '''''VIVA'''''it Desk de agente y el asterisk, sincronizando; convierte el protocolo “asterisk manager” a CSTA ('''''VIVA'''''it Desk “habla” CSTA).

Es un proceso importante para que el uso de '''''VIVA'''''it Desk, y que los agentes puedan realizar su operativa normal con la entrada y salida de llamadas… si bien el cursado telefónico de llamadas es factible, no disponer de las facilidades de '''''VIVA'''''it Desk y formularios hace el sistema difícilmente manejable

A efectos de diagnósticos, desde un SSH se ejecuta el comando “nc ip_maquina 1111”

'''root@vivait-acd:~# nc localhost 1111'''
vivait-cti sis ver='V01.5' inic='20140414 104312' alarmas=13 ultAlar='20140415 173152'
vivait-cti gmp msj=1018/1024 buf=1023/1024 tarea=97/102
vivait-cti tmp uptime=694748 (8d 0h 59m 8s)
vivait-cti cti numConx=(0/511) numPend=(0/127) numMakeCallPend=0 numCall=(0/2047)
numChan=(0/4095) numAuxStr=(0/511) numMoniColas=(0/511) numMoniDevice=0
numMoniCall=0 numMoniCallAuto=0 numMoniCallByDevice=0 numMoni=(0/511)
auditCallErr=0 auditAuxStrErr=0 auditMsjReqErr=0 araChanID=0 araUniqueID=0 araMoni=0
vivait-cti ami esta=conx resp=652(0) evs=1397(0) descar=556(0) err=16 errConx=16
numAct(0/0/127) auditErrAct=0

Donde cada parámetro monitorizado indica:

{| class="wikitable"
|-
!ver!!Versión del proceso
|-
|sis/inic||Fecha de de arranque del proceso
|-
|Sis/alarmas||Alarmas desde arranque
|-
|Sis/ultAlar||Fecha de última alarma
|-
|Gmp/msj||
|-
|Gmp/buf||
|-
|Gmp/tarea||
|-
|Tmp/uptime||
|-
|Cti/numConx||Número de conexiones actuales / Número de conexiones máximo
|-
|Cti/numPend||
|-
|Cti/numMakeCallPend||Llamadas pendientes de realizar
|-
|Cti/numcall||
|-
|Cti/numChan||
|-
|Cti/numAuxStr||
|-
|Cti/numMoniColas||Número de colas monitorizadas
|-
|Cti/numMoniDevice||
|-
|Cti/numMoniCall||
|-
|Cti/numMoniCallAuto||
|-
|Cti/numMoniCallByDevice||
|-
|Cti/numMoni||
|-
|Cti/auditCallErr||
|-
|Cti/auditAuxStrErr||
|-
|Cti/ auditMsjReqErr||
|-
|Cti/ araChanID||
|-
|Cti/ araUniqueID||
|-
|Cti/ araMoni||
|-
|Ami/esta||Estado de conexión contra manarger de asterisk
|-
|Ami/resp||
|-
|Ami/evs||Número de eventos (último minuto)
|-
||Ami/descar
|-
|Ami/err||Errores
|-
|Ami/errConx||Errores de conexión
|-
|Ami/numAct||
|-
|Ami/auditErrAct||
|-
|}

Como complemento a los diagnósticos:

Podremos examinar el fichero de configuración del proceso en '''/etc/MDtel/vivait-cti.conf'''

*El fichero de configuración, '''vivait-cti.conf''', es el siguiente:

#
# Los nombres no pueden tener numeros
# Si el valor de una cadena contiene espacios, se pondra entre comillas dobles
# Los valores comentados indican valores por defecto

base
{
cfg
{
soy_demonio = 1
hay_syslog = 0
# Archivo con identificador de proceso: (-: /var/run/vivait-cti.pid)
archivo_pid = -
# Archivo_traza: (-: stdout o /var/log/vivait-cti.log si soy_demonio)
# No se usa si se activa hay_syslog
archivo_traza = -
}
cfg_recarga
{
# Nivel_traza: (0: alarma, 1: aviso, 2: info, 3: depuAlto o 4: depuBajo)
nivel_traza = 3
pruebas = 1
hay_flush_traza = 1
}
sis
{
# No se usa. No modificar
subsistema = 0
}
gmp
{
# Numero de mensajes. No modificar
num_msj = 1024
# Numero de buffer. No modificar
num_buf = 1024
}
}

supercolas
{
en_comandos = 0
en_eventos = 0
# archivo_conf = supercolas.conf
}

supervision
{
puerto_escucha = 1111
}

cti
{
hay_cti = 1
# Dimensionamiento de recursos. Uno menos, ya que cero no vale
max_conx = 512
max_call = 2048
max_channel = 4096
max_monitor = 512
max_str_aux = 512
puerto_escucha = 4500
link_id = 1
#
hay_vdn = 1
hay_usuarios = 1
usuarios
{
vivait
{
clave = 3RSMbPlTi61rG5pySx9hhUokz8Fyy3Nql2w8Jairfl8=
ip = 0.0.0.0
msk = 0.0.0.0
}
}
}

cti_recarga
{
makeCall_primero_dentro = 1
makeCall_primero_fuera_agente_descuelga = 1
temporizador_makeCall = 30
fmt_canal_exten = SIP/%s
# contextos para llamadas salientes makeCall y makePredictiveCal
contexto_makeCall_primeroFuera = Cen_MakeCallPrimeroFuera
contexto_makeCall_primeroFueraDentro = Cen_MakeCallPrimeroFueraDentro
contexto_makeCall_primeroDentro = Cen_MakeCallPrimeroDentro
# contextos para llamadas salientes desde myAcdSuperv
contexto_myAcdSuperv_ProgreFuera = Cen_myAcdSuperv_ProgreFuera
contexto_myAcdSuperv_ProgreDentro = Cen_myAcdSuperv_ProgreDentro
contexto_myAcdSuperv_PredicFuera = Cen_myAcdSuperv_PredicFuera
contexto_myAcdSuperv_PredicDentro = Cen_myAcdSuperv_PredicDentro
# contexto para transferencias
contexto_redirect = Cen_Redirect
# expresiones regulares. se evaluan en el orden indicado
expr_esExtenLocal = ^(4)[0-9]{4}$
expr_esExtenInterna = -
expr_esCola = ^(8)[0-9]{4}$
expr_esPuntoDistribucion = ^(9)[0-9]{4}$
expr_esPuntoEnrutamiento = -
expr_esNumPrivateLocal = ^[369][0-9][0-9][0-9][0-9]$
expr_esNumPrivateUnknown = ^[369]
expr_esNumPublicNational = ^0?[69][0-9]{8}$
expr_esNumPublicInternational = ^000[0-9]*
# resto siempre esNumPublicUnknown
#
audit_hay_Call = 1
audit_call_minutContestada = 60
audit_call_minutNoContestada = 5
audit_hay_AuxStr = 1
audit_AuxStr_minut = 2
audit_hay_MsjReq = 1
audit_MsjReq_minut = 2
#
}

ami
{
max_action = 128
ip_asterisk = localhost
puerto_ami = 5038
usuario_ami = vivait
clave_ami = vivactisecret
to_inac = 30
to_audit = 600
audit_max_resp = 3
}

Los siguientes son los campos del fichero de configuración:

{| class="wikitable"
|-
!Campo !!Descripción !!Posibles valores (si aplica)
|-
|soy_demonio||# 0: Arranca como proceso - 1: arranca como demonio||
|-
|hay_syslog||Si hay servidor de syslog||1 lo hay – 0 no lo hay
|-
|archivo_pid||# Archivo con identificador de proceso: (-: /var/run/vivait-cti.pid)||
|-
|archivo_traza||# Archivo_traza: (-: stdout o /var/log/vivait-cti.log si soy_demonio)||
|-
|nivel_traza||# Nivel_traza: (0: alarma, 1: aviso, 2: info, 3: depuAlto o 4: depuBajo)||
|-
|pruebas||||
|-
|hay_flush_traza||||
|-
|subsistema||# No se usa. No modificar||
|-
|num_msj||# Numero de mensajes. No modificar||
|-
|num_buf||# Numero de buffer. No modificar||
|-
|en_comandos||||
|-
|en_eventos||||
|-
|archivo_conf||Archivo configuracion de asterisk para las supercolas||
|-
|puerto_escucha||Puerto de supervision del demonio||
|-
|hay_cti||hay cti||1 hay cti – o no hay
|-
|max_conx||Numero maximo de conexiones||
|-
|max_call||Numero maximo de llamadas||
|-
|max_channel||Numero maximo de canales||
|-
|max_monitor||Numero maximo de grabaciones||
|-
|max_str_aux||||
|-
|puerto_escucha||Puesto escucha del demonio||
|-
|link_id||||
|-
|hay_vdn||Existen vdns||1 existen – o no existen
|-
|hay_usuarios||Existen usuarios||1 existen – o no existen
|-
|clave||Clave usuario cti cifrada||
|-
|ip||Direcion de red de escucha del cti||
|-
|msk||Mascara de red de escucha del cti||
|-
|makeCall_primero_dentro||||
|-
|makeCall_primero_fuera_agente_descuelga||||
|-
|temporizador_makeCall||Tiempo maximo para realizar llamada||
|-
|fmt_canal_exten||||
|-
|contexto_makeCall_primeroFuera||# contextos para llamadas salientes makeCall y makePredictiveCal||
|-
|contexto_makeCall_primeroFueraDentro||# contextos para llamadas salientes makeCall y makePredictiveCal||
|-
|contexto_makeCall_primeroDentro||# contextos para llamadas salientes makeCall y makePredictiveCal||
|-
|contexto_myAcdSuperv_ProgreFuera||# contextos para llamadas salientes desde myAcdSuperv||
|-
|contexto_myAcdSuperv_ProgreDentro||# contextos para llamadas salientes desde myAcdSuperv||
|-
|contexto_myAcdSuperv_PredicFuera||# contextos para llamadas salientes desde myAcdSuperv||
|-
|contexto_myAcdSuperv_PredicDentro||# contextos para llamadas salientes desde myAcdSuperv||
|-
|contexto_redirect||# contexto para transferencias||
|-
|expr_esExtenLocal||# expresiones regulares. Se evaluan en el orden indicado||
|-
|expr_esExtenInterna ||# expresiones regulares. Se evaluan en el orden indicado||
|-
|expr_esCola||# expresiones regulares. Se evaluan en el orden indicado||
|-
|expr_esPuntoDistribucion||# expresiones regulares. Se evaluan en el orden indicado||
|-
|expr_esPuntoEnrutamiento||# expresiones regulares. Se evaluan en el orden indicado||
|-
|expr_esNumPrivateLocal||# expresiones regulares. Se evaluan en el orden indicado||
|-
|expr_esNumPrivateUnknown||# expresiones regulares. Se evaluan en el orden indicado||
|-
|expr_esNumPublicNational||# expresiones regulares. Se evaluan en el orden indicado||
|-
|expr_esNumPublicInternational||# expresiones regulares. Se evaluan en el orden indicado||
|-
|audit_hay_Call||||
|-
|audit_call_minutContestada||||
|-
|audit_call_minutNoContestada||||
|-
|audit_hay_AuxStr||||
|-
|audit_AuxStr_minut||||
|-
|audit_hay_MsjReq||||
|-
|audit_MsjReq_minut||||
|-
|max_action||Numero maximo de acciones en el manager de asterisk||
|-
|ip_asterisk||Ip del asterisk de ACD||
|-
|puerto_ami||Puerto del manager de asterisk ACD||
|-
|usuario_ami||Usuario del manager de asterisk del ACD||
|-
|clave_ami||Clave del manager de asterisk del ACD||
|-
|to_inac||Timeout de inactividad||
|-
|to_audit||||
|-
|audit_max_resp||Tiempo maximo de respuesta||
|-
|}

* Podremos examinar los logs del proceso en '''/var/log/vivait-cti.conf'''

==== Phoneprov-TFTP ====

==== Introducción al aprovisionamiento ====

En cada Centralita Telefónica existente, se puede configurar sus teléfonos IP y asignarles extensiones a cada teléfono. Para hacer un ''aprovisionamiento'' de los teléfonos es necesario que el técnico configure uno a uno manualmente utilizando su interfaz web, esto no es práctico, ya que genera muchos errores y el tiempo de implementación se incrementa drásticamente. Además, es casi imposible la administración cotidiana de los teléfonos IP. Desde '''MD'''tel se utiliza una herramienta que permite que los teléfonos IP soportados y homologados por '''MD'''tel ([[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_3.0#Terminales_telef.C3.B3nicos ver Terminales telefónicos]]) se puedan aprovisionar automáticamente, brindando una fácil implementación y administración cotidiana.

===== ¿Qué es aprovisionar? =====

Aprovisionar un teléfono es el proceso de configuración automático de teléfonos IP para su uso con una Centralita Telefónica de forma remota. Una vez que aprovisione un teléfono, el teléfono automáticamente se configurará correctamente y podrá administrar los teléfonos de forma centralizada y remota, sin tener que iniciar sesión en la interfaz web de cada uno de los teléfonos.

El aprovisionamiento de teléfono facilita enormemente la administración cotidiana de los teléfonos IP. Esto hace que sea fácil de cambiar las contraseñas de extensión,realizar desvíos de llamadas, nombre a mostrar, mensajería y demás configuraciones, ya que puede hacerlo de forma centralizada para todos los teléfonos desde el portal de administración y luego transferir los cambios al teléfono.

===== TFTP =====

'''TFTP''' son las siglas de '''T'''rivial '''F'''ile '''T'''ransfer '''P'''rotocol ''(Protocolo de transferencia de archivos trivial)''.

Es un protocolo de transferencia muy simple semejante a una versión básica de FTP. TFTP a menudo se utiliza para transferir pequeños archivos entre terminales en una red.

Algunos detalles del TFTP:

* Utiliza UDP (puerto 69) como protocolo de transporte (a diferencia de FTP que utiliza los
puertos 20 y 21 TCP).
* No puede listar el contenido de los directorios.
* No existen mecanismos de autenticación o cifrado.
* Se utiliza para leer o escribir archivos de un servidor remoto.
* Soporta tres modos diferentes de transferencia, "netascii", "octet" y "mail”.

===== Funcionamiento del servidor phoneprove-TFTP =====

A continuación se muestra un esquema que facilita el entendimiento del funcionamiento del servidor phoneprove-TFTP:

[[Archivo:Funcionamiento_Servidor.png‎ |center]]

El servidor Phoneprove-TFTP se ''encarga del aprovisionamiento masivo de terminales'', es de gran utilidad porque cualquier cambio en los teléfonos pueden ser realizados a nivel DHCP y todos los teléfonos tomarán la nueva configuración luego de reiniciarlos.

Desde phoneprove-TFTP se generara los archivos necesarios para cada teléfono y que sirven para ser aprovisionados automáticamente.
El servidor phoneprove-TFTP tiene alojados los ficheros de configuración están ordenados según las direcciones MAC de los teléfonos. El teléfono “preguntará” al servidor cual es su fichero de configuración utilizando su dirección MAC. Este a través de su MAC , consulta en la base de datos para ofrecer al terminal los datos de configuración según su plantilla, cual sera su extensión , cual sera el usuario propietario, entre otras cosas.

{|
|-
|
'''Nota:''' En instalaciones grandes habrá más de uno, quizás uno por sede grande; depende de la infraestructura de DHCP.
|}

===== Parámetros necesarios de Aprovisionamiento de Teléfonos =====

'''Notas:''' el aprovisionamiento desarrollado por '''MD'''tel, no emplea un fichero por cada
teléfono, sino que emplea una plantilla por cada modelo de teléfono.
Debe haber una '''configuración previa del servidor DHCP''' es necesario coordinar con el cliente la asignación de direcciones para
los diferentes elementos de la plataforma '''''VIVA'''''it, fundamentalmente para terminales telefónicos; en este caso además será necesario
activar la opción 66 que permitirá definir el servidor TFTP del que los terminales cogerán sus ficheros de aprovisionamiento.
El aprovisionamiento desde el portal de administración solo es posible para aquellos teléfonos IP homologados y probados desde '''MD'''tel
[[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_3.0#Terminales_telef.C3.B3nicos ver Terminales telefónicos]]

Como existen parámetros comunes de todos los teléfonos de la misma marca de fabricante, muchos de los parámetros necesarios para el aprovisionamiento como comentamos se han generado desde MDtel en forma de plantillas, que estarán disponibles en el portal de administración VIVAit [[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Plantillas | ver plantilla del portal de administración VIVAit]].

La configuración de un teléfono SIP es muy sencilla y en no es necesario tener conocimientos avanzados de informática o de telefonía. Cada una de estas plantillas que sirven para aprovisionar un teléfono IP homologado, algunos de los parámetros predeterminados se explicarán a continuación .

====== Parámetros de Aprovisionamiento globales ======

* Configuración de la red y MAC.
* Zona horaria.

====== Parámetros de Aprovisionamiento Personales ======

Además de los parámetros de aprovisionamiento globales, el teléfono también obtendrá información de configuración individual, tales como:

*Número de Extensión.
*Nombre y Contraseña de usuario SIP.
*Configuración de Teclas BLF.
*Contraseña de la Interfaz Web del Teléfono IP.
*Idioma de la Pantalla.
*Orden de Preferencia de los Codecs.

===== Aprovisionamiento de teléfonos nivel usuario =====

{|
|-
|
'''Notas:''' La dirección MAC debe estar especificada en letras mayúsculas.
La dirección MAC del teléfono se puede encontrar en la etiqueta adhesiva en la parte inferior del teléfono, o de lo contrario se deberá acceder desde
el menú del propio terminal.
|}

Los pasos a seguir son los siguientes:

'''1)''' Dar de alta el teléfono en el portal de administración, se debe seleccionar el modelo del teléfono, e indicar la dirección MAC del teléfono a aprovisionar, todo ello desde el portal de administración VIVAit.
Para mas información ver [[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Aprovisionamiento del portal de administracion| aprovisionamiento del portal de administración VIVAit]].

'''2)''' En el mismo portal de administración se deberá crear una extensión , asignar a la extensión el teléfono que se quiera aprovisionar, elegir la plantilla adecuada del teléfono y el usuario propietario (solo si sera un puesto fijo) desde [[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Extensiones | extensiones del portal de administración]].

'''3)''' Conectar el teléfono a la red LAN informática (conectarlo al router o switch) para que tenga acceso a Internet:

:*El teléfono enviará un mensaje de multidifusión a través de la LAN.
:*Este será captado por la Central Telefónica siempre que esté en la misma LAN.
:*Al teléfono se le enviará una URL de aprovisionamiento.

'''4)''' Como la mayoría de teléfonos IP del mercado al arrancar una vez sabiendo la URL de aprovisionamiento piden una serie de archivos de configuración para aprovisionarse vía TFTP. EL servidor phoneprove-TFTP, detectara la petición y a través de la MAC y datos del usuario, consultará en la base de datos los datos necesarios para aprovisionar al teléfono y si todo funciona correctamente mandara al teléfono IP los datos de configuración necesarios para funcionar.

'''5)''' Asegúrese de que el teléfono encuentren el servidor TFTP, para ello esperar un tiempo adecuado para que termine el aprovisionamiento.

'''6)''' Finalmente aparecerá como registrado en la centralita, obtendrá una dirección IP y podra funcionar según la configuración establecida.

{|
|-
|
'''Nota''': Si no se reaprovisiona tras un periodo largo de tiempo, desenchufe el cable de alimentación eléctrica o el cable Ethernet (si se utiliza la alimentación en línea PoE) para reiniciar los teléfonos.
|}

===== Aprovisionamiento de teléfonos nivel técnico =====

====== Plantilla de configuración ======

La plantilla de configuración empleadas en el apartado [[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Plantillas | plantilla del portal de administración VIVAit]] de cada modelo está formada por una serie de variables.

Los valores se obtienen de la tabla de la base de datos CEN_TELEFONOS, CEN_USUARIOS, ACD_EXTENSIONES, ACD_NODOS, COM_NODOS... correspondientes a la extensión del teléfono, usuario, nodo, etc.

variable ${NODO1_C_NOMBRE}='corp-ast13'
variable ${EXTEN_C_CLAVE_REGISTRO}='Tel21002'
variable ${USU_C_CODIGO_POSTAL}=''28034'
variable ${SEDE_C_CODIGO_POSTAL}='28034'
variable ${USU_C_NOMBRE}='Juan Antonio'
variable ${USU_C_APELLIDO2}='Ramirez'
variable ${SEDE_C_NOMBRE}='RED_LAB'
variable ${NODO2_C_NOMBRE}= NULL
variable ${EXTEN_C_NOMBRE}='' 21002
variable ${USU_C_LOCALIDAD}=''
variable ${USU_C_NOMBRE_MOSTRAR}='Juan'
variable ${NODO1_C_IP}='175.25.129.70'
variable ${MODEL_C_PREFIJO_PLANTILLA_MAC}='T28P'
variable ${SEDE_C_LOCALIDAD}='Madrid'
variable ${USU_C_APELLIDO1}='Casas'
variable ${NODO2_C_IP}= NULL
variable ${TF_ID_EXTENSION}='5'
cargando campos idExten=5

====== Ficheros y paquetes necesarios ======

'''Paquetes previos:''' libnet-tftpd-perl, tftp-hpa, libnet-address-ip-local-perl
'''Usuario de funcionamiento:''' root

{|
|-
|
'''Nota:''' los archivos y directorios que generemos podrian necesitar que se permitiera el acceso al archivo de lectura y escritura en el servidor TFTP.
|}

'''Archivos necesarios:'''

/usr/local/sbin/phoneprov-tftp.pl
/usr/local/sbin/phoneprov-tftp.pm
/etc/MDtel/phoneprov-tftp.pconf
/etc/init/phoneprov-tftp.conf
/etc/logrotate.d/phoneprov-tftp

'''Directorios a crear:'''

/var/lib/phoneprov-tftp/plt
/var/lib/phoneprov-tftp/bin

*El archivo de configuración, '''phoneprov-tftp''', es el siguiente:

#
# Configuracion de phoneprov-tftp.pl
#
# 0: Solo alarmas en archivo log - 1: alarmas y trazas
$depurar = 1;

# 0: Arranca como proceso - 1: arranca como demonio
$soyDemonio = 1;

# Archivo de log ('': salida estandar)
$logArch = '/var/log/phoneprov-tftp.log';

# Archivo para el pid
$pidArch = '/var/run/phoneprov-tftp';

# 0: El programa se ejecuta indefinidamente - 1: solo una vez (util en depuracion)
$unaVezSolo = 0;

# Conexion de base de datos
$db='nimitz';
$dbHost = 'BDTR';
$dbPort = 3306;
$dbUsuario = 'nimitz';
$dbClave = 'ivivanimitz';

# Configuracion de la supervision
$supPort = 1123;

# Configuracion de servidor TFTP
#
# Los archivos estaticos no tienen variables. Se sirven sin modificar.
# Estan en el arbol de directorios a partir del indicado por '$dirEstatico'
#
# Los archivos dinamicos soportan sustitucion de varibles.
# Las plantillas con variables a sustituir estan en el arbol de directorios
# a partir del indicado por '$dirPlantilla'.
# Los archivos temporales con variables sustituidas estan en el arbol
# de directorios a partir del indicado por '$dirDinamico'.
# Los archivos dinamicos se identifican porque contienen una mac.
# Tambien se identifican en base a las lineas que comienzan con '@'.
# En este ultimo caso, no se refieren a un telefono y puede tener pocas vars.
#
$miDir = '';
$bindDir = '';
$bindPuerto = 69;
$dirPlantilla = '/var/lib/phoneprov-tftp/plt';
$dirEstatico = '/var/lib/phoneprov-tftp/bin';
$dirDinamico = '/tmp';
$toRRQ = 10;
$toACK = 5;
$errACK = 3;
$tamBlq = 512;

# Valores de E_TIPO_CAMPO en tabla COM_CAMPOS que enganchan ID_TABLA con CEN_EXTENSIONES
$clasesCamposExtension = '50';
# Valores de E_TIPO_CAMPO en tabla COM_CAMPOS que enganchan ID_TABLA con CEN_USUARIOS
$clasesCamposUsuario = '70';

# Expresiones regulares de archivos con mac estaticos (separados por '>')
$nomArchMacEstaticos = '^SEP.*\.tlv$>^SEP.*\.bin$>^SP.*\.xml$';

# Traducciones previas de nombres de archivo estaticos
#%archivo = 'trad';

# Traducciones previas de nombres de archivo dinamicos sin mac
@y000000000044.cfg = 'Yealink-T23G-comun.cfg';
@y000000000034.cfg = 'Yealink-T21P-comun.cfg';
@y000000000000.cfg = 'Yealink-T28P-comun.cfg';
@y000000000004.cfg = 'Yealink-T26P-comun.cfg';
@y000000000036.cfg = 'Yealink-T41P-comun.cfg';
@y000000000058.cfg = 'Yealink-T58V-comun.cfg';
@y000000000069.cfg = 'Yealink-T27G-comun.cfg';
@snom710.htm = 'Snom-710-comun.cfg';
@snom710-firmware.xml = 'Snom-710-firmware.xml';
@spa514G.cfg = 'cisco-spa514G.cfg';
@spa512G.cfg = 'cisco-spa512G.cfg';

*Los campos del fuchero de configuración y su significado se muestran en la su¡iguiente tabla:

{| class="wikitable"
|-
!Campo !!Descripción !!Posibles valores (si aplica)
|-
|$depurar||# 0: Solo alarmas en archivo log - 1: alarmas y trazas||
|-
|$soyDemonio||# 0: Arranca como proceso - 1: arranca como demonio||
|-
|$logArch =||# Archivo de log ('': salida estandar)||
|-
|$pidArch||# Archivo para el pid||
|-
|$unaVezSolo||# 0: El programa se ejecuta indefinidamente - 1: solo una vez (util en depuracion)||
|-
|$db||Nombre de la base de datos||
|-
|$dbHost||IP o HOST máquina base de datos de tiempo real||
|-
|$dbPort||Puerto de escucha de mysql||
|-
|$dbUsuario||Usuario acceso Base de datos de tiempo real||
|-
|$dbClave||Clave usuario acceso base de datos de tiempo real||
|-
|$supPort ||Puerto de supervisión del demonio||
|-
|$miDir ||||
|-
|$bindDir||bindAddres||
|-
|$bindPuerto||Puerto de escucha del demonio||
|-
|$dirPlantilla||Directorio de las plantillas de aprovisionamiento||
|-
|$dirEstatico||Directorio archivos estáticos||
|-
|$dirDinamico||# Los archivos temporales con variables sustituidas están en el árbol de directorios a partir del indicado por '$dirDinamico'.||
|-
|$toRRQ ||||
|-
|$toACK||Timeout ACK||
|-
|$errACK||Número de errores de ACK||
|-
|$tamBlq||Tamaño del bloque de archivos a transferir||
|-
|$clasesCamposExtension||# Valores de E_TIPO_CAMPO en tabla COM_CAMPOS que enganchan ID_TABLA con CEN_EXTENSIONES ||
|-
|$clasesCamposUsuario||# Valores de E_TIPO_CAMPO en tabla COM_CAMPOS que enganchan ID_TABLA con CEN_USUARIOS ||
|-
|$nomArchMacEstaticos||# Expresiones regulares de archivos con mac estaticos (separados por '>')||
|-
|%archivo||# Traducciones previas de nombres de archivo estaticos||
|-
|@y000000000044.cfg||# Traducciones previas de nombres de archivo dinámicos sin mac||
|-
|@y000000000034.cfg||# Traducciones previas de nombres de archivo dinámicos sin mac||
|-
|@y000000000000.cfg||# Traducciones previas de nombres de archivo dinámicos sin mac||
|-
|@y000000000004.cfg||# Traducciones previas de nombres de archivo dinámicos sin mac||
|-
|@y000000000036.cfg||# Traducciones previas de nombres de archivo dinámicos sin mac||
|-
|@y000000000058.cfg||# Traducciones previas de nombres de archivo dinámicos sin mac||
|-
|@y000000000069.cfg||# Traducciones previas de nombres de archivo dinámicos sin mac||
|-
|@snom710.htm||# Traducciones previas de nombres de archivo dinámicos sin mac||
|-
|@snom710-firmware.xml||# Traducciones previas de nombres de archivo dinámicos sin mac||
|-
|@spa514G.cfg ||# Traducciones previas de nombres de archivo dinámicos sin mac||
|-
|@spa512G.cfg ||# Traducciones previas de nombres de archivo dinámicos sin mac||
|-
|}

==== Watchdog ====

Se trata de una aplicación del asterisk que monitoriza el SIP y en caso de fallo, pasado un cierto tiempo, reinicia el asterisk y genera un core.
Si escribimos en CLI de asterisk perro tenemos los siguientes comandos:

{| class="wikitable" border="0" style="background:#ffffff" align="top"
|-
|Activar||Activar el Watchdog
|-
|Desactivar||Desactiva el Watchdog
|-
|Parada IWantToStop||Reinicia el asterisk y genera un core para pruebas
|-
|Reload||Realiza una recarga del Watchdog y aplica cambios en su configuración
|-
|Show||Ver el estado del Watchdog

perro avisado=0 activo=1 segsDormir=1 segsInic=60 segsGuarda=30 maxErr=3
perro nombre=sip_monitor_udp lwp=[15437] segsInic=60 segsGuarda=30 hace=11 err=0/5
|-
|}

El dato "hace" informa de cuanto tiempo ha transcurrido desde el último tick. Facilita la calibración del parámetro de configuración "segs_guarda", normalmente es 30

Tiene un fichero de configuración ubicado en /etc/asterisk/MDcrash.conf

{| class="wikitable" border="0" style="background:#ffffff" align="top"
|-
|Sección [perro]
||activo=yes (Si esta o no activo)
segs_dormir=1 (Un tick por segundo)

segs_inic=60

segs_guarda=30

max_errores=3
|-
|Sección [sip_monitor_udp]
||segs_inic=60

segs_guarda=30 (Cada 30 segundos si no reciba trafico SIP genera core)

max_errores=5 (Número máximo de errores)
|-
|}



==== Proceso de Backup ====
Las plataformas '''''VIVA'''''it Call y '''''VIVA'''''it Suite incluyen un script para realizar un proceso de backup.

Se utilizará el script '''backup.sh''', que se encuentra en el directorio '''etc/MDTel'''.

Se ejecuta automaticamente mediante el uso de un cron

'''texto del cron:'''

SHELL=/bin/sh
PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
# m h dom mon dow user command
0 2 * * * root /etc/MDtel/backup.sh /etc/MDtel/backup.cfg

Para activar el script hay que descomentar la línea
# m h dom mon dow user command

Los directorios de los que se hace copia son:
* DIR=var/lib/asterisk/sounds/Particular
* DIR=var/lib/asterisk/moh
* DIR=etc
* DIR=etc/asterisk
* DIR=etc/cron.d
* DIR=etc/dahdi
* DIR=etc/exim4
* DIR=etc/ha.d
* DIR=etc/logrotate.d
* DIR=etc/MDtel
* DIR=etc/mysql
* DIR=etc/network
* DIR=etc/zabbix
* DIR=usr/local/sbin

Por defecto se realiza un backup cada dos horas en la carpeta '''/var/spool/MDtel/backup'''.

Para cambiar la ruta de destino del backup habrá que modificar el fichero backup.sh, en concreto modificar la variable MDTEL.

El fichero ''' backup.cfg''' que se genera incluye copia de la siguiente información:
* Ficheros de configuración de la aplicación.
* Base de Datos.
* Dialplan.

Se guardarán 10 copias del fichero ''' backup.cfg '''

Los campos disponibles en el fichero son los siguientes:

{| class="wikitable"
|-
!Campo !!Descripción !!Posibles valores (si aplica)
|-
|IP_BD ||IP o HOST máquina base de datos de tiempo real||
|-
|HAY_SMB ||Si hay o no servidor SAMBA||1 si existe servidor SAMBA o 0 si no existe
|-
|HOST_SMB||IP o HOST servidor SAMBA||
|-
|USU_SMB||Usuario acceso servidor SAMBA||
|-
|CLAVE_SMB||Clave usuario acceso servidor SAMBA||
|-
|RUTA_SMB||Ruta donde se guardará el backup en el servidor SAMBA||
|-
|}

Para recuperar una plataforma utilizando el backup, habrá que instalar una máquina nueva y cargar los ficheros de configuración, Base de Datos y Dialplan guardados en el proceso de backup.

===== Información adicional: como funciona un cron =====

La información sobre el fucnionamiento de un cron puede encontrarse en: [http://lasegundapuerta.com/index.php/informatica/linux-y-software-libre/1709-comando-cron-en-linux-ubuntu Información sobre el comando cron]

==== CHAT ====
La información para configurar el CHAT y su funcionamiento puede encontrarse en:

[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#CHAT CHAT]

=== Requerimientos de conectividad ===

El esquema siguiente muestra como ejemplo todos los flujos de información existentes en un entorno típico de <big>'''telefonía corporativa (sin presencia)'''</big> ('''''VIVA'''''it Call)

[[Archivo:Flujos corporativa.png|cebter]]

En el entorno de <big>'''Contact Center'''</big>, encontramos los siguientes flujos <big>'''entre servicios'''</big> (comunicaciones entre servidores, ('''''VIVA'''''it Suite))

[[Archivo:Flujos Contact servicios.png|650px|center]]

y <big>'''entre usuarios y servicios'''</big> los reflejados a continuación:

[[Archivo:Flujos Contact puestos.png|600px|center]]

{| class="wikitable"
|-
!Lado A!!Lado B!!Puertos!!Sentido!!Observ.
|-
|Terminal telefónico||Servidor||TCP 5060||A -> B||Señalización SIP
|-
|Terminal telefónico||Servidor||UDP 5060||A -> B||Señalización SIP
|-
|Terminal telefónico||Servidor||10000 a 20000||A -> B
B -> A
||RTP
|-
|Terminal telefónico||Servidor TFTP||UDP 69||A -> B
B -> A
||Para actualización de terminales por TFTP
|-
|Terminal telefónico||Servidor NTP||UDP 123||A -> B||
|-
|'''''VIVA'''''it Desk||Servidor||TCP 4500||A -> B||Comunicación CTI
|-
|'''''VIVA'''''it Desk||Servidor||TCP 3306||A -> B||Acceso a Mysql Base de datos
|-
|'''''VIVA'''''it Desk||Servidor Syslog||UDP 514||A -> B||Para envio de logs de agente
|-
|'''''VIVA'''''it Supervisor||Servidor||TCP 3306||A -> B||Acceso a Mysql Base de datos
|-
|'''''VIVA'''''it Tracker||Servidor||TCP 3306||A -> B||Acceso a Mysql Base de datos
|-
|'''''VIVA'''''it Tracker||Servidor||TCP 8180||A -> B||
|-
|Actualizador||Servidor||TCP 80||A -> B||Necesario para actualizaciones de versiones de aplicaciones de agente y supervisores
|-
|Portal de administración||Servidor||TCP 8180||A -> B||Acceso al portal de administración '''''VIVA'''''it Suite
|-
|'''''VIVA'''''it Tracker Web||Servidor||TCP 8180||A -> B||
|-
|Monitor||Servidor||TCP 8180||A -> B||Wallboard
|-
|Monitorización||Servidor||TCP 80||A -> B||Acceso a portal monitorización (Zabbix)
|-
|}

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Gateways ===
El concepto de gateway como tal no existe en la plataforma '''''VIVA'''''it; existen nodos de ACD y nodos de corporativa.

A efectos de operación un nodo de corporativa es el que en cualquier caso asumirá las funcionalidades de gateway, y recibirá las conexiones (analógicas, digitales o IP) a sistemas externos o a la RTC

El concepto gateway queda pues suscrito a entornos meramente comerciales

Incluimos no obstante en este apartado los diagnósticos y operaciones básicos de conexiones a sistemas externos o RTC

Para verificar los enlaces establecidos ejecutamos el siguiente comando en el terminal: '''sip show peers'''

Al ejecutar este comando obtenemos la salida:

[[Archivo:Enlace_Exterior.png |center]]

Las columnas ''Host'' y ''Port'' nos muestran las conexiones establecidas y nos informa de un posible problema de conexión.

Sabremos que ''no existe conexión'' cuando la columna Host tiene el valor '''Unspecified''' y en la columna Port aparece un '''0''' , a continuación se muestra un ejemplo:

[[Archivo:Ejemplo_no_conexion.png |center]]



=== Servidor de grabación ===
==== Almacenamiento en la nube ====
Almacenamiento en la nube.
Existe la posibilidad de que tras un determinado periodo de tiempo las grabaciones sean movidas a un almacenamiento externo. De esta operativa se encarga el proceso /usr/local/sbin/mueveGrabaciones.pl que recibe como parámetro la ruta al archivo de configuración. Dicho archivo tiene los siguientes elementos:

*$db: Nombre de la base de datos.
*$dbHost: servidor de MySQL
*$dbPort: Puerto del MySQL.
*$dbUsuario: Usuario de conexión a MySQL.
*$dbClave: Clave del usuario anterior.
*$dirBase: Directorio donde residen las grabaciones
*$diasCaducidad: Dias de antigüedad para mover las grabaciones
*$sftpHost: Servidor SFTP de destino
*$sftpPort: Puerto SFTP.
*$sftpUsuario: Usuario SFTP.
*$sftpClave: Clave del usuario SFTP.
*$simula: Si este campo vale 1, las grabaciones se copian, pero no se borran del directorio original, ni se actualiza su ubicación en la base de datos.

La grabación indica donde se encuentra mediante el campo E_UBICACION_GRABACION, que puede tener los siguientes valores:
*Sin definir (0)
*En línea (10): Las grabaciones se encuentran en el servidor de grabaciones.
*Fuera de línea (20): las grabaciones se encuentran en una ubicación externa.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Reporting ===
La aplicación de reporting en general no tiene procesos habituales de operación y mantenimiento.
Los informes son obtenidos desde la interfaz gráfica o mediante un procedimiento de scripting, descritos en “Formato de fichero de intercambio para '''''VIVA'''''it Reporting”.

==== Formato de fichero de intercambio para '''''VIVA'''''it Reporting ====
{| class="wikitable"
|-
! Nombre !! Descripción !! Ejemplo
|-
| colspan="3"| Selección de registros
|-
| SQL_selec || Expresión SQL que se añadirá al where a la SQL principal. || C_ORIGEN like '6%' and C_COD_CLIENTE= '023'
|-
| SQL_select_leido || Filtro de selección legible
|| Skill igual a 60310
|-
| SQL_orden || Lista de campos por los que se ordenará, después de los que estén ya definidos en la plantilla. || C_ORIGEN, C_COD_CLIENTE
|-
| colspan="3"| Salida
|-
| FIC_extension || Extensión de fichero de salida: PDF, XLSX, CSV || PDF
|-
| FIC_tipo_entrega || 'P': Pantalla, 'D': Directorio, 'C': Correo || D
|-
| FIC_destino || Si 'C', dirección de correo, si 'D', ruta del directorio || D:\informes\
|-
| colspan="3"| Plantilla
|-
| INF_modelo || Ruta del fichero de plantilla || C:\Modelos\llamadas.rep
|-
| INF_descripción || Descripción del informe || Informe detallado de llamadas
|-
| colspan="3"| Base de datos
|-
| BD_ip || IP o nombre de máquina ||
|-
| BD_puerto || Puerto de MySQL ||
|-
| BD_base_datos || Nombre de base de datos ||
|-
| BD_usuario || Usuario de base de datos ||
|-
| BD_clave || Clave de acceso cifrada ||
|-
| colspan="3"| Parámetros
|-
| PAR_desde_vis || Fecha inicial de selección en formato legible (o '-' si no hay) || 01/01/2016
|-
| PAR_hasta_vis || Fecha final de selección en formato legible (o '-' si no hay) || 31/01/2016
|-
| PAR_01 || Parámetro opcional ||
|-
| .. || .. ||
|-
| PAR_20 || Parámetro opcional ||
|}

El fichero tendrá un nombre único para permitir la generación simultánea de informes.
El fichero es borrado por la aplicación de forma automática.
Se pasa a la aplicación de generación de informes como parámetro. Por ejemplo:
“C:\Archivos de Programa\MDtel\Nimitz\LanzaInformes\LanzaInformes.exe”
“C:\Archivos de Programa\MDtel\Nimitz\LanzaInformes\NIM00001.tmp”

Ejemplo de fichero:
{| class="wikitable"
|-
| SQL_selec=(DAT_ACUMULADOS_COLAS.ID_COLA in (11))

SQL_select_leido=Skill igual a 60310

SQL_orden=
FIC_extension=pdf

FIC_tipo_entrega=P

FIC_destino=C:\

INF_modelo=skill_setsi.rep

INF_descripcion=Skill. SETSI

BD_ip=172.25.1.2

BD_puerto=3306

BD_base_datos=nimitz

BD_usuario=nimitz

BD_clave=UIk5jNY9PVX5ogg=

PAR_desde_vis=-

PAR_hasta_vis=-

PAR_01=
|}

==== Resumen de significado de columnas en reporting histórico ====
Esta información se puede consultar en el siguiente enlace:

http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Documentacion_de_usuario_VIVAit_Suite_3.3#Resumen_del_valor_de_las_columnas_que_aparecen_en_los_informes



===== Consideraciones adicionales =====

Los tiempos se insertan en el intervalo en el que se deja ese "estado", esto provoca que en un intervalo pueda ser mayor el tiempo ACD que el tiempo conectado.

''* Ejemplo:''

-Llamada: Duración 15 minutos Hora fin de la llamada 13:01
-Llamada: Duración 20 minutos Hora fin de la llamada 13:24
Suma de las duraciones de las llamadas para el intervalo ''35 minutos'' tiempo
conectado del agente en el intervalo ''30 minutos.''
Cuando los periodos consultados sean mas amplios (diario, mensual) los
desfases tenderán a desaparecer.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

== Otros Diagnósticos y operaciones básicas ==
=== Arranque y apagado de la plataforma ===

En general el arranque y apagado de cada nodo de una plataforma '''''VIVA'''''it es el estándar de un procedimiento ordenado de apagado en una máquina linux: '''"Shutdown -h now"''' o comando de apagado inmediato o programado equivalente

El orden de arranque de la plataforma deberá ser:
# En primer lugar arrancar el nodo con la base de datos de tiempo real
# Una vez finalizado el arranque del punto 1, arrancar el nodo con la base de datos de réplica
# Una vez finalizado el arranque del punto 2, arrancar el resto de nodos en cualquier orden

Al respecto del orden de apagado de nodos, es el siguiente:
# En primer lugar se apagarán, en cualquier orden, los nodos que NO CONTENGAN bases de datos de tiempo real ni bases de datos de réplica
# Una vez apagados totalmente todos los nodos del punto 1, apagaremos el nodo (o nodos) con bases de datos de réplica
# Una vez apagados totalmente todos los nodos del punto 2, se apagará el nodo con la base de datos de tiempo real

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]


=== Grabación ===

==== Configuración de la grabación en la plataforma corporativa ====
Para que una llamada se grabe, lo primero de todo es que alguien tenga la capacidad de grabar. Esto se consigue diciendo al nodo que sea grabador. Esto provoca que el nodo llame al mixmonitor para grabar y se inserte un registro en el DAT_GRABACIONES. Esto no significa que ya las llamadas se vayan a grabar, ya que para eso tiene que ser procesadas por un nodo que sea grabador. Hay tres, llamémosle elementos, que se pueden grabar:

* El nodo, es decir todo lo que el nodo enrute
* Prerutas
* Objetos: que son las extensiones, usuarios, grupos corporativos, etc.

Tenemos tres formas de grabar:

* Grabar con beep periódico
* Grabar sin beep periódico
* Descartar grabación

Si de los tres elementos tenemos que uno grabe, ya sea con o sin beep periódico, esa llamada se va a grabar ya que son OR, en cuanto haya un elemento que diga que grabe se va a grabar.

Al igual pasa si tenemos que un elemento tenga descartar la grabación. La grabación no se inicia.

Referente al campo de Modo de grabación en infraestructura, este no se emplea para la grabación de corporativo, sino que solo tiene validez en ACD. Para grabación en el ACD hay que, como se ha dicho anteriormente poner un nodo que sea grabador y especificar un elemento de los tres que hay cual es el que se va a grabar.

Para que exista una grabación ha de existir un segmento asociado a esta. Los segmentos se tratan en las prerutas. Hay un campo es las prerutas que es Generar segmento al enrutar. Si está se generará el segmento del tipo de la preruta y su correspondiente grabación si esta está configurada. Si le decimos que no genere segmentos al enrutar y el sistema está configurado para que grabe, el recordCentral creará un tipo de segmento llamado externo para esa grabación. Podemos configurar si queremos que se cree o no ese segmento, para eso hay que modificar el fichero de configuración del recordCentral y poner un tiempo muy alto al campo $segmExternoMinSegs. También podemos configurar que segmentos queremos que se graben. Por defecto el recordCentral va configurado para que se graben todos los segmentos. Para decirle que solo grabe cierto tipo de segmentos hay que ponerlos los que queramos que si se graben en la variable $tiposSegmentoGrabar del fichero de configuración del recordCentral.

==== Comprobar que el servidor de grabación está activo ====

Si al ejecutar el comando '''''nc ip_maquina 1114''''',si no se recibe ninguna respuesta, significa el servidor de grabación no estaría activo.
También usando el comando ''''' ps aux | grep recordCentral ''''', donde si no escribe ningún resultado implica que tampoco esta activo.

==== Comprobar que los nodos están conectados al servidor de grabación ====

Debemos fijarnos en la linea de respuesta del comando '''''nc ip_maquina 1114''''', que seria:
{| class="wikitable"
|-
| root@smadavacdrecord1:~# nc localhost 1114
recordCentral SIS ver='01.2' inic='20140423 094058' alarmas=11041 ultAlar='20140423
160112'

recordCentral MYSQL cnx=1

recordCentral NAS llamadas=1 segmentos=1

recordCenral REC llamNum=24901 llamErr=0 segmNum=38906 segmErr=0 retraso=305

'''recordCentral NODO fase=0 cuarentena='' descarga='8,6,4,7,10,9' gestion='4,6,7,8,9,10''''
|}

Sabiendo que el parámetro "fase=0" es el numero que identifica el recordCentral, los demás parámetros nos indicaran los nodos disponibles , que funcionan o no en el servidor. Entonces "gestión=4,6,7,8,9,10" indica el id de los nodos que maneja el proceso.

==== Comprobar que un nodo tiene activo el agente de grabación ====
Si al ejecutar el comando '''''nc ip_maquina 1113''''', no se recibe ninguna respuesta, significa que el nodo no tiene activo el agente de grabación.
También usando el comando ''''' ps aux | grep recordNodo''''', donde si no escribe ningun resultado implica que tampoco esta activo.

==== Comprobar que un nodo está subiendo archivos de grabación al servidor ====
Debemos fijarnos en la linea de respuesta del comando '''''nc ip_maquina 1114''''', que seria:

{| class="wikitable"
|-
| root@smadavacdrecord1:~# nc localhost 1114
recordCentral SIS ver='01.2' inic='20140423 094058' alarmas=11041 ultAlar='20140423
160112'

recordCentral MYSQL cnx=1

recordCentral NAS llamadas=1 segmentos=1

recordCenral REC llamNum=24901 llamErr=0 segmNum=38906 segmErr=0 retraso=305

'''recordCentral NODO fase=0 cuarentena='' descarga='8,6,4,7,10,9' gestion='4,6,7,8,9,10''''
|}

Fijándonos en "descarga=8,6,4,7,10,9" nos confirma que todos los nodos que maneja el proceso funcionan perfectamente y el servidor puede manejar las grabaciones.

==== Comprobación de grabaciones que se hayan quedado enganchadas en un nodo ====
Podemos fijarnos en los dos comandos, para '''''nc ip_maquina 1114''''':
{| class="wikitable"
|-
| root@smadavacdrecord1:~# nc localhost 1114
recordCentral SIS ver='01.2' inic='20140423 094058' alarmas=11041 ultAlar='20140423
160112'

recordCentral MYSQL cnx=1

recordCentral NAS llamadas=1 segmentos=1

recordCenral REC llamNum=24901 llamErr=0 segmNum=38906 segmErr=0 retraso=305

'''recordCentral NODO fase=0 cuarentena='' descarga='8,6,4,7,10,9' gestion='4,6,7,8,9,10''''
|}

Fijándonos en el campo "cuarentena=''" indica que ninguno de los nodos tiene problemas.

==== Comprobación del estado de ocupación del almacenamiento temporal de grabaciones en un nodo. ====

Desde un SSH ejecuta el comando '''''df - h''''' en la maquina donde creamos que debe estar ejecutando el proceso recordNod:

{|class="wikitable"
|-
! Filesystem !! Size !! Used !! Avail !! Use% !! Mounted on
|-
| udev || 486M || 4,0K || 486M || 1,00% || /dev
|-
| tmpfs || 100M || 416K || 99M || 1,00% || /run
|-
| '''/dev/vda1''' ||''' 236M''' ||''' 68M''' ||''' 156M''' ||''' 31,00% '''||''' /boot'''
|-
| tmpfs || 100M || 48K || 100M || 1,00% || /var/spool/asterisk/monitor

|}

Nos fijaríamos en la línea marcada en negrita, el campo "Use%" indicara el porcentaje de almacenamiento temporal de grabaciones en un nodo.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

===Escuchas e intrusiones en asterisk===
'''CallSpy''' es una aplicación elaborada para asterisk que permite a un usuario realizar escuchas e
intrusiones en llamadas.
En realidad tenemos dos aplicaciones en asterisk, CallSpy y CallSpyee.
====CallSpy ====
{|
|-
|
'''Nota:''' Como mucho se pueden tener a dieciséis personas al mismo tiempo usando esta aplicación.
|}

Como hemos mencionado anteriormente, esta aplicación permite la escucha de llamadas y,
opcionalmente, realiza la función de intrusión. Tiene tres opciones de configuración obligatorios
que mostramos a continuación:

{|
|-
|
CallSpy(<tipoEspiado>,<expRegEspiado>,<parametrosConf>)

|}
La opción '''<tipoEspiado>''' se refiere a que tipo de objeto que podemos espiar correspondiente, solo debe elegirse un único tipo:
*'''c:''' escuchar una cola
*'''v:''' escuchar un vdn
*'''a:''' escuchar a un agente
*'''e:''' escuchar extensión
La opción '''<expRegEspiado>''' representa el número de la cola, VDN, agente o extensión que queremos escuchar. Tiene que ser una expresión regular.
La opción '''<parametrosConf>''' se refiera a los parámetros de configuración para la llamada que podemos espiar, se pueden combinar o juntar :
*'''q:''' Desactiva el 'beep' al comienzo de cada nueva llamada.
*'''v([value]):''' Ajusta el volumen en el rango -4 a 4 (más alto, mas volumen).
*'''e:''' Habilita el que se pueda cambiar a otra llamada de la misma extensión.
*'''w:''' Habilita el que se pueda activar la intrusión (whisper).
Una vez iniciada la escucha, solo falta que entre una llamada al objetivo que estemos espiando. Al
iniciar la escucha, se puede hacer lo siguiente:
*Pulsando '''#''' modifica el volumen de escucha.
*Pulsando '''*''' cambia a una nueva llamada.
*Pulsando '''1''' si esta habilitado, cambia a otra llamada de la misma extensión.
*Pulsando '''2''' si esta habilitado, inicia la función de intrusión.
*Pulsando '''3''' desactiva la función de intrusión.
====CallSpyee (espiado)====
Mediante esta aplicación indicamos los parámetros que permite a una llamada ser seleccionada para
escuchar. Las opciones de configuración son:
{|
|-
|
CallSpyee([CID_NUM],[cola],[vdn],[agen],[exten])
'''Nota:'''No son parámetros obligatorios, por lo que no hace falta rellenar todos los campos pero si respetar sus posiciones separadas por comas.
|}
La explicación de los parámetros es la siguiente:
*'''CID_NUM:''' representa el call ID de la llamadas
*'''cola:'''representa el número de la cola que se quiere espiar (${QUEUE} ).
*'''vdn:''' representa el número del VDN que se quiere espiar (${VDN} ).
*'''agen:''' representa el número del agente que se quiere espiar.
*'''exten:''' representa el número de la extensión que se quiere espiar (${EXTENSION}) .

Por ejemplo si queremos escuchar todas las llamadas en las que participa una extensión determinada pondremos en la macro de extensiones:
{|
|-
|
exten => s,n,CallSpyee(,,,${EXTENSION})
|}

====Cambios para el dialplan de asterisk====
El funcionamiento de este tipo de servicio conlleva un cambio en el dialplan de asterisk. En cada macro correspondiente se pondrá los diferentes CallSpyee para VDN, colas , extensiones y agentes.
Pasos a seguir:
*Paso 1. Creación de un código de intrusión para cada tipo según necesidad (cola, VDN, agente y
extensión).
{|
|-
|
Ejemplo '''MD'''tel: declaramos como código de intrusión a Agente *44*NUMERO
;==========================================
;======== Intrusion a Agente
;==========================================
exten => _*44*X.,1,set(CadMarcar=intrusionEspiado)
exten => _*44*X.,n,set(DesL=SERVICIO)
exten => _*44*X.,n,set(datoServicio=^${EXTEN:4})
exten => _*44*X.,n,Goto(finMacro,1)
'''Nota:''' En la tercera línea podemos observar la expresión regular que se le pasara al CallSpy correspondiente con el número marcado por el espia. 
|}

*Paso 2.Llamar a CallSpy con la configuración deseada.
{|
|-
|
Ejemplo '''MD'''tel: llamada a CallSpy especificando que vamos a espiar una cola (la c del primer parámetro, con la
extensión introducida en el código de intrusión y con whisper, es decir, función de intrusión habilitada.
;------------------------------------------------------------------------
; Intrusion a Espiado
;------------------------------------------------------------------------
exten => intrusionEspiado,1,NoOp
exten => intrusionEspiado,n,GotoIf($["${datoServicio}"=""]?colgar)
exten => intrusionEspiado,n,CallSpy(c,${datoServicio},w)
exten => intrusionEspiado,n(colgar),Hangup
|}
* Paso 3. Llamar a CallSpyee con la configuración de las llamadas candidatas a ser escuchadas.
{|
|-
|
Ejemplo '''MD'''tel:
exten => s,n,CallSpyee(,,,,${EXTENSION}) → Para extensiones
exten => s,n,CallSpyee(,${QUEUE},,,) → Llamadas espiadas por cola
exten => s,n,CallSpyee(,,${VDN},,) → Llamadas espiadas por VDN
|}

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Calendarios ===

Para la configuración de los Calendarios se hace uso de '''CalDAV''', estándar de Internet que permite a un cliente acceder a información de planificación en un servidor remoto. Permite que varios clientes accedan a la misma información, facilitando la cooperación. Muchas aplicaciones, tanto clientes como servidores, son compatibles con este protocolo.

Si deseamos crear un calendario en la plataforma '''VIVAit''' podemos hacerlo siguiendo el siguiente enlace:
Para comprobar que el servidor de calendarios funciona correctamente bastaría con cargar en la barra de direcciones la siguiente url: [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Calendarios |Calendarios]]

http://${NODO.HOST}/dav/html/cal.php/calendars/${DAV.CUENTA}/${DAV.CALENDARIO}

donde,

* '''NODO.HOST:''' es la ip del servidor calendar
* '''DAV.CUENTA:''' hace referencia a la cuenta de usuario
* '''DAV.CALENDARIO:''' hace referencia el nombre de la cuenta

Una vez que se carga la url sabremos que el servidor funciona correctamente si visualizamos lo siguiente:

[[Archivo:Captura de pantalla de 2016-07-21 12_43_58.png || 1020px|center]]

Si el sistema nos pide usuario y clave querrá decir que el servidor de calendarios está operativo en esa maquina

Para comprobar que funciona en la consola de asterisk usaremos los comandos
calendar show calendars
calendar show calendar [nombreCalendario]

'''Nota:''' Debido bugs detectados, el proceso requerirá:
- La realización de una sincronización manual de la sección "mdcal" desde el portal de administración
- En la máquina donde esté instalado el servidor de calendarios apuntar a la IP de la BDTR (/var/www/dav/config.php)

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Syslog de agentes ===
'''''Syslog''''' es un estándar para el envío de mensajes de registro en una red informática IP. Por '''''Syslog''''' se conoce tanto al protocolo de red como a la aplicación o biblioteca que envía los mensajes de registro. Se lanza automáticamente al arrancar un sistema Unix, y es el encargado de guardar informes sobre el funcionamiento de la máquina (eventos, seguridad del sistema, etc) pero puede contener también cualquier información como mensajes de las diferentes partes del sistema (núcleo, programas...) y los envía y/o almacena en diferentes localizaciones transmitiéndose mediante un puerto UDP. Esto permite concentrar los registros de múltiples máquinas en un único punto simplificando la labor de gestión al administrador siendo habitual que múltiples dispositivos lo soporten.

El formato del mensaje se compone de tres campos :

* La cabecera contiene la prioridad, fecha y hora del mensaje, máquina, proceso (nombre e identificador) que lo ha generado y la versión del protocolo utilizado.
* Una serie de pares clave-valor con metadatos.
* El texto del mensaje.

Si es necesario podemos activar el registro de todos los eventos telefónicos que realiza un agente ACD llamado '''Syslog de agentes'''. Su activación se realiza mediante el '''portal de administración ''VIVA''it''' configurando unos parámetros para un usuario llamado ''Rastreo BBDD" y ''Rastreo Syslog''. Para más información[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Pesta.C3.B1a_ACD | ver sección Portal de administración - General - Usuarios - Pestaña ACD ]].

{| class="wikitable" border="0" align="top"
|-
| align="center" style="background:Lavender; color:Black" |<big>'''Elemento'''</big>
|align="center" style="background:Lavender; color:Black" | <big>'''Procedimiento'''</big>
|-
!colspan="2" width="60 px" style="background:Lavender; color:Black"|Operacion
|-
|Ubicación del proceso||Script arranque: /etc/init/ rsyslog.conf
Configuración :
/etc/rsyslog.d/30-vivait-
desk.conf
|-
|Arranque||service rsyslog start
|-
|Parada||service rsyslog stop
|-
|Reinicio||service rsyslog reload
|-
!colspan="2" width="60 px" style="background:Lavender; color:Black"|Diagnostico
|-
|Registro de logs||/var/log/MDtel/vivait-desk.log
Fichero del día actual. se guardan los 30
anteriores comprimidos en tar.g
|}

=== Generación de un Core ===
Un Core es la memoria de un programa.

Para generar un Core rápido con Asterisk hay que hacer lo siguiente:

Ejecutar ps aux | grep asterisk y coger el PID del programa
gdb /usr/sbin/asterisk [PID]
gcore [file]

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==Funcionalidades específicas ==
=== Mecanismo de prioridad adaptativa ===

El mecanismo de prioridad adaptativa permite en una plataforma '''''VIVA'''''it Suite establecer prioridades en las que se tenga en cuenta el tiempo de espera de las llamadas en cola, proporcionando una alternativa al mecanismo de prioridad absoluta que existe por defecto

==== Introducción ====

Este documento presenta una propuesta de mecanismo de asignación de llamadas en colas a agentes basado no solo en las prioridades de agente a cola,
sino en un factor de corrección de prioridad derivado del tiempo de espera de una llamada

==== Terminología ====

* '''Prioridad de llamada:''' A cada llamada susceptible de ser atendida en el ''Call Center'' se le asignará una prioridad de llamada; dicha prioridad será asignada cada vez que un agente quede disponible.
* '''Prioridad de grupo ACD:''' Los agentes del ''Call Center'' tendrán configurada una prioridad para cada grupo ACD al que pertenecen
* '''Tiempo de espera:''' Tiempo que una llamada lleva en espera en un determinado grupo ACD; si la llamada cambia de un grupo ACD a otro el tiempo de espera pasa a cero
* '''Objetivo de servicio:''' Tiempo objetivo máximo de espera por cada grupo ACD

'''Nota.-''' ''En terminología Asterisk el aumento de prioridad corresponde con números descendentes, es decir, 
prioridad 50 es mejor que prioridad 70''

==== Mecanismo de asignación de llamadas ====

En el momento en que exista un agente disponible para recibir llamada, el agente recepcionará la llamada con mejor prioridad de llamada (menor número). La prioridad de llamada para cada llamada se establecerá de la siguiente manera:

- Agentes con prioridad de grupo ACD de 1 a 99 utilizarán el mecanismo convencional de asterisk de prioridad absoluta; será útil para grupos ACD críticos o en Call Centers muy convencionales

'''Si un agente tiene prioridad menor de 100 en grupos ACD y hay llamadas en dichos grupos, estas llamadas serán atendidas por el agente con prioridad absoluta.'''

- Agentes con prioridad de colas de 100 en adelante; se utilizará el siguiente mecanismo de prioridad ponderada:

:*Si el grupo ACD de la llamada está dentro del objetivo de servicio, la prioridad de llamada será la prioridad de grupo ACD (a efectos prácticos se aplicará el mecanismo convencional de asignación de llamada a agente, equitativo entre grupos ACD con misma prioridad)

:*Si el grupo ACD de la llamada está fuera del objetivo de servicio, se aplicará una ponderación que mejorará la prioridad de la llamada a medida que aumente el tiempo de espera:

[[Archivo:Formula.png |center]]

En una configuración de igualdad de prioridad de agente y objetivo de servicio, el tiempo de espera influiría de manera determinante (más o menos en
función del peso) en la asignación de la siguiente llamada
El peso podrá adquirir tres posibles valores: 0, 1 y 10

[[Archivo:Esquema.png |center]]

- Calculo prioridad de llamada: se calcula por llamada cada vez que un agente queda libre
- Agente atiende llamada con mejor prioridad de llamada



[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Marcación saliente ===
Dentro del ACD hay un comportamiento especial que es la marcación saliente. Esta puede ser de tres tipos:
* '''Vista previa''': El agente demanda la siguiente llamada a realizar.
* '''Progresivo''': Se llama al agente y se lanza la llamada al contacto.
* '''Predictivo''': El sistema calcula cuando va a estar libre el agente y se adelanta lanzando varias llamadas (configurables por parámetros). La llamada que es contestada primero, se pasa a una cola (el resto se cuelgan) a la espera que el agente se quede libre.

====Esquema de funcionamiento====
[[Archivo:esquema funcionamiento marcador.jpg|center|500px]]

Los contactos se agrupan en listas para su facilidad de asignación a campañas, aunque finalmente lo que se asigna a una campaña es un contacto.

Las campañas tienen estrategias. Las estrategias definen como se ha de llamar (del primero al último, sólo los pares, etc.). Tienen una serie de parámetros que dependiendo de la estrategia pueden tener distinta utilidad. Desde el punto de vista de la base de datos, las estrategias se definirían en la tabla ACD_CLASES_ESTRATEGIAS y se les da valor en la tabla ACD_ESTRATEGIAS_MARCADOR.
Una vez establecida la campaña y asignados sus contactos y dependiendo del modo de marcación (que se define en las colas) el proceso motorSal crea los intentos de marcación (siempre y cuando no estén en las listas Robinson), que serán leídos por el proceso myAcdSuperv que los convierte en llamadas para el Asterisk.

====Flujo de estados====

El flujo de estados es el reflejado en la figura siguiente:

[[Archivo:diagrama de flujo motorsal.png|center|800px]]

Los diferentes estados de un contacto son:
{| class="wikitable sortable"
|-
! Estado !! ID_Estado!! Descripción
|-
| Planificable || 0|| El contacto está preparado para que lo gestione motorSal y según la estrategia definida se establece el campo ACD_CONTACTOS_CAMPANNAS.D_HORA_PROXIMA
|-
|Planificado||10||Cuando ha llegado el tiempo marcado en HORA PROXIMA, motorSal ejecuta la 2ª fase de la estrategia, generando el intento de marcación.
|-
|Intento||20||El control pasa a myAcdSuperv, que a su vez genera la llamada en Asterisk. Cuando termina, se pasa a Planificable o Finalizado.
|-
|Finalizado||100||Las gestiones con este contacto han terminado.
|-
|Abortado||110||
|-
|Obsoleto||200||Se ha agotado el tiempo para contactar sin agotar todos los intentos. No se le vuelve a llamar nunca.
|-
|Cancelado||300||
|-
|}

====Carga de contactos====

===== Descripción =====

A continuación se explica la configuración y funcionamiento de la utilidad encargada de asignar contactos a campañas.

===== Configuración =====

El archivo de configuración recibe el nombre de '''cargaContactos.pconf.''' Este archivo reside en '''/etc/MDtel.''' El formato se describe en la tabla siguiente. Hay que tener en cuenta que las columnas empiezan a numerarse en 0.

{| class="wikitable" style="text-align:center;"
|-
! Parámetro !! Valor !! Obligatorio !! Defecto
|-
| db|| Nombre de la base de datos|| SI || nimitz
|-
| dbHost|| Host MySQL || SI || localhost
|-
| dbPort|| Puerto MySQL || NO || 3306
|-
| dbUsuario || Usuario de acceso a la base de datos|| SI ||
|-
| dbClave || Clave del usuario || SI ||
|-
| rutaContactos || Ruta hasta el archivo de contactos || NO || /var/spool/MDtel/contactos
|-
| obsoletos || Si vale 1, marcar como obsoletos los contactos anteriores || NO || 0
|-
| diasCaducidad || Número de dias a partir de los cuales caducarán los contactos || SI ||
|-
| idCampanna || Número de columna que contiene el ID de la campaña || SI||
|-
| idLista || Numero de columna que contiene el ID de la lista || SI ||
|-
| prioridad || Número de columna que contiene la prioridad || NO || Nota: El valor es de 0 a 99. A mayor número mayor prioridad (se le llamará '''ANTES''')
|-
| tipoTarea|| Número de columna que contiene el tipo de tarea || NO || Nota: los posibles valores de la columna son : *A: Alta *M: Modificación *B: Baja Por defecto el valor es A
|-
| codCli || Número de columna del CSV que contiene el código de cliente || SI ||
|-
| nombreCon || Número de columna del CSV que contiene el nombre || NO ||
|-
| apellido1 || Número de columna del CSV que contiene el primer apellido|| NO ||
|-
| apellido2 || Número de columna del CSV que contiene el segundo apellido || NO ||
|-
| empresa || Número de columna del CSV que contiene la empresa || NO ||
|-
| direccion1 || Número de columna del CSV que contiene la dirección || NO ||
|-
| direccion2 || Número de columna del CSV que contiene la dirección 2 || NO ||
|-
| codPostal || Número de columna del CSV que contiene el código postal || NO ||
|-
| localidad || Número de columna del CSV que contiene la localidad || NO ||
|-
| provin || Número de columna del CSV que contiene la provincia || NO ||
|-
| email || Número de columna del CSV que contiene el email || NO ||
|-
| valFijo_1 || Número de columna del CSV que contiene el primer número fijo del contacto || SI ||
|-
| valFijo_2 || Número de columna del CSV que contiene el segundo número fijo del contacto || NO ||
|-
| valFijo_3 || Número de columna del CSV que contiene el tercer número fijo del contacto || NO ||
|-
| valFijo_4 || Número de columna del CSV que contiene el cuarto número fijo del contacto || NO ||
|-
| valMovil_1 || Número de columna del CSV que contiene el primer número móvil del contacto || SI ||
|-
| valMovil_2 || Número de columna del CSV que contiene el segundo número móvil del contacto || NO ||
|-
| valMovil_3 || Número de columna del CSV que contiene el tercer número móvil del contacto || NO ||
|-
| valMovil_4 || Número de columna del CSV que contiene el CUARTO número móvil del contacto || NO ||
|-
| edad || Número de columna del CSV que contiene la edad || NO ||
|-
| nOpc1|| Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc2 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc3 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc4 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc5 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc6 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc7 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc8 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| cOpc1 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc2 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc3 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc4 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc5 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc6 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc7 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc8 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| Idioma || Idioma del contacto || NO ||
|-
|}

===== Funcionamiento =====

Para ejecutar la utilidad se debe teclear la siguiente orden en la línea de comandos:

'''cmd# cargaContactos.pl /<ruta hasta el conf>/cargaContactos.pconf <archivo CSV>'''

El archivo con los contactos deberá ser un CSV con los campos separados por ';'. La utilidad parsea el archivo conforme a la distribución indicada en la configuración y crea las correspondientes entradas en las tablas '''ACD_CONTACTOS''' y '''ACD_CONTACTOS_CAMPANNAS.'''

La utilidad crea un log en '''/var/log/cargaContactos.log''' en el que vuelca toda la operativa.
Por pantalla se va mostrando un lista con el ID asignado al contacto y el ID de campaña al que se le ha asignado.

Un ejemplo de fichero de carga de contactos sería el siguiente:

#
# Configuracion de cargaContactos.pconf
#
# Conexion de base de datos
$db='nimitz';
$dbHost = 'localhost';
$dbPort = '3306';
$dbUsuario = 'nimitz';
$dbClave = 'LA QUE SEA';
$diasCaducidad='300';
$rutaGrab = '/var/spool/MDtel/contactos';
$idCampanna = '31';
$idLista = '32';
$obsoletos = 0;
$codCli = '1';
$nombreCon = '2';
$apellido1 = '3';
$apellido2 = '4';
$empresa = '5';
$direccion1 = '6';
$direccion2 = '7';
$codPostal = '8';
$localidad = '9';
$provin = '10';
$email = '11';
$valFijo_1 = '12';
$valFijo_2 = '13';
$valFijo_3 = '14';
$valFijo_4 = '15';
$valMovil_1 = '16';
$valMovil_2 = '17';
$valMovil_3 = '18';
$valMovil_4 = '19';
$edad = '20';
$nOpc1 = '21';
$nOpc2 = '22';
$nOpc3 = '23';
$nOpc4 = '24';
$cOpc1 = '25';
$cOpc2 = '26';
$cOpc3 = '27';
$cOpc4 = '28';
$prioridad = '29';
$tipoTarea = '30';

====Comportamiento de reprogramaciones de llamadas en función del estado del agente====

Se ha preparado la siguiente maqueta:

Campaña saliente.
Cola saliente progresiva.
Dos agentes logados en VIVAit Suite.

En el formulario de la llamada se indica: llamada redirigida
Se selecciona el "check dirigida"

Las posibilidades de prueba son dos: "'''Cualquier agente'''" y "'''Solo agente'''"

Resultados son los siguientes:

{| class="wikitable sortable"
|-
| '''Estado del agente''' || '''Modo Cualquier Agente'''|| '''Modo Solo Agente'''
|-
| '''Agente Preparado''' || Entra llamada a agente|| Entra llamada a agente
|-
|'''Agente en Pausa'''||Entra llamada a otro agente disponible||Espera a agente y entra llamada.
|-
|'''Agente Hablando'''||Espera a agente y entra llamada||Espera a agente y entra llamada.
|-
|'''Agente en Tiempo administrativo'''||Espera a agente y entra llamada||Espera a agente y entra llamada.
|-
|'''Agente no logado'''||Entra llamada a otro agenete disponible||Consume intento.
|-
|'''Agente con una pestaña de chat abierta y el otro agente en pausa'''||Entra llamada a otro agente disponible||Espera a agente y entra llamada.
|-
|'''Agente con dos pestañas de chat abiertas'''||Espera a agente y entra llamada||Espera a agente y entra llamada.
|-
|}

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Movilidad ===
La movilidad es una función integral de las comunicaciones en la empresa. Cualquier empleado (usuario) es móvil en cierto grado, ya sea dentro o fuera de la organización. La solución óptima debe proporcionar continuidad de servicios y acceso a nuestros servicios, sin importar donde estemos.

==== Ofrecer movilidad a un usuario ====

Para permitir la movilidad a un usuario, puede ser en el momento de crear o editar un usuario en el apartado ''Administración de usuario'' en ''General'' del '''portal de administración ''VIVA''it'''. Asignándole un '''''numero login''''' (numero personal corporativo para el usuario) y una '''''clave login''''' ( se debe asignar una clave por defecto, pero puede cambiarla en el [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_3.0#Portal_de_usuario |portal de usuario]]). Para más información[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Pesta.C3.B1a_Centralita | ver sección Portal de administración - General - Usuarios - administración de usuarios - Pestaña Centralita]].

Además, de crear un permiso de la '''aplicación ''Centralita''''' a cualquier nivel, desde el apartado ''Permisos de usuarios'' en ''General'' del '''portal de administración ''VIVA''it'''. Para más información[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Asignaci.C3.B3n_de_Permisos_de_Usuario_por_Administrador | ver sección Portal de administración - General - Usuarios - Permisos a usuarios]]

'''La movilidad permite''' disponer de las extensiones telefónicas empresariales en cualquier lugar. Por
ejemplo, con un ordenador portátil o smartphone en una ubicación remota con conexión a Internet,
podríamos tener registrada nuestra extensión remotamente, y así las llamadas hacia/desde nuestra
oficina serían enrutadas por Internet hasta el equipo en cuestión sin coste alguno.


Todo terminal tiene asociado una extensión y deberá permitir la movilidad de usuarios. La extensión se configura cambiando a '''''SI''''' el campo '''''Hay Movilidad''''' desde el apartado ''Extensiones'' de ''Dispositivos'' en ''VIVAit Call'' del '''portal de administración ''VIVA''it'''. Para más información [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Extensiones | ver sección Portal de administración - VIVAit Call - Dispositivos - Extensiones]]

==== ¿Cómo funcionan las extensiones? ====

Primeramente el usuario debe tener los ejes apropiados en la tabla '''COM_USUARIOS_APLICACION''' (aplicación centralita).

La extensión debe de tener ''un teléfono'' y por tanto ''un modelo de teléfono asociado.''

Es tan simple como especificar '''la extensión, el usuario y la clave de este.'''

Para corroborar el funcionamiento de esta hay ''dos métodos'':

'''* CLI asterisk:'''

'''mdintz qry * nimitz bd extenEntraUsuarioMovil 25001 20001 1234'''

Y como resultado obtenemos lo siguiente:

mdintz Variables: 
MdintzIdentif='cms1' 
MOVIL_TIPO_RESET='10' 
MOVIL_CAD_RESET='notify_yealink' 
MdintzRes='OK'

El usuario con el login numérico 20001 se ha "movido" a la extensión 25001

Ahora ''nos quitamos de esa extensión mediante el siguiente comando:''

'''mdintz qry * nimitz bd extenSaleUsuarioMovil 25001'''

Resultado del comando:

mdintz Variables: 
MdintzIdentif='cms1' 
MOVIL_TIPO_RESET='10' 
MOVIL_CAD_RESET='notify_yealink' 
MdintzRes='OK'

Las pruebas anteriores han sido '''con extensiones con movilidad y con usuario con/sin
propietario.'''

Ahora las realizamos '''con extensiones sin movilidad'''

'''mdintz qry * nimitz bd extenEntraUsuarioMovil 25002 20001 1234'''

Obteniendo:

mdintz Variables: 
MdintzIdentif='cms1' 
MdintzRes='movil_error_datos'

Como era lo previsible no nos deja "movernos" a esa extensión ya que no tiene movilidad.


'''Si un usuario ya se ha movido a una extensión y se mueve a otra, el sistema lo deslogará de la primera para logarlo en la segunda.'''

'''mdintz qry * nimitz bd extenEntraUsuarioMovil 21000 20001 1234'''

Con salida:

mdintz Variables: 
MdintzIdentif='cms1' 
MOVIL_EXTEN='25001' 
MDintzRes='movil_ya_login'

'''* Dialplan'''

Para llamar a la función de movilidad hay que marcar el '''9992.'''

Nota.- Para comprobar que se realiza todo correctamente habría que mirar las trazas de Asterisk

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Grabación ===

La grabación en '''''VIVA'''''it Call está diseñada para ser lo mas flexible posible.

====Configuración====

Si deseamos grabar, debemos activar que alguno de los dispositivos/elementos que intervienen en la llamada se grabe.

Estos dispositivos/elementos son:

* Nodo.
* Usuario con Centralita.
* Agente.
* Grupo ACD corporativo y de Contact Center.
* Enlace exterior.
* Extensión.
* Facilidades.
* Grupo: grupo de salto o grupo de operadoras.
* Sala de conferencia.
* VDN corporativo y de Contact Center.
* Pre-rutas.

Por otro lado necesitaremos que la llamada pase por un nodo que sea grabador, es decir, que si la llamada esta configurada para que se grabe pero no pasa por ningún nodo grabador, la llamada no se grabará.

Al configurar un nodo existen cuatro campos que intervienen en la grabación.

''''Grabador''''

Se configura en el portal en la sección general/nodos.

Este campo corresponde con el campo [[BD.COM_NODOS#B_ES_GRABADOR|B_ES_GRABADOR]] de la tabla [[BD.COM_NODOS|COM_NODOS]] , este campo define si el nodo va a grabar las llamas que pasen por el que necesiten ser grabadas y no se estén grabando ya.

Es un campo booleano los posibles valores en el portal son si/no y en la base de datos 1/0.

''''Modo grabación infraestructura''''

Su configuración se realiza en el portal, en la sección general/nodos.

Este campo define como está configurada la infraestructura, este campo existe por compatibilidad con '''''VIVA'''''it suite y para poder configurar la grabación bajo demanda.

Este campo corresponde con el campo [[BD.COM_NODOS#E_MODO_GRABACION_INFRAESTRUCTURA|E_MODO_GRABACION_INFRAESTRUCTURA]] de la tabla [[BD.COM_NODOS|COM_NODOS]], Este campo usa los valores del enumerado BD.ENUM.TModoGrabacionInfraestructura|TModoGrabacionInfraestructura]].

La formula que se seguiría para ver si una llamada se graba en ese nodo es:
{|
|
|-
|
(NODO.E_MODO_GRABACION_INFRAESTRUCTURA) AND (NODO.B_ENRU_GRABAR OR CEN_PRE_RUTA.B_ENRU_GRABAR OR "OBJETO".B_ENRU_GRABAR)
|}

Que sería que si la infraestructura esta en NoGraba no se graba nada de lo que se rute en ese nodo y en cualquiera de los 2 otros caso (GrabaTodo o GrabaPorPeticion) se grabaría dependiendo de la configuración del Nodo, la ruta o el objeto en cuestión (preruta, grupo ACD, extension,...).

''''Grabar enrutamiento''''

Se configura en el portal en la sección general/nodos.

Este campo define si van a grabar las llamadas que se enruten en este nodo.

Campo [[BD.COM_NODOS#E_ENRU_GRABAR|E_ENRU_GRABAR]] de la tabla [[BD.COM_NODOS|COM_NODOS]] que usa los valores del enumerado [[BD.ENUM.TTipoEnruGrabar|TTipoEnruGrabar]].

''''RecordCentral''''

Se configura en el portal en la sección general/nodos.

Define que instancia del recordCentral es la encargada de tratar las grabaciones de este nodo.

Para aumentar el rendimiento a la hora de traerse las grabaciones, se pueden definir varias instancias de proceso recordCentral, este campo define cual de estas instancias se encargara de este nodo.

====Vivait Tracker====

Desde '''''VIVA'''''it Supervisor, que es la aplicación dirigida a Supervisores, ofrece la posibilidad de supervisar y gestionar grupos ACD, agentes, asignaciones, prioridades,etc. Se puede obtener acceso directo a las aplicaciones de grabación ('''''VIVA'''''it tracker)


Esquematico actual del proyecto tracker
[[Archivo:Esquematico_tracker_1.jpg|center]]

1º El tracker web llama al web service Remote login para iniciar sesión y determinar si tiene permisos para la escucha y descarga de grabaciones.

2º Si la ubicación de la grabación es local, mira la ruta de esta y se procede a la escucha o descarga de esta.

3º Si la ubicación de la grabación es remota, entra en escena el proxy. Es el que realiza la petición.

4º Si utilizamos el tracker windows, este, como el tracker web, llama primero al web service remote login para la autenticación y tema de Permisos.

5º Para descargar o escuchar una grabación desde el tracker windows, se llama al web service servidor de grabaciones pasándole simplemente el ID de segmento.mp3. Este web service, con el ID de segmento, se encarga de determinar la ubicación de la grabación.

Esquematico actual del proyecto tracker
[[Archivo:Esquematico_tracker_2_https.jpg|center]]

1º El tracker web llama al web service Remote login para iniciar sesión (comunicación https) y determinar si tiene permisos para la escucha y descarga de grabaciones. Se elimina el proxy

2º Si la ubicación de la grabación es local, mira la ruta de esta y se procede a la escucha o descarga de esta.

3º Si la ubicación de la grabación es remota, se realiza una petición al host remoto. El tipo de petición vendrá fijada por base de datos (http, https, ftp,ftps)

4º Si utilizamos el tracker windows, este, como el tracker web, llama primero al web service remote login para la autenticación y tema de permisos (comunicación https extremo a extremo).

5º Para descargar o escuchar una grabación desde el tracker windows, se llama al web service servidor de grabaciones pasándole simplemente el ID de segmento.mp3. Este web service, con el ID de segmento, se encarga de determinar la ubicación de la grabación.

[[#Grabación_(Vivait_Tracker)| Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operación_plataforma_VIVAit Volver al indice]]

=== Enrutamiento ===

[[Archivo:Enrutamiento.png|885px |center]]

==== Enfoque inicial ====

[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Enfoque_inicial Acceso]

==== Funcionamiento ====
El proceso de enrutamiento, como vimos en el esquemático, se compone de dos fases:

# Preenrutameinto, que se encarga de tratar todas las llamadas
# Enrutamiento externo, que tiene módulos dedicados al enrutamiento hacia:
:*Enlaces externos.
:*Extensiones.
:*Usuarios de telefonía corporativa.
:*Facilidades.
:*Salas de conferencia.
:*Agentes de grupos ACD.
:*Grupos ACD.
:*Vdn.
:*Buzones para dejar mensaje.
:*Buzones para su gestión.

Se asume que existen rutas directas entre todos los nodos de la red.

Se asume que están directamente enrutadas todas las direcciones IP involucradas, tanto nodos, como terminales.

Se asume que todas las facilidades están disponibles en todos los nodos, aunque es posible que la implementación sea diferente entre ellos.

Los datos de entrada básicos al proceso de enrutamiento (pdEntr) son:
* Dispositivo
* Cola
* Origen
* Nodo entrada
* UCID
* CALLER_ID_NAME
* CALLER_ID_NUM
* DNIS
* Desvío por dialplan

A partir de los datos de entrada básicos anteriores se pueden deducir los siguientes valores:
* Sede del dispositivo de entrada
* Sede del nodo de entrada
* Ancho de banda disponible en la sede del dispositivo
* Ancho de banda disponible en la sede del nodo
* Categoría entrante
* Valor del eje1 asignado a la llamadas
* CALLER_ID_NUM_EXTERNO

Los datos de salida globales del proceso de enrutamiento (pdSale) son:
* Categoría saliente
* Código de cliente (opcional)
* Tipo de destino:
:* No existe
:* Ruta externa
:* Extensión
:* Usuario de telefonía corporativa
:* Facilidad
:* Salas de conferencia
:* Agentes de grupos ACD
:* Grupos ACD
:* VDN
:* Buzón para dejar mensaje.
:* Buzón para dejar mensaje por ocupado.
:* Buzón para dejar mensaje por no contestación.
:* Buzón para su gestión.
* Destinatario (cuando se trata de un usuario o de un agente)
* Valor del eje1 asignado a la llamada
* Buzón de las extensiones y usuarios que los tengan asignados
* Si el buzón está en nodo distinto al de entrada
* DESVIO_INCONDICIONAL (sólo extensiones y usuarios) (valor MENSA=desvio_mensajeria en variable)
* DESVIO_NO_CONTESTA (sólo extensiones y usuarios) (valor MENSA=desvio_mensajeria en variable)
* DESVIO_OCUPADO (sólo extensiones y usuarios) (valor MENSA=desvio_mensajeria en variable)
* DESVIO_FUERA_SERV (sólo extensiones y usuarios) (valor MENSA=desvio_mensajeria en variable)

Los datos de salida para cada una de las posibles rutas en orden son (nn va de 01 maxRutas [nn son dos dígitos decimales]):
* CONTADOR_ABDE_nn (contador para control de ancho de banda en sede de dispositivo de entrada).
* CONTADOR_ABNE_nn (contador para control de ancho de banda en sede de nodo de entrada).
* CONTADOR_ABDS_nn (contador para control de ancho de banda en sede de dispositivo de salida).
* CONTADOR_ABNS_nn (contador para control de ancho de banda en sede de nodo de salida).
* CALLER_NAME_SAL_nn , puede salir de una extensión, un usuario o de un agente.
* CALLER_NUM_SAL_nn, puede salir de una extensión, un usuario o de un agente.
* DESTINO_SAL_nn , en general, el valor C_NOMBRE o destino de salida.
* RUTA_NODO_nn , Cadena de marcación para ir la nodo que soporta DESTINO_SAL_nn, si es distinto del nodo de entrada.
* RUTA_SAL_nn
:* Extensión: cadena marcación.
:* Facilidad: E_CODIGO_FACILIDAD obtenido de la tabla CEN_FACILIDADES.
:* Usuario: cadena marcación de la extensión asignada al usuario en movilidad o en propiedad.
:* Agente: cadena marcación de la extensión a la que está conectado el agente.
:* Ruta externa: contexto que gestiona la llamada saliente.

=====Fase preenrutamiento =====

La fase de preenrutamiento (basada en la tabla CEN_PRE_RUTA) se usa en todas las llamadas entrantes, tanto internas, como externas. Permite desarrollar un “prerouting” estándar para ACD y para telefonía corporativa.

Los datos de entrada al proceso de enrutamiento son iguales a los del proceso global de enrutamiento, excepto en que este proceso no usa el nodo de entrada ya que es independiente de éste.

Los datos de salida de la fase de preenrutamiento:
* D_CATEGORIA_SAL
* COD_CLIENTE (opcional)
* TIPO_DESTINO_SAL
:* No existe.
:* Volver a preenrutar.
:* Ruta externa.
:* Extensión.
:* Usuario de telefonía corporativa.
:* Facilidad.
:* Sala de conferencia.
:* Agente de grupos ACD.
:* Grupos ACD.
:* VDN.
:* Buzón para dejar mensaje.
:* Buzón para dejar mensaje por ocupado.
:* Buzón para dejar mensaje por no contestación.
:* Buzón para su gestión.
* COD_CLIENTE
* Valor del eje1 asignado a la llamada
* CALLER_NAME
* CALLER_NUM
* DESTINO

El proceso de preenrutamiento consiste en seleccionar un único registro de la tabla CEN_PRE_RUTA y, con sus valores y con los valores de entrada al proceso, generar los datos de salida.

Un posible tipo de salida es "Volver a preenrutar". Esto permite realimentar el proceso un máximo de "max_pre_ruta_regs" veces (en archivo .conf) para simplificar configuración. Sólo tiene sentido realimentar si se ha hecho alguna modificación en los datos de selección de registro, ya que en caso contrario se produciría un bucle que el proceso de preenrutamiento es capaz de detectar y evitar.

Para elegir el registro de CEN_PRE_RUTA, se tienen en cuenta los datos de entrada de la llamada, de modo que se cumpla con todos los puntos siguientes:
* ID_CATEGORIA_ENT igual a la del dispositivo de entrada.
* CALLER_NUM de entrada
:* Debe comenzar por la cadena C_ORIGEN_ENT_PREF o C_ORIGEN_ENT_PREF=NULL, con menos prioridad. Es conveniente rellenar este dato del modo más restrictivo que sea posible, independientemente de C_ORIGEN_ENT_EXPR. Ello permite disminuir el uso innecesario de recursos de evaluación de expresiones regulares.
:* Debe de tener un número de dígitos igual o superior a N_ORIGEN_ENT_MIN_DIGITOS, si este valor no es NULL o cero.
:* Debe de tener un número de dígitos igual o inferior a N_ORIGEN_ENT_MAX_DIGITOS, si este valor no es NULL o cero.
:* Debe cumplir la expresión regular C_ORIGEN_ENT_EXPR, si ésta no es NULL.
* DNIS empiece con C_DESTINO_ENT_PREF o C_DESTINO_ENT_PREF=NULL. Es conveniente rellenar este dato del modo más restrictivo que sea posible, independientemente de C_DESTINO_ENT_EXPR. Ello permite disminuir el uso innecesario de recursos de evaluación de expresiones regulares.
* Si varias entradas cumplen la condición anterior, se prueba primero la que el campo C_DESTINO_ENT_PREF tenga una longitud mayor y, de entre éstas, la que C_ORIGEN_ENT_PREF tenga una longitud mayor.
* DNIS tenga un número de dígitos igual o superior a N_DESTINO_ENT_MIN_DIGITOS, si este valor no es NULL o cero.
* DNIS tenga un número de dígitos igual o inferior a N_ORIGEN_ENT_MIN_DIGITOS, si este valor no es NULL o cero.
* DNIS cumpla la expresión regular C_DESTINO_ENT_EXPR, si ésta no es NULL.

Si no se encuentra ninguna entrada adecuada, quiere decir que es una llamada prohibida y se devuelve el tipo de destino "No existe".

Puede conseguirse un destino "por defecto" diferente, creando una entrada que encaje siempre para cada categoría: C_ORIGEN_ENT, C_ORIGEN_ENT_MIN_DIGITOS, C_ORIGEN_ENT_MAX_DIGITOS, C_ORIGEN_ENT_EXPR, C_DESTINO_ENT_PREF, N_DESTINO_ENT_MIN_DIGITOS, N_DESTINO_ENT_MAX_DIGITOS y C_DESTINO_ENT_EXPR a valor NULL.

Una vez elegida una entrada, ésta puede transformar o sustituir el valor de ID_CATEGORIA, CALLER_NAME, CALLER_NUM, DESTINO, COD_CLIENTE y/o EJE1_MSK a la salida del proceso.

Si ID_CATEGORIA_SAL es cero, se propaga a la salida el valor de la entrada. En caso contrario, se sustituye.

Si C_CALLER_NAME está vacío, se mantiene el valor hubiese a la entrada. En caso contrario, se sustituye.

C_CALLER_NUM puede contener una cadena que identifica el nuevo CALLER_NUM. Además, si la cadena comienza por los caracteres que se indican, el significado es especial:
* "=" o cadena vacía, el nuevo CALLER_NUM es igual al de entrada al proceso.
* "+" el nuevo CALLER_NUM es igual al de entrada al proceso, con los caracteres a continuación de "+" como prefijo.
* "-" se quita el número de caracteres que se indica a continuación de "-".
* "_" lo que sigue al carácter es una expresión regular que se aplica al CALLER_NUM de entrada. Dicha expresión regular tiene obligatoriamente que contener una subcadena (definida entre paréntesis, según el estándar de expresiones regulares) que nos da el nuevo CALLER_NUM de salida. Si la expresión regular no se cumpliese, se propagará el valor de entrada al proceso.
* cualquier otro valor del primer carácter determina que es una constante que sustituye el valor a la entrada.

Cada vez que se utilice una preruta, se incrementará el valor de N_CONTA si el valor de N_UMBRAL es mayor que cero.

Un valor N_UMBRAL mayor que cero permite modificar el destino de salida cuando el valor de actual de N_CONTA (antes de incrementarse) supere o sea igual el valor de N_UMBRAL. Si se cumple la condición indicada, se usa como destino tras el preenrutamiento, los valores de los campos E_TIPO_DESTINO_SAL_2 y C_DESTINO_SAL_2.

Si el valor de N_UMBRAL es menor o igual a cero o si N_CONTA es inferior a N_UMBRAL, se usa como destino tras el preenrutamiento, los valores de los campos E_TIPO_DESTINO_SAL_1 y C_DESTINO_SAL_1.
Con este mecanismo de N_CONTA y N_UMBRAL, se pretende facilitar el discriminar a los llamantes reincidentes, cuando sea necesario.

Un proceso periódico externo debe encargarse de poner a cero o decrementar el valor de N_CONTA.
Como resultado de los procesos de filtrado y de verificación anteriores, se habrá obtenido un TIPO_DESTINO_SAL y un C_DESTINO_SAL a partir de los campos con sufijo "_1" o "_2", con una metodología similar al caso C_CALLER_NUM.

C_DESTINO_SAL_x puede contener cadena que permite obtener el nuevo destino. Además, si la cadena comienza por los caracteres que se indican, el significado es especial:
* "=" o cadena vacía, el nuevo destino es igual al de entrada al proceso.
* "+" el nuevo destino es igual al de entrada al proceso, con los caracteres a continuación de "+" como prefijo.
* "-" se quita el número de caracteres que se indica a continuación de "-".
* "_" lo que sigue al carácter es una expresión regular que se aplica al destino de entrada. Dicha expresión regular tiene obligatoriamente que contener una subcadena (definida entre paréntesis, según el estándar de expresiones regulares) que nos da el nuevo destino de salida. Si la expresión regular no se cumpliese, quiere decir que es una llamada prohibida y se encaminará hacia una facilidad por defecto.
* cualquier otro valor del primer carácter determina que es una constante que sustituye el valor a la entrada.
Información de salida del proceso de preenrutamiento: Cuando TIPO_DESTINO_SAL_x toma los valores que se indican, el proceso global de enrutamiento sólo requiere de preenrutamiento y la información a devolver se obtiene dependiendo de TIPO_DESTINO_SAL_x:
* No existe: Se asume que no se conoce un destino para los datos de entrada, por lo que la llamada se encamina hacia una facilidad por defecto que gestiona su tratamiento.
* Extensión: A partir de las tablas CEN_DISPOSITIVOS, CEN_EXTENSIONES y CEN_NODOS, se devolverán los valores que permiten alcanzar la extensión en el nodo principal y en el secundario.
* Facilidad: A partir de las tablas CEN_DISPOSITIVOS, CEN_FACILIDADES y CEN_NODOS.
* Usuario de telefonía corporativa: A partir de las tablas CEN_USUARIOS, CEN_DISPOSITIVOS, CEN_EXTENSIONES y CEN_NODOS, se devolverán los valores que permiten alcanzar al usuario en el nodo principal y en el secundario de la extensión que corresponde en base a movilidad, con prioridad, o en base a propiedad. El caso de movilidad no se tiene en cuenta si el proceso de enrutamiento se realiza en "modo supervivencia".
* Sala conferencia: A partir de las tablas CEN_SALAS_CONFERENCIAS y CEN_NODOS.
* Agente de ACD: A partir de las tablas ACD_USUARIOS, DAT_TR_ACD_EXTENSIONES, CEN_DISPOSITIVOS, CEN_EXTENSIONES y CEN_NODOS, se devolverán los valores que permiten alcanzar al agente en el nodo principal y en el secundario.
* VDN: A partir de las tablas ACD_VDN y CEN_NODOS, se devolverán los valores que permiten alcanzar al VDN en su nodo.
* Grupo ACD: A partir de las tablas ACD_COLAS y CEN_NODOS, se devolverán los valores que permiten alcanzar al grupo ACD en su nodo.

El campo B_GENERAR_SEGMENTO de la tabla CEN_PRE_RUTA indica al proceso de preenrutamiento que es preciso generar un segmento de tipo "preenrutamiento". En el segmento generado, se rellena el campo C_ETIQUETA1 del nuevo segmento con el valor que contiene el campo homónimo del registro asociado en la tabla CEN_LISTA_PRE_RUTAS.

===== Fase de enrutamiento en casos en que el destino no es externo =====
Datos de entrada al proceso de enrutamiento externo: iguales a los de salida del proceso de preenrutamiento (pdPreSale), uniéndose a éstos los datos globales de entrada al proceso (pdEntr).

Datos de salida de la fase de enrutamiento: iguales que los del proceso global de enrutamiento (pdSale).

Específicamente y sólo para los casos en que el destino es una extensión (tipo de destino extensión, usuario de telefonía corporativa o agente) es cuando son válidos los datos correspondientes al buzón asociado y los datos de los posibles desvíos previstos.

También en este caso, se prevén dos posibles rutas, una se corresponde con el acceso a la extensión en el nodo principal de ésta y la otra en el nodo secundario.

En el resto de tipos de destino, sólo se prevé una ruta que puede incluir o no un enlace internodal.

===== Fase de enrutamiento en el caso de destino externo =====
Datos de entrada al proceso de enrutamiento externo: iguales a los de salida del proceso de preenrutamiento (pdPreSale), uniéndose a éstos los datos globales de entrada al proceso (pdEntr).
Datos de salida de la fase de enrutamiento: iguales que los del proceso global de enrutamiento (pdSale).

Se elige los primeros "max_ruta" registros (configurado en archivo .conf) en CEN_DESTINOS_EXTERNOS unido con CEN_RELACION_DESTINOS_ENLACES_EXTERNOS que, teniendo en cuenta los datos de entrada al proceso de enrutamiento, cumpla con todos los puntos siguientes:
* ID_CATEGORIA_ENT igual a la de salida del proceso de preenrutamiento.
* C_DESTINO_SAL de proceso de preenrutamiento empiece con C_DESTINO_ENT_PREF.
* Si varias entradas cumplen la condicion anterior, se prueba primero la que el campo C_DESTINO_ENT_PREF tenga una longitud mayor.
* C_DESTINO_SAL tenga un número de dígitos igual o superior a N_DESTINO_ENT_MIN_DIGITOS, si este valor no es NULL o cero.
* C_DESTINO_SAL tenga un número de dígitos igual o inferior a N_DESTINO_ENT_MAX_DIGITOS, si este valor no es NULL o cero.
* C_DESTINO_SAL cumpla la expresión regular C_DESTINO_ENT_EXPR, si ésta no es NULL.

Aparte de la longitud del campo C_DESTINO_ENT_PREF, se usa N_PRIORIDAD como campo para ordenar los registros y seleccionar lo "max_ruta" primeros.

Una vez que un registro es válido, se descartan todos los registros cuyo C_DESTINO_ENT_PREF es diferente del primero seleccionado.

Como resultado de los procesos de filtrado y de verificación anteriores, se habrá obtenido hasta un máximo de "max_rutas" valores para posibles rutas. Las posibles propagaciones y transformaciones en los datos de cada ruta son función de los datos de cada registro seleccionado:

CALLER_NAME_nn: Si C_CALLER_NAME está vacío, se propaga el valor de entrada. En caso contrario, se sustituye.

CALLER_NUM_nn: Sale de C_CALLER_NUM que puede contener una cadena que identifica el nuevo CALLER_NUM_n. Además, si C_CALLER_NUM comienza por los caracteres que se indican, el significado es especial:
* "=" o cadena vacía, el nuevo CALLER_NUM_nn es igual al de entrada al proceso.
* "+" el nuevo CALLER_NUM_nn es igual al de entrada al proceso, con los caracteres a continuación de "+" como prefijo.
* "-" se quita el número de caracteres que se indica a continuación de "-".
* "_" lo que sigue al carácter es una expresión regular que se aplica al CALLER_NUM de entrada. Dicha expresión regular tiene obligatoriamente que contener una subcadena (definida entre paréntesis, según el estándar de expresiones regulares) que nos da el nuevo CALLER_NUM de salida. Si la expresión regular no se cumpliese, se propaga el valor de entrada al proceso.
* ">" Si existe valor para CALLER_NUM_EXTERNO, se propagará éste a la salida. En caso contrario y si no está vacía la cadena que queda al eliminar el prefijo ">", se susituye en la salida por el valor de la cadena sin prefijo. Si la cadena estuviese únicamente constituida por el valor ">", se propaga el valor de entrada.
* cualquier otro valor del primer carácter determina que es una constante sin ninguna modificación.

C_DESTINO_SAL_nn: Se obtiene a partir de C_DESTINO_SAL que puede contener una cadena que identifica el nuevo destino. Además, si la cadena comienza por los caracteres que se indican, el significado es especial:
* "=" o cadena vacía, el nuevo destino es igual al de entrada al proceso.
* "+" el nuevo destino es igual al de entrada al proceso, con los caracteres a continuación de "+" como prefijo.
* "-" se quita el número de caracteres que se indica a continuación de "-".
* "_" lo que sigue al carácter es una expresión regular que se aplica al destino de entrada. Dicha expresión regular tiene obligatoriamente que contener una subcadena (definida entre paréntesis, según el estándar de expresiones regulares) que nos da el nuevo destino de salida. Si la expresión regular no se cumpliese, se propaga el valor de entrada al proceso.
* cualquier otro valor del primer carácter determina que es una constante sin ninguna modificación.

RUTA_NODO_nn: Sólo se usa si el nodo de salida es diferente del nodo de entrada. Contiene la cadena de marcación para ir la nodo que soporta DESTINO_SAL_nn. Sale del campo C_FORMATO_DIAL (sustituyendo variables) correspondiente al tipo de dispositivo del enlace exterior.

RUTA_SAL_nn: Es el campo C_DATO_ASTERISK obtenido a partir del registro en la tabla CEN_ENLACE_EXTERIOR que se corresponde con ID_ENLACE_EXTERIOR de la tabla CEN_RELACION_DESTINOS_ENLACES_EXTERNOS.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Control de ancho de banda ===

Para el control de ancho de banda, primero hemos de tener en consideración que una llamada puede tener asociadas hasta cuatro sedes
:* Sede del terminal origen (terminal A)
:* Sede del nodo de registro del terminal origen (nodo A)
:* Sede del terminal destino (terminal B)
:* Sede del nodo de registro del terminal destino (nodo B)

Además hemos de tener en cuenta que el audio de la conversación podrá ir:
:* De manera directa entre terminal A y terminal B
:* De manera indirecta, a través de los nodos A y B

[[Archivo:ancho de banda.png|700px]]

Cuando se va a cursar una llamada de terminal A a terminal B, el proceso de enrutamiento del nodo A devuelve 4 variables de canal al dialplan:

{| class="wikitable"
|-
! Variable!!Campos
|-
|R_ABDE_xx||R = Variable de rutas --- AB = ancho de banda --- D = dispositivo --- E = Entrante --- xx = de 0 a 3
|-
|R_ABNE_xx||R = Variable de rutas --- AB = ancho de banda --- N = nodo --- E = Entrante --- xx = de 0 a 3
|-
|R_ABDS_xx||R = Variable de rutas --- AB = ancho de banda --- D = dispositivo --- S = Saliente --- xx = de 0 a 3
|-
|R_ABNS_xx||R = Variable de rutas --- AB = ancho de banda --- N = nodo --- S = Saliente --- xx = de 0 a 3
|-
|}

El valor de cada variable es una cadena del tipo '''AB.wwww.xxxx.y.z''' donde cada valor es:
:* '''wwww''' --> id de sede
:* '''xxxx''' --> ancho de banda total de la sede
:* '''y''' --> número de llamadas a sumar si conversación directa
:* '''z''' --> número de llamadas a sumar si conversación indirecta

Por otro lado tenemos que tener en cuenta que el dialplan tiene control de las llamadas que cada sede puede cursar

De esta forma, cuando existe una nueva llamada el dialplan aplica la fórmula, suma el resultado al número de llamadas en curso y lo compara con el máximo...si el resultado es mayor que le máximo la llamada no se cursará por congestión

Configuraremos el ancho de banda por sede en el portal de administración y el consumo que hace cada llamada en la variable '''AB_CONSUMO_LLAMADA''' del fichero '''ext_MDtel_particular.conf''' de cada nodo de conmutación; el valor por defecto es 32

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

== Puesto de trabajo ==
El puesto de trabajo del agente en la plataforma '''''VIVA'''''it (para el producto '''''VIVA'''''it Suite) estará compuesto por:
* PC (típicamente windows) en el que reside la aplicación '''''VIVA'''''it Desk
* Terminal telefónico con extensión física asociada.

Para más información [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Puestos | ver sección Portal de administración-VIVAit Suite ACD+ - Puestos]].

=== Relación PC/teléfono en puesto de trabajo ===

Existirá una relación única entre nombre PC y extensión física asociada, si bien los agentes se identificarán por su login que les acompaña al puesto de trabajo en el que se loguen
Existe un procedimiento documentado para la operativa de cambio de puesto de trabajo, en caso de ser necesario el cambio de PC o de teléfono de un puesto de trabajo.
==== Procedimiento para un cambio de puesto de trabajo ====
Se basa en una asignación de PC a teléfono relaccionando la extensión telefónica del terminal físico con el nombre del puesto de trabajo. La configuración de dicha asociación se realiza en el portal de administración de la plataforma.

Cualquier cambio que se realice en terminal telefónico o PC de agente ha de mantener la asociación en el portal a efectos de permitir el funcionamiento del sistema.

A continuación se reflejan los cambios más habituales:

{| class="wikitable"
|-
! Cambio !! Procedimiento !! Punto de acción
|-
|rowspan="2"| Cambio de ubicación de un PC || Opción 1.- Renombrar el PC para que conserve el nombre que tenía el anterior en esa ubicación || PC de agente
|-
| Opción 2.- Rehacer la asignación extensión/puesto || Portal de administración
|-
| rowspan="2"| Instalación de PC nuevo en puesto existente || Opción 1.- Renombrar el PC para que conserve el nombre que tenía el anterior en esa ubicación || PC de agente
|-
| Opción 2.- Rehacer la asignación extensión/puesto || Portal de administración
|-
| Cambio de nombre en un PC || Rehacer asignación extensión/puesto || Rehacer asignación extensión/puesto
|-
|Cambio de ubicación de un teléfono || Rehacer la asignación extensión/puesto
|| Portal de administración
|-
| Instalación de un teléfono nuevo en puesto existente || Rehacer la asignación extensión/puesto || Portal de administración
|-
| Instalación de un nuevo puesto de agente|| Hacer asignación extensión/puesto || Portal de administración
|}


=== Estructura de aplicaciones en puesto de trabajo ===
Las aplicaciones del puesto de trabajo pueden estar ubicadas en cualquier carpeta del sistema. Es importante tener en cuenta que los procesos de actualización, logs… escriben en dichas carpetas, por lo que el usuario de windows deberá tener permisos de lectura/escritura y borrado sobre dichas carpetas
La instalación del puesto de trabajo es muy liviana para el sistema; las aplicaciones ocupan poco espacio y no se modifican ficheros del sistema operativo (registry o similares)
Los ficheros importantes son
{| class="wikitable"
|-
! Fichero !! Descrición
|-
| Vivait-desk.exe || Contiene la aplicación '''''VIVA'''''it Desk de agente
|-
| vivait_desk_dll.dll||Este fichero contiene controles sobre los formularios (controles de
texto, algunas reglas de obligatoriedad…)
|-
| nimitz.ini || Configuración del puesto de agente
|-
| lanzador.exe || Aplicación de actualización de versiones
|-
| lanzador.ini || Configuración del actualizador de aplicaciones
|-
| Carpeta forms || En esta carpeta están ubicados los formularios que se abren ante llamada entrante o saliente
|-
| Carpeta imágenes || Contiene las imágenes izquierda y derecha de la barra de '''''VIVA'''''it Desk
|-
|}

=== Secciones de utilidad en nimitz.ini ===

==== Configuración del puesto de agente ====

El fichero nimitz.ini contiene la configuración del puesto de agente; sus principales parámetros son:

{| class="wikitable" border="0" style="background:#ffffff" align="top"
|-
| |''' Fichero'''
|| '''Descripción'''
|-
|Sección [bd1]
||host="ip_BBDD_tiempo_real"
puerto="Nº puerto"
basedatos="nimitz"
usuario="nimitz"
clave="UIk5jMY9PVX6ogg="

Contiene información para la conexión a BBDD de tiempo real, en la que '''''VIVA'''''it Desk fundamentalmente inserta información
|-
|Sección [bd2]
||host=" ip_BBDD_replica "
puerto="Nº puerto"
basedatos="nimitz"
usuario="nimitz"
clave="UIk5jMY9PVX6ogg="

Contiene información para la conexión a BBDD de réplica, en la que '''''VIVA'''''it Desk solo leerá información
|-
|Sección [telefono]
||pruebas=1 (Valores válidos 0 ó 1)
Activación de funcionalidad "servicio técnico" en '''''VIVA'''''it Desk.

puesto="Nombre puesto"
|-
|Sección [trazas]
|| nivel=3

archivo=1

consola=0

sobreescribir=1

Activación de generación de ficheros de trazas "viva-desk.log" en carpeta de aplicaciones
|}

=== Parámetros en invocación a '''''VIVA'''''it Desk ===

La aplicación '''''VIVA'''''it Desk puede ser invocada con una serie de parámetros que condicionan su funcionamiento; los parámetros son:
* Primer parámetro: Nombre del archivo .ini; usado como alternativa al fichero por defecto "nimitz.ini"
* Segundo parámetro: Nombre de puesto; usado como alternativa al nombre de puesto del ordenador
* Tercer parámetro: Nombre de login; para forzar un usuario; es de utilidad si el sistema está configurado como "confiar en sistema operativo", en cuyo caso no permite seleccionar un login de agente para acceder a la aplicación

=== Instalación y actualización de aplicaciones de puestos de trabajo ===
La instalación y actualización de las aplicaciones en el puesto de trabajo pasan por disponer de los ficheros “lanzador.exe” y “lanzador.ini” (debidamente configurado) dentro de la carpeta en la que se desee instalar.
Lanzando la aplicación “lanzador.exe” se instalará o actualizará el sistema.

El fichero “lanzador.ini” tiene el siguiente aspecto:
URL="http://IP_Servidor:8180/WSActualizaXML/actualizar.xml"
BASE_URL_DESCARGAS="http://IP_servidor:8180/XMLFILES/"

=== Servicio técnico en '''''VIVA'''''it Desk ===
La activación de la funcionalidad de servicio técnico en '''''VIVA'''''it Desk nos permite realizar sincronizaciones manuales de la aplicación y activar trazas a nivel de Base de Datos o a nivel de log sobre el propio '''''VIVA'''''it Desk. Pulsando el botón derecho del ratón sobre la barra '''''VIVA'''''it Desk accederemos a las capacidades de soporte técnico
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

== Funcionamiento de la plataforma en modo emergencia ==
== Accesos Web ==

{| class="wikitable"
|-
! Aplicación !! Enlace
|-
|Portal de administración '''''VIVA'''''it Suite || http://ip_admin:8180/Vivait-Call
|-
|'''''VIVA'''''it Tracker||http://ip_tracker:8180/Vivait-Tracker
|-
|Monitor Web||http://ip_monitor:8180/MonitorWeb
|-
|Monitorización Zabbix||http://ip_zabbix:80/zabbix
|-
|Base de datos tiempo real||http://ip_bbdd_tr:80/phpmyadmin/
|-
|Base de datos réplica||http://ip_bbdd_replica:80/phpmyadmin
|}

=== Permisos de aplicaciones ===
Se crean a través del '''portal de administración ''VIVA''it''' . Debe conocerse como funcionan los ejes [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Ejes| ver sección Portal de administracion - General - Ejes]] y que existen cuatro aplicaciones creadas en la plataforma:

[[Archivo:17_2 Pestaña Genera - Usuarios - Explicacion permisos.png|center]]

La forma como dar permisos de aplicaciones a un usuario esta explicada en la [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Asignaci.C3.B3n_de_Permisos_de_Usuario_por_Administrador | sección Portal de administracion - General - Usuarios ]].

== Elementos monitorizados del sistema ==
===Generalidades de Zabbix===
====Zabbix ====
Zabbix es una solución de código abierto que ofrece características de monitorización avanzada de forma tecnica y para el negocio, para todo tipo de servidores, aplicaciones y equipos que forman parte de una red. La versión que utilizamos en '''md'''tel es Zabbix 2.2.2.

Zabbix monitoriza los recursos de un equipo en forma remota, permite centralizar la información en un servidor que permite visualizar el monitoreo, cuenta con una interfaz de administración vía web y utiliza un mecanismo flexible de la notificación que permita que los usuarios configuren las alarmas basadas email para informar virtualmente cualquier acontecimiento. Esto permite una reacción rápida a los problemas del servidor.

Para acceder al servidor Zabbix abrimos el navegador y ponemos la dirección de red (IP) de la maquina donde se encuentra instalado el servidor de Zabbix seguido de "/Zabbix.
{|
|-
|
Direccion.IP.Zabbix.Server/zabbix
|}

Zabbix posee documentación tanto en wiki, foros y comunidades.Para ampliar la información se puede visitar:
[[http://www.zabbix.com Sitio oficial de Zabbix]]
===== Glosario Zabbix =====
Se trata de una lista de conceptos básicos de Zabbix, pero para ampliar la información sobre otros términos, visite el [[http://www.zabbix.com Sitio oficial de Zabbix]].
* '''host'''
:En Zabbix, un host es una entidad que define el elemento en red que se desea monitorizar/supervisar activamente sus recursos locales y aplicaciones. Este puede ser una impresa, router, switch, sensores de temperatura, un servidor, un ordenador,etc, o también una aplicación. La característica de un host es que debe poseer una dirección de red (IP).

* '''host group'''
:En Zabbix, un host group (grupo host) es una agrupación lógica de los host, como una forma de organizar los dispositivos "Host" registrados en Zabbix para su monitorización. Puede contener hosts y templates. Los grupos host se utilizan en la asignación de derechos de acceso a los hosts para diferentes grupos de usuarios.

* '''item'''
:En Zabbix, un item (medida) es el parámetro que deseamos obtener del host, básicamente es una medida especifica que el servidor Zabbix recogerá de los agentes de Zabbix instalados en los host.

* '''trigger'''
:En Zabbix, un trigger(disparador) es una entidad que define un umbral para detectar la existencia de un problema en un dispositivo. Son valores recolectados por los "items", se usa para "evaluar" los datos recibidos con condiciones definidas. Las condiciones son de tipo aritmético y lógico.
* '''event'''
:En Zabbix, un event (evento) es la aparición de un suceso en Zabbix que necesita atención. Por ejemplo, el cambio de estado a raíz de un trigger, el descubrimiento de un nuevo agente (autoregistro),etc.
* '''action'''
:En Zabbix, una action(acción) son reglas predefinidas para reaccionar a un evento disparado por los triggers, es decir, define qué hacer ante un evento. Consta de operaciones (por ejemplo, una notificacion, comandos remotos) y condiciones (cuando la operación se lleva a cabo).
* '''notification'''
:En Zabbix, una notification (notificacion) es la entidad con que Zabbix nos puede notificar (Correo Electrónico,mensajes vía "SMS" o Jabber).
* '''template'''
:En Zabbix, un témplate (plantilla) viene predefinida en la instalación de Zabbix Server, con el fin de ser aplicada en base al tipo de sistema operativo(Linux, Mac, Window, etc) o en elementos que comparten los mismos parámetros de medición, por ejemplo la carga del procesador, uso de memoria y uso de recursos de red. Las plantillas son un conjunto de módulos "ITEM, TRIGGERS y GRÁFICAS", que están preconfigurados y listas para ser aplicadas a uno o varios hosts.
* '''application'''
:En Zabbix, una application (aplicación) es una agrupación lógica de los items.
* '''Zabbix server'''
:El Zabbix server (servidor de Zabbix) es el proceso central donde están definidas las configuraciones y donde se almacenan todos los datos y estadísticas recogidas de los agentes Zabbix.Consta de una base de datos, una interfaz web y el propio server. Como servidor, se encarga de recoger los datos de los agentes, calcular los triggers, enviar notificaciones, etc.
* '''Zabbix agent'''
:El zabbix agent (agente de Zabbix) es un proceso desplegado en los host que son supervisados, que funciona como un servicio y puede funcionar de forma activa y pasiva simultáneamente.

=====Discovery=====
La funcionalidad discovery(detección) lista los dispositivos que se integran en nuestra red y el tipo de servicios que proporciona. Por ejemplo, si la empresa tuviera cien colas ACDs, y veinticinco VDNS, y en cada cola como veinte medidas, seria muy laborioso registrar una por uno cada uno.
Gracias a esta funcionalidad, se descubre todas las interfaces de red que se tiene, automáticamente y tanto para colas nodos o IVR. Para utilizar esta funcionalidad , se hace el uso de dos script, que se instalan en el momento de instalación de Zabbix en el directorio "/usr/local/sbin", que son:
{|
|-
|
'''zabbixDiscoveryQueues.pl''' : script utilizado para buscar colas ACD.

'''zabbixDiscoveryVDN.pl''' : script utilizado para buscar VDNS.
|}
La explicación de como configurarla se encuentra en el manual oficial [[https://www.zabbix.com/documentation/2.2/manual/discovery/network_discovery/rule | Zabbix detección de redes]].

=====Notificaciones=====

Necesariamente, debe darse de alta al usuario y darse de alta el servidor de correo electrónico para poder ser capaz de enviar correos.

Por otro lado, el formato del correo electrónico y las condiciones de envío de correo al usuario se configura en las acciones. Véase el [[https://www.zabbix.com/documentation/2.2/manual/quickstart/notification | manual oficial de Zabbix 2.2]]

=====Usuarios=====
Zabbix permite la organización de usuarios en grupos para establecer los permisos adecuados de acuerdo al tipo de perfil que deseemos crear. Necesariamente un usuario debe permanecer a un grupo o varios grupos.Todos los usuarios acceden a la aplicación de Zabbix a través de la interfaz Web.

Cada usuario Zabbix se le asigna un nombre de usuario único , una contraseña y podemos indicarle que tipo de comunicación que posee, normalmente es vía email, pero puede ser vía a otro tipo de medios. Para mas información ver el [[https://www.zabbix.com/documentation/2.2/manual/web_interface/user_profile || manual oficial ]].

=====Visualización=====
Con Zabbix es posible visualizar los datos como gráficos, pantallas, mapas y hasta presentaciones cambiantes, entre otros. En este apartado solo nombraremos características esenciales que se tendra que completar con el [[https://www.zabbix.com/documentation/2.2/manual/config/visualisation | manual oficial]]
======Graphs======
{|
|-
|
'''Nota:''' Debe crearse algun item dentro del host para poder utilizar una gráfica.
|}
En Zabbix una gráfica sirve para representar gráficamente los resultados obtenidos de uno item o varios items.
[[File:EjemploGrafica.png|center|750px]]
Los valores min / avg / max que Zabbix obtiene y representa son de un registro de datos de la tabla tendencias.

======Screens======
La pantalla refiere a otra característica adaptable de ZABBIX cuál permite que los usuarios creen las pantallas personalizadas dentro de ZABBIX para exhibir la información. Se considera como una colección de gráficas y no depende del host. Una pantalla puede consistir en gráficos simples, gráficos personalizados, integrar mapas, Alertas, gráficos estadísticos o texto llano tal como los 5 valores pasados de un item particular entre otros; y mostrar la información de forma dinámica.

[[File:EjemploScreen.png|center|750px]]

======Maps======
En Zabbix, un map (mapa) es una representación gráfica de la situacion de nuestros dispositivos en red. Es un escenario que muestra nuestra red, aplicaciones y servicios a través de figuras o iconos. Dichas figuras toman vida en respuesta a los eventos que se dan en nuestro entorno.
[[File:EjemploMaps.png|center|750px]]
[[File:EstadosMaps.png|center|750px]]

======Monitorizar el estado de los raid======
Los siguientes comandos son necesarios para poder monitorizar el estado de los raid.
La orden:

>hpacucli "ctrl slot=1 logicaldrive 1 show status"

nos proporciona el estado de un raid (p.e. logicaldrive 1 (931.5 GB, 1): Interim Recovery Mode).

La orden:
>hpacucli "ctrl slot=1 logicaldrive all show status"

nos proporciona el estado de todos los raid.

p.e.:
logicaldrive 1 (931.5 GB, 1): Interim Recovery Mode

logicaldrive 2 (1.8 TB, 1): OK.

Para conseguir información genérica el comando

ctrl all show config detail

nos muestra mucha información y podemos saber el modelo de disco físico que lleva instalado para poder comprar el modelo antes de "operar".

===Zabbix en '''MD'''tel===

==== Configuraciones de Zabbix ====

===== Agentes Zabbix =====
{|-
|
|
'''Nota:''' Hay que instalar un agente Zabbix en cada maquina que se quiera monitorizar.
|}

El agente de Zabbix puede recoger datos:
*'''De forma pasiva:''' el server contacta al agente pidiéndole un dato (por ejemplo el consumo de CPU en ese instante) y el agente responde al server con ese dato. A esta acción del agente le llamaremos '''Agente activo'''.
*'''De forma activa:''' en un primer momento, el server le enviará al agente el listado de items a monitorizar. A partir de ese momento, será el agente que de forma periódica recogerá datos sobre esos ítems y se los hará llegar al server. A esta acción del agente le llamaremos ''''''Agente pasivo''''''.

====== Configurar agente de forma pasiva======
Para configurar el agente de Zabbix necesitamos acceder a la maquina que actuará como agente, y en el directorio /etc/zabbix modificar el fichero '''zabbix_agentd.conf''' e indicar cual es la dirección de red (IP) del servidor Zabbix.

{|
|-
|
##### Passive checks related
### Option: Server
# List of comma delimited IP addresses (or hostnames) of Zabbix servers.
# Incoming connections will be accepted only from the hosts listed here.
# If IPv6 support is enabled then '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1'
# are treated equall$
#
# Mandatory: no
# Default:
Server= IP.Server Zabbix.
|}
Tras la configuración del fichero, debemos reiniciar el servicio de los agentes.
{|
|-
|
sudo service zabbix-agent restart
|}

====== Configurar agente de forma activa ======

Para configurar el agente de Zabbix necesitamos acceder a la máquina que actuará como agente, y en el directorio /etc/zabbix modificar el fichero '''zabbix_agentd.conf''' e indicar cual es la dirección de red (IP) del servidor Zabbix.

{|
|-
|
##### Active checks related
### Option: ServerActive
# List of comma delimited IP:port (or hostname:port) pairs of Zabbix serv$
# If port is not specified, default port is used.
# IPv6 addresses must be enclosed in square brackets if port for that hos$
# If port is not specified, square brackets for IPv6 addresses are option$
# If this parameter is not specified, active checks are disabled.
# Example: ServerActive=127.0.0.1:20051,zabbix.domain,[::1]:30051,::1,[12$
#
# Mandatory: no
# Default:
ServerActive=127.0.0.1
--------------------------sección separada----------------------------
### Option: UserParameter
# User-defined parameter to monitor. There can be several user-defined pa$
# Format: UserParameter=<key>,<shell command>
# See 'zabbix_agentd' directory for examples.
#
# Mandatory: no
# Default:
# UserParameter=
User_parameters:asterisk.pid, /usr/bin/asterisk -rx 'core show chanels'|grep 'active calls'| cat -d -f 1
|}

El parámetro '''User_parameters''' tiene un formato de este estilo:
{|
|-
|
User_parameters: NombreMedida, comando.
|}

El nombre de la medida se refiere al nombre que demos a la aplicación , no hace falta que exista una aplicación con ese nombre en Zabbix, y el comando , es el comando remoto que tiene que ejecutar el servidor Zabbix. Posiblemente necesita darse permisos para ejecutar el comando y siempre debe devolver un valor (un numero o un tiempo) que el servidor Zabbix puede manejar.
Tras la configuración del fichero, debemos reiniciar el servicio de los agentes.
{|
|-
|
sudo service zabbix-agent restart
|}

===== Scripts del Servidor Zabbix =====
{|
|
|
'''Nota''': No olvidar que en la misma maquina del server Zabbix, debe configurarse como agente de Zabbix.
|}
Después de realizar la [[# Instalación de Zabbix | Instalación de Zabbix ]] correctamente. Se han creado otros ficheros scripts (''scripts propios de '''md'''tel'') que facilitarán la petición del servidor a los agentes activos, para poder parametrizar todos los elementos del negocio que suelen monitorizarse.
Dependiendo de lo que vaya a monitorizarse necesitaremos algún script o todos. Algunos nos informan sobre elementos de negocio, saber si asterisk funciona , monitorizar el CTI (lanzara nc localhost 1111) , controlar el Intz-Nimitz, comprobar si funciona motalsal, ect.

Cada script se exportara a los host, para que pueda facilitar los datos que pide el servidor Zabbix y configurarse.
Por ejemplo,para monitorizar las llamadas en curso del ACD, agentes conectados, agentes desconectados, etc.
Todos los scripts se deben colocar en el directorio /usr/local/sbin con permisos 755, su nombre es parecido a "zabbixSenderXXXXX.pl"
{|
|-
|
ls /usr/local/sbin/ |grep zabbixSender
'''zabbixSenderACDBD.pl'''
'''zabbixSenderACD.pl'''
'''zabbixSenderCTI.pl'''
'''zabbixSender-intz-nimitz.pl'''
'''zabbixSenderMotorSal.pl'''
'''zabbixSenderMyACDSuperv.pl'''
'''zabbixSenderRecordNodo.pl'''
'''zabbixSenderRecordCentral.pl'''
|}

Se crea una tarea programada en linux para poder ejecutarse los scripts, programando el tiempo en que debe ejecutarse.

Si visualizo que "............" aparece:

***** root zabbix

======zabbixSenderACDBD.pl======

'''Uso:''' Obtiene diversos valores por cada cola, estados de agente por cola y estados de agente generales.

'''Ubicación:''' Servidor BDTR.

'''Parámetros:''' Ruta al archivo de configuración (Por ejemplo: ''/etc/MDtel/zabbixSenderACDBD.pconf'')

'''Archivo de configuración:''' zabbixSenderACDBD.pconf

{|
|-
|
'''$db:''' Nombre de la BBDD (normalmente nimitz)
'''$dbHost:''' Dirección IP del servidor de BBDD de TR (normalmente BDTR)
'''$dbPort:''' Puerto MySQL (normalmente 3306)
'''$dbUsuario:''' Usuario MySQL (normalmente nimitz)
'''$dbClave:''' Clave del usuario
'''$sZab:''' Dirección IP del servidor Zabbix
'''$hZab:''' Nombre del host Zabbix (normalmente el nombre de máquina, tal y como se configura en
zabbix_agentd.conf o en el host en la web de Zabbix)
|}

======zabbixSenderACD.pl======

'''Uso:''' Obtener el PID de Asterisk para revisar si se ha reiniciado en caso de que cambie.

'''Ubicación:''' Servidor ACD.

'''Parámetros:''' Ruta al archivo de configuración (Por ejemplo: ''/etc/MDtel/zabbixSenderACD.pconf'').

'''Archivo de configuración:''' zabbixSenderACDBD.pconf.

{|
|-
|
'''$db:''' Nombre de la BBDD (normalmente nimitz)
'''$dbHost:''' Dirección IP del servidor de BBDD de TR (normalmente BDTR)
'''$dbPort:''' Puerto MySQL (normalmente 3306)
'''$dbUsuario:''' Usuario MySQL (normalmente nimitz)
'''$dbClave:''' Clave del usuario
'''$sZab:''' Dirección IP del servidor Zabbix
'''$hZab:''' Nombre del host Zabbix (normalmente el nombre de máquina, tal y como se configura en
zabbix_agentd.conf o en el host en la web de Zabbix)
|}

======zabbixSenderCTI.pl======

'''Uso:''' Obtener estado y los distintos valores de vivait-cti.

'''Ubicación:''' Servidor donde se ejecute vivait-cti. Normalmente el servidor ACD.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

======zabbixSender-intz-nimitz.pl======

'''Uso:''' Obtener estado y los distintos valores de intz-nimitz.

'''Ubicación:''' Servidor donde se ejecute intz-nimitz.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

======zabbixSenderMotorSal.pl======

'''Uso:''' Obtener estado y los distintos valores de motorSal.

'''Ubicación:''' Servidor donde se ejecute motorSal.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

======zabbixSenderMyACDSuperv.pl======

'''Uso:''' Obtener estado y los distintos valores de myAcdSuperv.

'''Ubicación:''' Servidor donde se ejecute myAcdSuperv.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

======zabbixSenderRecordNodo.pl======

'''Uso:''' Obtener estado y los distintos valores de recordNodo.

'''Ubicación:''' Servidor donde se ejecute recordNodo.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

======zabbixSenderRecordCentral.pl======
'''Uso:''' Obtener estado y los distintos valores de recordCentral.

'''Ubicación:''' Servidor donde se ejecute recordCentral.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

A continuación se muestra una tabla resumen de los distintos scripts y sus funcionalidades:

[[Archivo:Zabbix_scripts.png |960px]]

====== Dimensionamiento del servidor (Startpollers) ======
{|
|
|
'''Nota''': EL parámetro StartPollers es un parámetro numérico que forma parte del fichero de configuración
del servidor Zabbix(zabbix_server.conf). Por defecto el servidor Zabbix está configurado para
iniciar con cinco startpollers.
|}

El servidor Zabbix puede hacer peticiones a los agentes de las medidas que necesita o quiere. O en caso contrario los agentes envian en un tiempo determinado la información al servidor. Para recibir todas estas peticiones necesitamos los pollers.

Los poller son los procesos encargados de recibir todas las peticiones de medidas. Aumentaremos su cantidad dependiendo de la necesitad que tengamos. Para ello podemos observar la queue , que es la encargada de almacenar un listado de todas las cosas que están pedidas para medirse y recibirse. SI por ejemplo esta cola (queue) muestra mas de mil medidas seguramente estos pollers sean un cuello de botella y habrá que aumentar su numero.

=====Templates=====

Zabbix cuenta con templates (plantillas) que facilitan la tarea de "Registrar Equipos y Dispositivos" y agregarles métricas; acelerar el despliegue de las tareas de supervisión en un host; aplicar cambios masivos a tareas de supervisión. En '''md'''tel hemos creado plantillas propias que facilitan estos procesos, los cuales necesitaremos [[#Importar templates |importar templates]].

Las plantillas están vinculados directamente a los hosts individuales, por tanto se necesitaran utilizar en cada host.

Automáticamente, cada template rellena por item las aplicaciones, trigers, alarmas,gráficos,... etc.

A continuación, se muestran los distintos bloques de funciones de la instalación en función de cada template:

{| class="wikitable" style="text-align:center;"
|-
! Templates !! Se instalan en general
|-
| DRBD|| SI (si clúster)
|-
| motorSal|| -
|-
| Vivait-Suite ACD|| -
|-
| Vivait-Suite BBDD|| -
|-
| Vivait-Suite Record|| -
|-
| Vivait-Suite GW|| -
|-
| Vivait-Call Asterisk|| -
|-
| Vivait-Call bdCentral|| -
|-
| Vivait-Call bdNodo|| si
|-
| cambiarPerfil_Cal|| -
|-
| Template App Zabbix Server|| -
|-
| Template_OS_Linux*|| si(si no posee ip virtuales de clúster)
|-
| Template_App_MySQL|| si
|-
|}

{| class="wikitable" style="text-align:center;"
|+ '''Dependiendo del tipo de nodo:'''
|-
! Templates !! ACD !! Corporativo/GW
|-
| DRBD|| - || -
|-
| motorSal|| - || -
|-
| Vivait-Suite ACD|| Si || -
|-
| Vivait-Suite BBDD|| - || -
|-
| Vivait-Suite Record|| - || -
|-
| Vivait-Suite GW|| - || Si
|-
| Vivait-Call Asterisk|| - || Si
|-
| Vivait-Call bdCentral|| - || -
|-
| Vivait-Call bdNodo|| - || -
|-
| cambiarPerfil_Cal|| - || -
|-
| Template App Zabbix Server|| - || -
|-
| Template_OS_Linux*|| - || -
|-
| Template_App_MySQL|| - || -
|-
|}

{| class="wikitable" style="text-align:center;"
|+ '''Dependiendo del tipo de Base de dato'''s:
|-
! Templates !! BBDD Tiempo Real !! BBDD Réplica !! BBDD Copia
|-
| DRBD|| - || - || -
|-
| motorSal|| Si(si ACD) || - || -
|-
| Vivait-Suite ACD|| - || - || -
|-
| Vivait-Suite BBDD|| si || si || si
|-
| Vivait-Suite Record|| - || - || -
|-
| Vivait-Suite GW|| - || - || -
|-
| Vivait-Call Asterisk|| - || - || -
|-
| Vivait-Call bdCentral|| si || - || -
|-
| Vivait-Call bdNodo|| - || - || -
|-
| cambiarPerfil_Cal|| - || - || -
|-
| Template App Zabbix Server|| - || - || -
|-
| Template_OS_Linux*|| - || - || -
|-
| Template_App_MySQL|| - || - || -
|-
|}

{| class="wikitable" style="text-align:center;"
|-
! Templates !! Administración
|-
| DRBD|| -
|-
| motorSal|| -
|-
| Vivait-Suite ACD|| -
|-
| Vivait-Suite BBDD|| -
|-
| Vivait-Suite Record|| -
|-
| Vivait-Suite GW|| -
|-
| Vivait-Call Asterisk|| -
|-
| Vivait-Call bdCentral|| -
|-
| Vivait-Call bdNodo|| -
|-
| cambiarPerfil_Cal||SI (si posee servidor calendarios)
|-
| Template App Zabbix Server|| -
|-
| Template_OS_Linux*|| -
|-
| Template_App_MySQL|| -
|-
|}

{| class="wikitable" style="text-align:center;"
|-
! Templates !! Servidor de grabaciones
|-
| DRBD|| -
|-
| motorSal|| -
|-
| Vivait-Suite ACD|| -
|-
| Vivait-Suite BBDD|| -
|-
| Vivait-Suite Record|| Si
|-
| Vivait-Suite GW|| -
|-
| Vivait-Call Asterisk|| -
|-
| Vivait-Call bdCentral|| -
|-
| Vivait-Call bdNodo|| -
|-
| cambiarPerfil_Cal||-
|-
| Template App Zabbix Server|| -
|-
| Template_OS_Linux*|| -
|-
| Template_App_MySQL|| -
|-
|}

{| class="wikitable" style="text-align:center;"
|+ '''Monitorización'''
|-
! Templates !! General !! Contact Center
|-
| DRBD|| - || -
|-
| motorSal|| - || -
|-
| Vivait-Suite ACD|| - || -
|-
| Vivait-Suite BBDD|| - || -
|-
| Vivait-Suite Record|| - || -
|-
| Vivait-Suite GW|| - || -
|-
| Vivait-Call Asterisk|| - || -
|-
| Vivait-Call bdCentral|| - || -
|-
| Vivait-Call bdNodo|| - || -
|-
| cambiarPerfil_Cal|| - || -
|-
| Template App Zabbix Server|| si || -
|-
| Template_OS_Linux*|| - || -
|-
| Template_App_MySQL|| - || -
|-
|}

* El template OS Linux tiene asociado el Template App Zabbix Agent.
Una '''base de datos unificada''' es una base de datos de tiempo real junto a una base de datos de replica

====== Importar templates======

Las plantillas propias de '''md'''tel se encuentran en la ruta "'''/usr/src/nimitz/archivos'''" y empiezan con el nombre de "TemplateXXX.xml".

{|
|-
|
ls /usr/src/nimitz/archivos | grep Template
'''Template DRBD.xml'''
'''Template motorSal.xml'''
'''Templates Vivait-Suite_GW.xml'''
'''Templates Vivait-Suite.xml'''
'''Template Vivait-Call Asterisk.xml'''
'''Template Vivait-Call bdCentral.xml'''
'''Template Vivait-Call bdNodo.xml'''
'''Template Vivait-Call cambiarPerfil_Cal.xml'''

|}

La importación se realizara una vez a través de la web, no hace falta desde el servidor Zabbix, puede ser en cualquier computadora con acceso a la interfaz web de Zabbix.

[[File:ImportarTemplates.png|750px|center]]

Hay opciones varias opciones a elegir para importación de templates, pero podemos dejar por defecto las señaladas y pulsar el botón "import".

===Configuración para un primer funcionamiento de Zabbix===
Se describe una básica configuracion de Zabbix para cualquier equipo que utilice Windows o linux. Pues mediante la definición de hosts, items, triggers y acciones, Zabbix permite efectuar un monitoreo efectivo de plataformas IT heterogéneas.

====Configuración de los equipost (host) para la monitorización====
{|
|-
|
'''Nota''': Tenga en cuenta que debe de estar previamente configurado el agente Zabbix del
dispositivo a ser monitorizado apuntando a la IP del "Servidor Zabbix".
|}
Existen dos tipos de host:
* '''Host físico''': donde la dirección de red que registramos en Zabbix, corresponde al dispositivo que deseamos monitorizar.
* '''Host virtual''': es una dirección IP virtual, que puede relacionarse con un servidor Web, clusters, etc.

[[File:CreacionHost.png|750px|center]]

Las opciones basicas para configurar un host son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center ;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Host Name'''
| | Definir un nombre para el host.
||Se puede utilizar números, letras, espacios y guiones bajos están permitidos.
|-
| font-weight: bold;" | '''Visible Name'''
| | Identificar con un nombre, la maquina a la que se refiere el host.
||Si no tiene valor, se mostrara como nombre "Host Name".
|-
| font-weight: bold;" | '''Groups'''
| | Seleccionar al grupo de host que pertence.Seleccione uno o varios grupos de la caja derecha.
|| Los valores que puede seleccionar por defecto:
Discoverd hosts.

Switches.

Templates.

Templates MDtel.

Zabbix servers.

Linux Servers.

Hypervisors.

Virtual machines.

O crear uno nuevo en '''New group'''.

|-
| font-weight: bold;" | '''Agent interfaces'''
| |Se recomienda usar una dirección IP, en vez de un nombre de la maquina para resolver por un servidor de DNS que puede fallar.
| | 10050 por defecto
|}

Cuando termine, haga clic en nel boton "Save". Su nuevo "Host" debe ser visible en la lista de "Host registrados".Despues el zabbix, intentara configurarse el zabbix para conectarse a la IP.... cada x tiempo hace un barrido.

===== Comprobación de disponibilidad del host=====
Para saber si todo esta bien debemos ver la Z de disponibilidad.

[[File:EstadosZHost.png|750px|center]]

Indicacion de los colores del icono Z:

* Si el icono Z en la columna de disponibilidad es de color rojo, indica que hay un error en la comunicación - mueva el cursor del ratón sobre él para ver el mensaje de error.

* Si el icono es gris, significa que esta en proceso de comunicación con el "Agente Zabbix". Compruebe que el servidor Zabbix está en marcha, y pruebe a actualizar la página más tarde. El tiempo estimado para revisar si existe problemas es de 5 minutos.

* Si el icono es verde, esta funcionando correctamente.

====Indicar que plantilla (template) tendra el host [opcional]====
Tras [[#Importar templates |importar templates]] nos dirigimos al host ya configurado, y en su pestaña de templates pulsamos "add" y añadimos la plantilla/s adecuadas.

====Asignar items al host ====
{|
|-
|
'''Nota''':Un host puede tener un ITEM sin necesitad de tener template.
|}

Todos lo ITEMS se agrupan por HOST, esto significa que cada HOST tiene sus propios "Módulos que recogen datos del Host". Para agregar un nuevo módulo vamos a "Configuration → Hosts" y localizamos el "Host" al cual queremos agregarle un nuevo "Item".

[[File:CrearItemEjemplo.png|750px|center]]

Parametros o campos a rellenar para una configuración básica :

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center ;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Name'''
| | Definir un nombre para el item. Este nombre va a ser nuestro identificador para todas la gestiones en donde lo involucremos como el caso de Triggers.
||
|-
| font-weight: bold;" | '''Type'''
|| Indicar de que entidad queremos recibir informacion.
||Puede ser al "Agente Zabbix" o a el Hardware como impresoras, switch o routers.
|-
| font-weight: bold;" | '''Key'''
| | los "Items" utilizan "Key" que son parámetros de Zabbix. Los "Key" nos permiten indicar específicamente que tipo de información vamos a solicitara a la entidad. Se puede considerar también como el nombre de alguna aplicación.
||
|-
| font-weight: bold;" | '''host interface'''
| |Es la direccion de red del servidor zabbix (puede ser uno o mas)
| |
||
|-
| font-weight: bold;" | '''Units'''
| |Es la dirección de red del servidor zabbix (puede ser uno o mas)
| |
|-
| font-weight: bold;" | '''Type of information'''
| |Tipo de unidades con el que mostrar Zabbix el valor segundos, minutos, euros,....
||
|}

Cuando termine, haga clic en Guardar. El nuevo elemento debe aparecer en la ITEMLIST.
Para mas informacion [[http://entation/1.8/manual/config/items#zabbix_agent. ver documentación Zabbix]]

===== Ver la información recolectada por el item =====
{|
|-
|
'''Nota:''' Normalmente para ver la información lo encontraremos en "Monitoring → Latest data",luego
clic en el signo "+" en "other" siempre que no pertenezca a una aplicación.
En caso contrario, estará bajo el nombre de la aplicación.
|}

Después de definir el "Item" vamos a revisar la información que esta recolectando. . La información comenzará a ser recolectada según el tiempo que le indicamos en el "Item".

[[File:VerInfoITEM.png|750px|center]]

La espera para recibir la información varía dependiendo del tiempo de recolección del item, la mayoría suele ser aproximadamente al minuto de generar el "Item". Zabbix le ofrece la opción de visualizar la información en forma gráfica (sencilla). En el "Item" en lista haga clic en la columna "History - Graph".

[[File:VIsualGraficaValorItem.png|center|750px]]
Si en un caso usted no observa información le recomendamos:

* Ingrese al "Item" y revise que la información del "Key" este igual al ejemplo "system.cpu.load"
* Verifique que el agente este funcionando en el "Servidor a ser monitoreado" y que "El Servidor recolector Zabbix" este funcionando.
* El icono "Z" en el host debe estar en color verde.
* Asegure que esta monitoreando el servidor que le agregó este "Item"

====Configurar los Triggers para los host====
A partir de la información que captura los agentes , el servidor de Zabbix comienza a efectuar la recolección de estos items en la base de datos. Con esto se tiene un registro histórico de tales mediciones, que pueden ser tan simples como un simple ping hasta datos de uso de disco, memoria, cpu, etc.
A partir de los datos que se reciben de los agentes lo que sigue es definir y configurar Triggers, que son evaluaciones que hace Zabix de estos datos para determinar la existencia de un Problema en un dispositivo.
{|
|-
|
Nota: Un trigger necesita una accion, que indica que hacer cuando se activa el trigger.
|}

Un trigger(disparador) es un tipo de reacción ante unas medidas, como un disparador en el que si pasa algo se activa. Los Trigger en Zabbix son módulos que creamos a uno o múltiples "Items" para evaluar o comparar los valores recolectados por los "Items" con condiciones que nosotros definamos. Las condiciones son de tipo aritmético y lógico.

Para configurar un "Trigger o Disparador" seleccionamos "Configuration → Hosts" localizamos el "Host" de ejemplo que creamos y luego hacemos clic en "Trigger", después haga clic en "Create Trigger".

Parametros o campos a rellenar para una configuración básica :

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center ;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Name'''
| | Definir un nombre para el trigger. Este nombre va a ser nuestro identificador para todas la gestiones en donde lo involucremos como el caso de los eventos.
||
|-
| font-weight: bold;" | '''Expression'''
|| Hay que indicar para que medida se crea (item) y sus funciones con los parametros adecuados. '''''Recomendación usar expression constructor que pedirá siempre al crearlo, para que item es y sus funciones...'''''
||Ejemplo: {New host:system.cpu.load.avg(180)}>2
|-
| font-weight: bold;" | '''Key'''
| | los "Items" utilizan "Key" que son parámetros de Zabbix. Los "Key" nos permiten indicar específicamente que tipo de información vamos a solicitara a la entidad. Se puede considerar tambien como el nombre de alguna aplicacion.
||
|-
| font-weight: bold;" | '''Descripción'''
| | Una descripción breve sobre el trigger.
||
|-
| font-weight: bold;" | '''Severity'''
| | everidad distinguida por colores,
|| No classified
Information
Warning
Average
High
Disaster
|}

===== Comprobar el estado del trigger =====
Podemos ver el estado del "Trigger" en "Monitoring → Triggers".El color en caso de que se active depende de la severidad definida. Por ejemplo, si el "Trigger" esta en color verde indica que el resultado de la métrica se mantiene por debajo de la condición que indicamos. Por el contrario si el resultado esta "sobre lo indicado" su color sera rojo.

[[File:EstadoTrigger.png|center|750px]]

====Asociar un Action al trigger====

Una action(acción) sirve para configurar un mensaje de alerta o una accion para Zabbix, ante un problema. Hay varias formas de gestionar un problema a través de una acción:

# A través de mensajes simples, alertando al instante.
# Escalar los mensajes hacia el jefe y/o otros grupos.
# Ejecución de commandos remotos.
# Notificaciones repetidas hasta que se resuelve el problema.
# Notificaciones y comandos retardados.
# Escenario complejo, la combinación de todo lo anterior.

Para crear una configuración en "Configuration-Actions". La explicación esta en la [[ https://www.zabbix.com/documentation/2.0/manual/config/notifications/action documentación de Zabbix]].
-->

== Integraciones con servicios externos ==

=== Presencia con Openfire ===
'''''VIVA'''''it se integra con servidor XMPP Openfire en su versión 3.10.2 (última probada)

Además del servidor, es necesario instalar un plugin de integración con asterisk 13, denominado "asterisk IM", versión 1.4.1

La instalación del servidor Openfire es una instalación estándar, realizada de paquete

La instalación del plugin es un "jar" que se carga desde la pagina de plugins de openfire

Con esto conseguiremos comunicar asterisk y OPenfire de manera que:
*Los estados telefónicos de una extensión '''''VIVA'''''it se reflejen en Openfire
*Poder marcar desde los clientes de IM instalados en los puestos
*Ver en el cliente llamadas entrantes al teléfono

-----

'''<big>Enlaces de interes:</big>'''

[http://www.igniterealtime.org/projects/openfire/ Página proyecto openfire]

[https://community.igniterealtime.org/thread/56076 Página proyecto "asterisk IM"]

=== Reuniones virtuales con Openmeetings ===
'''OpenMeetings''' es un sistema de vídeo web-conferencia en tiempo real. Usando recursos como audio (micrófono), vídeo (cámara web), posibilidad de subir y convertir presentaciones (en PDF , PPT o ODP que se convierten a Flash), compartición de la pantalla de tu ordenador, o pizarra digital compartida, panel de administración, posibilidad de grabar las sesiones… y completo soporte multiplataforma, es decir, que aparte de poder grabar las sesiones, se puede compartir un escritorio también desde una máquina Linux.

Para instalar '''OpenMettings''' debe seguir el [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manuales_de_instalaci%C3%B3n#Instalaci.C3.B3n_de_Openmeetings | manual de Instalación de Openmeetings]]

[[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:VIVAit Suite]]

Manual de operación plataforma VIVAit

2018-04-24T08:42:26Z

Imatarrubias: /* motorSal */

{| class="wikitable"
|-
! '''Producto: '''!! '''''VIVA'''''it Call
'''''VIVA'''''it Suite
|-
|}

== Introducción ==

En este documento se describe la arquitectura general de la plataforma '''''VIVA'''''it, detallando aquellos procesos principales que componen cada uno de los elementos del sistema, y sus principales elementos de diagnóstico
Quedan fuera del ámbito de este documento:
* Uso de aplicación de agente ('''''VIVA'''''it Desk)
* Uso de aplicación de supervisor ('''''VIVA'''''it Supervisor), incluyendo sus módulos autónomos ('''''VIVA'''''it reporting, '''''VIVA'''''it Tracker)
* Uso de portal de administración
* Uso de portal de traceo de llamadas y agentes ('''''VIVA'''''it Tracker web)
* Uso de portal de monitorización zabbix

== Arquitectura ==

[[Archivo:Arquitectura plataforma VIVAit.png|center|700px]]

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

== Descripción de los elementos, diagnósticos y operaciones ==
Las siguientes tablas definen los principales elementos software de la plataforma '''''VIVA'''''it, que son detallados en apartados siguientes:

{| class="wikitable"
|-
|+ <big>'''Nivel de sistema operativo'''</big>
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
| Ubuntu Server LTS 64 bits || Uno por servidor|| ||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
|| Actualmente (Oct-2015) 14.04
Bajo proyecto puede cambiarse
|-
| Almacenamiento de grabaciones|| Uno por sistema|| Almacenamiento de las grabaciones, ya sean de entorno corporativo o de contact center||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
|| Típicamente un espacio grande de almacenamiento proporcionado por el cliente y que se monta como un sistema de archivos local en los servidores de la plataforma
Pueden existir sistemas secundarios de almacenamiento de grabaciones
|-
|-
|}

{| class="wikitable"
|-
|+ <big>'''Nivel de conmutación de voz'''</big>
|-
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
|Asterisk 1.4.24 by MDtel||Uno por servidor ACD||Núcleo de conmutación de voz basado en Asterisk 1.4 y modificado por MDtel||'''''VIVA'''''it Suite||Fuertemente modificado por MDtel
En el futuro migrará a Asterisk 13 Certified
|-
|Dialplan ACD by MDtel||Uno por servidor ACD||Configuración de voz||'''''VIVA'''''it Suite||En el futuro se unificará con corporativa
|-
|Asterisk 13 Certified by MDtel||Uno por servidor corporativo/gateway||Núcleo de conmutación de voz basado en Asterisk 13 y modificado por MDtel||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Actualmente asterisk estándar (10/15)
La instalación contempla descargar de la red el más actualizado, siempre CERTIFIED"
|-
|Dialplan corporativo||Uno por servidor corporativo/gateway||Configuración de voz||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||En el futuro se unificará con ACD
|-
|}

{| class="wikitable"
|-
|+ <big>'''Nivel de base de datos'''</big>
|-
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
|MySQL 5.5||Donde haya BBDD de cualquier tipo (incluso zabbix)||Motor de Base de Datos||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||A efectos prácticos va a ser en todos los servidores con casi total seguridad
|-
|BBDD tiempo real||Una por sistema||Base de Datos sobre la que trabaja todo el entorno de tiempo real||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
|-
|BBDD réplica||Una por sistema multinodo||Base de Datos para acceso a información de reporting…y similar||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Bajo proyecto puede existir más de una
En el nodo en el que exista réplica existirá además copia (excepto nodo ACD)
|-
|BBDD copia||Uno por servidor corporativo/gateway||Copias de tablas de configuración para respaldo de la misma||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Local en cada nodo
Los nodos de ACD actualmente no trabajan con copia; en caso de fallo de BBDD TR se usa el modo emergencia
|-
|}

{| class="wikitable"
|-
|+ <big>'''Nivel de procesos ''VIVA''it'''</big>
|-
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
|Intz-Nimitz||Donde haya una BBDD de tiempo real o copia||Interfaz entre el dialplan y la base de datos||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||No donde haya BBDD de réplica
Sistemas grandes pueden contemplar mas de un intz-nimitz central"
|-
|vivait-cti||Uno por servidor ACD||Interfaz entre '''''VIVA'''''it Desk, supervisor y el manager de asterisk||'''''VIVA'''''it Suite||
|-
|myAcdSuperv||Uno por servidor ACD||Recopilador de datos de asterisk y actualiza en la BBDD
Genera llamadas en el marcador
||'''''VIVA'''''it Suite
||
|-
|motorSal||Uno por sistema con ACD||Motor de marcador saliente automático||'''''VIVA'''''it Suite||Solo si hay marcación saliente
Junto a la BBDD de tiempo real
|-
|recordCentral||Uno por sistema||Servidor de grabaciones, se conectan los agentes a el||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Se arrancan varias instancias en función del número de nodos
Debe instalarse en un servidor que tenga el almacenamiento de grabaciones en su sistema de archivos
|-
|recordNodo||Uno por servidor corporativo/gateway||Agente de grabación||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|bdCentral||Uno, en el nodo con la BBDD de tiempo real||Genera la base de datos que se copiará para respaldo a otros nodos||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|bdNodo||En cada nodo con BBDD de copia||Recoge la base de datos del servidor central con el objeto de tener el respaldo||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|Actualizador||Uno por sistema con ACD||Se encarga de proporcionar las versiones actualizadas de las aplicaciones de puesto de trabajo||'''''VIVA'''''it Suite||En el mismo servidor que el portal de administración
|-
|phoneProv-tftp||Uno por sistema||Se encarga del aprovisionamiento masivo de terminales||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||En instalaciones grandes habrá más de uno, quizás uno por sede grande; depende de la infraestructura de DHCP
|-
|borraregistrosnimitz||||||||
|-
|Mover grabaciones a nube||||||||
|-
|}

{| class="wikitable"
|-
|+ <big>'''Administración'''</big>
|-
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
|Tomcat 7||Uno por servidor con portales||Servidor de aplicaciones JAVA||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
|-
|Portal de administración ||Uno por sistema||Portal de administración del sistema||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Bajo proyecto puede existir más de uno
|-
|Portal usuario||Uno por sistema||Portal de usuario, para acceso a buzones, su configuración||'''''VIVA'''''it Call||Bajo proyecto puede existir más de uno
|-
|Tracker web||Uno por sistema||Portal de seguimiento de llamadas||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Debe instalarse en un servidor que tenga los ficheros de grabación montados en su sistema de archivos
Ligado a recordCentral
Bajo proyecto puede existir más de uno
|-
|Monitor||Uno por sistema||Portal de monitores de pared de Call Center||'''''VIVA'''''it Suite||Bajo proyecto puede existir más de uno
|-
|Apache||Uno por servidor de calendarios||Servidor de portales WEB||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|Servidor de calendarios||Uno por sistema||Aloja calendarios para su uso en diferentes entornos de NIMITZ||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Bajo proyecto puede existir más de uno
|-
|}

{| class="wikitable"
|-
|+ <big>'''Monitorización'''</big>
|-
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
|Servidor zabbix||Uno por instalación||Monitorización técnica y de negocio||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Bajo proyecto puede existir más de uno
Tipicamente irá o en BBDD replica o en nodo de gestión en instalaciones grandes
|-
|Templates zabbix||Uno por instalación||Adaptaciones específicas||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|Agente Zabbix||Uno por servidor||Agente de monitorización||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
||Scripts monitorización zabbix||Uno por servidor||Agente de monitorización||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|}
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

===Versiones de módulos===

{| class="wikitable"
|-
! Módulo !! VSuite
V.3.10
! VSuite
V.3.2.0
! VSuite
V.3.3.0
! VIVAit V.3.0.0
(VSuite 3.4+VCall3.0)
! VIVAit V.3.1.0
(VSuite 3.5+VCall3.1)
|-
| Sistema Operativo || || || ||
|| Ubuntu 14.0.4
Server 64 Kb
|-
| Asterisk || 1.4 || 1.4 || 1.4 || 1.4 Nodo ACD
13 resto nodos
|| 1.4 Nodo ACD
13 resto nodos
|-
| Asterisk ACD '''(VS)''' || || || || 3.3.1 || 3.4.1
|-
| Dialplan ACD '''(VS)''' || || || || || 3.5.0
|-
| Asterisk Corp '''(C)''' || || || || 3.3.4 || 3.4.4
|-
| Asterisk Cisco '''(VC)''' || || || || 3.3.4 || 3.4.4
|-
| Dialplan Corp '''(C)''' || || || || 3.3.1 || 3.5.0
|-
| Lazarus común '''(VS)''' || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0 || 3.5.0
|-
| BD '''(C)''' || 3.2.0 || 3.4.0 || 3.5.0 || 3.6.0 || 3.8.0
|-
| Generaconf '''(C)''' || 3.0.0 || 3.0.0 || 3.2.0 || 3.4.0 || 3.5.0
|-
| Instalador '''(C)''' || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0 || 3.5.0
|-
| Intz-nimitz '''(C)''' || 2.6.0 || 3.0.1 || 3.0.3 || 3.4.1 || 3.4.2
|-
| recordgwd '''(C)''' || 1.3.0 || 1.3.0 || 3.1.0 || ----- || -----
|-
| recordNodo '''(C)''' || ----- || ----- || ----- || 4.0.0 || 4.0.0
|-
| recordprocesad '''(C)''' || 1.2.0 ||1.2.0|| 3.0.0 || ----- || -----
|-
| recordCentral '''(C)''' || ----- || ----- || -----|| 4.0.0 || 4.0.1
|-
| MyACDSuperv '''(VS)''' || 5.2.0 || 5.3.0 || 5.3.0 || 5.3.2 || 5.3.2
|-
| Motorsal '''(VS)''' || 1.4.0 || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0
|-
| Vivait-cti '''(VS)''' || 3.0.0 || 3.0.1 || 3.0.1 || 3.0.1 || 3.0.2
|-
| Multimonitorweb '''(VS)''' || 3.0.1 || 3.0.2 || 3.1.0 || 3.1.0 || 3.2.0
|-
| Portal de administración '''(C)''' || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0 || 3.5.0
|-
| Tracker Web '''(C)''' || 3.0.2 || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0
|-
| VIVA supervisor '''(VS)''' || 3.0.0 || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0
|-
| Tracker windows '''(C)''' || 3.0.0 || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0
|-
| VIVA report '''(VS)''' || 1.2.0 || 3.1.0 || 3.2.0 || 3.2.2 || 3.3.0
|-
| VIVA desk '''(VS)''' || 3.0.2 || 3.2.0 || 3.3.0 || 3.4.0 || 3.5.0
|-
| VIVA designer '''(VS)''' || 1.0.23 || 3.0.1 || 3.1.0 || 3.1.0 || 3.2.0
|-
| Preview '''(VS)''' || 1.0.18 || 3.2.0 || 3.3.0 || 3.4.0 || 3.5.0
|-
| Phone_prov '''(C)''' || ------ || ------ || 3.0.1 || 3.0.3 || 3.0.3
|-
| Portal usuario '''(VC)''' || ------ || ------ || ------ || 3.0.0 || 3.1.0
|}

'''(C)''': Módulo común

'''(VC)''': Módulo de VIVAit Call

'''(VS)''': Módulo de VIVAit Suite

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Sistema Operativo ===
Los sistemas operativos de nuestra plataforma se corresponden a las versiones de Ubuntu Server LTS , ya que son las versiones estables, con un soporte continuado y mas estables a actualizaciones desde la salida Ubuntu 14.04.1. En concreto el sistema operativo utilizado para la plataforma '''''VIVA'''''it es Ubuntu Server 14.04.4 LTS. Para más información https://help.ubuntu.com/lts/serverguide/index.html.

[[Archivo:Ubuntu Kernel Release Schedule.png|750px]]

==== Funcionamiento en cluster ====

Un clúster es un grupo de múltiples ordenadores unidos mediante una red de alta velocidad, de tal forma que el conjunto es visto como un único ordenador.

De un clúster se espera que presente combinaciones de los siguientes servicios:

# Alto rendimiento
# Alta disponibilidad
# Balanceo de carga
# Escalabilidad

Tal y como esta definido el cluster de MDtel, este comprueba conectividad con la otra máquina que lo forma y con un punto de confianza. Si la máquina no tiene conectividad con la otra y si con el punto de confianza es que el servidor está vivo, mientas que si no tengo conectividad ni con la otra máquina ni con el punto de confianza es que el muerto soy yo, por lo que balanceo.

Por lo que las máquinas balancean en los casos siguientes:

* Todo lo que tenga que ver con la red, es decir, caída de la tarjeta de red, apagado de la máquina, corte en la red..

Y no balancea en los siguientes:

* No balancea en los demás casos, es decir, todo lo que tenga que ver con procesos de una máquina (caída asterisk, base de datos, intz-nimitz)

El funcionamiento en cluster se basa en:

* Heartbeat: IP flotante entre las dos máquinas que componen el cluster; típicamente este "latido" entre máquinas se realizará mediante conexión directa con cable cruzado para asegurar que no existan problemas de comunicaciones tales como retardo, pérdida de paquetes, etc en este latido y pueda ser causa de un balanceo inadecuado.

{| class="wikitable"
|-
| '''Nota 17-11-2015:''' Se ha realizado en un cliente un cluster distribuido, con dos servidores en diferentes sedes, realizando el heartbeat mediante enlace Gigabit. Si bien la solución no está validada por desarrollo, se está observando el funcionamiento.
|}

* DRBD se encargar de mantener una serie de carpetas totalmente replicadas entre los dos nodos; dichas carpetas son:

El cluster es <big>'''activo/pasivo'''</big>; la máquina activa posee la IP flotante y tiene arrancados los servicios.

==== Configuración del cluster ====
Para montar un cluster de asterisk partimos de la siguiente situación inicial:
* Dos maquinas con '''''VIVA'''''it Call 3.0 instalado.
* El driver bonding de Interfaces de Red en Ubuntu Server.

Los pasos a seguir para la configuración en el Ubuntu Server son los siguientes:
* Instalar ifenslave:
:{|
|-
|
aptitude install ifenslave.
|}
: Finalizada la instalación, comprobamos que la instalación de Bonding se ha configurado para empezar desde el arranque del sistema operativo desde el fichero '''/etc/modules''':
:{|
|-
| vi /etc/modules
# /etc/modules: kernel modules to load at boot time.
#
# This file contains the names of kernel modules that should be loaded
# at boot time, one per line. Lines beginning with "#" are ignored.
# Parameters can be specified after the module name.
lp
rtc
bonding
|}

* Crear o editar el archivo llamado '''/etc/modprobe.d/bonding.conf''' y añadir la siguiente linea en negrita:
:{|
|-
|
echo "alias bond0 bonding"> /etc/modprobe.d/bonding.conf
|}

* Editar el fichero /etc/network/interfaces y añadir lo que esta en negrita:
:{|
|-
|
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).
# The loopback network interface
auto lo
iface lo inet loopback

'''# Bonding'''

'''#em1 ip manual y esclavo en el "bond0" NIC'''
'''auto em1'''
'''iface em1 inet manual'''
'''bond-master bond0'''
'''bond-primary em0'''

'''#em2 ídem, creando así un vínculo de enlace 2.'''
'''auto em2'''
'''iface em2 inet manual'''
'''bond-master bond0'''
'''auto bond0'''
'''iface bond0 inet static'''
'''address 10.255.255.11'''
'''netmask 255.255.255.0'''
'''gateway 10.255.255.254'''
'''bond-mode active-backup'''
'''bond-miimon 100'''
'''bond-slaves none'''

'''# em3 replica entre servidores'''
'''auto em3'''
'''iface em3 inet static'''
'''address 10.255.254.10'''
'''netmask 255.255.255.0'''

'''# em4 gestion'''
'''auto em4'''
'''iface em4 inet static'''
'''address 172.17.47.255'''
'''netmask 255.255.0.0'''
|}

* Reiniciamos el sistema para que el kernel tome los cambios.

* Comprobación que en las dos maquinas el archivo '''/etc/host''' contenga el los nombre de las dos maquinas a vincular. En el ejemplo el archivo en ambas maquinas es:

:{|
|-
|
127.0.0.1 localhost

10.255.255.11 vivaitcall-CL-UAH-1

10.255.255.12 vivaitcall-CL-UAH-2

10.255.255.10 vivaitcall-CL-UAH

10.255.255.10 BDTR

10.255.254.10 vivaitcall-CL-UAH-1-em3

10.255.254.11 vivaitcall-CL-UAH-2-em3
|}

* Creamos dos particiones iguales en ambos ordenadores , usando el comando '''parted'''.
:{|
|-
|
root@vivaitcall-CL-UAH-1:~# '''parted /dev/sda'''
GNU Parted 2.3
Using /dev/sda
Welcome to GNU Parted! Type 'help' to view a list of commands.
(parted) p free
Model: HP LOGICAL VOLUME (scsi)
Disk /dev/sda: 1000GB
Sector size (logical/physical): 512B/512B
Partition Table: gpt
Number Start End Size File system Name Flags
17,4kB 262kB 245kB Free Space

1 262kB 1000MB 1000MB fat32 boot
2 1000MB 201GB 200GB ext4
3 201GB 217GB 16,0GB linux-swap(v1)
4 217GB 237GB 20,0GB ext4
237GB 1000GB 763GB Free Space

(parted) mkpart primary 237GB 1000GB
(parted) p free
Model: HP LOGICAL VOLUME (scsi)
Disk /dev/sda: 1000GB
Sector size (logical/physical): 512B/512B
Partition Table: gpt
Number Start End Size File system Name Flags
17,4kB 262kB 245kB Free Space
1 262kB 1000MB 1000MB fat32 boot
2 1000MB 201GB 200GB ext4
3 201GB 217GB 16,0GB linux-swap(v1)
4 217GB 237GB 20,0GB ext4
5 237GB 1000GB 763GB primary  No File System como ext4
1000GB 1000GB 204kB Free Space
(parted)quit
mkfs.ext4 /dev/sda5
root@vivaitcall-CL-UAH-1:~# '''parted /dev/sda'''
GNU Parted 2.3
Using /dev/sda
Welcome to GNU Parted! Type 'help' to view a list of commands.
(parted) p free
Model: HP LOGICAL VOLUME (scsi)
Disk /dev/sda: 1000GB
Sector size (logical/physical): 512B/512B
Partition Table: gpt
Number Start End Size File system Name Flags
17,4kB 262kB 245kB Free Space
1 262kB 1000MB 1000MB fat32 boot
2 1000MB 201GB 200GB ext4
3 201GB 217GB 16,0GB linux-swap(v1)
4 217GB 237GB 20,0GB ext4
5 237GB 1000GB 763GB primary
1000GB 1000GB 204kB Free Space
(parted) rm 5
(parted) mkpart primary 237GB 1000GB
(parted) p free
Model: HP LOGICAL VOLUME (scsi)
Disk /dev/sda: 1000GB
Sector size (logical/physical): 512B/512B
Partition Table: gpt

Number Start End Size File system Name Flags
17,4kB 262kB 245kB Free Space
1 262kB 1000MB 1000MB fat32 boot
2 1000MB 201GB 200GB ext4
3 201GB 217GB 16,0GB linux-swap(v1)
4 217GB 237GB 20,0GB ext4
5 237GB 1000GB 763GB ext4 primary  Si File Sytem ext4
1000GB 1000GB 204kB Free Space
(parted)quit
|}

* Instalar los paquetes necesarios para el drbd. '''En Ubuntu server 14.04 ya está instalado.'''
:{|
|-
|
aptitude install drbd8-utils
aptitude update (si no instala el drbd8-utils actualizar)
aptitude install drbd8-utils (volver a lanzar)
|}

* Creamos el archivo '''/etc/drbd.conf''' en ambas maquinas:
:{|
|-
|
# You can find an example in /usr/share/doc/drbd.../drbd.conf.example
include "drbd.d/global_common.conf";
include "drbd.d/*.res";
resource MDcluster {
protocol C;
on vivaitcall-CL-UAH-1 {
device /dev/drbd0;
disk /dev/sda5;
address 10.255.254.10:7788;
meta-disk internal;
}
on vivaitcall-CL-UAH-2 {
device /dev/drbd0;
disk /dev/sda5;
address 10.255.254.11:7788;
meta-disk internal;
}
disk {
on-io-error detach;
}
net {
max-buffers 2048;
ko-count 4;
}
syncer {
rate 100M;
al-extents 257;
}
startup {
wfc-timeout 0;
degr-wfc-timeout 120;
}
}
|}

* Reiniciamos el sistema para que el kernel tome los cambios.
* Inicializamos el recurso, para ello primero deberemos crear los recursos DRBD teclearemos en ambas maquinas. Desde /etc.
:{|
|-
|
drbdadm create-md MDcluster (no y yes )
|}

:Si tenemos algún problema porque ya exista sistema de ficheros.
:{|
|-
|
dd if=/dev/zero of=/dev/sda5 bs=1M count=128
drbdadm create-md MDcluster (no y yes )
|}

* Reiniciamos ambas maquinas para que su kernel tome los cambios.
* Levantamos el servicio del DRBD en ambos servidores (nos preguntara que si queremos enviar los datos a los desarrolladores de drbd) tecleando no, no se envían.
:{|
|-
|
service drbd start
/etc/init.d/drbd start
|}

: Ahora ambas maquinas son secundarias.
: Indicar cual de las dos maquinas usaremos como primaria, por tanto en la maquina elegida habra que ejecutar:
:{|
|-
|
drbdadm -- --overwrite-data-of-peer primary all (en una máquina)
:'''Nota:''' La ip virtual que va a estar asignada a la maquina activa es 172.25.129.70.

|}

: Podemos teclear el comando '''''cat''''' para ver si esta sincronizando y su progreso:

:{|
|-
|
cat /proc/drbd
'''Nota:''' El servicio DRBD aparecera como '''''Primary/Secondary''''' si ejecutamos en el primario ;
y aparecerá ''''Secondary/Primary'''' si lo ejecutamos en el secundario. 
|}

* Instalación de los script de arranque:
:{|
|-
|
update-rc.d -f drbd remove (en las dos maquinas)
update-rc.d drbd start 13 2 3 4 5 . stop 87 0 1 6 . (en las dos máquinas)
|}
* Seleccionar la fuente de sincronización.
:Formateamos un disco de la maquina que queramos que funcione como fuente del servicio DRBD, para evitar conflictos:
:{|
|-
|
mkfs.ext4 /dev/drbd0
|}
: Creamos el directorio sobre el que vamos a montar el disco, en ambas maquinas.
:{|
|-
|
mkdir /HDcluster
|}

: Creamos un archivo dentro '''''/HDcluster''''' de que se verá solo cuando el disco no está montado en ambas maquinas.
:{|
|-
|
touch sinMontar
'''Nota:''' Este archivo nos puede servir para monitorizar mediante zabbix, nagios, ... que el disco no está montado.
|}

: En una de las maquinas montamos el disco (desde fuera del directorio HDcluster)
:{|
|-
|
mount /dev/drbd0 /HDcluster
|}
* Procedemos a mover todos los datos que necesitemos en este disco y a crear accesos directos, los directorios que vamos a mover son los siguientes:
:{|
|-
|
/etc/asterisk
/var/lib/asterisk
/usr/lib/asterisk
/usr/spool/asterisk
/var/lib/mysql
/var/tftp/
|}
: El procedimiento que vamos a seguir es el siguiente, en el primer ordenador:
:{|
|-
|
'''Cd /HDcluster'''
'''tar -zcvf etc-asterisk.tgz /etc/asterisk'''
'''tar -zxvf etc-asterisk.tgz'''
'''rm -rf /etc/asterisk'''
'''ln -s /HDcluster/etc/asterisk /etc/asterisk'''
'''tar -zcvf var-lib-asterisk.tgz /var/lib/asterisk'''
'''tar -zxvf var-lib-asterisk.tgz'''
'''rm -rf /var/lib/asterisk'''
'''ln -s /HDcluster/var/lib/asterisk /var/lib/asterisk'''
'''tar -zcvf usr-lib-asterisk.tgz /usr/lib/asterisk'''
'''tar -zxvf usr-lib-asterisk.tgz'''
'''rm -rf /usr/lib/asterisk'''
'''ln -s /HDcluster/usr/lib/asterisk /usr/lib/asterisk'''
'''tar -zcvf var-spool-asterisk.tgz /var/spool/asterisk'''
'''tar -zxvf var-spool-asterisk.tgz'''
'''rm -rf /var/spool/asterisk'''
'''ln -s /HDcluster/var/spool/asterisk /var/spool/asterisk'''
'''tar -zcvf var-lib-mysql.tgz /var/lib/mysql'''
'''tar -zxvf var-lib-mysql.tgz'''
'''rm -rf /var/lib/mysql'''
'''ln -s /HDcluster/var/lib/mysql /var/lib/mysql'''
'''tar -zcvf var-lib-phoneprov-tftp.tgz /var/lib/phoneprov-tftp/'''
'''tar -zxvf var-lib-phoneprov-tftp.tgz'''
'''rm -rf /var/lib/phoneprov-tftp/'''
'''ln -s /HDcluster/var/lib/phoneprov-tftp /var/lib/phoneprov-tftp'''
|}

: En la segunda maquina debemos borrar los directorios y crear los accesos directos.
:{|
|-
|
'''rm -rf /etc/asterisk'''
'''ln -s /HDcluster/etc/asterisk /etc/asterisk'''
'''rm -rf /var/lib/asterisk'''
'''ln -s /HDcluster/var/lib/asterisk /var/lib/asterisk'''
'''rm -rf /usr/lib/asterisk'''
'''ln -s /HDcluster/usr/lib/asterisk /usr/lib/asterisk'''
'''rm -rf /var/spool/asterisk'''
'''ln -s /HDcluster/var/spool/asterisk /var/spool/asterisk'''
'''rm -rf /var/lib/mysql'''
'''ln -s /HDcluster/var/lib/mysql /var/lib/mysql'''
'''rm -rf /var/lib/phoneprov-tftp'''
'''ln -s /HDcluster/var/lib/phoneprov-tftp /var/lib/phoneprov-tftp'''
|}

* Configurar heartbeat para las dos maquinas.
: Instalamos heartbeat en las dos maquinas. '''En UBUNTU Server 14.04 ya está instalado.'''
:{|
|-
|
aptitude install heartbeat
|}
: Debemos modificar 3 ficheros en cada una de las maquinas, estos se encuentran en '''/etc/ha.d'''. El primer fichero a modificar es '''''ha.cf.''''':
:: En la maquina ''vivaitcall-CL-UAH-1'' es:
::{|
|-
|
root@vivaitcall-CL-UAH-1:~# cat /etc/ha.d/ha.cf
'''# Explicacion en /usr/share/doc/heartbeat/ha.cf.gz'''

'''udpport 694'''
'''baud 19200'''
'''auto_failback off'''
'''use_logd yes'''
'''crm no'''

'''# Temporizaciones en segs'''
'''logfacility local0'''
'''keepalive 2'''
'''deadtime 8'''
'''warntime 16'''
'''initdead 64'''
'''deadping 6'''

'''#ucast bond0 vivaitcall-CL-UAH-1'''
'''ucast bond0 vivaitcall-CL-UAH-2'''

'''#ucast em3 vivaitcall-CL-UAH-1-em3'''
'''ucast em3 vivaitcall-CL-UAH-2-em3'''

'''#Ping a puerta de enlace,gw1,gw2,gw3,gw4'''
'''ping_group red_local 10.255.255.12'''

'''respawn hacluster /usr/lib/heartbeat/ipfail'''
'''apiauth ipfail gid=haclient uid=hacluster'''

'''node vivaitcall-CL-UAH-1'''
'''node vivaitcall-CL-UAH-2'''
|}

:: Y en la maquina ''vivaitcall-CL-palacio-2'' es:
::{|
|-
|
root@vivaitcall-CL-UAH-1:~# cat /etc/ha.d/ha.cf
'''# Explicacion en /usr/share/doc/heartbeat/ha.cf.gz'''

'''udpport 694'''
'''baud 19200'''
'''auto_failback off'''
'''use_logd yes'''
'''crm no'''

'''# Temporizaciones en segs'''
'''logfacility local0'''
'''keepalive 2'''
'''deadtime 8'''
'''warntime 16'''
'''initdead 64'''
'''deadping 6'''

'''ucast bond0 vivaitcall-CL-UAH-1'''
'''#ucast bond0 vivaitcall-CL-UAH-2'''

'''ucast em3 vivaitcall-CL-UAH-1-em3'''
'''#ucast em3 vivaitcall-CL-UAH-2-em3'''

'''#Ping a puerta de enlace gw1 gw2 gw3 gw4'''
'''ping_group red_local 10.255.255.12'''

'''respawn hacluster /usr/lib/heartbeat/ipfail'''
'''apiauth ipfail gid=haclient uid=hacluster'''

'''node vivaitcall-CL-UAH-1'''
'''node vivaitcall-CL-UAH-2'''
|}
::'''Nota:''' El parámetro '''auto_failback''' se utiliza para indicar si queremos que al recuperarse una maquina adquiera los recursos sobre los que tiene prioridad.
:El segundo fichero es '''''authkeys''''',, este fichero es el mismo en ambas maquinas:
:{|
|-
|
chmod 600 authkeys '''(importante)'''
auth 1
1 sha1 claveSecretaATope
|}

:El tercer fichero '''haresources''', donde especificaremos en las dos maquinas que deben apuntar a la maquina que queremos que tenga prioridad en la adquisición de los recursos, este fichero es el mismo en las dos maquinas:
:{|
|-
|
MÁQUINA 1 -> vivaitcall-CL-palacio-1 hb_mdtel
MÁQUINA 2-> vivaitcall-CL-palacio-1 hb_mdtel
|}
: Copiaremos en el directorio '''/etc/ha.d/resource.d/''' los scripts de arranque con permisos 755 (lo podemos hacer mediante WINSCP). Los scripts se encuentran en '''''C:\Documents and Settings\javier.gutierrez.MDTEL\Mis documentos\Centrales\Asterisk\Cluster\scripts'''''.
:{|
|-
|
chmod 755 hb_catalina
chmod 755 hb_mdtel
chmod 755 hb_mdtel_firewall
|}
: Deberemos editar el archivo '''hb_mdtel'''
:{|
|-
|
(IP flotante a.b.c.d./mask) 10.255.255.10
CAD_IP_FLOTA=10.255.255.10/24/bond0
|}
:

* Paramos el proceso '''myAcdSuperv'''.
:{|
|-
|
mv /etc/rc2.d/S02myAcdSuperv s02myAcdSuperv
|}
* Reiniciamos ambas maquinas para que su kernel tome los cambios.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== Comprobación de buen funcionamiento del cluster ====
* La maquina activa tiene que tener en HDcluster montado el disco con todos sus directorios y la maquina inactiva no (tenemos que ver el archivo que hemos creado "sinMontar").
* La ip virtual tiene que estar en la maquina activa (ifconfig) y no tiene que estar en la inactiva.
* El asterisk tiene que estar arrancado en la maquina activa y parado en la inactiva.
* Tecleando la ip de la maquina activa en un navegador debemos acceder al portal de vivait-call y en la inactiva no debe de estar activo.
* Para cambiar el cluster manualmente podemos utilizar los siguientes comandos:
:{|
|-
|
/usr/share/heartbeat/hb_takeover
|}
: La maquina desde la que se ejecuta se convierte en la maquina activa
:{|
|-
|
/usr/share/heartbeat/hb_standby
|}
: La maquina desde la que se ejecuta deja de ser la maquina activa

==== Notas para MySQL ====
Si mysql es parte del cluster tenemos que tener en cuenta dos cosas:

* El archivo '''/etc/mysql/debían.cnf''' contiene una clave que debe ser igual en ambas maquinas y debe ser la clave de la máquina de donde cojamos la base de datos. 
:{|
|-
|
# Automatically generated for Debian scripts. DO NOT TOUCH!
[client]
host = localhost
user = debian-sys-maint
password = AI6AdPtnhLUrNm1S
socket = /var/run/mysqld/mysqld.sock
[mysql_upgrade]
user = debian-sys-maint
password = AI6AdPtnhLUrNm1S
socket = /var/run/mysqld/mysqld.sock
basedir = /usr
|} 
* El archivo '''/etc/apparmor.d/usr.sbin.mysqld''' contiene donde pueden estar ubicados los archivos de mysql, al cambiar su ubicación y poner un enlace directo en /var/lib/mysql si no modificamos este archivo mysql no arrancara al no tener la nueva ubicación entre sus localizaciones permitidas. Este es un ejemplo de las líneas que debemos añadir. 
:{|
|-
|
/var/run/mysqld/mysqld.sock w, (copiar después de esta linea)

#//!!
/HDcluster/var/lib/mysql/ r,
/HDcluster/var/lib/mysql/** rwk,
#//!!
|}

==== Notas de desincronización ====
EL servicio del DRBD esta iniciado pero al teclear el comando cat /proc/drbd para ver si esta sincronizando se presenta "'''primary/unknown" y/o secondary/unknown''' ".
* En el nodo primary
:{|
|-
|
drbdadm connect all
|}

* En el nodo secondary
:{|
|-
|
drbdadm disconnect all
drbdadm -- --discard-my-data connect all
|}

==== Adaptar red a cliente ====
Para adaptar la red de los equipos al entorno del cliente hay que editar los siguientes ficheros:
{|
|-
|
/etc/network/interfaces
/etc/resolv.conf
/etc/hosts
/etc/ha.d/resource.d/hb_mdtel
/etc/ha.d/ha.cf
- TFTP:
/etc/inetd.conf (IP del cluster)

|}
Tras la modificaciones oportunas, se debe reiniciar las dos máquinas para cargar las nuevas configuraciones.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Matriz de conmutación ===

Encontramos dos diferentes núcleos de conmutación en la plataforma VIVAit:

* Para los nodos de procesamiento ACD el núcleo de conmutación es asterisk 1.4 RSP con fuertes modificaciones realizadas por MDtel en determinados módulos (queues, chan_spy entre otros)

* Para los nodos que realizan funcionalidad de gateway y/o procesamiento de telefonía corporativa, se utiliza como núcleo de conmutación asterisk 13, versión certified
https://wiki.asterisk.org/wiki/display/AST/Asterisk+13+Documentation

==== Modificaciones realizadas sobre Asterisk 13 certified 2 ====

===== Archivos añadidos por '''MD'''tel =====
Los archivos añadidos son los siguientes:

* '''apps/app_ucid.c'''
* '''apps/app_cli.c'''
* '''apps/app_crash.c'''
* '''apps/app_mdintz.c'''
* '''apps/app_mdintz.exports.in'''
* '''include/asterisk/mdintz.h'''
* '''include/asterisk/ucid.h'''
* '''res/res_mdcal.c'''

'''→ apps/app_mdintz.exports.in '''

Este archivo sirve para la exportación de funciones del mdintz para el uso por aplicaciones externas

===== Modificaciones de archivos =====

Los archivos modificados por '''MD'''tel son los mostrados a continuación:

* '''apps/app_mixmonitor.c'''
* '''res/res_calendar_caldav.c'''
* '''contrib/scripts/safe_asterisk'''
* '''contrib/init.d/rc.debian.asterisk'''
* '''channels/sig_pri.c'''
* '''channels/chan_sip.c'''

'''→ main/audiohook.c''' 

'''audiohook.c''' ha sido modificado para solucionar un crash de asterisk al utilizar en el mixmonitor las opciónes r y t

'''→ app_crash.c '''

Esta nueva aplicación es sólo compatible con '''Asterisk 13'''.

La documentación de la misma se encuentra en el comando: '''"core show application Crash"'''

Esta nueva aplicación ''permite añadir'' al plan de pruebas:

* Generación de una parada de asterisk. (Crash(IwantToGetAnAccessViolation) ó Crash(IwantToGetADoubleFreeMem))
* Verificación de su impacto. Por ejemplo, no deben cortarse las llamadas en curso, si así está previsto por la topología.
* Correcta generación de los "core", comprobando que funciona "backtrace" (bt).

'''Nota.-''' Esta aplicación no debería estar presente en una instalación de '''Asterisk 13'''

'''→ app_mdintz.c y mdintz.h''' 

Esta aplicación sirve como interfaz a entornos (funcionalidades) creados por MDtel

Para mas información consultar la página de [[MDintz|MDintz]].

Las rutas de estos archivos son las siguientes:

'''apps/app_mdintz.c''' 
'''include/asterisk/mdintz.h '''

'''app_mdintz.c''' :

'''app_mdintz.c''' orientada al proceso de enrutamiento a implementar en ''intz-nimitz.''

El archivo '''.c''' es casi igual para asterisk 1.4.24 y asterisk 13.
'''Nota.-''' Cuando se compila para asterisk 13, es necesario comentar la línea que pone '''"#define ASTERISK_OLD".'''

Los cambios implementados son:

* Unificación de código entre las versiones de asterisk
* Nuevo comando "qry"
* Posible resolución de "Mal write" en intz-nimitz (a verificar)

En cuanto al nuevo comando, el formato es:

'''mdintz qry <nHostFijo> <entorno> <servicio> <par1>...<parN>'''

Permite interrogar a un servidor de igual modo que hace el dialplan con '''fines de diagnóstico'''. La única diferencia es que se ha añadido el parámetro '''"nHostFijo"''' que puede tomar como valor '''"*"''' (lo que solicita una interrogación secuencial a todos los servidores definidos, igual a la funcionalidad del dialplan) ó '''"0"''' a '''"3"''' (que solicita un interrogación dirigida el host indicado como hostN, y sólo a él, en archivo de configuración).

Para instalarlo, es necesario copiar:

* '''asterisk/apps/app_mdintz.c'''
* '''asterisk/include/asterisk/mdintz.h'''
* En asterisk 1.4.24 conviene asegurar que se ha actualizado '''"asterisk/apps/app_queue.o"''' y '''"asterisk/apps/app_queue.so"'''
* Luego '''"make", "make install"''' y module '''"unload/load"''' (mejor "stop now" y start)

'''→ scripts y rc.debian.asterisk'''

cambiado contrib/scripts por el modificado por MDtel 
cambiado contrib/init.d/rc.debian.asterisk por el modificado por MDtel

'''→ Carpeta mp3 añadida al directorio addons'''

La carpeta mp3 en addons permite la reproducción desde el diaplan de los mensajes en mp3. En make menuselect hay que marcar el format_mp3 y app_mp3 e instalar el paquete mpg123 de ubuntu

'''→ sig_pri.c'''

Modificado para enviar/recibir el ucid en un primario qsig

Para que se envie el ucis tenemos que habilitar el envio de facilidades en el chan_dahdi.conf

facilityenable = yes

'''→ init.d''' 

* Uno de los archivos modificados ha sido '''init.d''', se encuentra en la ruta: '''/etc/init.d/asterisk'''. La modificación realizada es la siguiente:

{|style="background-color:#ffffcc;" class="wikitable"
|-
|-
| SAFE_ASTEISK=/usr/sbin/safe_asterisk 
if [ -x $SAFE_ASTERISK ] ; then 
:# //!! wkw 
:DAEMON=$SAFE_ASTERISK 
fi
|}



'''→ safe-asterisk'''
* Se encuentra en la siguiente ruta:'''/usr/sbin/safe-asterisk''' .En este archivo se ha modificado MAXFILES=32768

'''→ default'''

* Este fichero podemos encontrarlo en: '''/etc/default/asterisk'''. La finalidad de la modificación de este fichero es poder correr como usuario Asterisk, grupo asterisk y generar cores (descomentar línea)
Las modificaciones realizadas han sido:

{|style="background-color:#ffffcc;" class="wikitable"
|-
|-
| AST_USER="asterisk"
AST_GROUP="asterisk"

COREDUMP=yes
|}

===== Nueva función de asterisk: app_cli.so =====

Esta función permite ejecutar desde el '''dialplan''' un comando de línea de consola de '''asterisk (CLI).''' Su primer uso (y esperamos que no último) será para lanzar los '''notify''' que los teléfonos necesitan para el ''reaprovisionamiento'' desde el portal o desde la facilidad de movilidad de usuario.

Básicamente ejecuta un comando y devuelve su salida. Utiliza un archivo intermedio que puede ser:

* '''/dev/null''' si el campo se deja vacío, por tanto, no se puede recuperar la salida.
* '''TEMP''', en cuyo caso se crea un archivo temporal que se borra antes de finalizar la ejecución de la función.
* Un nombre de fichero que es responsabilidad del dialplan el borrarlo cuando proceda.

Para instalarlo basta copiar '''apps/app_cli.c''' en el directorio ''' "apps" ''' de los fuentes y luego ejecutar '''"make" y "make install".'''

A continuación se pasa el resultado de '''"core show function CLI" '''

'''[Synopsis]'''

Lanza un comando CLI desde dialplan

'''[Description]''' 
- CLI(nomArchSal,cmd) 
- Si 'nomArchSal' está vacio, se usa '/dev/null' y no se recupera resultado 
- Si 'nomArchSal'=TEMP, Se crea un archivo temporal que se borra al final 
- En otro caso, se crea el archivo y no se borra

'''[Syntax]''' 
CLI(nomArchSal,cmd)

'''[Arguments]''' 
'''nomArchSal'''
Archivo de salida (si se omite, /dev/null)
'''cmd'''
Comando a ejecutar via CLI

==== Dialplan ====

El Dialplan podría considerarse la columna vertebral del sistema ''Asterisk''.

Es una colección ordenada de acciones que se llevan a cabo cuando un usuario marca una serie de números. Hace la función de una tabla de enrutamiento de llamadas.

Todas las configuraciones generales de Asterisk están accesibles en la ruta '''/etc/asterisk'''

'''CONCEPTOS BÁSICOS'''

♦ '''EXTENSIONES'''

Una extensión es una marcación en el teclado de un teléfono. Dicha configuración podemos encontrarla en el archivo '''extensions.conf'''

Por ejemplo, un usuario podría marcar “3001” en su teléfono, y eso sería una extensión. También podría marcar un número de teléfono nacional, como por ejemplo “915881000”, y también sería una extensión.

En Asterisk pueden definirse también extensiones como texto, por tanto no debemos relacionar las extensiones únicamente con números.

Algunas reglas que sería interesante conocer serían las siguientes:

{| class="wikitable"
|-
! '''Regla''' !! '''Descripción'''
|-
| '''X''' || Cualquier cifra de 0 a 9
|-
|'''Z'''||Cualquier cifra de 1 a 9
|-
|'''N'''||Cualquier cifra de 2 a 9
|-
|'''[x-y]'''||Cualquier cifra de "x" a "y"
|-
|'''[xyz]'''|| Las cifras "x", "y" o "z"
|-
|'''.'''||Una o más repeticiones del símbolo anterior
|-
|'''!'''||Cero o más repeticiones del símbolo anterior
|}

Estas reglas son necesarias a la hora de definir por ejemplo todos los números de teléfono posibles en España

♦ '''PRIORIDADES'''

En lenguaje scripting, las acciones se van ejecutando de arriba a abajo en orden. En cambio, en Asterisk, el orden en el que se ejecutan las acciones es el indicado mediante números.
Primero se ejecutará la acción 1, luego la 2...así sucesivamente.

Es decir no basta con definir las acciones que se llevarán a cabo, también debemos indicar el orden en el que se llevarán a cabo.

♦ '''CONTEXTOS'''

Es mecanismo que nos permite variar el comportamiento del sistema en función del número que se marque. Su misión es aumentar la seguridad del sistema ofreciendo servicios diferenciados en función del usuario.

La sintaxis típica es el nombre del contexto englobado entre corchetes [nombre_contexto]. Si un dispositivo no tiene un contexto definido se redirige directamente al contexto por defecto.

Los ficheros que conforman el Dialplan se clasifican en:

* '''Generales'''
* '''Particulares'''
* '''Web'''

{| class="wikitable"
|-
! '''Fichero''' !! '''Función'''
|-
| '''Generales''' || Se encuentran los ficheros de propios de MDtel y Asterisk. Es importante remarcar que estos ficheros NO pueden ser modificados por el usuario.
|-
|'''Particular'''||Estos ficheros son los únicos que puede modificar el usuario
|-
|'''Web'''|| Se encierran aquí los archivos generados automáticamente por la plataforma, a través del portal
|}

En función del nodo en el que estemos trabajando, encontraremos dos tipos de dialplan:

'''* Dialplan ACD''' --> Dialplan que aplica a nodos ACD

'''* Dialplan corporativa''' --> Dialplan que aplica a nodos de corporativa o gateways (ya sean de corporativa o ACD)

A continuación se muestran las tablas con los ficheros correspondientes a cada Dialplan.

{| border="1" align="center" bgcolor="FloralWhite"
|+ '''Ficheros de configuración Dialplan Corporativo'''
| '''GENERALES'''
| '''PARTICULARES'''
| '''WEB'''
|-
| ext_Grabaciones.conf ext_InicioLlamada.conf ext_InicioLlamada_Dahdi.conf ext_InicioLlamada_ExtSIP.conf ext_InicioLlamada_TrunkSIP.conf ext_MARCAR_ColaCentralita.conf ext_MARCAR_ColaCentralita_Dial.conf ext_MARCAR_Cola.conf ext_MARCAR_Cola_Dial.conf ext_MARCAR.conf ext_MARCAR_DejarMensaje.conf ext_MARCAR_DejarMensaje_Dial.conf ext_MARCAR_Extension.conf ext_MARCAR_Extension_Dial.conf ext_MARCAR_Externo.conf ext_MARCAR_Externo_Dial.conf ext_MARCAR_Facilidad.conf ext_MARCAR_Facilidad_Dial.conf ext_MARCAR_Facilidad_nimitz.conf ext_MARCAR_Interno.conf ext_MARCAR_LeerMensaje.conf ext_MARCAR_LeerMensaje_Dial.conf ext_MARCAR_Nodo.conf ext_MARCAR_Nodo_Dial.conf ext_MARCAR_SalasConf.conf ext_MARCAR_SalasConf_Dial.conf ext_MARCAR_Servicios.conf ext_MARCAR_VDN.conf MARCAR_VDN_Dial.conf ext_MDtel.conf ext_MDtel_Var.conf ext_Subrutinas_AnchoBanda.conf ext_Subrutinas_BD.conf ext_Subrutinas_BD_Facilidad.conf ext_Subrutinas_BD_Facilidad.conf ext_Subrutinas_Colas.conf ext_Subrutinas.conf ext_Subrutinas_Enrutamiento.conf ext_Subrutinas_finLlamada.conf ext_Subrutinas_Grabacion.conf ext_Subrutinas_nimitz.conf ext_Subrutinas_Varias.conf ext_Subscribe.conf ext_Transfer.conf ext_Transfer_ExtSIP.conf ext_Transfer_TrunkInternos.conf ext_TrunkInternos.conf ext_TrunkInternos_Dial.conf sip_Estatico.conf sip_GENCUST.conf sip_notify.conf queues.conf queues_GENERAL.conf queues_PLANTILLACOLAS.conf 

| ext_Enrutador_Particular.conf ext_InicioLlamada_Dahdi_Particular.conf ext_InicioLlamada_ExtSIP_Particular.conf ext_InicioLlamada_Particular.conf ext_InicioLlamada_TrunkSIP_Particular.conf ext_MARCAR_Extension_Particular.conf ext_MARCAR_Externo_Particular.conf ext_MARCAR_Facilidad_Particular.conf ext_MARCAR_VDN_Particular.conf ext_MDtel_Particular.conf ext_TrunkInternos_Particular.conf 

|asterisk_WEB.conf ext_MDtel_WEB.conf sip_trunkExt_WEB.conf sip_trunkInt_WEB.conf sip_trunk_WEB.conf sip_WEB.conf queues_WEB.conf
|}

{| border="1" align="center" bgcolor="FloralWhite"
|+ '''Ficheros de configuración Dialplan ACD'''
| '''GENERALES'''
| '''PARTICULARES'''
| '''WEB'''
|-
| ext_Enrutador.conf ext_Grabaciones.conf ext_InicioLlamada.conf ext_InicioLlamada_CTI.conf ext_InicioLlamada_Dahdi.conf ext_InicioLlamada_ExtSIP.conf ext_InicioLlamada_Marcador.conf ext_InicioLlamada_TrunkSIP.conf ext_MARCAR_ColaCentralita.conf ext_MARCAR_ColaCentralita_Dial.conf ext_MARCAR_Cola.conf ext_MARCAR_Cola_Dial.conf ext_MARCAR.conf ext_MARCAR_DejarMensaje.conf ext_MARCAR_DejarMensaje_Dial.conf ext_MARCAR_Extension.conf ext_MARCAR_Extension_Dial.conf ext_MARCAR_Externo.conf ext_MARCAR_Externo_Dial.conf ext_MARCAR_Facilidad.conf ext_MARCAR_Facilidad_Dial.conf ext_MARCAR_Facilidad_nimitz.conf ext_MARCAR_LeerMensaje.conf ext_MARCAR_LeerMensaje_Dial.conf ext_MARCAR_Nodo.conf ext_MARCAR_Nodo_Dial.conf ext_MARCAR_SalasConf.conf ext_MARCAR_SalasConf_Dial.conf ext_MARCAR_Servicios.conf ext_MARCAR_VDN.conf ext_MARCAR_VDN_Dial.conf ext_MDtel.conf ext_MDtel_Var.conf ext_Subrutinas_AnchoBanda.conf ext_Subrutinas_BD.conf ext_Subrutinas_BD_Facilidad.conf ext_Subrutinas_Colas.conf ext_Subrutinas.conf ext_Subrutinas_Enrutamiento.conf ext_Subrutinas_finLlamada.conf ext_Subrutinas_Grabacion.conf ext_Subrutinas_nimitz.conf ext_Subrutinas_Varias.conf ext_Subscribe.conf ext_Transfer.conf ext_Transfer_ExtSIP.conf ext_Transfer_TrunkInternos.conf ext_TrunkInternos.conf ext_TrunkInternos_Dial.conf queues_GENERAL.conf queues_PLANTILLACOLAS.conf sip_GENCUST.conf sip_GENERAL.conf sip_notify.conf sip_PLANTILLAEXT.conf sip_supervision.conf 

| ext_Enrutador_Particular.conf ext_InicioLlamada_CTI_Particular.conf ext_InicioLlamada_Dahdi_Particular.conf ext_InicioLlamada_ExtSIP_Particular.conf ext_InicioLlamada_Marcador_Particular.conf ext_InicioLlamada_Particular.conf. ext_InicioLlamada_TrunkSIP_Particular.conf ext_MARCAR_Externo_Particular.conf ext_MARCAR_Facilidad_Particular.conf ext_MARCAR_VDN_Particular.conf ext_MDtel_Particular.conf ext_TrunkInternos_Particular.conf 

|asterisk_WEB.conf ext_MDtel_WEB.conf queues_WEB.conf sip_trunkInt_WEB.conf sip_WEB.conf 
|}
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Servicios networking ===
Son muy importantes las configuraciones adecuadas de los servicios de:

* '''NTP''': El sistema en global ha de estar sincronizado; todos los servidores y puestos de trabajo (en el caso de ''VIVA''it Suite) han de estar perfectamente sincronizados; los servidores de la plataforma se sincronizarán con el NTP del cliente; si el cliente no tiene NTP será necesario que un servidor de la plataforma se sincronice con un NTP externo y este sea el servidor para el resto de la plataforma

* '''DNS''': La configuración de DNS de la plataforma será coherente con el resto de la plataforma IT del cliente

* '''DHCP''': Es necesario coordinar con el cliente la asignación de direcciones para los diferentes elementos de la plataforma '''''VIVA'''''it, fundamentalmente para terminales telefónicos; en este caso además será necesario activa la opción 66 que permitirá definir el servidor TFTP del que los terminales cogerán sus ficheros de aprovisionamiento

=== Bases de datos (BBDD)===

La base de datos del sistema se basa en el motor de base de datos MySQL, es un elemento crítico del sistema, en el que insertan y del que obtiene mucha información múltiples procesos.
Muchas comunicaciones entre procesos se realizan vía Base de Datos (tabla COM_COMUNICADOS). Pueden existir distintas instancias de base de datos que explicadas en las siguientes secciones, nuestra base de datos tiene la siguiente estructura: [[Base de datos|Información completa de la BD]]. Podéis ampliar más información en https://dev.mysql.com/doc/

==== BBDD Tiempo Real ====
En la base de datos de tiempo real insertan información todos los procesos del sistema, y se realizan los cambios en configuración utilizando como herramienta el portal de administración y '''''VIVA'''''it Supervisor

De la base de datos de tiempo real leen los procesos que requieren información, y las aplicaciones:
*'''''VIVA'''''it Supervisor (para reporting de tiempo real)
*PanelWeb
*Datos de sesión de '''''VIVA'''''it Desk
*Monitorización Zabbix
* Otros

El portal de administración se encarga de escribir las configuraciones añadidas o modificadas en la base de datos

Para cuando la BDTR contienen un número masivo de datos, existe un script que borra el contenido de ciertas tablas de la BD (tablas DAT_) dejando solamente datos de un cierto número de días configurable.
Este script se llama borraRegistrosNimitz.pl; para más información consultar el apartado de Howto's.

'''Por defecto, a partir de la versión 3.2.0 de la plataforma, los registros se mantedrán 2 meses.'''

==== BBDD Réplica ====
A efectos de asegurar las prestaciones del sistema, se establece una réplica de la base de datos, sincronizada con la de tiempo real; los procesos y aplicaciones pesados, que realicen consultas a las base de datos que puedan comprometer las prestaciones del sistema atacan a la réplica y nunca a la base de datos de tiempo real

Es posible que en instalaciones pequeñas no exista réplica, en cuyo caso se establece una base de datos unificada sobre la de tiempo real, en la que se añaden índices y procedimientos almacenados que típicamente residen en la de réplica.

Es posible establecer tantas réplicas como sean necesarias si diferentes procesos pesados se penalizan en exceso, si bien una implantación tipo contemplará una sola

Algunos procesos que utilizan la base de datos de réplica son:
*'''''VIVA'''''it Reporting
*'''''VIVA'''''it Tracker
*Histórico en tiempo real de '''''VIVA'''''it Supervisor

'''IMPORTANTE: Ningún proceso, programa, aplicación, etc. escribe en la base de datos de réplica; tan solo se extrae información'''

==== BBDD de copia ====
A efectos de asegurar el funcionamiento y como medida de contingencia ante un problema puntual de comunicación con la BD de tiempo real, en cada nodo disponemos de una BD de copia local. Posiblemente de un tamaño menor que la BD de tiempo real, dependiendo de cuanto tiempo pase hasta la próxima sincronización con la base de tiempo real.Esta base de datos llamada '''nimitzCopia'''.

Solo entrara en funcionamiento,cuando se produzca el problema mencionado, dejando acceder a los datos y poder dar servicio a la empresa mientras se soluciona el problema.

===== Backup y restore =====

Se utilizan dos script, para realizar la copia de seguridad y restaurar en la base de datos de copia local que son:

* El proceso '''bdCentral.sh''' que es el encargado de realizar la copia de seguridad. Tiene un archivo de configuración bdCentral.conf. En este archivo hay un parámetro (IGNORE_TABLAS) que indica las tablas de las que NO se realizará copia de seguridad. Toda tabla que no se indique formará parte de la copia de seguridad. Vuelca los resultados en /var/log/bdCentral.log
* El proceso '''bdNodo.sh''' que es el encargado de descargar la copia de seguridad y restaurarla en local. Tiene un archivo de configuración bdNodo.conf. Vuelca los resultados en /var/log/bdNodo.log. El fichero de backup se copia mediante el usuario sincroniza, que deberá poder acceder sin contraseña al servidor donde reside la copia.

En caso de producirse algún error en alguno de los procesos, marcarán dicho error en el log con una línea que comienza con la cadena "*ERROR".

==== Diagnósticos y operaciones sobre bases de datos ====

=====Comprobación que una base de datos está arrancada=====
Para comprobar si la base de datos está arrancada debemos poner en el terminal : '''ps aux | grep mysql'''

Si la base de datos está arrancada y funcionando correctamente se nos mostrará en el terminal:
[[Archivo:Base_Datos_bien.png‎ |500px|center]]

Por el contrario, si la base de datos presenta algun problema el mensaje mostrado será:

[[Archivo:Base_datos_mal.png |center]]

=====Comprobación que la base de datos de réplica está sincronizada con la base de datos de tiempo real.=====

Si se necesita verificar que la base de réplica está sincronizada con la base de datos en tiempo real basta con acudir al comando : '''show slave status\G'''.

Una vez introducido veremos:

[[Archivo:Replica.png |980px|center]]

Comandos importantes, desde dentro consola de Mysql:

'''show master status''': Realizado desde el master
'''show slave status''': Realizado desde el esclavo; el valor "seconds behind master" nos indica
cuanto está retrasada la réplica con respecto a la base de datos de tiempo real. Si el valor de este campo es elevado nos indicará
que la base de datos real con la réplica no estará sincronizada, por tanto, nos interesa que este valor sea lo más pequeño posible.
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Procesos propios ===

==== bdCentral ====

El proceso ''bdCentral.sh'' es el encargado de realizar la copia de seguridad. Tiene un archivo de configuración ''bdCentral.conf'' el cual puede encontrarse en la ruta '''/etc/MDtel/bdCentral.conf'''. En este archivo hay un parámetro (IGNORE_TABLAS) que indica las tablas de las que NO se realizará copia de seguridad. Toda tabla que no se indique formará parte de la copia de seguridad. Vuelca los resultados en /var/log/bdCentral.log

En caso de producirse algún error, se marcará dicho error en el log con una línea que comienza con la cadena "*ERROR".

Para ejecutar bdCentral:
bdCentral.sh /etc/MDtel/bdCentral.conf

Estos procesos se ejecutan automáticamente. Para ello está copiado el fichero bdCentral a /etc/cron.d.

Por defecto la programación vienen comentada por lo que será necesario activarlo.

Para que se roten los logs hay que copiar el fichero bdCentral.logrotate a /etc/logrotate.d (como bdCentral)
La ruta donde se encuentran los logs es la siguiente: '''/var/log/myAcdSuperv.log'''


[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== bdNodo ====
El proceso bdNodo.sh es el encargado de descargar la copia de seguridad y restaurarla en local. Tiene un archivo de configuración bdNodo.conf, este archivo puede encontrarse en la ruta '''/etc/MDtel/bdNodo.conf.''' Vuelca los resultados en /var/log/bdNodo.log. El fichero de backup se copia mediante el usuario sincroniza, que deberá poder acceder sin contraseña al servidor donde reside la copia.

En caso de producirse algún error, se marcará dicho error en el log con una línea que comienza con la cadena "*ERROR".

Para ejecutar bdNodo:

bdNodo.sh /etc/MDtel/bdNodo.conf

Estos procesos se ejecutan automáticamente. Para ello está copiado el fichero bdNodo a /etc/cron.d.

Por defecto la programación vienen comentada por lo que será necesario activarlo.

Para que se roten los logs hay que copiar el fichero bdNodo.logrotate a /etc/logrotate.d (como bdNodo)

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== Intz-Nimitz ====

Permite integrar procesos de asterisk (del dialplan) con la base de datos; por ejemplo es el que graba segmentos, inspecciona donde esta registrado un agente…etc. La estabilidad de este proceso es importante para el funcionamiento del sistema, si bien las llamadas entran en caso de no estar disponible.

Para mas información consultar la página de [[intz-nimitz|intz-nimitz]].

Desde un SSH ejecuta el comando “nc ip_maquina 1115”

'''root@vivait-acd:~# nc localhost 1115'''
intz-nimitz sis ver='V02.6' inic='20140401 110116' alarmas=21 ultAlar='20140414 171244'
intz-nimitz gmp msj=942/1024 buf=1024/1024 tarea=16/102
intz-nimitz tmp uptime=1816550 (21d 0h 35m 50s)
intz-nimitz vic identif='cms1' entorno='nimitz' conx=0/128 numConx=1018(0)
intz-nimitz mys curro=80/0/0/0 soli=1012(0) soliErr=6(0) soliEncol=0(0/0)
intz-nimitz cache colas=128/10/0/0 vdn=128/8/0/0 usuExten=10/0/0/0

Donde cada parámetro monitorizado indica:
{| class="wikitable"
|-
!Parámetro!!Descripción
|-
|sis/ver||Versión del proceso
|-
|sis/inic||Fecha de de arranque del proceso
|-
|Sis/alarmas||Alarmas desde arranque
|-
|Sis/ultAlar||Fecha de última alarma
|-
|Gmp/msj||
|-
|Gmp/buf||
|-
|Gmp/tarea||
|-
|Tmp/uptime||Tiempo que lleva el servicio activo
|-
|Vic/identif||Etiqueta de identificación del servicio
|-
|Vic/entorno||Entorno de base de datos
|-
|Vic/conx||Conexiones activas/conexiones máximas
|-
|Vic/numConx||Conexiones totales (último minuto)
|-
|Mys/curro||Número de hilos contra la base de datos
|-
|Mys/soli||Conexiones solicitadas (último minuto)
|-
|Mys/soliErr||Conexiones solicitadas con error (último minuto)
|-
|Mys/soliEncol||Conexiones encoladas
|-
|Cache/cola|| Colas monitorizadas/
|-
|Cache/vdn||VDN’s monitorizados
|-
|Cache/usuExten||
|-
|}

Como complemento a los diagnósticos:

* Podremos examinar el fichero de configuración del proceso en '''/etc/MDtel/intz-nimitz.conf'''
* Podremos examinar los logs del proceso en '''/var/log/intz-nimitz.log'''



[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== motorSal ====
Parte fundamental del proceso de marcación saliente, gestiona como hay que llamar a los diferentes contactos asignados a las campañas. Transforma los contactos en intentos de marcación.

A efectos de diagnósticos, desde un SSH ejecuta el comando “nc ip_maquina 1120”

'''root@vivait-acd:~# nc localhost 1120'''
motorSal sis ver='V01.4' inic='20140725 140832' alarmas=1 ultAlar='20140725 140832'
motorSal gmp msj=253/256 buf=256/256 tarea=99/102
motorSal tmp uptime=600165 (6d 22h 42m 45s)
motorSal mtr mys=1 ocup=0% planif=28(0) intento=26(0)

Donde cada parámetro monitorizado indica:

{| class="wikitable"
|-
!Parámetro!!Descripción
|-
|SIS/ver||Versión del proceso
|-
|SIS/inic||Fecha de de arranque del proceso
|-
|SIS/alarmas||Alarmas desde arranque
|-
|SIS/ultAlar||Fecha de última alarma
|-
|Gmp/msj||
|-
|Gmp/buf||
|-
|Gmp/tarea||
|-
|Tmp/uptime||Tiempo que lleva corriendo
|-
|mtr/mys||Si está conectado al MySQL
|-
|mtr/ocup||Porcentaje de ocupación
|-
|mtr/planif||Contactos planificados Totales (Último minuto)
|-
|mtr/intento||Intentos totales (Ültimo minuto)
|-
|}

* Posee un fichero de configuración llamado ''motorSal.conf'' en la ruta '''/etc/MDtel/motorSal.conf'''.


* Respecto a los logs del motorSal consultar el siguiente apartado: [[Trazas motorSal]]. Los logs pueden verse en la ruta '''/var/log/motorSal.log'''

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== MyACDSuperv ====
Refleja el estado de las colas de asterisk en la base de datos; tiene sentido a efectos de estadísticas e informes, pero no a efectos de funcionamiento de la conmutación de voz.

Es el responsable de mostrar información en las ventanes de tiempo real del supervisor.

Es también el proceso que genera las llamadas en el marcador automático de '''''VIVA'''''it Suite.

A efectos de diagnósticos, desde un SSH se ejecuta el comando “nc ip_maquina 1112”.

'''root@vivait-acd:~# nc localhost 1112'''
myAcdSuperv SIS ver='04.6' inic='20140416 081613' alarmas=6 ultAlar='20140416 121652'
myAcdSuperv AMI cnx=1 ocup=28% exten=2/2/511 asig=0/11/4095
myAcdSuperv MYSQL cnx=1 ms=316

Donde cada parámetro monitorizado indica:
{| class="wikitable"
|-
!Parámetro!!Descripción
|-
|SIS/ver||Versión del proceso
|-
|SIS/inic||Fecha de de arranque del proceso
|-
|SIS/alarmas||Alarmas desde arranque
|-
|SIS/ultAlar||Fecha de última alarma
|-
|AMI/cnx||Conectado (1) a asterisk
|-
|AMI/ocup||Porcentaje de ocupación de MyACDSuperv
|-
|AMI/exten||Extensiones/Extensiones/Extensiones monitorizadas|-
|-
|AMI/asig||
|-
|MYSQL/cnx||Conectado (1) a MySQL
|-
|MYSQL/ms||Tiempo de última operación en ejecutarse
|-
|}

Como complemento a los diagnósticos:

* Podremos examinar el fichero de configuración del proceso en '''/etc/MDtel/myAcdSuperv.cnf'''
* Podremos examinar los logs del proceso en '''/var/log/myAcdSuperv.log'''

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== Proceso escoba ====
El proceso escoba se encarga de resolver y consolidar todos aquellos segmentos de grabación que han quedado almacenados en los gateways por falta de información o incoherencias. Existen dos tipos de procesos escobas:
# Proceso escoba perteneciente a nodo con agente de grabación (recordNodo) llamado '''''escobaGW.pl'''''.
# Proceso escoba perteneciente o no a un servidor de grabación (recordCentral) llamado '''''escobaGrabsBd.pl'''''.

===== escobaGW.pl =====
Proceso que se ejecuta en los nodos busca en el disco RAM , las grabaciones de segmentos cuya antigüedad sea superior a mas de un día, es decir, si el proceso por ejemplo se ejecuta a la 01:00 a.m. del día 24/03/2016 buscara todas aquellas grabacionesn de segmentos realizadas antes de la 01:00 a.m del día 22/03/2016.
Una vez realizada la busqueda, obtendra el UCID a traves del nombre del fichero, y comprobara su correspondencia con la tabla DAT_LLAMADAS. Si existe una llamada con ese UCID, cambiara el estado de la llamada para que sea procesada correctamente. En caso contrario, es movida a la carpeta ''/var/lib/recordNodo/grabError''.

===== escobaGrabsBd.pl =====
Se ejecuta sobre la base de datos de histórico, normalmente se ejecuta en un servidor de grabación (recordCentral). El proceso hace una búsqueda en dos tablas:
* En DAT_SEGMENTOS obtiene todos aquellos segmentos con grabaciones que dieron error, su estado tendrá valor 120.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]
* En DAT_LLAMADAS obtendremos todos los registros correspondiente al segmentos anteriores.
Después hace una búsqueda en el sistema, usando como ruta el campo D_HORA_INICIO de cada llamada, que indica la ruta entera donde se encuentra el archivo. Una vez encontrado el archivo cambia el estado del segmento que tenia un error a estado de grabación disponible , que tendrá valor 100. Si no encontramos el segmento, no realizara nada.

==== recordCentral ====
Se considera como un servidor de grabaciones. Todas las grabaciones de llamadas son un activo importante y una empresa con Contact Center pueda recibir millones de llamadas que necesitan estar registradas y almacenadas en discos duros con gran capacidad, las máquinas donde suelen alojarse estos servidores poseen discos duros limitados, lo que hace necesario en algunos casos incorporar ''dispositivos NAS''.

Los ''dispositivos NAS'' son dispositivos de almacenamiento conectados a una red que permite el almacenamiento y la recuperación de datos desde una ubicación centralizada, flexibles y escalables, lo que significa que a medida que necesite almacenamiento adicional, puede añadirlo al que tiene. Esto no significa que sea necesario tener ''dispositivos NAS'' para funcionar, sino que puede tomar datos de diferentes sitios.

En '''recordCentral''' pueden existir tres tipos de dispositivos NAS:
* Uno dedicado para las llamadas
* Uno dedicado para los segmentos
* Uno mixto para todas las llamadas y segmentos.

El '''recordCentral''' se encarga de recoger todas las grabaciones de segmentos que tienen de estado proceso(3) en cada nodo gestionado, es decir, coger aquellos segmentos de llamadas marcados como llamadas disponibles, intenta descargar los segmentos de las llamadas y convertirlas al formato adecuado (MP3).
Como una característica particular cada diez minutos, siempre que no tenga ninguna otra tarea, intenta ver si puede establecer conexión con un nodo en cuarentena, para sacarlos de cuarentena y recoger todas las grabaciones de segmentos disponibles, para intentar convertir y descargar todas las grabaciones.

A efectos de diagnósticos, desde un SSH se ejecuta el comando '''''nc ip_maquina 1114''''' en la maquina donde creamos que debe estar ejecutando el proceso recordCentral. Ejemplo:
'''root@smadavacdrecord1:~# nc localhost 1114'''
recordCentral SIS ver='01.2' inic='20140423 094058' alarmas=11041 ultAlar='20140423 160112'
recordCentral MYSQL cnx=1
recordCentral NAS llamadas=1 segmentos=1
recordCentral REC llamNum=24901 llamErr=0 segmNum=38906 segmErr=0 retraso=305
recordCentral NODO fase=0 cuarentena='' descarga='8,6,4,7,10,9' gestion='4,6,7,8,9,10'
La explicación de los campos se muestra en la tabla siguiente:

{| class="wikitable"
|-
! Parámetro !! Descripción
|-
| SIS/ver || Versión del proceso
|-
| SIS/inic || Fecha de arranque del proceso
|-
| SIS/alarmas || Alarmas desde arranque
|-
| SIS/ultAlar || Fecha de última alarma
|-
| MYSQL/cnx || Conectado (1) a MySQL
|-
| NAS/llamadas || Alojamiento en NAS de llamadas activo (grabación de llamada completa en un único archivo)
|-
| NAS/segmentos || Alojamiento en NAS de segmentos activo
|-
| REC/llamNum || Llamadas procesadas
|-
| REC/llamErr || Llamadas con error
|-
| REC/segmNum || Segmentos procesados
|-
| REC/segmErr || Segmentos con error
|-
| NODO/fase || Número de proceso de recordCentral
|-
| NODO/cuarentena || Lista de nodos en cuarentena, separada por comas
|-
| NODO/descarga || Lista de nodos en descarga, separada por comas
|-
| NODO/gestion || Lista de nodos gestionados, separada por comas (cuarentena + descarga = gestión)
|}

Como complemento a los diagnósticos:
* Podremos examinar el fichero de configuración del proceso en '''/etc/MDtel/recordCentral.pconf'''



* Podremos examinar los logs del proceso en '''/var/log/recordCentral.log'''


[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== recordNodo ====
Se considera como proceso con función de agente de grabación para un nodo. Solo debe existir uno por maquina o por nodo (configurado como grabador) en el '''portal de administración de ''VIVA''it'''.

Para su funcionamiento utiliza un ''disco RAM'' por que su tiempo de acceso mejora drásticamente, debido a que la memoria RAM es varios órdenes de magnitud más rápida que las unidades de disco reales, haciendo que la velocidad de procesamiento de las grabaciones sea mucho mas rápida.

Este ''disco RAM'' normalmente ocupa la mitad de la memoria RAM de una maquina pero no es obligatorio pues dependerá de la memoria disponible en cada maquina, y además, se configura con un tamaño no superior a 2GB de memoria RAM. Hay que tener especial cuidado en que no se llene en espacio ni tampoco los i-nodos. Se puede monitorizar a través de la aplicación '''zabbix'''.

El '''''recordNodo''''' se encarga de recoger todas las grabaciones de segmentos que tienen de estado ''proceso(2)'', es decir, aquellos segmentos de llamadas que han sido grabadas pero no están siendo procesadas, moviéndolas del ''disco RAM'' a su carpeta correspondiente.

La forma de obtener la carpeta correspondiente es obteniendo el dato del campo D_HORA_INICIO en la tabla DAT_LLAMADAS para cada segmento,tras un tratamiento del campo creara la subruta correspondientes: /año/mes/dia/hora/min. Entonces, la ruta correcta seria /var/lib/recordNodo/grabaciones/año/mes/dia/hora/min, donde año, mes, dia , hora y min son los valores numéricos obtenidos del campo D_HORA_INICIO.

A efectos de diagnósticos, desde un SSH se ejecuta el comando '''''nc ip_maquina 1113''''' en la maquina donde creamos que debe estar ejecutando el proceso recordNodo:

root@smadavgw5:~#nc localhost 1113
recordNodo SIS ver='04.00.00' inic='20160326 105137' alarmas=2 ultAlar='20160326 105542'
recordNodo MYSQL cnx=1
recordNodo REC grabNum=0 grabErr=0

La explicación de los campos se muestra en la tabla siguiente:
{| class="wikitable"
|-
! Parámetro !! Descripción
|-
| SIS/ver || Versión del proceso
|-
| SIS/inic || Fecha de arranque del proceso
|-
| SIS/amarmas || Alarmas desde arranque
|-
| SIS/ultAlar || Fecha de última alarma
|-
| MYSQL/cnx || Conectado (1) a MySQL
|-
| REC/llamNum || Llamadas procesadas
|-
| REC/llamErr || Llamadas con error
|-
| REC/segmNum || Segmentos procesados
|-
| REC/segmErr || Segmentos con error
|}

Como complemento a los diagnósticos:
* Podremos examinar el fichero de configuración del proceso en '''/etc/MDtel/recordNodo.pconf'''
:Se muestra a continuación el fichero de configuración:
#
# Configuracion de recordNodo.pl
#
# 0: Solo alarmas en archivo log - 1: alarmas y trazas
$depurar = 1;

# 0: Arranca como proceso - 1: arranca como demonio
$soyDemonio = 1;

# Archivo de log ('': salida estandar)
$logArch = '/var/log/record/recordNodo.log';

# Archivo para el pid (eliminando el .pid final)
$pidArch = '/var/run/record/recordNodo';

# 0: El programa se ejecuta indefinidamente - 1: solo una vez (util en depuracion)
$unaVezSolo = 0;

# Tiempo de espera en segundos cuando no hay conexion o cuando no hay llamadas
$toBucle = 5;

# Tiempo de guarda en segundos desde D_HORA_FIN hasta que se procesa llamada
$toProcesar = 30;

# Bytes por segundo en archivos de grabaciones
$bytesPorSegundo = 16000;

# Bytes a leer en cada accceso a disco
$bytesLeerBuf = 1048576;

# Conexion de base de datos
$db='nimitz';
$dbHost = 'BDTR';
$dbPort = '3306';
$dbUsuario = 'nimitz';
$dbClave = 'ivivanimitz';

# Configuracion de la supervision
$supPort = '1113';

# Quien es mi nodo para filtrar grabaciones
$miNodo = 2;

# Directorio donde se localizan las grabaciones
$grabRutaOrig = '/var/spool/asterisk/monitor';
$grabRutaDest = '/var/lib/recordNodo/grabaciones';
$grabRutaError = '/var/lib/recordNodo/grabError';
$grabRutaUsaTimestamp = 1;

# Tiempo en segundos limite a truncar en las grabaciones (0=sin limite)
$grabLimiteSegs = 0;

# Indica si se procesan segmentos de tipo tipoSegmEliminarGrabacion y patron eliminacion
$segmEliminarGrabacionTrato = 1;
$patronEliminarGrabacion = '/etc/MDtel/null.bin'

A continuación se indican las variables a modificar:

{| class="wikitable"
|-
! Variable a modificar !! Comentario
|-
|$depurar = 1;||'''0''': Solo alarmas en archivo log
'''1''': alarmas y trazas
|-
|$soyDemonio = 1;||'''0''': Arranca como proceso
'''1''': arranca como demonio
|-
|$logArch = '/var/log/record/recordNodo.log';||Archivo de log ('': salida estándar) $pidArch = '/var/run/record/recordNodo'; Archivo para el pid (eliminando el .pid final)
|-
|$unaVezSolo = 0;||'''0''': El programa se ejecuta indefinidamente
'''1''': solo una vez (útil en depuración)
|-
|$toBucle = 5;||Tiempo de espera en segundos cuando no hay conexión o cuando no hay llamadas
|-
|$toProcesar = 30;||Tiempo de guarda en segundos desde D_HORA_FIN hasta que se procesa llamada
|-
|$bytesPorSegundo = 16000;||Bytes por segundo en archivos de grabaciones
|-
|$bytesLeerBuf = 1048576;||Bytes a leer en cada acceso a disco
|-
|$db='nimitz';||Conexión de base de datos
|-
|$dbHost = 'BDTR';||
|-
|$dbPort = '3306';||
|-
|$dbUsuario = 'nimitz';||
|-
|$dbClave = 'ivivanimitz';||
|-
|$supPort = '1113';||Configuración de la supervisión
|-
|$miNodo = 2;||Quien es mi nodo para filtrar grabaciones
|-
|$grabRutaOrig = '/var/spool/asterisk/monitor'; Directorio donde se localizan las grabaciones
|-
|$grabRutaDest = '/var/lib/recordNodo/grabaciones';
|-
|$grabRutaError = '/var/lib/recordNodo/grabError';
|-
|$grabRutaUsaTimestamp = 1;||'''1''': Usa Timestamp
'''0''': No usa Timestamp
|-
|$grabLimiteSegs = 0;|| Tiempo en segundos limite a truncar en las grabaciones (0=sin limite)
|-
|$segmEliminarGrabacionTrato = 1;||Indica si se procesan segmentos de tipo tipoSegmEliminarGrabacion y patrón eliminación
|-
|$patronEliminarGrabacion = '/etc/MDtel/null.bin'
|}


* Podremos examinar los logs del proceso en '''/var/log/recordNodo.log'''

==== Vivait-CTI ====
Permite la comunicación entre la aplicación '''''VIVA'''''it Desk de agente y el asterisk, sincronizando; convierte el protocolo “asterisk manager” a CSTA ('''''VIVA'''''it Desk “habla” CSTA).

Es un proceso importante para que el uso de '''''VIVA'''''it Desk, y que los agentes puedan realizar su operativa normal con la entrada y salida de llamadas… si bien el cursado telefónico de llamadas es factible, no disponer de las facilidades de '''''VIVA'''''it Desk y formularios hace el sistema difícilmente manejable

A efectos de diagnósticos, desde un SSH se ejecuta el comando “nc ip_maquina 1111”

'''root@vivait-acd:~# nc localhost 1111'''
vivait-cti sis ver='V01.5' inic='20140414 104312' alarmas=13 ultAlar='20140415 173152'
vivait-cti gmp msj=1018/1024 buf=1023/1024 tarea=97/102
vivait-cti tmp uptime=694748 (8d 0h 59m 8s)
vivait-cti cti numConx=(0/511) numPend=(0/127) numMakeCallPend=0 numCall=(0/2047)
numChan=(0/4095) numAuxStr=(0/511) numMoniColas=(0/511) numMoniDevice=0
numMoniCall=0 numMoniCallAuto=0 numMoniCallByDevice=0 numMoni=(0/511)
auditCallErr=0 auditAuxStrErr=0 auditMsjReqErr=0 araChanID=0 araUniqueID=0 araMoni=0
vivait-cti ami esta=conx resp=652(0) evs=1397(0) descar=556(0) err=16 errConx=16
numAct(0/0/127) auditErrAct=0

Donde cada parámetro monitorizado indica:

{| class="wikitable"
|-
!ver!!Versión del proceso
|-
|sis/inic||Fecha de de arranque del proceso
|-
|Sis/alarmas||Alarmas desde arranque
|-
|Sis/ultAlar||Fecha de última alarma
|-
|Gmp/msj||
|-
|Gmp/buf||
|-
|Gmp/tarea||
|-
|Tmp/uptime||
|-
|Cti/numConx||Número de conexiones actuales / Número de conexiones máximo
|-
|Cti/numPend||
|-
|Cti/numMakeCallPend||Llamadas pendientes de realizar
|-
|Cti/numcall||
|-
|Cti/numChan||
|-
|Cti/numAuxStr||
|-
|Cti/numMoniColas||Número de colas monitorizadas
|-
|Cti/numMoniDevice||
|-
|Cti/numMoniCall||
|-
|Cti/numMoniCallAuto||
|-
|Cti/numMoniCallByDevice||
|-
|Cti/numMoni||
|-
|Cti/auditCallErr||
|-
|Cti/auditAuxStrErr||
|-
|Cti/ auditMsjReqErr||
|-
|Cti/ araChanID||
|-
|Cti/ araUniqueID||
|-
|Cti/ araMoni||
|-
|Ami/esta||Estado de conexión contra manarger de asterisk
|-
|Ami/resp||
|-
|Ami/evs||Número de eventos (último minuto)
|-
||Ami/descar
|-
|Ami/err||Errores
|-
|Ami/errConx||Errores de conexión
|-
|Ami/numAct||
|-
|Ami/auditErrAct||
|-
|}

Como complemento a los diagnósticos:

* Podremos examinar el fichero de configuración del proceso en '''/etc/MDtel/vivait-cti.conf'''
* Podremos examinar los logs del proceso en '''/var/log/vivait-cti.conf'''

==== Phoneprov-TFTP ====

==== Introducción al aprovisionamiento ====

En cada Centralita Telefónica existente, se puede configurar sus teléfonos IP y asignarles extensiones a cada teléfono. Para hacer un ''aprovisionamiento'' de los teléfonos es necesario que el técnico configure uno a uno manualmente utilizando su interfaz web, esto no es práctico, ya que genera muchos errores y el tiempo de implementación se incrementa drásticamente. Además, es casi imposible la administración cotidiana de los teléfonos IP. Desde '''MD'''tel se utiliza una herramienta que permite que los teléfonos IP soportados y homologados por '''MD'''tel ([[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_3.0#Terminales_telef.C3.B3nicos ver Terminales telefónicos]]) se puedan aprovisionar automáticamente, brindando una fácil implementación y administración cotidiana.

===== ¿Qué es aprovisionar? =====

Aprovisionar un teléfono es el proceso de configuración automático de teléfonos IP para su uso con una Centralita Telefónica de forma remota. Una vez que aprovisione un teléfono, el teléfono automáticamente se configurará correctamente y podrá administrar los teléfonos de forma centralizada y remota, sin tener que iniciar sesión en la interfaz web de cada uno de los teléfonos.

El aprovisionamiento de teléfono facilita enormemente la administración cotidiana de los teléfonos IP. Esto hace que sea fácil de cambiar las contraseñas de extensión,realizar desvíos de llamadas, nombre a mostrar, mensajería y demás configuraciones, ya que puede hacerlo de forma centralizada para todos los teléfonos desde el portal de administración y luego transferir los cambios al teléfono.

===== TFTP =====

'''TFTP''' son las siglas de '''T'''rivial '''F'''ile '''T'''ransfer '''P'''rotocol ''(Protocolo de transferencia de archivos trivial)''.

Es un protocolo de transferencia muy simple semejante a una versión básica de FTP. TFTP a menudo se utiliza para transferir pequeños archivos entre terminales en una red.

Algunos detalles del TFTP:

* Utiliza UDP (puerto 69) como protocolo de transporte (a diferencia de FTP que utiliza los
puertos 20 y 21 TCP).
* No puede listar el contenido de los directorios.
* No existen mecanismos de autenticación o cifrado.
* Se utiliza para leer o escribir archivos de un servidor remoto.
* Soporta tres modos diferentes de transferencia, "netascii", "octet" y "mail”.

===== Funcionamiento del servidor phoneprove-TFTP =====

A continuación se muestra un esquema que facilita el entendimiento del funcionamiento del servidor phoneprove-TFTP:

[[Archivo:Funcionamiento_Servidor.png‎ |center]]

El servidor Phoneprove-TFTP se ''encarga del aprovisionamiento masivo de terminales'', es de gran utilidad porque cualquier cambio en los teléfonos pueden ser realizados a nivel DHCP y todos los teléfonos tomarán la nueva configuración luego de reiniciarlos.

Desde phoneprove-TFTP se generara los archivos necesarios para cada teléfono y que sirven para ser aprovisionados automáticamente.
El servidor phoneprove-TFTP tiene alojados los ficheros de configuración están ordenados según las direcciones MAC de los teléfonos. El teléfono “preguntará” al servidor cual es su fichero de configuración utilizando su dirección MAC. Este a través de su MAC , consulta en la base de datos para ofrecer al terminal los datos de configuración según su plantilla, cual sera su extensión , cual sera el usuario propietario, entre otras cosas.

{|
|-
|
'''Nota:''' En instalaciones grandes habrá más de uno, quizás uno por sede grande; depende de la infraestructura de DHCP.
|}

===== Parámetros necesarios de Aprovisionamiento de Teléfonos =====

'''Notas:''' el aprovisionamiento desarrollador por '''MD'''tel, no emplea un fichero por cada
teléfono, sino que emplea una plantilla por cada modelo de teléfono.
Debe haber una '''configuración previa del servidor DHCP''' es necesario coordinar con el cliente la asignación de direcciones para
los diferentes elementos de la plataforma '''''VIVA'''''it, fundamentalmente para terminales telefónicos; en este caso además será necesario
activar la opción 66 que permitirá definir el servidor TFTP del que los terminales cogerán sus ficheros de aprovisionamiento.
El aprovisionamiento desde el portal de administración solo es posible para aquellos teléfonos IP homologados y probados desde '''MD'''tel
[[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_3.0#Terminales_telef.C3.B3nicos ver Terminales telefónicos]]

Como existen parámetros comunes de todos los teléfonos de la misma marca de fabricante, muchos de los parámetros necesarios para el aprovisionamiento como comentamos se han generado desde MDtel en forma de plantillas, que estarán disponibles en el portal de administración VIVAit [[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Plantillas | ver plantilla del portal de administración VIVAit]].

La configuración de un teléfono SIP es muy sencilla y en no es necesario tener conocimientos avanzados de informática o de telefonía. Cada una de estas plantillas que sirven para aprovisionar un teléfono IP homologado, algunos de los parámetros predeterminados se explicarán a continuación .

====== Parámetros de Aprovisionamiento globales ======

* Configuración de la red y MAC.
* Zona horaria.

====== Parámetros de Aprovisionamiento Personales ======

Además de los parámetros de aprovisionamiento globales, el teléfono también obtendrá información de configuración individual, tales como:

*Número de Extensión.
*Nombre y Contraseña de usuario SIP.
*Configuración de Teclas BLF.
*Contraseña de la Interfaz Web del Teléfono IP.
*Idioma de la Pantalla.
*Orden de Preferencia de los Codecs.

===== Aprovisionamiento de teléfonos nivel usuario =====

{|
|-
|
'''Notas:''' La dirección MAC debe estar especificada en letras mayúsculas.
La dirección MAC del teléfono se puede encontrar en la etiqueta adhesiva en la parte inferior del teléfono, o de lo contrario se deberá acceder desde
el menú del propio terminal.
|}

Los pasos a seguir son los siguientes:

'''1)''' Dar de alta el teléfono en el portal de administración, se debe seleccionar el modelo del teléfono, e indicar la dirección MAC del teléfono a aprovisionar, todo ello desde el portal de administración VIVAit.
Para mas información ver [[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Aprovisionamiento del portal de administracion| aprovisionamiento del portal de administración VIVAit]].

'''2)''' En el mismo portal de administración se deberá crear una extensión , asignar a la extensión el teléfono que se quiera aprovisionar, elegir la plantilla adecuada del teléfono y el usuario propietario (solo si sera un puesto fijo) desde [[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Extensiones | extensiones del portal de administración]].

'''3)''' Conectar el teléfono a la red LAN informática (conectarlo al router o switch) para que tenga acceso a Internet:

:*El teléfono enviará un mensaje de multidifusión a través de la LAN.
:*Este será captado por la Central Telefónica siempre que esté en la misma LAN.
:*Al teléfono se le enviará una URL de aprovisionamiento.

'''4)''' Como la mayoría de teléfonos IP del mercado al arrancar una vez sabiendo la URL de aprovisionamiento piden una serie de archivos de configuración para aprovisionarse vía TFTP. EL servidor phoneprove-TFTP, detectara la petición y a través de la MAC y datos del usuario, consultará en la base de datos los datos necesarios para aprovisionar al teléfono y si todo funciona correctamente mandara al teléfono IP los datos de configuración necesarios para funcionar.

'''5)''' Asegúrese de que el teléfono encuentren el servidor TFTP, para ello esperar un tiempo adecuado para que termine el aprovisionamiento.

'''6)''' Finalmente aparecerá como registrado en la centralita, obtendrá una dirección IP y podra funcionar según la configuración establecida.

{|
|-
|
'''Nota''': Si no se reaprovisiona tras un periodo largo de tiempo, desenchufe el cable de alimentación eléctrica o el cable Ethernet (si se utiliza la alimentación en línea PoE) para reiniciar los teléfonos.
|}

===== Aprovisionamiento de teléfonos nivel técnico =====

====== Plantilla de configuración ======

La plantilla de configuración empleadas en el apartado [[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Plantillas | plantilla del portal de administración VIVAit]] de cada modelo está formada por una serie de variables.

Los valores se obtienen de la tabla de la base de datos CEN_TELEFONOS, CEN_USUARIOS, ACD_EXTENSIONES, ACD_NODOS, COM_NODOS... correspondientes a la extensión del teléfono, usuario, nodo, etc.

variable ${NODO1_C_NOMBRE}='corp-ast13'
variable ${EXTEN_C_CLAVE_REGISTRO}='Tel21002'
variable ${USU_C_CODIGO_POSTAL}=''28034'
variable ${SEDE_C_CODIGO_POSTAL}='28034'
variable ${USU_C_NOMBRE}='Juan Antonio'
variable ${USU_C_APELLIDO2}='Ramirez'
variable ${SEDE_C_NOMBRE}='RED_LAB'
variable ${NODO2_C_NOMBRE}= NULL
variable ${EXTEN_C_NOMBRE}='' 21002
variable ${USU_C_LOCALIDAD}=''
variable ${USU_C_NOMBRE_MOSTRAR}='Juan'
variable ${NODO1_C_IP}='175.25.129.70'
variable ${MODEL_C_PREFIJO_PLANTILLA_MAC}='T28P'
variable ${SEDE_C_LOCALIDAD}='Madrid'
variable ${USU_C_APELLIDO1}='Casas'
variable ${NODO2_C_IP}= NULL
variable ${TF_ID_EXTENSION}='5'
cargando campos idExten=5

====== Ficheros y paquetes necesarios ======

'''Paquetes previos:''' libnet-tftpd-perl, tftp-hpa, libnet-address-ip-local-perl
'''Usuario de funcionamiento:''' root

{|
|-
|
'''Nota:''' los archivos y directorios que generemos podrian necesitar que se permitiera el acceso al archivo de lectura y escritura en el servidor TFTP.
|}

'''Archivos necesarios:'''

/usr/local/sbin/phoneprov-tftp.pl
/usr/local/sbin/phoneprov-tftp.pm
/etc/MDtel/phoneprov-tftp.pconf
/etc/init/phoneprov-tftp.conf
/etc/logrotate.d/phoneprov-tftp

'''Directorios a crear:'''

/var/lib/phoneprov-tftp/plt
/var/lib/phoneprov-tftp/bin

==== Watchdog ====

Se trata de una aplicación del asterisk que monitoriza el SIP y en caso de fallo, pasado un cierto tiempo, reinicia el asterisk y genera un core.
Si escribimos en CLI de asterisk perro tenemos los siguientes comandos:

{| class="wikitable" border="0" style="background:#ffffff" align="top"
|-
|Activar||Activar el Watchdog
|-
|Desactivar||Desactiva el Watchdog
|-
|Parada IWantToStop||Reinicia el asterisk y genera un core para pruebas
|-
|Reload||Realiza una recarga del Watchdog y aplica cambios en su configuración
|-
|Show||Ver el estado del Watchdog

perro avisado=0 activo=1 segsDormir=1 segsInic=60 segsGuarda=30 maxErr=3
perro nombre=sip_monitor_udp lwp=[15437] segsInic=60 segsGuarda=30 hace=11 err=0/5
|-
|}

El dato "hace" informa de cuanto tiempo ha transcurrido desde el último tick. Facilita la calibración del parámetro de configuración "segs_guarda", normalmente es 30

Tiene un fichero de configuración ubicado en /etc/asterisk/MDcrash.conf

{| class="wikitable" border="0" style="background:#ffffff" align="top"
|-
|Sección [perro]
||activo=yes (Si esta o no activo)
segs_dormir=1 (Un tick por segundo)

segs_inic=60

segs_guarda=30

max_errores=3
|-
|Sección [sip_monitor_udp]
||segs_inic=60

segs_guarda=30 (Cada 30 segundos si no reciba trafico SIP genera core)

max_errores=5 (Número máximo de errores)
|-
|}



==== Proceso de Backup ====
Las plataformas '''''VIVA'''''it Call y '''''VIVA'''''it Suite incluyen un script para realizar un proceso de backup.

Se utilizará el script '''backup.sh''', que se encuentra en el directorio '''etc/MDTel'''.

Se ejecuta automaticamente mediante el uso de un cron

'''texto del cron:'''

SHELL=/bin/sh
PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
# m h dom mon dow user command
0 2 * * * root /etc/MDtel/backup.sh /etc/MDtel/backup.cfg

Para activar el script hay que descomentar la línea
# m h dom mon dow user command

Los directorios de los que se hace copia son:
* DIR=var/lib/asterisk/sounds/Particular
* DIR=var/lib/asterisk/moh
* DIR=etc
* DIR=etc/asterisk
* DIR=etc/cron.d
* DIR=etc/dahdi
* DIR=etc/exim4
* DIR=etc/ha.d
* DIR=etc/logrotate.d
* DIR=etc/MDtel
* DIR=etc/mysql
* DIR=etc/network
* DIR=etc/zabbix
* DIR=usr/local/sbin

Por defecto se realiza un backup cada dos horas en la carpeta '''/var/spool/MDtel/backup'''.

Para cambiar la ruta de destino del backup habrá que modificar el fichero backup.sh, en concreto modificar la variable MDTEL.

El fichero ''' backup.cfg''' que se genera incluye copia de la siguiente información:
* Ficheros de configuración de la aplicación.
* Base de Datos.
* Dialplan.

Se guardarán 10 copias del fichero ''' backup.cfg '''

Los campos disponibles en el fichero son los siguientes:

{| class="wikitable"
|-
!Campo !!Descripción !!Posibles valores (si aplica)
|-
|IP_BD ||IP o HOST máquina base de datos de tiempo real||
|-
|HAY_SMB ||Si hay o no servidor SAMBA||1 si existe servidor SAMBA o 0 si no existe
|-
|HOST_SMB||IP o HOST servidor SAMBA||
|-
|USU_SMB||Usuario acceso servidor SAMBA||
|-
|CLAVE_SMB||Clave usuario acceso servidor SAMBA||
|-
|RUTA_SMB||Ruta donde se guardará el backup en el servidor SAMBA||
|-
|}

Para recuperar una plataforma utilizando el backup, habrá que instalar una máquina nueva y cargar los ficheros de configuración, Base de Datos y Dialplan guardados en el proceso de backup.

===== Información adicional: como funciona un cron =====

La información sobre el fucnionamiento de un cron puede encontrarse en: [http://lasegundapuerta.com/index.php/informatica/linux-y-software-libre/1709-comando-cron-en-linux-ubuntu Información sobre el comando cron]

==== CHAT ====
La información para configurar el CHAT y su funcionamiento puede encontrarse en:

[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#CHAT CHAT]

=== Requerimientos de conectividad ===

El esquema siguiente muestra como ejemplo todos los flujos de información existentes en un entorno típico de <big>'''telefonía corporativa (sin presencia)'''</big> ('''''VIVA'''''it Call)

[[Archivo:Flujos corporativa.png|cebter]]

En el entorno de <big>'''Contact Center'''</big>, encontramos los siguientes flujos <big>'''entre servicios'''</big> (comunicaciones entre servidores, ('''''VIVA'''''it Suite))

[[Archivo:Flujos Contact servicios.png|650px|center]]

y <big>'''entre usuarios y servicios'''</big> los reflejados a continuación:

[[Archivo:Flujos Contact puestos.png|600px|center]]

{| class="wikitable"
|-
!Lado A!!Lado B!!Puertos!!Sentido!!Observ.
|-
|Terminal telefónico||Servidor||TCP 5060||A -> B||Señalización SIP
|-
|Terminal telefónico||Servidor||UDP 5060||A -> B||Señalización SIP
|-
|Terminal telefónico||Servidor||10000 a 20000||A -> B
B -> A
||RTP
|-
|Terminal telefónico||Servidor TFTP||UDP 69||A -> B
B -> A
||Para actualización de terminales por TFTP
|-
|Terminal telefónico||Servidor NTP||UDP 123||A -> B||
|-
|'''''VIVA'''''it Desk||Servidor||TCP 4500||A -> B||Comunicación CTI
|-
|'''''VIVA'''''it Desk||Servidor||TCP 3306||A -> B||Acceso a Mysql Base de datos
|-
|'''''VIVA'''''it Desk||Servidor Syslog||UDP 514||A -> B||Para envio de logs de agente
|-
|'''''VIVA'''''it Supervisor||Servidor||TCP 3306||A -> B||Acceso a Mysql Base de datos
|-
|'''''VIVA'''''it Tracker||Servidor||TCP 3306||A -> B||Acceso a Mysql Base de datos
|-
|'''''VIVA'''''it Tracker||Servidor||TCP 8180||A -> B||
|-
|Actualizador||Servidor||TCP 80||A -> B||Necesario para actualizaciones de versiones de aplicaciones de agente y supervisores
|-
|Portal de administración||Servidor||TCP 8180||A -> B||Acceso al portal de administración '''''VIVA'''''it Suite
|-
|'''''VIVA'''''it Tracker Web||Servidor||TCP 8180||A -> B||
|-
|Monitor||Servidor||TCP 8180||A -> B||Wallboard
|-
|Monitorización||Servidor||TCP 80||A -> B||Acceso a portal monitorización (Zabbix)
|-
|}

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Gateways ===
El concepto de gateway como tal no existe en la plataforma '''''VIVA'''''it; existen nodos de ACD y nodos de corporativa.

A efectos de operación un nodo de corporativa es el que en cualquier caso asumirá las funcionalidades de gateway, y recibirá las conexiones (analógicas, digitales o IP) a sistemas externos o a la RTC

El concepto gateway queda pues suscrito a entornos meramente comerciales

Incluimos no obstante en este apartado los diagnósticos y operaciones básicos de conexiones a sistemas externos o RTC

Para verificar los enlaces establecidos ejecutamos el siguiente comando en el terminal: '''sip show peers'''

Al ejecutar este comando obtenemos la salida:

[[Archivo:Enlace_Exterior.png |center]]

Las columnas ''Host'' y ''Port'' nos muestran las conexiones establecidas y nos informa de un posible problema de conexión.

Sabremos que ''no existe conexión'' cuando la columna Host tiene el valor '''Unspecified''' y en la columna Port aparece un '''0''' , a continuación se muestra un ejemplo:

[[Archivo:Ejemplo_no_conexion.png |center]]



=== Servidor de grabación ===
==== Almacenamiento en la nube ====
Almacenamiento en la nube.
Existe la posibilidad de que tras un determinado periodo de tiempo las grabaciones sean movidas a un almacenamiento externo. De esta operativa se encarga el proceso /usr/local/sbin/mueveGrabaciones.pl que recibe como parámetro la ruta al archivo de configuración. Dicho archivo tiene los siguientes elementos:

*$db: Nombre de la base de datos.
*$dbHost: servidor de MySQL
*$dbPort: Puerto del MySQL.
*$dbUsuario: Usuario de conexión a MySQL.
*$dbClave: Clave del usuario anterior.
*$dirBase: Directorio donde residen las grabaciones
*$diasCaducidad: Dias de antigüedad para mover las grabaciones
*$sftpHost: Servidor SFTP de destino
*$sftpPort: Puerto SFTP.
*$sftpUsuario: Usuario SFTP.
*$sftpClave: Clave del usuario SFTP.
*$simula: Si este campo vale 1, las grabaciones se copian, pero no se borran del directorio original, ni se actualiza su ubicación en la base de datos.

La grabación indica donde se encuentra mediante el campo E_UBICACION_GRABACION, que puede tener los siguientes valores:
*Sin definir (0)
*En línea (10): Las grabaciones se encuentran en el servidor de grabaciones.
*Fuera de línea (20): las grabaciones se encuentran en una ubicación externa.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Reporting ===
La aplicación de reporting en general no tiene procesos habituales de operación y mantenimiento.
Los informes son obtenidos desde la interfaz gráfica o mediante un procedimiento de scripting, descritos en “Formato de fichero de intercambio para '''''VIVA'''''it Reporting”.

==== Formato de fichero de intercambio para '''''VIVA'''''it Reporting ====
{| class="wikitable"
|-
! Nombre !! Descripción !! Ejemplo
|-
| colspan="3"| Selección de registros
|-
| SQL_selec || Expresión SQL que se añadirá al where a la SQL principal. || C_ORIGEN like '6%' and C_COD_CLIENTE= '023'
|-
| SQL_select_leido || Filtro de selección legible
|| Skill igual a 60310
|-
| SQL_orden || Lista de campos por los que se ordenará, después de los que estén ya definidos en la plantilla. || C_ORIGEN, C_COD_CLIENTE
|-
| colspan="3"| Salida
|-
| FIC_extension || Extensión de fichero de salida: PDF, XLSX, CSV || PDF
|-
| FIC_tipo_entrega || 'P': Pantalla, 'D': Directorio, 'C': Correo || D
|-
| FIC_destino || Si 'C', dirección de correo, si 'D', ruta del directorio || D:\informes\
|-
| colspan="3"| Plantilla
|-
| INF_modelo || Ruta del fichero de plantilla || C:\Modelos\llamadas.rep
|-
| INF_descripción || Descripción del informe || Informe detallado de llamadas
|-
| colspan="3"| Base de datos
|-
| BD_ip || IP o nombre de máquina ||
|-
| BD_puerto || Puerto de MySQL ||
|-
| BD_base_datos || Nombre de base de datos ||
|-
| BD_usuario || Usuario de base de datos ||
|-
| BD_clave || Clave de acceso cifrada ||
|-
| colspan="3"| Parámetros
|-
| PAR_desde_vis || Fecha inicial de selección en formato legible (o '-' si no hay) || 01/01/2016
|-
| PAR_hasta_vis || Fecha final de selección en formato legible (o '-' si no hay) || 31/01/2016
|-
| PAR_01 || Parámetro opcional ||
|-
| .. || .. ||
|-
| PAR_20 || Parámetro opcional ||
|}

El fichero tendrá un nombre único para permitir la generación simultánea de informes.
El fichero es borrado por la aplicación de forma automática.
Se pasa a la aplicación de generación de informes como parámetro. Por ejemplo:
“C:\Archivos de Programa\MDtel\Nimitz\LanzaInformes\LanzaInformes.exe”
“C:\Archivos de Programa\MDtel\Nimitz\LanzaInformes\NIM00001.tmp”

Ejemplo de fichero:
{| class="wikitable"
|-
| SQL_selec=(DAT_ACUMULADOS_COLAS.ID_COLA in (11))

SQL_select_leido=Skill igual a 60310

SQL_orden=
FIC_extension=pdf

FIC_tipo_entrega=P

FIC_destino=C:\

INF_modelo=skill_setsi.rep

INF_descripcion=Skill. SETSI

BD_ip=172.25.1.2

BD_puerto=3306

BD_base_datos=nimitz

BD_usuario=nimitz

BD_clave=UIk5jNY9PVX5ogg=

PAR_desde_vis=-

PAR_hasta_vis=-

PAR_01=
|}

==== Resumen de significado de columnas en reporting histórico ====
Esta información se puede consultar en el siguiente enlace:

http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Documentacion_de_usuario_VIVAit_Suite_3.3#Resumen_del_valor_de_las_columnas_que_aparecen_en_los_informes



===== Consideraciones adicionales =====

Los tiempos se insertan en el intervalo en el que se deja ese "estado", esto provoca que en un intervalo pueda ser mayor el tiempo ACD que el tiempo conectado.

''* Ejemplo:''

-Llamada: Duración 15 minutos Hora fin de la llamada 13:01
-Llamada: Duración 20 minutos Hora fin de la llamada 13:24
Suma de las duraciones de las llamadas para el intervalo ''35 minutos'' tiempo
conectado del agente en el intervalo ''30 minutos.''
Cuando los periodos consultados sean mas amplios (diario, mensual) los
desfases tenderán a desaparecer.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

== Otros Diagnósticos y operaciones básicas ==
=== Arranque y apagado de la plataforma ===

En general el arranque y apagado de cada nodo de una plataforma '''''VIVA'''''it es el estándar de un procedimiento ordenado de apagado en una máquina linux: '''"Shutdown -h now"''' o comando de apagado inmediato o programado equivalente

El orden de arranque de la plataforma deberá ser:
# En primer lugar arrancar el nodo con la base de datos de tiempo real
# Una vez finalizado el arranque del punto 1, arrancar el nodo con la base de datos de réplica
# Una vez finalizado el arranque del punto 2, arrancar el resto de nodos en cualquier orden

Al respecto del orden de apagado de nodos, es el siguiente:
# En primer lugar se apagarán, en cualquier orden, los nodos que NO CONTENGAN bases de datos de tiempo real ni bases de datos de réplica
# Una vez apagados totalmente todos los nodos del punto 1, apagaremos el nodo (o nodos) con bases de datos de réplica
# Una vez apagados totalmente todos los nodos del punto 2, se apagará el nodo con la base de datos de tiempo real

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]


=== Grabación ===

==== Configuración de la grabación en la plataforma corporativa ====
Para que una llamada se grabe, lo primero de todo es que alguien tenga la capacidad de grabar. Esto se consigue diciendo al nodo que sea grabador. Esto provoca que el nodo llame al mixmonitor para grabar y se inserte un registro en el DAT_GRABACIONES. Esto no significa que ya las llamadas se vayan a grabar, ya que para eso tiene que ser procesadas por un nodo que sea grabador. Hay tres, llamémosle elementos, que se pueden grabar:

* El nodo, es decir todo lo que el nodo enrute
* Prerutas
* Objetos: que son las extensiones, usuarios, grupos corporativos, etc.

Tenemos tres formas de grabar:

* Grabar con beep periódico
* Grabar sin beep periódico
* Descartar grabación

Si de los tres elementos tenemos que uno grabe, ya sea con o sin beep periódico, esa llamada se va a grabar ya que son OR, en cuanto haya un elemento que diga que grabe se va a grabar.

Al igual pasa si tenemos que un elemento tenga descartar la grabación. La grabación no se inicia.

Referente al campo de Modo de grabación en infraestructura, este no se emplea para la grabación de corporativo, sino que solo tiene validez en ACD. Para grabación en el ACD hay que, como se ha dicho anteriormente poner un nodo que sea grabador y especificar un elemento de los tres que hay cual es el que se va a grabar.

Para que exista una grabación ha de existir un segmento asociado a esta. Los segmentos se tratan en las prerutas. Hay un campo es las prerutas que es Generar segmento al enrutar. Si está se generará el segmento del tipo de la preruta y su correspondiente grabación si esta está configurada. Si le decimos que no genere segmentos al enrutar y el sistema está configurado para que grabe, el recordCentral creará un tipo de segmento llamado externo para esa grabación. Podemos configurar si queremos que se cree o no ese segmento, para eso hay que modificar el fichero de configuración del recordCentral y poner un tiempo muy alto al campo $segmExternoMinSegs. También podemos configurar que segmentos queremos que se graben. Por defecto el recordCentral va configurado para que se graben todos los segmentos. Para decirle que solo grabe cierto tipo de segmentos hay que ponerlos los que queramos que si se graben en la variable $tiposSegmentoGrabar del fichero de configuración del recordCentral.

==== Comprobación de que el servidor de grabación esta activo ====

Si al ejecutar el comando '''''nc ip_maquina 1114''''',si no se recibe ninguna respuesta, significa el servidor de grabación no estaría activo.
También usando el comando ''''' ps aux | grep recordCentral ''''', donde si no escribe ningún resultado implica que tampoco esta activo.

==== Comprobación de que los nodos están conectados al servidor de grabación ====

Debemos fijarnos en la linea de respuesta del comando '''''nc ip_maquina 1114''''', que seria:
{| class="wikitable"
|-
| root@smadavacdrecord1:~# nc localhost 1114
recordCentral SIS ver='01.2' inic='20140423 094058' alarmas=11041 ultAlar='20140423
160112'

recordCentral MYSQL cnx=1

recordCentral NAS llamadas=1 segmentos=1

recordCenral REC llamNum=24901 llamErr=0 segmNum=38906 segmErr=0 retraso=305

'''recordCentral NODO fase=0 cuarentena='' descarga='8,6,4,7,10,9' gestion='4,6,7,8,9,10''''
|}

Sabiendo que el parámetro "fase=0" es el numero que identifica el recordCentral, los demás parámetros nos indicaran los nodos disponibles , que funcionan o no en el servidor. Entonces "gestión=4,6,7,8,9,10" indica el id de los nodos que maneja el proceso.

==== Comprobación de que un nodo tiene activo el agente de grabación ====
Si al ejecutar el comando '''''nc ip_maquina 1113''''', no se recibe ninguna respuesta, significa que el nodo no tiene activo el agente de grabación.
También usando el comando ''''' ps aux | grep recordNodo''''', donde si no escribe ningun resultado implica que tampoco esta activo.

==== Comprobación de que un nodo está subiendo archivos de grabación al servidor ====
Debemos fijarnos en la linea de respuesta del comando '''''nc ip_maquina 1114''''', que seria:

{| class="wikitable"
|-
| root@smadavacdrecord1:~# nc localhost 1114
recordCentral SIS ver='01.2' inic='20140423 094058' alarmas=11041 ultAlar='20140423
160112'

recordCentral MYSQL cnx=1

recordCentral NAS llamadas=1 segmentos=1

recordCenral REC llamNum=24901 llamErr=0 segmNum=38906 segmErr=0 retraso=305

'''recordCentral NODO fase=0 cuarentena='' descarga='8,6,4,7,10,9' gestion='4,6,7,8,9,10''''
|}

Fijándonos en "descarga=8,6,4,7,10,9" nos confirma que todos los nodos que maneja el proceso funcionan perfectamente y el servidor puede manejar las grabaciones.

==== Comprobación de grabaciones que se hayan quedado enganchadas en un nodo ====
Podemos fijarnos en los dos comandos, para '''''nc ip_maquina 1114''''':
{| class="wikitable"
|-
| root@smadavacdrecord1:~# nc localhost 1114
recordCentral SIS ver='01.2' inic='20140423 094058' alarmas=11041 ultAlar='20140423
160112'

recordCentral MYSQL cnx=1

recordCentral NAS llamadas=1 segmentos=1

recordCenral REC llamNum=24901 llamErr=0 segmNum=38906 segmErr=0 retraso=305

'''recordCentral NODO fase=0 cuarentena='' descarga='8,6,4,7,10,9' gestion='4,6,7,8,9,10''''
|}

Fijándonos en el campo "cuarentena=''" indica que ninguno de los nodos tiene problemas.

==== Comprobación del estado de ocupación del almacenamiento temporal de grabaciones en un nodo. ====

Desde un SSH ejecuta el comando '''''df - h''''' en la maquina donde creamos que debe estar ejecutando el proceso recordNod:

{|class="wikitable"
|-
! Filesystem !! Size !! Used !! Avail !! Use% !! Mounted on
|-
| udev || 486M || 4,0K || 486M || 1,00% || /dev
|-
| tmpfs || 100M || 416K || 99M || 1,00% || /run
|-
| '''/dev/vda1''' ||''' 236M''' ||''' 68M''' ||''' 156M''' ||''' 31,00% '''||''' /boot'''
|-
| tmpfs || 100M || 48K || 100M || 1,00% || /var/spool/asterisk/monitor

|}

Nos fijaríamos en la línea marcada en negrita, el campo "Use%" indicara el porcentaje de almacenamiento temporal de grabaciones en un nodo.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

===Escuchas e intrusiones en asterisk===
'''CallSpy''' es una aplicación elaborada para asterisk que permite a un usuario realizar escuchas e
intrusiones en llamadas.
En realidad tenemos dos aplicaciones en asterisk, CallSpy y CallSpyee.
====CallSpy ====
{|
|-
|
'''Nota:''' Como mucho se pueden tener a dieciséis personas al mismo tiempo usando esta aplicación.
|}

Como hemos mencionado anteriormente, esta aplicación permite la escucha de llamadas y,
opcionalmente, realiza la función de intrusión. Tiene tres opciones de configuración obligatorios
que mostramos a continuación:

{|
|-
|
CallSpy(<tipoEspiado>,<expRegEspiado>,<parametrosConf>)

|}
La opción '''<tipoEspiado>''' se refiere a que tipo de objeto que podemos espiar correspondiente, solo debe elegirse un único tipo:
*'''c:''' escuchar una cola
*'''v:''' escuchar un vdn
*'''a:''' escuchar a un agente
*'''e:''' escuchar extensión
La opción '''<expRegEspiado>''' representa el número de la cola, VDN, agente o extensión que queremos escuchar. Tiene que ser una expresión regular.
La opción '''<parametrosConf>''' se refiera a los parámetros de configuración para la llamada que podemos espiar, se pueden combinar o juntar :
*'''q:''' Desactiva el 'beep' al comienzo de cada nueva llamada.
*'''v([value]):''' Ajusta el volumen en el rango -4 a 4 (más alto, mas volumen).
*'''e:''' Habilita el que se pueda cambiar a otra llamada de la misma extensión.
*'''w:''' Habilita el que se pueda activar la intrusión (whisper).
Una vez iniciada la escucha, solo falta que entre una llamada al objetivo que estemos espiando. Al
iniciar la escucha, se puede hacer lo siguiente:
*Pulsando '''#''' modifica el volumen de escucha.
*Pulsando '''*''' cambia a una nueva llamada.
*Pulsando '''1''' si esta habilitado, cambia a otra llamada de la misma extensión.
*Pulsando '''2''' si esta habilitado, inicia la función de intrusión.
*Pulsando '''3''' desactiva la función de intrusión.
====CallSpyee (espiado)====
Mediante esta aplicación indicamos los parámetros que permite a una llamada ser seleccionada para
escuchar. Las opciones de configuración son:
{|
|-
|
CallSpyee([CID_NUM],[cola],[vdn],[agen],[exten])
'''Nota:'''No son parámetros obligatorios, por lo que no hace falta rellenar todos los campos pero si respetar sus posiciones separadas por comas.
|}
La explicación de los parámetros es la siguiente:
*'''CID_NUM:''' representa el call ID de la llamadas
*'''cola:'''representa el número de la cola que se quiere espiar (${QUEUE} ).
*'''vdn:''' representa el número del VDN que se quiere espiar (${VDN} ).
*'''agen:''' representa el número del agente que se quiere espiar.
*'''exten:''' representa el número de la extensión que se quiere espiar (${EXTENSION}) .

Por ejemplo si queremos escuchar todas las llamadas en las que participa una extensión determinada pondremos en la macro de extensiones:
{|
|-
|
exten => s,n,CallSpyee(,,,${EXTENSION})
|}

====Cambios para el dialplan de asterisk====
El funcionamiento de este tipo de servicio conlleva un cambio en el dialplan de asterisk. En cada macro correspondiente se pondrá los diferentes CallSpyee para VDN, colas , extensiones y agentes.
Pasos a seguir:
*Paso 1. Creación de un código de intrusión para cada tipo según necesidad (cola, VDN, agente y
extensión).
{|
|-
|
Ejemplo '''MD'''tel: declaramos como código de intrusión a Agente *44*NUMERO
;==========================================
;======== Intrusion a Agente
;==========================================
exten => _*44*X.,1,set(CadMarcar=intrusionEspiado)
exten => _*44*X.,n,set(DesL=SERVICIO)
exten => _*44*X.,n,set(datoServicio=^${EXTEN:4})
exten => _*44*X.,n,Goto(finMacro,1)
'''Nota:''' En la tercera línea podemos observar la expresión regular que se le pasara al CallSpy correspondiente con el número marcado por el espia. 
|}

*Paso 2.Llamar a CallSpy con la configuración deseada.
{|
|-
|
Ejemplo '''MD'''tel: llamada a CallSpy especificando que vamos a espiar una cola (la c del primer parámetro, con la
extensión introducida en el código de intrusión y con whisper, es decir, función de intrusión habilitada.
;------------------------------------------------------------------------
; Intrusion a Espiado
;------------------------------------------------------------------------
exten => intrusionEspiado,1,NoOp
exten => intrusionEspiado,n,GotoIf($["${datoServicio}"=""]?colgar)
exten => intrusionEspiado,n,CallSpy(c,${datoServicio},w)
exten => intrusionEspiado,n(colgar),Hangup
|}
* Paso 3. Llamar a CallSpyee con la configuración de las llamadas candidatas a ser escuchadas.
{|
|-
|
Ejemplo '''MD'''tel:
exten => s,n,CallSpyee(,,,,${EXTENSION}) → Para extensiones
exten => s,n,CallSpyee(,${QUEUE},,,) → Llamadas espiadas por cola
exten => s,n,CallSpyee(,,${VDN},,) → Llamadas espiadas por VDN
|}

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Calendarios ===

Para la configuración de los Calendarios se hace uso de '''CalDAV''', estándar de Internet que permite a un cliente acceder a información de planificación en un servidor remoto. Permite que varios clientes accedan a la misma información, facilitando la cooperación. Muchas aplicaciones, tanto clientes como servidores, son compatibles con este protocolo.

Si deseamos crear un calendario en la plataforma '''VIVAit''' podemos hacerlo siguiendo el siguiente enlace:
Para comprobar que el servidor de calendarios funciona correctamente bastaría con cargar en la barra de direcciones la siguiente url: [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Calendarios |Calendarios]]

http://${NODO.HOST}/dav/html/cal.php/calendars/${DAV.CUENTA}/${DAV.CALENDARIO}

donde,

* '''NODO.HOST:''' es la ip del servidor calendar
* '''DAV.CUENTA:''' hace referencia a la cuenta de usuario
* '''DAV.CALENDARIO:''' hace referencia el nombre de la cuenta

Una vez que se carga la url sabremos que el servidor funciona correctamente si visualizamos lo siguiente:

[[Archivo:Captura de pantalla de 2016-07-21 12_43_58.png || 1020px|center]]

Si el sistema nos pide usuario y clave querrá decir que el servidor de calendarios está operativo en esa maquina

Para comprobar que funciona en la consola de asterisk usaremos los comandos
calendar show calendars
calendar show calendar [nombreCalendario]

'''Nota:''' Debido bugs detectados, el proceso requerirá:
- La realización de una sincronización manual de la sección "mdcal" desde el portal de administración
- Añadir la línea '''''#include "/etc/asterisk/mdcal.conf"''''' en el fichero calendars.conf y hacer "reload" de asterisk
- En la máquina donde esté instalado el servidor de calendarios apuntar a la IP de la BDTR (/var/www/dav/config.php)

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Syslog de agentes ===
'''''Syslog''''' es un estándar para el envío de mensajes de registro en una red informática IP. Por '''''Syslog''''' se conoce tanto al protocolo de red como a la aplicación o biblioteca que envía los mensajes de registro. Se lanza automáticamente al arrancar un sistema Unix, y es el encargado de guardar informes sobre el funcionamiento de la máquina (eventos, seguridad del sistema, etc) pero puede contener también cualquier información como mensajes de las diferentes partes del sistema (núcleo, programas...) y los envía y/o almacena en diferentes localizaciones transmitiéndose mediante un puerto UDP. Esto permite concentrar los registros de múltiples máquinas en un único punto simplificando la labor de gestión al administrador siendo habitual que múltiples dispositivos lo soporten.

El formato del mensaje se compone de tres campos :

* La cabecera contiene la prioridad, fecha y hora del mensaje, máquina, proceso (nombre e identificador) que lo ha generado y la versión del protocolo utilizado.
* Una serie de pares clave-valor con metadatos.
* El texto del mensaje.

Si es necesario podemos activar el registro de todos los eventos telefónicos que realiza un agente ACD llamado '''Syslog de agentes'''. Su activación se realiza mediante el '''portal de administración ''VIVA''it''' configurando unos parámetros para un usuario llamado ''Rastreo BBDD" y ''Rastreo Syslog''. Para más información[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Pesta.C3.B1a_ACD | ver sección Portal de administración - General - Usuarios - Pestaña ACD ]].

{| class="wikitable" border="0" align="top"
|-
| align="center" style="background:Lavender; color:Black" |<big>'''Elemento'''</big>
|align="center" style="background:Lavender; color:Black" | <big>'''Procedimiento'''</big>
|-
!colspan="2" width="60 px" style="background:Lavender; color:Black"|Operacion
|-
|Ubicación del proceso||Script arranque: /etc/init/ rsyslog.conf
Configuración :
/etc/rsyslog.d/30-vivait-
desk.conf
|-
|Arranque||service rsyslog start
|-
|Parada||service rsyslog stop
|-
|Reinicio||service rsyslog reload
|-
!colspan="2" width="60 px" style="background:Lavender; color:Black"|Diagnostico
|-
|Registro de logs||/var/log/MDtel/vivait-desk.log
Fichero del día actual. se guardan los 30
anteriores comprimidos en tar.g
|}

=== Generación de un Core ===
Un Core es la memoria de un programa.

Para generar un Core rápido con Asterisk hay que hacer lo siguiente:

Ejecutar ps aux | grep asterisk y coger el PID del programa
gdb /usr/sbin/asterisk [PID]
gcore [file]

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==Funcionalidades específicas ==
=== Mecanismo de prioridad adaptativa ===

El mecanismo de prioridad adaptativa permite en una plataforma '''''VIVA'''''it Suite establecer prioridades en las que se tenga en cuenta el tiempo de espera de las llamadas en cola, proporcionando una alternativa al mecanismo de prioridad absoluta que existe por defecto

==== Introducción ====

Este documento presenta una propuesta de mecanismo de asignación de llamadas en colas a agentes basado no solo en las prioridades de agente a cola,
sino en un factor de corrección de prioridad derivado del tiempo de espera de una llamada

==== Terminología ====

* '''Prioridad de llamada:''' A cada llamada susceptible de ser atendida en el ''Call Center'' se le asignará una prioridad de llamada; dicha prioridad será asignada cada vez que un agente quede disponible.
* '''Prioridad de grupo ACD:''' Los agentes del ''Call Center'' tendrán configurada una prioridad para cada grupo ACD al que pertenecen
* '''Tiempo de espera:''' Tiempo que una llamada lleva en espera en un determinado grupo ACD; si la llamada cambia de un grupo ACD a otro el tiempo de espera pasa a cero
* '''Objetivo de servicio:''' Tiempo objetivo máximo de espera por cada grupo ACD

'''Nota.-''' ''En terminología Asterisk el aumento de prioridad corresponde con números descendentes, es decir, 
prioridad 50 es mejor que prioridad 70''

==== Mecanismo de asignación de llamadas ====

En el momento en que exista un agente disponible para recibir llamada, el agente recepcionará la llamada con mejor prioridad de llamada (menor número). La prioridad de llamada para cada llamada se establecerá de la siguiente manera:

- Agentes con prioridad de grupo ACD de 1 a 99 utilizarán el mecanismo convencional de asterisk de prioridad absoluta; será útil para grupos ACD críticos o en Call Centers muy convencionales

'''Si un agente tiene prioridad menor de 100 en grupos ACD y hay llamadas en dichos grupos, estas llamadas serán atendidas por el agente con prioridad absoluta.'''

- Agentes con prioridad de colas de 100 en adelante; se utilizará el siguiente mecanismo de prioridad ponderada:

:*Si el grupo ACD de la llamada está dentro del objetivo de servicio, la prioridad de llamada será la prioridad de grupo ACD (a efectos prácticos se aplicará el mecanismo convencional de asignación de llamada a agente, equitativo entre grupos ACD con misma prioridad)

:*Si el grupo ACD de la llamada está fuera del objetivo de servicio, se aplicará una ponderación que mejorará la prioridad de la llamada a medida que aumente el tiempo de espera:

[[Archivo:Formula.png |center]]

En una configuración de igualdad de prioridad de agente y objetivo de servicio, el tiempo de espera influiría de manera determinante (más o menos en
función del peso) en la asignación de la siguiente llamada
El peso podrá adquirir tres posibles valores: 0, 1 y 10

[[Archivo:Esquema.png |center]]

- Calculo prioridad de llamada: se calcula por llamada cada vez que un agente queda libre
- Agente atiende llamada con mejor prioridad de llamada



[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Marcación saliente ===
Dentro del ACD hay un comportamiento especial que es la marcación saliente. Esta puede ser de tres tipos:
* '''Vista previa''': El agente demanda la siguiente llamada a realizar.
* '''Progresivo''': Se llama al agente y se lanza la llamada al contacto.
* '''Predictivo''': El sistema calcula cuando va a estar libre el agente y se adelanta lanzando varias llamadas (configurables por parámetros). La llamada que es contestada primero, se pasa a una cola (el resto se cuelgan) a la espera que el agente se quede libre.

====Esquema de funcionamiento====
[[Archivo:esquema funcionamiento marcador.jpg|center|500px]]

Los contactos se agrupan en listas para su facilidad de asignación a campañas, aunque finalmente lo que se asigna a una campaña es un contacto.

Las campañas tienen estrategias. Las estrategias definen como se ha de llamar (del primero al último, sólo los pares, etc.). Tienen una serie de parámetros que dependiendo de la estrategia pueden tener distinta utilidad. Desde el punto de vista de la base de datos, las estrategias se definirían en la tabla ACD_CLASES_ESTRATEGIAS y se les da valor en la tabla ACD_ESTRATEGIAS_MARCADOR.
Una vez establecida la campaña y asignados sus contactos y dependiendo del modo de marcación (que se define en las colas) el proceso motorSal crea los intentos de marcación (siempre y cuando no estén en las listas Robinson), que serán leídos por el proceso myAcdSuperv que los convierte en llamadas para el Asterisk.

====Flujo de estados====

El flujo de estados es el reflejado en la figura siguiente:

[[Archivo:diagrama de flujo motorsal.png|center|800px]]

Los diferentes estados de un contacto son:
{| class="wikitable sortable"
|-
! Estado !! ID_Estado!! Descripción
|-
| Planificable || 0|| El contacto está preparado para que lo gestione motorSal y según la estrategia definida se establece el campo ACD_CONTACTOS_CAMPANNAS.D_HORA_PROXIMA
|-
|Planificado||10||Cuando ha llegado el tiempo marcado en HORA PROXIMA, motorSal ejecuta la 2ª fase de la estrategia, generando el intento de marcación.
|-
|Intento||20||El control pasa a myAcdSuperv, que a su vez genera la llamada en Asterisk. Cuando termina, se pasa a Planificable o Finalizado.
|-
|Finalizado||100||Las gestiones con este contacto han terminado.
|-
|Abortado||110||
|-
|Obsoleto||200||Se ha agotado el tiempo para contactar sin agotar todos los intentos. No se le vuelve a llamar nunca.
|-
|}

====Carga de contactos====

===== Descripción =====

A continuación se explica la configuración y funcionamiento de la utilidad encargada de asignar contactos a campañas.

===== Configuración =====

El archivo de configuración recibe el nombre de '''cargaContactos.pconf.''' Este archivo reside en '''/etc/MDtel.''' El formato se describe en la tabla siguiente. Hay que tener en cuenta que las columnas empiezan a numerarse en 0.

{| class="wikitable" style="text-align:center;"
|-
! Parámetro !! Valor !! Obligatorio !! Defecto
|-
| db|| Nombre de la base de datos|| SI || nimitz
|-
| dbHost|| Host MySQL || SI || localhost
|-
| dbPort|| Puerto MySQL || NO || 3306
|-
| dbUsuario || Usuario de acceso a la base de datos|| SI ||
|-
| dbClave || Clave del usuario || SI ||
|-
| rutaContactos || Ruta hasta el archivo de contactos || NO || /var/spool/MDtel/contactos
|-
| obsoletos || Si vale 1, marcar como obsoletos los contactos anteriores || NO || 0
|-
| diasCaducidad || Número de dias a partir de los cuales caducarán los contactos || SI ||
|-
| idCampanna || Número de columna que contiene el ID de la campaña || SI||
|-
| idLista || Numero de columna que contiene el ID de la lista || SI ||
|-
| prioridad || Número de columna que contiene la prioridad || NO || Nota: El valor es de 0 a 99. A mayor número mayor prioridad (se le llamará '''ANTES''')
|-
| tipoTarea|| Número de columna que contiene el tipo de tarea || NO || Nota: los posibles valores de la columna son : *A: Alta *M: Modificación *B: Baja Por defecto el valor es A
|-
| codCli || Número de columna del CSV que contiene el código de cliente || SI ||
|-
| nombreCon || Número de columna del CSV que contiene el nombre || NO ||
|-
| apellido1 || Número de columna del CSV que contiene el primer apellido|| NO ||
|-
| apellido2 || Número de columna del CSV que contiene el segundo apellido || NO ||
|-
| empresa || Número de columna del CSV que contiene la empresa || NO ||
|-
| direccion1 || Número de columna del CSV que contiene la dirección || NO ||
|-
| direccion2 || Número de columna del CSV que contiene la dirección 2 || NO ||
|-
| codPostal || Número de columna del CSV que contiene el código postal || NO ||
|-
| localidad || Número de columna del CSV que contiene la localidad || NO ||
|-
| provin || Número de columna del CSV que contiene la provincia || NO ||
|-
| email || Número de columna del CSV que contiene el email || NO ||
|-
| valFijo_1 || Número de columna del CSV que contiene el primer número fijo del contacto || SI ||
|-
| valFijo_2 || Número de columna del CSV que contiene el segundo número fijo del contacto || NO ||
|-
| valFijo_3 || Número de columna del CSV que contiene el tercer número fijo del contacto || NO ||
|-
| valFijo_4 || Número de columna del CSV que contiene el cuarto número fijo del contacto || NO ||
|-
| valMovil_1 || Número de columna del CSV que contiene el primer número móvil del contacto || SI ||
|-
| valMovil_2 || Número de columna del CSV que contiene el segundo número móvil del contacto || NO ||
|-
| valMovil_3 || Número de columna del CSV que contiene el tercer número móvil del contacto || NO ||
|-
| valMovil_4 || Número de columna del CSV que contiene el CUARTO número móvil del contacto || NO ||
|-
| edad || Número de columna del CSV que contiene la edad || NO ||
|-
| nOpc1|| Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc2 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc3 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc4 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc5 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc6 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc7 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc8 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| cOpc1 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc2 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc3 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc4 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc5 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc6 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc7 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc8 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| Idioma || Idioma del contacto || NO ||
|-
|}

===== Funcionamiento =====

Para ejecutar la utilidad se debe teclear la siguiente orden en la línea de comandos:

'''cmd# cargaContactos.pl /<ruta hasta el conf>/cargaContactos.pconf <archivo CSV>'''

El archivo con los contactos deberá ser un CSV con los campos separados por ';'. La utilidad parsea el archivo conforme a la distribución indicada en la configuración y crea las correspondientes entradas en las tablas '''ACD_CONTACTOS''' y '''ACD_CONTACTOS_CAMPANNAS.'''

La utilidad crea un log en '''/var/log/cargaContactos.log''' en el que vuelca toda la operativa.
Por pantalla se va mostrando un lista con el ID asignado al contacto y el ID de campaña al que se le ha asignado.

Un ejemplo de fichero de carga de contactos sería el siguiente:

#
# Configuracion de recordGwd.pl
#
# Conexion de base de datos
$db='nimitz';
$dbHost = 'localhost';
$dbPort = '3306';
$dbUsuario = 'nimitz';
$dbClave = 'LA QUE SEA';
$diasCaducidad='300';
$rutaGrab = '/var/spool/MDtel/contactos';
$idCampanna = '31';
$idLista = '32';
$obsoletos = 0;
$codCli = '1';
$nombreCon = '2';
$apellido1 = '3';
$apellido2 = '4';
$empresa = '5';
$direccion1 = '6';
$direccion2 = '7';
$codPostal = '8';
$localidad = '9';
$provin = '10';
$email = '11';
$valFijo_1 = '12';
$valFijo_2 = '13';
$valFijo_3 = '14';
$valFijo_4 = '15';
$valMovil_1 = '16';
$valMovil_2 = '17';
$valMovil_3 = '18';
$valMovil_4 = '19';
$edad = '20';
$nOpc1 = '21';
$nOpc2 = '22';
$nOpc3 = '23';
$nOpc4 = '24';
$cOpc1 = '25';
$cOpc2 = '26';
$cOpc3 = '27';
$cOpc4 = '28';
$prioridad = '29';
$tipoTarea = '30';

====Comportamiento de reprogramaciones de llamadas en función del estado del agente====

Se ha preparado la siguiente maqueta:

Campaña saliente.
Cola saliente progresiva.
Dos agentes logados en VIVAit Suite.

En el formulario de la llamada se indica: llamada redirigida
Se selecciona el "check dirigida"

Las posibilidades de prueba son dos: "'''Cualquier agente'''" y "'''Solo agente'''"

Resultados son los siguientes:

{| class="wikitable sortable"
|-
| '''Estado del agente''' || '''Modo Cualquier Agente'''|| '''Modo Solo Agente'''
|-
| '''Agente Preparado''' || Entra llamada a agente|| Entra llamada a agente
|-
|'''Agente en Pausa'''||Entra llamada a otro agente disponible||Espera a agente y entra llamada.
|-
|'''Agente Hablando'''||Espera a agente y entra llamada||Espera a agente y entra llamada.
|-
|'''Agente en Tiempo administrativo'''||Espera a agente y entra llamada||Espera a agente y entra llamada.
|-
|'''Agente no logado'''||Entra llamada a otro agenete disponible||Consume intento.
|-
|'''Agente con una pestaña de chat abierta y el otro agente en pausa'''||Entra llamada a otro agente disponible||Espera a agente y entra llamada.
|-
|'''Agente con dos pestañas de chat abiertas'''||Espera a agente y entra llamada||Espera a agente y entra llamada.
|-
|}

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Movilidad ===
La movilidad es una función integral de las comunicaciones en la empresa. Cualquier empleado (usuario) es móvil en cierto grado, ya sea dentro o fuera de la organización. La solución óptima debe proporcionar continuidad de servicios y acceso a nuestros servicios, sin importar donde estemos.

==== Ofrecer movilidad a un usuario ====

Para permitir la movilidad a un usuario, puede ser en el momento de crear o editar un usuario en el apartado ''Administración de usuario'' en ''General'' del '''portal de administración ''VIVA''it'''. Asignándole un '''''numero login''''' (numero personal corporativo para el usuario) y una '''''clave login''''' ( se debe asignar una clave por defecto, pero puede cambiarla en el [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_3.0#Portal_de_usuario |portal de usuario]]). Para más información[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Pesta.C3.B1a_Centralita | ver sección Portal de administración - General - Usuarios - administración de usuarios - Pestaña Centralita]].

Además, de crear un permiso de la '''aplicación ''Centralita''''' a cualquier nivel, desde el apartado ''Permisos de usuarios'' en ''General'' del '''portal de administración ''VIVA''it'''. Para más información[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Asignaci.C3.B3n_de_Permisos_de_Usuario_por_Administrador | ver sección Portal de administración - General - Usuarios - Permisos a usuarios]]

'''La movilidad permite''' disponer de las extensiones telefónicas empresariales en cualquier lugar. Por
ejemplo, con un ordenador portátil o smartphone en una ubicación remota con conexión a Internet,
podríamos tener registrada nuestra extensión remotamente, y así las llamadas hacia/desde nuestra
oficina serían enrutadas por Internet hasta el equipo en cuestión sin coste alguno.


Todo terminal tiene asociado una extensión y deberá permitir la movilidad de usuarios. La extensión se configura cambiando a '''''SI''''' el campo '''''Hay Movilidad''''' desde el apartado ''Extensiones'' de ''Dispositivos'' en ''VIVAit Call'' del '''portal de administración ''VIVA''it'''. Para más información [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Extensiones | ver sección Portal de administración - VIVAit Call - Dispositivos - Extensiones]]

==== ¿Cómo funcionan las extensiones? ====

Primeramente el usuario debe tener los ejes apropiados en la tabla '''COM_USUARIOS_APLICACION''' (aplicación centralita).

La extensión debe de tener ''un teléfono'' y por tanto ''un modelo de teléfono asociado.''

Es tan simple como especificar '''la extensión, el usuario y la clave de este.'''

Para corroborar el funcionamiento de esta hay ''dos métodos'':

'''* CLI asterisk:'''

'''mdintz qry * nimitz bd extenEntraUsuarioMovil 25001 20001 1234'''

Y como resultado obtenemos lo siguiente:

mdintz Variables: 
MdintzIdentif='cms1' 
MOVIL_TIPO_RESET='10' 
MOVIL_CAD_RESET='notify_yealink' 
MdintzRes='OK'

El usuario con el login numérico 20001 se ha "movido" a la extensión 25001

Ahora ''nos quitamos de esa extensión mediante el siguiente comando:''

'''mdintz qry * nimitz bd extenSaleUsuarioMovil 25001'''

Resultado del comando:

mdintz Variables: 
MdintzIdentif='cms1' 
MOVIL_TIPO_RESET='10' 
MOVIL_CAD_RESET='notify_yealink' 
MdintzRes='OK'

Las pruebas anteriores han sido '''con extensiones con movilidad y con usuario con/sin
propietario.'''

Ahora las realizamos '''con extensiones sin movilidad'''

'''mdintz qry * nimitz bd extenEntraUsuarioMovil 25002 20001 1234'''

Obteniendo:

mdintz Variables: 
MdintzIdentif='cms1' 
MdintzRes='movil_error_datos'

Como era lo previsible no nos deja "movernos" a esa extensión ya que no tiene movilidad.


'''Si un usuario ya se ha movido a una extensión y se mueve a otra, el sistema lo deslogará de la primera para logarlo en la segunda.'''

'''mdintz qry * nimitz bd extenEntraUsuarioMovil 21000 20001 1234'''

Con salida:

mdintz Variables: 
MdintzIdentif='cms1' 
MOVIL_EXTEN='25001' 
MDintzRes='movil_ya_login'

'''* Dialplan'''

Para llamar a la función de movilidad hay que marcar el '''9992.'''

Nota.- Para comprobar que se realiza todo correctamente habría que mirar las trazas de Asterisk

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Grabación ===

La grabación en '''''VIVA'''''it Call está diseñada para ser lo mas flexible posible.

====Configuración====

Si deseamos grabar, debemos activar que alguno de los dispositivos/elementos que intervienen en la llamada se grabe.

Estos dispositivos/elementos son:

* Nodo.
* Usuario con Centralita.
* Agente.
* Grupo ACD corporativo y de Contact Center.
* Enlace exterior.
* Extensión.
* Facilidades.
* Grupo: grupo de salto o grupo de operadoras.
* Sala de conferencia.
* VDN corporativo y de Contact Center.
* Pre-rutas.

Por otro lado necesitaremos que la llamada pase por un nodo que sea grabador, es decir, que si la llamada esta configurada para que se grabe pero no pasa por ningún nodo grabador, la llamada no se grabará.

Al configurar un nodo existen cuatro campos que intervienen en la grabación.

''''Grabador''''

Se configura en el portal en la sección general/nodos.

Este campo corresponde con el campo [[BD.COM_NODOS#B_ES_GRABADOR|B_ES_GRABADOR]] de la tabla [[BD.COM_NODOS|COM_NODOS]] , este campo define si el nodo va a grabar las llamas que pasen por el que necesiten ser grabadas y no se estén grabando ya.

Es un campo booleano los posibles valores en el portal son si/no y en la base de datos 1/0.

''''Modo grabación infraestructura''''

Su configuración se realiza en el portal, en la sección general/nodos.

Este campo define como está configurada la infraestructura, este campo existe por compatibilidad con '''''VIVA'''''it suite y para poder configurar la grabación bajo demanda.

Este campo corresponde con el campo [[BD.COM_NODOS#E_MODO_GRABACION_INFRAESTRUCTURA|E_MODO_GRABACION_INFRAESTRUCTURA]] de la tabla [[BD.COM_NODOS|COM_NODOS]], Este campo usa los valores del enumerado BD.ENUM.TModoGrabacionInfraestructura|TModoGrabacionInfraestructura]].

La formula que se seguiría para ver si una llamada se graba en ese nodo es:
{|
|
|-
|
(NODO.E_MODO_GRABACION_INFRAESTRUCTURA) AND (NODO.B_ENRU_GRABAR OR CEN_PRE_RUTA.B_ENRU_GRABAR OR "OBJETO".B_ENRU_GRABAR)
|}

Que sería que si la infraestructura esta en NoGraba no se graba nada de lo que se rute en ese nodo y en cualquiera de los 2 otros caso (GrabaTodo o GrabaPorPeticion) se grabaría dependiendo de la configuración del Nodo, la ruta o el objeto en cuestión (preruta, grupo ACD, extension,...).

''''Grabar enrutamiento''''

Se configura en el portal en la sección general/nodos.

Este campo define si van a grabar las llamadas que se enruten en este nodo.

Campo [[BD.COM_NODOS#E_ENRU_GRABAR|E_ENRU_GRABAR]] de la tabla [[BD.COM_NODOS|COM_NODOS]] que usa los valores del enumerado [[BD.ENUM.TTipoEnruGrabar|TTipoEnruGrabar]].

''''RecordCentral''''

Se configura en el portal en la sección general/nodos.

Define que instancia del recordCentral es la encargada de tratar las grabaciones de este nodo.

Para aumentar el rendimiento a la hora de traerse las grabaciones, se pueden definir varias instancias de proceso recordCentral, este campo define cual de estas instancias se encargara de este nodo.

====Vivait Tracker====

Desde '''''VIVA'''''it Supervisor, que es la aplicación dirigida a Supervisores, ofrece la posibilidad de supervisar y gestionar grupos ACD, agentes, asignaciones, prioridades,etc. Se puede obtener acceso directo a las aplicaciones de grabación ('''''VIVA'''''it tracker)


Esquematico actual del proyecto tracker
[[Archivo:Esquematico_tracker_1.jpg|center]]

1º El tracker web llama al web service Remote login para iniciar sesión y determinar si tiene permisos para la escucha y descarga de grabaciones.

2º Si la ubicación de la grabación es local, mira la ruta de esta y se procede a la escucha o descarga de esta.

3º Si la ubicación de la grabación es remota, entra en escena el proxy. Es el que realiza la petición.

4º Si utilizamos el tracker windows, este, como el tracker web, llama primero al web service remote login para la autenticación y tema de Permisos.

5º Para descargar o escuchar una grabación desde el tracker windows, se llama al web service servidor de grabaciones pasándole simplemente el ID de segmento.mp3. Este web service, con el ID de segmento, se encarga de determinar la ubicación de la grabación.

Esquematico actual del proyecto tracker
[[Archivo:Esquematico_tracker_2_https.jpg|center]]

1º El tracker web llama al web service Remote login para iniciar sesión (comunicación https) y determinar si tiene permisos para la escucha y descarga de grabaciones. Se elimina el proxy

2º Si la ubicación de la grabación es local, mira la ruta de esta y se procede a la escucha o descarga de esta.

3º Si la ubicación de la grabación es remota, se realiza una petición al host remoto. El tipo de petición vendrá fijada por base de datos (http, https, ftp,ftps)

4º Si utilizamos el tracker windows, este, como el tracker web, llama primero al web service remote login para la autenticación y tema de permisos (comunicación https extremo a extremo).

5º Para descargar o escuchar una grabación desde el tracker windows, se llama al web service servidor de grabaciones pasándole simplemente el ID de segmento.mp3. Este web service, con el ID de segmento, se encarga de determinar la ubicación de la grabación.

[[#Grabación_(Vivait_Tracker)| Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operación_plataforma_VIVAit Volver al indice]]

=== Enrutamiento ===

[[Archivo:Enrutamiento.png|885px |center]]

==== Enfoque inicial ====

[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Enfoque_inicial Acceso]

==== Funcionamiento ====
El proceso de enrutamiento, como vimos en el esquemático, se compone de dos fases:

# Preenrutameinto, que se encarga de tratar todas las llamadas
# Enrutamiento externo, que tiene módulos dedicados al enrutamiento hacia:
:*Enlaces externos.
:*Extensiones.
:*Usuarios de telefonía corporativa.
:*Facilidades.
:*Salas de conferencia.
:*Agentes de grupos ACD.
:*Grupos ACD.
:*Vdn.
:*Buzones para dejar mensaje.
:*Buzones para su gestión.

Se asume que existen rutas directas entre todos los nodos de la red.

Se asume que están directamente enrutadas todas las direcciones IP involucradas, tanto nodos, como terminales.

Se asume que todas las facilidades están disponibles en todos los nodos, aunque es posible que la implementación sea diferente entre ellos.

Los datos de entrada básicos al proceso de enrutamiento (pdEntr) son:
* Dispositivo
* Cola
* Origen
* Nodo entrada
* UCID
* CALLER_ID_NAME
* CALLER_ID_NUM
* DNIS
* Desvío por dialplan

A partir de los datos de entrada básicos anteriores se pueden deducir los siguientes valores:
* Sede del dispositivo de entrada
* Sede del nodo de entrada
* Ancho de banda disponible en la sede del dispositivo
* Ancho de banda disponible en la sede del nodo
* Categoría entrante
* Valor del eje1 asignado a la llamadas
* CALLER_ID_NUM_EXTERNO

Los datos de salida globales del proceso de enrutamiento (pdSale) son:
* Categoría saliente
* Código de cliente (opcional)
* Tipo de destino:
:* No existe
:* Ruta externa
:* Extensión
:* Usuario de telefonía corporativa
:* Facilidad
:* Salas de conferencia
:* Agentes de grupos ACD
:* Grupos ACD
:* VDN
:* Buzón para dejar mensaje.
:* Buzón para dejar mensaje por ocupado.
:* Buzón para dejar mensaje por no contestación.
:* Buzón para su gestión.
* Destinatario (cuando se trata de un usuario o de un agente)
* Valor del eje1 asignado a la llamada
* Buzón de las extensiones y usuarios que los tengan asignados
* Si el buzón está en nodo distinto al de entrada
* DESVIO_INCONDICIONAL (sólo extensiones y usuarios) (valor MENSA=desvio_mensajeria en variable)
* DESVIO_NO_CONTESTA (sólo extensiones y usuarios) (valor MENSA=desvio_mensajeria en variable)
* DESVIO_OCUPADO (sólo extensiones y usuarios) (valor MENSA=desvio_mensajeria en variable)
* DESVIO_FUERA_SERV (sólo extensiones y usuarios) (valor MENSA=desvio_mensajeria en variable)

Los datos de salida para cada una de las posibles rutas en orden son (nn va de 01 maxRutas [nn son dos dígitos decimales]):
* CONTADOR_ABDE_nn (contador para control de ancho de banda en sede de dispositivo de entrada).
* CONTADOR_ABNE_nn (contador para control de ancho de banda en sede de nodo de entrada).
* CONTADOR_ABDS_nn (contador para control de ancho de banda en sede de dispositivo de salida).
* CONTADOR_ABNS_nn (contador para control de ancho de banda en sede de nodo de salida).
* CALLER_NAME_SAL_nn , puede salir de una extensión, un usuario o de un agente.
* CALLER_NUM_SAL_nn, puede salir de una extensión, un usuario o de un agente.
* DESTINO_SAL_nn , en general, el valor C_NOMBRE o destino de salida.
* RUTA_NODO_nn , Cadena de marcación para ir la nodo que soporta DESTINO_SAL_nn, si es distinto del nodo de entrada.
* RUTA_SAL_nn
:* Extensión: cadena marcación.
:* Facilidad: E_CODIGO_FACILIDAD obtenido de la tabla CEN_FACILIDADES.
:* Usuario: cadena marcación de la extensión asignada al usuario en movilidad o en propiedad.
:* Agente: cadena marcación de la extensión a la que está conectado el agente.
:* Ruta externa: contexto que gestiona la llamada saliente.

=====Fase preenrutamiento =====

La fase de preenrutamiento (basada en la tabla CEN_PRE_RUTA) se usa en todas las llamadas entrantes, tanto internas, como externas. Permite desarrollar un “prerouting” estándar para ACD y para telefonía corporativa.

Los datos de entrada al proceso de enrutamiento son iguales a los del proceso global de enrutamiento, excepto en que este proceso no usa el nodo de entrada ya que es independiente de éste.

Los datos de salida de la fase de preenrutamiento:
* D_CATEGORIA_SAL
* COD_CLIENTE (opcional)
* TIPO_DESTINO_SAL
:* No existe.
:* Volver a preenrutar.
:* Ruta externa.
:* Extensión.
:* Usuario de telefonía corporativa.
:* Facilidad.
:* Sala de conferencia.
:* Agente de grupos ACD.
:* Grupos ACD.
:* VDN.
:* Buzón para dejar mensaje.
:* Buzón para dejar mensaje por ocupado.
:* Buzón para dejar mensaje por no contestación.
:* Buzón para su gestión.
* COD_CLIENTE
* Valor del eje1 asignado a la llamada
* CALLER_NAME
* CALLER_NUM
* DESTINO

El proceso de preenrutamiento consiste en seleccionar un único registro de la tabla CEN_PRE_RUTA y, con sus valores y con los valores de entrada al proceso, generar los datos de salida.

Un posible tipo de salida es "Volver a preenrutar". Esto permite realimentar el proceso un máximo de "max_pre_ruta_regs" veces (en archivo .conf) para simplificar configuración. Sólo tiene sentido realimentar si se ha hecho alguna modificación en los datos de selección de registro, ya que en caso contrario se produciría un bucle que el proceso de preenrutamiento es capaz de detectar y evitar.

Para elegir el registro de CEN_PRE_RUTA, se tienen en cuenta los datos de entrada de la llamada, de modo que se cumpla con todos los puntos siguientes:
* ID_CATEGORIA_ENT igual a la del dispositivo de entrada.
* CALLER_NUM de entrada
:* Debe comenzar por la cadena C_ORIGEN_ENT_PREF o C_ORIGEN_ENT_PREF=NULL, con menos prioridad. Es conveniente rellenar este dato del modo más restrictivo que sea posible, independientemente de C_ORIGEN_ENT_EXPR. Ello permite disminuir el uso innecesario de recursos de evaluación de expresiones regulares.
:* Debe de tener un número de dígitos igual o superior a N_ORIGEN_ENT_MIN_DIGITOS, si este valor no es NULL o cero.
:* Debe de tener un número de dígitos igual o inferior a N_ORIGEN_ENT_MAX_DIGITOS, si este valor no es NULL o cero.
:* Debe cumplir la expresión regular C_ORIGEN_ENT_EXPR, si ésta no es NULL.
* DNIS empiece con C_DESTINO_ENT_PREF o C_DESTINO_ENT_PREF=NULL. Es conveniente rellenar este dato del modo más restrictivo que sea posible, independientemente de C_DESTINO_ENT_EXPR. Ello permite disminuir el uso innecesario de recursos de evaluación de expresiones regulares.
* Si varias entradas cumplen la condición anterior, se prueba primero la que el campo C_DESTINO_ENT_PREF tenga una longitud mayor y, de entre éstas, la que C_ORIGEN_ENT_PREF tenga una longitud mayor.
* DNIS tenga un número de dígitos igual o superior a N_DESTINO_ENT_MIN_DIGITOS, si este valor no es NULL o cero.
* DNIS tenga un número de dígitos igual o inferior a N_ORIGEN_ENT_MIN_DIGITOS, si este valor no es NULL o cero.
* DNIS cumpla la expresión regular C_DESTINO_ENT_EXPR, si ésta no es NULL.

Si no se encuentra ninguna entrada adecuada, quiere decir que es una llamada prohibida y se devuelve el tipo de destino "No existe".

Puede conseguirse un destino "por defecto" diferente, creando una entrada que encaje siempre para cada categoría: C_ORIGEN_ENT, C_ORIGEN_ENT_MIN_DIGITOS, C_ORIGEN_ENT_MAX_DIGITOS, C_ORIGEN_ENT_EXPR, C_DESTINO_ENT_PREF, N_DESTINO_ENT_MIN_DIGITOS, N_DESTINO_ENT_MAX_DIGITOS y C_DESTINO_ENT_EXPR a valor NULL.

Una vez elegida una entrada, ésta puede transformar o sustituir el valor de ID_CATEGORIA, CALLER_NAME, CALLER_NUM, DESTINO, COD_CLIENTE y/o EJE1_MSK a la salida del proceso.

Si ID_CATEGORIA_SAL es cero, se propaga a la salida el valor de la entrada. En caso contrario, se sustituye.

Si C_CALLER_NAME está vacío, se mantiene el valor hubiese a la entrada. En caso contrario, se sustituye.

C_CALLER_NUM puede contener una cadena que identifica el nuevo CALLER_NUM. Además, si la cadena comienza por los caracteres que se indican, el significado es especial:
* "=" o cadena vacía, el nuevo CALLER_NUM es igual al de entrada al proceso.
* "+" el nuevo CALLER_NUM es igual al de entrada al proceso, con los caracteres a continuación de "+" como prefijo.
* "-" se quita el número de caracteres que se indica a continuación de "-".
* "_" lo que sigue al carácter es una expresión regular que se aplica al CALLER_NUM de entrada. Dicha expresión regular tiene obligatoriamente que contener una subcadena (definida entre paréntesis, según el estándar de expresiones regulares) que nos da el nuevo CALLER_NUM de salida. Si la expresión regular no se cumpliese, se propagará el valor de entrada al proceso.
* cualquier otro valor del primer carácter determina que es una constante que sustituye el valor a la entrada.

Cada vez que se utilice una preruta, se incrementará el valor de N_CONTA si el valor de N_UMBRAL es mayor que cero.

Un valor N_UMBRAL mayor que cero permite modificar el destino de salida cuando el valor de actual de N_CONTA (antes de incrementarse) supere o sea igual el valor de N_UMBRAL. Si se cumple la condición indicada, se usa como destino tras el preenrutamiento, los valores de los campos E_TIPO_DESTINO_SAL_2 y C_DESTINO_SAL_2.

Si el valor de N_UMBRAL es menor o igual a cero o si N_CONTA es inferior a N_UMBRAL, se usa como destino tras el preenrutamiento, los valores de los campos E_TIPO_DESTINO_SAL_1 y C_DESTINO_SAL_1.
Con este mecanismo de N_CONTA y N_UMBRAL, se pretende facilitar el discriminar a los llamantes reincidentes, cuando sea necesario.

Un proceso periódico externo debe encargarse de poner a cero o decrementar el valor de N_CONTA.
Como resultado de los procesos de filtrado y de verificación anteriores, se habrá obtenido un TIPO_DESTINO_SAL y un C_DESTINO_SAL a partir de los campos con sufijo "_1" o "_2", con una metodología similar al caso C_CALLER_NUM.

C_DESTINO_SAL_x puede contener cadena que permite obtener el nuevo destino. Además, si la cadena comienza por los caracteres que se indican, el significado es especial:
* "=" o cadena vacía, el nuevo destino es igual al de entrada al proceso.
* "+" el nuevo destino es igual al de entrada al proceso, con los caracteres a continuación de "+" como prefijo.
* "-" se quita el número de caracteres que se indica a continuación de "-".
* "_" lo que sigue al carácter es una expresión regular que se aplica al destino de entrada. Dicha expresión regular tiene obligatoriamente que contener una subcadena (definida entre paréntesis, según el estándar de expresiones regulares) que nos da el nuevo destino de salida. Si la expresión regular no se cumpliese, quiere decir que es una llamada prohibida y se encaminará hacia una facilidad por defecto.
* cualquier otro valor del primer carácter determina que es una constante que sustituye el valor a la entrada.
Información de salida del proceso de preenrutamiento: Cuando TIPO_DESTINO_SAL_x toma los valores que se indican, el proceso global de enrutamiento sólo requiere de preenrutamiento y la información a devolver se obtiene dependiendo de TIPO_DESTINO_SAL_x:
* No existe: Se asume que no se conoce un destino para los datos de entrada, por lo que la llamada se encamina hacia una facilidad por defecto que gestiona su tratamiento.
* Extensión: A partir de las tablas CEN_DISPOSITIVOS, CEN_EXTENSIONES y CEN_NODOS, se devolverán los valores que permiten alcanzar la extensión en el nodo principal y en el secundario.
* Facilidad: A partir de las tablas CEN_DISPOSITIVOS, CEN_FACILIDADES y CEN_NODOS.
* Usuario de telefonía corporativa: A partir de las tablas CEN_USUARIOS, CEN_DISPOSITIVOS, CEN_EXTENSIONES y CEN_NODOS, se devolverán los valores que permiten alcanzar al usuario en el nodo principal y en el secundario de la extensión que corresponde en base a movilidad, con prioridad, o en base a propiedad. El caso de movilidad no se tiene en cuenta si el proceso de enrutamiento se realiza en "modo supervivencia".
* Sala conferencia: A partir de las tablas CEN_SALAS_CONFERENCIAS y CEN_NODOS.
* Agente de ACD: A partir de las tablas ACD_USUARIOS, DAT_TR_ACD_EXTENSIONES, CEN_DISPOSITIVOS, CEN_EXTENSIONES y CEN_NODOS, se devolverán los valores que permiten alcanzar al agente en el nodo principal y en el secundario.
* VDN: A partir de las tablas ACD_VDN y CEN_NODOS, se devolverán los valores que permiten alcanzar al VDN en su nodo.
* Grupo ACD: A partir de las tablas ACD_COLAS y CEN_NODOS, se devolverán los valores que permiten alcanzar al grupo ACD en su nodo.

El campo B_GENERAR_SEGMENTO de la tabla CEN_PRE_RUTA indica al proceso de preenrutamiento que es preciso generar un segmento de tipo "preenrutamiento". En el segmento generado, se rellena el campo C_ETIQUETA1 del nuevo segmento con el valor que contiene el campo homónimo del registro asociado en la tabla CEN_LISTA_PRE_RUTAS.

===== Fase de enrutamiento en casos en que el destino no es externo =====
Datos de entrada al proceso de enrutamiento externo: iguales a los de salida del proceso de preenrutamiento (pdPreSale), uniéndose a éstos los datos globales de entrada al proceso (pdEntr).

Datos de salida de la fase de enrutamiento: iguales que los del proceso global de enrutamiento (pdSale).

Específicamente y sólo para los casos en que el destino es una extensión (tipo de destino extensión, usuario de telefonía corporativa o agente) es cuando son válidos los datos correspondientes al buzón asociado y los datos de los posibles desvíos previstos.

También en este caso, se prevén dos posibles rutas, una se corresponde con el acceso a la extensión en el nodo principal de ésta y la otra en el nodo secundario.

En el resto de tipos de destino, sólo se prevé una ruta que puede incluir o no un enlace internodal.

===== Fase de enrutamiento en el caso de destino externo =====
Datos de entrada al proceso de enrutamiento externo: iguales a los de salida del proceso de preenrutamiento (pdPreSale), uniéndose a éstos los datos globales de entrada al proceso (pdEntr).
Datos de salida de la fase de enrutamiento: iguales que los del proceso global de enrutamiento (pdSale).

Se elige los primeros "max_ruta" registros (configurado en archivo .conf) en CEN_DESTINOS_EXTERNOS unido con CEN_RELACION_DESTINOS_ENLACES_EXTERNOS que, teniendo en cuenta los datos de entrada al proceso de enrutamiento, cumpla con todos los puntos siguientes:
* ID_CATEGORIA_ENT igual a la de salida del proceso de preenrutamiento.
* C_DESTINO_SAL de proceso de preenrutamiento empiece con C_DESTINO_ENT_PREF.
* Si varias entradas cumplen la condicion anterior, se prueba primero la que el campo C_DESTINO_ENT_PREF tenga una longitud mayor.
* C_DESTINO_SAL tenga un número de dígitos igual o superior a N_DESTINO_ENT_MIN_DIGITOS, si este valor no es NULL o cero.
* C_DESTINO_SAL tenga un número de dígitos igual o inferior a N_DESTINO_ENT_MAX_DIGITOS, si este valor no es NULL o cero.
* C_DESTINO_SAL cumpla la expresión regular C_DESTINO_ENT_EXPR, si ésta no es NULL.

Aparte de la longitud del campo C_DESTINO_ENT_PREF, se usa N_PRIORIDAD como campo para ordenar los registros y seleccionar lo "max_ruta" primeros.

Una vez que un registro es válido, se descartan todos los registros cuyo C_DESTINO_ENT_PREF es diferente del primero seleccionado.

Como resultado de los procesos de filtrado y de verificación anteriores, se habrá obtenido hasta un máximo de "max_rutas" valores para posibles rutas. Las posibles propagaciones y transformaciones en los datos de cada ruta son función de los datos de cada registro seleccionado:

CALLER_NAME_nn: Si C_CALLER_NAME está vacío, se propaga el valor de entrada. En caso contrario, se sustituye.

CALLER_NUM_nn: Sale de C_CALLER_NUM que puede contener una cadena que identifica el nuevo CALLER_NUM_n. Además, si C_CALLER_NUM comienza por los caracteres que se indican, el significado es especial:
* "=" o cadena vacía, el nuevo CALLER_NUM_nn es igual al de entrada al proceso.
* "+" el nuevo CALLER_NUM_nn es igual al de entrada al proceso, con los caracteres a continuación de "+" como prefijo.
* "-" se quita el número de caracteres que se indica a continuación de "-".
* "_" lo que sigue al carácter es una expresión regular que se aplica al CALLER_NUM de entrada. Dicha expresión regular tiene obligatoriamente que contener una subcadena (definida entre paréntesis, según el estándar de expresiones regulares) que nos da el nuevo CALLER_NUM de salida. Si la expresión regular no se cumpliese, se propaga el valor de entrada al proceso.
* ">" Si existe valor para CALLER_NUM_EXTERNO, se propagará éste a la salida. En caso contrario y si no está vacía la cadena que queda al eliminar el prefijo ">", se susituye en la salida por el valor de la cadena sin prefijo. Si la cadena estuviese únicamente constituida por el valor ">", se propaga el valor de entrada.
* cualquier otro valor del primer carácter determina que es una constante sin ninguna modificación.

C_DESTINO_SAL_nn: Se obtiene a partir de C_DESTINO_SAL que puede contener una cadena que identifica el nuevo destino. Además, si la cadena comienza por los caracteres que se indican, el significado es especial:
* "=" o cadena vacía, el nuevo destino es igual al de entrada al proceso.
* "+" el nuevo destino es igual al de entrada al proceso, con los caracteres a continuación de "+" como prefijo.
* "-" se quita el número de caracteres que se indica a continuación de "-".
* "_" lo que sigue al carácter es una expresión regular que se aplica al destino de entrada. Dicha expresión regular tiene obligatoriamente que contener una subcadena (definida entre paréntesis, según el estándar de expresiones regulares) que nos da el nuevo destino de salida. Si la expresión regular no se cumpliese, se propaga el valor de entrada al proceso.
* cualquier otro valor del primer carácter determina que es una constante sin ninguna modificación.

RUTA_NODO_nn: Sólo se usa si el nodo de salida es diferente del nodo de entrada. Contiene la cadena de marcación para ir la nodo que soporta DESTINO_SAL_nn. Sale del campo C_FORMATO_DIAL (sustituyendo variables) correspondiente al tipo de dispositivo del enlace exterior.

RUTA_SAL_nn: Es el campo C_DATO_ASTERISK obtenido a partir del registro en la tabla CEN_ENLACE_EXTERIOR que se corresponde con ID_ENLACE_EXTERIOR de la tabla CEN_RELACION_DESTINOS_ENLACES_EXTERNOS.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Control de ancho de banda ===

Para el control de ancho de banda, primero hemos de tener en consideración que una llamada puede tener asociadas hasta cuatro sedes
:* Sede del terminal origen (terminal A)
:* Sede del nodo de registro del terminal origen (nodo A)
:* Sede del terminal destino (terminal B)
:* Sede del nodo de registro del terminal destino (nodo B)

Además hemos de tener en cuenta que el audio de la conversación podrá ir:
:* De manera directa entre terminal A y terminal B
:* De manera indirecta, a través de los nodos A y B

[[Archivo:ancho de banda.png|700px]]

Cuando se va a cursar una llamada de terminal A a terminal B, el proceso de enrutamiento del nodo A devuelve 4 variables de canal al dialplan:

{| class="wikitable"
|-
! Variable!!Campos
|-
|R_ABDE_xx||R = Variable de rutas --- AB = ancho de banda --- D = dispositivo --- E = Entrante --- xx = de 0 a 3
|-
|R_ABNE_xx||R = Variable de rutas --- AB = ancho de banda --- N = nodo --- E = Entrante --- xx = de 0 a 3
|-
|R_ABDS_xx||R = Variable de rutas --- AB = ancho de banda --- D = dispositivo --- S = Saliente --- xx = de 0 a 3
|-
|R_ABNS_xx||R = Variable de rutas --- AB = ancho de banda --- N = nodo --- S = Saliente --- xx = de 0 a 3
|-
|}

El valor de cada variable es una cadena del tipo '''AB.wwww.xxxx.y.z''' donde cada valor es:
:* '''wwww''' --> id de sede
:* '''xxxx''' --> ancho de banda total de la sede
:* '''y''' --> número de llamadas a sumar si conversación directa
:* '''z''' --> número de llamadas a sumar si conversación indirecta

Por otro lado tenemos que tener en cuenta que el dialplan tiene control de las llamadas que cada sede puede cursar

De esta forma, cuando existe una nueva llamada el dialplan aplica la fórmula, suma el resultado al número de llamadas en curso y lo compara con el máximo...si el resultado es mayor que le máximo la llamada no se cursará por congestión

Configuraremos el ancho de banda por sede en el portal de administración y el consumo que hace cada llamada en la variable '''AB_CONSUMO_LLAMADA''' del fichero '''ext_MDtel_particular.conf''' de cada nodo de conmutación; el valor por defecto es 32

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

== Puesto de trabajo ==
El puesto de trabajo del agente en la plataforma '''''VIVA'''''it (para el producto '''''VIVA'''''it Suite) estará compuesto por:
* PC (típicamente windows) en el que reside la aplicación '''''VIVA'''''it Desk
* Terminal telefónico con extensión física asociada.

Para más información [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Puestos | ver sección Portal de administración-VIVAit Suite ACD+ - Puestos]].

=== Relación PC/teléfono en puesto de trabajo ===

Existirá una relación única entre nombre PC y extensión física asociada, si bien los agentes se identificarán por su login que les acompaña al puesto de trabajo en el que se loguen
Existe un procedimiento documentado para la operativa de cambio de puesto de trabajo, en caso de ser necesario el cambio de PC o de teléfono de un puesto de trabajo.
==== Procedimiento para un cambio de puesto de trabajo ====
Se basa en una asignación de PC a teléfono relaccionando la extensión telefónica del terminal físico con el nombre del puesto de trabajo. La configuración de dicha asociación se realiza en el portal de administración de la plataforma.

Cualquier cambio que se realice en terminal telefónico o PC de agente ha de mantener la asociación en el portal a efectos de permitir el funcionamiento del sistema.

A continuación se reflejan los cambios más habituales:

{| class="wikitable"
|-
! Cambio !! Procedimiento !! Punto de acción
|-
|rowspan="2"| Cambio de ubicación de un PC || Opción 1.- Renombrar el PC para que conserve el nombre que tenía el anterior en esa ubicación || PC de agente
|-
| Opción 2.- Rehacer la asignación extensión/puesto || Portal de administración
|-
| rowspan="2"| Instalación de PC nuevo en puesto existente || Opción 1.- Renombrar el PC para que conserve el nombre que tenía el anterior en esa ubicación || PC de agente
|-
| Opción 2.- Rehacer la asignación extensión/puesto || Portal de administración
|-
| Cambio de nombre en un PC || Rehacer asignación extensión/puesto || Rehacer asignación extensión/puesto
|-
|Cambio de ubicación de un teléfono || Rehacer la asignación extensión/puesto
|| Portal de administración
|-
| Instalación de un teléfono nuevo en puesto existente || Rehacer la asignación extensión/puesto || Portal de administración
|-
| Instalación de un nuevo puesto de agente|| Hacer asignación extensión/puesto || Portal de administración
|}


=== Estructura de aplicaciones en puesto de trabajo ===
Las aplicaciones del puesto de trabajo pueden estar ubicadas en cualquier carpeta del sistema. Es importante tener en cuenta que los procesos de actualización, logs… escriben en dichas carpetas, por lo que el usuario de windows deberá tener permisos de lectura/escritura y borrado sobre dichas carpetas
La instalación del puesto de trabajo es muy liviana para el sistema; las aplicaciones ocupan poco espacio y no se modifican ficheros del sistema operativo (registry o similares)
Los ficheros importantes son
{| class="wikitable"
|-
! Fichero !! Descrición
|-
| Vivait-desk.exe || Contiene la aplicación '''''VIVA'''''it Desk de agente
|-
| vivait_desk_dll.dll||Este fichero contiene controles sobre los formularios (controles de
texto, algunas reglas de obligatoriedad…)
|-
| nimitz.ini || Configuración del puesto de agente
|-
| lanzador.exe || Aplicación de actualización de versiones
|-
| lanzador.ini || Configuración del actualizador de aplicaciones
|-
| Carpeta forms || En esta carpeta están ubicados los formularios que se abren ante llamada entrante o saliente
|-
| Carpeta imágenes || Contiene las imágenes izquierda y derecha de la barra de '''''VIVA'''''it Desk
|-
|}

=== Secciones de utilidad en nimitz.ini ===

==== Configuración del puesto de agente ====

El fichero nimitz.ini contiene la configuración del puesto de agente; sus principales parámetros son:

{| class="wikitable" border="0" style="background:#ffffff" align="top"
|-
| |''' Fichero'''
|| '''Descripción'''
|-
|Sección [bd1]
||host="ip_BBDD_tiempo_real"
puerto="Nº puerto"
basedatos="nimitz"
usuario="nimitz"
clave="UIk5jMY9PVX6ogg="

Contiene información para la conexión a BBDD de tiempo real, en la que '''''VIVA'''''it Desk fundamentalmente inserta información
|-
|Sección [bd2]
||host=" ip_BBDD_replica "
puerto="Nº puerto"
basedatos="nimitz"
usuario="nimitz"
clave="UIk5jMY9PVX6ogg="

Contiene información para la conexión a BBDD de réplica, en la que '''''VIVA'''''it Desk solo leerá información
|-
|Sección [telefono]
||pruebas=1 (Valores válidos 0 ó 1)
Activación de funcionalidad "servicio técnico" en '''''VIVA'''''it Desk.

puesto="Nombre puesto"
|-
|Sección [trazas]
|| nivel=3

archivo=1

consola=0

sobreescribir=1

Activación de generación de ficheros de trazas "viva-desk.log" en carpeta de aplicaciones
|}

=== Parámetros en invocación a '''''VIVA'''''it Desk ===

La aplicación '''''VIVA'''''it Desk puede ser invocada con una serie de parámetros que condicionan su funcionamiento; los parámetros son:
* Primer parámetro: Nombre del archivo .ini; usado como alternativa al fichero por defecto "nimitz.ini"
* Segundo parámetro: Nombre de puesto; usado como alternativa al nombre de puesto del ordenador
* Tercer parámetro: Nombre de login; para forzar un usuario; es de utilidad si el sistema está configurado como "confiar en sistema operativo", en cuyo caso no permite seleccionar un login de agente para acceder a la aplicación

=== Instalación y actualización de aplicaciones de puestos de trabajo ===
La instalación y actualización de las aplicaciones en el puesto de trabajo pasan por disponer de los ficheros “lanzador.exe” y “lanzador.ini” (debidamente configurado) dentro de la carpeta en la que se desee instalar.
Lanzando la aplicación “lanzador.exe” se instalará o actualizará el sistema.

El fichero “lanzador.ini” tiene el siguiente aspecto:
URL="http://IP_Servidor:8180/WSActualizaXML/actualizar.xml"
BASE_URL_DESCARGAS="http://IP_servidor:8180/XMLFILES/"

=== Servicio técnico en '''''VIVA'''''it Desk ===
La activación de la funcionalidad de servicio técnico en '''''VIVA'''''it Desk nos permite realizar sincronizaciones manuales de la aplicación y activar trazas a nivel de Base de Datos o a nivel de log sobre el propio '''''VIVA'''''it Desk. Pulsando el botón derecho del ratón sobre la barra '''''VIVA'''''it Desk accederemos a las capacidades de soporte técnico
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

== Funcionamiento de la plataforma en modo emergencia ==
== Accesos Web ==

{| class="wikitable"
|-
! Aplicación !! Enlace
|-
|Portal de administración '''''VIVA'''''it Suite || http://ip_admin:8180/Vivait-Call
|-
|'''''VIVA'''''it Tracker||http://ip_tracker:8180/Vivait-Tracker
|-
|Monitor Web||http://ip_monitor:8180/MonitorWeb
|-
|Monitorización Zabbix||http://ip_zabbix:80/zabbix
|-
|Base de datos tiempo real||http://ip_bbdd_tr:80/phpmyadmin/
|-
|Base de datos réplica||http://ip_bbdd_replica:80/phpmyadmin
|}

=== Permisos de aplicaciones ===
Se crean a través del '''portal de administración ''VIVA''it''' . Debe conocerse como funcionan los ejes [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Ejes| ver sección Portal de administracion - General - Ejes]] y que existen cuatro aplicaciones creadas en la plataforma:

[[Archivo:17_2 Pestaña Genera - Usuarios - Explicacion permisos.png|center]]

La forma como dar permisos de aplicaciones a un usuario esta explicada en la [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Asignaci.C3.B3n_de_Permisos_de_Usuario_por_Administrador | sección Portal de administracion - General - Usuarios ]].

== Elementos monitorizados del sistema ==
===Generalidades de Zabbix===
====Zabbix ====
Zabbix es una solución de código abierto que ofrece características de monitorización avanzada de forma tecnica y para el negocio, para todo tipo de servidores, aplicaciones y equipos que forman parte de una red. La versión que utilizamos en '''md'''tel es Zabbix 2.2.2.

Zabbix monitoriza los recursos de un equipo en forma remota, permite centralizar la información en un servidor que permite visualizar el monitoreo, cuenta con una interfaz de administración vía web y utiliza un mecanismo flexible de la notificación que permita que los usuarios configuren las alarmas basadas email para informar virtualmente cualquier acontecimiento. Esto permite una reacción rápida a los problemas del servidor.

Para acceder al servidor Zabbix abrimos el navegador y ponemos la dirección de red (IP) de la maquina donde se encuentra instalado el servidor de Zabbix seguido de "/Zabbix.
{|
|-
|
Direccion.IP.Zabbix.Server/zabbix
|}

Zabbix posee documentación tanto en wiki, foros y comunidades.Para ampliar la información se puede visitar:
[[http://www.zabbix.com Sitio oficial de Zabbix]]
===== Glosario Zabbix =====
Se trata de una lista de conceptos básicos de Zabbix, pero para ampliar la información sobre otros términos, visite el [[http://www.zabbix.com Sitio oficial de Zabbix]].
* '''host'''
:En Zabbix, un host es una entidad que define el elemento en red que se desea monitorizar/supervisar activamente sus recursos locales y aplicaciones. Este puede ser una impresa, router, switch, sensores de temperatura, un servidor, un ordenador,etc, o también una aplicación. La característica de un host es que debe poseer una dirección de red (IP).

* '''host group'''
:En Zabbix, un host group (grupo host) es una agrupación lógica de los host, como una forma de organizar los dispositivos "Host" registrados en Zabbix para su monitorización. Puede contener hosts y templates. Los grupos host se utilizan en la asignación de derechos de acceso a los hosts para diferentes grupos de usuarios.

* '''item'''
:En Zabbix, un item (medida) es el parámetro que deseamos obtener del host, básicamente es una medida especifica que el servidor Zabbix recogerá de los agentes de Zabbix instalados en los host.

* '''trigger'''
:En Zabbix, un trigger(disparador) es una entidad que define un umbral para detectar la existencia de un problema en un dispositivo. Son valores recolectados por los "items", se usa para "evaluar" los datos recibidos con condiciones definidas. Las condiciones son de tipo aritmético y lógico.
* '''event'''
:En Zabbix, un event (evento) es la aparición de un suceso en Zabbix que necesita atención. Por ejemplo, el cambio de estado a raíz de un trigger, el descubrimiento de un nuevo agente (autoregistro),etc.
* '''action'''
:En Zabbix, una action(acción) son reglas predefinidas para reaccionar a un evento disparado por los triggers, es decir, define qué hacer ante un evento. Consta de operaciones (por ejemplo, una notificacion, comandos remotos) y condiciones (cuando la operación se lleva a cabo).
* '''notification'''
:En Zabbix, una notification (notificacion) es la entidad con que Zabbix nos puede notificar (Correo Electrónico,mensajes vía "SMS" o Jabber).
* '''template'''
:En Zabbix, un témplate (plantilla) viene predefinida en la instalación de Zabbix Server, con el fin de ser aplicada en base al tipo de sistema operativo(Linux, Mac, Window, etc) o en elementos que comparten los mismos parámetros de medición, por ejemplo la carga del procesador, uso de memoria y uso de recursos de red. Las plantillas son un conjunto de módulos "ITEM, TRIGGERS y GRÁFICAS", que están preconfigurados y listas para ser aplicadas a uno o varios hosts.
* '''application'''
:En Zabbix, una application (aplicación) es una agrupación lógica de los items.
* '''Zabbix server'''
:El Zabbix server (servidor de Zabbix) es el proceso central donde están definidas las configuraciones y donde se almacenan todos los datos y estadísticas recogidas de los agentes Zabbix.Consta de una base de datos, una interfaz web y el propio server. Como servidor, se encarga de recoger los datos de los agentes, calcular los triggers, enviar notificaciones, etc.
* '''Zabbix agent'''
:El zabbix agent (agente de Zabbix) es un proceso desplegado en los host que son supervisados, que funciona como un servicio y puede funcionar de forma activa y pasiva simultáneamente.

=====Discovery=====
La funcionalidad discovery(detección) lista los dispositivos que se integran en nuestra red y el tipo de servicios que proporciona. Por ejemplo, si la empresa tuviera cien colas ACDs, y veinticinco VDNS, y en cada cola como veinte medidas, seria muy laborioso registrar una por uno cada uno.
Gracias a esta funcionalidad, se descubre todas las interfaces de red que se tiene, automáticamente y tanto para colas nodos o IVR. Para utilizar esta funcionalidad , se hace el uso de dos script, que se instalan en el momento de instalación de Zabbix en el directorio "/usr/local/sbin", que son:
{|
|-
|
'''zabbixDiscoveryQueues.pl''' : script utilizado para buscar colas ACD.

'''zabbixDiscoveryVDN.pl''' : script utilizado para buscar VDNS.
|}
La explicación de como configurarla se encuentra en el manual oficial [[https://www.zabbix.com/documentation/2.2/manual/discovery/network_discovery/rule | Zabbix detección de redes]].

=====Notificaciones=====

Necesariamente, debe darse de alta al usuario y darse de alta el servidor de correo electrónico para poder ser capaz de enviar correos.

Por otro lado, el formato del correo electrónico y las condiciones de envío de correo al usuario se configura en las acciones. Véase el [[https://www.zabbix.com/documentation/2.2/manual/quickstart/notification | manual oficial de Zabbix 2.2]]

=====Usuarios=====
Zabbix permite la organización de usuarios en grupos para establecer los permisos adecuados de acuerdo al tipo de perfil que deseemos crear. Necesariamente un usuario debe permanecer a un grupo o varios grupos.Todos los usuarios acceden a la aplicación de Zabbix a través de la interfaz Web.

Cada usuario Zabbix se le asigna un nombre de usuario único , una contraseña y podemos indicarle que tipo de comunicación que posee, normalmente es vía email, pero puede ser vía a otro tipo de medios. Para mas información ver el [[https://www.zabbix.com/documentation/2.2/manual/web_interface/user_profile || manual oficial ]].

=====Visualización=====
Con Zabbix es posible visualizar los datos como gráficos, pantallas, mapas y hasta presentaciones cambiantes, entre otros. En este apartado solo nombraremos características esenciales que se tendra que completar con el [[https://www.zabbix.com/documentation/2.2/manual/config/visualisation | manual oficial]]
======Graphs======
{|
|-
|
'''Nota:''' Debe crearse algun item dentro del host para poder utilizar una gráfica.
|}
En Zabbix una gráfica sirve para representar gráficamente los resultados obtenidos de uno item o varios items.
[[File:EjemploGrafica.png|center|750px]]
Los valores min / avg / max que Zabbix obtiene y representa son de un registro de datos de la tabla tendencias.

======Screens======
La pantalla refiere a otra característica adaptable de ZABBIX cuál permite que los usuarios creen las pantallas personalizadas dentro de ZABBIX para exhibir la información. Se considera como una colección de gráficas y no depende del host. Una pantalla puede consistir en gráficos simples, gráficos personalizados, integrar mapas, Alertas, gráficos estadísticos o texto llano tal como los 5 valores pasados de un item particular entre otros; y mostrar la información de forma dinámica.

[[File:EjemploScreen.png|center|750px]]

======Maps======
En Zabbix, un map (mapa) es una representación gráfica de la situacion de nuestros dispositivos en red. Es un escenario que muestra nuestra red, aplicaciones y servicios a través de figuras o iconos. Dichas figuras toman vida en respuesta a los eventos que se dan en nuestro entorno.
[[File:EjemploMaps.png|center|750px]]
[[File:EstadosMaps.png|center|750px]]

======Monitorizar el estado de los raid======
Los siguientes comandos son necesarios para poder monitorizar el estado de los raid.
La orden:

>hpacucli "ctrl slot=1 logicaldrive 1 show status"

nos proporciona el estado de un raid (p.e. logicaldrive 1 (931.5 GB, 1): Interim Recovery Mode).

La orden:
>hpacucli "ctrl slot=1 logicaldrive all show status"

nos proporciona el estado de todos los raid.

p.e.:
logicaldrive 1 (931.5 GB, 1): Interim Recovery Mode

logicaldrive 2 (1.8 TB, 1): OK.

Para conseguir información genérica el comando

ctrl all show config detail

nos muestra mucha información y podemos saber el modelo de disco físico que lleva instalado para poder comprar el modelo antes de "operar".

===Zabbix en '''MD'''tel===

==== Configuraciones de Zabbix ====

===== Agentes Zabbix =====
{|-
|
|
'''Nota:''' Hay que instalar un agente Zabbix en cada maquina que se quiera monitorizar.
|}

El agente de Zabbix puede recoger datos:
*'''De forma pasiva:''' el server contacta al agente pidiéndole un dato (por ejemplo el consumo de CPU en ese instante) y el agente responde al server con ese dato. A esta acción del agente le llamaremos '''Agente activo'''.
*'''De forma activa:''' en un primer momento, el server le enviará al agente el listado de items a monitorizar. A partir de ese momento, será el agente que de forma periódica recogerá datos sobre esos ítems y se los hará llegar al server. A esta acción del agente le llamaremos ''''''Agente pasivo''''''.

====== Configurar agente de forma pasiva======
Para configurar el agente de Zabbix necesitamos acceder a la maquina que actuará como agente, y en el directorio /etc/zabbix modificar el fichero '''zabbix_agentd.conf''' e indicar cual es la dirección de red (IP) del servidor Zabbix.

{|
|-
|
##### Passive checks related
### Option: Server
# List of comma delimited IP addresses (or hostnames) of Zabbix servers.
# Incoming connections will be accepted only from the hosts listed here.
# If IPv6 support is enabled then '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1'
# are treated equall$
#
# Mandatory: no
# Default:
Server= IP.Server Zabbix.
|}
Tras la configuración del fichero, debemos reiniciar el servicio de los agentes.
{|
|-
|
sudo service zabbix-agent restart
|}

====== Configurar agente de forma activa ======

Para configurar el agente de Zabbix necesitamos acceder a la máquina que actuará como agente, y en el directorio /etc/zabbix modificar el fichero '''zabbix_agentd.conf''' e indicar cual es la dirección de red (IP) del servidor Zabbix.

{|
|-
|
##### Active checks related
### Option: ServerActive
# List of comma delimited IP:port (or hostname:port) pairs of Zabbix serv$
# If port is not specified, default port is used.
# IPv6 addresses must be enclosed in square brackets if port for that hos$
# If port is not specified, square brackets for IPv6 addresses are option$
# If this parameter is not specified, active checks are disabled.
# Example: ServerActive=127.0.0.1:20051,zabbix.domain,[::1]:30051,::1,[12$
#
# Mandatory: no
# Default:
ServerActive=127.0.0.1
--------------------------sección separada----------------------------
### Option: UserParameter
# User-defined parameter to monitor. There can be several user-defined pa$
# Format: UserParameter=<key>,<shell command>
# See 'zabbix_agentd' directory for examples.
#
# Mandatory: no
# Default:
# UserParameter=
User_parameters:asterisk.pid, /usr/bin/asterisk -rx 'core show chanels'|grep 'active calls'| cat -d -f 1
|}

El parámetro '''User_parameters''' tiene un formato de este estilo:
{|
|-
|
User_parameters: NombreMedida, comando.
|}

El nombre de la medida se refiere al nombre que demos a la aplicación , no hace falta que exista una aplicación con ese nombre en Zabbix, y el comando , es el comando remoto que tiene que ejecutar el servidor Zabbix. Posiblemente necesita darse permisos para ejecutar el comando y siempre debe devolver un valor (un numero o un tiempo) que el servidor Zabbix puede manejar.
Tras la configuración del fichero, debemos reiniciar el servicio de los agentes.
{|
|-
|
sudo service zabbix-agent restart
|}

===== Scripts del Servidor Zabbix =====
{|
|
|
'''Nota''': No olvidar que en la misma maquina del server Zabbix, debe configurarse como agente de Zabbix.
|}
Después de realizar la [[# Instalación de Zabbix | Instalación de Zabbix ]] correctamente. Se han creado otros ficheros scripts (''scripts propios de '''md'''tel'') que facilitarán la petición del servidor a los agentes activos, para poder parametrizar todos los elementos del negocio que suelen monitorizarse.
Dependiendo de lo que vaya a monitorizarse necesitaremos algún script o todos. Algunos nos informan sobre elementos de negocio, saber si asterisk funciona , monitorizar el CTI (lanzara nc localhost 1111) , controlar el Intz-Nimitz, comprobar si funciona motalsal, ect.

Cada script se exportara a los host, para que pueda facilitar los datos que pide el servidor Zabbix y configurarse.
Por ejemplo,para monitorizar las llamadas en curso del ACD, agentes conectados, agentes desconectados, etc.
Todos los scripts se deben colocar en el directorio /usr/local/sbin con permisos 755, su nombre es parecido a "zabbixSenderXXXXX.pl"
{|
|-
|
ls /usr/local/sbin/ |grep zabbixSender
'''zabbixSenderACDBD.pl'''
'''zabbixSenderACD.pl'''
'''zabbixSenderCTI.pl'''
'''zabbixSender-intz-nimitz.pl'''
'''zabbixSenderMotorSal.pl'''
'''zabbixSenderMyACDSuperv.pl'''
'''zabbixSenderRecordNodo.pl'''
'''zabbixSenderRecordCentral.pl'''
|}

Se crea una tarea programada en linux para poder ejecutarse los scripts, programando el tiempo en que debe ejecutarse.

Si visualizo que "............" aparece:

***** root zabbix

======zabbixSenderACDBD.pl======

'''Uso:''' Obtiene diversos valores por cada cola, estados de agente por cola y estados de agente generales.

'''Ubicación:''' Servidor BDTR.

'''Parámetros:''' Ruta al archivo de configuración (Por ejemplo: ''/etc/MDtel/zabbixSenderACDBD.pconf'')

'''Archivo de configuración:''' zabbixSenderACDBD.pconf

{|
|-
|
'''$db:''' Nombre de la BBDD (normalmente nimitz)
'''$dbHost:''' Dirección IP del servidor de BBDD de TR (normalmente BDTR)
'''$dbPort:''' Puerto MySQL (normalmente 3306)
'''$dbUsuario:''' Usuario MySQL (normalmente nimitz)
'''$dbClave:''' Clave del usuario
'''$sZab:''' Dirección IP del servidor Zabbix
'''$hZab:''' Nombre del host Zabbix (normalmente el nombre de máquina, tal y como se configura en
zabbix_agentd.conf o en el host en la web de Zabbix)
|}

======zabbixSenderACD.pl======

'''Uso:''' Obtener el PID de Asterisk para revisar si se ha reiniciado en caso de que cambie.

'''Ubicación:''' Servidor ACD.

'''Parámetros:''' Ruta al archivo de configuración (Por ejemplo: ''/etc/MDtel/zabbixSenderACD.pconf'').

'''Archivo de configuración:''' zabbixSenderACDBD.pconf.

{|
|-
|
'''$db:''' Nombre de la BBDD (normalmente nimitz)
'''$dbHost:''' Dirección IP del servidor de BBDD de TR (normalmente BDTR)
'''$dbPort:''' Puerto MySQL (normalmente 3306)
'''$dbUsuario:''' Usuario MySQL (normalmente nimitz)
'''$dbClave:''' Clave del usuario
'''$sZab:''' Dirección IP del servidor Zabbix
'''$hZab:''' Nombre del host Zabbix (normalmente el nombre de máquina, tal y como se configura en
zabbix_agentd.conf o en el host en la web de Zabbix)
|}

======zabbixSenderCTI.pl======

'''Uso:''' Obtener estado y los distintos valores de vivait-cti.

'''Ubicación:''' Servidor donde se ejecute vivait-cti. Normalmente el servidor ACD.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

======zabbixSender-intz-nimitz.pl======

'''Uso:''' Obtener estado y los distintos valores de intz-nimitz.

'''Ubicación:''' Servidor donde se ejecute intz-nimitz.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

======zabbixSenderMotorSal.pl======

'''Uso:''' Obtener estado y los distintos valores de motorSal.

'''Ubicación:''' Servidor donde se ejecute motorSal.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

======zabbixSenderMyACDSuperv.pl======

'''Uso:''' Obtener estado y los distintos valores de myAcdSuperv.

'''Ubicación:''' Servidor donde se ejecute myAcdSuperv.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

======zabbixSenderRecordNodo.pl======

'''Uso:''' Obtener estado y los distintos valores de recordNodo.

'''Ubicación:''' Servidor donde se ejecute recordNodo.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

======zabbixSenderRecordCentral.pl======
'''Uso:''' Obtener estado y los distintos valores de recordCentral.

'''Ubicación:''' Servidor donde se ejecute recordCentral.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

A continuación se muestra una tabla resumen de los distintos scripts y sus funcionalidades:

[[Archivo:Zabbix_scripts.png |960px]]

====== Dimensionamiento del servidor (Startpollers) ======
{|
|
|
'''Nota''': EL parámetro StartPollers es un parámetro numérico que forma parte del fichero de configuración
del servidor Zabbix(zabbix_server.conf). Por defecto el servidor Zabbix está configurado para
iniciar con cinco startpollers.
|}

El servidor Zabbix puede hacer peticiones a los agentes de las medidas que necesita o quiere. O en caso contrario los agentes envian en un tiempo determinado la información al servidor. Para recibir todas estas peticiones necesitamos los pollers.

Los poller son los procesos encargados de recibir todas las peticiones de medidas. Aumentaremos su cantidad dependiendo de la necesitad que tengamos. Para ello podemos observar la queue , que es la encargada de almacenar un listado de todas las cosas que están pedidas para medirse y recibirse. SI por ejemplo esta cola (queue) muestra mas de mil medidas seguramente estos pollers sean un cuello de botella y habrá que aumentar su numero.

=====Templates=====

Zabbix cuenta con templates (plantillas) que facilitan la tarea de "Registrar Equipos y Dispositivos" y agregarles métricas; acelerar el despliegue de las tareas de supervisión en un host; aplicar cambios masivos a tareas de supervisión. En '''md'''tel hemos creado plantillas propias que facilitan estos procesos, los cuales necesitaremos [[#Importar templates |importar templates]].

Las plantillas están vinculados directamente a los hosts individuales, por tanto se necesitaran utilizar en cada host.

Automáticamente, cada template rellena por item las aplicaciones, trigers, alarmas,gráficos,... etc.

A continuación, se muestran los distintos bloques de funciones de la instalación en función de cada template:

{| class="wikitable" style="text-align:center;"
|-
! Templates !! Se instalan en general
|-
| DRBD|| SI (si clúster)
|-
| motorSal|| -
|-
| Vivait-Suite ACD|| -
|-
| Vivait-Suite BBDD|| -
|-
| Vivait-Suite Record|| -
|-
| Vivait-Suite GW|| -
|-
| Vivait-Call Asterisk|| -
|-
| Vivait-Call bdCentral|| -
|-
| Vivait-Call bdNodo|| si
|-
| cambiarPerfil_Cal|| -
|-
| Template App Zabbix Server|| -
|-
| Template_OS_Linux*|| si(si no posee ip virtuales de clúster)
|-
| Template_App_MySQL|| si
|-
|}

{| class="wikitable" style="text-align:center;"
|+ '''Dependiendo del tipo de nodo:'''
|-
! Templates !! ACD !! Corporativo/GW
|-
| DRBD|| - || -
|-
| motorSal|| - || -
|-
| Vivait-Suite ACD|| Si || -
|-
| Vivait-Suite BBDD|| - || -
|-
| Vivait-Suite Record|| - || -
|-
| Vivait-Suite GW|| - || Si
|-
| Vivait-Call Asterisk|| - || Si
|-
| Vivait-Call bdCentral|| - || -
|-
| Vivait-Call bdNodo|| - || -
|-
| cambiarPerfil_Cal|| - || -
|-
| Template App Zabbix Server|| - || -
|-
| Template_OS_Linux*|| - || -
|-
| Template_App_MySQL|| - || -
|-
|}

{| class="wikitable" style="text-align:center;"
|+ '''Dependiendo del tipo de Base de dato'''s:
|-
! Templates !! BBDD Tiempo Real !! BBDD Réplica !! BBDD Copia
|-
| DRBD|| - || - || -
|-
| motorSal|| Si(si ACD) || - || -
|-
| Vivait-Suite ACD|| - || - || -
|-
| Vivait-Suite BBDD|| si || si || si
|-
| Vivait-Suite Record|| - || - || -
|-
| Vivait-Suite GW|| - || - || -
|-
| Vivait-Call Asterisk|| - || - || -
|-
| Vivait-Call bdCentral|| si || - || -
|-
| Vivait-Call bdNodo|| - || - || -
|-
| cambiarPerfil_Cal|| - || - || -
|-
| Template App Zabbix Server|| - || - || -
|-
| Template_OS_Linux*|| - || - || -
|-
| Template_App_MySQL|| - || - || -
|-
|}

{| class="wikitable" style="text-align:center;"
|-
! Templates !! Administración
|-
| DRBD|| -
|-
| motorSal|| -
|-
| Vivait-Suite ACD|| -
|-
| Vivait-Suite BBDD|| -
|-
| Vivait-Suite Record|| -
|-
| Vivait-Suite GW|| -
|-
| Vivait-Call Asterisk|| -
|-
| Vivait-Call bdCentral|| -
|-
| Vivait-Call bdNodo|| -
|-
| cambiarPerfil_Cal||SI (si posee servidor calendarios)
|-
| Template App Zabbix Server|| -
|-
| Template_OS_Linux*|| -
|-
| Template_App_MySQL|| -
|-
|}

{| class="wikitable" style="text-align:center;"
|-
! Templates !! Servidor de grabaciones
|-
| DRBD|| -
|-
| motorSal|| -
|-
| Vivait-Suite ACD|| -
|-
| Vivait-Suite BBDD|| -
|-
| Vivait-Suite Record|| Si
|-
| Vivait-Suite GW|| -
|-
| Vivait-Call Asterisk|| -
|-
| Vivait-Call bdCentral|| -
|-
| Vivait-Call bdNodo|| -
|-
| cambiarPerfil_Cal||-
|-
| Template App Zabbix Server|| -
|-
| Template_OS_Linux*|| -
|-
| Template_App_MySQL|| -
|-
|}

{| class="wikitable" style="text-align:center;"
|+ '''Monitorización'''
|-
! Templates !! General !! Contact Center
|-
| DRBD|| - || -
|-
| motorSal|| - || -
|-
| Vivait-Suite ACD|| - || -
|-
| Vivait-Suite BBDD|| - || -
|-
| Vivait-Suite Record|| - || -
|-
| Vivait-Suite GW|| - || -
|-
| Vivait-Call Asterisk|| - || -
|-
| Vivait-Call bdCentral|| - || -
|-
| Vivait-Call bdNodo|| - || -
|-
| cambiarPerfil_Cal|| - || -
|-
| Template App Zabbix Server|| si || -
|-
| Template_OS_Linux*|| - || -
|-
| Template_App_MySQL|| - || -
|-
|}

* El template OS Linux tiene asociado el Template App Zabbix Agent.
Una '''base de datos unificada''' es una base de datos de tiempo real junto a una base de datos de replica

====== Importar templates======

Las plantillas propias de '''md'''tel se encuentran en la ruta "'''/usr/src/nimitz/archivos'''" y empiezan con el nombre de "TemplateXXX.xml".

{|
|-
|
ls /usr/src/nimitz/archivos | grep Template
'''Template DRBD.xml'''
'''Template motorSal.xml'''
'''Templates Vivait-Suite_GW.xml'''
'''Templates Vivait-Suite.xml'''
'''Template Vivait-Call Asterisk.xml'''
'''Template Vivait-Call bdCentral.xml'''
'''Template Vivait-Call bdNodo.xml'''
'''Template Vivait-Call cambiarPerfil_Cal.xml'''

|}

La importación se realizara una vez a través de la web, no hace falta desde el servidor Zabbix, puede ser en cualquier computadora con acceso a la interfaz web de Zabbix.

[[File:ImportarTemplates.png|750px|center]]

Hay opciones varias opciones a elegir para importación de templates, pero podemos dejar por defecto las señaladas y pulsar el botón "import".

===Configuración para un primer funcionamiento de Zabbix===
Se describe una básica configuracion de Zabbix para cualquier equipo que utilice Windows o linux. Pues mediante la definición de hosts, items, triggers y acciones, Zabbix permite efectuar un monitoreo efectivo de plataformas IT heterogéneas.

====Configuración de los equipost (host) para la monitorización====
{|
|-
|
'''Nota''': Tenga en cuenta que debe de estar previamente configurado el agente Zabbix del
dispositivo a ser monitorizado apuntando a la IP del "Servidor Zabbix".
|}
Existen dos tipos de host:
* '''Host físico''': donde la dirección de red que registramos en Zabbix, corresponde al dispositivo que deseamos monitorizar.
* '''Host virtual''': es una dirección IP virtual, que puede relacionarse con un servidor Web, clusters, etc.

[[File:CreacionHost.png|750px|center]]

Las opciones basicas para configurar un host son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center ;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Host Name'''
| | Definir un nombre para el host.
||Se puede utilizar números, letras, espacios y guiones bajos están permitidos.
|-
| font-weight: bold;" | '''Visible Name'''
| | Identificar con un nombre, la maquina a la que se refiere el host.
||Si no tiene valor, se mostrara como nombre "Host Name".
|-
| font-weight: bold;" | '''Groups'''
| | Seleccionar al grupo de host que pertence.Seleccione uno o varios grupos de la caja derecha.
|| Los valores que puede seleccionar por defecto:
Discoverd hosts.

Switches.

Templates.

Templates MDtel.

Zabbix servers.

Linux Servers.

Hypervisors.

Virtual machines.

O crear uno nuevo en '''New group'''.

|-
| font-weight: bold;" | '''Agent interfaces'''
| |Se recomienda usar una dirección IP, en vez de un nombre de la maquina para resolver por un servidor de DNS que puede fallar.
| | 10050 por defecto
|}

Cuando termine, haga clic en nel boton "Save". Su nuevo "Host" debe ser visible en la lista de "Host registrados".Despues el zabbix, intentara configurarse el zabbix para conectarse a la IP.... cada x tiempo hace un barrido.

===== Comprobación de disponibilidad del host=====
Para saber si todo esta bien debemos ver la Z de disponibilidad.

[[File:EstadosZHost.png|750px|center]]

Indicacion de los colores del icono Z:

* Si el icono Z en la columna de disponibilidad es de color rojo, indica que hay un error en la comunicación - mueva el cursor del ratón sobre él para ver el mensaje de error.

* Si el icono es gris, significa que esta en proceso de comunicación con el "Agente Zabbix". Compruebe que el servidor Zabbix está en marcha, y pruebe a actualizar la página más tarde. El tiempo estimado para revisar si existe problemas es de 5 minutos.

* Si el icono es verde, esta funcionando correctamente.

====Indicar que plantilla(template) tendra el host [opcional]====
Tras [[#Importar templates |importar templates]] nos dirigimos al host ya configurado, y en su pestaña de templates pulsamos "add" y añadimos la plantilla/s adecuadas.

====Asignar items al host ====
{|
|-
|
'''Nota''':Un host puede tener un ITEM sin necesitad de tener template.
|}

Todos lo ITEMS se agrupan por HOST, esto significa que cada HOST tiene sus propios "Módulos que recogen datos del Host". Para agregar un nuevo módulo vamos a "Configuration → Hosts" y localizamos el "Host" al cual queremos agregarle un nuevo "Item".

[[File:CrearItemEjemplo.png|750px|center]]

Parametros o campos a rellenar para una configuración básica :

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center ;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Name'''
| | Definir un nombre para el item. Este nombre va a ser nuestro identificador para todas la gestiones en donde lo involucremos como el caso de Triggers.
||
|-
| font-weight: bold;" | '''Type'''
|| Indicar de que entidad queremos recibir informacion.
||Puede ser al "Agente Zabbix" o a el Hardware como impresoras, switch o routers.
|-
| font-weight: bold;" | '''Key'''
| | los "Items" utilizan "Key" que son parámetros de Zabbix. Los "Key" nos permiten indicar específicamente que tipo de información vamos a solicitara a la entidad. Se puede considerar también como el nombre de alguna aplicación.
||
|-
| font-weight: bold;" | '''host interface'''
| |Es la direccion de red del servidor zabbix (puede ser uno o mas)
| |
||
|-
| font-weight: bold;" | '''Units'''
| |Es la dirección de red del servidor zabbix (puede ser uno o mas)
| |
|-
| font-weight: bold;" | '''Type of information'''
| |Tipo de unidades con el que mostrar Zabbix el valor segundos, minutos, euros,....
||
|}

Cuando termine, haga clic en Guardar. El nuevo elemento debe aparecer en la ITEMLIST.
Para mas informacion [[http://entation/1.8/manual/config/items#zabbix_agent. ver documentación Zabbix]]

===== Ver la información recolectada por el item =====
{|
|-
|
'''Nota:''' Normalmente para ver la información lo encontraremos en "Monitoring → Latest data",luego
clic en el signo "+" en "other" siempre que no pertenezca a una aplicación.
En caso contrario, estará bajo el nombre de la aplicación.
|}

Después de definir el "Item" vamos a revisar la información que esta recolectando. . La información comenzará a ser recolectada según el tiempo que le indicamos en el "Item".

[[File:VerInfoITEM.png|750px|center]]

La espera para recibir la información varía dependiendo del tiempo de recolección del item, la mayoría suele ser aproximadamente al minuto de generar el "Item". Zabbix le ofrece la opción de visualizar la información en forma gráfica (sencilla). En el "Item" en lista haga clic en la columna "History - Graph".

[[File:VIsualGraficaValorItem.png|center|750px]]
Si en un caso usted no observa información le recomendamos:

* Ingrese al "Item" y revise que la información del "Key" este igual al ejemplo "system.cpu.load"
* Verifique que el agente este funcionando en el "Servidor a ser monitoreado" y que "El Servidor recolector Zabbix" este funcionando.
* El icono "Z" en el host debe estar en color verde.
* Asegure que esta monitoreando el servidor que le agregó este "Item"

====Configurar los Triggers para los host====
A partir de la información que captura los agentes , el servidor de Zabbix comienza a efectuar la recolección de estos items en la base de datos. Con esto se tiene un registro histórico de tales mediciones, que pueden ser tan simples como un simple ping hasta datos de uso de disco, memoria, cpu, etc.
A partir de los datos que se reciben de los agentes lo que sigue es definir y configurar Triggers, que son evaluaciones que hace Zabix de estos datos para determinar la existencia de un Problema en un dispositivo.
{|
|-
|
Nota: Un trigger necesita una accion, que indica que hacer cuando se activa el trigger.
|}

Un trigger(disparador) es un tipo de reacción ante unas medidas, como un disparador en el que si pasa algo se activa. Los Trigger en Zabbix son módulos que creamos a uno o múltiples "Items" para evaluar o comparar los valores recolectados por los "Items" con condiciones que nosotros definamos. Las condiciones son de tipo aritmético y lógico.

Para configurar un "Trigger o Disparador" seleccionamos "Configuration → Hosts" localizamos el "Host" de ejemplo que creamos y luego hacemos clic en "Trigger", después haga clic en "Create Trigger".

Parametros o campos a rellenar para una configuración básica :

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center ;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Name'''
| | Definir un nombre para el trigger. Este nombre va a ser nuestro identificador para todas la gestiones en donde lo involucremos como el caso de los eventos.
||
|-
| font-weight: bold;" | '''Expression'''
|| Hay que indicar para que medida se crea (item) y sus funciones con los parametros adecuados. '''''Recomendación usar expression constructor que pedirá siempre al crearlo, para que item es y sus funciones...'''''
||Ejemplo: {New host:system.cpu.load.avg(180)}>2
|-
| font-weight: bold;" | '''Key'''
| | los "Items" utilizan "Key" que son parámetros de Zabbix. Los "Key" nos permiten indicar específicamente que tipo de información vamos a solicitara a la entidad. Se puede considerar tambien como el nombre de alguna aplicacion.
||
|-
| font-weight: bold;" | '''Descripción'''
| | Una descripción breve sobre el trigger.
||
|-
| font-weight: bold;" | '''Severity'''
| | everidad distinguida por colores,
|| No classified
Information
Warning
Average
High
Disaster
|}

===== Comprobar el estado del trigger =====
Podemos ver el estado del "Trigger" en "Monitoring → Triggers".El color en caso de que se active depende de la severidad definida. Por ejemplo, si el "Trigger" esta en color verde indica que el resultado de la métrica se mantiene por debajo de la condición que indicamos. Por el contrario si el resultado esta "sobre lo indicado" su color sera rojo.

[[File:EstadoTrigger.png|center|750px]]

====Asociar un Action al trigger====

Una action(acción) sirve para configurar un mensaje de alerta o una accion para Zabbix, ante un problema. Hay varias formas de gestionar un problema a través de una acción:

# A través de mensajes simples, alertando al instante.
# Escalar los mensajes hacia el jefe y/o otros grupos.
# Ejecución de commandos remotos.
# Notificaciones repetidas hasta que se resuelve el problema.
# Notificaciones y comandos retardados.
# Escenario complejo, la combinación de todo lo anterior.

Para crear una configuración en "Configuration-Actions". La explicación esta en la [[ https://www.zabbix.com/documentation/2.0/manual/config/notifications/action documentación de Zabbix]].
-->

== Integraciones con servicios externos ==

=== Presencia con Openfire ===
'''''VIVA'''''it se integra con servidor XMPP Openfire en su versión 3.10.2 (última probada)

Además del servidor, es necesario instalar un plugin de integración con asterisk 13, denominado "asterisk IM", versión 1.4.1

La instalación del servidor Openfire es una instalación estándar, realizada de paquete

La instalación del plugin es un "jar" que se carga desde la pagina de plugins de openfire

Con esto conseguiremos comunicar asterisk y OPenfire de manera que:
*Los estados telefónicos de una extensión '''''VIVA'''''it se reflejen en Openfire
*Poder marcar desde los clientes de IM instalados en los puestos
*Ver en el cliente llamadas entrantes al teléfono

-----

'''<big>Enlaces de interes:</big>'''

[http://www.igniterealtime.org/projects/openfire/ Página proyecto openfire]

[https://community.igniterealtime.org/thread/56076 Página proyecto "asterisk IM"]

=== Reuniones virtuales con Openmeetings ===
'''OpenMeetings''' es un sistema de vídeo web-conferencia en tiempo real. Usando recursos como audio (micrófono), vídeo (cámara web), posibilidad de subir y convertir presentaciones (en PDF , PPT o ODP que se convierten a Flash), compartición de la pantalla de tu ordenador, o pizarra digital compartida, panel de administración, posibilidad de grabar las sesiones… y completo soporte multiplataforma, es decir, que aparte de poder grabar las sesiones, se puede compartir un escritorio también desde una máquina Linux.

Para instalar '''OpenMettings''' debe seguir el [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manuales_de_instalaci%C3%B3n#Instalaci.C3.B3n_de_Openmeetings | manual de Instalación de Openmeetings]]

[[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:VIVAit Suite]]

Manual de operación plataforma VIVAit

2018-04-23T10:45:18Z

Imatarrubias: /* Modificaciones de archivos */

{| class="wikitable"
|-
! '''Producto: '''!! '''''VIVA'''''it Call
'''''VIVA'''''it Suite
|-
|}

== Introducción ==

En este documento se describe la arquitectura general de la plataforma '''''VIVA'''''it, detallando aquellos procesos principales que componen cada uno de los elementos del sistema, y sus principales elementos de diagnóstico
Quedan fuera del ámbito de este documento:
* Uso de aplicación de agente ('''''VIVA'''''it Desk)
* Uso de aplicación de supervisor ('''''VIVA'''''it Supervisor), incluyendo sus módulos autónomos ('''''VIVA'''''it reporting, '''''VIVA'''''it Tracker)
* Uso de portal de administración
* Uso de portal de traceo de llamadas y agentes ('''''VIVA'''''it Tracker web)
* Uso de portal de monitorización zabbix

== Arquitectura ==

[[Archivo:Arquitectura plataforma VIVAit.png|center|700px]]

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

== Descripción de los elementos, diagnósticos y operaciones ==
Las siguientes tablas definen los principales elementos software de la plataforma '''''VIVA'''''it, que son detallados en apartados siguientes:

{| class="wikitable"
|-
|+ <big>'''Nivel de sistema operativo'''</big>
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
| Ubuntu Server LTS 64 bits || Uno por servidor|| ||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
|| Actualmente (Oct-2015) 14.04
Bajo proyecto puede cambiarse
|-
| Almacenamiento de grabaciones|| Uno por sistema|| Almacenamiento de las grabaciones, ya sean de entorno corporativo o de contact center||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
|| Típicamente un espacio grande de almacenamiento proporcionado por el cliente y que se monta como un sistema de archivos local en los servidores de la plataforma
Pueden existir sistemas secundarios de almacenamiento de grabaciones
|-
|-
|}

{| class="wikitable"
|-
|+ <big>'''Nivel de conmutación de voz'''</big>
|-
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
|Asterisk 1.4.24 by MDtel||Uno por servidor ACD||Núcleo de conmutación de voz basado en Asterisk 1.4 y modificado por MDtel||'''''VIVA'''''it Suite||Fuertemente modificado por MDtel
En el futuro migrará a Asterisk 13 Certified
|-
|Dialplan ACD by MDtel||Uno por servidor ACD||Configuración de voz||'''''VIVA'''''it Suite||En el futuro se unificará con corporativa
|-
|Asterisk 13 Certified by MDtel||Uno por servidor corporativo/gateway||Núcleo de conmutación de voz basado en Asterisk 13 y modificado por MDtel||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Actualmente asterisk estándar (10/15)
La instalación contempla descargar de la red el más actualizado, siempre CERTIFIED"
|-
|Dialplan corporativo||Uno por servidor corporativo/gateway||Configuración de voz||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||En el futuro se unificará con ACD
|-
|}

{| class="wikitable"
|-
|+ <big>'''Nivel de base de datos'''</big>
|-
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
|MySQL 5.5||Donde haya BBDD de cualquier tipo (incluso zabbix)||Motor de Base de Datos||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||A efectos prácticos va a ser en todos los servidores con casi total seguridad
|-
|BBDD tiempo real||Una por sistema||Base de Datos sobre la que trabaja todo el entorno de tiempo real||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
|-
|BBDD réplica||Una por sistema multinodo||Base de Datos para acceso a información de reporting…y similar||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Bajo proyecto puede existir más de una
En el nodo en el que exista réplica existirá además copia (excepto nodo ACD)
|-
|BBDD copia||Uno por servidor corporativo/gateway||Copias de tablas de configuración para respaldo de la misma||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Local en cada nodo
Los nodos de ACD actualmente no trabajan con copia; en caso de fallo de BBDD TR se usa el modo emergencia
|-
|}

{| class="wikitable"
|-
|+ <big>'''Nivel de procesos ''VIVA''it'''</big>
|-
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
|Intz-Nimitz||Donde haya una BBDD de tiempo real o copia||Interfaz entre el dialplan y la base de datos||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||No donde haya BBDD de réplica
Sistemas grandes pueden contemplar mas de un intz-nimitz central"
|-
|vivait-cti||Uno por servidor ACD||Interfaz entre '''''VIVA'''''it Desk, supervisor y el manager de asterisk||'''''VIVA'''''it Suite||
|-
|myAcdSuperv||Uno por servidor ACD||Recopilador de datos de asterisk y actualiza en la BBDD
Genera llamadas en el marcador
||'''''VIVA'''''it Suite
||
|-
|motorSal||Uno por sistema con ACD||Motor de marcador saliente automático||'''''VIVA'''''it Suite||Solo si hay marcación saliente
Junto a la BBDD de tiempo real
|-
|recordCentral||Uno por sistema||Servidor de grabaciones, se conectan los agentes a el||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Se arrancan varias instancias en función del número de nodos
Debe instalarse en un servidor que tenga el almacenamiento de grabaciones en su sistema de archivos
|-
|recordNodo||Uno por servidor corporativo/gateway||Agente de grabación||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|bdCentral||Uno, en el nodo con la BBDD de tiempo real||Genera la base de datos que se copiará para respaldo a otros nodos||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|bdNodo||En cada nodo con BBDD de copia||Recoge la base de datos del servidor central con el objeto de tener el respaldo||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|Actualizador||Uno por sistema con ACD||Se encarga de proporcionar las versiones actualizadas de las aplicaciones de puesto de trabajo||'''''VIVA'''''it Suite||En el mismo servidor que el portal de administración
|-
|phoneProv-tftp||Uno por sistema||Se encarga del aprovisionamiento masivo de terminales||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||En instalaciones grandes habrá más de uno, quizás uno por sede grande; depende de la infraestructura de DHCP
|-
|borraregistrosnimitz||||||||
|-
|Mover grabaciones a nube||||||||
|-
|}

{| class="wikitable"
|-
|+ <big>'''Administración'''</big>
|-
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
|Tomcat 7||Uno por servidor con portales||Servidor de aplicaciones JAVA||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
|-
|Portal de administración ||Uno por sistema||Portal de administración del sistema||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Bajo proyecto puede existir más de uno
|-
|Portal usuario||Uno por sistema||Portal de usuario, para acceso a buzones, su configuración||'''''VIVA'''''it Call||Bajo proyecto puede existir más de uno
|-
|Tracker web||Uno por sistema||Portal de seguimiento de llamadas||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Debe instalarse en un servidor que tenga los ficheros de grabación montados en su sistema de archivos
Ligado a recordCentral
Bajo proyecto puede existir más de uno
|-
|Monitor||Uno por sistema||Portal de monitores de pared de Call Center||'''''VIVA'''''it Suite||Bajo proyecto puede existir más de uno
|-
|Apache||Uno por servidor de calendarios||Servidor de portales WEB||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|Servidor de calendarios||Uno por sistema||Aloja calendarios para su uso en diferentes entornos de NIMITZ||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Bajo proyecto puede existir más de uno
|-
|}

{| class="wikitable"
|-
|+ <big>'''Monitorización'''</big>
|-
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
|Servidor zabbix||Uno por instalación||Monitorización técnica y de negocio||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Bajo proyecto puede existir más de uno
Tipicamente irá o en BBDD replica o en nodo de gestión en instalaciones grandes
|-
|Templates zabbix||Uno por instalación||Adaptaciones específicas||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|Agente Zabbix||Uno por servidor||Agente de monitorización||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
||Scripts monitorización zabbix||Uno por servidor||Agente de monitorización||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|}
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

===Versiones de módulos===

{| class="wikitable"
|-
! Módulo !! VSuite
V.3.10
! VSuite
V.3.2.0
! VSuite
V.3.3.0
! VIVAit V.3.0.0
(VSuite 3.4+VCall3.0)
! VIVAit V.3.1.0
(VSuite 3.5+VCall3.1)
|-
| Sistema Operativo || || || ||
|| Ubuntu 14.0.4
Server 64 Kb
|-
| Asterisk || 1.4 || 1.4 || 1.4 || 1.4 Nodo ACD
13 resto nodos
|| 1.4 Nodo ACD
13 resto nodos
|-
| Asterisk ACD '''(VS)''' || || || || 3.3.1 || 3.4.1
|-
| Dialplan ACD '''(VS)''' || || || || || 3.5.0
|-
| Asterisk Corp '''(C)''' || || || || 3.3.4 || 3.4.4
|-
| Asterisk Cisco '''(VC)''' || || || || 3.3.4 || 3.4.4
|-
| Dialplan Corp '''(C)''' || || || || 3.3.1 || 3.5.0
|-
| Lazarus común '''(VS)''' || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0 || 3.5.0
|-
| BD '''(C)''' || 3.2.0 || 3.4.0 || 3.5.0 || 3.6.0 || 3.8.0
|-
| Generaconf '''(C)''' || 3.0.0 || 3.0.0 || 3.2.0 || 3.4.0 || 3.5.0
|-
| Instalador '''(C)''' || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0 || 3.5.0
|-
| Intz-nimitz '''(C)''' || 2.6.0 || 3.0.1 || 3.0.3 || 3.4.1 || 3.4.2
|-
| recordgwd '''(C)''' || 1.3.0 || 1.3.0 || 3.1.0 || ----- || -----
|-
| recordNodo '''(C)''' || ----- || ----- || ----- || 4.0.0 || 4.0.0
|-
| recordprocesad '''(C)''' || 1.2.0 ||1.2.0|| 3.0.0 || ----- || -----
|-
| recordCentral '''(C)''' || ----- || ----- || -----|| 4.0.0 || 4.0.1
|-
| MyACDSuperv '''(VS)''' || 5.2.0 || 5.3.0 || 5.3.0 || 5.3.2 || 5.3.2
|-
| Motorsal '''(VS)''' || 1.4.0 || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0
|-
| Vivait-cti '''(VS)''' || 3.0.0 || 3.0.1 || 3.0.1 || 3.0.1 || 3.0.2
|-
| Multimonitorweb '''(VS)''' || 3.0.1 || 3.0.2 || 3.1.0 || 3.1.0 || 3.2.0
|-
| Portal de administración '''(C)''' || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0 || 3.5.0
|-
| Tracker Web '''(C)''' || 3.0.2 || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0
|-
| VIVA supervisor '''(VS)''' || 3.0.0 || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0
|-
| Tracker windows '''(C)''' || 3.0.0 || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0
|-
| VIVA report '''(VS)''' || 1.2.0 || 3.1.0 || 3.2.0 || 3.2.2 || 3.3.0
|-
| VIVA desk '''(VS)''' || 3.0.2 || 3.2.0 || 3.3.0 || 3.4.0 || 3.5.0
|-
| VIVA designer '''(VS)''' || 1.0.23 || 3.0.1 || 3.1.0 || 3.1.0 || 3.2.0
|-
| Preview '''(VS)''' || 1.0.18 || 3.2.0 || 3.3.0 || 3.4.0 || 3.5.0
|-
| Phone_prov '''(C)''' || ------ || ------ || 3.0.1 || 3.0.3 || 3.0.3
|-
| Portal usuario '''(VC)''' || ------ || ------ || ------ || 3.0.0 || 3.1.0
|}

'''(C)''': Módulo común

'''(VC)''': Módulo de VIVAit Call

'''(VS)''': Módulo de VIVAit Suite

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Sistema Operativo ===
Los sistemas operativos de nuestra plataforma se corresponden a las versiones de Ubuntu Server LTS , ya que son las versiones estables, con un soporte continuado y mas estables a actualizaciones desde la salida Ubuntu 14.04.1. En concreto el sistema operativo utilizado para la plataforma '''''VIVA'''''it es Ubuntu Server 14.04.4 LTS. Para más información https://help.ubuntu.com/lts/serverguide/index.html.

[[Archivo:Ubuntu Kernel Release Schedule.png|750px]]

==== Funcionamiento en cluster ====

Un clúster es un grupo de múltiples ordenadores unidos mediante una red de alta velocidad, de tal forma que el conjunto es visto como un único ordenador.

De un clúster se espera que presente combinaciones de los siguientes servicios:

# Alto rendimiento
# Alta disponibilidad
# Balanceo de carga
# Escalabilidad

Tal y como esta definido el cluster de MDtel, este comprueba conectividad con la otra máquina que lo forma y con un punto de confianza. Si la máquina no tiene conectividad con la otra y si con el punto de confianza es que el servidor está vivo, mientas que si no tengo conectividad ni con la otra máquina ni con el punto de confianza es que el muerto soy yo, por lo que balanceo.

Por lo que las máquinas balancean en los casos siguientes:

* Todo lo que tenga que ver con la red, es decir, caída de la tarjeta de red, apagado de la máquina, corte en la red..

Y no balancea en los siguientes:

* No balancea en los demás casos, es decir, todo lo que tenga que ver con procesos de una máquina (caída asterisk, base de datos, intz-nimitz)

El funcionamiento en cluster se basa en:

* Heartbeat: IP flotante entre las dos máquinas que componen el cluster; típicamente este "latido" entre máquinas se realizará mediante conexión directa con cable cruzado para asegurar que no existan problemas de comunicaciones tales como retardo, pérdida de paquetes, etc en este latido y pueda ser causa de un balanceo inadecuado.

{| class="wikitable"
|-
| '''Nota 17-11-2015:''' Se ha realizado en un cliente un cluster distribuido, con dos servidores en diferentes sedes, realizando el heartbeat mediante enlace Gigabit. Si bien la solución no está validada por desarrollo, se está observando el funcionamiento.
|}

* DRBD se encargar de mantener una serie de carpetas totalmente replicadas entre los dos nodos; dichas carpetas son:

El cluster es <big>'''activo/pasivo'''</big>; la máquina activa posee la IP flotante y tiene arrancados los servicios.

==== Configuración del cluster ====
Para montar un cluster de asterisk partimos de la siguiente situación inicial:
* Dos maquinas con '''''VIVA'''''it Call 3.0 instalado.
* El driver bonding de Interfaces de Red en Ubuntu Server.

Los pasos a seguir para la configuración en el Ubuntu Server son los siguientes:
* Instalar ifenslave:
:{|
|-
|
aptitude install ifenslave.
|}
: Finalizada la instalación, comprobamos que la instalación de Bonding se ha configurado para empezar desde el arranque del sistema operativo desde el fichero '''/etc/modules''':
:{|
|-
| vi /etc/modules
# /etc/modules: kernel modules to load at boot time.
#
# This file contains the names of kernel modules that should be loaded
# at boot time, one per line. Lines beginning with "#" are ignored.
# Parameters can be specified after the module name.
lp
rtc
bonding
|}

* Crear o editar el archivo llamado '''/etc/modprobe.d/bonding.conf''' y añadir la siguiente linea en negrita:
:{|
|-
|
echo "alias bond0 bonding"> /etc/modprobe.d/bonding.conf
|}

* Editar el fichero /etc/network/interfaces y añadir lo que esta en negrita:
:{|
|-
|
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).
# The loopback network interface
auto lo
iface lo inet loopback

'''# Bonding'''

'''#em1 ip manual y esclavo en el "bond0" NIC'''
'''auto em1'''
'''iface em1 inet manual'''
'''bond-master bond0'''
'''bond-primary em0'''

'''#em2 ídem, creando así un vínculo de enlace 2.'''
'''auto em2'''
'''iface em2 inet manual'''
'''bond-master bond0'''
'''auto bond0'''
'''iface bond0 inet static'''
'''address 10.255.255.11'''
'''netmask 255.255.255.0'''
'''gateway 10.255.255.254'''
'''bond-mode active-backup'''
'''bond-miimon 100'''
'''bond-slaves none'''

'''# em3 replica entre servidores'''
'''auto em3'''
'''iface em3 inet static'''
'''address 10.255.254.10'''
'''netmask 255.255.255.0'''

'''# em4 gestion'''
'''auto em4'''
'''iface em4 inet static'''
'''address 172.17.47.255'''
'''netmask 255.255.0.0'''
|}

* Reiniciamos el sistema para que el kernel tome los cambios.

* Comprobación que en las dos maquinas el archivo '''/etc/host''' contenga el los nombre de las dos maquinas a vincular. En el ejemplo el archivo en ambas maquinas es:

:{|
|-
|
127.0.0.1 localhost

10.255.255.11 vivaitcall-CL-UAH-1

10.255.255.12 vivaitcall-CL-UAH-2

10.255.255.10 vivaitcall-CL-UAH

10.255.255.10 BDTR

10.255.254.10 vivaitcall-CL-UAH-1-em3

10.255.254.11 vivaitcall-CL-UAH-2-em3
|}

* Creamos dos particiones iguales en ambos ordenadores , usando el comando '''parted'''.
:{|
|-
|
root@vivaitcall-CL-UAH-1:~# '''parted /dev/sda'''
GNU Parted 2.3
Using /dev/sda
Welcome to GNU Parted! Type 'help' to view a list of commands.
(parted) p free
Model: HP LOGICAL VOLUME (scsi)
Disk /dev/sda: 1000GB
Sector size (logical/physical): 512B/512B
Partition Table: gpt
Number Start End Size File system Name Flags
17,4kB 262kB 245kB Free Space

1 262kB 1000MB 1000MB fat32 boot
2 1000MB 201GB 200GB ext4
3 201GB 217GB 16,0GB linux-swap(v1)
4 217GB 237GB 20,0GB ext4
237GB 1000GB 763GB Free Space

(parted) mkpart primary 237GB 1000GB
(parted) p free
Model: HP LOGICAL VOLUME (scsi)
Disk /dev/sda: 1000GB
Sector size (logical/physical): 512B/512B
Partition Table: gpt
Number Start End Size File system Name Flags
17,4kB 262kB 245kB Free Space
1 262kB 1000MB 1000MB fat32 boot
2 1000MB 201GB 200GB ext4
3 201GB 217GB 16,0GB linux-swap(v1)
4 217GB 237GB 20,0GB ext4
5 237GB 1000GB 763GB primary  No File System como ext4
1000GB 1000GB 204kB Free Space
(parted)quit
mkfs.ext4 /dev/sda5
root@vivaitcall-CL-UAH-1:~# '''parted /dev/sda'''
GNU Parted 2.3
Using /dev/sda
Welcome to GNU Parted! Type 'help' to view a list of commands.
(parted) p free
Model: HP LOGICAL VOLUME (scsi)
Disk /dev/sda: 1000GB
Sector size (logical/physical): 512B/512B
Partition Table: gpt
Number Start End Size File system Name Flags
17,4kB 262kB 245kB Free Space
1 262kB 1000MB 1000MB fat32 boot
2 1000MB 201GB 200GB ext4
3 201GB 217GB 16,0GB linux-swap(v1)
4 217GB 237GB 20,0GB ext4
5 237GB 1000GB 763GB primary
1000GB 1000GB 204kB Free Space
(parted) rm 5
(parted) mkpart primary 237GB 1000GB
(parted) p free
Model: HP LOGICAL VOLUME (scsi)
Disk /dev/sda: 1000GB
Sector size (logical/physical): 512B/512B
Partition Table: gpt

Number Start End Size File system Name Flags
17,4kB 262kB 245kB Free Space
1 262kB 1000MB 1000MB fat32 boot
2 1000MB 201GB 200GB ext4
3 201GB 217GB 16,0GB linux-swap(v1)
4 217GB 237GB 20,0GB ext4
5 237GB 1000GB 763GB ext4 primary  Si File Sytem ext4
1000GB 1000GB 204kB Free Space
(parted)quit
|}

* Instalar los paquetes necesarios para el drbd. '''En Ubuntu server 14.04 ya está instalado.'''
:{|
|-
|
aptitude install drbd8-utils
aptitude update (si no instala el drbd8-utils actualizar)
aptitude install drbd8-utils (volver a lanzar)
|}

* Creamos el archivo '''/etc/drbd.conf''' en ambas maquinas:
:{|
|-
|
# You can find an example in /usr/share/doc/drbd.../drbd.conf.example
include "drbd.d/global_common.conf";
include "drbd.d/*.res";
resource MDcluster {
protocol C;
on vivaitcall-CL-UAH-1 {
device /dev/drbd0;
disk /dev/sda5;
address 10.255.254.10:7788;
meta-disk internal;
}
on vivaitcall-CL-UAH-2 {
device /dev/drbd0;
disk /dev/sda5;
address 10.255.254.11:7788;
meta-disk internal;
}
disk {
on-io-error detach;
}
net {
max-buffers 2048;
ko-count 4;
}
syncer {
rate 100M;
al-extents 257;
}
startup {
wfc-timeout 0;
degr-wfc-timeout 120;
}
}
|}

* Reiniciamos el sistema para que el kernel tome los cambios.
* Inicializamos el recurso, para ello primero deberemos crear los recursos DRBD teclearemos en ambas maquinas. Desde /etc.
:{|
|-
|
drbdadm create-md MDcluster (no y yes )
|}

:Si tenemos algún problema porque ya exista sistema de ficheros.
:{|
|-
|
dd if=/dev/zero of=/dev/sda5 bs=1M count=128
drbdadm create-md MDcluster (no y yes )
|}

* Reiniciamos ambas maquinas para que su kernel tome los cambios.
* Levantamos el servicio del DRBD en ambos servidores (nos preguntara que si queremos enviar los datos a los desarrolladores de drbd) tecleando no, no se envían.
:{|
|-
|
service drbd start
/etc/init.d/drbd start
|}

: Ahora ambas maquinas son secundarias.
: Indicar cual de las dos maquinas usaremos como primaria, por tanto en la maquina elegida habra que ejecutar:
:{|
|-
|
drbdadm -- --overwrite-data-of-peer primary all (en una máquina)
:'''Nota:''' La ip virtual que va a estar asignada a la maquina activa es 172.25.129.70.

|}

: Podemos teclear el comando '''''cat''''' para ver si esta sincronizando y su progreso:

:{|
|-
|
cat /proc/drbd
'''Nota:''' El servicio DRBD aparecera como '''''Primary/Secondary''''' si ejecutamos en el primario ;
y aparecerá ''''Secondary/Primary'''' si lo ejecutamos en el secundario. 
|}

* Instalación de los script de arranque:
:{|
|-
|
update-rc.d -f drbd remove (en las dos maquinas)
update-rc.d drbd start 13 2 3 4 5 . stop 87 0 1 6 . (en las dos máquinas)
|}
* Seleccionar la fuente de sincronización.
:Formateamos un disco de la maquina que queramos que funcione como fuente del servicio DRBD, para evitar conflictos:
:{|
|-
|
mkfs.ext4 /dev/drbd0
|}
: Creamos el directorio sobre el que vamos a montar el disco, en ambas maquinas.
:{|
|-
|
mkdir /HDcluster
|}

: Creamos un archivo dentro '''''/HDcluster''''' de que se verá solo cuando el disco no está montado en ambas maquinas.
:{|
|-
|
touch sinMontar
'''Nota:''' Este archivo nos puede servir para monitorizar mediante zabbix, nagios, ... que el disco no está montado.
|}

: En una de las maquinas montamos el disco (desde fuera del directorio HDcluster)
:{|
|-
|
mount /dev/drbd0 /HDcluster
|}
* Procedemos a mover todos los datos que necesitemos en este disco y a crear accesos directos, los directorios que vamos a mover son los siguientes:
:{|
|-
|
/etc/asterisk
/var/lib/asterisk
/usr/lib/asterisk
/usr/spool/asterisk
/var/lib/mysql
/var/tftp/
|}
: El procedimiento que vamos a seguir es el siguiente, en el primer ordenador:
:{|
|-
|
'''Cd /HDcluster'''
'''tar -zcvf etc-asterisk.tgz /etc/asterisk'''
'''tar -zxvf etc-asterisk.tgz'''
'''rm -rf /etc/asterisk'''
'''ln -s /HDcluster/etc/asterisk /etc/asterisk'''
'''tar -zcvf var-lib-asterisk.tgz /var/lib/asterisk'''
'''tar -zxvf var-lib-asterisk.tgz'''
'''rm -rf /var/lib/asterisk'''
'''ln -s /HDcluster/var/lib/asterisk /var/lib/asterisk'''
'''tar -zcvf usr-lib-asterisk.tgz /usr/lib/asterisk'''
'''tar -zxvf usr-lib-asterisk.tgz'''
'''rm -rf /usr/lib/asterisk'''
'''ln -s /HDcluster/usr/lib/asterisk /usr/lib/asterisk'''
'''tar -zcvf var-spool-asterisk.tgz /var/spool/asterisk'''
'''tar -zxvf var-spool-asterisk.tgz'''
'''rm -rf /var/spool/asterisk'''
'''ln -s /HDcluster/var/spool/asterisk /var/spool/asterisk'''
'''tar -zcvf var-lib-mysql.tgz /var/lib/mysql'''
'''tar -zxvf var-lib-mysql.tgz'''
'''rm -rf /var/lib/mysql'''
'''ln -s /HDcluster/var/lib/mysql /var/lib/mysql'''
'''tar -zcvf var-lib-phoneprov-tftp.tgz /var/lib/phoneprov-tftp/'''
'''tar -zxvf var-lib-phoneprov-tftp.tgz'''
'''rm -rf /var/lib/phoneprov-tftp/'''
'''ln -s /HDcluster/var/lib/phoneprov-tftp /var/lib/phoneprov-tftp'''
|}

: En la segunda maquina debemos borrar los directorios y crear los accesos directos.
:{|
|-
|
'''rm -rf /etc/asterisk'''
'''ln -s /HDcluster/etc/asterisk /etc/asterisk'''
'''rm -rf /var/lib/asterisk'''
'''ln -s /HDcluster/var/lib/asterisk /var/lib/asterisk'''
'''rm -rf /usr/lib/asterisk'''
'''ln -s /HDcluster/usr/lib/asterisk /usr/lib/asterisk'''
'''rm -rf /var/spool/asterisk'''
'''ln -s /HDcluster/var/spool/asterisk /var/spool/asterisk'''
'''rm -rf /var/lib/mysql'''
'''ln -s /HDcluster/var/lib/mysql /var/lib/mysql'''
'''rm -rf /var/lib/phoneprov-tftp'''
'''ln -s /HDcluster/var/lib/phoneprov-tftp /var/lib/phoneprov-tftp'''
|}

* Configurar heartbeat para las dos maquinas.
: Instalamos heartbeat en las dos maquinas. '''En UBUNTU Server 14.04 ya está instalado.'''
:{|
|-
|
aptitude install heartbeat
|}
: Debemos modificar 3 ficheros en cada una de las maquinas, estos se encuentran en '''/etc/ha.d'''. El primer fichero a modificar es '''''ha.cf.''''':
:: En la maquina ''vivaitcall-CL-UAH-1'' es:
::{|
|-
|
root@vivaitcall-CL-UAH-1:~# cat /etc/ha.d/ha.cf
'''# Explicacion en /usr/share/doc/heartbeat/ha.cf.gz'''

'''udpport 694'''
'''baud 19200'''
'''auto_failback off'''
'''use_logd yes'''
'''crm no'''

'''# Temporizaciones en segs'''
'''logfacility local0'''
'''keepalive 2'''
'''deadtime 8'''
'''warntime 16'''
'''initdead 64'''
'''deadping 6'''

'''#ucast bond0 vivaitcall-CL-UAH-1'''
'''ucast bond0 vivaitcall-CL-UAH-2'''

'''#ucast em3 vivaitcall-CL-UAH-1-em3'''
'''ucast em3 vivaitcall-CL-UAH-2-em3'''

'''#Ping a puerta de enlace,gw1,gw2,gw3,gw4'''
'''ping_group red_local 10.255.255.12'''

'''respawn hacluster /usr/lib/heartbeat/ipfail'''
'''apiauth ipfail gid=haclient uid=hacluster'''

'''node vivaitcall-CL-UAH-1'''
'''node vivaitcall-CL-UAH-2'''
|}

:: Y en la maquina ''vivaitcall-CL-palacio-2'' es:
::{|
|-
|
root@vivaitcall-CL-UAH-1:~# cat /etc/ha.d/ha.cf
'''# Explicacion en /usr/share/doc/heartbeat/ha.cf.gz'''

'''udpport 694'''
'''baud 19200'''
'''auto_failback off'''
'''use_logd yes'''
'''crm no'''

'''# Temporizaciones en segs'''
'''logfacility local0'''
'''keepalive 2'''
'''deadtime 8'''
'''warntime 16'''
'''initdead 64'''
'''deadping 6'''

'''ucast bond0 vivaitcall-CL-UAH-1'''
'''#ucast bond0 vivaitcall-CL-UAH-2'''

'''ucast em3 vivaitcall-CL-UAH-1-em3'''
'''#ucast em3 vivaitcall-CL-UAH-2-em3'''

'''#Ping a puerta de enlace gw1 gw2 gw3 gw4'''
'''ping_group red_local 10.255.255.12'''

'''respawn hacluster /usr/lib/heartbeat/ipfail'''
'''apiauth ipfail gid=haclient uid=hacluster'''

'''node vivaitcall-CL-UAH-1'''
'''node vivaitcall-CL-UAH-2'''
|}
::'''Nota:''' El parámetro '''auto_failback''' se utiliza para indicar si queremos que al recuperarse una maquina adquiera los recursos sobre los que tiene prioridad.
:El segundo fichero es '''''authkeys''''',, este fichero es el mismo en ambas maquinas:
:{|
|-
|
chmod 600 authkeys '''(importante)'''
auth 1
1 sha1 claveSecretaATope
|}

:El tercer fichero '''haresources''', donde especificaremos en las dos maquinas que deben apuntar a la maquina que queremos que tenga prioridad en la adquisición de los recursos, este fichero es el mismo en las dos maquinas:
:{|
|-
|
MÁQUINA 1 -> vivaitcall-CL-palacio-1 hb_mdtel
MÁQUINA 2-> vivaitcall-CL-palacio-1 hb_mdtel
|}
: Copiaremos en el directorio '''/etc/ha.d/resource.d/''' los scripts de arranque con permisos 755 (lo podemos hacer mediante WINSCP). Los scripts se encuentran en '''''C:\Documents and Settings\javier.gutierrez.MDTEL\Mis documentos\Centrales\Asterisk\Cluster\scripts'''''.
:{|
|-
|
chmod 755 hb_catalina
chmod 755 hb_mdtel
chmod 755 hb_mdtel_firewall
|}
: Deberemos editar el archivo '''hb_mdtel'''
:{|
|-
|
(IP flotante a.b.c.d./mask) 10.255.255.10
CAD_IP_FLOTA=10.255.255.10/24/bond0
|}
:

* Paramos el proceso '''myAcdSuperv'''.
:{|
|-
|
mv /etc/rc2.d/S02myAcdSuperv s02myAcdSuperv
|}
* Reiniciamos ambas maquinas para que su kernel tome los cambios.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== Comprobación de buen funcionamiento del cluster ====
* La maquina activa tiene que tener en HDcluster montado el disco con todos sus directorios y la maquina inactiva no (tenemos que ver el archivo que hemos creado "sinMontar").
* La ip virtual tiene que estar en la maquina activa (ifconfig) y no tiene que estar en la inactiva.
* El asterisk tiene que estar arrancado en la maquina activa y parado en la inactiva.
* Tecleando la ip de la maquina activa en un navegador debemos acceder al portal de vivait-call y en la inactiva no debe de estar activo.
* Para cambiar el cluster manualmente podemos utilizar los siguientes comandos:
:{|
|-
|
/usr/share/heartbeat/hb_takeover
|}
: La maquina desde la que se ejecuta se convierte en la maquina activa
:{|
|-
|
/usr/share/heartbeat/hb_standby
|}
: La maquina desde la que se ejecuta deja de ser la maquina activa

==== Notas para MySQL ====
Si mysql es parte del cluster tenemos que tener en cuenta dos cosas:

* El archivo '''/etc/mysql/debían.cnf''' contiene una clave que debe ser igual en ambas maquinas y debe ser la clave de la máquina de donde cojamos la base de datos. 
:{|
|-
|
# Automatically generated for Debian scripts. DO NOT TOUCH!
[client]
host = localhost
user = debian-sys-maint
password = AI6AdPtnhLUrNm1S
socket = /var/run/mysqld/mysqld.sock
[mysql_upgrade]
user = debian-sys-maint
password = AI6AdPtnhLUrNm1S
socket = /var/run/mysqld/mysqld.sock
basedir = /usr
|} 
* El archivo '''/etc/apparmor.d/usr.sbin.mysqld''' contiene donde pueden estar ubicados los archivos de mysql, al cambiar su ubicación y poner un enlace directo en /var/lib/mysql si no modificamos este archivo mysql no arrancara al no tener la nueva ubicación entre sus localizaciones permitidas. Este es un ejemplo de las líneas que debemos añadir. 
:{|
|-
|
/var/run/mysqld/mysqld.sock w, (copiar después de esta linea)

#//!!
/HDcluster/var/lib/mysql/ r,
/HDcluster/var/lib/mysql/** rwk,
#//!!
|}

==== Notas de desincronización ====
EL servicio del DRBD esta iniciado pero al teclear el comando cat /proc/drbd para ver si esta sincronizando se presenta "'''primary/unknown" y/o secondary/unknown''' ".
* En el nodo primary
:{|
|-
|
drbdadm connect all
|}

* En el nodo secondary
:{|
|-
|
drbdadm disconnect all
drbdadm -- --discard-my-data connect all
|}

==== Adaptar red a cliente ====
Para adaptar la red de los equipos al entorno del cliente hay que editar los siguientes ficheros:
{|
|-
|
/etc/network/interfaces
/etc/resolv.conf
/etc/hosts
/etc/ha.d/resource.d/hb_mdtel
/etc/ha.d/ha.cf
- TFTP:
/etc/inetd.conf (IP del cluster)

|}
Tras la modificaciones oportunas, se debe reiniciar las dos máquinas para cargar las nuevas configuraciones.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Matriz de conmutación ===

Encontramos dos diferentes núcleos de conmutación en la plataforma VIVAit:

* Para los nodos de procesamiento ACD el núcleo de conmutación es asterisk 1.4 RSP con fuertes modificaciones realizadas por MDtel en determinados módulos (queues, chan_spy entre otros)

* Para los nodos que realizan funcionalidad de gateway y/o procesamiento de telefonía corporativa, se utiliza como núcleo de conmutación asterisk 13, versión certified
https://wiki.asterisk.org/wiki/display/AST/Asterisk+13+Documentation

==== Modificaciones realizadas sobre Asterisk 13 certified 2 ====

===== Archivos añadidos por '''MD'''tel =====
Los archivos añadidos son los siguientes:

* '''apps/app_ucid.c'''
* '''apps/app_cli.c'''
* '''apps/app_crash.c'''
* '''apps/app_mdintz.c'''
* '''apps/app_mdintz.exports.in'''
* '''include/asterisk/mdintz.h'''
* '''include/asterisk/ucid.h'''
* '''res/res_mdcal.c'''

'''→ apps/app_mdintz.exports.in '''

Este archivo sirve para la exportación de funciones del mdintz para el uso por aplicaciones externas

===== Modificaciones de archivos =====

Los archivos modificados por '''MD'''tel son los mostrados a continuación:

* '''apps/app_mixmonitor.c'''
* '''res/res_calendar_caldav.c'''
* '''contrib/scripts/safe_asterisk'''
* '''contrib/init.d/rc.debian.asterisk'''
* '''channels/sig_pri.c'''
* '''channels/chan_sip.c'''

'''→ main/audiohook.c''' 

'''audiohook.c''' ha sido modificado para solucionar un crash de asterisk al utilizar en el mixmonitor las opciónes r y t

'''→ app_crash.c '''

Esta nueva aplicación es sólo compatible con '''Asterisk 13'''.

La documentación de la misma se encuentra en el comando: '''"core show application Crash"'''

Esta nueva aplicación ''permite añadir'' al plan de pruebas:

* Generación de una parada de asterisk. (Crash(IwantToGetAnAccessViolation) ó Crash(IwantToGetADoubleFreeMem))
* Verificación de su impacto. Por ejemplo, no deben cortarse las llamadas en curso, si así está previsto por la topología.
* Correcta generación de los "core", comprobando que funciona "backtrace" (bt).

'''Nota.-''' Esta aplicación no debería estar presente en una instalación de '''Asterisk 13'''

'''→ app_mdintz.c y mdintz.h''' 

Esta aplicación sirve como interfaz a entornos (funcionalidades) creados por MDtel

Para mas información consultar la página de [[MDintz|MDintz]].

Las rutas de estos archivos son las siguientes:

'''apps/app_mdintz.c''' 
'''include/asterisk/mdintz.h '''

'''app_mdintz.c''' :

'''app_mdintz.c''' orientada al proceso de enrutamiento a implementar en ''intz-nimitz.''

El archivo '''.c''' es casi igual para asterisk 1.4.24 y asterisk 13.
'''Nota.-''' Cuando se compila para asterisk 13, es necesario comentar la línea que pone '''"#define ASTERISK_OLD".'''

Los cambios implementados son:

* Unificación de código entre las versiones de asterisk
* Nuevo comando "qry"
* Posible resolución de "Mal write" en intz-nimitz (a verificar)

En cuanto al nuevo comando, el formato es:

'''mdintz qry <nHostFijo> <entorno> <servicio> <par1>...<parN>'''

Permite interrogar a un servidor de igual modo que hace el dialplan con '''fines de diagnóstico'''. La única diferencia es que se ha añadido el parámetro '''"nHostFijo"''' que puede tomar como valor '''"*"''' (lo que solicita una interrogación secuencial a todos los servidores definidos, igual a la funcionalidad del dialplan) ó '''"0"''' a '''"3"''' (que solicita un interrogación dirigida el host indicado como hostN, y sólo a él, en archivo de configuración).

Para instalarlo, es necesario copiar:

* '''asterisk/apps/app_mdintz.c'''
* '''asterisk/include/asterisk/mdintz.h'''
* En asterisk 1.4.24 conviene asegurar que se ha actualizado '''"asterisk/apps/app_queue.o"''' y '''"asterisk/apps/app_queue.so"'''
* Luego '''"make", "make install"''' y module '''"unload/load"''' (mejor "stop now" y start)

'''→ scripts y rc.debian.asterisk'''

cambiado contrib/scripts por el modificado por MDtel 
cambiado contrib/init.d/rc.debian.asterisk por el modificado por MDtel

'''→ Carpeta mp3 añadida al directorio addons'''

La carpeta mp3 en addons permite la reproducción desde el diaplan de los mensajes en mp3. En make menuselect hay que marcar el format_mp3 y app_mp3 e instalar el paquete mpg123 de ubuntu

'''→ sig_pri.c'''

Modificado para enviar/recibir el ucid en un primario qsig

Para que se envie el ucis tenemos que habilitar el envio de facilidades en el chan_dahdi.conf

facilityenable = yes

'''→ init.d''' 

* Uno de los archivos modificados ha sido '''init.d''', se encuentra en la ruta: '''/etc/init.d/asterisk'''. La modificación realizada es la siguiente:

{|style="background-color:#ffffcc;" class="wikitable"
|-
|-
| SAFE_ASTEISK=/usr/sbin/safe_asterisk 
if [ -x $SAFE_ASTERISK ] ; then 
:# //!! wkw 
:DAEMON=$SAFE_ASTERISK 
fi
|}



'''→ safe-asterisk'''
* Se encuentra en la siguiente ruta:'''/usr/sbin/safe-asterisk''' .En este archivo se ha modificado MAXFILES=32768

'''→ default'''

* Este fichero podemos encontrarlo en: '''/etc/default/asterisk'''. La finalidad de la modificación de este fichero es poder correr como usuario Asterisk, grupo asterisk y generar cores (descomentar línea)
Las modificaciones realizadas han sido:

{|style="background-color:#ffffcc;" class="wikitable"
|-
|-
| AST_USER="asterisk"
AST_GROUP="asterisk"

COREDUMP=yes
|}

===== Nueva función de asterisk: app_cli.so =====

Esta función permite ejecutar desde el '''dialplan''' un comando de línea de consola de '''asterisk (CLI).''' Su primer uso (y esperamos que no último) será para lanzar los '''notify''' que los teléfonos necesitan para el ''reaprovisionamiento'' desde el portal o desde la facilidad de movilidad de usuario.

Básicamente ejecuta un comando y devuelve su salida. Utiliza un archivo intermedio que puede ser:

* '''/dev/null''' si el campo se deja vacío, por tanto, no se puede recuperar la salida.
* '''TEMP''', en cuyo caso se crea un archivo temporal que se borra antes de finalizar la ejecución de la función.
* Un nombre de fichero que es responsabilidad del dialplan el borrarlo cuando proceda.

Para instalarlo basta copiar '''apps/app_cli.c''' en el directorio ''' "apps" ''' de los fuentes y luego ejecutar '''"make" y "make install".'''

A continuación se pasa el resultado de '''"core show function CLI" '''

'''[Synopsis]'''

Lanza un comando CLI desde dialplan

'''[Description]''' 
- CLI(nomArchSal,cmd) 
- Si 'nomArchSal' está vacio, se usa '/dev/null' y no se recupera resultado 
- Si 'nomArchSal'=TEMP, Se crea un archivo temporal que se borra al final 
- En otro caso, se crea el archivo y no se borra

'''[Syntax]''' 
CLI(nomArchSal,cmd)

'''[Arguments]''' 
'''nomArchSal'''
Archivo de salida (si se omite, /dev/null)
'''cmd'''
Comando a ejecutar via CLI

==== Dialplan ====

El Dialplan podría considerarse la columna vertebral del sistema ''Asterisk''.

Es una colección ordenada de acciones que se llevan a cabo cuando un usuario marca una serie de números. Hace la función de una tabla de enrutamiento de llamadas.

Todas las configuraciones generales de Asterisk están accesibles en la ruta '''/etc/asterisk'''

'''CONCEPTOS BÁSICOS'''

♦ '''EXTENSIONES'''

Una extensión es una marcación en el teclado de un teléfono. Dicha configuración podemos encontrarla en el archivo '''extensions.conf'''

Por ejemplo, un usuario podría marcar “3001” en su teléfono, y eso sería una extensión. También podría marcar un número de teléfono nacional, como por ejemplo “915881000”, y también sería una extensión.

En Asterisk pueden definirse también extensiones como texto, por tanto no debemos relacionar las extensiones únicamente con números.

Algunas reglas que sería interesante conocer serían las siguientes:

{| class="wikitable"
|-
! '''Regla''' !! '''Descripción'''
|-
| '''X''' || Cualquier cifra de 0 a 9
|-
|'''Z'''||Cualquier cifra de 1 a 9
|-
|'''N'''||Cualquier cifra de 2 a 9
|-
|'''[x-y]'''||Cualquier cifra de "x" a "y"
|-
|'''[xyz]'''|| Las cifras "x", "y" o "z"
|-
|'''.'''||Una o más repeticiones del símbolo anterior
|-
|'''!'''||Cero o más repeticiones del símbolo anterior
|}

Estas reglas son necesarias a la hora de definir por ejemplo todos los números de teléfono posibles en España

♦ '''PRIORIDADES'''

En lenguaje scripting, las acciones se van ejecutando de arriba a abajo en orden. En cambio, en Asterisk, el orden en el que se ejecutan las acciones es el indicado mediante números.
Primero se ejecutará la acción 1, luego la 2...así sucesivamente.

Es decir no basta con definir las acciones que se llevarán a cabo, también debemos indicar el orden en el que se llevarán a cabo.

♦ '''CONTEXTOS'''

Es mecanismo que nos permite variar el comportamiento del sistema en función del número que se marque. Su misión es aumentar la seguridad del sistema ofreciendo servicios diferenciados en función del usuario.

La sintaxis típica es el nombre del contexto englobado entre corchetes [nombre_contexto]. Si un dispositivo no tiene un contexto definido se redirige directamente al contexto por defecto.

Los ficheros que conforman el Dialplan se clasifican en:

* '''Generales'''
* '''Particulares'''
* '''Web'''

{| class="wikitable"
|-
! '''Fichero''' !! '''Función'''
|-
| '''Generales''' || Se encuentran los ficheros de propios de MDtel y Asterisk. Es importante remarcar que estos ficheros NO pueden ser modificados por el usuario.
|-
|'''Particular'''||Estos ficheros son los únicos que puede modificar el usuario
|-
|'''Web'''|| Se encierran aquí los archivos generados automáticamente por la plataforma, a través del portal
|}

En función del nodo en el que estemos trabajando, encontraremos dos tipos de dialplan:

'''* Dialplan ACD''' --> Dialplan que aplica a nodos ACD

'''* Dialplan corporativa''' --> Dialplan que aplica a nodos de corporativa o gateways (ya sean de corporativa o ACD)

A continuación se muestran las tablas con los ficheros correspondientes a cada Dialplan.

{| border="1" align="center" bgcolor="FloralWhite"
|+ '''Ficheros de configuración Dialplan Corporativo'''
| '''GENERALES'''
| '''PARTICULARES'''
| '''WEB'''
|-
| ext_Grabaciones.conf ext_InicioLlamada.conf ext_InicioLlamada_Dahdi.conf ext_InicioLlamada_ExtSIP.conf ext_InicioLlamada_TrunkSIP.conf ext_MARCAR_ColaCentralita.conf ext_MARCAR_ColaCentralita_Dial.conf ext_MARCAR_Cola.conf ext_MARCAR_Cola_Dial.conf ext_MARCAR.conf ext_MARCAR_DejarMensaje.conf ext_MARCAR_DejarMensaje_Dial.conf ext_MARCAR_Extension.conf ext_MARCAR_Extension_Dial.conf ext_MARCAR_Externo.conf ext_MARCAR_Externo_Dial.conf ext_MARCAR_Facilidad.conf ext_MARCAR_Facilidad_Dial.conf ext_MARCAR_Facilidad_nimitz.conf ext_MARCAR_Interno.conf ext_MARCAR_LeerMensaje.conf ext_MARCAR_LeerMensaje_Dial.conf ext_MARCAR_Nodo.conf ext_MARCAR_Nodo_Dial.conf ext_MARCAR_SalasConf.conf ext_MARCAR_SalasConf_Dial.conf ext_MARCAR_Servicios.conf ext_MARCAR_VDN.conf MARCAR_VDN_Dial.conf ext_MDtel.conf ext_MDtel_Var.conf ext_Subrutinas_AnchoBanda.conf ext_Subrutinas_BD.conf ext_Subrutinas_BD_Facilidad.conf ext_Subrutinas_BD_Facilidad.conf ext_Subrutinas_Colas.conf ext_Subrutinas.conf ext_Subrutinas_Enrutamiento.conf ext_Subrutinas_finLlamada.conf ext_Subrutinas_Grabacion.conf ext_Subrutinas_nimitz.conf ext_Subrutinas_Varias.conf ext_Subscribe.conf ext_Transfer.conf ext_Transfer_ExtSIP.conf ext_Transfer_TrunkInternos.conf ext_TrunkInternos.conf ext_TrunkInternos_Dial.conf sip_Estatico.conf sip_GENCUST.conf sip_notify.conf queues.conf queues_GENERAL.conf queues_PLANTILLACOLAS.conf 

| ext_Enrutador_Particular.conf ext_InicioLlamada_Dahdi_Particular.conf ext_InicioLlamada_ExtSIP_Particular.conf ext_InicioLlamada_Particular.conf ext_InicioLlamada_TrunkSIP_Particular.conf ext_MARCAR_Extension_Particular.conf ext_MARCAR_Externo_Particular.conf ext_MARCAR_Facilidad_Particular.conf ext_MARCAR_VDN_Particular.conf ext_MDtel_Particular.conf ext_TrunkInternos_Particular.conf 

|asterisk_WEB.conf ext_MDtel_WEB.conf sip_trunkExt_WEB.conf sip_trunkInt_WEB.conf sip_trunk_WEB.conf sip_WEB.conf queues_WEB.conf
|}

{| border="1" align="center" bgcolor="FloralWhite"
|+ '''Ficheros de configuración Dialplan ACD'''
| '''GENERALES'''
| '''PARTICULARES'''
| '''WEB'''
|-
| ext_Enrutador.conf ext_Grabaciones.conf ext_InicioLlamada.conf ext_InicioLlamada_CTI.conf ext_InicioLlamada_Dahdi.conf ext_InicioLlamada_ExtSIP.conf ext_InicioLlamada_Marcador.conf ext_InicioLlamada_TrunkSIP.conf ext_MARCAR_ColaCentralita.conf ext_MARCAR_ColaCentralita_Dial.conf ext_MARCAR_Cola.conf ext_MARCAR_Cola_Dial.conf ext_MARCAR.conf ext_MARCAR_DejarMensaje.conf ext_MARCAR_DejarMensaje_Dial.conf ext_MARCAR_Extension.conf ext_MARCAR_Extension_Dial.conf ext_MARCAR_Externo.conf ext_MARCAR_Externo_Dial.conf ext_MARCAR_Facilidad.conf ext_MARCAR_Facilidad_Dial.conf ext_MARCAR_Facilidad_nimitz.conf ext_MARCAR_LeerMensaje.conf ext_MARCAR_LeerMensaje_Dial.conf ext_MARCAR_Nodo.conf ext_MARCAR_Nodo_Dial.conf ext_MARCAR_SalasConf.conf ext_MARCAR_SalasConf_Dial.conf ext_MARCAR_Servicios.conf ext_MARCAR_VDN.conf ext_MARCAR_VDN_Dial.conf ext_MDtel.conf ext_MDtel_Var.conf ext_Subrutinas_AnchoBanda.conf ext_Subrutinas_BD.conf ext_Subrutinas_BD_Facilidad.conf ext_Subrutinas_Colas.conf ext_Subrutinas.conf ext_Subrutinas_Enrutamiento.conf ext_Subrutinas_finLlamada.conf ext_Subrutinas_Grabacion.conf ext_Subrutinas_nimitz.conf ext_Subrutinas_Varias.conf ext_Subscribe.conf ext_Transfer.conf ext_Transfer_ExtSIP.conf ext_Transfer_TrunkInternos.conf ext_TrunkInternos.conf ext_TrunkInternos_Dial.conf queues_GENERAL.conf queues_PLANTILLACOLAS.conf sip_GENCUST.conf sip_GENERAL.conf sip_notify.conf sip_PLANTILLAEXT.conf sip_supervision.conf 

| ext_Enrutador_Particular.conf ext_InicioLlamada_CTI_Particular.conf ext_InicioLlamada_Dahdi_Particular.conf ext_InicioLlamada_ExtSIP_Particular.conf ext_InicioLlamada_Marcador_Particular.conf ext_InicioLlamada_Particular.conf. ext_InicioLlamada_TrunkSIP_Particular.conf ext_MARCAR_Externo_Particular.conf ext_MARCAR_Facilidad_Particular.conf ext_MARCAR_VDN_Particular.conf ext_MDtel_Particular.conf ext_TrunkInternos_Particular.conf 

|asterisk_WEB.conf ext_MDtel_WEB.conf queues_WEB.conf sip_trunkInt_WEB.conf sip_WEB.conf 
|}
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Servicios networking ===
Son muy importantes las configuraciones adecuadas de los servicios de:

* '''NTP''': El sistema en global ha de estar sincronizado; todos los servidores y puestos de trabajo (en el caso de ''VIVA''it Suite) han de estar perfectamente sincronizados; los servidores de la plataforma se sincronizarán con el NTP del cliente; si el cliente no tiene NTP será necesario que un servidor de la plataforma se sincronice con un NTP externo y este sea el servidor para el resto de la plataforma

* '''DNS''': La configuración de DNS de la plataforma será coherente con el resto de la plataforma IT del cliente

* '''DHCP''': Es necesario coordinar con el cliente la asignación de direcciones para los diferentes elementos de la plataforma '''''VIVA'''''it, fundamentalmente para terminales telefónicos; en este caso además será necesario activa la opción 66 que permitirá definir el servidor TFTP del que los terminales cogerán sus ficheros de aprovisionamiento

=== Bases de datos (BBDD)===

La base de datos del sistema se basa en el motor de base de datos MySQL, es un elemento crítico del sistema, en el que insertan y del que obtiene mucha información múltiples procesos.
Muchas comunicaciones entre procesos se realizan vía Base de Datos (tabla COM_COMUNICADOS). Pueden existir distintas instancias de base de datos que explicadas en las siguientes secciones, nuestra base de datos tiene la siguiente estructura: [[Base de datos|Información completa de la BD]]. Podéis ampliar más información en https://dev.mysql.com/doc/

==== BBDD Tiempo Real ====
En la base de datos de tiempo real insertan información todos los procesos del sistema, y se realizan los cambios en configuración utilizando como herramienta el portal de administración y '''''VIVA'''''it Supervisor

De la base de datos de tiempo real leen los procesos que requieren información, y las aplicaciones:
*'''''VIVA'''''it Supervisor (para reporting de tiempo real)
*PanelWeb
*Datos de sesión de '''''VIVA'''''it Desk
*Monitorización Zabbix
* Otros

El portal de administración se encarga de escribir las configuraciones añadidas o modificadas en la base de datos

Para cuando la BDTR contienen un número masivo de datos, existe un script que borra el contenido de ciertas tablas de la BD (tablas DAT_) dejando solamente datos de un cierto número de días configurable.
Este script se llama borraRegistrosNimitz.pl; para más información consultar el apartado de Howto's.

'''Por defecto, a partir de la versión 3.2.0 de la plataforma, los registros se mantedrán 2 meses.'''

==== BBDD Réplica ====
A efectos de asegurar las prestaciones del sistema, se establece una réplica de la base de datos, sincronizada con la de tiempo real; los procesos y aplicaciones pesados, que realicen consultas a las base de datos que puedan comprometer las prestaciones del sistema atacan a la réplica y nunca a la base de datos de tiempo real

Es posible que en instalaciones pequeñas no exista réplica, en cuyo caso se establece una base de datos unificada sobre la de tiempo real, en la que se añaden índices y procedimientos almacenados que típicamente residen en la de réplica.

Es posible establecer tantas réplicas como sean necesarias si diferentes procesos pesados se penalizan en exceso, si bien una implantación tipo contemplará una sola

Algunos procesos que utilizan la base de datos de réplica son:
*'''''VIVA'''''it Reporting
*'''''VIVA'''''it Tracker
*Histórico en tiempo real de '''''VIVA'''''it Supervisor

'''IMPORTANTE: Ningún proceso, programa, aplicación, etc. escribe en la base de datos de réplica; tan solo se extrae información'''

==== BBDD de copia ====
A efectos de asegurar el funcionamiento y como medida de contingencia ante un problema puntual de comunicación con la BD de tiempo real, en cada nodo disponemos de una BD de copia local. Posiblemente de un tamaño menor que la BD de tiempo real, dependiendo de cuanto tiempo pase hasta la próxima sincronización con la base de tiempo real.Esta base de datos llamada '''nimitzCopia'''.

Solo entrara en funcionamiento,cuando se produzca el problema mencionado, dejando acceder a los datos y poder dar servicio a la empresa mientras se soluciona el problema.

===== Backup y restore =====

Se utilizan dos script, para realizar la copia de seguridad y restaurar en la base de datos de copia local que son:

* El proceso '''bdCentral.sh''' que es el encargado de realizar la copia de seguridad. Tiene un archivo de configuración bdCentral.conf. En este archivo hay un parámetro (IGNORE_TABLAS) que indica las tablas de las que NO se realizará copia de seguridad. Toda tabla que no se indique formará parte de la copia de seguridad. Vuelca los resultados en /var/log/bdCentral.log
* El proceso '''bdNodo.sh''' que es el encargado de descargar la copia de seguridad y restaurarla en local. Tiene un archivo de configuración bdNodo.conf. Vuelca los resultados en /var/log/bdNodo.log. El fichero de backup se copia mediante el usuario sincroniza, que deberá poder acceder sin contraseña al servidor donde reside la copia.

En caso de producirse algún error en alguno de los procesos, marcarán dicho error en el log con una línea que comienza con la cadena "*ERROR".

==== Diagnósticos y operaciones sobre bases de datos ====

=====Comprobación que una base de datos está arrancada=====
Para comprobar si la base de datos está arrancada debemos poner en el terminal : '''ps aux | grep mysql'''

Si la base de datos está arrancada y funcionando correctamente se nos mostrará en el terminal:
[[Archivo:Base_Datos_bien.png‎ |500px|center]]

Por el contrario, si la base de datos presenta algun problema el mensaje mostrado será:

[[Archivo:Base_datos_mal.png |center]]

=====Comprobación que la base de datos de réplica está sincronizada con la base de datos de tiempo real.=====

Si se necesita verificar que la base de réplica está sincronizada con la base de datos en tiempo real basta con acudir al comando : '''show slave status\G'''.

Una vez introducido veremos:

[[Archivo:Replica.png |980px|center]]

Comandos importantes, desde dentro consola de Mysql:

'''show master status''': Realizado desde el master
'''show slave status''': Realizado desde el esclavo; el valor "seconds behind master" nos indica
cuanto está retrasada la réplica con respecto a la base de datos de tiempo real. Si el valor de este campo es elevado nos indicará
que la base de datos real con la réplica no estará sincronizada, por tanto, nos interesa que este valor sea lo más pequeño posible.
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Procesos propios ===

==== bdCentral ====

El proceso ''bdCentral.sh'' es el encargado de realizar la copia de seguridad. Tiene un archivo de configuración ''bdCentral.conf'' el cual puede encontrarse en la ruta '''/etc/MDtel/bdCentral.conf'''. En este archivo hay un parámetro (IGNORE_TABLAS) que indica las tablas de las que NO se realizará copia de seguridad. Toda tabla que no se indique formará parte de la copia de seguridad. Vuelca los resultados en /var/log/bdCentral.log

En caso de producirse algún error, se marcará dicho error en el log con una línea que comienza con la cadena "*ERROR".

Para ejecutar bdCentral:
bdCentral.sh /etc/MDtel/bdCentral.conf

Estos procesos se ejecutan automáticamente. Para ello está copiado el fichero bdCentral a /etc/cron.d.

Por defecto la programación vienen comentada por lo que será necesario activarlo.

Para que se roten los logs hay que copiar el fichero bdCentral.logrotate a /etc/logrotate.d (como bdCentral)
La ruta donde se encuentran los logs es la siguiente: '''/var/log/myAcdSuperv.log'''


[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== bdNodo ====
El proceso bdNodo.sh es el encargado de descargar la copia de seguridad y restaurarla en local. Tiene un archivo de configuración bdNodo.conf, este archivo puede encontrarse en la ruta '''/etc/MDtel/bdNodo.conf.''' Vuelca los resultados en /var/log/bdNodo.log. El fichero de backup se copia mediante el usuario sincroniza, que deberá poder acceder sin contraseña al servidor donde reside la copia.

En caso de producirse algún error, se marcará dicho error en el log con una línea que comienza con la cadena "*ERROR".

Para ejecutar bdNodo:

bdNodo.sh /etc/MDtel/bdNodo.conf

Estos procesos se ejecutan automáticamente. Para ello está copiado el fichero bdNodo a /etc/cron.d.

Por defecto la programación vienen comentada por lo que será necesario activarlo.

Para que se roten los logs hay que copiar el fichero bdNodo.logrotate a /etc/logrotate.d (como bdNodo)

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== Intz-Nimitz ====

Permite integrar procesos de asterisk (del dialplan) con la base de datos; por ejemplo es el que graba segmentos, inspecciona donde esta registrado un agente…etc. La estabilidad de este proceso es importante para el funcionamiento del sistema, si bien las llamadas entran en caso de no estar disponible.

Para mas información consultar la página de [[intz-nimitz|intz-nimitz]].

Desde un SSH ejecuta el comando “nc ip_maquina 1115”

'''root@vivait-acd:~# nc localhost 1115'''
intz-nimitz sis ver='V02.6' inic='20140401 110116' alarmas=21 ultAlar='20140414 171244'
intz-nimitz gmp msj=942/1024 buf=1024/1024 tarea=16/102
intz-nimitz tmp uptime=1816550 (21d 0h 35m 50s)
intz-nimitz vic identif='cms1' entorno='nimitz' conx=0/128 numConx=1018(0)
intz-nimitz mys curro=80/0/0/0 soli=1012(0) soliErr=6(0) soliEncol=0(0/0)
intz-nimitz cache colas=128/10/0/0 vdn=128/8/0/0 usuExten=10/0/0/0

Donde cada parámetro monitorizado indica:
{| class="wikitable"
|-
!Parámetro!!Descripción
|-
|sis/ver||Versión del proceso
|-
|sis/inic||Fecha de de arranque del proceso
|-
|Sis/alarmas||Alarmas desde arranque
|-
|Sis/ultAlar||Fecha de última alarma
|-
|Gmp/msj||
|-
|Gmp/buf||
|-
|Gmp/tarea||
|-
|Tmp/uptime||Tiempo que lleva el servicio activo
|-
|Vic/identif||Etiqueta de identificación del servicio
|-
|Vic/entorno||Entorno de base de datos
|-
|Vic/conx||Conexiones activas/conexiones máximas
|-
|Vic/numConx||Conexiones totales (último minuto)
|-
|Mys/curro||Número de hilos contra la base de datos
|-
|Mys/soli||Conexiones solicitadas (último minuto)
|-
|Mys/soliErr||Conexiones solicitadas con error (último minuto)
|-
|Mys/soliEncol||Conexiones encoladas
|-
|Cache/cola|| Colas monitorizadas/
|-
|Cache/vdn||VDN’s monitorizados
|-
|Cache/usuExten||
|-
|}

Como complemento a los diagnósticos:

* Podremos examinar el fichero de configuración del proceso en '''/etc/MDtel/intz-nimitz.conf'''
* Podremos examinar los logs del proceso en '''/var/log/intz-nimitz.log'''



[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== motorSal ====
Parte fundamental del proceso de marcación saliente, gestiona como hay que llamar a los diferentes contactos asignados a las campañas. Transforma los contactos en intentos de marcación.

A efectos de diagnósticos, desde un SSH ejecuta el comando “nc ip_maquina 1120”

'''root@vivait-acd:~# nc localhost 1120'''
motorSal sis ver='V01.4' inic='20140725 140832' alarmas=1 ultAlar='20140725 140832'
motorSal gmp msj=253/256 buf=256/256 tarea=99/102
motorSal tmp uptime=600165 (6d 22h 42m 45s)
motorSal mtr mys=1 ocup=0% planif=28(0) intento=26(0)

Donde cada parámetro monitorizado indica:

{| class="wikitable"
|-
!Parámetro!!Descripción
|-
|SIS/ver||Versión del proceso
|-
|SIS/inic||Fecha de de arranque del proceso
|-
|SIS/alarmas||Alarmas desde arranque
|-
|SIS/ultAlar||Fecha de última alarma
|-
|Gmp/msj||
|-
|Gmp/buf||
|-
|Gmp/tarea||
|-
|Tmp/uptime||Tiempo que lleva corriendo
|-
|mtr/mys||Si está conectado al MySQL
|-
|mtr/ocup||Porcentaje de ocupación
|-
|mtr/planif||Contactos planificados Totales (Último minuto)
|-
|mtr/intento||Intentos totales (Ültimo minuto)
|-
|}

* Posee un fichero de configuración llamado ''motorSal.conf'' en la ruta '''/etc/MDtel/motorSal.conf'''.


* Respecto a los logs del motorSal consultar el siguiente apartado: [[Trazas motorSal]]. Los logs pueden verse en la ruta '''/var/log/intz-nimitz.log'''

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== MyACDSuperv ====
Refleja el estado de las colas de asterisk en la base de datos; tiene sentido a efectos de estadísticas e informes, pero no a efectos de funcionamiento de la conmutación de voz.

Es el responsable de mostrar información en las ventanes de tiempo real del supervisor.

Es también el proceso que genera las llamadas en el marcador automático de '''''VIVA'''''it Suite.

A efectos de diagnósticos, desde un SSH se ejecuta el comando “nc ip_maquina 1112”.

'''root@vivait-acd:~# nc localhost 1112'''
myAcdSuperv SIS ver='04.6' inic='20140416 081613' alarmas=6 ultAlar='20140416 121652'
myAcdSuperv AMI cnx=1 ocup=28% exten=2/2/511 asig=0/11/4095
myAcdSuperv MYSQL cnx=1 ms=316

Donde cada parámetro monitorizado indica:
{| class="wikitable"
|-
!Parámetro!!Descripción
|-
|SIS/ver||Versión del proceso
|-
|SIS/inic||Fecha de de arranque del proceso
|-
|SIS/alarmas||Alarmas desde arranque
|-
|SIS/ultAlar||Fecha de última alarma
|-
|AMI/cnx||Conectado (1) a asterisk
|-
|AMI/ocup||Porcentaje de ocupación de MyACDSuperv
|-
|AMI/exten||Extensiones/Extensiones/Extensiones monitorizadas|-
|-
|AMI/asig||
|-
|MYSQL/cnx||Conectado (1) a MySQL
|-
|MYSQL/ms||Tiempo de última operación en ejecutarse
|-
|}

Como complemento a los diagnósticos:

* Podremos examinar el fichero de configuración del proceso en '''/etc/MDtel/myAcdSuperv.cnf'''
* Podremos examinar los logs del proceso en '''/var/log/myAcdSuperv.log'''

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== Proceso escoba ====
El proceso escoba se encarga de resolver y consolidar todos aquellos segmentos de grabación que han quedado almacenados en los gateways por falta de información o incoherencias. Existen dos tipos de procesos escobas:
# Proceso escoba perteneciente a nodo con agente de grabación (recordNodo) llamado '''''escobaGW.pl'''''.
# Proceso escoba perteneciente o no a un servidor de grabación (recordCentral) llamado '''''escobaGrabsBd.pl'''''.

===== escobaGW.pl =====
Proceso que se ejecuta en los nodos busca en el disco RAM , las grabaciones de segmentos cuya antigüedad sea superior a mas de un día, es decir, si el proceso por ejemplo se ejecuta a la 01:00 a.m. del día 24/03/2016 buscara todas aquellas grabacionesn de segmentos realizadas antes de la 01:00 a.m del día 22/03/2016.
Una vez realizada la busqueda, obtendra el UCID a traves del nombre del fichero, y comprobara su correspondencia con la tabla DAT_LLAMADAS. Si existe una llamada con ese UCID, cambiara el estado de la llamada para que sea procesada correctamente. En caso contrario, es movida a la carpeta ''/var/lib/recordNodo/grabError''.

===== escobaGrabsBd.pl =====
Se ejecuta sobre la base de datos de histórico, normalmente se ejecuta en un servidor de grabación (recordCentral). El proceso hace una búsqueda en dos tablas:
* En DAT_SEGMENTOS obtiene todos aquellos segmentos con grabaciones que dieron error, su estado tendrá valor 120.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]
* En DAT_LLAMADAS obtendremos todos los registros correspondiente al segmentos anteriores.
Después hace una búsqueda en el sistema, usando como ruta el campo D_HORA_INICIO de cada llamada, que indica la ruta entera donde se encuentra el archivo. Una vez encontrado el archivo cambia el estado del segmento que tenia un error a estado de grabación disponible , que tendrá valor 100. Si no encontramos el segmento, no realizara nada.

==== recordCentral ====
Se considera como un servidor de grabaciones. Todas las grabaciones de llamadas son un activo importante y una empresa con Contact Center pueda recibir millones de llamadas que necesitan estar registradas y almacenadas en discos duros con gran capacidad, las máquinas donde suelen alojarse estos servidores poseen discos duros limitados, lo que hace necesario en algunos casos incorporar ''dispositivos NAS''.

Los ''dispositivos NAS'' son dispositivos de almacenamiento conectados a una red que permite el almacenamiento y la recuperación de datos desde una ubicación centralizada, flexibles y escalables, lo que significa que a medida que necesite almacenamiento adicional, puede añadirlo al que tiene. Esto no significa que sea necesario tener ''dispositivos NAS'' para funcionar, sino que puede tomar datos de diferentes sitios.

En '''recordCentral''' pueden existir tres tipos de dispositivos NAS:
* Uno dedicado para las llamadas
* Uno dedicado para los segmentos
* Uno mixto para todas las llamadas y segmentos.

El '''recordCentral''' se encarga de recoger todas las grabaciones de segmentos que tienen de estado proceso(3) en cada nodo gestionado, es decir, coger aquellos segmentos de llamadas marcados como llamadas disponibles, intenta descargar los segmentos de las llamadas y convertirlas al formato adecuado (MP3).
Como una característica particular cada diez minutos, siempre que no tenga ninguna otra tarea, intenta ver si puede establecer conexión con un nodo en cuarentena, para sacarlos de cuarentena y recoger todas las grabaciones de segmentos disponibles, para intentar convertir y descargar todas las grabaciones.

A efectos de diagnósticos, desde un SSH se ejecuta el comando '''''nc ip_maquina 1114''''' en la maquina donde creamos que debe estar ejecutando el proceso recordCentral. Ejemplo:
'''root@smadavacdrecord1:~# nc localhost 1114'''
recordCentral SIS ver='01.2' inic='20140423 094058' alarmas=11041 ultAlar='20140423 160112'
recordCentral MYSQL cnx=1
recordCentral NAS llamadas=1 segmentos=1
recordCentral REC llamNum=24901 llamErr=0 segmNum=38906 segmErr=0 retraso=305
recordCentral NODO fase=0 cuarentena='' descarga='8,6,4,7,10,9' gestion='4,6,7,8,9,10'
La explicación de los campos se muestra en la tabla siguiente:

{| class="wikitable"
|-
! Parámetro !! Descripción
|-
| SIS/ver || Versión del proceso
|-
| SIS/inic || Fecha de arranque del proceso
|-
| SIS/alarmas || Alarmas desde arranque
|-
| SIS/ultAlar || Fecha de última alarma
|-
| MYSQL/cnx || Conectado (1) a MySQL
|-
| NAS/llamadas || Alojamiento en NAS de llamadas activo (grabación de llamada completa en un único archivo)
|-
| NAS/segmentos || Alojamiento en NAS de segmentos activo
|-
| REC/llamNum || Llamadas procesadas
|-
| REC/llamErr || Llamadas con error
|-
| REC/segmNum || Segmentos procesados
|-
| REC/segmErr || Segmentos con error
|-
| NODO/fase || Número de proceso de recordCentral
|-
| NODO/cuarentena || Lista de nodos en cuarentena, separada por comas
|-
| NODO/descarga || Lista de nodos en descarga, separada por comas
|-
| NODO/gestion || Lista de nodos gestionados, separada por comas (cuarentena + descarga = gestión)
|}

Como complemento a los diagnósticos:
* Podremos examinar el fichero de configuración del proceso en '''/etc/MDtel/recordCentral.pconf'''



* Podremos examinar los logs del proceso en '''/var/log/recordCentral.log'''


[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== recordNodo ====
Se considera como proceso con función de agente de grabación para un nodo. Solo debe existir uno por maquina o por nodo (configurado como grabador) en el '''portal de administración de ''VIVA''it'''.

Para su funcionamiento utiliza un ''disco RAM'' por que su tiempo de acceso mejora drásticamente, debido a que la memoria RAM es varios órdenes de magnitud más rápida que las unidades de disco reales, haciendo que la velocidad de procesamiento de las grabaciones sea mucho mas rápida.

Este ''disco RAM'' normalmente ocupa la mitad de la memoria RAM de una maquina pero no es obligatorio pues dependerá de la memoria disponible en cada maquina, y además, se configura con un tamaño no superior a 2GB de memoria RAM. Hay que tener especial cuidado en que no se llene en espacio ni tampoco los i-nodos. Se puede monitorizar a través de la aplicación '''zabbix'''.

El '''''recordNodo''''' se encarga de recoger todas las grabaciones de segmentos que tienen de estado ''proceso(2)'', es decir, aquellos segmentos de llamadas que han sido grabadas pero no están siendo procesadas, moviéndolas del ''disco RAM'' a su carpeta correspondiente.

La forma de obtener la carpeta correspondiente es obteniendo el dato del campo D_HORA_INICIO en la tabla DAT_LLAMADAS para cada segmento,tras un tratamiento del campo creara la subruta correspondientes: /año/mes/dia/hora/min. Entonces, la ruta correcta seria /var/lib/recordNodo/grabaciones/año/mes/dia/hora/min, donde año, mes, dia , hora y min son los valores numéricos obtenidos del campo D_HORA_INICIO.

A efectos de diagnósticos, desde un SSH se ejecuta el comando '''''nc ip_maquina 1113''''' en la maquina donde creamos que debe estar ejecutando el proceso recordNodo:

root@smadavgw5:~#nc localhost 1113
recordNodo SIS ver='04.00.00' inic='20160326 105137' alarmas=2 ultAlar='20160326 105542'
recordNodo MYSQL cnx=1
recordNodo REC grabNum=0 grabErr=0

La explicación de los campos se muestra en la tabla siguiente:
{| class="wikitable"
|-
! Parámetro !! Descripción
|-
| SIS/ver || Versión del proceso
|-
| SIS/inic || Fecha de arranque del proceso
|-
| SIS/amarmas || Alarmas desde arranque
|-
| SIS/ultAlar || Fecha de última alarma
|-
| MYSQL/cnx || Conectado (1) a MySQL
|-
| REC/llamNum || Llamadas procesadas
|-
| REC/llamErr || Llamadas con error
|-
| REC/segmNum || Segmentos procesados
|-
| REC/segmErr || Segmentos con error
|}

Como complemento a los diagnósticos:
* Podremos examinar el fichero de configuración del proceso en '''/etc/MDtel/recordNodo.pconf'''
:Se muestra a continuación el fichero de configuración:
#
# Configuracion de recordNodo.pl
#
# 0: Solo alarmas en archivo log - 1: alarmas y trazas
$depurar = 1;

# 0: Arranca como proceso - 1: arranca como demonio
$soyDemonio = 1;

# Archivo de log ('': salida estandar)
$logArch = '/var/log/record/recordNodo.log';

# Archivo para el pid (eliminando el .pid final)
$pidArch = '/var/run/record/recordNodo';

# 0: El programa se ejecuta indefinidamente - 1: solo una vez (util en depuracion)
$unaVezSolo = 0;

# Tiempo de espera en segundos cuando no hay conexion o cuando no hay llamadas
$toBucle = 5;

# Tiempo de guarda en segundos desde D_HORA_FIN hasta que se procesa llamada
$toProcesar = 30;

# Bytes por segundo en archivos de grabaciones
$bytesPorSegundo = 16000;

# Bytes a leer en cada accceso a disco
$bytesLeerBuf = 1048576;

# Conexion de base de datos
$db='nimitz';
$dbHost = 'BDTR';
$dbPort = '3306';
$dbUsuario = 'nimitz';
$dbClave = 'ivivanimitz';

# Configuracion de la supervision
$supPort = '1113';

# Quien es mi nodo para filtrar grabaciones
$miNodo = 2;

# Directorio donde se localizan las grabaciones
$grabRutaOrig = '/var/spool/asterisk/monitor';
$grabRutaDest = '/var/lib/recordNodo/grabaciones';
$grabRutaError = '/var/lib/recordNodo/grabError';
$grabRutaUsaTimestamp = 1;

# Tiempo en segundos limite a truncar en las grabaciones (0=sin limite)
$grabLimiteSegs = 0;

# Indica si se procesan segmentos de tipo tipoSegmEliminarGrabacion y patron eliminacion
$segmEliminarGrabacionTrato = 1;
$patronEliminarGrabacion = '/etc/MDtel/null.bin'

A continuación se indican las variables a modificar:

{| class="wikitable"
|-
! Variable a modificar !! Comentario
|-
|$depurar = 1;||'''0''': Solo alarmas en archivo log
'''1''': alarmas y trazas
|-
|$soyDemonio = 1;||'''0''': Arranca como proceso
'''1''': arranca como demonio
|-
|$logArch = '/var/log/record/recordNodo.log';||Archivo de log ('': salida estándar) $pidArch = '/var/run/record/recordNodo'; Archivo para el pid (eliminando el .pid final)
|-
|$unaVezSolo = 0;||'''0''': El programa se ejecuta indefinidamente
'''1''': solo una vez (útil en depuración)
|-
|$toBucle = 5;||Tiempo de espera en segundos cuando no hay conexión o cuando no hay llamadas
|-
|$toProcesar = 30;||Tiempo de guarda en segundos desde D_HORA_FIN hasta que se procesa llamada
|-
|$bytesPorSegundo = 16000;||Bytes por segundo en archivos de grabaciones
|-
|$bytesLeerBuf = 1048576;||Bytes a leer en cada acceso a disco
|-
|$db='nimitz';||Conexión de base de datos
|-
|$dbHost = 'BDTR';||
|-
|$dbPort = '3306';||
|-
|$dbUsuario = 'nimitz';||
|-
|$dbClave = 'ivivanimitz';||
|-
|$supPort = '1113';||Configuración de la supervisión
|-
|$miNodo = 2;||Quien es mi nodo para filtrar grabaciones
|-
|$grabRutaOrig = '/var/spool/asterisk/monitor'; Directorio donde se localizan las grabaciones
|-
|$grabRutaDest = '/var/lib/recordNodo/grabaciones';
|-
|$grabRutaError = '/var/lib/recordNodo/grabError';
|-
|$grabRutaUsaTimestamp = 1;||'''1''': Usa Timestamp
'''0''': No usa Timestamp
|-
|$grabLimiteSegs = 0;|| Tiempo en segundos limite a truncar en las grabaciones (0=sin limite)
|-
|$segmEliminarGrabacionTrato = 1;||Indica si se procesan segmentos de tipo tipoSegmEliminarGrabacion y patrón eliminación
|-
|$patronEliminarGrabacion = '/etc/MDtel/null.bin'
|}


* Podremos examinar los logs del proceso en '''/var/log/recordNodo.log'''

==== Vivait-CTI ====
Permite la comunicación entre la aplicación '''''VIVA'''''it Desk de agente y el asterisk, sincronizando; convierte el protocolo “asterisk manager” a CSTA ('''''VIVA'''''it Desk “habla” CSTA).

Es un proceso importante para que el uso de '''''VIVA'''''it Desk, y que los agentes puedan realizar su operativa normal con la entrada y salida de llamadas… si bien el cursado telefónico de llamadas es factible, no disponer de las facilidades de '''''VIVA'''''it Desk y formularios hace el sistema difícilmente manejable

A efectos de diagnósticos, desde un SSH se ejecuta el comando “nc ip_maquina 1111”

'''root@vivait-acd:~# nc localhost 1111'''
vivait-cti sis ver='V01.5' inic='20140414 104312' alarmas=13 ultAlar='20140415 173152'
vivait-cti gmp msj=1018/1024 buf=1023/1024 tarea=97/102
vivait-cti tmp uptime=694748 (8d 0h 59m 8s)
vivait-cti cti numConx=(0/511) numPend=(0/127) numMakeCallPend=0 numCall=(0/2047)
numChan=(0/4095) numAuxStr=(0/511) numMoniColas=(0/511) numMoniDevice=0
numMoniCall=0 numMoniCallAuto=0 numMoniCallByDevice=0 numMoni=(0/511)
auditCallErr=0 auditAuxStrErr=0 auditMsjReqErr=0 araChanID=0 araUniqueID=0 araMoni=0
vivait-cti ami esta=conx resp=652(0) evs=1397(0) descar=556(0) err=16 errConx=16
numAct(0/0/127) auditErrAct=0

Donde cada parámetro monitorizado indica:

{| class="wikitable"
|-
!ver!!Versión del proceso
|-
|sis/inic||Fecha de de arranque del proceso
|-
|Sis/alarmas||Alarmas desde arranque
|-
|Sis/ultAlar||Fecha de última alarma
|-
|Gmp/msj||
|-
|Gmp/buf||
|-
|Gmp/tarea||
|-
|Tmp/uptime||
|-
|Cti/numConx||Número de conexiones actuales / Número de conexiones máximo
|-
|Cti/numPend||
|-
|Cti/numMakeCallPend||Llamadas pendientes de realizar
|-
|Cti/numcall||
|-
|Cti/numChan||
|-
|Cti/numAuxStr||
|-
|Cti/numMoniColas||Número de colas monitorizadas
|-
|Cti/numMoniDevice||
|-
|Cti/numMoniCall||
|-
|Cti/numMoniCallAuto||
|-
|Cti/numMoniCallByDevice||
|-
|Cti/numMoni||
|-
|Cti/auditCallErr||
|-
|Cti/auditAuxStrErr||
|-
|Cti/ auditMsjReqErr||
|-
|Cti/ araChanID||
|-
|Cti/ araUniqueID||
|-
|Cti/ araMoni||
|-
|Ami/esta||Estado de conexión contra manarger de asterisk
|-
|Ami/resp||
|-
|Ami/evs||Número de eventos (último minuto)
|-
||Ami/descar
|-
|Ami/err||Errores
|-
|Ami/errConx||Errores de conexión
|-
|Ami/numAct||
|-
|Ami/auditErrAct||
|-
|}

Como complemento a los diagnósticos:

* Podremos examinar el fichero de configuración del proceso en '''/etc/MDtel/vivait-cti.conf'''
* Podremos examinar los logs del proceso en '''/var/log/vivait-cti.conf'''

==== Phoneprov-TFTP ====

==== Introducción al aprovisionamiento ====

En cada Centralita Telefónica existente, se puede configurar sus teléfonos IP y asignarles extensiones a cada teléfono. Para hacer un ''aprovisionamiento'' de los teléfonos es necesario que el técnico configure uno a uno manualmente utilizando su interfaz web, esto no es práctico, ya que genera muchos errores y el tiempo de implementación se incrementa drásticamente. Además, es casi imposible la administración cotidiana de los teléfonos IP. Desde '''MD'''tel se utiliza una herramienta que permite que los teléfonos IP soportados y homologados por '''MD'''tel ([[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_3.0#Terminales_telef.C3.B3nicos ver Terminales telefónicos]]) se puedan aprovisionar automáticamente, brindando una fácil implementación y administración cotidiana.

===== ¿Qué es aprovisionar? =====

Aprovisionar un teléfono es el proceso de configuración automático de teléfonos IP para su uso con una Centralita Telefónica de forma remota. Una vez que aprovisione un teléfono, el teléfono automáticamente se configurará correctamente y podrá administrar los teléfonos de forma centralizada y remota, sin tener que iniciar sesión en la interfaz web de cada uno de los teléfonos.

El aprovisionamiento de teléfono facilita enormemente la administración cotidiana de los teléfonos IP. Esto hace que sea fácil de cambiar las contraseñas de extensión,realizar desvíos de llamadas, nombre a mostrar, mensajería y demás configuraciones, ya que puede hacerlo de forma centralizada para todos los teléfonos desde el portal de administración y luego transferir los cambios al teléfono.

===== TFTP =====

'''TFTP''' son las siglas de '''T'''rivial '''F'''ile '''T'''ransfer '''P'''rotocol ''(Protocolo de transferencia de archivos trivial)''.

Es un protocolo de transferencia muy simple semejante a una versión básica de FTP. TFTP a menudo se utiliza para transferir pequeños archivos entre terminales en una red.

Algunos detalles del TFTP:

* Utiliza UDP (puerto 69) como protocolo de transporte (a diferencia de FTP que utiliza los
puertos 20 y 21 TCP).
* No puede listar el contenido de los directorios.
* No existen mecanismos de autenticación o cifrado.
* Se utiliza para leer o escribir archivos de un servidor remoto.
* Soporta tres modos diferentes de transferencia, "netascii", "octet" y "mail”.

===== Funcionamiento del servidor phoneprove-TFTP =====

A continuación se muestra un esquema que facilita el entendimiento del funcionamiento del servidor phoneprove-TFTP:

[[Archivo:Funcionamiento_Servidor.png‎ |center]]

El servidor Phoneprove-TFTP se ''encarga del aprovisionamiento masivo de terminales'', es de gran utilidad porque cualquier cambio en los teléfonos pueden ser realizados a nivel DHCP y todos los teléfonos tomarán la nueva configuración luego de reiniciarlos.

Desde phoneprove-TFTP se generara los archivos necesarios para cada teléfono y que sirven para ser aprovisionados automáticamente.
El servidor phoneprove-TFTP tiene alojados los ficheros de configuración están ordenados según las direcciones MAC de los teléfonos. El teléfono “preguntará” al servidor cual es su fichero de configuración utilizando su dirección MAC. Este a través de su MAC , consulta en la base de datos para ofrecer al terminal los datos de configuración según su plantilla, cual sera su extensión , cual sera el usuario propietario, entre otras cosas.

{|
|-
|
'''Nota:''' En instalaciones grandes habrá más de uno, quizás uno por sede grande; depende de la infraestructura de DHCP.
|}

===== Parámetros necesarios de Aprovisionamiento de Teléfonos =====

'''Notas:''' el aprovisionamiento desarrollador por '''MD'''tel, no emplea un fichero por cada
teléfono, sino que emplea una plantilla por cada modelo de teléfono.
Debe haber una '''configuración previa del servidor DHCP''' es necesario coordinar con el cliente la asignación de direcciones para
los diferentes elementos de la plataforma '''''VIVA'''''it, fundamentalmente para terminales telefónicos; en este caso además será necesario
activar la opción 66 que permitirá definir el servidor TFTP del que los terminales cogerán sus ficheros de aprovisionamiento.
El aprovisionamiento desde el portal de administración solo es posible para aquellos teléfonos IP homologados y probados desde '''MD'''tel
[[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_3.0#Terminales_telef.C3.B3nicos ver Terminales telefónicos]]

Como existen parámetros comunes de todos los teléfonos de la misma marca de fabricante, muchos de los parámetros necesarios para el aprovisionamiento como comentamos se han generado desde MDtel en forma de plantillas, que estarán disponibles en el portal de administración VIVAit [[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Plantillas | ver plantilla del portal de administración VIVAit]].

La configuración de un teléfono SIP es muy sencilla y en no es necesario tener conocimientos avanzados de informática o de telefonía. Cada una de estas plantillas que sirven para aprovisionar un teléfono IP homologado, algunos de los parámetros predeterminados se explicarán a continuación .

====== Parámetros de Aprovisionamiento globales ======

* Configuración de la red y MAC.
* Zona horaria.

====== Parámetros de Aprovisionamiento Personales ======

Además de los parámetros de aprovisionamiento globales, el teléfono también obtendrá información de configuración individual, tales como:

*Número de Extensión.
*Nombre y Contraseña de usuario SIP.
*Configuración de Teclas BLF.
*Contraseña de la Interfaz Web del Teléfono IP.
*Idioma de la Pantalla.
*Orden de Preferencia de los Codecs.

===== Aprovisionamiento de teléfonos nivel usuario =====

{|
|-
|
'''Notas:''' La dirección MAC debe estar especificada en letras mayúsculas.
La dirección MAC del teléfono se puede encontrar en la etiqueta adhesiva en la parte inferior del teléfono, o de lo contrario se deberá acceder desde
el menú del propio terminal.
|}

Los pasos a seguir son los siguientes:

'''1)''' Dar de alta el teléfono en el portal de administración, se debe seleccionar el modelo del teléfono, e indicar la dirección MAC del teléfono a aprovisionar, todo ello desde el portal de administración VIVAit.
Para mas información ver [[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Aprovisionamiento del portal de administracion| aprovisionamiento del portal de administración VIVAit]].

'''2)''' En el mismo portal de administración se deberá crear una extensión , asignar a la extensión el teléfono que se quiera aprovisionar, elegir la plantilla adecuada del teléfono y el usuario propietario (solo si sera un puesto fijo) desde [[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Extensiones | extensiones del portal de administración]].

'''3)''' Conectar el teléfono a la red LAN informática (conectarlo al router o switch) para que tenga acceso a Internet:

:*El teléfono enviará un mensaje de multidifusión a través de la LAN.
:*Este será captado por la Central Telefónica siempre que esté en la misma LAN.
:*Al teléfono se le enviará una URL de aprovisionamiento.

'''4)''' Como la mayoría de teléfonos IP del mercado al arrancar una vez sabiendo la URL de aprovisionamiento piden una serie de archivos de configuración para aprovisionarse vía TFTP. EL servidor phoneprove-TFTP, detectara la petición y a través de la MAC y datos del usuario, consultará en la base de datos los datos necesarios para aprovisionar al teléfono y si todo funciona correctamente mandara al teléfono IP los datos de configuración necesarios para funcionar.

'''5)''' Asegúrese de que el teléfono encuentren el servidor TFTP, para ello esperar un tiempo adecuado para que termine el aprovisionamiento.

'''6)''' Finalmente aparecerá como registrado en la centralita, obtendrá una dirección IP y podra funcionar según la configuración establecida.

{|
|-
|
'''Nota''': Si no se reaprovisiona tras un periodo largo de tiempo, desenchufe el cable de alimentación eléctrica o el cable Ethernet (si se utiliza la alimentación en línea PoE) para reiniciar los teléfonos.
|}

===== Aprovisionamiento de teléfonos nivel técnico =====

====== Plantilla de configuración ======

La plantilla de configuración empleadas en el apartado [[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Plantillas | plantilla del portal de administración VIVAit]] de cada modelo está formada por una serie de variables.

Los valores se obtienen de la tabla de la base de datos CEN_TELEFONOS, CEN_USUARIOS, ACD_EXTENSIONES, ACD_NODOS, COM_NODOS... correspondientes a la extensión del teléfono, usuario, nodo, etc.

variable ${NODO1_C_NOMBRE}='corp-ast13'
variable ${EXTEN_C_CLAVE_REGISTRO}='Tel21002'
variable ${USU_C_CODIGO_POSTAL}=''28034'
variable ${SEDE_C_CODIGO_POSTAL}='28034'
variable ${USU_C_NOMBRE}='Juan Antonio'
variable ${USU_C_APELLIDO2}='Ramirez'
variable ${SEDE_C_NOMBRE}='RED_LAB'
variable ${NODO2_C_NOMBRE}= NULL
variable ${EXTEN_C_NOMBRE}='' 21002
variable ${USU_C_LOCALIDAD}=''
variable ${USU_C_NOMBRE_MOSTRAR}='Juan'
variable ${NODO1_C_IP}='175.25.129.70'
variable ${MODEL_C_PREFIJO_PLANTILLA_MAC}='T28P'
variable ${SEDE_C_LOCALIDAD}='Madrid'
variable ${USU_C_APELLIDO1}='Casas'
variable ${NODO2_C_IP}= NULL
variable ${TF_ID_EXTENSION}='5'
cargando campos idExten=5

====== Ficheros y paquetes necesarios ======

'''Paquetes previos:''' libnet-tftpd-perl, tftp-hpa, libnet-address-ip-local-perl
'''Usuario de funcionamiento:''' root

{|
|-
|
'''Nota:''' los archivos y directorios que generemos podrian necesitar que se permitiera el acceso al archivo de lectura y escritura en el servidor TFTP.
|}

'''Archivos necesarios:'''

/usr/local/sbin/phoneprov-tftp.pl
/usr/local/sbin/phoneprov-tftp.pm
/etc/MDtel/phoneprov-tftp.pconf
/etc/init/phoneprov-tftp.conf
/etc/logrotate.d/phoneprov-tftp

'''Directorios a crear:'''

/var/lib/phoneprov-tftp/plt
/var/lib/phoneprov-tftp/bin

==== Watchdog ====

Se trata de una aplicación del asterisk que monitoriza el SIP y en caso de fallo, pasado un cierto tiempo, reinicia el asterisk y genera un core.
Si escribimos en CLI de asterisk perro tenemos los siguientes comandos:

{| class="wikitable" border="0" style="background:#ffffff" align="top"
|-
|Activar||Activar el Watchdog
|-
|Desactivar||Desactiva el Watchdog
|-
|Parada IWantToStop||Reinicia el asterisk y genera un core para pruebas
|-
|Reload||Realiza una recarga del Watchdog y aplica cambios en su configuración
|-
|Show||Ver el estado del Watchdog

perro avisado=0 activo=1 segsDormir=1 segsInic=60 segsGuarda=30 maxErr=3
perro nombre=sip_monitor_udp lwp=[15437] segsInic=60 segsGuarda=30 hace=11 err=0/5
|-
|}

El dato "hace" informa de cuanto tiempo ha transcurrido desde el último tick. Facilita la calibración del parámetro de configuración "segs_guarda", normalmente es 30

Tiene un fichero de configuración ubicado en /etc/asterisk/MDcrash.conf

{| class="wikitable" border="0" style="background:#ffffff" align="top"
|-
|Sección [perro]
||activo=yes (Si esta o no activo)
segs_dormir=1 (Un tick por segundo)

segs_inic=60

segs_guarda=30

max_errores=3
|-
|Sección [sip_monitor_udp]
||segs_inic=60

segs_guarda=30 (Cada 30 segundos si no reciba trafico SIP genera core)

max_errores=5 (Número máximo de errores)
|-
|}



==== Proceso de Backup ====
Las plataformas '''''VIVA'''''it Call y '''''VIVA'''''it Suite incluyen un script para realizar un proceso de backup.

Se utilizará el script '''backup.sh''', que se encuentra en el directorio '''etc/MDTel'''.

Se ejecuta automaticamente mediante el uso de un cron

'''texto del cron:'''

SHELL=/bin/sh
PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
# m h dom mon dow user command
0 2 * * * root /etc/MDtel/backup.sh /etc/MDtel/backup.cfg

Para activar el script hay que descomentar la línea
# m h dom mon dow user command

Los directorios de los que se hace copia son:
* DIR=var/lib/asterisk/sounds/Particular
* DIR=var/lib/asterisk/moh
* DIR=etc
* DIR=etc/asterisk
* DIR=etc/cron.d
* DIR=etc/dahdi
* DIR=etc/exim4
* DIR=etc/ha.d
* DIR=etc/logrotate.d
* DIR=etc/MDtel
* DIR=etc/mysql
* DIR=etc/network
* DIR=etc/zabbix
* DIR=usr/local/sbin

Por defecto se realiza un backup cada dos horas en la carpeta '''/var/spool/MDtel/backup'''.

Para cambiar la ruta de destino del backup habrá que modificar el fichero backup.sh, en concreto modificar la variable MDTEL.

El fichero ''' backup.cfg''' que se genera incluye copia de la siguiente información:
* Ficheros de configuración de la aplicación.
* Base de Datos.
* Dialplan.

Se guardarán 10 copias del fichero ''' backup.cfg '''

Los campos disponibles en el fichero son los siguientes:

{| class="wikitable"
|-
!Campo !!Descripción !!Posibles valores (si aplica)
|-
|IP_BD ||IP o HOST máquina base de datos de tiempo real||
|-
|HAY_SMB ||Si hay o no servidor SAMBA||1 si existe servidor SAMBA o 0 si no existe
|-
|HOST_SMB||IP o HOST servidor SAMBA||
|-
|USU_SMB||Usuario acceso servidor SAMBA||
|-
|CLAVE_SMB||Clave usuario acceso servidor SAMBA||
|-
|RUTA_SMB||Ruta donde se guardará el backup en el servidor SAMBA||
|-
|}

Para recuperar una plataforma utilizando el backup, habrá que instalar una máquina nueva y cargar los ficheros de configuración, Base de Datos y Dialplan guardados en el proceso de backup.

===== Información adicional: como funciona un cron =====

La información sobre el fucnionamiento de un cron puede encontrarse en: [http://lasegundapuerta.com/index.php/informatica/linux-y-software-libre/1709-comando-cron-en-linux-ubuntu Información sobre el comando cron]

==== CHAT ====
La información para configurar el CHAT y su funcionamiento puede encontrarse en:

[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#CHAT CHAT]

=== Requerimientos de conectividad ===

El esquema siguiente muestra como ejemplo todos los flujos de información existentes en un entorno típico de <big>'''telefonía corporativa (sin presencia)'''</big> ('''''VIVA'''''it Call)

[[Archivo:Flujos corporativa.png|cebter]]

En el entorno de <big>'''Contact Center'''</big>, encontramos los siguientes flujos <big>'''entre servicios'''</big> (comunicaciones entre servidores, ('''''VIVA'''''it Suite))

[[Archivo:Flujos Contact servicios.png|650px|center]]

y <big>'''entre usuarios y servicios'''</big> los reflejados a continuación:

[[Archivo:Flujos Contact puestos.png|600px|center]]

{| class="wikitable"
|-
!Lado A!!Lado B!!Puertos!!Sentido!!Observ.
|-
|Terminal telefónico||Servidor||TCP 5060||A -> B||Señalización SIP
|-
|Terminal telefónico||Servidor||UDP 5060||A -> B||Señalización SIP
|-
|Terminal telefónico||Servidor||10000 a 20000||A -> B
B -> A
||RTP
|-
|Terminal telefónico||Servidor TFTP||UDP 69||A -> B
B -> A
||Para actualización de terminales por TFTP
|-
|Terminal telefónico||Servidor NTP||UDP 123||A -> B||
|-
|'''''VIVA'''''it Desk||Servidor||TCP 4500||A -> B||Comunicación CTI
|-
|'''''VIVA'''''it Desk||Servidor||TCP 3306||A -> B||Acceso a Mysql Base de datos
|-
|'''''VIVA'''''it Desk||Servidor Syslog||UDP 514||A -> B||Para envio de logs de agente
|-
|'''''VIVA'''''it Supervisor||Servidor||TCP 3306||A -> B||Acceso a Mysql Base de datos
|-
|'''''VIVA'''''it Tracker||Servidor||TCP 3306||A -> B||Acceso a Mysql Base de datos
|-
|'''''VIVA'''''it Tracker||Servidor||TCP 8180||A -> B||
|-
|Actualizador||Servidor||TCP 80||A -> B||Necesario para actualizaciones de versiones de aplicaciones de agente y supervisores
|-
|Portal de administración||Servidor||TCP 8180||A -> B||Acceso al portal de administración '''''VIVA'''''it Suite
|-
|'''''VIVA'''''it Tracker Web||Servidor||TCP 8180||A -> B||
|-
|Monitor||Servidor||TCP 8180||A -> B||Wallboard
|-
|Monitorización||Servidor||TCP 80||A -> B||Acceso a portal monitorización (Zabbix)
|-
|}

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Gateways ===
El concepto de gateway como tal no existe en la plataforma '''''VIVA'''''it; existen nodos de ACD y nodos de corporativa.

A efectos de operación un nodo de corporativa es el que en cualquier caso asumirá las funcionalidades de gateway, y recibirá las conexiones (analógicas, digitales o IP) a sistemas externos o a la RTC

El concepto gateway queda pues suscrito a entornos meramente comerciales

Incluimos no obstante en este apartado los diagnósticos y operaciones básicos de conexiones a sistemas externos o RTC

Para verificar los enlaces establecidos ejecutamos el siguiente comando en el terminal: '''sip show peers'''

Al ejecutar este comando obtenemos la salida:

[[Archivo:Enlace_Exterior.png |center]]

Las columnas ''Host'' y ''Port'' nos muestran las conexiones establecidas y nos informa de un posible problema de conexión.

Sabremos que ''no existe conexión'' cuando la columna Host tiene el valor '''Unspecified''' y en la columna Port aparece un '''0''' , a continuación se muestra un ejemplo:

[[Archivo:Ejemplo_no_conexion.png |center]]



=== Servidor de grabación ===
==== Almacenamiento en la nube ====
Almacenamiento en la nube.
Existe la posibilidad de que tras un determinado periodo de tiempo las grabaciones sean movidas a un almacenamiento externo. De esta operativa se encarga el proceso /usr/local/sbin/mueveGrabaciones.pl que recibe como parámetro la ruta al archivo de configuración. Dicho archivo tiene los siguientes elementos:

*$db: Nombre de la base de datos.
*$dbHost: servidor de MySQL
*$dbPort: Puerto del MySQL.
*$dbUsuario: Usuario de conexión a MySQL.
*$dbClave: Clave del usuario anterior.
*$dirBase: Directorio donde residen las grabaciones
*$diasCaducidad: Dias de antigüedad para mover las grabaciones
*$sftpHost: Servidor SFTP de destino
*$sftpPort: Puerto SFTP.
*$sftpUsuario: Usuario SFTP.
*$sftpClave: Clave del usuario SFTP.
*$simula: Si este campo vale 1, las grabaciones se copian, pero no se borran del directorio original, ni se actualiza su ubicación en la base de datos.

La grabación indica donde se encuentra mediante el campo E_UBICACION_GRABACION, que puede tener los siguientes valores:
*Sin definir (0)
*En línea (10): Las grabaciones se encuentran en el servidor de grabaciones.
*Fuera de línea (20): las grabaciones se encuentran en una ubicación externa.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Reporting ===
La aplicación de reporting en general no tiene procesos habituales de operación y mantenimiento.
Los informes son obtenidos desde la interfaz gráfica o mediante un procedimiento de scripting, descritos en “Formato de fichero de intercambio para '''''VIVA'''''it Reporting”.

==== Formato de fichero de intercambio para '''''VIVA'''''it Reporting ====
{| class="wikitable"
|-
! Nombre !! Descripción !! Ejemplo
|-
| colspan="3"| Selección de registros
|-
| SQL_selec || Expresión SQL que se añadirá al where a la SQL principal. || C_ORIGEN like '6%' and C_COD_CLIENTE= '023'
|-
| SQL_select_leido || Filtro de selección legible
|| Skill igual a 60310
|-
| SQL_orden || Lista de campos por los que se ordenará, después de los que estén ya definidos en la plantilla. || C_ORIGEN, C_COD_CLIENTE
|-
| colspan="3"| Salida
|-
| FIC_extension || Extensión de fichero de salida: PDF, XLSX, CSV || PDF
|-
| FIC_tipo_entrega || 'P': Pantalla, 'D': Directorio, 'C': Correo || D
|-
| FIC_destino || Si 'C', dirección de correo, si 'D', ruta del directorio || D:\informes\
|-
| colspan="3"| Plantilla
|-
| INF_modelo || Ruta del fichero de plantilla || C:\Modelos\llamadas.rep
|-
| INF_descripción || Descripción del informe || Informe detallado de llamadas
|-
| colspan="3"| Base de datos
|-
| BD_ip || IP o nombre de máquina ||
|-
| BD_puerto || Puerto de MySQL ||
|-
| BD_base_datos || Nombre de base de datos ||
|-
| BD_usuario || Usuario de base de datos ||
|-
| BD_clave || Clave de acceso cifrada ||
|-
| colspan="3"| Parámetros
|-
| PAR_desde_vis || Fecha inicial de selección en formato legible (o '-' si no hay) || 01/01/2016
|-
| PAR_hasta_vis || Fecha final de selección en formato legible (o '-' si no hay) || 31/01/2016
|-
| PAR_01 || Parámetro opcional ||
|-
| .. || .. ||
|-
| PAR_20 || Parámetro opcional ||
|}

El fichero tendrá un nombre único para permitir la generación simultánea de informes.
El fichero es borrado por la aplicación de forma automática.
Se pasa a la aplicación de generación de informes como parámetro. Por ejemplo:
“C:\Archivos de Programa\MDtel\Nimitz\LanzaInformes\LanzaInformes.exe”
“C:\Archivos de Programa\MDtel\Nimitz\LanzaInformes\NIM00001.tmp”

Ejemplo de fichero:
{| class="wikitable"
|-
| SQL_selec=(DAT_ACUMULADOS_COLAS.ID_COLA in (11))

SQL_select_leido=Skill igual a 60310

SQL_orden=
FIC_extension=pdf

FIC_tipo_entrega=P

FIC_destino=C:\

INF_modelo=skill_setsi.rep

INF_descripcion=Skill. SETSI

BD_ip=172.25.1.2

BD_puerto=3306

BD_base_datos=nimitz

BD_usuario=nimitz

BD_clave=UIk5jNY9PVX5ogg=

PAR_desde_vis=-

PAR_hasta_vis=-

PAR_01=
|}

==== Resumen de significado de columnas en reporting histórico ====
Esta información se puede consultar en el siguiente enlace:

http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Documentacion_de_usuario_VIVAit_Suite_3.3#Resumen_del_valor_de_las_columnas_que_aparecen_en_los_informes



===== Consideraciones adicionales =====

Los tiempos se insertan en el intervalo en el que se deja ese "estado", esto provoca que en un intervalo pueda ser mayor el tiempo ACD que el tiempo conectado.

''* Ejemplo:''

-Llamada: Duración 15 minutos Hora fin de la llamada 13:01
-Llamada: Duración 20 minutos Hora fin de la llamada 13:24
Suma de las duraciones de las llamadas para el intervalo ''35 minutos'' tiempo
conectado del agente en el intervalo ''30 minutos.''
Cuando los periodos consultados sean mas amplios (diario, mensual) los
desfases tenderán a desaparecer.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

== Otros Diagnósticos y operaciones básicas ==
=== Arranque y apagado de la plataforma ===

En general el arranque y apagado de cada nodo de una plataforma '''''VIVA'''''it es el estándar de un procedimiento ordenado de apagado en una máquina linux: '''"Shutdown -h now"''' o comando de apagado inmediato o programado equivalente

El orden de arranque de la plataforma deberá ser:
# En primer lugar arrancar el nodo con la base de datos de tiempo real
# Una vez finalizado el arranque del punto 1, arrancar el nodo con la base de datos de réplica
# Una vez finalizado el arranque del punto 2, arrancar el resto de nodos en cualquier orden

Al respecto del orden de apagado de nodos, es el siguiente:
# En primer lugar se apagarán, en cualquier orden, los nodos que NO CONTENGAN bases de datos de tiempo real ni bases de datos de réplica
# Una vez apagados totalmente todos los nodos del punto 1, apagaremos el nodo (o nodos) con bases de datos de réplica
# Una vez apagados totalmente todos los nodos del punto 2, se apagará el nodo con la base de datos de tiempo real

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]


=== Grabación ===

==== Configuración de la grabación en la plataforma corporativa ====
Para que una llamada se grabe, lo primero de todo es que alguien tenga la capacidad de grabar. Esto se consigue diciendo al nodo que sea grabador. Esto provoca que el nodo llame al mixmonitor para grabar y se inserte un registro en el DAT_GRABACIONES. Esto no significa que ya las llamadas se vayan a grabar, ya que para eso tiene que ser procesadas por un nodo que sea grabador. Hay tres, llamémosle elementos, que se pueden grabar:

* El nodo, es decir todo lo que el nodo enrute
* Prerutas
* Objetos: que son las extensiones, usuarios, grupos corporativos, etc.

Tenemos tres formas de grabar:

* Grabar con beep periódico
* Grabar sin beep periódico
* Descartar grabación

Si de los tres elementos tenemos que uno grabe, ya sea con o sin beep periódico, esa llamada se va a grabar ya que son OR, en cuanto haya un elemento que diga que grabe se va a grabar.

Al igual pasa si tenemos que un elemento tenga descartar la grabación. La grabación no se inicia.

Referente al campo de Modo de grabación en infraestructura, este no se emplea para la grabación de corporativo, sino que solo tiene validez en ACD. Para grabación en el ACD hay que, como se ha dicho anteriormente poner un nodo que sea grabador y especificar un elemento de los tres que hay cual es el que se va a grabar.

Para que exista una grabación ha de existir un segmento asociado a esta. Los segmentos se tratan en las prerutas. Hay un campo es las prerutas que es Generar segmento al enrutar. Si está se generará el segmento del tipo de la preruta y su correspondiente grabación si esta está configurada. Si le decimos que no genere segmentos al enrutar y el sistema está configurado para que grabe, el recordCentral creará un tipo de segmento llamado externo para esa grabación. Podemos configurar si queremos que se cree o no ese segmento, para eso hay que modificar el fichero de configuración del recordCentral y poner un tiempo muy alto al campo $segmExternoMinSegs. También podemos configurar que segmentos queremos que se graben. Por defecto el recordCentral va configurado para que se graben todos los segmentos. Para decirle que solo grabe cierto tipo de segmentos hay que ponerlos los que queramos que si se graben en la variable $tiposSegmentoGrabar del fichero de configuración del recordCentral.

==== Comprobación de que el servidor de grabación esta activo ====

Si al ejecutar el comando '''''nc ip_maquina 1114''''',si no se recibe ninguna respuesta, significa el servidor de grabación no estaría activo.
También usando el comando ''''' ps aux | grep recordCentral ''''', donde si no escribe ningún resultado implica que tampoco esta activo.

==== Comprobación de que los nodos están conectados al servidor de grabación ====

Debemos fijarnos en la linea de respuesta del comando '''''nc ip_maquina 1114''''', que seria:
{| class="wikitable"
|-
| root@smadavacdrecord1:~# nc localhost 1114
recordCentral SIS ver='01.2' inic='20140423 094058' alarmas=11041 ultAlar='20140423
160112'

recordCentral MYSQL cnx=1

recordCentral NAS llamadas=1 segmentos=1

recordCenral REC llamNum=24901 llamErr=0 segmNum=38906 segmErr=0 retraso=305

'''recordCentral NODO fase=0 cuarentena='' descarga='8,6,4,7,10,9' gestion='4,6,7,8,9,10''''
|}

Sabiendo que el parámetro "fase=0" es el numero que identifica el recordCentral, los demás parámetros nos indicaran los nodos disponibles , que funcionan o no en el servidor. Entonces "gestión=4,6,7,8,9,10" indica el id de los nodos que maneja el proceso.

==== Comprobación de que un nodo tiene activo el agente de grabación ====
Si al ejecutar el comando '''''nc ip_maquina 1113''''', no se recibe ninguna respuesta, significa que el nodo no tiene activo el agente de grabación.
También usando el comando ''''' ps aux | grep recordNodo''''', donde si no escribe ningun resultado implica que tampoco esta activo.

==== Comprobación de que un nodo está subiendo archivos de grabación al servidor ====
Debemos fijarnos en la linea de respuesta del comando '''''nc ip_maquina 1114''''', que seria:

{| class="wikitable"
|-
| root@smadavacdrecord1:~# nc localhost 1114
recordCentral SIS ver='01.2' inic='20140423 094058' alarmas=11041 ultAlar='20140423
160112'

recordCentral MYSQL cnx=1

recordCentral NAS llamadas=1 segmentos=1

recordCenral REC llamNum=24901 llamErr=0 segmNum=38906 segmErr=0 retraso=305

'''recordCentral NODO fase=0 cuarentena='' descarga='8,6,4,7,10,9' gestion='4,6,7,8,9,10''''
|}

Fijándonos en "descarga=8,6,4,7,10,9" nos confirma que todos los nodos que maneja el proceso funcionan perfectamente y el servidor puede manejar las grabaciones.

==== Comprobación de grabaciones que se hayan quedado enganchadas en un nodo ====
Podemos fijarnos en los dos comandos, para '''''nc ip_maquina 1114''''':
{| class="wikitable"
|-
| root@smadavacdrecord1:~# nc localhost 1114
recordCentral SIS ver='01.2' inic='20140423 094058' alarmas=11041 ultAlar='20140423
160112'

recordCentral MYSQL cnx=1

recordCentral NAS llamadas=1 segmentos=1

recordCenral REC llamNum=24901 llamErr=0 segmNum=38906 segmErr=0 retraso=305

'''recordCentral NODO fase=0 cuarentena='' descarga='8,6,4,7,10,9' gestion='4,6,7,8,9,10''''
|}

Fijándonos en el campo "cuarentena=''" indica que ninguno de los nodos tiene problemas.

==== Comprobación del estado de ocupación del almacenamiento temporal de grabaciones en un nodo. ====

Desde un SSH ejecuta el comando '''''df - h''''' en la maquina donde creamos que debe estar ejecutando el proceso recordNod:

{|class="wikitable"
|-
! Filesystem !! Size !! Used !! Avail !! Use% !! Mounted on
|-
| udev || 486M || 4,0K || 486M || 1,00% || /dev
|-
| tmpfs || 100M || 416K || 99M || 1,00% || /run
|-
| '''/dev/vda1''' ||''' 236M''' ||''' 68M''' ||''' 156M''' ||''' 31,00% '''||''' /boot'''
|-
| tmpfs || 100M || 48K || 100M || 1,00% || /var/spool/asterisk/monitor

|}

Nos fijaríamos en la línea marcada en negrita, el campo "Use%" indicara el porcentaje de almacenamiento temporal de grabaciones en un nodo.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

===Escuchas e intrusiones en asterisk===
'''CallSpy''' es una aplicación elaborada para asterisk que permite a un usuario realizar escuchas e
intrusiones en llamadas.
En realidad tenemos dos aplicaciones en asterisk, CallSpy y CallSpyee.
====CallSpy ====
{|
|-
|
'''Nota:''' Como mucho se pueden tener a dieciséis personas al mismo tiempo usando esta aplicación.
|}

Como hemos mencionado anteriormente, esta aplicación permite la escucha de llamadas y,
opcionalmente, realiza la función de intrusión. Tiene tres opciones de configuración obligatorios
que mostramos a continuación:

{|
|-
|
CallSpy(<tipoEspiado>,<expRegEspiado>,<parametrosConf>)

|}
La opción '''<tipoEspiado>''' se refiere a que tipo de objeto que podemos espiar correspondiente, solo debe elegirse un único tipo:
*'''c:''' escuchar una cola
*'''v:''' escuchar un vdn
*'''a:''' escuchar a un agente
*'''e:''' escuchar extensión
La opción '''<expRegEspiado>''' representa el número de la cola, VDN, agente o extensión que queremos escuchar. Tiene que ser una expresión regular.
La opción '''<parametrosConf>''' se refiera a los parámetros de configuración para la llamada que podemos espiar, se pueden combinar o juntar :
*'''q:''' Desactiva el 'beep' al comienzo de cada nueva llamada.
*'''v([value]):''' Ajusta el volumen en el rango -4 a 4 (más alto, mas volumen).
*'''e:''' Habilita el que se pueda cambiar a otra llamada de la misma extensión.
*'''w:''' Habilita el que se pueda activar la intrusión (whisper).
Una vez iniciada la escucha, solo falta que entre una llamada al objetivo que estemos espiando. Al
iniciar la escucha, se puede hacer lo siguiente:
*Pulsando '''#''' modifica el volumen de escucha.
*Pulsando '''*''' cambia a una nueva llamada.
*Pulsando '''1''' si esta habilitado, cambia a otra llamada de la misma extensión.
*Pulsando '''2''' si esta habilitado, inicia la función de intrusión.
*Pulsando '''3''' desactiva la función de intrusión.
====CallSpyee (espiado)====
Mediante esta aplicación indicamos los parámetros que permite a una llamada ser seleccionada para
escuchar. Las opciones de configuración son:
{|
|-
|
CallSpyee([CID_NUM],[cola],[vdn],[agen],[exten])
'''Nota:'''No son parámetros obligatorios, por lo que no hace falta rellenar todos los campos pero si respetar sus posiciones separadas por comas.
|}
La explicación de los parámetros es la siguiente:
*'''CID_NUM:''' representa el call ID de la llamadas
*'''cola:'''representa el número de la cola que se quiere espiar (${QUEUE} ).
*'''vdn:''' representa el número del VDN que se quiere espiar (${VDN} ).
*'''agen:''' representa el número del agente que se quiere espiar.
*'''exten:''' representa el número de la extensión que se quiere espiar (${EXTENSION}) .

Por ejemplo si queremos escuchar todas las llamadas en las que participa una extensión determinada pondremos en la macro de extensiones:
{|
|-
|
exten => s,n,CallSpyee(,,,${EXTENSION})
|}

====Cambios para el dialplan de asterisk====
El funcionamiento de este tipo de servicio conlleva un cambio en el dialplan de asterisk. En cada macro correspondiente se pondrá los diferentes CallSpyee para VDN, colas , extensiones y agentes.
Pasos a seguir:
*Paso 1. Creación de un código de intrusión para cada tipo según necesidad (cola, VDN, agente y
extensión).
{|
|-
|
Ejemplo '''MD'''tel: declaramos como código de intrusión a Agente *44*NUMERO
;==========================================
;======== Intrusion a Agente
;==========================================
exten => _*44*X.,1,set(CadMarcar=intrusionEspiado)
exten => _*44*X.,n,set(DesL=SERVICIO)
exten => _*44*X.,n,set(datoServicio=^${EXTEN:4})
exten => _*44*X.,n,Goto(finMacro,1)
'''Nota:''' En la tercera línea podemos observar la expresión regular que se le pasara al CallSpy correspondiente con el número marcado por el espia. 
|}

*Paso 2.Llamar a CallSpy con la configuración deseada.
{|
|-
|
Ejemplo '''MD'''tel: llamada a CallSpy especificando que vamos a espiar una cola (la c del primer parámetro, con la
extensión introducida en el código de intrusión y con whisper, es decir, función de intrusión habilitada.
;------------------------------------------------------------------------
; Intrusion a Espiado
;------------------------------------------------------------------------
exten => intrusionEspiado,1,NoOp
exten => intrusionEspiado,n,GotoIf($["${datoServicio}"=""]?colgar)
exten => intrusionEspiado,n,CallSpy(c,${datoServicio},w)
exten => intrusionEspiado,n(colgar),Hangup
|}
* Paso 3. Llamar a CallSpyee con la configuración de las llamadas candidatas a ser escuchadas.
{|
|-
|
Ejemplo '''MD'''tel:
exten => s,n,CallSpyee(,,,,${EXTENSION}) → Para extensiones
exten => s,n,CallSpyee(,${QUEUE},,,) → Llamadas espiadas por cola
exten => s,n,CallSpyee(,,${VDN},,) → Llamadas espiadas por VDN
|}

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Calendarios ===

Para la configuración de los Calendarios se hace uso de '''CalDAV''', estándar de Internet que permite a un cliente acceder a información de planificación en un servidor remoto. Permite que varios clientes accedan a la misma información, facilitando la cooperación. Muchas aplicaciones, tanto clientes como servidores, son compatibles con este protocolo.

Si deseamos crear un calendario en la plataforma '''VIVAit''' podemos hacerlo siguiendo el siguiente enlace:
Para comprobar que el servidor de calendarios funciona correctamente bastaría con cargar en la barra de direcciones la siguiente url: [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Calendarios |Calendarios]]

http://${NODO.HOST}/dav/html/cal.php/calendars/${DAV.CUENTA}/${DAV.CALENDARIO}

donde,

* '''NODO.HOST:''' es la ip del servidor calendar
* '''DAV.CUENTA:''' hace referencia a la cuenta de usuario
* '''DAV.CALENDARIO:''' hace referencia el nombre de la cuenta

Una vez que se carga la url sabremos que el servidor funciona correctamente si visualizamos lo siguiente:

[[Archivo:Captura de pantalla de 2016-07-21 12_43_58.png || 1020px|center]]

Si el sistema nos pide usuario y clave querrá decir que el servidor de calendarios está operativo en esa maquina

Para comprobar que funciona en la consola de asterisk usaremos los comandos
calendar show calendars
calendar show calendar [nombreCalendario]

'''Nota:''' Debido bugs detectados, el proceso requerirá:
- La realización de una sincronización manual de la sección "mdcal" desde el portal de administración
- Añadir la línea '''''#include "/etc/asterisk/mdcal.conf"''''' en el fichero calendars.conf y hacer "reload" de asterisk
- En la máquina donde esté instalado el servidor de calendarios apuntar a la IP de la BDTR (/var/www/dav/config.php)

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Syslog de agentes ===
'''''Syslog''''' es un estándar para el envío de mensajes de registro en una red informática IP. Por '''''Syslog''''' se conoce tanto al protocolo de red como a la aplicación o biblioteca que envía los mensajes de registro. Se lanza automáticamente al arrancar un sistema Unix, y es el encargado de guardar informes sobre el funcionamiento de la máquina (eventos, seguridad del sistema, etc) pero puede contener también cualquier información como mensajes de las diferentes partes del sistema (núcleo, programas...) y los envía y/o almacena en diferentes localizaciones transmitiéndose mediante un puerto UDP. Esto permite concentrar los registros de múltiples máquinas en un único punto simplificando la labor de gestión al administrador siendo habitual que múltiples dispositivos lo soporten.

El formato del mensaje se compone de tres campos :

* La cabecera contiene la prioridad, fecha y hora del mensaje, máquina, proceso (nombre e identificador) que lo ha generado y la versión del protocolo utilizado.
* Una serie de pares clave-valor con metadatos.
* El texto del mensaje.

Si es necesario podemos activar el registro de todos los eventos telefónicos que realiza un agente ACD llamado '''Syslog de agentes'''. Su activación se realiza mediante el '''portal de administración ''VIVA''it''' configurando unos parámetros para un usuario llamado ''Rastreo BBDD" y ''Rastreo Syslog''. Para más información[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Pesta.C3.B1a_ACD | ver sección Portal de administración - General - Usuarios - Pestaña ACD ]].

{| class="wikitable" border="0" align="top"
|-
| align="center" style="background:Lavender; color:Black" |<big>'''Elemento'''</big>
|align="center" style="background:Lavender; color:Black" | <big>'''Procedimiento'''</big>
|-
!colspan="2" width="60 px" style="background:Lavender; color:Black"|Operacion
|-
|Ubicación del proceso||Script arranque: /etc/init/ rsyslog.conf
Configuración :
/etc/rsyslog.d/30-vivait-
desk.conf
|-
|Arranque||service rsyslog start
|-
|Parada||service rsyslog stop
|-
|Reinicio||service rsyslog reload
|-
!colspan="2" width="60 px" style="background:Lavender; color:Black"|Diagnostico
|-
|Registro de logs||/var/log/MDtel/vivait-desk.log
Fichero del día actual. se guardan los 30
anteriores comprimidos en tar.g
|}

=== Generación de un Core ===
Un Core es la memoria de un programa.

Para generar un Core rápido con Asterisk hay que hacer lo siguiente:

Ejecutar ps aux | grep asterisk y coger el PID del programa
gdb /usr/sbin/asterisk [PID]
gcore [file]

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==Funcionalidades específicas ==
=== Mecanismo de prioridad adaptativa ===

El mecanismo de prioridad adaptativa permite en una plataforma '''''VIVA'''''it Suite establecer prioridades en las que se tenga en cuenta el tiempo de espera de las llamadas en cola, proporcionando una alternativa al mecanismo de prioridad absoluta que existe por defecto

==== Introducción ====

Este documento presenta una propuesta de mecanismo de asignación de llamadas en colas a agentes basado no solo en las prioridades de agente a cola,
sino en un factor de corrección de prioridad derivado del tiempo de espera de una llamada

==== Terminología ====

* '''Prioridad de llamada:''' A cada llamada susceptible de ser atendida en el ''Call Center'' se le asignará una prioridad de llamada; dicha prioridad será asignada cada vez que un agente quede disponible.
* '''Prioridad de grupo ACD:''' Los agentes del ''Call Center'' tendrán configurada una prioridad para cada grupo ACD al que pertenecen
* '''Tiempo de espera:''' Tiempo que una llamada lleva en espera en un determinado grupo ACD; si la llamada cambia de un grupo ACD a otro el tiempo de espera pasa a cero
* '''Objetivo de servicio:''' Tiempo objetivo máximo de espera por cada grupo ACD

'''Nota.-''' ''En terminología Asterisk el aumento de prioridad corresponde con números descendentes, es decir, 
prioridad 50 es mejor que prioridad 70''

==== Mecanismo de asignación de llamadas ====

En el momento en que exista un agente disponible para recibir llamada, el agente recepcionará la llamada con mejor prioridad de llamada (menor número). La prioridad de llamada para cada llamada se establecerá de la siguiente manera:

- Agentes con prioridad de grupo ACD de 1 a 99 utilizarán el mecanismo convencional de asterisk de prioridad absoluta; será útil para grupos ACD críticos o en Call Centers muy convencionales

'''Si un agente tiene prioridad menor de 100 en grupos ACD y hay llamadas en dichos grupos, estas llamadas serán atendidas por el agente con prioridad absoluta.'''

- Agentes con prioridad de colas de 100 en adelante; se utilizará el siguiente mecanismo de prioridad ponderada:

:*Si el grupo ACD de la llamada está dentro del objetivo de servicio, la prioridad de llamada será la prioridad de grupo ACD (a efectos prácticos se aplicará el mecanismo convencional de asignación de llamada a agente, equitativo entre grupos ACD con misma prioridad)

:*Si el grupo ACD de la llamada está fuera del objetivo de servicio, se aplicará una ponderación que mejorará la prioridad de la llamada a medida que aumente el tiempo de espera:

[[Archivo:Formula.png |center]]

En una configuración de igualdad de prioridad de agente y objetivo de servicio, el tiempo de espera influiría de manera determinante (más o menos en
función del peso) en la asignación de la siguiente llamada
El peso podrá adquirir tres posibles valores: 0, 1 y 10

[[Archivo:Esquema.png |center]]

- Calculo prioridad de llamada: se calcula por llamada cada vez que un agente queda libre
- Agente atiende llamada con mejor prioridad de llamada



[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Marcación saliente ===
Dentro del ACD hay un comportamiento especial que es la marcación saliente. Esta puede ser de tres tipos:
* '''Vista previa''': El agente demanda la siguiente llamada a realizar.
* '''Progresivo''': Se llama al agente y se lanza la llamada al contacto.
* '''Predictivo''': El sistema calcula cuando va a estar libre el agente y se adelanta lanzando varias llamadas (configurables por parámetros). La llamada que es contestada primero, se pasa a una cola (el resto se cuelgan) a la espera que el agente se quede libre.

====Esquema de funcionamiento====
[[Archivo:esquema funcionamiento marcador.jpg|center|500px]]

Los contactos se agrupan en listas para su facilidad de asignación a campañas, aunque finalmente lo que se asigna a una campaña es un contacto.

Las campañas tienen estrategias. Las estrategias definen como se ha de llamar (del primero al último, sólo los pares, etc.). Tienen una serie de parámetros que dependiendo de la estrategia pueden tener distinta utilidad. Desde el punto de vista de la base de datos, las estrategias se definirían en la tabla ACD_CLASES_ESTRATEGIAS y se les da valor en la tabla ACD_ESTRATEGIAS_MARCADOR.
Una vez establecida la campaña y asignados sus contactos y dependiendo del modo de marcación (que se define en las colas) el proceso motorSal crea los intentos de marcación (siempre y cuando no estén en las listas Robinson), que serán leídos por el proceso myAcdSuperv que los convierte en llamadas para el Asterisk.

====Flujo de estados====

El flujo de estados es el reflejado en la figura siguiente:

[[Archivo:diagrama de flujo motorsal.png|center|800px]]

Los diferentes estados de un contacto son:
{| class="wikitable sortable"
|-
! Estado !! ID_Estado!! Descripción
|-
| Planificable || 0|| El contacto está preparado para que lo gestione motorSal y según la estrategia definida se establece el campo ACD_CONTACTOS_CAMPANNAS.D_HORA_PROXIMA
|-
|Planificado||10||Cuando ha llegado el tiempo marcado en HORA PROXIMA, motorSal ejecuta la 2ª fase de la estrategia, generando el intento de marcación.
|-
|Intento||20||El control pasa a myAcdSuperv, que a su vez genera la llamada en Asterisk. Cuando termina, se pasa a Planificable o Finalizado.
|-
|Finalizado||100||Las gestiones con este contacto han terminado.
|-
|Abortado||110||
|-
|Obsoleto||200||Se ha agotado el tiempo para contactar sin agotar todos los intentos. No se le vuelve a llamar nunca.
|-
|}

====Carga de contactos====

===== Descripción =====

A continuación se explica la configuración y funcionamiento de la utilidad encargada de asignar contactos a campañas.

===== Configuración =====

El archivo de configuración recibe el nombre de '''cargaContactos.pconf.''' Este archivo reside en '''/etc/MDtel.''' El formato se describe en la tabla siguiente. Hay que tener en cuenta que las columnas empiezan a numerarse en 0.

{| class="wikitable" style="text-align:center;"
|-
! Parámetro !! Valor !! Obligatorio !! Defecto
|-
| db|| Nombre de la base de datos|| SI || nimitz
|-
| dbHost|| Host MySQL || SI || localhost
|-
| dbPort|| Puerto MySQL || NO || 3306
|-
| dbUsuario || Usuario de acceso a la base de datos|| SI ||
|-
| dbClave || Clave del usuario || SI ||
|-
| rutaContactos || Ruta hasta el archivo de contactos || NO || /var/spool/MDtel/contactos
|-
| obsoletos || Si vale 1, marcar como obsoletos los contactos anteriores || NO || 0
|-
| diasCaducidad || Número de dias a partir de los cuales caducarán los contactos || SI ||
|-
| idCampanna || Número de columna que contiene el ID de la campaña || SI||
|-
| idLista || Numero de columna que contiene el ID de la lista || SI ||
|-
| prioridad || Número de columna que contiene la prioridad || NO || Nota: El valor es de 0 a 99. A mayor número mayor prioridad (se le llamará '''ANTES''')
|-
| tipoTarea|| Número de columna que contiene el tipo de tarea || NO || Nota: los posibles valores de la columna son : *A: Alta *M: Modificación *B: Baja Por defecto el valor es A
|-
| codCli || Número de columna del CSV que contiene el código de cliente || SI ||
|-
| nombreCon || Número de columna del CSV que contiene el nombre || NO ||
|-
| apellido1 || Número de columna del CSV que contiene el primer apellido|| NO ||
|-
| apellido2 || Número de columna del CSV que contiene el segundo apellido || NO ||
|-
| empresa || Número de columna del CSV que contiene la empresa || NO ||
|-
| direccion1 || Número de columna del CSV que contiene la dirección || NO ||
|-
| direccion2 || Número de columna del CSV que contiene la dirección 2 || NO ||
|-
| codPostal || Número de columna del CSV que contiene el código postal || NO ||
|-
| localidad || Número de columna del CSV que contiene la localidad || NO ||
|-
| provin || Número de columna del CSV que contiene la provincia || NO ||
|-
| email || Número de columna del CSV que contiene el email || NO ||
|-
| valFijo_1 || Número de columna del CSV que contiene el primer número fijo del contacto || SI ||
|-
| valFijo_2 || Número de columna del CSV que contiene el segundo número fijo del contacto || NO ||
|-
| valFijo_3 || Número de columna del CSV que contiene el tercer número fijo del contacto || NO ||
|-
| valFijo_4 || Número de columna del CSV que contiene el cuarto número fijo del contacto || NO ||
|-
| valMovil_1 || Número de columna del CSV que contiene el primer número móvil del contacto || SI ||
|-
| valMovil_2 || Número de columna del CSV que contiene el segundo número móvil del contacto || NO ||
|-
| valMovil_3 || Número de columna del CSV que contiene el tercer número móvil del contacto || NO ||
|-
| valMovil_4 || Número de columna del CSV que contiene el CUARTO número móvil del contacto || NO ||
|-
| edad || Número de columna del CSV que contiene la edad || NO ||
|-
| nOpc1|| Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc2 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc3 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc4 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc5 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc6 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc7 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc8 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| cOpc1 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc2 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc3 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc4 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc5 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc6 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc7 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc8 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| Idioma || Idioma del contacto || NO ||
|-
|}

===== Funcionamiento =====

Para ejecutar la utilidad se debe teclear la siguiente orden en la línea de comandos:

'''cmd# cargaContactos.pl /<ruta hasta el conf>/cargaContactos.pconf <archivo CSV>'''

El archivo con los contactos deberá ser un CSV con los campos separados por ';'. La utilidad parsea el archivo conforme a la distribución indicada en la configuración y crea las correspondientes entradas en las tablas '''ACD_CONTACTOS''' y '''ACD_CONTACTOS_CAMPANNAS.'''

La utilidad crea un log en '''/var/log/cargaContactos.log''' en el que vuelca toda la operativa.
Por pantalla se va mostrando un lista con el ID asignado al contacto y el ID de campaña al que se le ha asignado.

Un ejemplo de fichero de carga de contactos sería el siguiente:

#
# Configuracion de recordGwd.pl
#
# Conexion de base de datos
$db='nimitz';
$dbHost = 'localhost';
$dbPort = '3306';
$dbUsuario = 'nimitz';
$dbClave = 'LA QUE SEA';
$diasCaducidad='300';
$rutaGrab = '/var/spool/MDtel/contactos';
$idCampanna = '31';
$idLista = '32';
$obsoletos = 0;
$codCli = '1';
$nombreCon = '2';
$apellido1 = '3';
$apellido2 = '4';
$empresa = '5';
$direccion1 = '6';
$direccion2 = '7';
$codPostal = '8';
$localidad = '9';
$provin = '10';
$email = '11';
$valFijo_1 = '12';
$valFijo_2 = '13';
$valFijo_3 = '14';
$valFijo_4 = '15';
$valMovil_1 = '16';
$valMovil_2 = '17';
$valMovil_3 = '18';
$valMovil_4 = '19';
$edad = '20';
$nOpc1 = '21';
$nOpc2 = '22';
$nOpc3 = '23';
$nOpc4 = '24';
$cOpc1 = '25';
$cOpc2 = '26';
$cOpc3 = '27';
$cOpc4 = '28';
$prioridad = '29';
$tipoTarea = '30';

====Comportamiento de reprogramaciones de llamadas en función del estado del agente====

Se ha preparado la siguiente maqueta:

Campaña saliente.
Cola saliente progresiva.
Dos agentes logados en VIVAit Suite.

En el formulario de la llamada se indica: llamada redirigida
Se selecciona el "check dirigida"

Las posibilidades de prueba son dos: "'''Cualquier agente'''" y "'''Solo agente'''"

Resultados son los siguientes:

{| class="wikitable sortable"
|-
| '''Estado del agente''' || '''Modo Cualquier Agente'''|| '''Modo Solo Agente'''
|-
| '''Agente Preparado''' || Entra llamada a agente|| Entra llamada a agente
|-
|'''Agente en Pausa'''||Entra llamada a otro agente disponible||Espera a agente y entra llamada.
|-
|'''Agente Hablando'''||Espera a agente y entra llamada||Espera a agente y entra llamada.
|-
|'''Agente en Tiempo administrativo'''||Espera a agente y entra llamada||Espera a agente y entra llamada.
|-
|'''Agente no logado'''||Entra llamada a otro agenete disponible||Consume intento.
|-
|'''Agente con una pestaña de chat abierta y el otro agente en pausa'''||Entra llamada a otro agente disponible||Espera a agente y entra llamada.
|-
|'''Agente con dos pestañas de chat abiertas'''||Espera a agente y entra llamada||Espera a agente y entra llamada.
|-
|}

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Movilidad ===
La movilidad es una función integral de las comunicaciones en la empresa. Cualquier empleado (usuario) es móvil en cierto grado, ya sea dentro o fuera de la organización. La solución óptima debe proporcionar continuidad de servicios y acceso a nuestros servicios, sin importar donde estemos.

==== Ofrecer movilidad a un usuario ====

Para permitir la movilidad a un usuario, puede ser en el momento de crear o editar un usuario en el apartado ''Administración de usuario'' en ''General'' del '''portal de administración ''VIVA''it'''. Asignándole un '''''numero login''''' (numero personal corporativo para el usuario) y una '''''clave login''''' ( se debe asignar una clave por defecto, pero puede cambiarla en el [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_3.0#Portal_de_usuario |portal de usuario]]). Para más información[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Pesta.C3.B1a_Centralita | ver sección Portal de administración - General - Usuarios - administración de usuarios - Pestaña Centralita]].

Además, de crear un permiso de la '''aplicación ''Centralita''''' a cualquier nivel, desde el apartado ''Permisos de usuarios'' en ''General'' del '''portal de administración ''VIVA''it'''. Para más información[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Asignaci.C3.B3n_de_Permisos_de_Usuario_por_Administrador | ver sección Portal de administración - General - Usuarios - Permisos a usuarios]]

'''La movilidad permite''' disponer de las extensiones telefónicas empresariales en cualquier lugar. Por
ejemplo, con un ordenador portátil o smartphone en una ubicación remota con conexión a Internet,
podríamos tener registrada nuestra extensión remotamente, y así las llamadas hacia/desde nuestra
oficina serían enrutadas por Internet hasta el equipo en cuestión sin coste alguno.


Todo terminal tiene asociado una extensión y deberá permitir la movilidad de usuarios. La extensión se configura cambiando a '''''SI''''' el campo '''''Hay Movilidad''''' desde el apartado ''Extensiones'' de ''Dispositivos'' en ''VIVAit Call'' del '''portal de administración ''VIVA''it'''. Para más información [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Extensiones | ver sección Portal de administración - VIVAit Call - Dispositivos - Extensiones]]

==== ¿Cómo funcionan las extensiones? ====

Primeramente el usuario debe tener los ejes apropiados en la tabla '''COM_USUARIOS_APLICACION''' (aplicación centralita).

La extensión debe de tener ''un teléfono'' y por tanto ''un modelo de teléfono asociado.''

Es tan simple como especificar '''la extensión, el usuario y la clave de este.'''

Para corroborar el funcionamiento de esta hay ''dos métodos'':

'''* CLI asterisk:'''

'''mdintz qry * nimitz bd extenEntraUsuarioMovil 25001 20001 1234'''

Y como resultado obtenemos lo siguiente:

mdintz Variables: 
MdintzIdentif='cms1' 
MOVIL_TIPO_RESET='10' 
MOVIL_CAD_RESET='notify_yealink' 
MdintzRes='OK'

El usuario con el login numérico 20001 se ha "movido" a la extensión 25001

Ahora ''nos quitamos de esa extensión mediante el siguiente comando:''

'''mdintz qry * nimitz bd extenSaleUsuarioMovil 25001'''

Resultado del comando:

mdintz Variables: 
MdintzIdentif='cms1' 
MOVIL_TIPO_RESET='10' 
MOVIL_CAD_RESET='notify_yealink' 
MdintzRes='OK'

Las pruebas anteriores han sido '''con extensiones con movilidad y con usuario con/sin
propietario.'''

Ahora las realizamos '''con extensiones sin movilidad'''

'''mdintz qry * nimitz bd extenEntraUsuarioMovil 25002 20001 1234'''

Obteniendo:

mdintz Variables: 
MdintzIdentif='cms1' 
MdintzRes='movil_error_datos'

Como era lo previsible no nos deja "movernos" a esa extensión ya que no tiene movilidad.


'''Si un usuario ya se ha movido a una extensión y se mueve a otra, el sistema lo deslogará de la primera para logarlo en la segunda.'''

'''mdintz qry * nimitz bd extenEntraUsuarioMovil 21000 20001 1234'''

Con salida:

mdintz Variables: 
MdintzIdentif='cms1' 
MOVIL_EXTEN='25001' 
MDintzRes='movil_ya_login'

'''* Dialplan'''

Para llamar a la función de movilidad hay que marcar el '''9992.'''

Nota.- Para comprobar que se realiza todo correctamente habría que mirar las trazas de Asterisk

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Grabación ===

La grabación en '''''VIVA'''''it Call está diseñada para ser lo mas flexible posible.

====Configuración====

Si deseamos grabar, debemos activar que alguno de los dispositivos/elementos que intervienen en la llamada se grabe.

Estos dispositivos/elementos son:

* Nodo.
* Usuario con Centralita.
* Agente.
* Grupo ACD corporativo y de Contact Center.
* Enlace exterior.
* Extensión.
* Facilidades.
* Grupo: grupo de salto o grupo de operadoras.
* Sala de conferencia.
* VDN corporativo y de Contact Center.
* Pre-rutas.

Por otro lado necesitaremos que la llamada pase por un nodo que sea grabador, es decir, que si la llamada esta configurada para que se grabe pero no pasa por ningún nodo grabador, la llamada no se grabará.

Al configurar un nodo existen cuatro campos que intervienen en la grabación.

''''Grabador''''

Se configura en el portal en la sección general/nodos.

Este campo corresponde con el campo [[BD.COM_NODOS#B_ES_GRABADOR|B_ES_GRABADOR]] de la tabla [[BD.COM_NODOS|COM_NODOS]] , este campo define si el nodo va a grabar las llamas que pasen por el que necesiten ser grabadas y no se estén grabando ya.

Es un campo booleano los posibles valores en el portal son si/no y en la base de datos 1/0.

''''Modo grabación infraestructura''''

Su configuración se realiza en el portal, en la sección general/nodos.

Este campo define como está configurada la infraestructura, este campo existe por compatibilidad con '''''VIVA'''''it suite y para poder configurar la grabación bajo demanda.

Este campo corresponde con el campo [[BD.COM_NODOS#E_MODO_GRABACION_INFRAESTRUCTURA|E_MODO_GRABACION_INFRAESTRUCTURA]] de la tabla [[BD.COM_NODOS|COM_NODOS]], Este campo usa los valores del enumerado BD.ENUM.TModoGrabacionInfraestructura|TModoGrabacionInfraestructura]].

La formula que se seguiría para ver si una llamada se graba en ese nodo es:
{|
|
|-
|
(NODO.E_MODO_GRABACION_INFRAESTRUCTURA) AND (NODO.B_ENRU_GRABAR OR CEN_PRE_RUTA.B_ENRU_GRABAR OR "OBJETO".B_ENRU_GRABAR)
|}

Que sería que si la infraestructura esta en NoGraba no se graba nada de lo que se rute en ese nodo y en cualquiera de los 2 otros caso (GrabaTodo o GrabaPorPeticion) se grabaría dependiendo de la configuración del Nodo, la ruta o el objeto en cuestión (preruta, grupo ACD, extension,...).

''''Grabar enrutamiento''''

Se configura en el portal en la sección general/nodos.

Este campo define si van a grabar las llamadas que se enruten en este nodo.

Campo [[BD.COM_NODOS#E_ENRU_GRABAR|E_ENRU_GRABAR]] de la tabla [[BD.COM_NODOS|COM_NODOS]] que usa los valores del enumerado [[BD.ENUM.TTipoEnruGrabar|TTipoEnruGrabar]].

''''RecordCentral''''

Se configura en el portal en la sección general/nodos.

Define que instancia del recordCentral es la encargada de tratar las grabaciones de este nodo.

Para aumentar el rendimiento a la hora de traerse las grabaciones, se pueden definir varias instancias de proceso recordCentral, este campo define cual de estas instancias se encargara de este nodo.

====Vivait Tracker====

Desde '''''VIVA'''''it Supervisor, que es la aplicación dirigida a Supervisores, ofrece la posibilidad de supervisar y gestionar grupos ACD, agentes, asignaciones, prioridades,etc. Se puede obtener acceso directo a las aplicaciones de grabación ('''''VIVA'''''it tracker)


Esquematico actual del proyecto tracker
[[Archivo:Esquematico_tracker_1.jpg|center]]

1º El tracker web llama al web service Remote login para iniciar sesión y determinar si tiene permisos para la escucha y descarga de grabaciones.

2º Si la ubicación de la grabación es local, mira la ruta de esta y se procede a la escucha o descarga de esta.

3º Si la ubicación de la grabación es remota, entra en escena el proxy. Es el que realiza la petición.

4º Si utilizamos el tracker windows, este, como el tracker web, llama primero al web service remote login para la autenticación y tema de Permisos.

5º Para descargar o escuchar una grabación desde el tracker windows, se llama al web service servidor de grabaciones pasándole simplemente el ID de segmento.mp3. Este web service, con el ID de segmento, se encarga de determinar la ubicación de la grabación.

Esquematico actual del proyecto tracker
[[Archivo:Esquematico_tracker_2_https.jpg|center]]

1º El tracker web llama al web service Remote login para iniciar sesión (comunicación https) y determinar si tiene permisos para la escucha y descarga de grabaciones. Se elimina el proxy

2º Si la ubicación de la grabación es local, mira la ruta de esta y se procede a la escucha o descarga de esta.

3º Si la ubicación de la grabación es remota, se realiza una petición al host remoto. El tipo de petición vendrá fijada por base de datos (http, https, ftp,ftps)

4º Si utilizamos el tracker windows, este, como el tracker web, llama primero al web service remote login para la autenticación y tema de permisos (comunicación https extremo a extremo).

5º Para descargar o escuchar una grabación desde el tracker windows, se llama al web service servidor de grabaciones pasándole simplemente el ID de segmento.mp3. Este web service, con el ID de segmento, se encarga de determinar la ubicación de la grabación.

[[#Grabación_(Vivait_Tracker)| Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operación_plataforma_VIVAit Volver al indice]]

=== Enrutamiento ===

[[Archivo:Enrutamiento.png|885px |center]]

==== Enfoque inicial ====

[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Enfoque_inicial Acceso]

==== Funcionamiento ====
El proceso de enrutamiento, como vimos en el esquemático, se compone de dos fases:

# Preenrutameinto, que se encarga de tratar todas las llamadas
# Enrutamiento externo, que tiene módulos dedicados al enrutamiento hacia:
:*Enlaces externos.
:*Extensiones.
:*Usuarios de telefonía corporativa.
:*Facilidades.
:*Salas de conferencia.
:*Agentes de grupos ACD.
:*Grupos ACD.
:*Vdn.
:*Buzones para dejar mensaje.
:*Buzones para su gestión.

Se asume que existen rutas directas entre todos los nodos de la red.

Se asume que están directamente enrutadas todas las direcciones IP involucradas, tanto nodos, como terminales.

Se asume que todas las facilidades están disponibles en todos los nodos, aunque es posible que la implementación sea diferente entre ellos.

Los datos de entrada básicos al proceso de enrutamiento (pdEntr) son:
* Dispositivo
* Cola
* Origen
* Nodo entrada
* UCID
* CALLER_ID_NAME
* CALLER_ID_NUM
* DNIS
* Desvío por dialplan

A partir de los datos de entrada básicos anteriores se pueden deducir los siguientes valores:
* Sede del dispositivo de entrada
* Sede del nodo de entrada
* Ancho de banda disponible en la sede del dispositivo
* Ancho de banda disponible en la sede del nodo
* Categoría entrante
* Valor del eje1 asignado a la llamadas
* CALLER_ID_NUM_EXTERNO

Los datos de salida globales del proceso de enrutamiento (pdSale) son:
* Categoría saliente
* Código de cliente (opcional)
* Tipo de destino:
:* No existe
:* Ruta externa
:* Extensión
:* Usuario de telefonía corporativa
:* Facilidad
:* Salas de conferencia
:* Agentes de grupos ACD
:* Grupos ACD
:* VDN
:* Buzón para dejar mensaje.
:* Buzón para dejar mensaje por ocupado.
:* Buzón para dejar mensaje por no contestación.
:* Buzón para su gestión.
* Destinatario (cuando se trata de un usuario o de un agente)
* Valor del eje1 asignado a la llamada
* Buzón de las extensiones y usuarios que los tengan asignados
* Si el buzón está en nodo distinto al de entrada
* DESVIO_INCONDICIONAL (sólo extensiones y usuarios) (valor MENSA=desvio_mensajeria en variable)
* DESVIO_NO_CONTESTA (sólo extensiones y usuarios) (valor MENSA=desvio_mensajeria en variable)
* DESVIO_OCUPADO (sólo extensiones y usuarios) (valor MENSA=desvio_mensajeria en variable)
* DESVIO_FUERA_SERV (sólo extensiones y usuarios) (valor MENSA=desvio_mensajeria en variable)

Los datos de salida para cada una de las posibles rutas en orden son (nn va de 01 maxRutas [nn son dos dígitos decimales]):
* CONTADOR_ABDE_nn (contador para control de ancho de banda en sede de dispositivo de entrada).
* CONTADOR_ABNE_nn (contador para control de ancho de banda en sede de nodo de entrada).
* CONTADOR_ABDS_nn (contador para control de ancho de banda en sede de dispositivo de salida).
* CONTADOR_ABNS_nn (contador para control de ancho de banda en sede de nodo de salida).
* CALLER_NAME_SAL_nn , puede salir de una extensión, un usuario o de un agente.
* CALLER_NUM_SAL_nn, puede salir de una extensión, un usuario o de un agente.
* DESTINO_SAL_nn , en general, el valor C_NOMBRE o destino de salida.
* RUTA_NODO_nn , Cadena de marcación para ir la nodo que soporta DESTINO_SAL_nn, si es distinto del nodo de entrada.
* RUTA_SAL_nn
:* Extensión: cadena marcación.
:* Facilidad: E_CODIGO_FACILIDAD obtenido de la tabla CEN_FACILIDADES.
:* Usuario: cadena marcación de la extensión asignada al usuario en movilidad o en propiedad.
:* Agente: cadena marcación de la extensión a la que está conectado el agente.
:* Ruta externa: contexto que gestiona la llamada saliente.

=====Fase preenrutamiento =====

La fase de preenrutamiento (basada en la tabla CEN_PRE_RUTA) se usa en todas las llamadas entrantes, tanto internas, como externas. Permite desarrollar un “prerouting” estándar para ACD y para telefonía corporativa.

Los datos de entrada al proceso de enrutamiento son iguales a los del proceso global de enrutamiento, excepto en que este proceso no usa el nodo de entrada ya que es independiente de éste.

Los datos de salida de la fase de preenrutamiento:
* D_CATEGORIA_SAL
* COD_CLIENTE (opcional)
* TIPO_DESTINO_SAL
:* No existe.
:* Volver a preenrutar.
:* Ruta externa.
:* Extensión.
:* Usuario de telefonía corporativa.
:* Facilidad.
:* Sala de conferencia.
:* Agente de grupos ACD.
:* Grupos ACD.
:* VDN.
:* Buzón para dejar mensaje.
:* Buzón para dejar mensaje por ocupado.
:* Buzón para dejar mensaje por no contestación.
:* Buzón para su gestión.
* COD_CLIENTE
* Valor del eje1 asignado a la llamada
* CALLER_NAME
* CALLER_NUM
* DESTINO

El proceso de preenrutamiento consiste en seleccionar un único registro de la tabla CEN_PRE_RUTA y, con sus valores y con los valores de entrada al proceso, generar los datos de salida.

Un posible tipo de salida es "Volver a preenrutar". Esto permite realimentar el proceso un máximo de "max_pre_ruta_regs" veces (en archivo .conf) para simplificar configuración. Sólo tiene sentido realimentar si se ha hecho alguna modificación en los datos de selección de registro, ya que en caso contrario se produciría un bucle que el proceso de preenrutamiento es capaz de detectar y evitar.

Para elegir el registro de CEN_PRE_RUTA, se tienen en cuenta los datos de entrada de la llamada, de modo que se cumpla con todos los puntos siguientes:
* ID_CATEGORIA_ENT igual a la del dispositivo de entrada.
* CALLER_NUM de entrada
:* Debe comenzar por la cadena C_ORIGEN_ENT_PREF o C_ORIGEN_ENT_PREF=NULL, con menos prioridad. Es conveniente rellenar este dato del modo más restrictivo que sea posible, independientemente de C_ORIGEN_ENT_EXPR. Ello permite disminuir el uso innecesario de recursos de evaluación de expresiones regulares.
:* Debe de tener un número de dígitos igual o superior a N_ORIGEN_ENT_MIN_DIGITOS, si este valor no es NULL o cero.
:* Debe de tener un número de dígitos igual o inferior a N_ORIGEN_ENT_MAX_DIGITOS, si este valor no es NULL o cero.
:* Debe cumplir la expresión regular C_ORIGEN_ENT_EXPR, si ésta no es NULL.
* DNIS empiece con C_DESTINO_ENT_PREF o C_DESTINO_ENT_PREF=NULL. Es conveniente rellenar este dato del modo más restrictivo que sea posible, independientemente de C_DESTINO_ENT_EXPR. Ello permite disminuir el uso innecesario de recursos de evaluación de expresiones regulares.
* Si varias entradas cumplen la condición anterior, se prueba primero la que el campo C_DESTINO_ENT_PREF tenga una longitud mayor y, de entre éstas, la que C_ORIGEN_ENT_PREF tenga una longitud mayor.
* DNIS tenga un número de dígitos igual o superior a N_DESTINO_ENT_MIN_DIGITOS, si este valor no es NULL o cero.
* DNIS tenga un número de dígitos igual o inferior a N_ORIGEN_ENT_MIN_DIGITOS, si este valor no es NULL o cero.
* DNIS cumpla la expresión regular C_DESTINO_ENT_EXPR, si ésta no es NULL.

Si no se encuentra ninguna entrada adecuada, quiere decir que es una llamada prohibida y se devuelve el tipo de destino "No existe".

Puede conseguirse un destino "por defecto" diferente, creando una entrada que encaje siempre para cada categoría: C_ORIGEN_ENT, C_ORIGEN_ENT_MIN_DIGITOS, C_ORIGEN_ENT_MAX_DIGITOS, C_ORIGEN_ENT_EXPR, C_DESTINO_ENT_PREF, N_DESTINO_ENT_MIN_DIGITOS, N_DESTINO_ENT_MAX_DIGITOS y C_DESTINO_ENT_EXPR a valor NULL.

Una vez elegida una entrada, ésta puede transformar o sustituir el valor de ID_CATEGORIA, CALLER_NAME, CALLER_NUM, DESTINO, COD_CLIENTE y/o EJE1_MSK a la salida del proceso.

Si ID_CATEGORIA_SAL es cero, se propaga a la salida el valor de la entrada. En caso contrario, se sustituye.

Si C_CALLER_NAME está vacío, se mantiene el valor hubiese a la entrada. En caso contrario, se sustituye.

C_CALLER_NUM puede contener una cadena que identifica el nuevo CALLER_NUM. Además, si la cadena comienza por los caracteres que se indican, el significado es especial:
* "=" o cadena vacía, el nuevo CALLER_NUM es igual al de entrada al proceso.
* "+" el nuevo CALLER_NUM es igual al de entrada al proceso, con los caracteres a continuación de "+" como prefijo.
* "-" se quita el número de caracteres que se indica a continuación de "-".
* "_" lo que sigue al carácter es una expresión regular que se aplica al CALLER_NUM de entrada. Dicha expresión regular tiene obligatoriamente que contener una subcadena (definida entre paréntesis, según el estándar de expresiones regulares) que nos da el nuevo CALLER_NUM de salida. Si la expresión regular no se cumpliese, se propagará el valor de entrada al proceso.
* cualquier otro valor del primer carácter determina que es una constante que sustituye el valor a la entrada.

Cada vez que se utilice una preruta, se incrementará el valor de N_CONTA si el valor de N_UMBRAL es mayor que cero.

Un valor N_UMBRAL mayor que cero permite modificar el destino de salida cuando el valor de actual de N_CONTA (antes de incrementarse) supere o sea igual el valor de N_UMBRAL. Si se cumple la condición indicada, se usa como destino tras el preenrutamiento, los valores de los campos E_TIPO_DESTINO_SAL_2 y C_DESTINO_SAL_2.

Si el valor de N_UMBRAL es menor o igual a cero o si N_CONTA es inferior a N_UMBRAL, se usa como destino tras el preenrutamiento, los valores de los campos E_TIPO_DESTINO_SAL_1 y C_DESTINO_SAL_1.
Con este mecanismo de N_CONTA y N_UMBRAL, se pretende facilitar el discriminar a los llamantes reincidentes, cuando sea necesario.

Un proceso periódico externo debe encargarse de poner a cero o decrementar el valor de N_CONTA.
Como resultado de los procesos de filtrado y de verificación anteriores, se habrá obtenido un TIPO_DESTINO_SAL y un C_DESTINO_SAL a partir de los campos con sufijo "_1" o "_2", con una metodología similar al caso C_CALLER_NUM.

C_DESTINO_SAL_x puede contener cadena que permite obtener el nuevo destino. Además, si la cadena comienza por los caracteres que se indican, el significado es especial:
* "=" o cadena vacía, el nuevo destino es igual al de entrada al proceso.
* "+" el nuevo destino es igual al de entrada al proceso, con los caracteres a continuación de "+" como prefijo.
* "-" se quita el número de caracteres que se indica a continuación de "-".
* "_" lo que sigue al carácter es una expresión regular que se aplica al destino de entrada. Dicha expresión regular tiene obligatoriamente que contener una subcadena (definida entre paréntesis, según el estándar de expresiones regulares) que nos da el nuevo destino de salida. Si la expresión regular no se cumpliese, quiere decir que es una llamada prohibida y se encaminará hacia una facilidad por defecto.
* cualquier otro valor del primer carácter determina que es una constante que sustituye el valor a la entrada.
Información de salida del proceso de preenrutamiento: Cuando TIPO_DESTINO_SAL_x toma los valores que se indican, el proceso global de enrutamiento sólo requiere de preenrutamiento y la información a devolver se obtiene dependiendo de TIPO_DESTINO_SAL_x:
* No existe: Se asume que no se conoce un destino para los datos de entrada, por lo que la llamada se encamina hacia una facilidad por defecto que gestiona su tratamiento.
* Extensión: A partir de las tablas CEN_DISPOSITIVOS, CEN_EXTENSIONES y CEN_NODOS, se devolverán los valores que permiten alcanzar la extensión en el nodo principal y en el secundario.
* Facilidad: A partir de las tablas CEN_DISPOSITIVOS, CEN_FACILIDADES y CEN_NODOS.
* Usuario de telefonía corporativa: A partir de las tablas CEN_USUARIOS, CEN_DISPOSITIVOS, CEN_EXTENSIONES y CEN_NODOS, se devolverán los valores que permiten alcanzar al usuario en el nodo principal y en el secundario de la extensión que corresponde en base a movilidad, con prioridad, o en base a propiedad. El caso de movilidad no se tiene en cuenta si el proceso de enrutamiento se realiza en "modo supervivencia".
* Sala conferencia: A partir de las tablas CEN_SALAS_CONFERENCIAS y CEN_NODOS.
* Agente de ACD: A partir de las tablas ACD_USUARIOS, DAT_TR_ACD_EXTENSIONES, CEN_DISPOSITIVOS, CEN_EXTENSIONES y CEN_NODOS, se devolverán los valores que permiten alcanzar al agente en el nodo principal y en el secundario.
* VDN: A partir de las tablas ACD_VDN y CEN_NODOS, se devolverán los valores que permiten alcanzar al VDN en su nodo.
* Grupo ACD: A partir de las tablas ACD_COLAS y CEN_NODOS, se devolverán los valores que permiten alcanzar al grupo ACD en su nodo.

El campo B_GENERAR_SEGMENTO de la tabla CEN_PRE_RUTA indica al proceso de preenrutamiento que es preciso generar un segmento de tipo "preenrutamiento". En el segmento generado, se rellena el campo C_ETIQUETA1 del nuevo segmento con el valor que contiene el campo homónimo del registro asociado en la tabla CEN_LISTA_PRE_RUTAS.

===== Fase de enrutamiento en casos en que el destino no es externo =====
Datos de entrada al proceso de enrutamiento externo: iguales a los de salida del proceso de preenrutamiento (pdPreSale), uniéndose a éstos los datos globales de entrada al proceso (pdEntr).

Datos de salida de la fase de enrutamiento: iguales que los del proceso global de enrutamiento (pdSale).

Específicamente y sólo para los casos en que el destino es una extensión (tipo de destino extensión, usuario de telefonía corporativa o agente) es cuando son válidos los datos correspondientes al buzón asociado y los datos de los posibles desvíos previstos.

También en este caso, se prevén dos posibles rutas, una se corresponde con el acceso a la extensión en el nodo principal de ésta y la otra en el nodo secundario.

En el resto de tipos de destino, sólo se prevé una ruta que puede incluir o no un enlace internodal.

===== Fase de enrutamiento en el caso de destino externo =====
Datos de entrada al proceso de enrutamiento externo: iguales a los de salida del proceso de preenrutamiento (pdPreSale), uniéndose a éstos los datos globales de entrada al proceso (pdEntr).
Datos de salida de la fase de enrutamiento: iguales que los del proceso global de enrutamiento (pdSale).

Se elige los primeros "max_ruta" registros (configurado en archivo .conf) en CEN_DESTINOS_EXTERNOS unido con CEN_RELACION_DESTINOS_ENLACES_EXTERNOS que, teniendo en cuenta los datos de entrada al proceso de enrutamiento, cumpla con todos los puntos siguientes:
* ID_CATEGORIA_ENT igual a la de salida del proceso de preenrutamiento.
* C_DESTINO_SAL de proceso de preenrutamiento empiece con C_DESTINO_ENT_PREF.
* Si varias entradas cumplen la condicion anterior, se prueba primero la que el campo C_DESTINO_ENT_PREF tenga una longitud mayor.
* C_DESTINO_SAL tenga un número de dígitos igual o superior a N_DESTINO_ENT_MIN_DIGITOS, si este valor no es NULL o cero.
* C_DESTINO_SAL tenga un número de dígitos igual o inferior a N_DESTINO_ENT_MAX_DIGITOS, si este valor no es NULL o cero.
* C_DESTINO_SAL cumpla la expresión regular C_DESTINO_ENT_EXPR, si ésta no es NULL.

Aparte de la longitud del campo C_DESTINO_ENT_PREF, se usa N_PRIORIDAD como campo para ordenar los registros y seleccionar lo "max_ruta" primeros.

Una vez que un registro es válido, se descartan todos los registros cuyo C_DESTINO_ENT_PREF es diferente del primero seleccionado.

Como resultado de los procesos de filtrado y de verificación anteriores, se habrá obtenido hasta un máximo de "max_rutas" valores para posibles rutas. Las posibles propagaciones y transformaciones en los datos de cada ruta son función de los datos de cada registro seleccionado:

CALLER_NAME_nn: Si C_CALLER_NAME está vacío, se propaga el valor de entrada. En caso contrario, se sustituye.

CALLER_NUM_nn: Sale de C_CALLER_NUM que puede contener una cadena que identifica el nuevo CALLER_NUM_n. Además, si C_CALLER_NUM comienza por los caracteres que se indican, el significado es especial:
* "=" o cadena vacía, el nuevo CALLER_NUM_nn es igual al de entrada al proceso.
* "+" el nuevo CALLER_NUM_nn es igual al de entrada al proceso, con los caracteres a continuación de "+" como prefijo.
* "-" se quita el número de caracteres que se indica a continuación de "-".
* "_" lo que sigue al carácter es una expresión regular que se aplica al CALLER_NUM de entrada. Dicha expresión regular tiene obligatoriamente que contener una subcadena (definida entre paréntesis, según el estándar de expresiones regulares) que nos da el nuevo CALLER_NUM de salida. Si la expresión regular no se cumpliese, se propaga el valor de entrada al proceso.
* ">" Si existe valor para CALLER_NUM_EXTERNO, se propagará éste a la salida. En caso contrario y si no está vacía la cadena que queda al eliminar el prefijo ">", se susituye en la salida por el valor de la cadena sin prefijo. Si la cadena estuviese únicamente constituida por el valor ">", se propaga el valor de entrada.
* cualquier otro valor del primer carácter determina que es una constante sin ninguna modificación.

C_DESTINO_SAL_nn: Se obtiene a partir de C_DESTINO_SAL que puede contener una cadena que identifica el nuevo destino. Además, si la cadena comienza por los caracteres que se indican, el significado es especial:
* "=" o cadena vacía, el nuevo destino es igual al de entrada al proceso.
* "+" el nuevo destino es igual al de entrada al proceso, con los caracteres a continuación de "+" como prefijo.
* "-" se quita el número de caracteres que se indica a continuación de "-".
* "_" lo que sigue al carácter es una expresión regular que se aplica al destino de entrada. Dicha expresión regular tiene obligatoriamente que contener una subcadena (definida entre paréntesis, según el estándar de expresiones regulares) que nos da el nuevo destino de salida. Si la expresión regular no se cumpliese, se propaga el valor de entrada al proceso.
* cualquier otro valor del primer carácter determina que es una constante sin ninguna modificación.

RUTA_NODO_nn: Sólo se usa si el nodo de salida es diferente del nodo de entrada. Contiene la cadena de marcación para ir la nodo que soporta DESTINO_SAL_nn. Sale del campo C_FORMATO_DIAL (sustituyendo variables) correspondiente al tipo de dispositivo del enlace exterior.

RUTA_SAL_nn: Es el campo C_DATO_ASTERISK obtenido a partir del registro en la tabla CEN_ENLACE_EXTERIOR que se corresponde con ID_ENLACE_EXTERIOR de la tabla CEN_RELACION_DESTINOS_ENLACES_EXTERNOS.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Control de ancho de banda ===

Para el control de ancho de banda, primero hemos de tener en consideración que una llamada puede tener asociadas hasta cuatro sedes
:* Sede del terminal origen (terminal A)
:* Sede del nodo de registro del terminal origen (nodo A)
:* Sede del terminal destino (terminal B)
:* Sede del nodo de registro del terminal destino (nodo B)

Además hemos de tener en cuenta que el audio de la conversación podrá ir:
:* De manera directa entre terminal A y terminal B
:* De manera indirecta, a través de los nodos A y B

[[Archivo:ancho de banda.png|700px]]

Cuando se va a cursar una llamada de terminal A a terminal B, el proceso de enrutamiento del nodo A devuelve 4 variables de canal al dialplan:

{| class="wikitable"
|-
! Variable!!Campos
|-
|R_ABDE_xx||R = Variable de rutas --- AB = ancho de banda --- D = dispositivo --- E = Entrante --- xx = de 0 a 3
|-
|R_ABNE_xx||R = Variable de rutas --- AB = ancho de banda --- N = nodo --- E = Entrante --- xx = de 0 a 3
|-
|R_ABDS_xx||R = Variable de rutas --- AB = ancho de banda --- D = dispositivo --- S = Saliente --- xx = de 0 a 3
|-
|R_ABNS_xx||R = Variable de rutas --- AB = ancho de banda --- N = nodo --- S = Saliente --- xx = de 0 a 3
|-
|}

El valor de cada variable es una cadena del tipo '''AB.wwww.xxxx.y.z''' donde cada valor es:
:* '''wwww''' --> id de sede
:* '''xxxx''' --> ancho de banda total de la sede
:* '''y''' --> número de llamadas a sumar si conversación directa
:* '''z''' --> número de llamadas a sumar si conversación indirecta

Por otro lado tenemos que tener en cuenta que el dialplan tiene control de las llamadas que cada sede puede cursar

De esta forma, cuando existe una nueva llamada el dialplan aplica la fórmula, suma el resultado al número de llamadas en curso y lo compara con el máximo...si el resultado es mayor que le máximo la llamada no se cursará por congestión

Configuraremos el ancho de banda por sede en el portal de administración y el consumo que hace cada llamada en la variable '''AB_CONSUMO_LLAMADA''' del fichero '''ext_MDtel_particular.conf''' de cada nodo de conmutación; el valor por defecto es 32

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

== Puesto de trabajo ==
El puesto de trabajo del agente en la plataforma '''''VIVA'''''it (para el producto '''''VIVA'''''it Suite) estará compuesto por:
* PC (típicamente windows) en el que reside la aplicación '''''VIVA'''''it Desk
* Terminal telefónico con extensión física asociada.

Para más información [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Puestos | ver sección Portal de administración-VIVAit Suite ACD+ - Puestos]].

=== Relación PC/teléfono en puesto de trabajo ===

Existirá una relación única entre nombre PC y extensión física asociada, si bien los agentes se identificarán por su login que les acompaña al puesto de trabajo en el que se loguen
Existe un procedimiento documentado para la operativa de cambio de puesto de trabajo, en caso de ser necesario el cambio de PC o de teléfono de un puesto de trabajo.
==== Procedimiento para un cambio de puesto de trabajo ====
Se basa en una asignación de PC a teléfono relaccionando la extensión telefónica del terminal físico con el nombre del puesto de trabajo. La configuración de dicha asociación se realiza en el portal de administración de la plataforma.

Cualquier cambio que se realice en terminal telefónico o PC de agente ha de mantener la asociación en el portal a efectos de permitir el funcionamiento del sistema.

A continuación se reflejan los cambios más habituales:

{| class="wikitable"
|-
! Cambio !! Procedimiento !! Punto de acción
|-
|rowspan="2"| Cambio de ubicación de un PC || Opción 1.- Renombrar el PC para que conserve el nombre que tenía el anterior en esa ubicación || PC de agente
|-
| Opción 2.- Rehacer la asignación extensión/puesto || Portal de administración
|-
| rowspan="2"| Instalación de PC nuevo en puesto existente || Opción 1.- Renombrar el PC para que conserve el nombre que tenía el anterior en esa ubicación || PC de agente
|-
| Opción 2.- Rehacer la asignación extensión/puesto || Portal de administración
|-
| Cambio de nombre en un PC || Rehacer asignación extensión/puesto || Rehacer asignación extensión/puesto
|-
|Cambio de ubicación de un teléfono || Rehacer la asignación extensión/puesto
|| Portal de administración
|-
| Instalación de un teléfono nuevo en puesto existente || Rehacer la asignación extensión/puesto || Portal de administración
|-
| Instalación de un nuevo puesto de agente|| Hacer asignación extensión/puesto || Portal de administración
|}


=== Estructura de aplicaciones en puesto de trabajo ===
Las aplicaciones del puesto de trabajo pueden estar ubicadas en cualquier carpeta del sistema. Es importante tener en cuenta que los procesos de actualización, logs… escriben en dichas carpetas, por lo que el usuario de windows deberá tener permisos de lectura/escritura y borrado sobre dichas carpetas
La instalación del puesto de trabajo es muy liviana para el sistema; las aplicaciones ocupan poco espacio y no se modifican ficheros del sistema operativo (registry o similares)
Los ficheros importantes son
{| class="wikitable"
|-
! Fichero !! Descrición
|-
| Vivait-desk.exe || Contiene la aplicación '''''VIVA'''''it Desk de agente
|-
| vivait_desk_dll.dll||Este fichero contiene controles sobre los formularios (controles de
texto, algunas reglas de obligatoriedad…)
|-
| nimitz.ini || Configuración del puesto de agente
|-
| lanzador.exe || Aplicación de actualización de versiones
|-
| lanzador.ini || Configuración del actualizador de aplicaciones
|-
| Carpeta forms || En esta carpeta están ubicados los formularios que se abren ante llamada entrante o saliente
|-
| Carpeta imágenes || Contiene las imágenes izquierda y derecha de la barra de '''''VIVA'''''it Desk
|-
|}

=== Secciones de utilidad en nimitz.ini ===

==== Configuración del puesto de agente ====

El fichero nimitz.ini contiene la configuración del puesto de agente; sus principales parámetros son:

{| class="wikitable" border="0" style="background:#ffffff" align="top"
|-
| |''' Fichero'''
|| '''Descripción'''
|-
|Sección [bd1]
||host="ip_BBDD_tiempo_real"
puerto="Nº puerto"
basedatos="nimitz"
usuario="nimitz"
clave="UIk5jMY9PVX6ogg="

Contiene información para la conexión a BBDD de tiempo real, en la que '''''VIVA'''''it Desk fundamentalmente inserta información
|-
|Sección [bd2]
||host=" ip_BBDD_replica "
puerto="Nº puerto"
basedatos="nimitz"
usuario="nimitz"
clave="UIk5jMY9PVX6ogg="

Contiene información para la conexión a BBDD de réplica, en la que '''''VIVA'''''it Desk solo leerá información
|-
|Sección [telefono]
||pruebas=1 (Valores válidos 0 ó 1)
Activación de funcionalidad "servicio técnico" en '''''VIVA'''''it Desk.

puesto="Nombre puesto"
|-
|Sección [trazas]
|| nivel=3

archivo=1

consola=0

sobreescribir=1

Activación de generación de ficheros de trazas "viva-desk.log" en carpeta de aplicaciones
|}

=== Parámetros en invocación a '''''VIVA'''''it Desk ===

La aplicación '''''VIVA'''''it Desk puede ser invocada con una serie de parámetros que condicionan su funcionamiento; los parámetros son:
* Primer parámetro: Nombre del archivo .ini; usado como alternativa al fichero por defecto "nimitz.ini"
* Segundo parámetro: Nombre de puesto; usado como alternativa al nombre de puesto del ordenador
* Tercer parámetro: Nombre de login; para forzar un usuario; es de utilidad si el sistema está configurado como "confiar en sistema operativo", en cuyo caso no permite seleccionar un login de agente para acceder a la aplicación

=== Instalación y actualización de aplicaciones de puestos de trabajo ===
La instalación y actualización de las aplicaciones en el puesto de trabajo pasan por disponer de los ficheros “lanzador.exe” y “lanzador.ini” (debidamente configurado) dentro de la carpeta en la que se desee instalar.
Lanzando la aplicación “lanzador.exe” se instalará o actualizará el sistema.

El fichero “lanzador.ini” tiene el siguiente aspecto:
URL="http://IP_Servidor:8180/WSActualizaXML/actualizar.xml"
BASE_URL_DESCARGAS="http://IP_servidor:8180/XMLFILES/"

=== Servicio técnico en '''''VIVA'''''it Desk ===
La activación de la funcionalidad de servicio técnico en '''''VIVA'''''it Desk nos permite realizar sincronizaciones manuales de la aplicación y activar trazas a nivel de Base de Datos o a nivel de log sobre el propio '''''VIVA'''''it Desk. Pulsando el botón derecho del ratón sobre la barra '''''VIVA'''''it Desk accederemos a las capacidades de soporte técnico
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

== Funcionamiento de la plataforma en modo emergencia ==
== Accesos Web ==

{| class="wikitable"
|-
! Aplicación !! Enlace
|-
|Portal de administración '''''VIVA'''''it Suite || http://ip_admin:8180/Vivait-Call
|-
|'''''VIVA'''''it Tracker||http://ip_tracker:8180/Vivait-Tracker
|-
|Monitor Web||http://ip_monitor:8180/MonitorWeb
|-
|Monitorización Zabbix||http://ip_zabbix:80/zabbix
|-
|Base de datos tiempo real||http://ip_bbdd_tr:80/phpmyadmin/
|-
|Base de datos réplica||http://ip_bbdd_replica:80/phpmyadmin
|}

=== Permisos de aplicaciones ===
Se crean a través del '''portal de administración ''VIVA''it''' . Debe conocerse como funcionan los ejes [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Ejes| ver sección Portal de administracion - General - Ejes]] y que existen cuatro aplicaciones creadas en la plataforma:

[[Archivo:17_2 Pestaña Genera - Usuarios - Explicacion permisos.png|center]]

La forma como dar permisos de aplicaciones a un usuario esta explicada en la [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Asignaci.C3.B3n_de_Permisos_de_Usuario_por_Administrador | sección Portal de administracion - General - Usuarios ]].

== Elementos monitorizados del sistema ==
===Generalidades de Zabbix===
====Zabbix ====
Zabbix es una solución de código abierto que ofrece características de monitorización avanzada de forma tecnica y para el negocio, para todo tipo de servidores, aplicaciones y equipos que forman parte de una red. La versión que utilizamos en '''md'''tel es Zabbix 2.2.2.

Zabbix monitoriza los recursos de un equipo en forma remota, permite centralizar la información en un servidor que permite visualizar el monitoreo, cuenta con una interfaz de administración vía web y utiliza un mecanismo flexible de la notificación que permita que los usuarios configuren las alarmas basadas email para informar virtualmente cualquier acontecimiento. Esto permite una reacción rápida a los problemas del servidor.

Para acceder al servidor Zabbix abrimos el navegador y ponemos la dirección de red (IP) de la maquina donde se encuentra instalado el servidor de Zabbix seguido de "/Zabbix.
{|
|-
|
Direccion.IP.Zabbix.Server/zabbix
|}

Zabbix posee documentación tanto en wiki, foros y comunidades.Para ampliar la información se puede visitar:
[[http://www.zabbix.com Sitio oficial de Zabbix]]
===== Glosario Zabbix =====
Se trata de una lista de conceptos básicos de Zabbix, pero para ampliar la información sobre otros términos, visite el [[http://www.zabbix.com Sitio oficial de Zabbix]].
* '''host'''
:En Zabbix, un host es una entidad que define el elemento en red que se desea monitorizar/supervisar activamente sus recursos locales y aplicaciones. Este puede ser una impresa, router, switch, sensores de temperatura, un servidor, un ordenador,etc, o también una aplicación. La característica de un host es que debe poseer una dirección de red (IP).

* '''host group'''
:En Zabbix, un host group (grupo host) es una agrupación lógica de los host, como una forma de organizar los dispositivos "Host" registrados en Zabbix para su monitorización. Puede contener hosts y templates. Los grupos host se utilizan en la asignación de derechos de acceso a los hosts para diferentes grupos de usuarios.

* '''item'''
:En Zabbix, un item (medida) es el parámetro que deseamos obtener del host, básicamente es una medida especifica que el servidor Zabbix recogerá de los agentes de Zabbix instalados en los host.

* '''trigger'''
:En Zabbix, un trigger(disparador) es una entidad que define un umbral para detectar la existencia de un problema en un dispositivo. Son valores recolectados por los "items", se usa para "evaluar" los datos recibidos con condiciones definidas. Las condiciones son de tipo aritmético y lógico.
* '''event'''
:En Zabbix, un event (evento) es la aparición de un suceso en Zabbix que necesita atención. Por ejemplo, el cambio de estado a raíz de un trigger, el descubrimiento de un nuevo agente (autoregistro),etc.
* '''action'''
:En Zabbix, una action(acción) son reglas predefinidas para reaccionar a un evento disparado por los triggers, es decir, define qué hacer ante un evento. Consta de operaciones (por ejemplo, una notificacion, comandos remotos) y condiciones (cuando la operación se lleva a cabo).
* '''notification'''
:En Zabbix, una notification (notificacion) es la entidad con que Zabbix nos puede notificar (Correo Electrónico,mensajes vía "SMS" o Jabber).
* '''template'''
:En Zabbix, un témplate (plantilla) viene predefinida en la instalación de Zabbix Server, con el fin de ser aplicada en base al tipo de sistema operativo(Linux, Mac, Window, etc) o en elementos que comparten los mismos parámetros de medición, por ejemplo la carga del procesador, uso de memoria y uso de recursos de red. Las plantillas son un conjunto de módulos "ITEM, TRIGGERS y GRÁFICAS", que están preconfigurados y listas para ser aplicadas a uno o varios hosts.
* '''application'''
:En Zabbix, una application (aplicación) es una agrupación lógica de los items.
* '''Zabbix server'''
:El Zabbix server (servidor de Zabbix) es el proceso central donde están definidas las configuraciones y donde se almacenan todos los datos y estadísticas recogidas de los agentes Zabbix.Consta de una base de datos, una interfaz web y el propio server. Como servidor, se encarga de recoger los datos de los agentes, calcular los triggers, enviar notificaciones, etc.
* '''Zabbix agent'''
:El zabbix agent (agente de Zabbix) es un proceso desplegado en los host que son supervisados, que funciona como un servicio y puede funcionar de forma activa y pasiva simultáneamente.

=====Discovery=====
La funcionalidad discovery(detección) lista los dispositivos que se integran en nuestra red y el tipo de servicios que proporciona. Por ejemplo, si la empresa tuviera cien colas ACDs, y veinticinco VDNS, y en cada cola como veinte medidas, seria muy laborioso registrar una por uno cada uno.
Gracias a esta funcionalidad, se descubre todas las interfaces de red que se tiene, automáticamente y tanto para colas nodos o IVR. Para utilizar esta funcionalidad , se hace el uso de dos script, que se instalan en el momento de instalación de Zabbix en el directorio "/usr/local/sbin", que son:
{|
|-
|
'''zabbixDiscoveryQueues.pl''' : script utilizado para buscar colas ACD.

'''zabbixDiscoveryVDN.pl''' : script utilizado para buscar VDNS.
|}
La explicación de como configurarla se encuentra en el manual oficial [[https://www.zabbix.com/documentation/2.2/manual/discovery/network_discovery/rule | Zabbix detección de redes]].

=====Notificaciones=====

Necesariamente, debe darse de alta al usuario y darse de alta el servidor de correo electrónico para poder ser capaz de enviar correos.

Por otro lado, el formato del correo electrónico y las condiciones de envío de correo al usuario se configura en las acciones. Véase el [[https://www.zabbix.com/documentation/2.2/manual/quickstart/notification | manual oficial de Zabbix 2.2]]

=====Usuarios=====
Zabbix permite la organización de usuarios en grupos para establecer los permisos adecuados de acuerdo al tipo de perfil que deseemos crear. Necesariamente un usuario debe permanecer a un grupo o varios grupos.Todos los usuarios acceden a la aplicación de Zabbix a través de la interfaz Web.

Cada usuario Zabbix se le asigna un nombre de usuario único , una contraseña y podemos indicarle que tipo de comunicación que posee, normalmente es vía email, pero puede ser vía a otro tipo de medios. Para mas información ver el [[https://www.zabbix.com/documentation/2.2/manual/web_interface/user_profile || manual oficial ]].

=====Visualización=====
Con Zabbix es posible visualizar los datos como gráficos, pantallas, mapas y hasta presentaciones cambiantes, entre otros. En este apartado solo nombraremos características esenciales que se tendra que completar con el [[https://www.zabbix.com/documentation/2.2/manual/config/visualisation | manual oficial]]
======Graphs======
{|
|-
|
'''Nota:''' Debe crearse algun item dentro del host para poder utilizar una gráfica.
|}
En Zabbix una gráfica sirve para representar gráficamente los resultados obtenidos de uno item o varios items.
[[File:EjemploGrafica.png|center|750px]]
Los valores min / avg / max que Zabbix obtiene y representa son de un registro de datos de la tabla tendencias.

======Screens======
La pantalla refiere a otra característica adaptable de ZABBIX cuál permite que los usuarios creen las pantallas personalizadas dentro de ZABBIX para exhibir la información. Se considera como una colección de gráficas y no depende del host. Una pantalla puede consistir en gráficos simples, gráficos personalizados, integrar mapas, Alertas, gráficos estadísticos o texto llano tal como los 5 valores pasados de un item particular entre otros; y mostrar la información de forma dinámica.

[[File:EjemploScreen.png|center|750px]]

======Maps======
En Zabbix, un map (mapa) es una representación gráfica de la situacion de nuestros dispositivos en red. Es un escenario que muestra nuestra red, aplicaciones y servicios a través de figuras o iconos. Dichas figuras toman vida en respuesta a los eventos que se dan en nuestro entorno.
[[File:EjemploMaps.png|center|750px]]
[[File:EstadosMaps.png|center|750px]]

======Monitorizar el estado de los raid======
Los siguientes comandos son necesarios para poder monitorizar el estado de los raid.
La orden:

>hpacucli "ctrl slot=1 logicaldrive 1 show status"

nos proporciona el estado de un raid (p.e. logicaldrive 1 (931.5 GB, 1): Interim Recovery Mode).

La orden:
>hpacucli "ctrl slot=1 logicaldrive all show status"

nos proporciona el estado de todos los raid.

p.e.:
logicaldrive 1 (931.5 GB, 1): Interim Recovery Mode

logicaldrive 2 (1.8 TB, 1): OK.

Para conseguir información genérica el comando

ctrl all show config detail

nos muestra mucha información y podemos saber el modelo de disco físico que lleva instalado para poder comprar el modelo antes de "operar".

===Zabbix en '''MD'''tel===

==== Configuraciones de Zabbix ====

===== Agentes Zabbix =====
{|-
|
|
'''Nota:''' Hay que instalar un agente Zabbix en cada maquina que se quiera monitorizar.
|}

El agente de Zabbix puede recoger datos:
*'''De forma pasiva:''' el server contacta al agente pidiéndole un dato (por ejemplo el consumo de CPU en ese instante) y el agente responde al server con ese dato. A esta acción del agente le llamaremos '''Agente activo'''.
*'''De forma activa:''' en un primer momento, el server le enviará al agente el listado de items a monitorizar. A partir de ese momento, será el agente que de forma periódica recogerá datos sobre esos ítems y se los hará llegar al server. A esta acción del agente le llamaremos ''''''Agente pasivo''''''.

====== Configurar agente de forma pasiva======
Para configurar el agente de Zabbix necesitamos acceder a la maquina que actuará como agente, y en el directorio /etc/zabbix modificar el fichero '''zabbix_agentd.conf''' e indicar cual es la dirección de red (IP) del servidor Zabbix.

{|
|-
|
##### Passive checks related
### Option: Server
# List of comma delimited IP addresses (or hostnames) of Zabbix servers.
# Incoming connections will be accepted only from the hosts listed here.
# If IPv6 support is enabled then '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1'
# are treated equall$
#
# Mandatory: no
# Default:
Server= IP.Server Zabbix.
|}
Tras la configuración del fichero, debemos reiniciar el servicio de los agentes.
{|
|-
|
sudo service zabbix-agent restart
|}

====== Configurar agente de forma activa ======

Para configurar el agente de Zabbix necesitamos acceder a la máquina que actuará como agente, y en el directorio /etc/zabbix modificar el fichero '''zabbix_agentd.conf''' e indicar cual es la dirección de red (IP) del servidor Zabbix.

{|
|-
|
##### Active checks related
### Option: ServerActive
# List of comma delimited IP:port (or hostname:port) pairs of Zabbix serv$
# If port is not specified, default port is used.
# IPv6 addresses must be enclosed in square brackets if port for that hos$
# If port is not specified, square brackets for IPv6 addresses are option$
# If this parameter is not specified, active checks are disabled.
# Example: ServerActive=127.0.0.1:20051,zabbix.domain,[::1]:30051,::1,[12$
#
# Mandatory: no
# Default:
ServerActive=127.0.0.1
--------------------------sección separada----------------------------
### Option: UserParameter
# User-defined parameter to monitor. There can be several user-defined pa$
# Format: UserParameter=<key>,<shell command>
# See 'zabbix_agentd' directory for examples.
#
# Mandatory: no
# Default:
# UserParameter=
User_parameters:asterisk.pid, /usr/bin/asterisk -rx 'core show chanels'|grep 'active calls'| cat -d -f 1
|}

El parámetro '''User_parameters''' tiene un formato de este estilo:
{|
|-
|
User_parameters: NombreMedida, comando.
|}

El nombre de la medida se refiere al nombre que demos a la aplicación , no hace falta que exista una aplicación con ese nombre en Zabbix, y el comando , es el comando remoto que tiene que ejecutar el servidor Zabbix. Posiblemente necesita darse permisos para ejecutar el comando y siempre debe devolver un valor (un numero o un tiempo) que el servidor Zabbix puede manejar.
Tras la configuración del fichero, debemos reiniciar el servicio de los agentes.
{|
|-
|
sudo service zabbix-agent restart
|}

===== Scripts del Servidor Zabbix =====
{|
|
|
'''Nota''': No olvidar que en la misma maquina del server Zabbix, debe configurarse como agente de Zabbix.
|}
Después de realizar la [[# Instalación de Zabbix | Instalación de Zabbix ]] correctamente. Se han creado otros ficheros scripts (''scripts propios de '''md'''tel'') que facilitarán la petición del servidor a los agentes activos, para poder parametrizar todos los elementos del negocio que suelen monitorizarse.
Dependiendo de lo que vaya a monitorizarse necesitaremos algún script o todos. Algunos nos informan sobre elementos de negocio, saber si asterisk funciona , monitorizar el CTI (lanzara nc localhost 1111) , controlar el Intz-Nimitz, comprobar si funciona motalsal, ect.

Cada script se exportara a los host, para que pueda facilitar los datos que pide el servidor Zabbix y configurarse.
Por ejemplo,para monitorizar las llamadas en curso del ACD, agentes conectados, agentes desconectados, etc.
Todos los scripts se deben colocar en el directorio /usr/local/sbin con permisos 755, su nombre es parecido a "zabbixSenderXXXXX.pl"
{|
|-
|
ls /usr/local/sbin/ |grep zabbixSender
'''zabbixSenderACDBD.pl'''
'''zabbixSenderACD.pl'''
'''zabbixSenderCTI.pl'''
'''zabbixSender-intz-nimitz.pl'''
'''zabbixSenderMotorSal.pl'''
'''zabbixSenderMyACDSuperv.pl'''
'''zabbixSenderRecordNodo.pl'''
'''zabbixSenderRecordCentral.pl'''
|}

Se crea una tarea programada en linux para poder ejecutarse los scripts, programando el tiempo en que debe ejecutarse.

Si visualizo que "............" aparece:

***** root zabbix

======zabbixSenderACDBD.pl======

'''Uso:''' Obtiene diversos valores por cada cola, estados de agente por cola y estados de agente generales.

'''Ubicación:''' Servidor BDTR.

'''Parámetros:''' Ruta al archivo de configuración (Por ejemplo: ''/etc/MDtel/zabbixSenderACDBD.pconf'')

'''Archivo de configuración:''' zabbixSenderACDBD.pconf

{|
|-
|
'''$db:''' Nombre de la BBDD (normalmente nimitz)
'''$dbHost:''' Dirección IP del servidor de BBDD de TR (normalmente BDTR)
'''$dbPort:''' Puerto MySQL (normalmente 3306)
'''$dbUsuario:''' Usuario MySQL (normalmente nimitz)
'''$dbClave:''' Clave del usuario
'''$sZab:''' Dirección IP del servidor Zabbix
'''$hZab:''' Nombre del host Zabbix (normalmente el nombre de máquina, tal y como se configura en
zabbix_agentd.conf o en el host en la web de Zabbix)
|}

======zabbixSenderACD.pl======

'''Uso:''' Obtener el PID de Asterisk para revisar si se ha reiniciado en caso de que cambie.

'''Ubicación:''' Servidor ACD.

'''Parámetros:''' Ruta al archivo de configuración (Por ejemplo: ''/etc/MDtel/zabbixSenderACD.pconf'').

'''Archivo de configuración:''' zabbixSenderACDBD.pconf.

{|
|-
|
'''$db:''' Nombre de la BBDD (normalmente nimitz)
'''$dbHost:''' Dirección IP del servidor de BBDD de TR (normalmente BDTR)
'''$dbPort:''' Puerto MySQL (normalmente 3306)
'''$dbUsuario:''' Usuario MySQL (normalmente nimitz)
'''$dbClave:''' Clave del usuario
'''$sZab:''' Dirección IP del servidor Zabbix
'''$hZab:''' Nombre del host Zabbix (normalmente el nombre de máquina, tal y como se configura en
zabbix_agentd.conf o en el host en la web de Zabbix)
|}

======zabbixSenderCTI.pl======

'''Uso:''' Obtener estado y los distintos valores de vivait-cti.

'''Ubicación:''' Servidor donde se ejecute vivait-cti. Normalmente el servidor ACD.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

======zabbixSender-intz-nimitz.pl======

'''Uso:''' Obtener estado y los distintos valores de intz-nimitz.

'''Ubicación:''' Servidor donde se ejecute intz-nimitz.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

======zabbixSenderMotorSal.pl======

'''Uso:''' Obtener estado y los distintos valores de motorSal.

'''Ubicación:''' Servidor donde se ejecute motorSal.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

======zabbixSenderMyACDSuperv.pl======

'''Uso:''' Obtener estado y los distintos valores de myAcdSuperv.

'''Ubicación:''' Servidor donde se ejecute myAcdSuperv.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

======zabbixSenderRecordNodo.pl======

'''Uso:''' Obtener estado y los distintos valores de recordNodo.

'''Ubicación:''' Servidor donde se ejecute recordNodo.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

======zabbixSenderRecordCentral.pl======
'''Uso:''' Obtener estado y los distintos valores de recordCentral.

'''Ubicación:''' Servidor donde se ejecute recordCentral.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

A continuación se muestra una tabla resumen de los distintos scripts y sus funcionalidades:

[[Archivo:Zabbix_scripts.png |960px]]

====== Dimensionamiento del servidor (Startpollers) ======
{|
|
|
'''Nota''': EL parámetro StartPollers es un parámetro numérico que forma parte del fichero de configuración
del servidor Zabbix(zabbix_server.conf). Por defecto el servidor Zabbix está configurado para
iniciar con cinco startpollers.
|}

El servidor Zabbix puede hacer peticiones a los agentes de las medidas que necesita o quiere. O en caso contrario los agentes envian en un tiempo determinado la información al servidor. Para recibir todas estas peticiones necesitamos los pollers.

Los poller son los procesos encargados de recibir todas las peticiones de medidas. Aumentaremos su cantidad dependiendo de la necesitad que tengamos. Para ello podemos observar la queue , que es la encargada de almacenar un listado de todas las cosas que están pedidas para medirse y recibirse. SI por ejemplo esta cola (queue) muestra mas de mil medidas seguramente estos pollers sean un cuello de botella y habrá que aumentar su numero.

=====Templates=====

Zabbix cuenta con templates (plantillas) que facilitan la tarea de "Registrar Equipos y Dispositivos" y agregarles métricas; acelerar el despliegue de las tareas de supervisión en un host; aplicar cambios masivos a tareas de supervisión. En '''md'''tel hemos creado plantillas propias que facilitan estos procesos, los cuales necesitaremos [[#Importar templates |importar templates]].

Las plantillas están vinculados directamente a los hosts individuales, por tanto se necesitaran utilizar en cada host.

Automáticamente, cada template rellena por item las aplicaciones, trigers, alarmas,gráficos,... etc.

A continuación, se muestran los distintos bloques de funciones de la instalación en función de cada template:

{| class="wikitable" style="text-align:center;"
|-
! Templates !! Se instalan en general
|-
| DRBD|| SI (si clúster)
|-
| motorSal|| -
|-
| Vivait-Suite ACD|| -
|-
| Vivait-Suite BBDD|| -
|-
| Vivait-Suite Record|| -
|-
| Vivait-Suite GW|| -
|-
| Vivait-Call Asterisk|| -
|-
| Vivait-Call bdCentral|| -
|-
| Vivait-Call bdNodo|| si
|-
| cambiarPerfil_Cal|| -
|-
| Template App Zabbix Server|| -
|-
| Template_OS_Linux*|| si(si no posee ip virtuales de clúster)
|-
| Template_App_MySQL|| si
|-
|}

{| class="wikitable" style="text-align:center;"
|+ '''Dependiendo del tipo de nodo:'''
|-
! Templates !! ACD !! Corporativo/GW
|-
| DRBD|| - || -
|-
| motorSal|| - || -
|-
| Vivait-Suite ACD|| Si || -
|-
| Vivait-Suite BBDD|| - || -
|-
| Vivait-Suite Record|| - || -
|-
| Vivait-Suite GW|| - || Si
|-
| Vivait-Call Asterisk|| - || Si
|-
| Vivait-Call bdCentral|| - || -
|-
| Vivait-Call bdNodo|| - || -
|-
| cambiarPerfil_Cal|| - || -
|-
| Template App Zabbix Server|| - || -
|-
| Template_OS_Linux*|| - || -
|-
| Template_App_MySQL|| - || -
|-
|}

{| class="wikitable" style="text-align:center;"
|+ '''Dependiendo del tipo de Base de dato'''s:
|-
! Templates !! BBDD Tiempo Real !! BBDD Réplica !! BBDD Copia
|-
| DRBD|| - || - || -
|-
| motorSal|| Si(si ACD) || - || -
|-
| Vivait-Suite ACD|| - || - || -
|-
| Vivait-Suite BBDD|| si || si || si
|-
| Vivait-Suite Record|| - || - || -
|-
| Vivait-Suite GW|| - || - || -
|-
| Vivait-Call Asterisk|| - || - || -
|-
| Vivait-Call bdCentral|| si || - || -
|-
| Vivait-Call bdNodo|| - || - || -
|-
| cambiarPerfil_Cal|| - || - || -
|-
| Template App Zabbix Server|| - || - || -
|-
| Template_OS_Linux*|| - || - || -
|-
| Template_App_MySQL|| - || - || -
|-
|}

{| class="wikitable" style="text-align:center;"
|-
! Templates !! Administración
|-
| DRBD|| -
|-
| motorSal|| -
|-
| Vivait-Suite ACD|| -
|-
| Vivait-Suite BBDD|| -
|-
| Vivait-Suite Record|| -
|-
| Vivait-Suite GW|| -
|-
| Vivait-Call Asterisk|| -
|-
| Vivait-Call bdCentral|| -
|-
| Vivait-Call bdNodo|| -
|-
| cambiarPerfil_Cal||SI (si posee servidor calendarios)
|-
| Template App Zabbix Server|| -
|-
| Template_OS_Linux*|| -
|-
| Template_App_MySQL|| -
|-
|}

{| class="wikitable" style="text-align:center;"
|-
! Templates !! Servidor de grabaciones
|-
| DRBD|| -
|-
| motorSal|| -
|-
| Vivait-Suite ACD|| -
|-
| Vivait-Suite BBDD|| -
|-
| Vivait-Suite Record|| Si
|-
| Vivait-Suite GW|| -
|-
| Vivait-Call Asterisk|| -
|-
| Vivait-Call bdCentral|| -
|-
| Vivait-Call bdNodo|| -
|-
| cambiarPerfil_Cal||-
|-
| Template App Zabbix Server|| -
|-
| Template_OS_Linux*|| -
|-
| Template_App_MySQL|| -
|-
|}

{| class="wikitable" style="text-align:center;"
|+ '''Monitorización'''
|-
! Templates !! General !! Contact Center
|-
| DRBD|| - || -
|-
| motorSal|| - || -
|-
| Vivait-Suite ACD|| - || -
|-
| Vivait-Suite BBDD|| - || -
|-
| Vivait-Suite Record|| - || -
|-
| Vivait-Suite GW|| - || -
|-
| Vivait-Call Asterisk|| - || -
|-
| Vivait-Call bdCentral|| - || -
|-
| Vivait-Call bdNodo|| - || -
|-
| cambiarPerfil_Cal|| - || -
|-
| Template App Zabbix Server|| si || -
|-
| Template_OS_Linux*|| - || -
|-
| Template_App_MySQL|| - || -
|-
|}

* El template OS Linux tiene asociado el Template App Zabbix Agent.
Una '''base de datos unificada''' es una base de datos de tiempo real junto a una base de datos de replica

====== Importar templates======

Las plantillas propias de '''md'''tel se encuentran en la ruta "'''/usr/src/nimitz/archivos'''" y empiezan con el nombre de "TemplateXXX.xml".

{|
|-
|
ls /usr/src/nimitz/archivos | grep Template
'''Template DRBD.xml'''
'''Template motorSal.xml'''
'''Templates Vivait-Suite_GW.xml'''
'''Templates Vivait-Suite.xml'''
'''Template Vivait-Call Asterisk.xml'''
'''Template Vivait-Call bdCentral.xml'''
'''Template Vivait-Call bdNodo.xml'''
'''Template Vivait-Call cambiarPerfil_Cal.xml'''

|}

La importación se realizara una vez a través de la web, no hace falta desde el servidor Zabbix, puede ser en cualquier computadora con acceso a la interfaz web de Zabbix.

[[File:ImportarTemplates.png|750px|center]]

Hay opciones varias opciones a elegir para importación de templates, pero podemos dejar por defecto las señaladas y pulsar el botón "import".

===Configuración para un primer funcionamiento de Zabbix===
Se describe una básica configuracion de Zabbix para cualquier equipo que utilice Windows o linux. Pues mediante la definición de hosts, items, triggers y acciones, Zabbix permite efectuar un monitoreo efectivo de plataformas IT heterogéneas.

====Configuración de los equipost (host) para la monitorización====
{|
|-
|
'''Nota''': Tenga en cuenta que debe de estar previamente configurado el agente Zabbix del
dispositivo a ser monitorizado apuntando a la IP del "Servidor Zabbix".
|}
Existen dos tipos de host:
* '''Host físico''': donde la dirección de red que registramos en Zabbix, corresponde al dispositivo que deseamos monitorizar.
* '''Host virtual''': es una dirección IP virtual, que puede relacionarse con un servidor Web, clusters, etc.

[[File:CreacionHost.png|750px|center]]

Las opciones basicas para configurar un host son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center ;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Host Name'''
| | Definir un nombre para el host.
||Se puede utilizar números, letras, espacios y guiones bajos están permitidos.
|-
| font-weight: bold;" | '''Visible Name'''
| | Identificar con un nombre, la maquina a la que se refiere el host.
||Si no tiene valor, se mostrara como nombre "Host Name".
|-
| font-weight: bold;" | '''Groups'''
| | Seleccionar al grupo de host que pertence.Seleccione uno o varios grupos de la caja derecha.
|| Los valores que puede seleccionar por defecto:
Discoverd hosts.

Switches.

Templates.

Templates MDtel.

Zabbix servers.

Linux Servers.

Hypervisors.

Virtual machines.

O crear uno nuevo en '''New group'''.

|-
| font-weight: bold;" | '''Agent interfaces'''
| |Se recomienda usar una dirección IP, en vez de un nombre de la maquina para resolver por un servidor de DNS que puede fallar.
| | 10050 por defecto
|}

Cuando termine, haga clic en nel boton "Save". Su nuevo "Host" debe ser visible en la lista de "Host registrados".Despues el zabbix, intentara configurarse el zabbix para conectarse a la IP.... cada x tiempo hace un barrido.

===== Comprobación de disponibilidad del host=====
Para saber si todo esta bien debemos ver la Z de disponibilidad.

[[File:EstadosZHost.png|750px|center]]

Indicacion de los colores del icono Z:

* Si el icono Z en la columna de disponibilidad es de color rojo, indica que hay un error en la comunicación - mueva el cursor del ratón sobre él para ver el mensaje de error.

* Si el icono es gris, significa que esta en proceso de comunicación con el "Agente Zabbix". Compruebe que el servidor Zabbix está en marcha, y pruebe a actualizar la página más tarde. El tiempo estimado para revisar si existe problemas es de 5 minutos.

* Si el icono es verde, esta funcionando correctamente.

====Indicar que plantilla(template) tendra el host [opcional]====
Tras [[#Importar templates |importar templates]] nos dirigimos al host ya configurado, y en su pestaña de templates pulsamos "add" y añadimos la plantilla/s adecuadas.

====Asignar items al host ====
{|
|-
|
'''Nota''':Un host puede tener un ITEM sin necesitad de tener template.
|}

Todos lo ITEMS se agrupan por HOST, esto significa que cada HOST tiene sus propios "Módulos que recogen datos del Host". Para agregar un nuevo módulo vamos a "Configuration → Hosts" y localizamos el "Host" al cual queremos agregarle un nuevo "Item".

[[File:CrearItemEjemplo.png|750px|center]]

Parametros o campos a rellenar para una configuración básica :

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center ;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Name'''
| | Definir un nombre para el item. Este nombre va a ser nuestro identificador para todas la gestiones en donde lo involucremos como el caso de Triggers.
||
|-
| font-weight: bold;" | '''Type'''
|| Indicar de que entidad queremos recibir informacion.
||Puede ser al "Agente Zabbix" o a el Hardware como impresoras, switch o routers.
|-
| font-weight: bold;" | '''Key'''
| | los "Items" utilizan "Key" que son parámetros de Zabbix. Los "Key" nos permiten indicar específicamente que tipo de información vamos a solicitara a la entidad. Se puede considerar también como el nombre de alguna aplicación.
||
|-
| font-weight: bold;" | '''host interface'''
| |Es la direccion de red del servidor zabbix (puede ser uno o mas)
| |
||
|-
| font-weight: bold;" | '''Units'''
| |Es la dirección de red del servidor zabbix (puede ser uno o mas)
| |
|-
| font-weight: bold;" | '''Type of information'''
| |Tipo de unidades con el que mostrar Zabbix el valor segundos, minutos, euros,....
||
|}

Cuando termine, haga clic en Guardar. El nuevo elemento debe aparecer en la ITEMLIST.
Para mas informacion [[http://entation/1.8/manual/config/items#zabbix_agent. ver documentación Zabbix]]

===== Ver la información recolectada por el item =====
{|
|-
|
'''Nota:''' Normalmente para ver la información lo encontraremos en "Monitoring → Latest data",luego
clic en el signo "+" en "other" siempre que no pertenezca a una aplicación.
En caso contrario, estará bajo el nombre de la aplicación.
|}

Después de definir el "Item" vamos a revisar la información que esta recolectando. . La información comenzará a ser recolectada según el tiempo que le indicamos en el "Item".

[[File:VerInfoITEM.png|750px|center]]

La espera para recibir la información varía dependiendo del tiempo de recolección del item, la mayoría suele ser aproximadamente al minuto de generar el "Item". Zabbix le ofrece la opción de visualizar la información en forma gráfica (sencilla). En el "Item" en lista haga clic en la columna "History - Graph".

[[File:VIsualGraficaValorItem.png|center|750px]]
Si en un caso usted no observa información le recomendamos:

* Ingrese al "Item" y revise que la información del "Key" este igual al ejemplo "system.cpu.load"
* Verifique que el agente este funcionando en el "Servidor a ser monitoreado" y que "El Servidor recolector Zabbix" este funcionando.
* El icono "Z" en el host debe estar en color verde.
* Asegure que esta monitoreando el servidor que le agregó este "Item"

====Configurar los Triggers para los host====
A partir de la información que captura los agentes , el servidor de Zabbix comienza a efectuar la recolección de estos items en la base de datos. Con esto se tiene un registro histórico de tales mediciones, que pueden ser tan simples como un simple ping hasta datos de uso de disco, memoria, cpu, etc.
A partir de los datos que se reciben de los agentes lo que sigue es definir y configurar Triggers, que son evaluaciones que hace Zabix de estos datos para determinar la existencia de un Problema en un dispositivo.
{|
|-
|
Nota: Un trigger necesita una accion, que indica que hacer cuando se activa el trigger.
|}

Un trigger(disparador) es un tipo de reacción ante unas medidas, como un disparador en el que si pasa algo se activa. Los Trigger en Zabbix son módulos que creamos a uno o múltiples "Items" para evaluar o comparar los valores recolectados por los "Items" con condiciones que nosotros definamos. Las condiciones son de tipo aritmético y lógico.

Para configurar un "Trigger o Disparador" seleccionamos "Configuration → Hosts" localizamos el "Host" de ejemplo que creamos y luego hacemos clic en "Trigger", después haga clic en "Create Trigger".

Parametros o campos a rellenar para una configuración básica :

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center ;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Name'''
| | Definir un nombre para el trigger. Este nombre va a ser nuestro identificador para todas la gestiones en donde lo involucremos como el caso de los eventos.
||
|-
| font-weight: bold;" | '''Expression'''
|| Hay que indicar para que medida se crea (item) y sus funciones con los parametros adecuados. '''''Recomendación usar expression constructor que pedirá siempre al crearlo, para que item es y sus funciones...'''''
||Ejemplo: {New host:system.cpu.load.avg(180)}>2
|-
| font-weight: bold;" | '''Key'''
| | los "Items" utilizan "Key" que son parámetros de Zabbix. Los "Key" nos permiten indicar específicamente que tipo de información vamos a solicitara a la entidad. Se puede considerar tambien como el nombre de alguna aplicacion.
||
|-
| font-weight: bold;" | '''Descripción'''
| | Una descripción breve sobre el trigger.
||
|-
| font-weight: bold;" | '''Severity'''
| | everidad distinguida por colores,
|| No classified
Information
Warning
Average
High
Disaster
|}

===== Comprobar el estado del trigger =====
Podemos ver el estado del "Trigger" en "Monitoring → Triggers".El color en caso de que se active depende de la severidad definida. Por ejemplo, si el "Trigger" esta en color verde indica que el resultado de la métrica se mantiene por debajo de la condición que indicamos. Por el contrario si el resultado esta "sobre lo indicado" su color sera rojo.

[[File:EstadoTrigger.png|center|750px]]

====Asociar un Action al trigger====

Una action(acción) sirve para configurar un mensaje de alerta o una accion para Zabbix, ante un problema. Hay varias formas de gestionar un problema a través de una acción:

# A través de mensajes simples, alertando al instante.
# Escalar los mensajes hacia el jefe y/o otros grupos.
# Ejecución de commandos remotos.
# Notificaciones repetidas hasta que se resuelve el problema.
# Notificaciones y comandos retardados.
# Escenario complejo, la combinación de todo lo anterior.

Para crear una configuración en "Configuration-Actions". La explicación esta en la [[ https://www.zabbix.com/documentation/2.0/manual/config/notifications/action documentación de Zabbix]].
-->

== Integraciones con servicios externos ==

=== Presencia con Openfire ===
'''''VIVA'''''it se integra con servidor XMPP Openfire en su versión 3.10.2 (última probada)

Además del servidor, es necesario instalar un plugin de integración con asterisk 13, denominado "asterisk IM", versión 1.4.1

La instalación del servidor Openfire es una instalación estándar, realizada de paquete

La instalación del plugin es un "jar" que se carga desde la pagina de plugins de openfire

Con esto conseguiremos comunicar asterisk y OPenfire de manera que:
*Los estados telefónicos de una extensión '''''VIVA'''''it se reflejen en Openfire
*Poder marcar desde los clientes de IM instalados en los puestos
*Ver en el cliente llamadas entrantes al teléfono

-----

'''<big>Enlaces de interes:</big>'''

[http://www.igniterealtime.org/projects/openfire/ Página proyecto openfire]

[https://community.igniterealtime.org/thread/56076 Página proyecto "asterisk IM"]

=== Reuniones virtuales con Openmeetings ===
'''OpenMeetings''' es un sistema de vídeo web-conferencia en tiempo real. Usando recursos como audio (micrófono), vídeo (cámara web), posibilidad de subir y convertir presentaciones (en PDF , PPT o ODP que se convierten a Flash), compartición de la pantalla de tu ordenador, o pizarra digital compartida, panel de administración, posibilidad de grabar las sesiones… y completo soporte multiplataforma, es decir, que aparte de poder grabar las sesiones, se puede compartir un escritorio también desde una máquina Linux.

Para instalar '''OpenMettings''' debe seguir el [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manuales_de_instalaci%C3%B3n#Instalaci.C3.B3n_de_Openmeetings | manual de Instalación de Openmeetings]]

[[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:VIVAit Suite]]

Manual de operación plataforma VIVAit

2018-04-23T10:40:49Z

Imatarrubias: /* Watchdog */

{| class="wikitable"
|-
! '''Producto: '''!! '''''VIVA'''''it Call
'''''VIVA'''''it Suite
|-
|}

== Introducción ==

En este documento se describe la arquitectura general de la plataforma '''''VIVA'''''it, detallando aquellos procesos principales que componen cada uno de los elementos del sistema, y sus principales elementos de diagnóstico
Quedan fuera del ámbito de este documento:
* Uso de aplicación de agente ('''''VIVA'''''it Desk)
* Uso de aplicación de supervisor ('''''VIVA'''''it Supervisor), incluyendo sus módulos autónomos ('''''VIVA'''''it reporting, '''''VIVA'''''it Tracker)
* Uso de portal de administración
* Uso de portal de traceo de llamadas y agentes ('''''VIVA'''''it Tracker web)
* Uso de portal de monitorización zabbix

== Arquitectura ==

[[Archivo:Arquitectura plataforma VIVAit.png|center|700px]]

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

== Descripción de los elementos, diagnósticos y operaciones ==
Las siguientes tablas definen los principales elementos software de la plataforma '''''VIVA'''''it, que son detallados en apartados siguientes:

{| class="wikitable"
|-
|+ <big>'''Nivel de sistema operativo'''</big>
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
| Ubuntu Server LTS 64 bits || Uno por servidor|| ||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
|| Actualmente (Oct-2015) 14.04
Bajo proyecto puede cambiarse
|-
| Almacenamiento de grabaciones|| Uno por sistema|| Almacenamiento de las grabaciones, ya sean de entorno corporativo o de contact center||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
|| Típicamente un espacio grande de almacenamiento proporcionado por el cliente y que se monta como un sistema de archivos local en los servidores de la plataforma
Pueden existir sistemas secundarios de almacenamiento de grabaciones
|-
|-
|}

{| class="wikitable"
|-
|+ <big>'''Nivel de conmutación de voz'''</big>
|-
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
|Asterisk 1.4.24 by MDtel||Uno por servidor ACD||Núcleo de conmutación de voz basado en Asterisk 1.4 y modificado por MDtel||'''''VIVA'''''it Suite||Fuertemente modificado por MDtel
En el futuro migrará a Asterisk 13 Certified
|-
|Dialplan ACD by MDtel||Uno por servidor ACD||Configuración de voz||'''''VIVA'''''it Suite||En el futuro se unificará con corporativa
|-
|Asterisk 13 Certified by MDtel||Uno por servidor corporativo/gateway||Núcleo de conmutación de voz basado en Asterisk 13 y modificado por MDtel||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Actualmente asterisk estándar (10/15)
La instalación contempla descargar de la red el más actualizado, siempre CERTIFIED"
|-
|Dialplan corporativo||Uno por servidor corporativo/gateway||Configuración de voz||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||En el futuro se unificará con ACD
|-
|}

{| class="wikitable"
|-
|+ <big>'''Nivel de base de datos'''</big>
|-
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
|MySQL 5.5||Donde haya BBDD de cualquier tipo (incluso zabbix)||Motor de Base de Datos||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||A efectos prácticos va a ser en todos los servidores con casi total seguridad
|-
|BBDD tiempo real||Una por sistema||Base de Datos sobre la que trabaja todo el entorno de tiempo real||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
|-
|BBDD réplica||Una por sistema multinodo||Base de Datos para acceso a información de reporting…y similar||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Bajo proyecto puede existir más de una
En el nodo en el que exista réplica existirá además copia (excepto nodo ACD)
|-
|BBDD copia||Uno por servidor corporativo/gateway||Copias de tablas de configuración para respaldo de la misma||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Local en cada nodo
Los nodos de ACD actualmente no trabajan con copia; en caso de fallo de BBDD TR se usa el modo emergencia
|-
|}

{| class="wikitable"
|-
|+ <big>'''Nivel de procesos ''VIVA''it'''</big>
|-
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
|Intz-Nimitz||Donde haya una BBDD de tiempo real o copia||Interfaz entre el dialplan y la base de datos||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||No donde haya BBDD de réplica
Sistemas grandes pueden contemplar mas de un intz-nimitz central"
|-
|vivait-cti||Uno por servidor ACD||Interfaz entre '''''VIVA'''''it Desk, supervisor y el manager de asterisk||'''''VIVA'''''it Suite||
|-
|myAcdSuperv||Uno por servidor ACD||Recopilador de datos de asterisk y actualiza en la BBDD
Genera llamadas en el marcador
||'''''VIVA'''''it Suite
||
|-
|motorSal||Uno por sistema con ACD||Motor de marcador saliente automático||'''''VIVA'''''it Suite||Solo si hay marcación saliente
Junto a la BBDD de tiempo real
|-
|recordCentral||Uno por sistema||Servidor de grabaciones, se conectan los agentes a el||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Se arrancan varias instancias en función del número de nodos
Debe instalarse en un servidor que tenga el almacenamiento de grabaciones en su sistema de archivos
|-
|recordNodo||Uno por servidor corporativo/gateway||Agente de grabación||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|bdCentral||Uno, en el nodo con la BBDD de tiempo real||Genera la base de datos que se copiará para respaldo a otros nodos||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|bdNodo||En cada nodo con BBDD de copia||Recoge la base de datos del servidor central con el objeto de tener el respaldo||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|Actualizador||Uno por sistema con ACD||Se encarga de proporcionar las versiones actualizadas de las aplicaciones de puesto de trabajo||'''''VIVA'''''it Suite||En el mismo servidor que el portal de administración
|-
|phoneProv-tftp||Uno por sistema||Se encarga del aprovisionamiento masivo de terminales||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||En instalaciones grandes habrá más de uno, quizás uno por sede grande; depende de la infraestructura de DHCP
|-
|borraregistrosnimitz||||||||
|-
|Mover grabaciones a nube||||||||
|-
|}

{| class="wikitable"
|-
|+ <big>'''Administración'''</big>
|-
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
|Tomcat 7||Uno por servidor con portales||Servidor de aplicaciones JAVA||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
|-
|Portal de administración ||Uno por sistema||Portal de administración del sistema||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Bajo proyecto puede existir más de uno
|-
|Portal usuario||Uno por sistema||Portal de usuario, para acceso a buzones, su configuración||'''''VIVA'''''it Call||Bajo proyecto puede existir más de uno
|-
|Tracker web||Uno por sistema||Portal de seguimiento de llamadas||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Debe instalarse en un servidor que tenga los ficheros de grabación montados en su sistema de archivos
Ligado a recordCentral
Bajo proyecto puede existir más de uno
|-
|Monitor||Uno por sistema||Portal de monitores de pared de Call Center||'''''VIVA'''''it Suite||Bajo proyecto puede existir más de uno
|-
|Apache||Uno por servidor de calendarios||Servidor de portales WEB||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|Servidor de calendarios||Uno por sistema||Aloja calendarios para su uso en diferentes entornos de NIMITZ||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Bajo proyecto puede existir más de uno
|-
|}

{| class="wikitable"
|-
|+ <big>'''Monitorización'''</big>
|-
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
|Servidor zabbix||Uno por instalación||Monitorización técnica y de negocio||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Bajo proyecto puede existir más de uno
Tipicamente irá o en BBDD replica o en nodo de gestión en instalaciones grandes
|-
|Templates zabbix||Uno por instalación||Adaptaciones específicas||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|Agente Zabbix||Uno por servidor||Agente de monitorización||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
||Scripts monitorización zabbix||Uno por servidor||Agente de monitorización||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|}
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

===Versiones de módulos===

{| class="wikitable"
|-
! Módulo !! VSuite
V.3.10
! VSuite
V.3.2.0
! VSuite
V.3.3.0
! VIVAit V.3.0.0
(VSuite 3.4+VCall3.0)
! VIVAit V.3.1.0
(VSuite 3.5+VCall3.1)
|-
| Sistema Operativo || || || ||
|| Ubuntu 14.0.4
Server 64 Kb
|-
| Asterisk || 1.4 || 1.4 || 1.4 || 1.4 Nodo ACD
13 resto nodos
|| 1.4 Nodo ACD
13 resto nodos
|-
| Asterisk ACD '''(VS)''' || || || || 3.3.1 || 3.4.1
|-
| Dialplan ACD '''(VS)''' || || || || || 3.5.0
|-
| Asterisk Corp '''(C)''' || || || || 3.3.4 || 3.4.4
|-
| Asterisk Cisco '''(VC)''' || || || || 3.3.4 || 3.4.4
|-
| Dialplan Corp '''(C)''' || || || || 3.3.1 || 3.5.0
|-
| Lazarus común '''(VS)''' || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0 || 3.5.0
|-
| BD '''(C)''' || 3.2.0 || 3.4.0 || 3.5.0 || 3.6.0 || 3.8.0
|-
| Generaconf '''(C)''' || 3.0.0 || 3.0.0 || 3.2.0 || 3.4.0 || 3.5.0
|-
| Instalador '''(C)''' || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0 || 3.5.0
|-
| Intz-nimitz '''(C)''' || 2.6.0 || 3.0.1 || 3.0.3 || 3.4.1 || 3.4.2
|-
| recordgwd '''(C)''' || 1.3.0 || 1.3.0 || 3.1.0 || ----- || -----
|-
| recordNodo '''(C)''' || ----- || ----- || ----- || 4.0.0 || 4.0.0
|-
| recordprocesad '''(C)''' || 1.2.0 ||1.2.0|| 3.0.0 || ----- || -----
|-
| recordCentral '''(C)''' || ----- || ----- || -----|| 4.0.0 || 4.0.1
|-
| MyACDSuperv '''(VS)''' || 5.2.0 || 5.3.0 || 5.3.0 || 5.3.2 || 5.3.2
|-
| Motorsal '''(VS)''' || 1.4.0 || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0
|-
| Vivait-cti '''(VS)''' || 3.0.0 || 3.0.1 || 3.0.1 || 3.0.1 || 3.0.2
|-
| Multimonitorweb '''(VS)''' || 3.0.1 || 3.0.2 || 3.1.0 || 3.1.0 || 3.2.0
|-
| Portal de administración '''(C)''' || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0 || 3.5.0
|-
| Tracker Web '''(C)''' || 3.0.2 || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0
|-
| VIVA supervisor '''(VS)''' || 3.0.0 || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0
|-
| Tracker windows '''(C)''' || 3.0.0 || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0
|-
| VIVA report '''(VS)''' || 1.2.0 || 3.1.0 || 3.2.0 || 3.2.2 || 3.3.0
|-
| VIVA desk '''(VS)''' || 3.0.2 || 3.2.0 || 3.3.0 || 3.4.0 || 3.5.0
|-
| VIVA designer '''(VS)''' || 1.0.23 || 3.0.1 || 3.1.0 || 3.1.0 || 3.2.0
|-
| Preview '''(VS)''' || 1.0.18 || 3.2.0 || 3.3.0 || 3.4.0 || 3.5.0
|-
| Phone_prov '''(C)''' || ------ || ------ || 3.0.1 || 3.0.3 || 3.0.3
|-
| Portal usuario '''(VC)''' || ------ || ------ || ------ || 3.0.0 || 3.1.0
|}

'''(C)''': Módulo común

'''(VC)''': Módulo de VIVAit Call

'''(VS)''': Módulo de VIVAit Suite

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Sistema Operativo ===
Los sistemas operativos de nuestra plataforma se corresponden a las versiones de Ubuntu Server LTS , ya que son las versiones estables, con un soporte continuado y mas estables a actualizaciones desde la salida Ubuntu 14.04.1. En concreto el sistema operativo utilizado para la plataforma '''''VIVA'''''it es Ubuntu Server 14.04.4 LTS. Para más información https://help.ubuntu.com/lts/serverguide/index.html.

[[Archivo:Ubuntu Kernel Release Schedule.png|750px]]

==== Funcionamiento en cluster ====

Un clúster es un grupo de múltiples ordenadores unidos mediante una red de alta velocidad, de tal forma que el conjunto es visto como un único ordenador.

De un clúster se espera que presente combinaciones de los siguientes servicios:

# Alto rendimiento
# Alta disponibilidad
# Balanceo de carga
# Escalabilidad

Tal y como esta definido el cluster de MDtel, este comprueba conectividad con la otra máquina que lo forma y con un punto de confianza. Si la máquina no tiene conectividad con la otra y si con el punto de confianza es que el servidor está vivo, mientas que si no tengo conectividad ni con la otra máquina ni con el punto de confianza es que el muerto soy yo, por lo que balanceo.

Por lo que las máquinas balancean en los casos siguientes:

* Todo lo que tenga que ver con la red, es decir, caída de la tarjeta de red, apagado de la máquina, corte en la red..

Y no balancea en los siguientes:

* No balancea en los demás casos, es decir, todo lo que tenga que ver con procesos de una máquina (caída asterisk, base de datos, intz-nimitz)

El funcionamiento en cluster se basa en:

* Heartbeat: IP flotante entre las dos máquinas que componen el cluster; típicamente este "latido" entre máquinas se realizará mediante conexión directa con cable cruzado para asegurar que no existan problemas de comunicaciones tales como retardo, pérdida de paquetes, etc en este latido y pueda ser causa de un balanceo inadecuado.

{| class="wikitable"
|-
| '''Nota 17-11-2015:''' Se ha realizado en un cliente un cluster distribuido, con dos servidores en diferentes sedes, realizando el heartbeat mediante enlace Gigabit. Si bien la solución no está validada por desarrollo, se está observando el funcionamiento.
|}

* DRBD se encargar de mantener una serie de carpetas totalmente replicadas entre los dos nodos; dichas carpetas son:

El cluster es <big>'''activo/pasivo'''</big>; la máquina activa posee la IP flotante y tiene arrancados los servicios.

==== Configuración del cluster ====
Para montar un cluster de asterisk partimos de la siguiente situación inicial:
* Dos maquinas con '''''VIVA'''''it Call 3.0 instalado.
* El driver bonding de Interfaces de Red en Ubuntu Server.

Los pasos a seguir para la configuración en el Ubuntu Server son los siguientes:
* Instalar ifenslave:
:{|
|-
|
aptitude install ifenslave.
|}
: Finalizada la instalación, comprobamos que la instalación de Bonding se ha configurado para empezar desde el arranque del sistema operativo desde el fichero '''/etc/modules''':
:{|
|-
| vi /etc/modules
# /etc/modules: kernel modules to load at boot time.
#
# This file contains the names of kernel modules that should be loaded
# at boot time, one per line. Lines beginning with "#" are ignored.
# Parameters can be specified after the module name.
lp
rtc
bonding
|}

* Crear o editar el archivo llamado '''/etc/modprobe.d/bonding.conf''' y añadir la siguiente linea en negrita:
:{|
|-
|
echo "alias bond0 bonding"> /etc/modprobe.d/bonding.conf
|}

* Editar el fichero /etc/network/interfaces y añadir lo que esta en negrita:
:{|
|-
|
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).
# The loopback network interface
auto lo
iface lo inet loopback

'''# Bonding'''

'''#em1 ip manual y esclavo en el "bond0" NIC'''
'''auto em1'''
'''iface em1 inet manual'''
'''bond-master bond0'''
'''bond-primary em0'''

'''#em2 ídem, creando así un vínculo de enlace 2.'''
'''auto em2'''
'''iface em2 inet manual'''
'''bond-master bond0'''
'''auto bond0'''
'''iface bond0 inet static'''
'''address 10.255.255.11'''
'''netmask 255.255.255.0'''
'''gateway 10.255.255.254'''
'''bond-mode active-backup'''
'''bond-miimon 100'''
'''bond-slaves none'''

'''# em3 replica entre servidores'''
'''auto em3'''
'''iface em3 inet static'''
'''address 10.255.254.10'''
'''netmask 255.255.255.0'''

'''# em4 gestion'''
'''auto em4'''
'''iface em4 inet static'''
'''address 172.17.47.255'''
'''netmask 255.255.0.0'''
|}

* Reiniciamos el sistema para que el kernel tome los cambios.

* Comprobación que en las dos maquinas el archivo '''/etc/host''' contenga el los nombre de las dos maquinas a vincular. En el ejemplo el archivo en ambas maquinas es:

:{|
|-
|
127.0.0.1 localhost

10.255.255.11 vivaitcall-CL-UAH-1

10.255.255.12 vivaitcall-CL-UAH-2

10.255.255.10 vivaitcall-CL-UAH

10.255.255.10 BDTR

10.255.254.10 vivaitcall-CL-UAH-1-em3

10.255.254.11 vivaitcall-CL-UAH-2-em3
|}

* Creamos dos particiones iguales en ambos ordenadores , usando el comando '''parted'''.
:{|
|-
|
root@vivaitcall-CL-UAH-1:~# '''parted /dev/sda'''
GNU Parted 2.3
Using /dev/sda
Welcome to GNU Parted! Type 'help' to view a list of commands.
(parted) p free
Model: HP LOGICAL VOLUME (scsi)
Disk /dev/sda: 1000GB
Sector size (logical/physical): 512B/512B
Partition Table: gpt
Number Start End Size File system Name Flags
17,4kB 262kB 245kB Free Space

1 262kB 1000MB 1000MB fat32 boot
2 1000MB 201GB 200GB ext4
3 201GB 217GB 16,0GB linux-swap(v1)
4 217GB 237GB 20,0GB ext4
237GB 1000GB 763GB Free Space

(parted) mkpart primary 237GB 1000GB
(parted) p free
Model: HP LOGICAL VOLUME (scsi)
Disk /dev/sda: 1000GB
Sector size (logical/physical): 512B/512B
Partition Table: gpt
Number Start End Size File system Name Flags
17,4kB 262kB 245kB Free Space
1 262kB 1000MB 1000MB fat32 boot
2 1000MB 201GB 200GB ext4
3 201GB 217GB 16,0GB linux-swap(v1)
4 217GB 237GB 20,0GB ext4
5 237GB 1000GB 763GB primary  No File System como ext4
1000GB 1000GB 204kB Free Space
(parted)quit
mkfs.ext4 /dev/sda5
root@vivaitcall-CL-UAH-1:~# '''parted /dev/sda'''
GNU Parted 2.3
Using /dev/sda
Welcome to GNU Parted! Type 'help' to view a list of commands.
(parted) p free
Model: HP LOGICAL VOLUME (scsi)
Disk /dev/sda: 1000GB
Sector size (logical/physical): 512B/512B
Partition Table: gpt
Number Start End Size File system Name Flags
17,4kB 262kB 245kB Free Space
1 262kB 1000MB 1000MB fat32 boot
2 1000MB 201GB 200GB ext4
3 201GB 217GB 16,0GB linux-swap(v1)
4 217GB 237GB 20,0GB ext4
5 237GB 1000GB 763GB primary
1000GB 1000GB 204kB Free Space
(parted) rm 5
(parted) mkpart primary 237GB 1000GB
(parted) p free
Model: HP LOGICAL VOLUME (scsi)
Disk /dev/sda: 1000GB
Sector size (logical/physical): 512B/512B
Partition Table: gpt

Number Start End Size File system Name Flags
17,4kB 262kB 245kB Free Space
1 262kB 1000MB 1000MB fat32 boot
2 1000MB 201GB 200GB ext4
3 201GB 217GB 16,0GB linux-swap(v1)
4 217GB 237GB 20,0GB ext4
5 237GB 1000GB 763GB ext4 primary  Si File Sytem ext4
1000GB 1000GB 204kB Free Space
(parted)quit
|}

* Instalar los paquetes necesarios para el drbd. '''En Ubuntu server 14.04 ya está instalado.'''
:{|
|-
|
aptitude install drbd8-utils
aptitude update (si no instala el drbd8-utils actualizar)
aptitude install drbd8-utils (volver a lanzar)
|}

* Creamos el archivo '''/etc/drbd.conf''' en ambas maquinas:
:{|
|-
|
# You can find an example in /usr/share/doc/drbd.../drbd.conf.example
include "drbd.d/global_common.conf";
include "drbd.d/*.res";
resource MDcluster {
protocol C;
on vivaitcall-CL-UAH-1 {
device /dev/drbd0;
disk /dev/sda5;
address 10.255.254.10:7788;
meta-disk internal;
}
on vivaitcall-CL-UAH-2 {
device /dev/drbd0;
disk /dev/sda5;
address 10.255.254.11:7788;
meta-disk internal;
}
disk {
on-io-error detach;
}
net {
max-buffers 2048;
ko-count 4;
}
syncer {
rate 100M;
al-extents 257;
}
startup {
wfc-timeout 0;
degr-wfc-timeout 120;
}
}
|}

* Reiniciamos el sistema para que el kernel tome los cambios.
* Inicializamos el recurso, para ello primero deberemos crear los recursos DRBD teclearemos en ambas maquinas. Desde /etc.
:{|
|-
|
drbdadm create-md MDcluster (no y yes )
|}

:Si tenemos algún problema porque ya exista sistema de ficheros.
:{|
|-
|
dd if=/dev/zero of=/dev/sda5 bs=1M count=128
drbdadm create-md MDcluster (no y yes )
|}

* Reiniciamos ambas maquinas para que su kernel tome los cambios.
* Levantamos el servicio del DRBD en ambos servidores (nos preguntara que si queremos enviar los datos a los desarrolladores de drbd) tecleando no, no se envían.
:{|
|-
|
service drbd start
/etc/init.d/drbd start
|}

: Ahora ambas maquinas son secundarias.
: Indicar cual de las dos maquinas usaremos como primaria, por tanto en la maquina elegida habra que ejecutar:
:{|
|-
|
drbdadm -- --overwrite-data-of-peer primary all (en una máquina)
:'''Nota:''' La ip virtual que va a estar asignada a la maquina activa es 172.25.129.70.

|}

: Podemos teclear el comando '''''cat''''' para ver si esta sincronizando y su progreso:

:{|
|-
|
cat /proc/drbd
'''Nota:''' El servicio DRBD aparecera como '''''Primary/Secondary''''' si ejecutamos en el primario ;
y aparecerá ''''Secondary/Primary'''' si lo ejecutamos en el secundario. 
|}

* Instalación de los script de arranque:
:{|
|-
|
update-rc.d -f drbd remove (en las dos maquinas)
update-rc.d drbd start 13 2 3 4 5 . stop 87 0 1 6 . (en las dos máquinas)
|}
* Seleccionar la fuente de sincronización.
:Formateamos un disco de la maquina que queramos que funcione como fuente del servicio DRBD, para evitar conflictos:
:{|
|-
|
mkfs.ext4 /dev/drbd0
|}
: Creamos el directorio sobre el que vamos a montar el disco, en ambas maquinas.
:{|
|-
|
mkdir /HDcluster
|}

: Creamos un archivo dentro '''''/HDcluster''''' de que se verá solo cuando el disco no está montado en ambas maquinas.
:{|
|-
|
touch sinMontar
'''Nota:''' Este archivo nos puede servir para monitorizar mediante zabbix, nagios, ... que el disco no está montado.
|}

: En una de las maquinas montamos el disco (desde fuera del directorio HDcluster)
:{|
|-
|
mount /dev/drbd0 /HDcluster
|}
* Procedemos a mover todos los datos que necesitemos en este disco y a crear accesos directos, los directorios que vamos a mover son los siguientes:
:{|
|-
|
/etc/asterisk
/var/lib/asterisk
/usr/lib/asterisk
/usr/spool/asterisk
/var/lib/mysql
/var/tftp/
|}
: El procedimiento que vamos a seguir es el siguiente, en el primer ordenador:
:{|
|-
|
'''Cd /HDcluster'''
'''tar -zcvf etc-asterisk.tgz /etc/asterisk'''
'''tar -zxvf etc-asterisk.tgz'''
'''rm -rf /etc/asterisk'''
'''ln -s /HDcluster/etc/asterisk /etc/asterisk'''
'''tar -zcvf var-lib-asterisk.tgz /var/lib/asterisk'''
'''tar -zxvf var-lib-asterisk.tgz'''
'''rm -rf /var/lib/asterisk'''
'''ln -s /HDcluster/var/lib/asterisk /var/lib/asterisk'''
'''tar -zcvf usr-lib-asterisk.tgz /usr/lib/asterisk'''
'''tar -zxvf usr-lib-asterisk.tgz'''
'''rm -rf /usr/lib/asterisk'''
'''ln -s /HDcluster/usr/lib/asterisk /usr/lib/asterisk'''
'''tar -zcvf var-spool-asterisk.tgz /var/spool/asterisk'''
'''tar -zxvf var-spool-asterisk.tgz'''
'''rm -rf /var/spool/asterisk'''
'''ln -s /HDcluster/var/spool/asterisk /var/spool/asterisk'''
'''tar -zcvf var-lib-mysql.tgz /var/lib/mysql'''
'''tar -zxvf var-lib-mysql.tgz'''
'''rm -rf /var/lib/mysql'''
'''ln -s /HDcluster/var/lib/mysql /var/lib/mysql'''
'''tar -zcvf var-lib-phoneprov-tftp.tgz /var/lib/phoneprov-tftp/'''
'''tar -zxvf var-lib-phoneprov-tftp.tgz'''
'''rm -rf /var/lib/phoneprov-tftp/'''
'''ln -s /HDcluster/var/lib/phoneprov-tftp /var/lib/phoneprov-tftp'''
|}

: En la segunda maquina debemos borrar los directorios y crear los accesos directos.
:{|
|-
|
'''rm -rf /etc/asterisk'''
'''ln -s /HDcluster/etc/asterisk /etc/asterisk'''
'''rm -rf /var/lib/asterisk'''
'''ln -s /HDcluster/var/lib/asterisk /var/lib/asterisk'''
'''rm -rf /usr/lib/asterisk'''
'''ln -s /HDcluster/usr/lib/asterisk /usr/lib/asterisk'''
'''rm -rf /var/spool/asterisk'''
'''ln -s /HDcluster/var/spool/asterisk /var/spool/asterisk'''
'''rm -rf /var/lib/mysql'''
'''ln -s /HDcluster/var/lib/mysql /var/lib/mysql'''
'''rm -rf /var/lib/phoneprov-tftp'''
'''ln -s /HDcluster/var/lib/phoneprov-tftp /var/lib/phoneprov-tftp'''
|}

* Configurar heartbeat para las dos maquinas.
: Instalamos heartbeat en las dos maquinas. '''En UBUNTU Server 14.04 ya está instalado.'''
:{|
|-
|
aptitude install heartbeat
|}
: Debemos modificar 3 ficheros en cada una de las maquinas, estos se encuentran en '''/etc/ha.d'''. El primer fichero a modificar es '''''ha.cf.''''':
:: En la maquina ''vivaitcall-CL-UAH-1'' es:
::{|
|-
|
root@vivaitcall-CL-UAH-1:~# cat /etc/ha.d/ha.cf
'''# Explicacion en /usr/share/doc/heartbeat/ha.cf.gz'''

'''udpport 694'''
'''baud 19200'''
'''auto_failback off'''
'''use_logd yes'''
'''crm no'''

'''# Temporizaciones en segs'''
'''logfacility local0'''
'''keepalive 2'''
'''deadtime 8'''
'''warntime 16'''
'''initdead 64'''
'''deadping 6'''

'''#ucast bond0 vivaitcall-CL-UAH-1'''
'''ucast bond0 vivaitcall-CL-UAH-2'''

'''#ucast em3 vivaitcall-CL-UAH-1-em3'''
'''ucast em3 vivaitcall-CL-UAH-2-em3'''

'''#Ping a puerta de enlace,gw1,gw2,gw3,gw4'''
'''ping_group red_local 10.255.255.12'''

'''respawn hacluster /usr/lib/heartbeat/ipfail'''
'''apiauth ipfail gid=haclient uid=hacluster'''

'''node vivaitcall-CL-UAH-1'''
'''node vivaitcall-CL-UAH-2'''
|}

:: Y en la maquina ''vivaitcall-CL-palacio-2'' es:
::{|
|-
|
root@vivaitcall-CL-UAH-1:~# cat /etc/ha.d/ha.cf
'''# Explicacion en /usr/share/doc/heartbeat/ha.cf.gz'''

'''udpport 694'''
'''baud 19200'''
'''auto_failback off'''
'''use_logd yes'''
'''crm no'''

'''# Temporizaciones en segs'''
'''logfacility local0'''
'''keepalive 2'''
'''deadtime 8'''
'''warntime 16'''
'''initdead 64'''
'''deadping 6'''

'''ucast bond0 vivaitcall-CL-UAH-1'''
'''#ucast bond0 vivaitcall-CL-UAH-2'''

'''ucast em3 vivaitcall-CL-UAH-1-em3'''
'''#ucast em3 vivaitcall-CL-UAH-2-em3'''

'''#Ping a puerta de enlace gw1 gw2 gw3 gw4'''
'''ping_group red_local 10.255.255.12'''

'''respawn hacluster /usr/lib/heartbeat/ipfail'''
'''apiauth ipfail gid=haclient uid=hacluster'''

'''node vivaitcall-CL-UAH-1'''
'''node vivaitcall-CL-UAH-2'''
|}
::'''Nota:''' El parámetro '''auto_failback''' se utiliza para indicar si queremos que al recuperarse una maquina adquiera los recursos sobre los que tiene prioridad.
:El segundo fichero es '''''authkeys''''',, este fichero es el mismo en ambas maquinas:
:{|
|-
|
chmod 600 authkeys '''(importante)'''
auth 1
1 sha1 claveSecretaATope
|}

:El tercer fichero '''haresources''', donde especificaremos en las dos maquinas que deben apuntar a la maquina que queremos que tenga prioridad en la adquisición de los recursos, este fichero es el mismo en las dos maquinas:
:{|
|-
|
MÁQUINA 1 -> vivaitcall-CL-palacio-1 hb_mdtel
MÁQUINA 2-> vivaitcall-CL-palacio-1 hb_mdtel
|}
: Copiaremos en el directorio '''/etc/ha.d/resource.d/''' los scripts de arranque con permisos 755 (lo podemos hacer mediante WINSCP). Los scripts se encuentran en '''''C:\Documents and Settings\javier.gutierrez.MDTEL\Mis documentos\Centrales\Asterisk\Cluster\scripts'''''.
:{|
|-
|
chmod 755 hb_catalina
chmod 755 hb_mdtel
chmod 755 hb_mdtel_firewall
|}
: Deberemos editar el archivo '''hb_mdtel'''
:{|
|-
|
(IP flotante a.b.c.d./mask) 10.255.255.10
CAD_IP_FLOTA=10.255.255.10/24/bond0
|}
:

* Paramos el proceso '''myAcdSuperv'''.
:{|
|-
|
mv /etc/rc2.d/S02myAcdSuperv s02myAcdSuperv
|}
* Reiniciamos ambas maquinas para que su kernel tome los cambios.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== Comprobación de buen funcionamiento del cluster ====
* La maquina activa tiene que tener en HDcluster montado el disco con todos sus directorios y la maquina inactiva no (tenemos que ver el archivo que hemos creado "sinMontar").
* La ip virtual tiene que estar en la maquina activa (ifconfig) y no tiene que estar en la inactiva.
* El asterisk tiene que estar arrancado en la maquina activa y parado en la inactiva.
* Tecleando la ip de la maquina activa en un navegador debemos acceder al portal de vivait-call y en la inactiva no debe de estar activo.
* Para cambiar el cluster manualmente podemos utilizar los siguientes comandos:
:{|
|-
|
/usr/share/heartbeat/hb_takeover
|}
: La maquina desde la que se ejecuta se convierte en la maquina activa
:{|
|-
|
/usr/share/heartbeat/hb_standby
|}
: La maquina desde la que se ejecuta deja de ser la maquina activa

==== Notas para MySQL ====
Si mysql es parte del cluster tenemos que tener en cuenta dos cosas:

* El archivo '''/etc/mysql/debían.cnf''' contiene una clave que debe ser igual en ambas maquinas y debe ser la clave de la máquina de donde cojamos la base de datos. 
:{|
|-
|
# Automatically generated for Debian scripts. DO NOT TOUCH!
[client]
host = localhost
user = debian-sys-maint
password = AI6AdPtnhLUrNm1S
socket = /var/run/mysqld/mysqld.sock
[mysql_upgrade]
user = debian-sys-maint
password = AI6AdPtnhLUrNm1S
socket = /var/run/mysqld/mysqld.sock
basedir = /usr
|} 
* El archivo '''/etc/apparmor.d/usr.sbin.mysqld''' contiene donde pueden estar ubicados los archivos de mysql, al cambiar su ubicación y poner un enlace directo en /var/lib/mysql si no modificamos este archivo mysql no arrancara al no tener la nueva ubicación entre sus localizaciones permitidas. Este es un ejemplo de las líneas que debemos añadir. 
:{|
|-
|
/var/run/mysqld/mysqld.sock w, (copiar después de esta linea)

#//!!
/HDcluster/var/lib/mysql/ r,
/HDcluster/var/lib/mysql/** rwk,
#//!!
|}

==== Notas de desincronización ====
EL servicio del DRBD esta iniciado pero al teclear el comando cat /proc/drbd para ver si esta sincronizando se presenta "'''primary/unknown" y/o secondary/unknown''' ".
* En el nodo primary
:{|
|-
|
drbdadm connect all
|}

* En el nodo secondary
:{|
|-
|
drbdadm disconnect all
drbdadm -- --discard-my-data connect all
|}

==== Adaptar red a cliente ====
Para adaptar la red de los equipos al entorno del cliente hay que editar los siguientes ficheros:
{|
|-
|
/etc/network/interfaces
/etc/resolv.conf
/etc/hosts
/etc/ha.d/resource.d/hb_mdtel
/etc/ha.d/ha.cf
- TFTP:
/etc/inetd.conf (IP del cluster)

|}
Tras la modificaciones oportunas, se debe reiniciar las dos máquinas para cargar las nuevas configuraciones.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Matriz de conmutación ===

Encontramos dos diferentes núcleos de conmutación en la plataforma VIVAit:

* Para los nodos de procesamiento ACD el núcleo de conmutación es asterisk 1.4 RSP con fuertes modificaciones realizadas por MDtel en determinados módulos (queues, chan_spy entre otros)

* Para los nodos que realizan funcionalidad de gateway y/o procesamiento de telefonía corporativa, se utiliza como núcleo de conmutación asterisk 13, versión certified
https://wiki.asterisk.org/wiki/display/AST/Asterisk+13+Documentation

==== Modificaciones realizadas sobre Asterisk 13 certified 2 ====

===== Archivos añadidos por '''MD'''tel =====
Los archivos añadidos son los siguientes:

* '''apps/app_ucid.c'''
* '''apps/app_cli.c'''
* '''apps/app_crash.c'''
* '''apps/app_mdintz.c'''
* '''apps/app_mdintz.exports.in'''
* '''include/asterisk/mdintz.h'''
* '''include/asterisk/ucid.h'''
* '''res/res_mdcal.c'''

'''→ apps/app_mdintz.exports.in '''

Este archivo sirve para la exportación de funciones del mdintz para el uso por aplicaciones externas

===== Modificaciones de archivos =====

Los archivos modificados por '''MD'''tel son los mostrados a continuación:

* '''apps/app_mixmonitor.c'''
* '''res/res_calendar_caldav.c'''
* '''contrib/scripts/safe_asterisk'''
* '''contrib/init.d/rc.debian.asterisk'''
* '''channels/sig_pri.c'''
* '''channels/chan_sip.c'''

'''→ main/audiohook.c''' 

'''audiohook.c''' ha sido modificado para solucionar un crash de asterisk al utilizar en el mixmonitor las opciónes r y t

'''→ app_crash.c '''

Esta nueva aplicación es sólo compatible con '''Asterisk 13'''.

La documentación de la misma se encuentra en el comando: '''"core show application Crash"'''

Esta nueva aplicación ''permite añadir'' al plan de pruebas:

* Generación de una parada de asterisk.
* Verificación de su impacto. Por ejemplo, no deben cortarse las llamadas en curso, si así está previsto por la topología.
* Correcta generación de los "core", comprobando que funciona "backtrace" (bt).

'''Nota.-''' Esta aplicación no debería estar presente en una instalación de '''Asterisk 13'''

'''→ app_mdintz.c y mdintz.h''' 

Esta aplicación sirve como interfaz a entornos (funcionalidades) creados por MDtel

Para mas información consultar la página de [[MDintz|MDintz]].

Las rutas de estos archivos son las siguientes:

'''apps/app_mdintz.c''' 
'''include/asterisk/mdintz.h '''

'''app_mdintz.c''' :

'''app_mdintz.c''' orientada al proceso de enrutamiento a implementar en ''intz-nimitz.''

El archivo '''.c''' es casi igual para asterisk 1.4.24 y asterisk 13.
'''Nota.-''' Cuando se compila para asterisk 13, es necesario comentar la línea que pone '''"#define ASTERISK_OLD".'''

Los cambios implementados son:

* Unificación de código entre las versiones de asterisk
* Nuevo comando "qry"
* Posible resolución de "Mal write" en intz-nimitz (a verificar)

En cuanto al nuevo comando, el formato es:

'''mdintz qry <nHostFijo> <entorno> <servicio> <par1>...<parN>'''

Permite interrogar a un servidor de igual modo que hace el dialplan con '''fines de diagnóstico'''. La única diferencia es que se ha añadido el parámetro '''"nHostFijo"''' que puede tomar como valor '''"*"''' (lo que solicita una interrogación secuencial a todos los servidores definidos, igual a la funcionalidad del dialplan) ó '''"0"''' a '''"3"''' (que solicita un interrogación dirigida el host indicado como hostN, y sólo a él, en archivo de configuración).

Para instalarlo, es necesario copiar:

* '''asterisk/apps/app_mdintz.c'''
* '''asterisk/include/asterisk/mdintz.h'''
* En asterisk 1.4.24 conviene asegurar que se ha actualizado '''"asterisk/apps/app_queue.o"''' y '''"asterisk/apps/app_queue.so"'''
* Luego '''"make", "make install"''' y module '''"unload/load"''' (mejor "stop now" y start)

'''→ scripts y rc.debian.asterisk'''

cambiado contrib/scripts por el modificado por MDtel 
cambiado contrib/init.d/rc.debian.asterisk por el modificado por MDtel

'''→ Carpeta mp3 añadida al directorio addons'''

La carpeta mp3 en addons permite la reproducción desde el diaplan de los mensajes en mp3. En make menuselect hay que marcar el format_mp3 y app_mp3 e instalar el paquete mpg123 de ubuntu

'''→ sig_pri.c'''

Modificado para enviar/recibir el ucid en un primario qsig

Para que se envie el ucis tenemos que habilitar el envio de facilidades en el chan_dahdi.conf

facilityenable = yes

'''→ init.d''' 

* Uno de los archivos modificados ha sido '''init.d''', se encuentra en la ruta: '''/etc/init.d/asterisk'''. La modificación realizada es la siguiente:

{|style="background-color:#ffffcc;" class="wikitable"
|-
|-
| SAFE_ASTEISK=/usr/sbin/safe_asterisk 
if [ -x $SAFE_ASTERISK ] ; then 
:# //!! wkw 
:DAEMON=$SAFE_ASTERISK 
fi
|}



'''→ safe-asterisk'''
* Se encuentra en la siguiente ruta:'''/usr/sbin/safe-asterisk''' .En este archivo se ha modificado MAXFILES=32768

'''→ default'''

* Este fichero podemos encontrarlo en: '''/etc/default/asterisk'''. La finalidad de la modificación de este fichero es poder correr como usuario Asterisk, grupo asterisk y generar cores (descomentar línea)
Las modificaciones realizadas han sido:

{|style="background-color:#ffffcc;" class="wikitable"
|-
|-
| AST_USER="asterisk"
AST_GROUP="asterisk"

COREDUMP=yes
|}

===== Nueva función de asterisk: app_cli.so =====

Esta función permite ejecutar desde el '''dialplan''' un comando de línea de consola de '''asterisk (CLI).''' Su primer uso (y esperamos que no último) será para lanzar los '''notify''' que los teléfonos necesitan para el ''reaprovisionamiento'' desde el portal o desde la facilidad de movilidad de usuario.

Básicamente ejecuta un comando y devuelve su salida. Utiliza un archivo intermedio que puede ser:

* '''/dev/null''' si el campo se deja vacío, por tanto, no se puede recuperar la salida.
* '''TEMP''', en cuyo caso se crea un archivo temporal que se borra antes de finalizar la ejecución de la función.
* Un nombre de fichero que es responsabilidad del dialplan el borrarlo cuando proceda.

Para instalarlo basta copiar '''apps/app_cli.c''' en el directorio ''' "apps" ''' de los fuentes y luego ejecutar '''"make" y "make install".'''

A continuación se pasa el resultado de '''"core show function CLI" '''

'''[Synopsis]'''

Lanza un comando CLI desde dialplan

'''[Description]''' 
- CLI(nomArchSal,cmd) 
- Si 'nomArchSal' está vacio, se usa '/dev/null' y no se recupera resultado 
- Si 'nomArchSal'=TEMP, Se crea un archivo temporal que se borra al final 
- En otro caso, se crea el archivo y no se borra

'''[Syntax]''' 
CLI(nomArchSal,cmd)

'''[Arguments]''' 
'''nomArchSal'''
Archivo de salida (si se omite, /dev/null)
'''cmd'''
Comando a ejecutar via CLI

==== Dialplan ====

El Dialplan podría considerarse la columna vertebral del sistema ''Asterisk''.

Es una colección ordenada de acciones que se llevan a cabo cuando un usuario marca una serie de números. Hace la función de una tabla de enrutamiento de llamadas.

Todas las configuraciones generales de Asterisk están accesibles en la ruta '''/etc/asterisk'''

'''CONCEPTOS BÁSICOS'''

♦ '''EXTENSIONES'''

Una extensión es una marcación en el teclado de un teléfono. Dicha configuración podemos encontrarla en el archivo '''extensions.conf'''

Por ejemplo, un usuario podría marcar “3001” en su teléfono, y eso sería una extensión. También podría marcar un número de teléfono nacional, como por ejemplo “915881000”, y también sería una extensión.

En Asterisk pueden definirse también extensiones como texto, por tanto no debemos relacionar las extensiones únicamente con números.

Algunas reglas que sería interesante conocer serían las siguientes:

{| class="wikitable"
|-
! '''Regla''' !! '''Descripción'''
|-
| '''X''' || Cualquier cifra de 0 a 9
|-
|'''Z'''||Cualquier cifra de 1 a 9
|-
|'''N'''||Cualquier cifra de 2 a 9
|-
|'''[x-y]'''||Cualquier cifra de "x" a "y"
|-
|'''[xyz]'''|| Las cifras "x", "y" o "z"
|-
|'''.'''||Una o más repeticiones del símbolo anterior
|-
|'''!'''||Cero o más repeticiones del símbolo anterior
|}

Estas reglas son necesarias a la hora de definir por ejemplo todos los números de teléfono posibles en España

♦ '''PRIORIDADES'''

En lenguaje scripting, las acciones se van ejecutando de arriba a abajo en orden. En cambio, en Asterisk, el orden en el que se ejecutan las acciones es el indicado mediante números.
Primero se ejecutará la acción 1, luego la 2...así sucesivamente.

Es decir no basta con definir las acciones que se llevarán a cabo, también debemos indicar el orden en el que se llevarán a cabo.

♦ '''CONTEXTOS'''

Es mecanismo que nos permite variar el comportamiento del sistema en función del número que se marque. Su misión es aumentar la seguridad del sistema ofreciendo servicios diferenciados en función del usuario.

La sintaxis típica es el nombre del contexto englobado entre corchetes [nombre_contexto]. Si un dispositivo no tiene un contexto definido se redirige directamente al contexto por defecto.

Los ficheros que conforman el Dialplan se clasifican en:

* '''Generales'''
* '''Particulares'''
* '''Web'''

{| class="wikitable"
|-
! '''Fichero''' !! '''Función'''
|-
| '''Generales''' || Se encuentran los ficheros de propios de MDtel y Asterisk. Es importante remarcar que estos ficheros NO pueden ser modificados por el usuario.
|-
|'''Particular'''||Estos ficheros son los únicos que puede modificar el usuario
|-
|'''Web'''|| Se encierran aquí los archivos generados automáticamente por la plataforma, a través del portal
|}

En función del nodo en el que estemos trabajando, encontraremos dos tipos de dialplan:

'''* Dialplan ACD''' --> Dialplan que aplica a nodos ACD

'''* Dialplan corporativa''' --> Dialplan que aplica a nodos de corporativa o gateways (ya sean de corporativa o ACD)

A continuación se muestran las tablas con los ficheros correspondientes a cada Dialplan.

{| border="1" align="center" bgcolor="FloralWhite"
|+ '''Ficheros de configuración Dialplan Corporativo'''
| '''GENERALES'''
| '''PARTICULARES'''
| '''WEB'''
|-
| ext_Grabaciones.conf ext_InicioLlamada.conf ext_InicioLlamada_Dahdi.conf ext_InicioLlamada_ExtSIP.conf ext_InicioLlamada_TrunkSIP.conf ext_MARCAR_ColaCentralita.conf ext_MARCAR_ColaCentralita_Dial.conf ext_MARCAR_Cola.conf ext_MARCAR_Cola_Dial.conf ext_MARCAR.conf ext_MARCAR_DejarMensaje.conf ext_MARCAR_DejarMensaje_Dial.conf ext_MARCAR_Extension.conf ext_MARCAR_Extension_Dial.conf ext_MARCAR_Externo.conf ext_MARCAR_Externo_Dial.conf ext_MARCAR_Facilidad.conf ext_MARCAR_Facilidad_Dial.conf ext_MARCAR_Facilidad_nimitz.conf ext_MARCAR_Interno.conf ext_MARCAR_LeerMensaje.conf ext_MARCAR_LeerMensaje_Dial.conf ext_MARCAR_Nodo.conf ext_MARCAR_Nodo_Dial.conf ext_MARCAR_SalasConf.conf ext_MARCAR_SalasConf_Dial.conf ext_MARCAR_Servicios.conf ext_MARCAR_VDN.conf MARCAR_VDN_Dial.conf ext_MDtel.conf ext_MDtel_Var.conf ext_Subrutinas_AnchoBanda.conf ext_Subrutinas_BD.conf ext_Subrutinas_BD_Facilidad.conf ext_Subrutinas_BD_Facilidad.conf ext_Subrutinas_Colas.conf ext_Subrutinas.conf ext_Subrutinas_Enrutamiento.conf ext_Subrutinas_finLlamada.conf ext_Subrutinas_Grabacion.conf ext_Subrutinas_nimitz.conf ext_Subrutinas_Varias.conf ext_Subscribe.conf ext_Transfer.conf ext_Transfer_ExtSIP.conf ext_Transfer_TrunkInternos.conf ext_TrunkInternos.conf ext_TrunkInternos_Dial.conf sip_Estatico.conf sip_GENCUST.conf sip_notify.conf queues.conf queues_GENERAL.conf queues_PLANTILLACOLAS.conf 

| ext_Enrutador_Particular.conf ext_InicioLlamada_Dahdi_Particular.conf ext_InicioLlamada_ExtSIP_Particular.conf ext_InicioLlamada_Particular.conf ext_InicioLlamada_TrunkSIP_Particular.conf ext_MARCAR_Extension_Particular.conf ext_MARCAR_Externo_Particular.conf ext_MARCAR_Facilidad_Particular.conf ext_MARCAR_VDN_Particular.conf ext_MDtel_Particular.conf ext_TrunkInternos_Particular.conf 

|asterisk_WEB.conf ext_MDtel_WEB.conf sip_trunkExt_WEB.conf sip_trunkInt_WEB.conf sip_trunk_WEB.conf sip_WEB.conf queues_WEB.conf
|}

{| border="1" align="center" bgcolor="FloralWhite"
|+ '''Ficheros de configuración Dialplan ACD'''
| '''GENERALES'''
| '''PARTICULARES'''
| '''WEB'''
|-
| ext_Enrutador.conf ext_Grabaciones.conf ext_InicioLlamada.conf ext_InicioLlamada_CTI.conf ext_InicioLlamada_Dahdi.conf ext_InicioLlamada_ExtSIP.conf ext_InicioLlamada_Marcador.conf ext_InicioLlamada_TrunkSIP.conf ext_MARCAR_ColaCentralita.conf ext_MARCAR_ColaCentralita_Dial.conf ext_MARCAR_Cola.conf ext_MARCAR_Cola_Dial.conf ext_MARCAR.conf ext_MARCAR_DejarMensaje.conf ext_MARCAR_DejarMensaje_Dial.conf ext_MARCAR_Extension.conf ext_MARCAR_Extension_Dial.conf ext_MARCAR_Externo.conf ext_MARCAR_Externo_Dial.conf ext_MARCAR_Facilidad.conf ext_MARCAR_Facilidad_Dial.conf ext_MARCAR_Facilidad_nimitz.conf ext_MARCAR_LeerMensaje.conf ext_MARCAR_LeerMensaje_Dial.conf ext_MARCAR_Nodo.conf ext_MARCAR_Nodo_Dial.conf ext_MARCAR_SalasConf.conf ext_MARCAR_SalasConf_Dial.conf ext_MARCAR_Servicios.conf ext_MARCAR_VDN.conf ext_MARCAR_VDN_Dial.conf ext_MDtel.conf ext_MDtel_Var.conf ext_Subrutinas_AnchoBanda.conf ext_Subrutinas_BD.conf ext_Subrutinas_BD_Facilidad.conf ext_Subrutinas_Colas.conf ext_Subrutinas.conf ext_Subrutinas_Enrutamiento.conf ext_Subrutinas_finLlamada.conf ext_Subrutinas_Grabacion.conf ext_Subrutinas_nimitz.conf ext_Subrutinas_Varias.conf ext_Subscribe.conf ext_Transfer.conf ext_Transfer_ExtSIP.conf ext_Transfer_TrunkInternos.conf ext_TrunkInternos.conf ext_TrunkInternos_Dial.conf queues_GENERAL.conf queues_PLANTILLACOLAS.conf sip_GENCUST.conf sip_GENERAL.conf sip_notify.conf sip_PLANTILLAEXT.conf sip_supervision.conf 

| ext_Enrutador_Particular.conf ext_InicioLlamada_CTI_Particular.conf ext_InicioLlamada_Dahdi_Particular.conf ext_InicioLlamada_ExtSIP_Particular.conf ext_InicioLlamada_Marcador_Particular.conf ext_InicioLlamada_Particular.conf. ext_InicioLlamada_TrunkSIP_Particular.conf ext_MARCAR_Externo_Particular.conf ext_MARCAR_Facilidad_Particular.conf ext_MARCAR_VDN_Particular.conf ext_MDtel_Particular.conf ext_TrunkInternos_Particular.conf 

|asterisk_WEB.conf ext_MDtel_WEB.conf queues_WEB.conf sip_trunkInt_WEB.conf sip_WEB.conf 
|}
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Servicios networking ===
Son muy importantes las configuraciones adecuadas de los servicios de:

* '''NTP''': El sistema en global ha de estar sincronizado; todos los servidores y puestos de trabajo (en el caso de ''VIVA''it Suite) han de estar perfectamente sincronizados; los servidores de la plataforma se sincronizarán con el NTP del cliente; si el cliente no tiene NTP será necesario que un servidor de la plataforma se sincronice con un NTP externo y este sea el servidor para el resto de la plataforma

* '''DNS''': La configuración de DNS de la plataforma será coherente con el resto de la plataforma IT del cliente

* '''DHCP''': Es necesario coordinar con el cliente la asignación de direcciones para los diferentes elementos de la plataforma '''''VIVA'''''it, fundamentalmente para terminales telefónicos; en este caso además será necesario activa la opción 66 que permitirá definir el servidor TFTP del que los terminales cogerán sus ficheros de aprovisionamiento

=== Bases de datos (BBDD)===

La base de datos del sistema se basa en el motor de base de datos MySQL, es un elemento crítico del sistema, en el que insertan y del que obtiene mucha información múltiples procesos.
Muchas comunicaciones entre procesos se realizan vía Base de Datos (tabla COM_COMUNICADOS). Pueden existir distintas instancias de base de datos que explicadas en las siguientes secciones, nuestra base de datos tiene la siguiente estructura: [[Base de datos|Información completa de la BD]]. Podéis ampliar más información en https://dev.mysql.com/doc/

==== BBDD Tiempo Real ====
En la base de datos de tiempo real insertan información todos los procesos del sistema, y se realizan los cambios en configuración utilizando como herramienta el portal de administración y '''''VIVA'''''it Supervisor

De la base de datos de tiempo real leen los procesos que requieren información, y las aplicaciones:
*'''''VIVA'''''it Supervisor (para reporting de tiempo real)
*PanelWeb
*Datos de sesión de '''''VIVA'''''it Desk
*Monitorización Zabbix
* Otros

El portal de administración se encarga de escribir las configuraciones añadidas o modificadas en la base de datos

Para cuando la BDTR contienen un número masivo de datos, existe un script que borra el contenido de ciertas tablas de la BD (tablas DAT_) dejando solamente datos de un cierto número de días configurable.
Este script se llama borraRegistrosNimitz.pl; para más información consultar el apartado de Howto's.

'''Por defecto, a partir de la versión 3.2.0 de la plataforma, los registros se mantedrán 2 meses.'''

==== BBDD Réplica ====
A efectos de asegurar las prestaciones del sistema, se establece una réplica de la base de datos, sincronizada con la de tiempo real; los procesos y aplicaciones pesados, que realicen consultas a las base de datos que puedan comprometer las prestaciones del sistema atacan a la réplica y nunca a la base de datos de tiempo real

Es posible que en instalaciones pequeñas no exista réplica, en cuyo caso se establece una base de datos unificada sobre la de tiempo real, en la que se añaden índices y procedimientos almacenados que típicamente residen en la de réplica.

Es posible establecer tantas réplicas como sean necesarias si diferentes procesos pesados se penalizan en exceso, si bien una implantación tipo contemplará una sola

Algunos procesos que utilizan la base de datos de réplica son:
*'''''VIVA'''''it Reporting
*'''''VIVA'''''it Tracker
*Histórico en tiempo real de '''''VIVA'''''it Supervisor

'''IMPORTANTE: Ningún proceso, programa, aplicación, etc. escribe en la base de datos de réplica; tan solo se extrae información'''

==== BBDD de copia ====
A efectos de asegurar el funcionamiento y como medida de contingencia ante un problema puntual de comunicación con la BD de tiempo real, en cada nodo disponemos de una BD de copia local. Posiblemente de un tamaño menor que la BD de tiempo real, dependiendo de cuanto tiempo pase hasta la próxima sincronización con la base de tiempo real.Esta base de datos llamada '''nimitzCopia'''.

Solo entrara en funcionamiento,cuando se produzca el problema mencionado, dejando acceder a los datos y poder dar servicio a la empresa mientras se soluciona el problema.

===== Backup y restore =====

Se utilizan dos script, para realizar la copia de seguridad y restaurar en la base de datos de copia local que son:

* El proceso '''bdCentral.sh''' que es el encargado de realizar la copia de seguridad. Tiene un archivo de configuración bdCentral.conf. En este archivo hay un parámetro (IGNORE_TABLAS) que indica las tablas de las que NO se realizará copia de seguridad. Toda tabla que no se indique formará parte de la copia de seguridad. Vuelca los resultados en /var/log/bdCentral.log
* El proceso '''bdNodo.sh''' que es el encargado de descargar la copia de seguridad y restaurarla en local. Tiene un archivo de configuración bdNodo.conf. Vuelca los resultados en /var/log/bdNodo.log. El fichero de backup se copia mediante el usuario sincroniza, que deberá poder acceder sin contraseña al servidor donde reside la copia.

En caso de producirse algún error en alguno de los procesos, marcarán dicho error en el log con una línea que comienza con la cadena "*ERROR".

==== Diagnósticos y operaciones sobre bases de datos ====

=====Comprobación que una base de datos está arrancada=====
Para comprobar si la base de datos está arrancada debemos poner en el terminal : '''ps aux | grep mysql'''

Si la base de datos está arrancada y funcionando correctamente se nos mostrará en el terminal:
[[Archivo:Base_Datos_bien.png‎ |500px|center]]

Por el contrario, si la base de datos presenta algun problema el mensaje mostrado será:

[[Archivo:Base_datos_mal.png |center]]

=====Comprobación que la base de datos de réplica está sincronizada con la base de datos de tiempo real.=====

Si se necesita verificar que la base de réplica está sincronizada con la base de datos en tiempo real basta con acudir al comando : '''show slave status\G'''.

Una vez introducido veremos:

[[Archivo:Replica.png |980px|center]]

Comandos importantes, desde dentro consola de Mysql:

'''show master status''': Realizado desde el master
'''show slave status''': Realizado desde el esclavo; el valor "seconds behind master" nos indica
cuanto está retrasada la réplica con respecto a la base de datos de tiempo real. Si el valor de este campo es elevado nos indicará
que la base de datos real con la réplica no estará sincronizada, por tanto, nos interesa que este valor sea lo más pequeño posible.
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Procesos propios ===

==== bdCentral ====

El proceso ''bdCentral.sh'' es el encargado de realizar la copia de seguridad. Tiene un archivo de configuración ''bdCentral.conf'' el cual puede encontrarse en la ruta '''/etc/MDtel/bdCentral.conf'''. En este archivo hay un parámetro (IGNORE_TABLAS) que indica las tablas de las que NO se realizará copia de seguridad. Toda tabla que no se indique formará parte de la copia de seguridad. Vuelca los resultados en /var/log/bdCentral.log

En caso de producirse algún error, se marcará dicho error en el log con una línea que comienza con la cadena "*ERROR".

Para ejecutar bdCentral:
bdCentral.sh /etc/MDtel/bdCentral.conf

Estos procesos se ejecutan automáticamente. Para ello está copiado el fichero bdCentral a /etc/cron.d.

Por defecto la programación vienen comentada por lo que será necesario activarlo.

Para que se roten los logs hay que copiar el fichero bdCentral.logrotate a /etc/logrotate.d (como bdCentral)
La ruta donde se encuentran los logs es la siguiente: '''/var/log/myAcdSuperv.log'''


[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== bdNodo ====
El proceso bdNodo.sh es el encargado de descargar la copia de seguridad y restaurarla en local. Tiene un archivo de configuración bdNodo.conf, este archivo puede encontrarse en la ruta '''/etc/MDtel/bdNodo.conf.''' Vuelca los resultados en /var/log/bdNodo.log. El fichero de backup se copia mediante el usuario sincroniza, que deberá poder acceder sin contraseña al servidor donde reside la copia.

En caso de producirse algún error, se marcará dicho error en el log con una línea que comienza con la cadena "*ERROR".

Para ejecutar bdNodo:

bdNodo.sh /etc/MDtel/bdNodo.conf

Estos procesos se ejecutan automáticamente. Para ello está copiado el fichero bdNodo a /etc/cron.d.

Por defecto la programación vienen comentada por lo que será necesario activarlo.

Para que se roten los logs hay que copiar el fichero bdNodo.logrotate a /etc/logrotate.d (como bdNodo)

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== Intz-Nimitz ====

Permite integrar procesos de asterisk (del dialplan) con la base de datos; por ejemplo es el que graba segmentos, inspecciona donde esta registrado un agente…etc. La estabilidad de este proceso es importante para el funcionamiento del sistema, si bien las llamadas entran en caso de no estar disponible.

Para mas información consultar la página de [[intz-nimitz|intz-nimitz]].

Desde un SSH ejecuta el comando “nc ip_maquina 1115”

'''root@vivait-acd:~# nc localhost 1115'''
intz-nimitz sis ver='V02.6' inic='20140401 110116' alarmas=21 ultAlar='20140414 171244'
intz-nimitz gmp msj=942/1024 buf=1024/1024 tarea=16/102
intz-nimitz tmp uptime=1816550 (21d 0h 35m 50s)
intz-nimitz vic identif='cms1' entorno='nimitz' conx=0/128 numConx=1018(0)
intz-nimitz mys curro=80/0/0/0 soli=1012(0) soliErr=6(0) soliEncol=0(0/0)
intz-nimitz cache colas=128/10/0/0 vdn=128/8/0/0 usuExten=10/0/0/0

Donde cada parámetro monitorizado indica:
{| class="wikitable"
|-
!Parámetro!!Descripción
|-
|sis/ver||Versión del proceso
|-
|sis/inic||Fecha de de arranque del proceso
|-
|Sis/alarmas||Alarmas desde arranque
|-
|Sis/ultAlar||Fecha de última alarma
|-
|Gmp/msj||
|-
|Gmp/buf||
|-
|Gmp/tarea||
|-
|Tmp/uptime||Tiempo que lleva el servicio activo
|-
|Vic/identif||Etiqueta de identificación del servicio
|-
|Vic/entorno||Entorno de base de datos
|-
|Vic/conx||Conexiones activas/conexiones máximas
|-
|Vic/numConx||Conexiones totales (último minuto)
|-
|Mys/curro||Número de hilos contra la base de datos
|-
|Mys/soli||Conexiones solicitadas (último minuto)
|-
|Mys/soliErr||Conexiones solicitadas con error (último minuto)
|-
|Mys/soliEncol||Conexiones encoladas
|-
|Cache/cola|| Colas monitorizadas/
|-
|Cache/vdn||VDN’s monitorizados
|-
|Cache/usuExten||
|-
|}

Como complemento a los diagnósticos:

* Podremos examinar el fichero de configuración del proceso en '''/etc/MDtel/intz-nimitz.conf'''
* Podremos examinar los logs del proceso en '''/var/log/intz-nimitz.log'''



[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== motorSal ====
Parte fundamental del proceso de marcación saliente, gestiona como hay que llamar a los diferentes contactos asignados a las campañas. Transforma los contactos en intentos de marcación.

A efectos de diagnósticos, desde un SSH ejecuta el comando “nc ip_maquina 1120”

'''root@vivait-acd:~# nc localhost 1120'''
motorSal sis ver='V01.4' inic='20140725 140832' alarmas=1 ultAlar='20140725 140832'
motorSal gmp msj=253/256 buf=256/256 tarea=99/102
motorSal tmp uptime=600165 (6d 22h 42m 45s)
motorSal mtr mys=1 ocup=0% planif=28(0) intento=26(0)

Donde cada parámetro monitorizado indica:

{| class="wikitable"
|-
!Parámetro!!Descripción
|-
|SIS/ver||Versión del proceso
|-
|SIS/inic||Fecha de de arranque del proceso
|-
|SIS/alarmas||Alarmas desde arranque
|-
|SIS/ultAlar||Fecha de última alarma
|-
|Gmp/msj||
|-
|Gmp/buf||
|-
|Gmp/tarea||
|-
|Tmp/uptime||Tiempo que lleva corriendo
|-
|mtr/mys||Si está conectado al MySQL
|-
|mtr/ocup||Porcentaje de ocupación
|-
|mtr/planif||Contactos planificados Totales (Último minuto)
|-
|mtr/intento||Intentos totales (Ültimo minuto)
|-
|}

* Posee un fichero de configuración llamado ''motorSal.conf'' en la ruta '''/etc/MDtel/motorSal.conf'''.


* Respecto a los logs del motorSal consultar el siguiente apartado: [[Trazas motorSal]]. Los logs pueden verse en la ruta '''/var/log/intz-nimitz.log'''

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== MyACDSuperv ====
Refleja el estado de las colas de asterisk en la base de datos; tiene sentido a efectos de estadísticas e informes, pero no a efectos de funcionamiento de la conmutación de voz.

Es el responsable de mostrar información en las ventanes de tiempo real del supervisor.

Es también el proceso que genera las llamadas en el marcador automático de '''''VIVA'''''it Suite.

A efectos de diagnósticos, desde un SSH se ejecuta el comando “nc ip_maquina 1112”.

'''root@vivait-acd:~# nc localhost 1112'''
myAcdSuperv SIS ver='04.6' inic='20140416 081613' alarmas=6 ultAlar='20140416 121652'
myAcdSuperv AMI cnx=1 ocup=28% exten=2/2/511 asig=0/11/4095
myAcdSuperv MYSQL cnx=1 ms=316

Donde cada parámetro monitorizado indica:
{| class="wikitable"
|-
!Parámetro!!Descripción
|-
|SIS/ver||Versión del proceso
|-
|SIS/inic||Fecha de de arranque del proceso
|-
|SIS/alarmas||Alarmas desde arranque
|-
|SIS/ultAlar||Fecha de última alarma
|-
|AMI/cnx||Conectado (1) a asterisk
|-
|AMI/ocup||Porcentaje de ocupación de MyACDSuperv
|-
|AMI/exten||Extensiones/Extensiones/Extensiones monitorizadas|-
|-
|AMI/asig||
|-
|MYSQL/cnx||Conectado (1) a MySQL
|-
|MYSQL/ms||Tiempo de última operación en ejecutarse
|-
|}

Como complemento a los diagnósticos:

* Podremos examinar el fichero de configuración del proceso en '''/etc/MDtel/myAcdSuperv.cnf'''
* Podremos examinar los logs del proceso en '''/var/log/myAcdSuperv.log'''

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== Proceso escoba ====
El proceso escoba se encarga de resolver y consolidar todos aquellos segmentos de grabación que han quedado almacenados en los gateways por falta de información o incoherencias. Existen dos tipos de procesos escobas:
# Proceso escoba perteneciente a nodo con agente de grabación (recordNodo) llamado '''''escobaGW.pl'''''.
# Proceso escoba perteneciente o no a un servidor de grabación (recordCentral) llamado '''''escobaGrabsBd.pl'''''.

===== escobaGW.pl =====
Proceso que se ejecuta en los nodos busca en el disco RAM , las grabaciones de segmentos cuya antigüedad sea superior a mas de un día, es decir, si el proceso por ejemplo se ejecuta a la 01:00 a.m. del día 24/03/2016 buscara todas aquellas grabacionesn de segmentos realizadas antes de la 01:00 a.m del día 22/03/2016.
Una vez realizada la busqueda, obtendra el UCID a traves del nombre del fichero, y comprobara su correspondencia con la tabla DAT_LLAMADAS. Si existe una llamada con ese UCID, cambiara el estado de la llamada para que sea procesada correctamente. En caso contrario, es movida a la carpeta ''/var/lib/recordNodo/grabError''.

===== escobaGrabsBd.pl =====
Se ejecuta sobre la base de datos de histórico, normalmente se ejecuta en un servidor de grabación (recordCentral). El proceso hace una búsqueda en dos tablas:
* En DAT_SEGMENTOS obtiene todos aquellos segmentos con grabaciones que dieron error, su estado tendrá valor 120.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]
* En DAT_LLAMADAS obtendremos todos los registros correspondiente al segmentos anteriores.
Después hace una búsqueda en el sistema, usando como ruta el campo D_HORA_INICIO de cada llamada, que indica la ruta entera donde se encuentra el archivo. Una vez encontrado el archivo cambia el estado del segmento que tenia un error a estado de grabación disponible , que tendrá valor 100. Si no encontramos el segmento, no realizara nada.

==== recordCentral ====
Se considera como un servidor de grabaciones. Todas las grabaciones de llamadas son un activo importante y una empresa con Contact Center pueda recibir millones de llamadas que necesitan estar registradas y almacenadas en discos duros con gran capacidad, las máquinas donde suelen alojarse estos servidores poseen discos duros limitados, lo que hace necesario en algunos casos incorporar ''dispositivos NAS''.

Los ''dispositivos NAS'' son dispositivos de almacenamiento conectados a una red que permite el almacenamiento y la recuperación de datos desde una ubicación centralizada, flexibles y escalables, lo que significa que a medida que necesite almacenamiento adicional, puede añadirlo al que tiene. Esto no significa que sea necesario tener ''dispositivos NAS'' para funcionar, sino que puede tomar datos de diferentes sitios.

En '''recordCentral''' pueden existir tres tipos de dispositivos NAS:
* Uno dedicado para las llamadas
* Uno dedicado para los segmentos
* Uno mixto para todas las llamadas y segmentos.

El '''recordCentral''' se encarga de recoger todas las grabaciones de segmentos que tienen de estado proceso(3) en cada nodo gestionado, es decir, coger aquellos segmentos de llamadas marcados como llamadas disponibles, intenta descargar los segmentos de las llamadas y convertirlas al formato adecuado (MP3).
Como una característica particular cada diez minutos, siempre que no tenga ninguna otra tarea, intenta ver si puede establecer conexión con un nodo en cuarentena, para sacarlos de cuarentena y recoger todas las grabaciones de segmentos disponibles, para intentar convertir y descargar todas las grabaciones.

A efectos de diagnósticos, desde un SSH se ejecuta el comando '''''nc ip_maquina 1114''''' en la maquina donde creamos que debe estar ejecutando el proceso recordCentral. Ejemplo:
'''root@smadavacdrecord1:~# nc localhost 1114'''
recordCentral SIS ver='01.2' inic='20140423 094058' alarmas=11041 ultAlar='20140423 160112'
recordCentral MYSQL cnx=1
recordCentral NAS llamadas=1 segmentos=1
recordCentral REC llamNum=24901 llamErr=0 segmNum=38906 segmErr=0 retraso=305
recordCentral NODO fase=0 cuarentena='' descarga='8,6,4,7,10,9' gestion='4,6,7,8,9,10'
La explicación de los campos se muestra en la tabla siguiente:

{| class="wikitable"
|-
! Parámetro !! Descripción
|-
| SIS/ver || Versión del proceso
|-
| SIS/inic || Fecha de arranque del proceso
|-
| SIS/alarmas || Alarmas desde arranque
|-
| SIS/ultAlar || Fecha de última alarma
|-
| MYSQL/cnx || Conectado (1) a MySQL
|-
| NAS/llamadas || Alojamiento en NAS de llamadas activo (grabación de llamada completa en un único archivo)
|-
| NAS/segmentos || Alojamiento en NAS de segmentos activo
|-
| REC/llamNum || Llamadas procesadas
|-
| REC/llamErr || Llamadas con error
|-
| REC/segmNum || Segmentos procesados
|-
| REC/segmErr || Segmentos con error
|-
| NODO/fase || Número de proceso de recordCentral
|-
| NODO/cuarentena || Lista de nodos en cuarentena, separada por comas
|-
| NODO/descarga || Lista de nodos en descarga, separada por comas
|-
| NODO/gestion || Lista de nodos gestionados, separada por comas (cuarentena + descarga = gestión)
|}

Como complemento a los diagnósticos:
* Podremos examinar el fichero de configuración del proceso en '''/etc/MDtel/recordCentral.pconf'''



* Podremos examinar los logs del proceso en '''/var/log/recordCentral.log'''


[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== recordNodo ====
Se considera como proceso con función de agente de grabación para un nodo. Solo debe existir uno por maquina o por nodo (configurado como grabador) en el '''portal de administración de ''VIVA''it'''.

Para su funcionamiento utiliza un ''disco RAM'' por que su tiempo de acceso mejora drásticamente, debido a que la memoria RAM es varios órdenes de magnitud más rápida que las unidades de disco reales, haciendo que la velocidad de procesamiento de las grabaciones sea mucho mas rápida.

Este ''disco RAM'' normalmente ocupa la mitad de la memoria RAM de una maquina pero no es obligatorio pues dependerá de la memoria disponible en cada maquina, y además, se configura con un tamaño no superior a 2GB de memoria RAM. Hay que tener especial cuidado en que no se llene en espacio ni tampoco los i-nodos. Se puede monitorizar a través de la aplicación '''zabbix'''.

El '''''recordNodo''''' se encarga de recoger todas las grabaciones de segmentos que tienen de estado ''proceso(2)'', es decir, aquellos segmentos de llamadas que han sido grabadas pero no están siendo procesadas, moviéndolas del ''disco RAM'' a su carpeta correspondiente.

La forma de obtener la carpeta correspondiente es obteniendo el dato del campo D_HORA_INICIO en la tabla DAT_LLAMADAS para cada segmento,tras un tratamiento del campo creara la subruta correspondientes: /año/mes/dia/hora/min. Entonces, la ruta correcta seria /var/lib/recordNodo/grabaciones/año/mes/dia/hora/min, donde año, mes, dia , hora y min son los valores numéricos obtenidos del campo D_HORA_INICIO.

A efectos de diagnósticos, desde un SSH se ejecuta el comando '''''nc ip_maquina 1113''''' en la maquina donde creamos que debe estar ejecutando el proceso recordNodo:

root@smadavgw5:~#nc localhost 1113
recordNodo SIS ver='04.00.00' inic='20160326 105137' alarmas=2 ultAlar='20160326 105542'
recordNodo MYSQL cnx=1
recordNodo REC grabNum=0 grabErr=0

La explicación de los campos se muestra en la tabla siguiente:
{| class="wikitable"
|-
! Parámetro !! Descripción
|-
| SIS/ver || Versión del proceso
|-
| SIS/inic || Fecha de arranque del proceso
|-
| SIS/amarmas || Alarmas desde arranque
|-
| SIS/ultAlar || Fecha de última alarma
|-
| MYSQL/cnx || Conectado (1) a MySQL
|-
| REC/llamNum || Llamadas procesadas
|-
| REC/llamErr || Llamadas con error
|-
| REC/segmNum || Segmentos procesados
|-
| REC/segmErr || Segmentos con error
|}

Como complemento a los diagnósticos:
* Podremos examinar el fichero de configuración del proceso en '''/etc/MDtel/recordNodo.pconf'''
:Se muestra a continuación el fichero de configuración:
#
# Configuracion de recordNodo.pl
#
# 0: Solo alarmas en archivo log - 1: alarmas y trazas
$depurar = 1;

# 0: Arranca como proceso - 1: arranca como demonio
$soyDemonio = 1;

# Archivo de log ('': salida estandar)
$logArch = '/var/log/record/recordNodo.log';

# Archivo para el pid (eliminando el .pid final)
$pidArch = '/var/run/record/recordNodo';

# 0: El programa se ejecuta indefinidamente - 1: solo una vez (util en depuracion)
$unaVezSolo = 0;

# Tiempo de espera en segundos cuando no hay conexion o cuando no hay llamadas
$toBucle = 5;

# Tiempo de guarda en segundos desde D_HORA_FIN hasta que se procesa llamada
$toProcesar = 30;

# Bytes por segundo en archivos de grabaciones
$bytesPorSegundo = 16000;

# Bytes a leer en cada accceso a disco
$bytesLeerBuf = 1048576;

# Conexion de base de datos
$db='nimitz';
$dbHost = 'BDTR';
$dbPort = '3306';
$dbUsuario = 'nimitz';
$dbClave = 'ivivanimitz';

# Configuracion de la supervision
$supPort = '1113';

# Quien es mi nodo para filtrar grabaciones
$miNodo = 2;

# Directorio donde se localizan las grabaciones
$grabRutaOrig = '/var/spool/asterisk/monitor';
$grabRutaDest = '/var/lib/recordNodo/grabaciones';
$grabRutaError = '/var/lib/recordNodo/grabError';
$grabRutaUsaTimestamp = 1;

# Tiempo en segundos limite a truncar en las grabaciones (0=sin limite)
$grabLimiteSegs = 0;

# Indica si se procesan segmentos de tipo tipoSegmEliminarGrabacion y patron eliminacion
$segmEliminarGrabacionTrato = 1;
$patronEliminarGrabacion = '/etc/MDtel/null.bin'

A continuación se indican las variables a modificar:

{| class="wikitable"
|-
! Variable a modificar !! Comentario
|-
|$depurar = 1;||'''0''': Solo alarmas en archivo log
'''1''': alarmas y trazas
|-
|$soyDemonio = 1;||'''0''': Arranca como proceso
'''1''': arranca como demonio
|-
|$logArch = '/var/log/record/recordNodo.log';||Archivo de log ('': salida estándar) $pidArch = '/var/run/record/recordNodo'; Archivo para el pid (eliminando el .pid final)
|-
|$unaVezSolo = 0;||'''0''': El programa se ejecuta indefinidamente
'''1''': solo una vez (útil en depuración)
|-
|$toBucle = 5;||Tiempo de espera en segundos cuando no hay conexión o cuando no hay llamadas
|-
|$toProcesar = 30;||Tiempo de guarda en segundos desde D_HORA_FIN hasta que se procesa llamada
|-
|$bytesPorSegundo = 16000;||Bytes por segundo en archivos de grabaciones
|-
|$bytesLeerBuf = 1048576;||Bytes a leer en cada acceso a disco
|-
|$db='nimitz';||Conexión de base de datos
|-
|$dbHost = 'BDTR';||
|-
|$dbPort = '3306';||
|-
|$dbUsuario = 'nimitz';||
|-
|$dbClave = 'ivivanimitz';||
|-
|$supPort = '1113';||Configuración de la supervisión
|-
|$miNodo = 2;||Quien es mi nodo para filtrar grabaciones
|-
|$grabRutaOrig = '/var/spool/asterisk/monitor'; Directorio donde se localizan las grabaciones
|-
|$grabRutaDest = '/var/lib/recordNodo/grabaciones';
|-
|$grabRutaError = '/var/lib/recordNodo/grabError';
|-
|$grabRutaUsaTimestamp = 1;||'''1''': Usa Timestamp
'''0''': No usa Timestamp
|-
|$grabLimiteSegs = 0;|| Tiempo en segundos limite a truncar en las grabaciones (0=sin limite)
|-
|$segmEliminarGrabacionTrato = 1;||Indica si se procesan segmentos de tipo tipoSegmEliminarGrabacion y patrón eliminación
|-
|$patronEliminarGrabacion = '/etc/MDtel/null.bin'
|}


* Podremos examinar los logs del proceso en '''/var/log/recordNodo.log'''

==== Vivait-CTI ====
Permite la comunicación entre la aplicación '''''VIVA'''''it Desk de agente y el asterisk, sincronizando; convierte el protocolo “asterisk manager” a CSTA ('''''VIVA'''''it Desk “habla” CSTA).

Es un proceso importante para que el uso de '''''VIVA'''''it Desk, y que los agentes puedan realizar su operativa normal con la entrada y salida de llamadas… si bien el cursado telefónico de llamadas es factible, no disponer de las facilidades de '''''VIVA'''''it Desk y formularios hace el sistema difícilmente manejable

A efectos de diagnósticos, desde un SSH se ejecuta el comando “nc ip_maquina 1111”

'''root@vivait-acd:~# nc localhost 1111'''
vivait-cti sis ver='V01.5' inic='20140414 104312' alarmas=13 ultAlar='20140415 173152'
vivait-cti gmp msj=1018/1024 buf=1023/1024 tarea=97/102
vivait-cti tmp uptime=694748 (8d 0h 59m 8s)
vivait-cti cti numConx=(0/511) numPend=(0/127) numMakeCallPend=0 numCall=(0/2047)
numChan=(0/4095) numAuxStr=(0/511) numMoniColas=(0/511) numMoniDevice=0
numMoniCall=0 numMoniCallAuto=0 numMoniCallByDevice=0 numMoni=(0/511)
auditCallErr=0 auditAuxStrErr=0 auditMsjReqErr=0 araChanID=0 araUniqueID=0 araMoni=0
vivait-cti ami esta=conx resp=652(0) evs=1397(0) descar=556(0) err=16 errConx=16
numAct(0/0/127) auditErrAct=0

Donde cada parámetro monitorizado indica:

{| class="wikitable"
|-
!ver!!Versión del proceso
|-
|sis/inic||Fecha de de arranque del proceso
|-
|Sis/alarmas||Alarmas desde arranque
|-
|Sis/ultAlar||Fecha de última alarma
|-
|Gmp/msj||
|-
|Gmp/buf||
|-
|Gmp/tarea||
|-
|Tmp/uptime||
|-
|Cti/numConx||Número de conexiones actuales / Número de conexiones máximo
|-
|Cti/numPend||
|-
|Cti/numMakeCallPend||Llamadas pendientes de realizar
|-
|Cti/numcall||
|-
|Cti/numChan||
|-
|Cti/numAuxStr||
|-
|Cti/numMoniColas||Número de colas monitorizadas
|-
|Cti/numMoniDevice||
|-
|Cti/numMoniCall||
|-
|Cti/numMoniCallAuto||
|-
|Cti/numMoniCallByDevice||
|-
|Cti/numMoni||
|-
|Cti/auditCallErr||
|-
|Cti/auditAuxStrErr||
|-
|Cti/ auditMsjReqErr||
|-
|Cti/ araChanID||
|-
|Cti/ araUniqueID||
|-
|Cti/ araMoni||
|-
|Ami/esta||Estado de conexión contra manarger de asterisk
|-
|Ami/resp||
|-
|Ami/evs||Número de eventos (último minuto)
|-
||Ami/descar
|-
|Ami/err||Errores
|-
|Ami/errConx||Errores de conexión
|-
|Ami/numAct||
|-
|Ami/auditErrAct||
|-
|}

Como complemento a los diagnósticos:

* Podremos examinar el fichero de configuración del proceso en '''/etc/MDtel/vivait-cti.conf'''
* Podremos examinar los logs del proceso en '''/var/log/vivait-cti.conf'''

==== Phoneprov-TFTP ====

==== Introducción al aprovisionamiento ====

En cada Centralita Telefónica existente, se puede configurar sus teléfonos IP y asignarles extensiones a cada teléfono. Para hacer un ''aprovisionamiento'' de los teléfonos es necesario que el técnico configure uno a uno manualmente utilizando su interfaz web, esto no es práctico, ya que genera muchos errores y el tiempo de implementación se incrementa drásticamente. Además, es casi imposible la administración cotidiana de los teléfonos IP. Desde '''MD'''tel se utiliza una herramienta que permite que los teléfonos IP soportados y homologados por '''MD'''tel ([[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_3.0#Terminales_telef.C3.B3nicos ver Terminales telefónicos]]) se puedan aprovisionar automáticamente, brindando una fácil implementación y administración cotidiana.

===== ¿Qué es aprovisionar? =====

Aprovisionar un teléfono es el proceso de configuración automático de teléfonos IP para su uso con una Centralita Telefónica de forma remota. Una vez que aprovisione un teléfono, el teléfono automáticamente se configurará correctamente y podrá administrar los teléfonos de forma centralizada y remota, sin tener que iniciar sesión en la interfaz web de cada uno de los teléfonos.

El aprovisionamiento de teléfono facilita enormemente la administración cotidiana de los teléfonos IP. Esto hace que sea fácil de cambiar las contraseñas de extensión,realizar desvíos de llamadas, nombre a mostrar, mensajería y demás configuraciones, ya que puede hacerlo de forma centralizada para todos los teléfonos desde el portal de administración y luego transferir los cambios al teléfono.

===== TFTP =====

'''TFTP''' son las siglas de '''T'''rivial '''F'''ile '''T'''ransfer '''P'''rotocol ''(Protocolo de transferencia de archivos trivial)''.

Es un protocolo de transferencia muy simple semejante a una versión básica de FTP. TFTP a menudo se utiliza para transferir pequeños archivos entre terminales en una red.

Algunos detalles del TFTP:

* Utiliza UDP (puerto 69) como protocolo de transporte (a diferencia de FTP que utiliza los
puertos 20 y 21 TCP).
* No puede listar el contenido de los directorios.
* No existen mecanismos de autenticación o cifrado.
* Se utiliza para leer o escribir archivos de un servidor remoto.
* Soporta tres modos diferentes de transferencia, "netascii", "octet" y "mail”.

===== Funcionamiento del servidor phoneprove-TFTP =====

A continuación se muestra un esquema que facilita el entendimiento del funcionamiento del servidor phoneprove-TFTP:

[[Archivo:Funcionamiento_Servidor.png‎ |center]]

El servidor Phoneprove-TFTP se ''encarga del aprovisionamiento masivo de terminales'', es de gran utilidad porque cualquier cambio en los teléfonos pueden ser realizados a nivel DHCP y todos los teléfonos tomarán la nueva configuración luego de reiniciarlos.

Desde phoneprove-TFTP se generara los archivos necesarios para cada teléfono y que sirven para ser aprovisionados automáticamente.
El servidor phoneprove-TFTP tiene alojados los ficheros de configuración están ordenados según las direcciones MAC de los teléfonos. El teléfono “preguntará” al servidor cual es su fichero de configuración utilizando su dirección MAC. Este a través de su MAC , consulta en la base de datos para ofrecer al terminal los datos de configuración según su plantilla, cual sera su extensión , cual sera el usuario propietario, entre otras cosas.

{|
|-
|
'''Nota:''' En instalaciones grandes habrá más de uno, quizás uno por sede grande; depende de la infraestructura de DHCP.
|}

===== Parámetros necesarios de Aprovisionamiento de Teléfonos =====

'''Notas:''' el aprovisionamiento desarrollador por '''MD'''tel, no emplea un fichero por cada
teléfono, sino que emplea una plantilla por cada modelo de teléfono.
Debe haber una '''configuración previa del servidor DHCP''' es necesario coordinar con el cliente la asignación de direcciones para
los diferentes elementos de la plataforma '''''VIVA'''''it, fundamentalmente para terminales telefónicos; en este caso además será necesario
activar la opción 66 que permitirá definir el servidor TFTP del que los terminales cogerán sus ficheros de aprovisionamiento.
El aprovisionamiento desde el portal de administración solo es posible para aquellos teléfonos IP homologados y probados desde '''MD'''tel
[[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_3.0#Terminales_telef.C3.B3nicos ver Terminales telefónicos]]

Como existen parámetros comunes de todos los teléfonos de la misma marca de fabricante, muchos de los parámetros necesarios para el aprovisionamiento como comentamos se han generado desde MDtel en forma de plantillas, que estarán disponibles en el portal de administración VIVAit [[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Plantillas | ver plantilla del portal de administración VIVAit]].

La configuración de un teléfono SIP es muy sencilla y en no es necesario tener conocimientos avanzados de informática o de telefonía. Cada una de estas plantillas que sirven para aprovisionar un teléfono IP homologado, algunos de los parámetros predeterminados se explicarán a continuación .

====== Parámetros de Aprovisionamiento globales ======

* Configuración de la red y MAC.
* Zona horaria.

====== Parámetros de Aprovisionamiento Personales ======

Además de los parámetros de aprovisionamiento globales, el teléfono también obtendrá información de configuración individual, tales como:

*Número de Extensión.
*Nombre y Contraseña de usuario SIP.
*Configuración de Teclas BLF.
*Contraseña de la Interfaz Web del Teléfono IP.
*Idioma de la Pantalla.
*Orden de Preferencia de los Codecs.

===== Aprovisionamiento de teléfonos nivel usuario =====

{|
|-
|
'''Notas:''' La dirección MAC debe estar especificada en letras mayúsculas.
La dirección MAC del teléfono se puede encontrar en la etiqueta adhesiva en la parte inferior del teléfono, o de lo contrario se deberá acceder desde
el menú del propio terminal.
|}

Los pasos a seguir son los siguientes:

'''1)''' Dar de alta el teléfono en el portal de administración, se debe seleccionar el modelo del teléfono, e indicar la dirección MAC del teléfono a aprovisionar, todo ello desde el portal de administración VIVAit.
Para mas información ver [[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Aprovisionamiento del portal de administracion| aprovisionamiento del portal de administración VIVAit]].

'''2)''' En el mismo portal de administración se deberá crear una extensión , asignar a la extensión el teléfono que se quiera aprovisionar, elegir la plantilla adecuada del teléfono y el usuario propietario (solo si sera un puesto fijo) desde [[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Extensiones | extensiones del portal de administración]].

'''3)''' Conectar el teléfono a la red LAN informática (conectarlo al router o switch) para que tenga acceso a Internet:

:*El teléfono enviará un mensaje de multidifusión a través de la LAN.
:*Este será captado por la Central Telefónica siempre que esté en la misma LAN.
:*Al teléfono se le enviará una URL de aprovisionamiento.

'''4)''' Como la mayoría de teléfonos IP del mercado al arrancar una vez sabiendo la URL de aprovisionamiento piden una serie de archivos de configuración para aprovisionarse vía TFTP. EL servidor phoneprove-TFTP, detectara la petición y a través de la MAC y datos del usuario, consultará en la base de datos los datos necesarios para aprovisionar al teléfono y si todo funciona correctamente mandara al teléfono IP los datos de configuración necesarios para funcionar.

'''5)''' Asegúrese de que el teléfono encuentren el servidor TFTP, para ello esperar un tiempo adecuado para que termine el aprovisionamiento.

'''6)''' Finalmente aparecerá como registrado en la centralita, obtendrá una dirección IP y podra funcionar según la configuración establecida.

{|
|-
|
'''Nota''': Si no se reaprovisiona tras un periodo largo de tiempo, desenchufe el cable de alimentación eléctrica o el cable Ethernet (si se utiliza la alimentación en línea PoE) para reiniciar los teléfonos.
|}

===== Aprovisionamiento de teléfonos nivel técnico =====

====== Plantilla de configuración ======

La plantilla de configuración empleadas en el apartado [[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Plantillas | plantilla del portal de administración VIVAit]] de cada modelo está formada por una serie de variables.

Los valores se obtienen de la tabla de la base de datos CEN_TELEFONOS, CEN_USUARIOS, ACD_EXTENSIONES, ACD_NODOS, COM_NODOS... correspondientes a la extensión del teléfono, usuario, nodo, etc.

variable ${NODO1_C_NOMBRE}='corp-ast13'
variable ${EXTEN_C_CLAVE_REGISTRO}='Tel21002'
variable ${USU_C_CODIGO_POSTAL}=''28034'
variable ${SEDE_C_CODIGO_POSTAL}='28034'
variable ${USU_C_NOMBRE}='Juan Antonio'
variable ${USU_C_APELLIDO2}='Ramirez'
variable ${SEDE_C_NOMBRE}='RED_LAB'
variable ${NODO2_C_NOMBRE}= NULL
variable ${EXTEN_C_NOMBRE}='' 21002
variable ${USU_C_LOCALIDAD}=''
variable ${USU_C_NOMBRE_MOSTRAR}='Juan'
variable ${NODO1_C_IP}='175.25.129.70'
variable ${MODEL_C_PREFIJO_PLANTILLA_MAC}='T28P'
variable ${SEDE_C_LOCALIDAD}='Madrid'
variable ${USU_C_APELLIDO1}='Casas'
variable ${NODO2_C_IP}= NULL
variable ${TF_ID_EXTENSION}='5'
cargando campos idExten=5

====== Ficheros y paquetes necesarios ======

'''Paquetes previos:''' libnet-tftpd-perl, tftp-hpa, libnet-address-ip-local-perl
'''Usuario de funcionamiento:''' root

{|
|-
|
'''Nota:''' los archivos y directorios que generemos podrian necesitar que se permitiera el acceso al archivo de lectura y escritura en el servidor TFTP.
|}

'''Archivos necesarios:'''

/usr/local/sbin/phoneprov-tftp.pl
/usr/local/sbin/phoneprov-tftp.pm
/etc/MDtel/phoneprov-tftp.pconf
/etc/init/phoneprov-tftp.conf
/etc/logrotate.d/phoneprov-tftp

'''Directorios a crear:'''

/var/lib/phoneprov-tftp/plt
/var/lib/phoneprov-tftp/bin

==== Watchdog ====

Se trata de una aplicación del asterisk que monitoriza el SIP y en caso de fallo, pasado un cierto tiempo, reinicia el asterisk y genera un core.
Si escribimos en CLI de asterisk perro tenemos los siguientes comandos:

{| class="wikitable" border="0" style="background:#ffffff" align="top"
|-
|Activar||Activar el Watchdog
|-
|Desactivar||Desactiva el Watchdog
|-
|Parada IWantToStop||Reinicia el asterisk y genera un core para pruebas
|-
|Reload||Realiza una recarga del Watchdog y aplica cambios en su configuración
|-
|Show||Ver el estado del Watchdog

perro avisado=0 activo=1 segsDormir=1 segsInic=60 segsGuarda=30 maxErr=3
perro nombre=sip_monitor_udp lwp=[15437] segsInic=60 segsGuarda=30 hace=11 err=0/5
|-
|}

El dato "hace" informa de cuanto tiempo ha transcurrido desde el último tick. Facilita la calibración del parámetro de configuración "segs_guarda", normalmente es 30

Tiene un fichero de configuración ubicado en /etc/asterisk/MDcrash.conf

{| class="wikitable" border="0" style="background:#ffffff" align="top"
|-
|Sección [perro]
||activo=yes (Si esta o no activo)
segs_dormir=1 (Un tick por segundo)

segs_inic=60

segs_guarda=30

max_errores=3
|-
|Sección [sip_monitor_udp]
||segs_inic=60

segs_guarda=30 (Cada 30 segundos si no reciba trafico SIP genera core)

max_errores=5 (Número máximo de errores)
|-
|}



==== Proceso de Backup ====
Las plataformas '''''VIVA'''''it Call y '''''VIVA'''''it Suite incluyen un script para realizar un proceso de backup.

Se utilizará el script '''backup.sh''', que se encuentra en el directorio '''etc/MDTel'''.

Se ejecuta automaticamente mediante el uso de un cron

'''texto del cron:'''

SHELL=/bin/sh
PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
# m h dom mon dow user command
0 2 * * * root /etc/MDtel/backup.sh /etc/MDtel/backup.cfg

Para activar el script hay que descomentar la línea
# m h dom mon dow user command

Los directorios de los que se hace copia son:
* DIR=var/lib/asterisk/sounds/Particular
* DIR=var/lib/asterisk/moh
* DIR=etc
* DIR=etc/asterisk
* DIR=etc/cron.d
* DIR=etc/dahdi
* DIR=etc/exim4
* DIR=etc/ha.d
* DIR=etc/logrotate.d
* DIR=etc/MDtel
* DIR=etc/mysql
* DIR=etc/network
* DIR=etc/zabbix
* DIR=usr/local/sbin

Por defecto se realiza un backup cada dos horas en la carpeta '''/var/spool/MDtel/backup'''.

Para cambiar la ruta de destino del backup habrá que modificar el fichero backup.sh, en concreto modificar la variable MDTEL.

El fichero ''' backup.cfg''' que se genera incluye copia de la siguiente información:
* Ficheros de configuración de la aplicación.
* Base de Datos.
* Dialplan.

Se guardarán 10 copias del fichero ''' backup.cfg '''

Los campos disponibles en el fichero son los siguientes:

{| class="wikitable"
|-
!Campo !!Descripción !!Posibles valores (si aplica)
|-
|IP_BD ||IP o HOST máquina base de datos de tiempo real||
|-
|HAY_SMB ||Si hay o no servidor SAMBA||1 si existe servidor SAMBA o 0 si no existe
|-
|HOST_SMB||IP o HOST servidor SAMBA||
|-
|USU_SMB||Usuario acceso servidor SAMBA||
|-
|CLAVE_SMB||Clave usuario acceso servidor SAMBA||
|-
|RUTA_SMB||Ruta donde se guardará el backup en el servidor SAMBA||
|-
|}

Para recuperar una plataforma utilizando el backup, habrá que instalar una máquina nueva y cargar los ficheros de configuración, Base de Datos y Dialplan guardados en el proceso de backup.

===== Información adicional: como funciona un cron =====

La información sobre el fucnionamiento de un cron puede encontrarse en: [http://lasegundapuerta.com/index.php/informatica/linux-y-software-libre/1709-comando-cron-en-linux-ubuntu Información sobre el comando cron]

==== CHAT ====
La información para configurar el CHAT y su funcionamiento puede encontrarse en:

[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#CHAT CHAT]

=== Requerimientos de conectividad ===

El esquema siguiente muestra como ejemplo todos los flujos de información existentes en un entorno típico de <big>'''telefonía corporativa (sin presencia)'''</big> ('''''VIVA'''''it Call)

[[Archivo:Flujos corporativa.png|cebter]]

En el entorno de <big>'''Contact Center'''</big>, encontramos los siguientes flujos <big>'''entre servicios'''</big> (comunicaciones entre servidores, ('''''VIVA'''''it Suite))

[[Archivo:Flujos Contact servicios.png|650px|center]]

y <big>'''entre usuarios y servicios'''</big> los reflejados a continuación:

[[Archivo:Flujos Contact puestos.png|600px|center]]

{| class="wikitable"
|-
!Lado A!!Lado B!!Puertos!!Sentido!!Observ.
|-
|Terminal telefónico||Servidor||TCP 5060||A -> B||Señalización SIP
|-
|Terminal telefónico||Servidor||UDP 5060||A -> B||Señalización SIP
|-
|Terminal telefónico||Servidor||10000 a 20000||A -> B
B -> A
||RTP
|-
|Terminal telefónico||Servidor TFTP||UDP 69||A -> B
B -> A
||Para actualización de terminales por TFTP
|-
|Terminal telefónico||Servidor NTP||UDP 123||A -> B||
|-
|'''''VIVA'''''it Desk||Servidor||TCP 4500||A -> B||Comunicación CTI
|-
|'''''VIVA'''''it Desk||Servidor||TCP 3306||A -> B||Acceso a Mysql Base de datos
|-
|'''''VIVA'''''it Desk||Servidor Syslog||UDP 514||A -> B||Para envio de logs de agente
|-
|'''''VIVA'''''it Supervisor||Servidor||TCP 3306||A -> B||Acceso a Mysql Base de datos
|-
|'''''VIVA'''''it Tracker||Servidor||TCP 3306||A -> B||Acceso a Mysql Base de datos
|-
|'''''VIVA'''''it Tracker||Servidor||TCP 8180||A -> B||
|-
|Actualizador||Servidor||TCP 80||A -> B||Necesario para actualizaciones de versiones de aplicaciones de agente y supervisores
|-
|Portal de administración||Servidor||TCP 8180||A -> B||Acceso al portal de administración '''''VIVA'''''it Suite
|-
|'''''VIVA'''''it Tracker Web||Servidor||TCP 8180||A -> B||
|-
|Monitor||Servidor||TCP 8180||A -> B||Wallboard
|-
|Monitorización||Servidor||TCP 80||A -> B||Acceso a portal monitorización (Zabbix)
|-
|}

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Gateways ===
El concepto de gateway como tal no existe en la plataforma '''''VIVA'''''it; existen nodos de ACD y nodos de corporativa.

A efectos de operación un nodo de corporativa es el que en cualquier caso asumirá las funcionalidades de gateway, y recibirá las conexiones (analógicas, digitales o IP) a sistemas externos o a la RTC

El concepto gateway queda pues suscrito a entornos meramente comerciales

Incluimos no obstante en este apartado los diagnósticos y operaciones básicos de conexiones a sistemas externos o RTC

Para verificar los enlaces establecidos ejecutamos el siguiente comando en el terminal: '''sip show peers'''

Al ejecutar este comando obtenemos la salida:

[[Archivo:Enlace_Exterior.png |center]]

Las columnas ''Host'' y ''Port'' nos muestran las conexiones establecidas y nos informa de un posible problema de conexión.

Sabremos que ''no existe conexión'' cuando la columna Host tiene el valor '''Unspecified''' y en la columna Port aparece un '''0''' , a continuación se muestra un ejemplo:

[[Archivo:Ejemplo_no_conexion.png |center]]



=== Servidor de grabación ===
==== Almacenamiento en la nube ====
Almacenamiento en la nube.
Existe la posibilidad de que tras un determinado periodo de tiempo las grabaciones sean movidas a un almacenamiento externo. De esta operativa se encarga el proceso /usr/local/sbin/mueveGrabaciones.pl que recibe como parámetro la ruta al archivo de configuración. Dicho archivo tiene los siguientes elementos:

*$db: Nombre de la base de datos.
*$dbHost: servidor de MySQL
*$dbPort: Puerto del MySQL.
*$dbUsuario: Usuario de conexión a MySQL.
*$dbClave: Clave del usuario anterior.
*$dirBase: Directorio donde residen las grabaciones
*$diasCaducidad: Dias de antigüedad para mover las grabaciones
*$sftpHost: Servidor SFTP de destino
*$sftpPort: Puerto SFTP.
*$sftpUsuario: Usuario SFTP.
*$sftpClave: Clave del usuario SFTP.
*$simula: Si este campo vale 1, las grabaciones se copian, pero no se borran del directorio original, ni se actualiza su ubicación en la base de datos.

La grabación indica donde se encuentra mediante el campo E_UBICACION_GRABACION, que puede tener los siguientes valores:
*Sin definir (0)
*En línea (10): Las grabaciones se encuentran en el servidor de grabaciones.
*Fuera de línea (20): las grabaciones se encuentran en una ubicación externa.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Reporting ===
La aplicación de reporting en general no tiene procesos habituales de operación y mantenimiento.
Los informes son obtenidos desde la interfaz gráfica o mediante un procedimiento de scripting, descritos en “Formato de fichero de intercambio para '''''VIVA'''''it Reporting”.

==== Formato de fichero de intercambio para '''''VIVA'''''it Reporting ====
{| class="wikitable"
|-
! Nombre !! Descripción !! Ejemplo
|-
| colspan="3"| Selección de registros
|-
| SQL_selec || Expresión SQL que se añadirá al where a la SQL principal. || C_ORIGEN like '6%' and C_COD_CLIENTE= '023'
|-
| SQL_select_leido || Filtro de selección legible
|| Skill igual a 60310
|-
| SQL_orden || Lista de campos por los que se ordenará, después de los que estén ya definidos en la plantilla. || C_ORIGEN, C_COD_CLIENTE
|-
| colspan="3"| Salida
|-
| FIC_extension || Extensión de fichero de salida: PDF, XLSX, CSV || PDF
|-
| FIC_tipo_entrega || 'P': Pantalla, 'D': Directorio, 'C': Correo || D
|-
| FIC_destino || Si 'C', dirección de correo, si 'D', ruta del directorio || D:\informes\
|-
| colspan="3"| Plantilla
|-
| INF_modelo || Ruta del fichero de plantilla || C:\Modelos\llamadas.rep
|-
| INF_descripción || Descripción del informe || Informe detallado de llamadas
|-
| colspan="3"| Base de datos
|-
| BD_ip || IP o nombre de máquina ||
|-
| BD_puerto || Puerto de MySQL ||
|-
| BD_base_datos || Nombre de base de datos ||
|-
| BD_usuario || Usuario de base de datos ||
|-
| BD_clave || Clave de acceso cifrada ||
|-
| colspan="3"| Parámetros
|-
| PAR_desde_vis || Fecha inicial de selección en formato legible (o '-' si no hay) || 01/01/2016
|-
| PAR_hasta_vis || Fecha final de selección en formato legible (o '-' si no hay) || 31/01/2016
|-
| PAR_01 || Parámetro opcional ||
|-
| .. || .. ||
|-
| PAR_20 || Parámetro opcional ||
|}

El fichero tendrá un nombre único para permitir la generación simultánea de informes.
El fichero es borrado por la aplicación de forma automática.
Se pasa a la aplicación de generación de informes como parámetro. Por ejemplo:
“C:\Archivos de Programa\MDtel\Nimitz\LanzaInformes\LanzaInformes.exe”
“C:\Archivos de Programa\MDtel\Nimitz\LanzaInformes\NIM00001.tmp”

Ejemplo de fichero:
{| class="wikitable"
|-
| SQL_selec=(DAT_ACUMULADOS_COLAS.ID_COLA in (11))

SQL_select_leido=Skill igual a 60310

SQL_orden=
FIC_extension=pdf

FIC_tipo_entrega=P

FIC_destino=C:\

INF_modelo=skill_setsi.rep

INF_descripcion=Skill. SETSI

BD_ip=172.25.1.2

BD_puerto=3306

BD_base_datos=nimitz

BD_usuario=nimitz

BD_clave=UIk5jNY9PVX5ogg=

PAR_desde_vis=-

PAR_hasta_vis=-

PAR_01=
|}

==== Resumen de significado de columnas en reporting histórico ====
Esta información se puede consultar en el siguiente enlace:

http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Documentacion_de_usuario_VIVAit_Suite_3.3#Resumen_del_valor_de_las_columnas_que_aparecen_en_los_informes



===== Consideraciones adicionales =====

Los tiempos se insertan en el intervalo en el que se deja ese "estado", esto provoca que en un intervalo pueda ser mayor el tiempo ACD que el tiempo conectado.

''* Ejemplo:''

-Llamada: Duración 15 minutos Hora fin de la llamada 13:01
-Llamada: Duración 20 minutos Hora fin de la llamada 13:24
Suma de las duraciones de las llamadas para el intervalo ''35 minutos'' tiempo
conectado del agente en el intervalo ''30 minutos.''
Cuando los periodos consultados sean mas amplios (diario, mensual) los
desfases tenderán a desaparecer.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

== Otros Diagnósticos y operaciones básicas ==
=== Arranque y apagado de la plataforma ===

En general el arranque y apagado de cada nodo de una plataforma '''''VIVA'''''it es el estándar de un procedimiento ordenado de apagado en una máquina linux: '''"Shutdown -h now"''' o comando de apagado inmediato o programado equivalente

El orden de arranque de la plataforma deberá ser:
# En primer lugar arrancar el nodo con la base de datos de tiempo real
# Una vez finalizado el arranque del punto 1, arrancar el nodo con la base de datos de réplica
# Una vez finalizado el arranque del punto 2, arrancar el resto de nodos en cualquier orden

Al respecto del orden de apagado de nodos, es el siguiente:
# En primer lugar se apagarán, en cualquier orden, los nodos que NO CONTENGAN bases de datos de tiempo real ni bases de datos de réplica
# Una vez apagados totalmente todos los nodos del punto 1, apagaremos el nodo (o nodos) con bases de datos de réplica
# Una vez apagados totalmente todos los nodos del punto 2, se apagará el nodo con la base de datos de tiempo real

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]


=== Grabación ===

==== Configuración de la grabación en la plataforma corporativa ====
Para que una llamada se grabe, lo primero de todo es que alguien tenga la capacidad de grabar. Esto se consigue diciendo al nodo que sea grabador. Esto provoca que el nodo llame al mixmonitor para grabar y se inserte un registro en el DAT_GRABACIONES. Esto no significa que ya las llamadas se vayan a grabar, ya que para eso tiene que ser procesadas por un nodo que sea grabador. Hay tres, llamémosle elementos, que se pueden grabar:

* El nodo, es decir todo lo que el nodo enrute
* Prerutas
* Objetos: que son las extensiones, usuarios, grupos corporativos, etc.

Tenemos tres formas de grabar:

* Grabar con beep periódico
* Grabar sin beep periódico
* Descartar grabación

Si de los tres elementos tenemos que uno grabe, ya sea con o sin beep periódico, esa llamada se va a grabar ya que son OR, en cuanto haya un elemento que diga que grabe se va a grabar.

Al igual pasa si tenemos que un elemento tenga descartar la grabación. La grabación no se inicia.

Referente al campo de Modo de grabación en infraestructura, este no se emplea para la grabación de corporativo, sino que solo tiene validez en ACD. Para grabación en el ACD hay que, como se ha dicho anteriormente poner un nodo que sea grabador y especificar un elemento de los tres que hay cual es el que se va a grabar.

Para que exista una grabación ha de existir un segmento asociado a esta. Los segmentos se tratan en las prerutas. Hay un campo es las prerutas que es Generar segmento al enrutar. Si está se generará el segmento del tipo de la preruta y su correspondiente grabación si esta está configurada. Si le decimos que no genere segmentos al enrutar y el sistema está configurado para que grabe, el recordCentral creará un tipo de segmento llamado externo para esa grabación. Podemos configurar si queremos que se cree o no ese segmento, para eso hay que modificar el fichero de configuración del recordCentral y poner un tiempo muy alto al campo $segmExternoMinSegs. También podemos configurar que segmentos queremos que se graben. Por defecto el recordCentral va configurado para que se graben todos los segmentos. Para decirle que solo grabe cierto tipo de segmentos hay que ponerlos los que queramos que si se graben en la variable $tiposSegmentoGrabar del fichero de configuración del recordCentral.

==== Comprobación de que el servidor de grabación esta activo ====

Si al ejecutar el comando '''''nc ip_maquina 1114''''',si no se recibe ninguna respuesta, significa el servidor de grabación no estaría activo.
También usando el comando ''''' ps aux | grep recordCentral ''''', donde si no escribe ningún resultado implica que tampoco esta activo.

==== Comprobación de que los nodos están conectados al servidor de grabación ====

Debemos fijarnos en la linea de respuesta del comando '''''nc ip_maquina 1114''''', que seria:
{| class="wikitable"
|-
| root@smadavacdrecord1:~# nc localhost 1114
recordCentral SIS ver='01.2' inic='20140423 094058' alarmas=11041 ultAlar='20140423
160112'

recordCentral MYSQL cnx=1

recordCentral NAS llamadas=1 segmentos=1

recordCenral REC llamNum=24901 llamErr=0 segmNum=38906 segmErr=0 retraso=305

'''recordCentral NODO fase=0 cuarentena='' descarga='8,6,4,7,10,9' gestion='4,6,7,8,9,10''''
|}

Sabiendo que el parámetro "fase=0" es el numero que identifica el recordCentral, los demás parámetros nos indicaran los nodos disponibles , que funcionan o no en el servidor. Entonces "gestión=4,6,7,8,9,10" indica el id de los nodos que maneja el proceso.

==== Comprobación de que un nodo tiene activo el agente de grabación ====
Si al ejecutar el comando '''''nc ip_maquina 1113''''', no se recibe ninguna respuesta, significa que el nodo no tiene activo el agente de grabación.
También usando el comando ''''' ps aux | grep recordNodo''''', donde si no escribe ningun resultado implica que tampoco esta activo.

==== Comprobación de que un nodo está subiendo archivos de grabación al servidor ====
Debemos fijarnos en la linea de respuesta del comando '''''nc ip_maquina 1114''''', que seria:

{| class="wikitable"
|-
| root@smadavacdrecord1:~# nc localhost 1114
recordCentral SIS ver='01.2' inic='20140423 094058' alarmas=11041 ultAlar='20140423
160112'

recordCentral MYSQL cnx=1

recordCentral NAS llamadas=1 segmentos=1

recordCenral REC llamNum=24901 llamErr=0 segmNum=38906 segmErr=0 retraso=305

'''recordCentral NODO fase=0 cuarentena='' descarga='8,6,4,7,10,9' gestion='4,6,7,8,9,10''''
|}

Fijándonos en "descarga=8,6,4,7,10,9" nos confirma que todos los nodos que maneja el proceso funcionan perfectamente y el servidor puede manejar las grabaciones.

==== Comprobación de grabaciones que se hayan quedado enganchadas en un nodo ====
Podemos fijarnos en los dos comandos, para '''''nc ip_maquina 1114''''':
{| class="wikitable"
|-
| root@smadavacdrecord1:~# nc localhost 1114
recordCentral SIS ver='01.2' inic='20140423 094058' alarmas=11041 ultAlar='20140423
160112'

recordCentral MYSQL cnx=1

recordCentral NAS llamadas=1 segmentos=1

recordCenral REC llamNum=24901 llamErr=0 segmNum=38906 segmErr=0 retraso=305

'''recordCentral NODO fase=0 cuarentena='' descarga='8,6,4,7,10,9' gestion='4,6,7,8,9,10''''
|}

Fijándonos en el campo "cuarentena=''" indica que ninguno de los nodos tiene problemas.

==== Comprobación del estado de ocupación del almacenamiento temporal de grabaciones en un nodo. ====

Desde un SSH ejecuta el comando '''''df - h''''' en la maquina donde creamos que debe estar ejecutando el proceso recordNod:

{|class="wikitable"
|-
! Filesystem !! Size !! Used !! Avail !! Use% !! Mounted on
|-
| udev || 486M || 4,0K || 486M || 1,00% || /dev
|-
| tmpfs || 100M || 416K || 99M || 1,00% || /run
|-
| '''/dev/vda1''' ||''' 236M''' ||''' 68M''' ||''' 156M''' ||''' 31,00% '''||''' /boot'''
|-
| tmpfs || 100M || 48K || 100M || 1,00% || /var/spool/asterisk/monitor

|}

Nos fijaríamos en la línea marcada en negrita, el campo "Use%" indicara el porcentaje de almacenamiento temporal de grabaciones en un nodo.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

===Escuchas e intrusiones en asterisk===
'''CallSpy''' es una aplicación elaborada para asterisk que permite a un usuario realizar escuchas e
intrusiones en llamadas.
En realidad tenemos dos aplicaciones en asterisk, CallSpy y CallSpyee.
====CallSpy ====
{|
|-
|
'''Nota:''' Como mucho se pueden tener a dieciséis personas al mismo tiempo usando esta aplicación.
|}

Como hemos mencionado anteriormente, esta aplicación permite la escucha de llamadas y,
opcionalmente, realiza la función de intrusión. Tiene tres opciones de configuración obligatorios
que mostramos a continuación:

{|
|-
|
CallSpy(<tipoEspiado>,<expRegEspiado>,<parametrosConf>)

|}
La opción '''<tipoEspiado>''' se refiere a que tipo de objeto que podemos espiar correspondiente, solo debe elegirse un único tipo:
*'''c:''' escuchar una cola
*'''v:''' escuchar un vdn
*'''a:''' escuchar a un agente
*'''e:''' escuchar extensión
La opción '''<expRegEspiado>''' representa el número de la cola, VDN, agente o extensión que queremos escuchar. Tiene que ser una expresión regular.
La opción '''<parametrosConf>''' se refiera a los parámetros de configuración para la llamada que podemos espiar, se pueden combinar o juntar :
*'''q:''' Desactiva el 'beep' al comienzo de cada nueva llamada.
*'''v([value]):''' Ajusta el volumen en el rango -4 a 4 (más alto, mas volumen).
*'''e:''' Habilita el que se pueda cambiar a otra llamada de la misma extensión.
*'''w:''' Habilita el que se pueda activar la intrusión (whisper).
Una vez iniciada la escucha, solo falta que entre una llamada al objetivo que estemos espiando. Al
iniciar la escucha, se puede hacer lo siguiente:
*Pulsando '''#''' modifica el volumen de escucha.
*Pulsando '''*''' cambia a una nueva llamada.
*Pulsando '''1''' si esta habilitado, cambia a otra llamada de la misma extensión.
*Pulsando '''2''' si esta habilitado, inicia la función de intrusión.
*Pulsando '''3''' desactiva la función de intrusión.
====CallSpyee (espiado)====
Mediante esta aplicación indicamos los parámetros que permite a una llamada ser seleccionada para
escuchar. Las opciones de configuración son:
{|
|-
|
CallSpyee([CID_NUM],[cola],[vdn],[agen],[exten])
'''Nota:'''No son parámetros obligatorios, por lo que no hace falta rellenar todos los campos pero si respetar sus posiciones separadas por comas.
|}
La explicación de los parámetros es la siguiente:
*'''CID_NUM:''' representa el call ID de la llamadas
*'''cola:'''representa el número de la cola que se quiere espiar (${QUEUE} ).
*'''vdn:''' representa el número del VDN que se quiere espiar (${VDN} ).
*'''agen:''' representa el número del agente que se quiere espiar.
*'''exten:''' representa el número de la extensión que se quiere espiar (${EXTENSION}) .

Por ejemplo si queremos escuchar todas las llamadas en las que participa una extensión determinada pondremos en la macro de extensiones:
{|
|-
|
exten => s,n,CallSpyee(,,,${EXTENSION})
|}

====Cambios para el dialplan de asterisk====
El funcionamiento de este tipo de servicio conlleva un cambio en el dialplan de asterisk. En cada macro correspondiente se pondrá los diferentes CallSpyee para VDN, colas , extensiones y agentes.
Pasos a seguir:
*Paso 1. Creación de un código de intrusión para cada tipo según necesidad (cola, VDN, agente y
extensión).
{|
|-
|
Ejemplo '''MD'''tel: declaramos como código de intrusión a Agente *44*NUMERO
;==========================================
;======== Intrusion a Agente
;==========================================
exten => _*44*X.,1,set(CadMarcar=intrusionEspiado)
exten => _*44*X.,n,set(DesL=SERVICIO)
exten => _*44*X.,n,set(datoServicio=^${EXTEN:4})
exten => _*44*X.,n,Goto(finMacro,1)
'''Nota:''' En la tercera línea podemos observar la expresión regular que se le pasara al CallSpy correspondiente con el número marcado por el espia. 
|}

*Paso 2.Llamar a CallSpy con la configuración deseada.
{|
|-
|
Ejemplo '''MD'''tel: llamada a CallSpy especificando que vamos a espiar una cola (la c del primer parámetro, con la
extensión introducida en el código de intrusión y con whisper, es decir, función de intrusión habilitada.
;------------------------------------------------------------------------
; Intrusion a Espiado
;------------------------------------------------------------------------
exten => intrusionEspiado,1,NoOp
exten => intrusionEspiado,n,GotoIf($["${datoServicio}"=""]?colgar)
exten => intrusionEspiado,n,CallSpy(c,${datoServicio},w)
exten => intrusionEspiado,n(colgar),Hangup
|}
* Paso 3. Llamar a CallSpyee con la configuración de las llamadas candidatas a ser escuchadas.
{|
|-
|
Ejemplo '''MD'''tel:
exten => s,n,CallSpyee(,,,,${EXTENSION}) → Para extensiones
exten => s,n,CallSpyee(,${QUEUE},,,) → Llamadas espiadas por cola
exten => s,n,CallSpyee(,,${VDN},,) → Llamadas espiadas por VDN
|}

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Calendarios ===

Para la configuración de los Calendarios se hace uso de '''CalDAV''', estándar de Internet que permite a un cliente acceder a información de planificación en un servidor remoto. Permite que varios clientes accedan a la misma información, facilitando la cooperación. Muchas aplicaciones, tanto clientes como servidores, son compatibles con este protocolo.

Si deseamos crear un calendario en la plataforma '''VIVAit''' podemos hacerlo siguiendo el siguiente enlace:
Para comprobar que el servidor de calendarios funciona correctamente bastaría con cargar en la barra de direcciones la siguiente url: [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Calendarios |Calendarios]]

http://${NODO.HOST}/dav/html/cal.php/calendars/${DAV.CUENTA}/${DAV.CALENDARIO}

donde,

* '''NODO.HOST:''' es la ip del servidor calendar
* '''DAV.CUENTA:''' hace referencia a la cuenta de usuario
* '''DAV.CALENDARIO:''' hace referencia el nombre de la cuenta

Una vez que se carga la url sabremos que el servidor funciona correctamente si visualizamos lo siguiente:

[[Archivo:Captura de pantalla de 2016-07-21 12_43_58.png || 1020px|center]]

Si el sistema nos pide usuario y clave querrá decir que el servidor de calendarios está operativo en esa maquina

Para comprobar que funciona en la consola de asterisk usaremos los comandos
calendar show calendars
calendar show calendar [nombreCalendario]

'''Nota:''' Debido bugs detectados, el proceso requerirá:
- La realización de una sincronización manual de la sección "mdcal" desde el portal de administración
- Añadir la línea '''''#include "/etc/asterisk/mdcal.conf"''''' en el fichero calendars.conf y hacer "reload" de asterisk
- En la máquina donde esté instalado el servidor de calendarios apuntar a la IP de la BDTR (/var/www/dav/config.php)

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Syslog de agentes ===
'''''Syslog''''' es un estándar para el envío de mensajes de registro en una red informática IP. Por '''''Syslog''''' se conoce tanto al protocolo de red como a la aplicación o biblioteca que envía los mensajes de registro. Se lanza automáticamente al arrancar un sistema Unix, y es el encargado de guardar informes sobre el funcionamiento de la máquina (eventos, seguridad del sistema, etc) pero puede contener también cualquier información como mensajes de las diferentes partes del sistema (núcleo, programas...) y los envía y/o almacena en diferentes localizaciones transmitiéndose mediante un puerto UDP. Esto permite concentrar los registros de múltiples máquinas en un único punto simplificando la labor de gestión al administrador siendo habitual que múltiples dispositivos lo soporten.

El formato del mensaje se compone de tres campos :

* La cabecera contiene la prioridad, fecha y hora del mensaje, máquina, proceso (nombre e identificador) que lo ha generado y la versión del protocolo utilizado.
* Una serie de pares clave-valor con metadatos.
* El texto del mensaje.

Si es necesario podemos activar el registro de todos los eventos telefónicos que realiza un agente ACD llamado '''Syslog de agentes'''. Su activación se realiza mediante el '''portal de administración ''VIVA''it''' configurando unos parámetros para un usuario llamado ''Rastreo BBDD" y ''Rastreo Syslog''. Para más información[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Pesta.C3.B1a_ACD | ver sección Portal de administración - General - Usuarios - Pestaña ACD ]].

{| class="wikitable" border="0" align="top"
|-
| align="center" style="background:Lavender; color:Black" |<big>'''Elemento'''</big>
|align="center" style="background:Lavender; color:Black" | <big>'''Procedimiento'''</big>
|-
!colspan="2" width="60 px" style="background:Lavender; color:Black"|Operacion
|-
|Ubicación del proceso||Script arranque: /etc/init/ rsyslog.conf
Configuración :
/etc/rsyslog.d/30-vivait-
desk.conf
|-
|Arranque||service rsyslog start
|-
|Parada||service rsyslog stop
|-
|Reinicio||service rsyslog reload
|-
!colspan="2" width="60 px" style="background:Lavender; color:Black"|Diagnostico
|-
|Registro de logs||/var/log/MDtel/vivait-desk.log
Fichero del día actual. se guardan los 30
anteriores comprimidos en tar.g
|}

=== Generación de un Core ===
Un Core es la memoria de un programa.

Para generar un Core rápido con Asterisk hay que hacer lo siguiente:

Ejecutar ps aux | grep asterisk y coger el PID del programa
gdb /usr/sbin/asterisk [PID]
gcore [file]

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==Funcionalidades específicas ==
=== Mecanismo de prioridad adaptativa ===

El mecanismo de prioridad adaptativa permite en una plataforma '''''VIVA'''''it Suite establecer prioridades en las que se tenga en cuenta el tiempo de espera de las llamadas en cola, proporcionando una alternativa al mecanismo de prioridad absoluta que existe por defecto

==== Introducción ====

Este documento presenta una propuesta de mecanismo de asignación de llamadas en colas a agentes basado no solo en las prioridades de agente a cola,
sino en un factor de corrección de prioridad derivado del tiempo de espera de una llamada

==== Terminología ====

* '''Prioridad de llamada:''' A cada llamada susceptible de ser atendida en el ''Call Center'' se le asignará una prioridad de llamada; dicha prioridad será asignada cada vez que un agente quede disponible.
* '''Prioridad de grupo ACD:''' Los agentes del ''Call Center'' tendrán configurada una prioridad para cada grupo ACD al que pertenecen
* '''Tiempo de espera:''' Tiempo que una llamada lleva en espera en un determinado grupo ACD; si la llamada cambia de un grupo ACD a otro el tiempo de espera pasa a cero
* '''Objetivo de servicio:''' Tiempo objetivo máximo de espera por cada grupo ACD

'''Nota.-''' ''En terminología Asterisk el aumento de prioridad corresponde con números descendentes, es decir, 
prioridad 50 es mejor que prioridad 70''

==== Mecanismo de asignación de llamadas ====

En el momento en que exista un agente disponible para recibir llamada, el agente recepcionará la llamada con mejor prioridad de llamada (menor número). La prioridad de llamada para cada llamada se establecerá de la siguiente manera:

- Agentes con prioridad de grupo ACD de 1 a 99 utilizarán el mecanismo convencional de asterisk de prioridad absoluta; será útil para grupos ACD críticos o en Call Centers muy convencionales

'''Si un agente tiene prioridad menor de 100 en grupos ACD y hay llamadas en dichos grupos, estas llamadas serán atendidas por el agente con prioridad absoluta.'''

- Agentes con prioridad de colas de 100 en adelante; se utilizará el siguiente mecanismo de prioridad ponderada:

:*Si el grupo ACD de la llamada está dentro del objetivo de servicio, la prioridad de llamada será la prioridad de grupo ACD (a efectos prácticos se aplicará el mecanismo convencional de asignación de llamada a agente, equitativo entre grupos ACD con misma prioridad)

:*Si el grupo ACD de la llamada está fuera del objetivo de servicio, se aplicará una ponderación que mejorará la prioridad de la llamada a medida que aumente el tiempo de espera:

[[Archivo:Formula.png |center]]

En una configuración de igualdad de prioridad de agente y objetivo de servicio, el tiempo de espera influiría de manera determinante (más o menos en
función del peso) en la asignación de la siguiente llamada
El peso podrá adquirir tres posibles valores: 0, 1 y 10

[[Archivo:Esquema.png |center]]

- Calculo prioridad de llamada: se calcula por llamada cada vez que un agente queda libre
- Agente atiende llamada con mejor prioridad de llamada



[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Marcación saliente ===
Dentro del ACD hay un comportamiento especial que es la marcación saliente. Esta puede ser de tres tipos:
* '''Vista previa''': El agente demanda la siguiente llamada a realizar.
* '''Progresivo''': Se llama al agente y se lanza la llamada al contacto.
* '''Predictivo''': El sistema calcula cuando va a estar libre el agente y se adelanta lanzando varias llamadas (configurables por parámetros). La llamada que es contestada primero, se pasa a una cola (el resto se cuelgan) a la espera que el agente se quede libre.

====Esquema de funcionamiento====
[[Archivo:esquema funcionamiento marcador.jpg|center|500px]]

Los contactos se agrupan en listas para su facilidad de asignación a campañas, aunque finalmente lo que se asigna a una campaña es un contacto.

Las campañas tienen estrategias. Las estrategias definen como se ha de llamar (del primero al último, sólo los pares, etc.). Tienen una serie de parámetros que dependiendo de la estrategia pueden tener distinta utilidad. Desde el punto de vista de la base de datos, las estrategias se definirían en la tabla ACD_CLASES_ESTRATEGIAS y se les da valor en la tabla ACD_ESTRATEGIAS_MARCADOR.
Una vez establecida la campaña y asignados sus contactos y dependiendo del modo de marcación (que se define en las colas) el proceso motorSal crea los intentos de marcación (siempre y cuando no estén en las listas Robinson), que serán leídos por el proceso myAcdSuperv que los convierte en llamadas para el Asterisk.

====Flujo de estados====

El flujo de estados es el reflejado en la figura siguiente:

[[Archivo:diagrama de flujo motorsal.png|center|800px]]

Los diferentes estados de un contacto son:
{| class="wikitable sortable"
|-
! Estado !! ID_Estado!! Descripción
|-
| Planificable || 0|| El contacto está preparado para que lo gestione motorSal y según la estrategia definida se establece el campo ACD_CONTACTOS_CAMPANNAS.D_HORA_PROXIMA
|-
|Planificado||10||Cuando ha llegado el tiempo marcado en HORA PROXIMA, motorSal ejecuta la 2ª fase de la estrategia, generando el intento de marcación.
|-
|Intento||20||El control pasa a myAcdSuperv, que a su vez genera la llamada en Asterisk. Cuando termina, se pasa a Planificable o Finalizado.
|-
|Finalizado||100||Las gestiones con este contacto han terminado.
|-
|Abortado||110||
|-
|Obsoleto||200||Se ha agotado el tiempo para contactar sin agotar todos los intentos. No se le vuelve a llamar nunca.
|-
|}

====Carga de contactos====

===== Descripción =====

A continuación se explica la configuración y funcionamiento de la utilidad encargada de asignar contactos a campañas.

===== Configuración =====

El archivo de configuración recibe el nombre de '''cargaContactos.pconf.''' Este archivo reside en '''/etc/MDtel.''' El formato se describe en la tabla siguiente. Hay que tener en cuenta que las columnas empiezan a numerarse en 0.

{| class="wikitable" style="text-align:center;"
|-
! Parámetro !! Valor !! Obligatorio !! Defecto
|-
| db|| Nombre de la base de datos|| SI || nimitz
|-
| dbHost|| Host MySQL || SI || localhost
|-
| dbPort|| Puerto MySQL || NO || 3306
|-
| dbUsuario || Usuario de acceso a la base de datos|| SI ||
|-
| dbClave || Clave del usuario || SI ||
|-
| rutaContactos || Ruta hasta el archivo de contactos || NO || /var/spool/MDtel/contactos
|-
| obsoletos || Si vale 1, marcar como obsoletos los contactos anteriores || NO || 0
|-
| diasCaducidad || Número de dias a partir de los cuales caducarán los contactos || SI ||
|-
| idCampanna || Número de columna que contiene el ID de la campaña || SI||
|-
| idLista || Numero de columna que contiene el ID de la lista || SI ||
|-
| prioridad || Número de columna que contiene la prioridad || NO || Nota: El valor es de 0 a 99. A mayor número mayor prioridad (se le llamará '''ANTES''')
|-
| tipoTarea|| Número de columna que contiene el tipo de tarea || NO || Nota: los posibles valores de la columna son : *A: Alta *M: Modificación *B: Baja Por defecto el valor es A
|-
| codCli || Número de columna del CSV que contiene el código de cliente || SI ||
|-
| nombreCon || Número de columna del CSV que contiene el nombre || NO ||
|-
| apellido1 || Número de columna del CSV que contiene el primer apellido|| NO ||
|-
| apellido2 || Número de columna del CSV que contiene el segundo apellido || NO ||
|-
| empresa || Número de columna del CSV que contiene la empresa || NO ||
|-
| direccion1 || Número de columna del CSV que contiene la dirección || NO ||
|-
| direccion2 || Número de columna del CSV que contiene la dirección 2 || NO ||
|-
| codPostal || Número de columna del CSV que contiene el código postal || NO ||
|-
| localidad || Número de columna del CSV que contiene la localidad || NO ||
|-
| provin || Número de columna del CSV que contiene la provincia || NO ||
|-
| email || Número de columna del CSV que contiene el email || NO ||
|-
| valFijo_1 || Número de columna del CSV que contiene el primer número fijo del contacto || SI ||
|-
| valFijo_2 || Número de columna del CSV que contiene el segundo número fijo del contacto || NO ||
|-
| valFijo_3 || Número de columna del CSV que contiene el tercer número fijo del contacto || NO ||
|-
| valFijo_4 || Número de columna del CSV que contiene el cuarto número fijo del contacto || NO ||
|-
| valMovil_1 || Número de columna del CSV que contiene el primer número móvil del contacto || SI ||
|-
| valMovil_2 || Número de columna del CSV que contiene el segundo número móvil del contacto || NO ||
|-
| valMovil_3 || Número de columna del CSV que contiene el tercer número móvil del contacto || NO ||
|-
| valMovil_4 || Número de columna del CSV que contiene el CUARTO número móvil del contacto || NO ||
|-
| edad || Número de columna del CSV que contiene la edad || NO ||
|-
| nOpc1|| Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc2 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc3 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc4 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc5 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc6 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc7 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc8 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| cOpc1 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc2 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc3 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc4 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc5 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc6 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc7 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc8 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| Idioma || Idioma del contacto || NO ||
|-
|}

===== Funcionamiento =====

Para ejecutar la utilidad se debe teclear la siguiente orden en la línea de comandos:

'''cmd# cargaContactos.pl /<ruta hasta el conf>/cargaContactos.pconf <archivo CSV>'''

El archivo con los contactos deberá ser un CSV con los campos separados por ';'. La utilidad parsea el archivo conforme a la distribución indicada en la configuración y crea las correspondientes entradas en las tablas '''ACD_CONTACTOS''' y '''ACD_CONTACTOS_CAMPANNAS.'''

La utilidad crea un log en '''/var/log/cargaContactos.log''' en el que vuelca toda la operativa.
Por pantalla se va mostrando un lista con el ID asignado al contacto y el ID de campaña al que se le ha asignado.

Un ejemplo de fichero de carga de contactos sería el siguiente:

#
# Configuracion de recordGwd.pl
#
# Conexion de base de datos
$db='nimitz';
$dbHost = 'localhost';
$dbPort = '3306';
$dbUsuario = 'nimitz';
$dbClave = 'LA QUE SEA';
$diasCaducidad='300';
$rutaGrab = '/var/spool/MDtel/contactos';
$idCampanna = '31';
$idLista = '32';
$obsoletos = 0;
$codCli = '1';
$nombreCon = '2';
$apellido1 = '3';
$apellido2 = '4';
$empresa = '5';
$direccion1 = '6';
$direccion2 = '7';
$codPostal = '8';
$localidad = '9';
$provin = '10';
$email = '11';
$valFijo_1 = '12';
$valFijo_2 = '13';
$valFijo_3 = '14';
$valFijo_4 = '15';
$valMovil_1 = '16';
$valMovil_2 = '17';
$valMovil_3 = '18';
$valMovil_4 = '19';
$edad = '20';
$nOpc1 = '21';
$nOpc2 = '22';
$nOpc3 = '23';
$nOpc4 = '24';
$cOpc1 = '25';
$cOpc2 = '26';
$cOpc3 = '27';
$cOpc4 = '28';
$prioridad = '29';
$tipoTarea = '30';

====Comportamiento de reprogramaciones de llamadas en función del estado del agente====

Se ha preparado la siguiente maqueta:

Campaña saliente.
Cola saliente progresiva.
Dos agentes logados en VIVAit Suite.

En el formulario de la llamada se indica: llamada redirigida
Se selecciona el "check dirigida"

Las posibilidades de prueba son dos: "'''Cualquier agente'''" y "'''Solo agente'''"

Resultados son los siguientes:

{| class="wikitable sortable"
|-
| '''Estado del agente''' || '''Modo Cualquier Agente'''|| '''Modo Solo Agente'''
|-
| '''Agente Preparado''' || Entra llamada a agente|| Entra llamada a agente
|-
|'''Agente en Pausa'''||Entra llamada a otro agente disponible||Espera a agente y entra llamada.
|-
|'''Agente Hablando'''||Espera a agente y entra llamada||Espera a agente y entra llamada.
|-
|'''Agente en Tiempo administrativo'''||Espera a agente y entra llamada||Espera a agente y entra llamada.
|-
|'''Agente no logado'''||Entra llamada a otro agenete disponible||Consume intento.
|-
|'''Agente con una pestaña de chat abierta y el otro agente en pausa'''||Entra llamada a otro agente disponible||Espera a agente y entra llamada.
|-
|'''Agente con dos pestañas de chat abiertas'''||Espera a agente y entra llamada||Espera a agente y entra llamada.
|-
|}

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Movilidad ===
La movilidad es una función integral de las comunicaciones en la empresa. Cualquier empleado (usuario) es móvil en cierto grado, ya sea dentro o fuera de la organización. La solución óptima debe proporcionar continuidad de servicios y acceso a nuestros servicios, sin importar donde estemos.

==== Ofrecer movilidad a un usuario ====

Para permitir la movilidad a un usuario, puede ser en el momento de crear o editar un usuario en el apartado ''Administración de usuario'' en ''General'' del '''portal de administración ''VIVA''it'''. Asignándole un '''''numero login''''' (numero personal corporativo para el usuario) y una '''''clave login''''' ( se debe asignar una clave por defecto, pero puede cambiarla en el [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_3.0#Portal_de_usuario |portal de usuario]]). Para más información[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Pesta.C3.B1a_Centralita | ver sección Portal de administración - General - Usuarios - administración de usuarios - Pestaña Centralita]].

Además, de crear un permiso de la '''aplicación ''Centralita''''' a cualquier nivel, desde el apartado ''Permisos de usuarios'' en ''General'' del '''portal de administración ''VIVA''it'''. Para más información[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Asignaci.C3.B3n_de_Permisos_de_Usuario_por_Administrador | ver sección Portal de administración - General - Usuarios - Permisos a usuarios]]

'''La movilidad permite''' disponer de las extensiones telefónicas empresariales en cualquier lugar. Por
ejemplo, con un ordenador portátil o smartphone en una ubicación remota con conexión a Internet,
podríamos tener registrada nuestra extensión remotamente, y así las llamadas hacia/desde nuestra
oficina serían enrutadas por Internet hasta el equipo en cuestión sin coste alguno.


Todo terminal tiene asociado una extensión y deberá permitir la movilidad de usuarios. La extensión se configura cambiando a '''''SI''''' el campo '''''Hay Movilidad''''' desde el apartado ''Extensiones'' de ''Dispositivos'' en ''VIVAit Call'' del '''portal de administración ''VIVA''it'''. Para más información [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Extensiones | ver sección Portal de administración - VIVAit Call - Dispositivos - Extensiones]]

==== ¿Cómo funcionan las extensiones? ====

Primeramente el usuario debe tener los ejes apropiados en la tabla '''COM_USUARIOS_APLICACION''' (aplicación centralita).

La extensión debe de tener ''un teléfono'' y por tanto ''un modelo de teléfono asociado.''

Es tan simple como especificar '''la extensión, el usuario y la clave de este.'''

Para corroborar el funcionamiento de esta hay ''dos métodos'':

'''* CLI asterisk:'''

'''mdintz qry * nimitz bd extenEntraUsuarioMovil 25001 20001 1234'''

Y como resultado obtenemos lo siguiente:

mdintz Variables: 
MdintzIdentif='cms1' 
MOVIL_TIPO_RESET='10' 
MOVIL_CAD_RESET='notify_yealink' 
MdintzRes='OK'

El usuario con el login numérico 20001 se ha "movido" a la extensión 25001

Ahora ''nos quitamos de esa extensión mediante el siguiente comando:''

'''mdintz qry * nimitz bd extenSaleUsuarioMovil 25001'''

Resultado del comando:

mdintz Variables: 
MdintzIdentif='cms1' 
MOVIL_TIPO_RESET='10' 
MOVIL_CAD_RESET='notify_yealink' 
MdintzRes='OK'

Las pruebas anteriores han sido '''con extensiones con movilidad y con usuario con/sin
propietario.'''

Ahora las realizamos '''con extensiones sin movilidad'''

'''mdintz qry * nimitz bd extenEntraUsuarioMovil 25002 20001 1234'''

Obteniendo:

mdintz Variables: 
MdintzIdentif='cms1' 
MdintzRes='movil_error_datos'

Como era lo previsible no nos deja "movernos" a esa extensión ya que no tiene movilidad.


'''Si un usuario ya se ha movido a una extensión y se mueve a otra, el sistema lo deslogará de la primera para logarlo en la segunda.'''

'''mdintz qry * nimitz bd extenEntraUsuarioMovil 21000 20001 1234'''

Con salida:

mdintz Variables: 
MdintzIdentif='cms1' 
MOVIL_EXTEN='25001' 
MDintzRes='movil_ya_login'

'''* Dialplan'''

Para llamar a la función de movilidad hay que marcar el '''9992.'''

Nota.- Para comprobar que se realiza todo correctamente habría que mirar las trazas de Asterisk

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Grabación ===

La grabación en '''''VIVA'''''it Call está diseñada para ser lo mas flexible posible.

====Configuración====

Si deseamos grabar, debemos activar que alguno de los dispositivos/elementos que intervienen en la llamada se grabe.

Estos dispositivos/elementos son:

* Nodo.
* Usuario con Centralita.
* Agente.
* Grupo ACD corporativo y de Contact Center.
* Enlace exterior.
* Extensión.
* Facilidades.
* Grupo: grupo de salto o grupo de operadoras.
* Sala de conferencia.
* VDN corporativo y de Contact Center.
* Pre-rutas.

Por otro lado necesitaremos que la llamada pase por un nodo que sea grabador, es decir, que si la llamada esta configurada para que se grabe pero no pasa por ningún nodo grabador, la llamada no se grabará.

Al configurar un nodo existen cuatro campos que intervienen en la grabación.

''''Grabador''''

Se configura en el portal en la sección general/nodos.

Este campo corresponde con el campo [[BD.COM_NODOS#B_ES_GRABADOR|B_ES_GRABADOR]] de la tabla [[BD.COM_NODOS|COM_NODOS]] , este campo define si el nodo va a grabar las llamas que pasen por el que necesiten ser grabadas y no se estén grabando ya.

Es un campo booleano los posibles valores en el portal son si/no y en la base de datos 1/0.

''''Modo grabación infraestructura''''

Su configuración se realiza en el portal, en la sección general/nodos.

Este campo define como está configurada la infraestructura, este campo existe por compatibilidad con '''''VIVA'''''it suite y para poder configurar la grabación bajo demanda.

Este campo corresponde con el campo [[BD.COM_NODOS#E_MODO_GRABACION_INFRAESTRUCTURA|E_MODO_GRABACION_INFRAESTRUCTURA]] de la tabla [[BD.COM_NODOS|COM_NODOS]], Este campo usa los valores del enumerado BD.ENUM.TModoGrabacionInfraestructura|TModoGrabacionInfraestructura]].

La formula que se seguiría para ver si una llamada se graba en ese nodo es:
{|
|
|-
|
(NODO.E_MODO_GRABACION_INFRAESTRUCTURA) AND (NODO.B_ENRU_GRABAR OR CEN_PRE_RUTA.B_ENRU_GRABAR OR "OBJETO".B_ENRU_GRABAR)
|}

Que sería que si la infraestructura esta en NoGraba no se graba nada de lo que se rute en ese nodo y en cualquiera de los 2 otros caso (GrabaTodo o GrabaPorPeticion) se grabaría dependiendo de la configuración del Nodo, la ruta o el objeto en cuestión (preruta, grupo ACD, extension,...).

''''Grabar enrutamiento''''

Se configura en el portal en la sección general/nodos.

Este campo define si van a grabar las llamadas que se enruten en este nodo.

Campo [[BD.COM_NODOS#E_ENRU_GRABAR|E_ENRU_GRABAR]] de la tabla [[BD.COM_NODOS|COM_NODOS]] que usa los valores del enumerado [[BD.ENUM.TTipoEnruGrabar|TTipoEnruGrabar]].

''''RecordCentral''''

Se configura en el portal en la sección general/nodos.

Define que instancia del recordCentral es la encargada de tratar las grabaciones de este nodo.

Para aumentar el rendimiento a la hora de traerse las grabaciones, se pueden definir varias instancias de proceso recordCentral, este campo define cual de estas instancias se encargara de este nodo.

====Vivait Tracker====

Desde '''''VIVA'''''it Supervisor, que es la aplicación dirigida a Supervisores, ofrece la posibilidad de supervisar y gestionar grupos ACD, agentes, asignaciones, prioridades,etc. Se puede obtener acceso directo a las aplicaciones de grabación ('''''VIVA'''''it tracker)


Esquematico actual del proyecto tracker
[[Archivo:Esquematico_tracker_1.jpg|center]]

1º El tracker web llama al web service Remote login para iniciar sesión y determinar si tiene permisos para la escucha y descarga de grabaciones.

2º Si la ubicación de la grabación es local, mira la ruta de esta y se procede a la escucha o descarga de esta.

3º Si la ubicación de la grabación es remota, entra en escena el proxy. Es el que realiza la petición.

4º Si utilizamos el tracker windows, este, como el tracker web, llama primero al web service remote login para la autenticación y tema de Permisos.

5º Para descargar o escuchar una grabación desde el tracker windows, se llama al web service servidor de grabaciones pasándole simplemente el ID de segmento.mp3. Este web service, con el ID de segmento, se encarga de determinar la ubicación de la grabación.

Esquematico actual del proyecto tracker
[[Archivo:Esquematico_tracker_2_https.jpg|center]]

1º El tracker web llama al web service Remote login para iniciar sesión (comunicación https) y determinar si tiene permisos para la escucha y descarga de grabaciones. Se elimina el proxy

2º Si la ubicación de la grabación es local, mira la ruta de esta y se procede a la escucha o descarga de esta.

3º Si la ubicación de la grabación es remota, se realiza una petición al host remoto. El tipo de petición vendrá fijada por base de datos (http, https, ftp,ftps)

4º Si utilizamos el tracker windows, este, como el tracker web, llama primero al web service remote login para la autenticación y tema de permisos (comunicación https extremo a extremo).

5º Para descargar o escuchar una grabación desde el tracker windows, se llama al web service servidor de grabaciones pasándole simplemente el ID de segmento.mp3. Este web service, con el ID de segmento, se encarga de determinar la ubicación de la grabación.

[[#Grabación_(Vivait_Tracker)| Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operación_plataforma_VIVAit Volver al indice]]

=== Enrutamiento ===

[[Archivo:Enrutamiento.png|885px |center]]

==== Enfoque inicial ====

[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Enfoque_inicial Acceso]

==== Funcionamiento ====
El proceso de enrutamiento, como vimos en el esquemático, se compone de dos fases:

# Preenrutameinto, que se encarga de tratar todas las llamadas
# Enrutamiento externo, que tiene módulos dedicados al enrutamiento hacia:
:*Enlaces externos.
:*Extensiones.
:*Usuarios de telefonía corporativa.
:*Facilidades.
:*Salas de conferencia.
:*Agentes de grupos ACD.
:*Grupos ACD.
:*Vdn.
:*Buzones para dejar mensaje.
:*Buzones para su gestión.

Se asume que existen rutas directas entre todos los nodos de la red.

Se asume que están directamente enrutadas todas las direcciones IP involucradas, tanto nodos, como terminales.

Se asume que todas las facilidades están disponibles en todos los nodos, aunque es posible que la implementación sea diferente entre ellos.

Los datos de entrada básicos al proceso de enrutamiento (pdEntr) son:
* Dispositivo
* Cola
* Origen
* Nodo entrada
* UCID
* CALLER_ID_NAME
* CALLER_ID_NUM
* DNIS
* Desvío por dialplan

A partir de los datos de entrada básicos anteriores se pueden deducir los siguientes valores:
* Sede del dispositivo de entrada
* Sede del nodo de entrada
* Ancho de banda disponible en la sede del dispositivo
* Ancho de banda disponible en la sede del nodo
* Categoría entrante
* Valor del eje1 asignado a la llamadas
* CALLER_ID_NUM_EXTERNO

Los datos de salida globales del proceso de enrutamiento (pdSale) son:
* Categoría saliente
* Código de cliente (opcional)
* Tipo de destino:
:* No existe
:* Ruta externa
:* Extensión
:* Usuario de telefonía corporativa
:* Facilidad
:* Salas de conferencia
:* Agentes de grupos ACD
:* Grupos ACD
:* VDN
:* Buzón para dejar mensaje.
:* Buzón para dejar mensaje por ocupado.
:* Buzón para dejar mensaje por no contestación.
:* Buzón para su gestión.
* Destinatario (cuando se trata de un usuario o de un agente)
* Valor del eje1 asignado a la llamada
* Buzón de las extensiones y usuarios que los tengan asignados
* Si el buzón está en nodo distinto al de entrada
* DESVIO_INCONDICIONAL (sólo extensiones y usuarios) (valor MENSA=desvio_mensajeria en variable)
* DESVIO_NO_CONTESTA (sólo extensiones y usuarios) (valor MENSA=desvio_mensajeria en variable)
* DESVIO_OCUPADO (sólo extensiones y usuarios) (valor MENSA=desvio_mensajeria en variable)
* DESVIO_FUERA_SERV (sólo extensiones y usuarios) (valor MENSA=desvio_mensajeria en variable)

Los datos de salida para cada una de las posibles rutas en orden son (nn va de 01 maxRutas [nn son dos dígitos decimales]):
* CONTADOR_ABDE_nn (contador para control de ancho de banda en sede de dispositivo de entrada).
* CONTADOR_ABNE_nn (contador para control de ancho de banda en sede de nodo de entrada).
* CONTADOR_ABDS_nn (contador para control de ancho de banda en sede de dispositivo de salida).
* CONTADOR_ABNS_nn (contador para control de ancho de banda en sede de nodo de salida).
* CALLER_NAME_SAL_nn , puede salir de una extensión, un usuario o de un agente.
* CALLER_NUM_SAL_nn, puede salir de una extensión, un usuario o de un agente.
* DESTINO_SAL_nn , en general, el valor C_NOMBRE o destino de salida.
* RUTA_NODO_nn , Cadena de marcación para ir la nodo que soporta DESTINO_SAL_nn, si es distinto del nodo de entrada.
* RUTA_SAL_nn
:* Extensión: cadena marcación.
:* Facilidad: E_CODIGO_FACILIDAD obtenido de la tabla CEN_FACILIDADES.
:* Usuario: cadena marcación de la extensión asignada al usuario en movilidad o en propiedad.
:* Agente: cadena marcación de la extensión a la que está conectado el agente.
:* Ruta externa: contexto que gestiona la llamada saliente.

=====Fase preenrutamiento =====

La fase de preenrutamiento (basada en la tabla CEN_PRE_RUTA) se usa en todas las llamadas entrantes, tanto internas, como externas. Permite desarrollar un “prerouting” estándar para ACD y para telefonía corporativa.

Los datos de entrada al proceso de enrutamiento son iguales a los del proceso global de enrutamiento, excepto en que este proceso no usa el nodo de entrada ya que es independiente de éste.

Los datos de salida de la fase de preenrutamiento:
* D_CATEGORIA_SAL
* COD_CLIENTE (opcional)
* TIPO_DESTINO_SAL
:* No existe.
:* Volver a preenrutar.
:* Ruta externa.
:* Extensión.
:* Usuario de telefonía corporativa.
:* Facilidad.
:* Sala de conferencia.
:* Agente de grupos ACD.
:* Grupos ACD.
:* VDN.
:* Buzón para dejar mensaje.
:* Buzón para dejar mensaje por ocupado.
:* Buzón para dejar mensaje por no contestación.
:* Buzón para su gestión.
* COD_CLIENTE
* Valor del eje1 asignado a la llamada
* CALLER_NAME
* CALLER_NUM
* DESTINO

El proceso de preenrutamiento consiste en seleccionar un único registro de la tabla CEN_PRE_RUTA y, con sus valores y con los valores de entrada al proceso, generar los datos de salida.

Un posible tipo de salida es "Volver a preenrutar". Esto permite realimentar el proceso un máximo de "max_pre_ruta_regs" veces (en archivo .conf) para simplificar configuración. Sólo tiene sentido realimentar si se ha hecho alguna modificación en los datos de selección de registro, ya que en caso contrario se produciría un bucle que el proceso de preenrutamiento es capaz de detectar y evitar.

Para elegir el registro de CEN_PRE_RUTA, se tienen en cuenta los datos de entrada de la llamada, de modo que se cumpla con todos los puntos siguientes:
* ID_CATEGORIA_ENT igual a la del dispositivo de entrada.
* CALLER_NUM de entrada
:* Debe comenzar por la cadena C_ORIGEN_ENT_PREF o C_ORIGEN_ENT_PREF=NULL, con menos prioridad. Es conveniente rellenar este dato del modo más restrictivo que sea posible, independientemente de C_ORIGEN_ENT_EXPR. Ello permite disminuir el uso innecesario de recursos de evaluación de expresiones regulares.
:* Debe de tener un número de dígitos igual o superior a N_ORIGEN_ENT_MIN_DIGITOS, si este valor no es NULL o cero.
:* Debe de tener un número de dígitos igual o inferior a N_ORIGEN_ENT_MAX_DIGITOS, si este valor no es NULL o cero.
:* Debe cumplir la expresión regular C_ORIGEN_ENT_EXPR, si ésta no es NULL.
* DNIS empiece con C_DESTINO_ENT_PREF o C_DESTINO_ENT_PREF=NULL. Es conveniente rellenar este dato del modo más restrictivo que sea posible, independientemente de C_DESTINO_ENT_EXPR. Ello permite disminuir el uso innecesario de recursos de evaluación de expresiones regulares.
* Si varias entradas cumplen la condición anterior, se prueba primero la que el campo C_DESTINO_ENT_PREF tenga una longitud mayor y, de entre éstas, la que C_ORIGEN_ENT_PREF tenga una longitud mayor.
* DNIS tenga un número de dígitos igual o superior a N_DESTINO_ENT_MIN_DIGITOS, si este valor no es NULL o cero.
* DNIS tenga un número de dígitos igual o inferior a N_ORIGEN_ENT_MIN_DIGITOS, si este valor no es NULL o cero.
* DNIS cumpla la expresión regular C_DESTINO_ENT_EXPR, si ésta no es NULL.

Si no se encuentra ninguna entrada adecuada, quiere decir que es una llamada prohibida y se devuelve el tipo de destino "No existe".

Puede conseguirse un destino "por defecto" diferente, creando una entrada que encaje siempre para cada categoría: C_ORIGEN_ENT, C_ORIGEN_ENT_MIN_DIGITOS, C_ORIGEN_ENT_MAX_DIGITOS, C_ORIGEN_ENT_EXPR, C_DESTINO_ENT_PREF, N_DESTINO_ENT_MIN_DIGITOS, N_DESTINO_ENT_MAX_DIGITOS y C_DESTINO_ENT_EXPR a valor NULL.

Una vez elegida una entrada, ésta puede transformar o sustituir el valor de ID_CATEGORIA, CALLER_NAME, CALLER_NUM, DESTINO, COD_CLIENTE y/o EJE1_MSK a la salida del proceso.

Si ID_CATEGORIA_SAL es cero, se propaga a la salida el valor de la entrada. En caso contrario, se sustituye.

Si C_CALLER_NAME está vacío, se mantiene el valor hubiese a la entrada. En caso contrario, se sustituye.

C_CALLER_NUM puede contener una cadena que identifica el nuevo CALLER_NUM. Además, si la cadena comienza por los caracteres que se indican, el significado es especial:
* "=" o cadena vacía, el nuevo CALLER_NUM es igual al de entrada al proceso.
* "+" el nuevo CALLER_NUM es igual al de entrada al proceso, con los caracteres a continuación de "+" como prefijo.
* "-" se quita el número de caracteres que se indica a continuación de "-".
* "_" lo que sigue al carácter es una expresión regular que se aplica al CALLER_NUM de entrada. Dicha expresión regular tiene obligatoriamente que contener una subcadena (definida entre paréntesis, según el estándar de expresiones regulares) que nos da el nuevo CALLER_NUM de salida. Si la expresión regular no se cumpliese, se propagará el valor de entrada al proceso.
* cualquier otro valor del primer carácter determina que es una constante que sustituye el valor a la entrada.

Cada vez que se utilice una preruta, se incrementará el valor de N_CONTA si el valor de N_UMBRAL es mayor que cero.

Un valor N_UMBRAL mayor que cero permite modificar el destino de salida cuando el valor de actual de N_CONTA (antes de incrementarse) supere o sea igual el valor de N_UMBRAL. Si se cumple la condición indicada, se usa como destino tras el preenrutamiento, los valores de los campos E_TIPO_DESTINO_SAL_2 y C_DESTINO_SAL_2.

Si el valor de N_UMBRAL es menor o igual a cero o si N_CONTA es inferior a N_UMBRAL, se usa como destino tras el preenrutamiento, los valores de los campos E_TIPO_DESTINO_SAL_1 y C_DESTINO_SAL_1.
Con este mecanismo de N_CONTA y N_UMBRAL, se pretende facilitar el discriminar a los llamantes reincidentes, cuando sea necesario.

Un proceso periódico externo debe encargarse de poner a cero o decrementar el valor de N_CONTA.
Como resultado de los procesos de filtrado y de verificación anteriores, se habrá obtenido un TIPO_DESTINO_SAL y un C_DESTINO_SAL a partir de los campos con sufijo "_1" o "_2", con una metodología similar al caso C_CALLER_NUM.

C_DESTINO_SAL_x puede contener cadena que permite obtener el nuevo destino. Además, si la cadena comienza por los caracteres que se indican, el significado es especial:
* "=" o cadena vacía, el nuevo destino es igual al de entrada al proceso.
* "+" el nuevo destino es igual al de entrada al proceso, con los caracteres a continuación de "+" como prefijo.
* "-" se quita el número de caracteres que se indica a continuación de "-".
* "_" lo que sigue al carácter es una expresión regular que se aplica al destino de entrada. Dicha expresión regular tiene obligatoriamente que contener una subcadena (definida entre paréntesis, según el estándar de expresiones regulares) que nos da el nuevo destino de salida. Si la expresión regular no se cumpliese, quiere decir que es una llamada prohibida y se encaminará hacia una facilidad por defecto.
* cualquier otro valor del primer carácter determina que es una constante que sustituye el valor a la entrada.
Información de salida del proceso de preenrutamiento: Cuando TIPO_DESTINO_SAL_x toma los valores que se indican, el proceso global de enrutamiento sólo requiere de preenrutamiento y la información a devolver se obtiene dependiendo de TIPO_DESTINO_SAL_x:
* No existe: Se asume que no se conoce un destino para los datos de entrada, por lo que la llamada se encamina hacia una facilidad por defecto que gestiona su tratamiento.
* Extensión: A partir de las tablas CEN_DISPOSITIVOS, CEN_EXTENSIONES y CEN_NODOS, se devolverán los valores que permiten alcanzar la extensión en el nodo principal y en el secundario.
* Facilidad: A partir de las tablas CEN_DISPOSITIVOS, CEN_FACILIDADES y CEN_NODOS.
* Usuario de telefonía corporativa: A partir de las tablas CEN_USUARIOS, CEN_DISPOSITIVOS, CEN_EXTENSIONES y CEN_NODOS, se devolverán los valores que permiten alcanzar al usuario en el nodo principal y en el secundario de la extensión que corresponde en base a movilidad, con prioridad, o en base a propiedad. El caso de movilidad no se tiene en cuenta si el proceso de enrutamiento se realiza en "modo supervivencia".
* Sala conferencia: A partir de las tablas CEN_SALAS_CONFERENCIAS y CEN_NODOS.
* Agente de ACD: A partir de las tablas ACD_USUARIOS, DAT_TR_ACD_EXTENSIONES, CEN_DISPOSITIVOS, CEN_EXTENSIONES y CEN_NODOS, se devolverán los valores que permiten alcanzar al agente en el nodo principal y en el secundario.
* VDN: A partir de las tablas ACD_VDN y CEN_NODOS, se devolverán los valores que permiten alcanzar al VDN en su nodo.
* Grupo ACD: A partir de las tablas ACD_COLAS y CEN_NODOS, se devolverán los valores que permiten alcanzar al grupo ACD en su nodo.

El campo B_GENERAR_SEGMENTO de la tabla CEN_PRE_RUTA indica al proceso de preenrutamiento que es preciso generar un segmento de tipo "preenrutamiento". En el segmento generado, se rellena el campo C_ETIQUETA1 del nuevo segmento con el valor que contiene el campo homónimo del registro asociado en la tabla CEN_LISTA_PRE_RUTAS.

===== Fase de enrutamiento en casos en que el destino no es externo =====
Datos de entrada al proceso de enrutamiento externo: iguales a los de salida del proceso de preenrutamiento (pdPreSale), uniéndose a éstos los datos globales de entrada al proceso (pdEntr).

Datos de salida de la fase de enrutamiento: iguales que los del proceso global de enrutamiento (pdSale).

Específicamente y sólo para los casos en que el destino es una extensión (tipo de destino extensión, usuario de telefonía corporativa o agente) es cuando son válidos los datos correspondientes al buzón asociado y los datos de los posibles desvíos previstos.

También en este caso, se prevén dos posibles rutas, una se corresponde con el acceso a la extensión en el nodo principal de ésta y la otra en el nodo secundario.

En el resto de tipos de destino, sólo se prevé una ruta que puede incluir o no un enlace internodal.

===== Fase de enrutamiento en el caso de destino externo =====
Datos de entrada al proceso de enrutamiento externo: iguales a los de salida del proceso de preenrutamiento (pdPreSale), uniéndose a éstos los datos globales de entrada al proceso (pdEntr).
Datos de salida de la fase de enrutamiento: iguales que los del proceso global de enrutamiento (pdSale).

Se elige los primeros "max_ruta" registros (configurado en archivo .conf) en CEN_DESTINOS_EXTERNOS unido con CEN_RELACION_DESTINOS_ENLACES_EXTERNOS que, teniendo en cuenta los datos de entrada al proceso de enrutamiento, cumpla con todos los puntos siguientes:
* ID_CATEGORIA_ENT igual a la de salida del proceso de preenrutamiento.
* C_DESTINO_SAL de proceso de preenrutamiento empiece con C_DESTINO_ENT_PREF.
* Si varias entradas cumplen la condicion anterior, se prueba primero la que el campo C_DESTINO_ENT_PREF tenga una longitud mayor.
* C_DESTINO_SAL tenga un número de dígitos igual o superior a N_DESTINO_ENT_MIN_DIGITOS, si este valor no es NULL o cero.
* C_DESTINO_SAL tenga un número de dígitos igual o inferior a N_DESTINO_ENT_MAX_DIGITOS, si este valor no es NULL o cero.
* C_DESTINO_SAL cumpla la expresión regular C_DESTINO_ENT_EXPR, si ésta no es NULL.

Aparte de la longitud del campo C_DESTINO_ENT_PREF, se usa N_PRIORIDAD como campo para ordenar los registros y seleccionar lo "max_ruta" primeros.

Una vez que un registro es válido, se descartan todos los registros cuyo C_DESTINO_ENT_PREF es diferente del primero seleccionado.

Como resultado de los procesos de filtrado y de verificación anteriores, se habrá obtenido hasta un máximo de "max_rutas" valores para posibles rutas. Las posibles propagaciones y transformaciones en los datos de cada ruta son función de los datos de cada registro seleccionado:

CALLER_NAME_nn: Si C_CALLER_NAME está vacío, se propaga el valor de entrada. En caso contrario, se sustituye.

CALLER_NUM_nn: Sale de C_CALLER_NUM que puede contener una cadena que identifica el nuevo CALLER_NUM_n. Además, si C_CALLER_NUM comienza por los caracteres que se indican, el significado es especial:
* "=" o cadena vacía, el nuevo CALLER_NUM_nn es igual al de entrada al proceso.
* "+" el nuevo CALLER_NUM_nn es igual al de entrada al proceso, con los caracteres a continuación de "+" como prefijo.
* "-" se quita el número de caracteres que se indica a continuación de "-".
* "_" lo que sigue al carácter es una expresión regular que se aplica al CALLER_NUM de entrada. Dicha expresión regular tiene obligatoriamente que contener una subcadena (definida entre paréntesis, según el estándar de expresiones regulares) que nos da el nuevo CALLER_NUM de salida. Si la expresión regular no se cumpliese, se propaga el valor de entrada al proceso.
* ">" Si existe valor para CALLER_NUM_EXTERNO, se propagará éste a la salida. En caso contrario y si no está vacía la cadena que queda al eliminar el prefijo ">", se susituye en la salida por el valor de la cadena sin prefijo. Si la cadena estuviese únicamente constituida por el valor ">", se propaga el valor de entrada.
* cualquier otro valor del primer carácter determina que es una constante sin ninguna modificación.

C_DESTINO_SAL_nn: Se obtiene a partir de C_DESTINO_SAL que puede contener una cadena que identifica el nuevo destino. Además, si la cadena comienza por los caracteres que se indican, el significado es especial:
* "=" o cadena vacía, el nuevo destino es igual al de entrada al proceso.
* "+" el nuevo destino es igual al de entrada al proceso, con los caracteres a continuación de "+" como prefijo.
* "-" se quita el número de caracteres que se indica a continuación de "-".
* "_" lo que sigue al carácter es una expresión regular que se aplica al destino de entrada. Dicha expresión regular tiene obligatoriamente que contener una subcadena (definida entre paréntesis, según el estándar de expresiones regulares) que nos da el nuevo destino de salida. Si la expresión regular no se cumpliese, se propaga el valor de entrada al proceso.
* cualquier otro valor del primer carácter determina que es una constante sin ninguna modificación.

RUTA_NODO_nn: Sólo se usa si el nodo de salida es diferente del nodo de entrada. Contiene la cadena de marcación para ir la nodo que soporta DESTINO_SAL_nn. Sale del campo C_FORMATO_DIAL (sustituyendo variables) correspondiente al tipo de dispositivo del enlace exterior.

RUTA_SAL_nn: Es el campo C_DATO_ASTERISK obtenido a partir del registro en la tabla CEN_ENLACE_EXTERIOR que se corresponde con ID_ENLACE_EXTERIOR de la tabla CEN_RELACION_DESTINOS_ENLACES_EXTERNOS.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Control de ancho de banda ===

Para el control de ancho de banda, primero hemos de tener en consideración que una llamada puede tener asociadas hasta cuatro sedes
:* Sede del terminal origen (terminal A)
:* Sede del nodo de registro del terminal origen (nodo A)
:* Sede del terminal destino (terminal B)
:* Sede del nodo de registro del terminal destino (nodo B)

Además hemos de tener en cuenta que el audio de la conversación podrá ir:
:* De manera directa entre terminal A y terminal B
:* De manera indirecta, a través de los nodos A y B

[[Archivo:ancho de banda.png|700px]]

Cuando se va a cursar una llamada de terminal A a terminal B, el proceso de enrutamiento del nodo A devuelve 4 variables de canal al dialplan:

{| class="wikitable"
|-
! Variable!!Campos
|-
|R_ABDE_xx||R = Variable de rutas --- AB = ancho de banda --- D = dispositivo --- E = Entrante --- xx = de 0 a 3
|-
|R_ABNE_xx||R = Variable de rutas --- AB = ancho de banda --- N = nodo --- E = Entrante --- xx = de 0 a 3
|-
|R_ABDS_xx||R = Variable de rutas --- AB = ancho de banda --- D = dispositivo --- S = Saliente --- xx = de 0 a 3
|-
|R_ABNS_xx||R = Variable de rutas --- AB = ancho de banda --- N = nodo --- S = Saliente --- xx = de 0 a 3
|-
|}

El valor de cada variable es una cadena del tipo '''AB.wwww.xxxx.y.z''' donde cada valor es:
:* '''wwww''' --> id de sede
:* '''xxxx''' --> ancho de banda total de la sede
:* '''y''' --> número de llamadas a sumar si conversación directa
:* '''z''' --> número de llamadas a sumar si conversación indirecta

Por otro lado tenemos que tener en cuenta que el dialplan tiene control de las llamadas que cada sede puede cursar

De esta forma, cuando existe una nueva llamada el dialplan aplica la fórmula, suma el resultado al número de llamadas en curso y lo compara con el máximo...si el resultado es mayor que le máximo la llamada no se cursará por congestión

Configuraremos el ancho de banda por sede en el portal de administración y el consumo que hace cada llamada en la variable '''AB_CONSUMO_LLAMADA''' del fichero '''ext_MDtel_particular.conf''' de cada nodo de conmutación; el valor por defecto es 32

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

== Puesto de trabajo ==
El puesto de trabajo del agente en la plataforma '''''VIVA'''''it (para el producto '''''VIVA'''''it Suite) estará compuesto por:
* PC (típicamente windows) en el que reside la aplicación '''''VIVA'''''it Desk
* Terminal telefónico con extensión física asociada.

Para más información [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Puestos | ver sección Portal de administración-VIVAit Suite ACD+ - Puestos]].

=== Relación PC/teléfono en puesto de trabajo ===

Existirá una relación única entre nombre PC y extensión física asociada, si bien los agentes se identificarán por su login que les acompaña al puesto de trabajo en el que se loguen
Existe un procedimiento documentado para la operativa de cambio de puesto de trabajo, en caso de ser necesario el cambio de PC o de teléfono de un puesto de trabajo.
==== Procedimiento para un cambio de puesto de trabajo ====
Se basa en una asignación de PC a teléfono relaccionando la extensión telefónica del terminal físico con el nombre del puesto de trabajo. La configuración de dicha asociación se realiza en el portal de administración de la plataforma.

Cualquier cambio que se realice en terminal telefónico o PC de agente ha de mantener la asociación en el portal a efectos de permitir el funcionamiento del sistema.

A continuación se reflejan los cambios más habituales:

{| class="wikitable"
|-
! Cambio !! Procedimiento !! Punto de acción
|-
|rowspan="2"| Cambio de ubicación de un PC || Opción 1.- Renombrar el PC para que conserve el nombre que tenía el anterior en esa ubicación || PC de agente
|-
| Opción 2.- Rehacer la asignación extensión/puesto || Portal de administración
|-
| rowspan="2"| Instalación de PC nuevo en puesto existente || Opción 1.- Renombrar el PC para que conserve el nombre que tenía el anterior en esa ubicación || PC de agente
|-
| Opción 2.- Rehacer la asignación extensión/puesto || Portal de administración
|-
| Cambio de nombre en un PC || Rehacer asignación extensión/puesto || Rehacer asignación extensión/puesto
|-
|Cambio de ubicación de un teléfono || Rehacer la asignación extensión/puesto
|| Portal de administración
|-
| Instalación de un teléfono nuevo en puesto existente || Rehacer la asignación extensión/puesto || Portal de administración
|-
| Instalación de un nuevo puesto de agente|| Hacer asignación extensión/puesto || Portal de administración
|}


=== Estructura de aplicaciones en puesto de trabajo ===
Las aplicaciones del puesto de trabajo pueden estar ubicadas en cualquier carpeta del sistema. Es importante tener en cuenta que los procesos de actualización, logs… escriben en dichas carpetas, por lo que el usuario de windows deberá tener permisos de lectura/escritura y borrado sobre dichas carpetas
La instalación del puesto de trabajo es muy liviana para el sistema; las aplicaciones ocupan poco espacio y no se modifican ficheros del sistema operativo (registry o similares)
Los ficheros importantes son
{| class="wikitable"
|-
! Fichero !! Descrición
|-
| Vivait-desk.exe || Contiene la aplicación '''''VIVA'''''it Desk de agente
|-
| vivait_desk_dll.dll||Este fichero contiene controles sobre los formularios (controles de
texto, algunas reglas de obligatoriedad…)
|-
| nimitz.ini || Configuración del puesto de agente
|-
| lanzador.exe || Aplicación de actualización de versiones
|-
| lanzador.ini || Configuración del actualizador de aplicaciones
|-
| Carpeta forms || En esta carpeta están ubicados los formularios que se abren ante llamada entrante o saliente
|-
| Carpeta imágenes || Contiene las imágenes izquierda y derecha de la barra de '''''VIVA'''''it Desk
|-
|}

=== Secciones de utilidad en nimitz.ini ===

==== Configuración del puesto de agente ====

El fichero nimitz.ini contiene la configuración del puesto de agente; sus principales parámetros son:

{| class="wikitable" border="0" style="background:#ffffff" align="top"
|-
| |''' Fichero'''
|| '''Descripción'''
|-
|Sección [bd1]
||host="ip_BBDD_tiempo_real"
puerto="Nº puerto"
basedatos="nimitz"
usuario="nimitz"
clave="UIk5jMY9PVX6ogg="

Contiene información para la conexión a BBDD de tiempo real, en la que '''''VIVA'''''it Desk fundamentalmente inserta información
|-
|Sección [bd2]
||host=" ip_BBDD_replica "
puerto="Nº puerto"
basedatos="nimitz"
usuario="nimitz"
clave="UIk5jMY9PVX6ogg="

Contiene información para la conexión a BBDD de réplica, en la que '''''VIVA'''''it Desk solo leerá información
|-
|Sección [telefono]
||pruebas=1 (Valores válidos 0 ó 1)
Activación de funcionalidad "servicio técnico" en '''''VIVA'''''it Desk.

puesto="Nombre puesto"
|-
|Sección [trazas]
|| nivel=3

archivo=1

consola=0

sobreescribir=1

Activación de generación de ficheros de trazas "viva-desk.log" en carpeta de aplicaciones
|}

=== Parámetros en invocación a '''''VIVA'''''it Desk ===

La aplicación '''''VIVA'''''it Desk puede ser invocada con una serie de parámetros que condicionan su funcionamiento; los parámetros son:
* Primer parámetro: Nombre del archivo .ini; usado como alternativa al fichero por defecto "nimitz.ini"
* Segundo parámetro: Nombre de puesto; usado como alternativa al nombre de puesto del ordenador
* Tercer parámetro: Nombre de login; para forzar un usuario; es de utilidad si el sistema está configurado como "confiar en sistema operativo", en cuyo caso no permite seleccionar un login de agente para acceder a la aplicación

=== Instalación y actualización de aplicaciones de puestos de trabajo ===
La instalación y actualización de las aplicaciones en el puesto de trabajo pasan por disponer de los ficheros “lanzador.exe” y “lanzador.ini” (debidamente configurado) dentro de la carpeta en la que se desee instalar.
Lanzando la aplicación “lanzador.exe” se instalará o actualizará el sistema.

El fichero “lanzador.ini” tiene el siguiente aspecto:
URL="http://IP_Servidor:8180/WSActualizaXML/actualizar.xml"
BASE_URL_DESCARGAS="http://IP_servidor:8180/XMLFILES/"

=== Servicio técnico en '''''VIVA'''''it Desk ===
La activación de la funcionalidad de servicio técnico en '''''VIVA'''''it Desk nos permite realizar sincronizaciones manuales de la aplicación y activar trazas a nivel de Base de Datos o a nivel de log sobre el propio '''''VIVA'''''it Desk. Pulsando el botón derecho del ratón sobre la barra '''''VIVA'''''it Desk accederemos a las capacidades de soporte técnico
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

== Funcionamiento de la plataforma en modo emergencia ==
== Accesos Web ==

{| class="wikitable"
|-
! Aplicación !! Enlace
|-
|Portal de administración '''''VIVA'''''it Suite || http://ip_admin:8180/Vivait-Call
|-
|'''''VIVA'''''it Tracker||http://ip_tracker:8180/Vivait-Tracker
|-
|Monitor Web||http://ip_monitor:8180/MonitorWeb
|-
|Monitorización Zabbix||http://ip_zabbix:80/zabbix
|-
|Base de datos tiempo real||http://ip_bbdd_tr:80/phpmyadmin/
|-
|Base de datos réplica||http://ip_bbdd_replica:80/phpmyadmin
|}

=== Permisos de aplicaciones ===
Se crean a través del '''portal de administración ''VIVA''it''' . Debe conocerse como funcionan los ejes [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Ejes| ver sección Portal de administracion - General - Ejes]] y que existen cuatro aplicaciones creadas en la plataforma:

[[Archivo:17_2 Pestaña Genera - Usuarios - Explicacion permisos.png|center]]

La forma como dar permisos de aplicaciones a un usuario esta explicada en la [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Asignaci.C3.B3n_de_Permisos_de_Usuario_por_Administrador | sección Portal de administracion - General - Usuarios ]].

== Elementos monitorizados del sistema ==
===Generalidades de Zabbix===
====Zabbix ====
Zabbix es una solución de código abierto que ofrece características de monitorización avanzada de forma tecnica y para el negocio, para todo tipo de servidores, aplicaciones y equipos que forman parte de una red. La versión que utilizamos en '''md'''tel es Zabbix 2.2.2.

Zabbix monitoriza los recursos de un equipo en forma remota, permite centralizar la información en un servidor que permite visualizar el monitoreo, cuenta con una interfaz de administración vía web y utiliza un mecanismo flexible de la notificación que permita que los usuarios configuren las alarmas basadas email para informar virtualmente cualquier acontecimiento. Esto permite una reacción rápida a los problemas del servidor.

Para acceder al servidor Zabbix abrimos el navegador y ponemos la dirección de red (IP) de la maquina donde se encuentra instalado el servidor de Zabbix seguido de "/Zabbix.
{|
|-
|
Direccion.IP.Zabbix.Server/zabbix
|}

Zabbix posee documentación tanto en wiki, foros y comunidades.Para ampliar la información se puede visitar:
[[http://www.zabbix.com Sitio oficial de Zabbix]]
===== Glosario Zabbix =====
Se trata de una lista de conceptos básicos de Zabbix, pero para ampliar la información sobre otros términos, visite el [[http://www.zabbix.com Sitio oficial de Zabbix]].
* '''host'''
:En Zabbix, un host es una entidad que define el elemento en red que se desea monitorizar/supervisar activamente sus recursos locales y aplicaciones. Este puede ser una impresa, router, switch, sensores de temperatura, un servidor, un ordenador,etc, o también una aplicación. La característica de un host es que debe poseer una dirección de red (IP).

* '''host group'''
:En Zabbix, un host group (grupo host) es una agrupación lógica de los host, como una forma de organizar los dispositivos "Host" registrados en Zabbix para su monitorización. Puede contener hosts y templates. Los grupos host se utilizan en la asignación de derechos de acceso a los hosts para diferentes grupos de usuarios.

* '''item'''
:En Zabbix, un item (medida) es el parámetro que deseamos obtener del host, básicamente es una medida especifica que el servidor Zabbix recogerá de los agentes de Zabbix instalados en los host.

* '''trigger'''
:En Zabbix, un trigger(disparador) es una entidad que define un umbral para detectar la existencia de un problema en un dispositivo. Son valores recolectados por los "items", se usa para "evaluar" los datos recibidos con condiciones definidas. Las condiciones son de tipo aritmético y lógico.
* '''event'''
:En Zabbix, un event (evento) es la aparición de un suceso en Zabbix que necesita atención. Por ejemplo, el cambio de estado a raíz de un trigger, el descubrimiento de un nuevo agente (autoregistro),etc.
* '''action'''
:En Zabbix, una action(acción) son reglas predefinidas para reaccionar a un evento disparado por los triggers, es decir, define qué hacer ante un evento. Consta de operaciones (por ejemplo, una notificacion, comandos remotos) y condiciones (cuando la operación se lleva a cabo).
* '''notification'''
:En Zabbix, una notification (notificacion) es la entidad con que Zabbix nos puede notificar (Correo Electrónico,mensajes vía "SMS" o Jabber).
* '''template'''
:En Zabbix, un témplate (plantilla) viene predefinida en la instalación de Zabbix Server, con el fin de ser aplicada en base al tipo de sistema operativo(Linux, Mac, Window, etc) o en elementos que comparten los mismos parámetros de medición, por ejemplo la carga del procesador, uso de memoria y uso de recursos de red. Las plantillas son un conjunto de módulos "ITEM, TRIGGERS y GRÁFICAS", que están preconfigurados y listas para ser aplicadas a uno o varios hosts.
* '''application'''
:En Zabbix, una application (aplicación) es una agrupación lógica de los items.
* '''Zabbix server'''
:El Zabbix server (servidor de Zabbix) es el proceso central donde están definidas las configuraciones y donde se almacenan todos los datos y estadísticas recogidas de los agentes Zabbix.Consta de una base de datos, una interfaz web y el propio server. Como servidor, se encarga de recoger los datos de los agentes, calcular los triggers, enviar notificaciones, etc.
* '''Zabbix agent'''
:El zabbix agent (agente de Zabbix) es un proceso desplegado en los host que son supervisados, que funciona como un servicio y puede funcionar de forma activa y pasiva simultáneamente.

=====Discovery=====
La funcionalidad discovery(detección) lista los dispositivos que se integran en nuestra red y el tipo de servicios que proporciona. Por ejemplo, si la empresa tuviera cien colas ACDs, y veinticinco VDNS, y en cada cola como veinte medidas, seria muy laborioso registrar una por uno cada uno.
Gracias a esta funcionalidad, se descubre todas las interfaces de red que se tiene, automáticamente y tanto para colas nodos o IVR. Para utilizar esta funcionalidad , se hace el uso de dos script, que se instalan en el momento de instalación de Zabbix en el directorio "/usr/local/sbin", que son:
{|
|-
|
'''zabbixDiscoveryQueues.pl''' : script utilizado para buscar colas ACD.

'''zabbixDiscoveryVDN.pl''' : script utilizado para buscar VDNS.
|}
La explicación de como configurarla se encuentra en el manual oficial [[https://www.zabbix.com/documentation/2.2/manual/discovery/network_discovery/rule | Zabbix detección de redes]].

=====Notificaciones=====

Necesariamente, debe darse de alta al usuario y darse de alta el servidor de correo electrónico para poder ser capaz de enviar correos.

Por otro lado, el formato del correo electrónico y las condiciones de envío de correo al usuario se configura en las acciones. Véase el [[https://www.zabbix.com/documentation/2.2/manual/quickstart/notification | manual oficial de Zabbix 2.2]]

=====Usuarios=====
Zabbix permite la organización de usuarios en grupos para establecer los permisos adecuados de acuerdo al tipo de perfil que deseemos crear. Necesariamente un usuario debe permanecer a un grupo o varios grupos.Todos los usuarios acceden a la aplicación de Zabbix a través de la interfaz Web.

Cada usuario Zabbix se le asigna un nombre de usuario único , una contraseña y podemos indicarle que tipo de comunicación que posee, normalmente es vía email, pero puede ser vía a otro tipo de medios. Para mas información ver el [[https://www.zabbix.com/documentation/2.2/manual/web_interface/user_profile || manual oficial ]].

=====Visualización=====
Con Zabbix es posible visualizar los datos como gráficos, pantallas, mapas y hasta presentaciones cambiantes, entre otros. En este apartado solo nombraremos características esenciales que se tendra que completar con el [[https://www.zabbix.com/documentation/2.2/manual/config/visualisation | manual oficial]]
======Graphs======
{|
|-
|
'''Nota:''' Debe crearse algun item dentro del host para poder utilizar una gráfica.
|}
En Zabbix una gráfica sirve para representar gráficamente los resultados obtenidos de uno item o varios items.
[[File:EjemploGrafica.png|center|750px]]
Los valores min / avg / max que Zabbix obtiene y representa son de un registro de datos de la tabla tendencias.

======Screens======
La pantalla refiere a otra característica adaptable de ZABBIX cuál permite que los usuarios creen las pantallas personalizadas dentro de ZABBIX para exhibir la información. Se considera como una colección de gráficas y no depende del host. Una pantalla puede consistir en gráficos simples, gráficos personalizados, integrar mapas, Alertas, gráficos estadísticos o texto llano tal como los 5 valores pasados de un item particular entre otros; y mostrar la información de forma dinámica.

[[File:EjemploScreen.png|center|750px]]

======Maps======
En Zabbix, un map (mapa) es una representación gráfica de la situacion de nuestros dispositivos en red. Es un escenario que muestra nuestra red, aplicaciones y servicios a través de figuras o iconos. Dichas figuras toman vida en respuesta a los eventos que se dan en nuestro entorno.
[[File:EjemploMaps.png|center|750px]]
[[File:EstadosMaps.png|center|750px]]

======Monitorizar el estado de los raid======
Los siguientes comandos son necesarios para poder monitorizar el estado de los raid.
La orden:

>hpacucli "ctrl slot=1 logicaldrive 1 show status"

nos proporciona el estado de un raid (p.e. logicaldrive 1 (931.5 GB, 1): Interim Recovery Mode).

La orden:
>hpacucli "ctrl slot=1 logicaldrive all show status"

nos proporciona el estado de todos los raid.

p.e.:
logicaldrive 1 (931.5 GB, 1): Interim Recovery Mode

logicaldrive 2 (1.8 TB, 1): OK.

Para conseguir información genérica el comando

ctrl all show config detail

nos muestra mucha información y podemos saber el modelo de disco físico que lleva instalado para poder comprar el modelo antes de "operar".

===Zabbix en '''MD'''tel===

==== Configuraciones de Zabbix ====

===== Agentes Zabbix =====
{|-
|
|
'''Nota:''' Hay que instalar un agente Zabbix en cada maquina que se quiera monitorizar.
|}

El agente de Zabbix puede recoger datos:
*'''De forma pasiva:''' el server contacta al agente pidiéndole un dato (por ejemplo el consumo de CPU en ese instante) y el agente responde al server con ese dato. A esta acción del agente le llamaremos '''Agente activo'''.
*'''De forma activa:''' en un primer momento, el server le enviará al agente el listado de items a monitorizar. A partir de ese momento, será el agente que de forma periódica recogerá datos sobre esos ítems y se los hará llegar al server. A esta acción del agente le llamaremos ''''''Agente pasivo''''''.

====== Configurar agente de forma pasiva======
Para configurar el agente de Zabbix necesitamos acceder a la maquina que actuará como agente, y en el directorio /etc/zabbix modificar el fichero '''zabbix_agentd.conf''' e indicar cual es la dirección de red (IP) del servidor Zabbix.

{|
|-
|
##### Passive checks related
### Option: Server
# List of comma delimited IP addresses (or hostnames) of Zabbix servers.
# Incoming connections will be accepted only from the hosts listed here.
# If IPv6 support is enabled then '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1'
# are treated equall$
#
# Mandatory: no
# Default:
Server= IP.Server Zabbix.
|}
Tras la configuración del fichero, debemos reiniciar el servicio de los agentes.
{|
|-
|
sudo service zabbix-agent restart
|}

====== Configurar agente de forma activa ======

Para configurar el agente de Zabbix necesitamos acceder a la máquina que actuará como agente, y en el directorio /etc/zabbix modificar el fichero '''zabbix_agentd.conf''' e indicar cual es la dirección de red (IP) del servidor Zabbix.

{|
|-
|
##### Active checks related
### Option: ServerActive
# List of comma delimited IP:port (or hostname:port) pairs of Zabbix serv$
# If port is not specified, default port is used.
# IPv6 addresses must be enclosed in square brackets if port for that hos$
# If port is not specified, square brackets for IPv6 addresses are option$
# If this parameter is not specified, active checks are disabled.
# Example: ServerActive=127.0.0.1:20051,zabbix.domain,[::1]:30051,::1,[12$
#
# Mandatory: no
# Default:
ServerActive=127.0.0.1
--------------------------sección separada----------------------------
### Option: UserParameter
# User-defined parameter to monitor. There can be several user-defined pa$
# Format: UserParameter=<key>,<shell command>
# See 'zabbix_agentd' directory for examples.
#
# Mandatory: no
# Default:
# UserParameter=
User_parameters:asterisk.pid, /usr/bin/asterisk -rx 'core show chanels'|grep 'active calls'| cat -d -f 1
|}

El parámetro '''User_parameters''' tiene un formato de este estilo:
{|
|-
|
User_parameters: NombreMedida, comando.
|}

El nombre de la medida se refiere al nombre que demos a la aplicación , no hace falta que exista una aplicación con ese nombre en Zabbix, y el comando , es el comando remoto que tiene que ejecutar el servidor Zabbix. Posiblemente necesita darse permisos para ejecutar el comando y siempre debe devolver un valor (un numero o un tiempo) que el servidor Zabbix puede manejar.
Tras la configuración del fichero, debemos reiniciar el servicio de los agentes.
{|
|-
|
sudo service zabbix-agent restart
|}

===== Scripts del Servidor Zabbix =====
{|
|
|
'''Nota''': No olvidar que en la misma maquina del server Zabbix, debe configurarse como agente de Zabbix.
|}
Después de realizar la [[# Instalación de Zabbix | Instalación de Zabbix ]] correctamente. Se han creado otros ficheros scripts (''scripts propios de '''md'''tel'') que facilitarán la petición del servidor a los agentes activos, para poder parametrizar todos los elementos del negocio que suelen monitorizarse.
Dependiendo de lo que vaya a monitorizarse necesitaremos algún script o todos. Algunos nos informan sobre elementos de negocio, saber si asterisk funciona , monitorizar el CTI (lanzara nc localhost 1111) , controlar el Intz-Nimitz, comprobar si funciona motalsal, ect.

Cada script se exportara a los host, para que pueda facilitar los datos que pide el servidor Zabbix y configurarse.
Por ejemplo,para monitorizar las llamadas en curso del ACD, agentes conectados, agentes desconectados, etc.
Todos los scripts se deben colocar en el directorio /usr/local/sbin con permisos 755, su nombre es parecido a "zabbixSenderXXXXX.pl"
{|
|-
|
ls /usr/local/sbin/ |grep zabbixSender
'''zabbixSenderACDBD.pl'''
'''zabbixSenderACD.pl'''
'''zabbixSenderCTI.pl'''
'''zabbixSender-intz-nimitz.pl'''
'''zabbixSenderMotorSal.pl'''
'''zabbixSenderMyACDSuperv.pl'''
'''zabbixSenderRecordNodo.pl'''
'''zabbixSenderRecordCentral.pl'''
|}

Se crea una tarea programada en linux para poder ejecutarse los scripts, programando el tiempo en que debe ejecutarse.

Si visualizo que "............" aparece:

***** root zabbix

======zabbixSenderACDBD.pl======

'''Uso:''' Obtiene diversos valores por cada cola, estados de agente por cola y estados de agente generales.

'''Ubicación:''' Servidor BDTR.

'''Parámetros:''' Ruta al archivo de configuración (Por ejemplo: ''/etc/MDtel/zabbixSenderACDBD.pconf'')

'''Archivo de configuración:''' zabbixSenderACDBD.pconf

{|
|-
|
'''$db:''' Nombre de la BBDD (normalmente nimitz)
'''$dbHost:''' Dirección IP del servidor de BBDD de TR (normalmente BDTR)
'''$dbPort:''' Puerto MySQL (normalmente 3306)
'''$dbUsuario:''' Usuario MySQL (normalmente nimitz)
'''$dbClave:''' Clave del usuario
'''$sZab:''' Dirección IP del servidor Zabbix
'''$hZab:''' Nombre del host Zabbix (normalmente el nombre de máquina, tal y como se configura en
zabbix_agentd.conf o en el host en la web de Zabbix)
|}

======zabbixSenderACD.pl======

'''Uso:''' Obtener el PID de Asterisk para revisar si se ha reiniciado en caso de que cambie.

'''Ubicación:''' Servidor ACD.

'''Parámetros:''' Ruta al archivo de configuración (Por ejemplo: ''/etc/MDtel/zabbixSenderACD.pconf'').

'''Archivo de configuración:''' zabbixSenderACDBD.pconf.

{|
|-
|
'''$db:''' Nombre de la BBDD (normalmente nimitz)
'''$dbHost:''' Dirección IP del servidor de BBDD de TR (normalmente BDTR)
'''$dbPort:''' Puerto MySQL (normalmente 3306)
'''$dbUsuario:''' Usuario MySQL (normalmente nimitz)
'''$dbClave:''' Clave del usuario
'''$sZab:''' Dirección IP del servidor Zabbix
'''$hZab:''' Nombre del host Zabbix (normalmente el nombre de máquina, tal y como se configura en
zabbix_agentd.conf o en el host en la web de Zabbix)
|}

======zabbixSenderCTI.pl======

'''Uso:''' Obtener estado y los distintos valores de vivait-cti.

'''Ubicación:''' Servidor donde se ejecute vivait-cti. Normalmente el servidor ACD.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

======zabbixSender-intz-nimitz.pl======

'''Uso:''' Obtener estado y los distintos valores de intz-nimitz.

'''Ubicación:''' Servidor donde se ejecute intz-nimitz.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

======zabbixSenderMotorSal.pl======

'''Uso:''' Obtener estado y los distintos valores de motorSal.

'''Ubicación:''' Servidor donde se ejecute motorSal.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

======zabbixSenderMyACDSuperv.pl======

'''Uso:''' Obtener estado y los distintos valores de myAcdSuperv.

'''Ubicación:''' Servidor donde se ejecute myAcdSuperv.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

======zabbixSenderRecordNodo.pl======

'''Uso:''' Obtener estado y los distintos valores de recordNodo.

'''Ubicación:''' Servidor donde se ejecute recordNodo.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

======zabbixSenderRecordCentral.pl======
'''Uso:''' Obtener estado y los distintos valores de recordCentral.

'''Ubicación:''' Servidor donde se ejecute recordCentral.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

A continuación se muestra una tabla resumen de los distintos scripts y sus funcionalidades:

[[Archivo:Zabbix_scripts.png |960px]]

====== Dimensionamiento del servidor (Startpollers) ======
{|
|
|
'''Nota''': EL parámetro StartPollers es un parámetro numérico que forma parte del fichero de configuración
del servidor Zabbix(zabbix_server.conf). Por defecto el servidor Zabbix está configurado para
iniciar con cinco startpollers.
|}

El servidor Zabbix puede hacer peticiones a los agentes de las medidas que necesita o quiere. O en caso contrario los agentes envian en un tiempo determinado la información al servidor. Para recibir todas estas peticiones necesitamos los pollers.

Los poller son los procesos encargados de recibir todas las peticiones de medidas. Aumentaremos su cantidad dependiendo de la necesitad que tengamos. Para ello podemos observar la queue , que es la encargada de almacenar un listado de todas las cosas que están pedidas para medirse y recibirse. SI por ejemplo esta cola (queue) muestra mas de mil medidas seguramente estos pollers sean un cuello de botella y habrá que aumentar su numero.

=====Templates=====

Zabbix cuenta con templates (plantillas) que facilitan la tarea de "Registrar Equipos y Dispositivos" y agregarles métricas; acelerar el despliegue de las tareas de supervisión en un host; aplicar cambios masivos a tareas de supervisión. En '''md'''tel hemos creado plantillas propias que facilitan estos procesos, los cuales necesitaremos [[#Importar templates |importar templates]].

Las plantillas están vinculados directamente a los hosts individuales, por tanto se necesitaran utilizar en cada host.

Automáticamente, cada template rellena por item las aplicaciones, trigers, alarmas,gráficos,... etc.

A continuación, se muestran los distintos bloques de funciones de la instalación en función de cada template:

{| class="wikitable" style="text-align:center;"
|-
! Templates !! Se instalan en general
|-
| DRBD|| SI (si clúster)
|-
| motorSal|| -
|-
| Vivait-Suite ACD|| -
|-
| Vivait-Suite BBDD|| -
|-
| Vivait-Suite Record|| -
|-
| Vivait-Suite GW|| -
|-
| Vivait-Call Asterisk|| -
|-
| Vivait-Call bdCentral|| -
|-
| Vivait-Call bdNodo|| si
|-
| cambiarPerfil_Cal|| -
|-
| Template App Zabbix Server|| -
|-
| Template_OS_Linux*|| si(si no posee ip virtuales de clúster)
|-
| Template_App_MySQL|| si
|-
|}

{| class="wikitable" style="text-align:center;"
|+ '''Dependiendo del tipo de nodo:'''
|-
! Templates !! ACD !! Corporativo/GW
|-
| DRBD|| - || -
|-
| motorSal|| - || -
|-
| Vivait-Suite ACD|| Si || -
|-
| Vivait-Suite BBDD|| - || -
|-
| Vivait-Suite Record|| - || -
|-
| Vivait-Suite GW|| - || Si
|-
| Vivait-Call Asterisk|| - || Si
|-
| Vivait-Call bdCentral|| - || -
|-
| Vivait-Call bdNodo|| - || -
|-
| cambiarPerfil_Cal|| - || -
|-
| Template App Zabbix Server|| - || -
|-
| Template_OS_Linux*|| - || -
|-
| Template_App_MySQL|| - || -
|-
|}

{| class="wikitable" style="text-align:center;"
|+ '''Dependiendo del tipo de Base de dato'''s:
|-
! Templates !! BBDD Tiempo Real !! BBDD Réplica !! BBDD Copia
|-
| DRBD|| - || - || -
|-
| motorSal|| Si(si ACD) || - || -
|-
| Vivait-Suite ACD|| - || - || -
|-
| Vivait-Suite BBDD|| si || si || si
|-
| Vivait-Suite Record|| - || - || -
|-
| Vivait-Suite GW|| - || - || -
|-
| Vivait-Call Asterisk|| - || - || -
|-
| Vivait-Call bdCentral|| si || - || -
|-
| Vivait-Call bdNodo|| - || - || -
|-
| cambiarPerfil_Cal|| - || - || -
|-
| Template App Zabbix Server|| - || - || -
|-
| Template_OS_Linux*|| - || - || -
|-
| Template_App_MySQL|| - || - || -
|-
|}

{| class="wikitable" style="text-align:center;"
|-
! Templates !! Administración
|-
| DRBD|| -
|-
| motorSal|| -
|-
| Vivait-Suite ACD|| -
|-
| Vivait-Suite BBDD|| -
|-
| Vivait-Suite Record|| -
|-
| Vivait-Suite GW|| -
|-
| Vivait-Call Asterisk|| -
|-
| Vivait-Call bdCentral|| -
|-
| Vivait-Call bdNodo|| -
|-
| cambiarPerfil_Cal||SI (si posee servidor calendarios)
|-
| Template App Zabbix Server|| -
|-
| Template_OS_Linux*|| -
|-
| Template_App_MySQL|| -
|-
|}

{| class="wikitable" style="text-align:center;"
|-
! Templates !! Servidor de grabaciones
|-
| DRBD|| -
|-
| motorSal|| -
|-
| Vivait-Suite ACD|| -
|-
| Vivait-Suite BBDD|| -
|-
| Vivait-Suite Record|| Si
|-
| Vivait-Suite GW|| -
|-
| Vivait-Call Asterisk|| -
|-
| Vivait-Call bdCentral|| -
|-
| Vivait-Call bdNodo|| -
|-
| cambiarPerfil_Cal||-
|-
| Template App Zabbix Server|| -
|-
| Template_OS_Linux*|| -
|-
| Template_App_MySQL|| -
|-
|}

{| class="wikitable" style="text-align:center;"
|+ '''Monitorización'''
|-
! Templates !! General !! Contact Center
|-
| DRBD|| - || -
|-
| motorSal|| - || -
|-
| Vivait-Suite ACD|| - || -
|-
| Vivait-Suite BBDD|| - || -
|-
| Vivait-Suite Record|| - || -
|-
| Vivait-Suite GW|| - || -
|-
| Vivait-Call Asterisk|| - || -
|-
| Vivait-Call bdCentral|| - || -
|-
| Vivait-Call bdNodo|| - || -
|-
| cambiarPerfil_Cal|| - || -
|-
| Template App Zabbix Server|| si || -
|-
| Template_OS_Linux*|| - || -
|-
| Template_App_MySQL|| - || -
|-
|}

* El template OS Linux tiene asociado el Template App Zabbix Agent.
Una '''base de datos unificada''' es una base de datos de tiempo real junto a una base de datos de replica

====== Importar templates======

Las plantillas propias de '''md'''tel se encuentran en la ruta "'''/usr/src/nimitz/archivos'''" y empiezan con el nombre de "TemplateXXX.xml".

{|
|-
|
ls /usr/src/nimitz/archivos | grep Template
'''Template DRBD.xml'''
'''Template motorSal.xml'''
'''Templates Vivait-Suite_GW.xml'''
'''Templates Vivait-Suite.xml'''
'''Template Vivait-Call Asterisk.xml'''
'''Template Vivait-Call bdCentral.xml'''
'''Template Vivait-Call bdNodo.xml'''
'''Template Vivait-Call cambiarPerfil_Cal.xml'''

|}

La importación se realizara una vez a través de la web, no hace falta desde el servidor Zabbix, puede ser en cualquier computadora con acceso a la interfaz web de Zabbix.

[[File:ImportarTemplates.png|750px|center]]

Hay opciones varias opciones a elegir para importación de templates, pero podemos dejar por defecto las señaladas y pulsar el botón "import".

===Configuración para un primer funcionamiento de Zabbix===
Se describe una básica configuracion de Zabbix para cualquier equipo que utilice Windows o linux. Pues mediante la definición de hosts, items, triggers y acciones, Zabbix permite efectuar un monitoreo efectivo de plataformas IT heterogéneas.

====Configuración de los equipost (host) para la monitorización====
{|
|-
|
'''Nota''': Tenga en cuenta que debe de estar previamente configurado el agente Zabbix del
dispositivo a ser monitorizado apuntando a la IP del "Servidor Zabbix".
|}
Existen dos tipos de host:
* '''Host físico''': donde la dirección de red que registramos en Zabbix, corresponde al dispositivo que deseamos monitorizar.
* '''Host virtual''': es una dirección IP virtual, que puede relacionarse con un servidor Web, clusters, etc.

[[File:CreacionHost.png|750px|center]]

Las opciones basicas para configurar un host son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center ;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Host Name'''
| | Definir un nombre para el host.
||Se puede utilizar números, letras, espacios y guiones bajos están permitidos.
|-
| font-weight: bold;" | '''Visible Name'''
| | Identificar con un nombre, la maquina a la que se refiere el host.
||Si no tiene valor, se mostrara como nombre "Host Name".
|-
| font-weight: bold;" | '''Groups'''
| | Seleccionar al grupo de host que pertence.Seleccione uno o varios grupos de la caja derecha.
|| Los valores que puede seleccionar por defecto:
Discoverd hosts.

Switches.

Templates.

Templates MDtel.

Zabbix servers.

Linux Servers.

Hypervisors.

Virtual machines.

O crear uno nuevo en '''New group'''.

|-
| font-weight: bold;" | '''Agent interfaces'''
| |Se recomienda usar una dirección IP, en vez de un nombre de la maquina para resolver por un servidor de DNS que puede fallar.
| | 10050 por defecto
|}

Cuando termine, haga clic en nel boton "Save". Su nuevo "Host" debe ser visible en la lista de "Host registrados".Despues el zabbix, intentara configurarse el zabbix para conectarse a la IP.... cada x tiempo hace un barrido.

===== Comprobación de disponibilidad del host=====
Para saber si todo esta bien debemos ver la Z de disponibilidad.

[[File:EstadosZHost.png|750px|center]]

Indicacion de los colores del icono Z:

* Si el icono Z en la columna de disponibilidad es de color rojo, indica que hay un error en la comunicación - mueva el cursor del ratón sobre él para ver el mensaje de error.

* Si el icono es gris, significa que esta en proceso de comunicación con el "Agente Zabbix". Compruebe que el servidor Zabbix está en marcha, y pruebe a actualizar la página más tarde. El tiempo estimado para revisar si existe problemas es de 5 minutos.

* Si el icono es verde, esta funcionando correctamente.

====Indicar que plantilla(template) tendra el host [opcional]====
Tras [[#Importar templates |importar templates]] nos dirigimos al host ya configurado, y en su pestaña de templates pulsamos "add" y añadimos la plantilla/s adecuadas.

====Asignar items al host ====
{|
|-
|
'''Nota''':Un host puede tener un ITEM sin necesitad de tener template.
|}

Todos lo ITEMS se agrupan por HOST, esto significa que cada HOST tiene sus propios "Módulos que recogen datos del Host". Para agregar un nuevo módulo vamos a "Configuration → Hosts" y localizamos el "Host" al cual queremos agregarle un nuevo "Item".

[[File:CrearItemEjemplo.png|750px|center]]

Parametros o campos a rellenar para una configuración básica :

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center ;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Name'''
| | Definir un nombre para el item. Este nombre va a ser nuestro identificador para todas la gestiones en donde lo involucremos como el caso de Triggers.
||
|-
| font-weight: bold;" | '''Type'''
|| Indicar de que entidad queremos recibir informacion.
||Puede ser al "Agente Zabbix" o a el Hardware como impresoras, switch o routers.
|-
| font-weight: bold;" | '''Key'''
| | los "Items" utilizan "Key" que son parámetros de Zabbix. Los "Key" nos permiten indicar específicamente que tipo de información vamos a solicitara a la entidad. Se puede considerar también como el nombre de alguna aplicación.
||
|-
| font-weight: bold;" | '''host interface'''
| |Es la direccion de red del servidor zabbix (puede ser uno o mas)
| |
||
|-
| font-weight: bold;" | '''Units'''
| |Es la dirección de red del servidor zabbix (puede ser uno o mas)
| |
|-
| font-weight: bold;" | '''Type of information'''
| |Tipo de unidades con el que mostrar Zabbix el valor segundos, minutos, euros,....
||
|}

Cuando termine, haga clic en Guardar. El nuevo elemento debe aparecer en la ITEMLIST.
Para mas informacion [[http://entation/1.8/manual/config/items#zabbix_agent. ver documentación Zabbix]]

===== Ver la información recolectada por el item =====
{|
|-
|
'''Nota:''' Normalmente para ver la información lo encontraremos en "Monitoring → Latest data",luego
clic en el signo "+" en "other" siempre que no pertenezca a una aplicación.
En caso contrario, estará bajo el nombre de la aplicación.
|}

Después de definir el "Item" vamos a revisar la información que esta recolectando. . La información comenzará a ser recolectada según el tiempo que le indicamos en el "Item".

[[File:VerInfoITEM.png|750px|center]]

La espera para recibir la información varía dependiendo del tiempo de recolección del item, la mayoría suele ser aproximadamente al minuto de generar el "Item". Zabbix le ofrece la opción de visualizar la información en forma gráfica (sencilla). En el "Item" en lista haga clic en la columna "History - Graph".

[[File:VIsualGraficaValorItem.png|center|750px]]
Si en un caso usted no observa información le recomendamos:

* Ingrese al "Item" y revise que la información del "Key" este igual al ejemplo "system.cpu.load"
* Verifique que el agente este funcionando en el "Servidor a ser monitoreado" y que "El Servidor recolector Zabbix" este funcionando.
* El icono "Z" en el host debe estar en color verde.
* Asegure que esta monitoreando el servidor que le agregó este "Item"

====Configurar los Triggers para los host====
A partir de la información que captura los agentes , el servidor de Zabbix comienza a efectuar la recolección de estos items en la base de datos. Con esto se tiene un registro histórico de tales mediciones, que pueden ser tan simples como un simple ping hasta datos de uso de disco, memoria, cpu, etc.
A partir de los datos que se reciben de los agentes lo que sigue es definir y configurar Triggers, que son evaluaciones que hace Zabix de estos datos para determinar la existencia de un Problema en un dispositivo.
{|
|-
|
Nota: Un trigger necesita una accion, que indica que hacer cuando se activa el trigger.
|}

Un trigger(disparador) es un tipo de reacción ante unas medidas, como un disparador en el que si pasa algo se activa. Los Trigger en Zabbix son módulos que creamos a uno o múltiples "Items" para evaluar o comparar los valores recolectados por los "Items" con condiciones que nosotros definamos. Las condiciones son de tipo aritmético y lógico.

Para configurar un "Trigger o Disparador" seleccionamos "Configuration → Hosts" localizamos el "Host" de ejemplo que creamos y luego hacemos clic en "Trigger", después haga clic en "Create Trigger".

Parametros o campos a rellenar para una configuración básica :

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center ;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Name'''
| | Definir un nombre para el trigger. Este nombre va a ser nuestro identificador para todas la gestiones en donde lo involucremos como el caso de los eventos.
||
|-
| font-weight: bold;" | '''Expression'''
|| Hay que indicar para que medida se crea (item) y sus funciones con los parametros adecuados. '''''Recomendación usar expression constructor que pedirá siempre al crearlo, para que item es y sus funciones...'''''
||Ejemplo: {New host:system.cpu.load.avg(180)}>2
|-
| font-weight: bold;" | '''Key'''
| | los "Items" utilizan "Key" que son parámetros de Zabbix. Los "Key" nos permiten indicar específicamente que tipo de información vamos a solicitara a la entidad. Se puede considerar tambien como el nombre de alguna aplicacion.
||
|-
| font-weight: bold;" | '''Descripción'''
| | Una descripción breve sobre el trigger.
||
|-
| font-weight: bold;" | '''Severity'''
| | everidad distinguida por colores,
|| No classified
Information
Warning
Average
High
Disaster
|}

===== Comprobar el estado del trigger =====
Podemos ver el estado del "Trigger" en "Monitoring → Triggers".El color en caso de que se active depende de la severidad definida. Por ejemplo, si el "Trigger" esta en color verde indica que el resultado de la métrica se mantiene por debajo de la condición que indicamos. Por el contrario si el resultado esta "sobre lo indicado" su color sera rojo.

[[File:EstadoTrigger.png|center|750px]]

====Asociar un Action al trigger====

Una action(acción) sirve para configurar un mensaje de alerta o una accion para Zabbix, ante un problema. Hay varias formas de gestionar un problema a través de una acción:

# A través de mensajes simples, alertando al instante.
# Escalar los mensajes hacia el jefe y/o otros grupos.
# Ejecución de commandos remotos.
# Notificaciones repetidas hasta que se resuelve el problema.
# Notificaciones y comandos retardados.
# Escenario complejo, la combinación de todo lo anterior.

Para crear una configuración en "Configuration-Actions". La explicación esta en la [[ https://www.zabbix.com/documentation/2.0/manual/config/notifications/action documentación de Zabbix]].
-->

== Integraciones con servicios externos ==

=== Presencia con Openfire ===
'''''VIVA'''''it se integra con servidor XMPP Openfire en su versión 3.10.2 (última probada)

Además del servidor, es necesario instalar un plugin de integración con asterisk 13, denominado "asterisk IM", versión 1.4.1

La instalación del servidor Openfire es una instalación estándar, realizada de paquete

La instalación del plugin es un "jar" que se carga desde la pagina de plugins de openfire

Con esto conseguiremos comunicar asterisk y OPenfire de manera que:
*Los estados telefónicos de una extensión '''''VIVA'''''it se reflejen en Openfire
*Poder marcar desde los clientes de IM instalados en los puestos
*Ver en el cliente llamadas entrantes al teléfono

-----

'''<big>Enlaces de interes:</big>'''

[http://www.igniterealtime.org/projects/openfire/ Página proyecto openfire]

[https://community.igniterealtime.org/thread/56076 Página proyecto "asterisk IM"]

=== Reuniones virtuales con Openmeetings ===
'''OpenMeetings''' es un sistema de vídeo web-conferencia en tiempo real. Usando recursos como audio (micrófono), vídeo (cámara web), posibilidad de subir y convertir presentaciones (en PDF , PPT o ODP que se convierten a Flash), compartición de la pantalla de tu ordenador, o pizarra digital compartida, panel de administración, posibilidad de grabar las sesiones… y completo soporte multiplataforma, es decir, que aparte de poder grabar las sesiones, se puede compartir un escritorio también desde una máquina Linux.

Para instalar '''OpenMettings''' debe seguir el [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manuales_de_instalaci%C3%B3n#Instalaci.C3.B3n_de_Openmeetings | manual de Instalación de Openmeetings]]

[[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:VIVAit Suite]]

Homologación de Terminales

2018-04-04T10:27:31Z

Imatarrubias: /* 6921 */

{| class="wikitable"
|-
! '''Producto: '''!! VIVAit Call
VIVAit Suite
|-
|}

== Tabla global de compatibilidad ==

La siguiente tabla muestra los terminales probados y homologados en la mesa de pruebas de la plataforma VIVAit

'''Otras partes pueden haber implantado existosamente otras marcas y modelos'''

Respecto a los terminales marca '''Cisco''', si bien es posible cargar módulos SCCP y MGCP en VIVAit, desconocemos la funcionalidad (qué funciona y qué no), la estabilidad (se cae o no se cae) y la escalabilidad (cuantos elementos se soportan y cuanto afecta cada elemento adicional a las prestaciones del sistema) en un entorno que no se considere de uso '''testimonial''', por lo que '''no podemos asegurar su funcionalidad ni su funcionamiento'''.

{| class="wikitable"
|-
! Marca !! Modelo !! Probado !! Homologado !! Limitaciones !! observaciones
|-
|-
| Aastra (Mitel) || 6731i || Si || Si || No || --
|-
| Aastra (Mitel) || 6753i || Si || Si || No || --
|-
| Aastra (Mitel) || 6755i || Si || Si || No || --
|-
| Aastra (Mitel) || 6865i || Si || Si || No || --
|-
| Cisco || 3905 ||Si || ''' NO ''' || Si ||[[#3905|'''VER OBSERVACIONES''']]
|-
| Cisco || 6921 ||en proceso || || ||[[#6921|'''VER OBSERVACIONES''']]
|-
| Cisco || 6941 || Si || Si || Si ||[[#6941|'''VER OBSERVACIONES''']]
|-
| Cisco || 6945 || Si || Si || Si ||[[#6945|'''VER OBSERVACIONES''']]
|-
| Cisco || 7911 || Si || Si || Si ||[[#7911|'''VER OBSERVACIONES''']]

Validado SAT desde versión 2

|-
| Cisco || 7912 ||Si || Si || Si ||[[#7912|'''VER OBSERVACIONES''']]

Validado SAT desde versión 2
|-
| Cisco || 7921 ||en proceso || || ||--
|-
| Cisco || 7940 G ||Si ||Si || Si ||[[#7940|'''VER OBSERVACIONES''']]
|-
| Cisco || 7941 IP ||Si ||Si || Si ||[[#7941IP|'''VER OBSERVACIONES''']]
|-
| Cisco || 7942 ||Si || Si || Si ||[[#7942|'''VER OBSERVACIONES''']]
|-
| Cisco || 7945 ||Si || SI || Si ||[[#7945|'''VER OBSERVACIONES''']]
|-
| Cisco || 7965 ||Si || SI || Si ||[[#7965|'''VER OBSERVACIONES''']]
|-
|Cisco || 8811 IP || Si || Si || Si ||[[#8811IP|'''VER OBSERVACIONES''']]
|-
| Cisco || IP SPA 512G|| Si||Si ||Si ||[[#512G|'''VER OBSERVACIONES''']]
|-
| Cisco || IP SPA 514G|| Si||Si ||Si ||[[#514G|'''VER OBSERVACIONES''']]
|-
| Cisco || ATA 186 || No || No || ||PROBADO E INSTALADO POR SAT
|-
| Cisco || VG224 ||No || ''' NO ''' || ||[[#VG224|'''VER OBSERVACIONES''']]
|-
| Grandstream || DP715 || Si || Si || Si ||[[#DP715_EU|'''VER OBSERVACIONES''']]
|-
| Grandstream || GXP1405 || Si || Si || No || Homologado desde versión 2
|-
| Grandstream || GXP1625 || Si || Si || No ||
|-
| Grandstream || GXP1628 ||en proceso || || ||--
|-
| Grandstream || GXP2135 || Si || Si || Si ||[[#GXP_2135|'''VER OBSERVACIONES''']]
|-
| Grandstream || GXP2140 || Si || Si || Si ||[[#GXP_2140|'''VER OBSERVACIONES''']]
|-
| Grandstream || GXP2160 ||en proceso || || ||--
|-
| Grandstream || GXP2170 || Si || Si || Si ||
|-
| Grandstream || GXV3240 || Si || Si || Si ||[[#GXV_3240|'''VER OBSERVACIONES''']]
|-
| Grandstream || GXV3275 || Si || Si || Si ||[[#GXV_3275|'''VER OBSERVACIONES''']]
|-
| Huawei || eSpace 7910 || Si|| ''' NO ''' || Si ||[[#eSpace_7910|'''VER OBSERVACIONES''']]
|-
| Huawei || eSpace 7950 || Si|| ''' NO ''' || Si ||[[#eSpace_7950|'''VER OBSERVACIONES''']]
|-
| ICM || 10000G || Si || Si || No || --
|-
| Innovaphone || IP110 || Si ||Si || ||[[#IP110|'''VER OBSERVACIONES''']]
|-
| Mitel || 5212 || Si || Si || Si ||[[#5212|'''VER OBSERVACIONES''']]
|-
| Mitel || 6865i || Si || Si || No || --
|-
| Mitel || 6867i || Si || Si || No || --
|-
| Mobotix || T25 || Si || ''' NO ''' || N/A ||[[#T25|'''VER OBSERVACIONES''']]
|-
| Panasonic || KX-TGP600+TPA60 || Si || Si || Si || [[#KX-TGP600|'''VER OBSERVACIONES''']]
|-
| Siemens || Gigaset C530 IP || Si || ''' NO ''' || ''' SI ''' || Durante las pruebas no se ha podido hacer el aprovisionamiento
|-
|Siemens||OpenStage 15_SIP||Si||Si||Si||'''El teléfono se aprovisiona manualmente'''
[[ #OpenStage 15|'''VER OBSERVACIONES''']]
|-
| Unifi || VoIP Phone || Si || ''' NO ''' || N/A || Pruebas básicas de registro SIP
|-
| Yealink || T18P || Si || Si || Si ||[[#T18P|'''VER OBSERVACIONES''']]
|-
| Yealink || T20P || Si || Si || No || Homologado desde versión 2
|-
| Yealink || T21P || Si || Si || No || Homologado desde versión 2
|-
| Yealink || T21PE2 || en proceso || en proceso || ||
|-
| Yealink || T22P || en proceso || en proceso || ||
|-
| Yealink || T23G || en proceso || || ||
|-
| Yealink || T26P || Si || Si || No || Homologado desde versión 2
|-
| Yealink || T27P || en proceso || || ||
|-
| Yealink || T28P || Si || Si || No || Homologado desde versión 2
|-
| Yealink || T29G || Si || Si || No || Homologado desde versión 2
|-
| Yealink || T42G || Si || Si || No ||
|-
| Yealink || T46G || Si || Si || No ||
|-
| Yealink || VP530 || Si || Si || No ||
|-
|Yealink|| SIP-T58V||Si||Si||No|| [[#SIP-T58V|'''VER OBSERVACIONES''']]
|-
| Zoiper || Business Windows || Si || Si || No || Homologado desde versión 2
Integrado con VIVAit Suite (controles telefónicos desde formularios)
|-
|}

== Cisco ==
=== 3905 ===
{| class="wikitable"
|-
! Item !! Observaciones
|-
!BOTONES!!
|-
|NOMBRE DEL BOTÓN Y ACCIÓN
|-
|Botón Función: Con el teléfono descolgado, el botón Selección accede a funciones preestablecidas.||'''NO OK'''. Se pierden dos funciones mencionadas en el manual de usuario: ""Captura de llamadas"" y ""Captura de llamadas de Grupo"".
|-
|Desvío Incondicional. Aparece la función pero no activa el desvío
|-
|Acceso a mensajería|| Pendiene de prueba
|-
!TAREAS TELEFÓNICAS COMUNES!!
|-
|DESCRIPCIÓN DE LA TAREA
|-
|Realizar una llamada interna descolgando el teléfono. Se marcan indistintamente números de usuarios y de extensión física, del mismo y de distinto nodo que la del SIP 3905.|| El display del llamante (3905) presenta el nombre de la extensión marcada. El diplay del llamado presenta nombre y número del usuario llamante.
|-
|Poner la llamada en espera y reanudarla (Botón Espera/Continuar).||'''NO OK'''. La vuelta al lado en conversación tarda segundos en producirse.
|-
|Recibir y atender una llamada interna: Desde diferentes terminales origen marcamos el número de la extensión del SIP 3905.|| "El establecimiento (señalización de la llamada en el SIP 3905) se retrasa de modo perceptible, respecto a las que se originan en los modelos Aastra, Mitel, YealinK; cuando la llamada se origina en CISCO 7942 y CISCO 7911).
El display del llamado presenta el nombre asociado a la extensión llamante. El display del llamante nombre y número de extensión llamada."
|-
|Llamar a un usuario en movilidad (presentado en una extensión del mismo y de otro nodo). El display del llamante (3905) presenta el nombre del usuario llamado. ||El display del teléfono conectado presenta el nombre y número de usuario llamante.
|-
|Llamar a una extensión con desvío incondicional activo.||El display del 3905 presenta el nombre asociado a la extensión conectada (la que recibe la llamada desviada).
|-
|Llamar a un usuario con desvío incondicional activo|| El display del 3905 presenta el nombre asociado a la extensión conectada (la que recibe la llamada desviada).
|-
|Llamar a extensión y a usuario con desvío "si no contesta" activo. Se prueban ambos casos||Cuando se produce el desvío de la llamada iniciada, el display del 3905 cambia para presentar el nombre asociado a la extensión conectada (posición de desvío).
|-
|Atender una llamada en espera: Con una llamada establecida, el 3905 recibe una llamada entrante (1 tono de llamada en el auricular + información del llamante en el display). Pulsa la tecla Espera/continuar, la conversación en curso queda en espera y se establece conexión con la nueva llamada).||'''NO OK'''. El establecimiento de la nueva conexión se hace correctamente pero la vuelta al otro lado (cursor para seleccionar la otra comunicación y tecla espera/continuar) tarda segundos en producirse.
|-
|Transferencia con consulta de una llamada local en curso a otra extensión.||La transferencia se realiza pero en el display del 3905 aparece indicación de que la conexión con el lado que queremos transferir queda en espera (no es así).
|-
|Transferencia con consulta de una llamada local en curso al exterior.||La transferencia se realiza pero en el display del 3905 aparece indicación de que la conexión con el lado que queremos transferir queda en espera (no es así).
|-
|Consulta Repetida: Antes de transferir una llamada el 3905 tiene la posibilidad de conectarse a uno u otro lado de la comunicación haciendo uso de las teclas cursor y espera/continuar.||Se presenta el mismo retardo en el establecimiento de la comunicación que cuando aparcamos y retomamos una llamada.
|-
|Transferencia sin consulta: Con señal de llamada en el lado C pulsamos la tecla de transferencia. Se prueba con llamada externa e interna.||El display de la extensión que recibe la llamada transferida no presenta información del conectado, se queda con la información del usuario asociado al 3905.Además en el display del 3905 aparece indicación de que la conexión con el lado que queremos transferir queda en espera (no es así).
|-
|Conferencia a Tres||'''NO OK'''. La conferencia debe establecerse haciendo uso del gancho del teléfono y No Funciona.
|-
|Captura de llamadas: Capturar una llamada que está dirigida a otro teléfono.||Con las limitaciones que tiene la facilidad en la versión Asterisk en pruebas.
|-
|Captura de llamadas en un Grupo de Captura: Probamos que el 3905 puede capturar las llamadas dirigidas a cualquier extensión del grupo de captura de llamadas al que pertenece.||Con las limitaciones que tiene la facilidad en la versión Asterisk en pruebas.
|-
|Retro llamada: El 3905 activa el servicio de retro llamada tras recibir comunicando cuando llama a una extensión de su mismo nodo.||Tal como funciona en la versión Asterisk en pruebas.
|-
|Desvío Incondicional activado con la función del menú del teléfono||'''NO OK'''. Después de introducir el número de teléfono al que se desea realizar el desvío no hay confirmación de que quede activo.
Realizamos una llamada y no se produce el desvío.
|-
|Desvío Incondicional de la extensión física activado por código||El desvío queda activo y se produce (tanto a otra extensión, como al exterior). La locución de confirmación se altera con pitidos
No queda información de que el teléfono esté desviado.
|-
|Desactivación del desvío incondicional de la extensión física.||El desvío se desactiva.La locución de confirmación se altera con un pitido al final.
|-
|Desvío incondicional del usuario activado por código||El desvío queda activo y se produce (tanto a otra extensión, como al exterior). La locución de confirmación se altera con pitidos. No queda información de que el teléfono esté desviado.
|-
|Desactivación del desvío incondicional del número de usuario.||El desvío se desactiva.
La locución de confirmación se altera con un pitido al final.
|-
|Desvío por ocupado de la extensión física activado por código.||'''NO OK'''. Con 3905 ocupado en una llamada interna, la primera llamada que realizamos se señaliza como llamada en espera y la puede atender. Con 3905 ocupado y con una llamada en espera atendida, la siguiente llamada dirigida a él da ocupado (NO SE DESVIA).
|-
|Desvío por ocupado del usuario activado por código.|| '''NO OK'''. Lo mismo que en el caso anterior.
|-
|Desvío si no contesta||Pendiente de probar.
|}

=== 6921 ===






{| class="wikitable"
|-
! Item !! Observaciones
|-
!BOTONES!!
|-
|Se comprueba la funcionalidad esperada al actuar sobre el botón.
|-
!NOMBRE DEL BOTÓN Y ACCIÓN!!
|-
|'''Botón de Contactos:''' Abre y cierra el menú Directorios.Se utiliza para acceder a los directorios personal y corporativo.||Con la configuración de prueba del terminal, no está operativo. Al pulsar el display muestra "Solicitando".
|-
|'''Botón Transferencia:''' Inicia la transferencia de la llamada en curso y Transfiere la llamada cuando el destino está en llamada o cuando responde.||La transferencia directa o transferencia ciega NO ES POSIBLE con este terminal.
|-
|'''Botón Conferencia:''' Inicia una llamada de Conferencia.||
|-
|'''Botón Espera:''' Pone en espera la llamada activa||Para recuperar la comunicación con la llamada en espera hacer uso de la tecla programada "Cont"
|-
|'''Botón Silencio (Mute):''' Activa o desactiva el micrófono.||Cuando el micrófono está silenciado, el botón está encendido.
|-
|Botones de Línea: 2 botones (1 y 2).|| "El botón de línea 1 selecciona la línea de teléfono principal. '''PROBADO'''
Según cómo el administrador del sistema configure el teléfono, el botón de línea 2 podría permitir el acceso a:

• La línea de teléfono secundaria '''NO PROBADO'''

• Un número de marcación rápida (botón de marcación rápida) '''PROBADO''' junto a BLF.

• Servicio basado en la Web (por ejemplo, el botón Libreta personal de direcciones). '''NO PROBADO'''
|-
|Botón Auriculares: Activa o desactiva los auriculares.|| Cuando los auriculares están activados, el botón está encendido. '''PTE PRUEBA'''
|-
!BOTONES PROGRAMADOS!!
|-
|||Se trata de botones que dan acceso a opciones de funciones que aparecen en la pantalla LCD y que varían dependiendo del estado del teléfono y de la llamada en curso. Se comprueba que efectivamente se ejecuta la opción indicada para el botón en cada situación"
|-
!OPCIÓN PROGRAMADA!!
|-
|NoMlsta: Activa/desactiva la función Mo Molestar.|| Es una función configurable por el administrador. La configuración probada es "la llamada entrante se señaliza con un destello ámbar del botón de línea, no hay indicación sonora".
|-
|Marc. Ráp: Si se ha configurado una lista de numeros de marcación rápida.|| Envía el número traducido que se corresponde con la cifras marcadas en el teclado. '''NO PROBADO:''' En la configuración del terminal probada, la programación de una lista de números de marcación rápida no era accesible.
|-
|Trnsf: Transfiere la llamada actual al número marcado.||Aparece después de iniciar una transferencia con el botón Transferencia del panel.
|-
!TAREAS TELEFÓNICAS COMUNES!!
|-
!DESCRIPCIÓN DE LA TAREA!!
|-
|Transferir la llamada actual a un nuevo número sin consulta (Transferencia Directa)|| No puede realizar una transferencia directa, la opción transferir no aparece en el display hasta que se produce llamada en el lado C (extensión que recibe la transferencia). Si transferimos en llamada antes de que descuelgue el lado C se produce el reparo general identificado para este caso de transferencia (el display del terminal que recibe la llamada transferida no actualiza para presentar el número conectado).
|-
|Iniciar una conferencia a tres.||No es posible en Asterisk 13.
|-
|Activar No Molestar|| Con esta función activa las llamadas recibidas por el terminal se señalizan en el display pero el timbre no suena.
|-
!BUZÓN DE VOZ!!
|-
|Señalización en el terminal de mensajes nuevos pendientes.||Indicación luminosa en led del micro teléfono.
|-
|Consulta de mensajes|| Una vez consultados los mensajes en la carpeta nuevos, desaparece la señalización en el terminal de mensajes nuevos pendientes.
|-
|SUPERVISIÓN (BLF) En tecla 2 del panel.|| El led asociado se ilumina cuando se establece una llamada
|}

=== 6941 ===
{| class="wikitable"
|-
! Item !! Observaciones
|-
|Transferencias con Consulta ||Al coger nueva línea e introducir el destino de la consulta, no aparece la función dínámica LLAMADA, debiendo esperar la temporización “interdigit timeout” correspondiente para que se realice la llamada.
|-
|Transferencia sin consulta|| El teléfono no tiene la opción de trasferencia sin consulta. Se puede utilizar la función transferencia antes de contestar. La línea utilizada para la transferencia se queda retenida, liberándose por time-out o manualmente."
|-
!SERVICIO JEFE SECRETARIA!!
|-
|Conferencia|| Después de pulsar CONFERENCIA e introducir el nuevo destino a incorpora a la conferencia, no aparece la función dínámica LLAMADA, debiendo esperar la temporización “interdigit timeout” correspondiente para que se realice la llamada.
|-
|Transferencia con consulta|| Al coger nueva línea e introducir el destino de la consulta, no aparece la función dínámica LLAMADA, debiendo esperar la temporización “interdigit timeout” correspondiente para que se realice la llamada.
|-
|Transferencia sin consulta|| El teléfono no tiene la opción de trasferencia sin consulta. Se puede utilizar la función transferencia antes de contestar.
La línea utilizada para la transferencia se queda retenida, liberándose por time-out o manualmente."
|-
!AGENTE DE ACD!!
|-
!Generar llamadas!!
|-
!Administración de llamadas!!
|-
|Conferencia con supervisor desde el terminal|| '''NOK''' Aparece el mensaje “No se puede completar conferencia”
|-
|Conferencia con no supervisor desde el terminal|| '''NOK''' Aparece el mensaje “No se puede completar conferencia”
|-
!Campañas!!
|-
!Saliente Predictiva!!
|-
|Establecida comunicación con agente, consulta destino externo desde VIVA desk|| '''NOK''' La llamada se indica en el terminal pero no progresa
|-
|Conferencia desde el terminal|| '''NOK''' Aparece el mensaje “No se puede completar conferencia”
|-
!Saliente Progresiva!!
|-
|Establecida comunicación con agente, consulta destino externo desde VIVA desk|| '''NOK''' La llamada se indica en el terminal pero no progresa
|-
|Conferencia desde el terminal|| '''NOK''' Aparece el mensaje “No se puede completar conferencia”
|-
!Saliente Vista Previa!!
|-
|Establecida comunicación con agente, consulta destino externo desde VIVA desk|| '''NOK''' La llamada se indica en el terminal pero no progresa
|-
|Establecida comunicación con agente, consulta destino externo desde el terminal|| '''NOK''' La llamada se indica en el terminal pero no progresa
|-
|Conferencia desde el terminal|| '''NOK''' Aparece el mensaje “No se puede completar conferencia”
|-
!Saliente Bajo Demanda!!
|-
|Establecida comunicación con agente, consulta destino externo desde VIVA desk|| '''NOK''' La llamada se indica en el terminal pero no progresa
|-
|Establecida comunicación con agente, consulta destino externo desde el terminal|| '''NOK''' La llamada se indica en el terminal pero no progresa
|-
|Conferencia desde el terminal|| '''NOK''' Aparece el mensaje “No se puede completar conferencia”
|-
|}

=== 6945 ===
{| class="wikitable"
|-
! Item !! Observaciones
|-
|Mute: silencia a los participantes en una multiconferencia||Al pulsar la tecla no se silencia ninguna parte de la multiconferencia.
|-
|Cisco inicia la llamada y realiza la transferencia||En un entorno de terminales Cisco, se pierde el micro.
|-
|Cisco inicia la llamada, luego es transferido por la extensión a la que llamó||En un entorno de terminales Cisco, se pierde el micro.
|-
|En transferencias sin consulta: Cisco inicia la llamada y realiza la transferencia||Para realizar la transferencia es necesario esperar que el destino de la transferencia comience a sonar.
Las extensiones que quedan al habla presentan en pantalla información del teléfono conectado.
Transcurrido el tiempo de no contesta, la llamada no vuelve a la extensión que inició la transferencia.
Al realizar la transferencia Cisco recibe señal similar a la señal de ocupado durante 20 segundos.
|-
|Desvío extensión por fuera de servicio||El llamante escucha silencio 30 segundos y después se produce el desvío. La situación no se informa en pantalla. Al llamante no se le informa del desvío hasta que la extensión destino del desvío descuelga.
|-
|Desvío extensión por fuera de servicio a mensajería||El llamante escucha silencio 30 segundos y después se produce el desvío. La situación no se informa en pantalla.
|-
|Llamada externa originada en secretaria, llama al jefe y luego transferida al exterior||En un entorno Cisco el destinatario externo de la transferencia escucha ruido.
|-
!Transferencia sin consulta:!!
|-
|Llamada local originada en secretaria, primero llama al jefe y luego transfiere||Tanto si la secretaria marca el número de extensión física del jefe como si marca el número de usuario.
Para realizar la transferencia es necesario esperar que el destino de la transferencia comience a sonar.
Las extensiones que quedan al habla presentan en pantalla información del teléfono conectado.
Transcurrido el tiempo de no contesta, la llamada no vuelve a la extensión que inicio la transferencia.
Al realizar la transferencia Cisco recibe señal similar a la señal de ocupado durante 20 segundos.
|-
|Llamada local originada en secretaria, llama a otra extensión y luego transfiere al jefe||Tanto si la secretaria marca el número de extensión física del jefe como si marca el número de usuario.
Para realizar la transferencia es necesario esperar que el destino de la transferencia comience a sonar.
Las extensiones que quedan al habla presentan en pantalla información del teléfono conectado.
Transcurrido el tiempo de no contesta, la llamada no vuelve a la extensión que inicio la transferencia.
Al realizar la transferencia Cisco recibe señal similar a la señal de ocupado durante 20 segundos.
|-
|Llamada externa originada en secretaria, llama al jefe y luego transferida al exterior||Tanto si la secretaria marca el número de extensión física del jefe como si marca el número de usuario.
Para realizar la transferencia es necesario esperar que el destino de la transferencia comience a sonar.
Las extensiones que quedan al habla presentan en pantalla información del teléfono conectado.
Transcurrido el tiempo de no contesta, la llamada no vuelve a la extensión que inicio la transferencia.
Al realizar la transferencia Cisco recibe señal similar a la señal de ocupado durante 20 segundos.
|-
|Llamada externa originada en secretaria, llama al exterior y luego transferida al jefe||Tanto si la secretaria marca el número de extensión física del jefe como si marca el número de usuario.
Para realizar la transferencia es necesario esperar que el destino de la transferencia comience a sonar.
Las extensiones que quedan al habla presentan en pantalla información del teléfono conectado.
Transcurrido el tiempo de no contesta, la llamada no vuelve a la extensión que inicio la transferencia.
Al realizar la transferencia Cisco recibe señal similar a la señal de ocupado durante 20 segundos.
|-
|Llamada local entrante a la secretaria y luego transfiere al jefe||Tanto si la secretaria marca el número de extensión física del jefe como si marca el número de usuario.
Para realizar la transferencia es necesario esperar que el destino de la transferencia comience a sonar.
Las extensiones que quedan al habla presentan en pantalla información del teléfono conectado.
Transcurrido el tiempo de no contesta, la llamada no vuelve a la extensión que inicio la transferencia.
Al realizar la transferencia Cisco recibe señal similar a la señal de ocupado durante 20 segundos.
|-
|Llamada externa entrante a la secretaria y luego transfiere al jefe||Tanto si la secretaria marca el número de extensión física del jefe como si marca el número de usuario.
Para realizar la transferencia es necesario esperar que el destino de la transferencia comience a sonar.
Las extensiones que quedan al habla presentan en pantalla información del teléfono conectado.
Transcurrido el tiempo de no contesta, la llamada no vuelve a la extensión que inicio la transferencia.
Al realizar la transferencia Cisco recibe señal similar a la señal de ocupado durante 20 segundos.
|-
|Llamada local entrante al jefe, recibida por la secretaria y trasferida después al jefe||Tanto si la secretaria marca el número de extensión física del jefe como si marca el número de usuario.
Para realizar la transferencia es necesario esperar que el destino de la transferencia comience a sonar.
Las extensiones que quedan al habla presentan en pantalla información del teléfono conectado.
Transcurrido el tiempo de no contesta, la llamada no vuelve a la extensión que inicio la transferencia.
Al realizar la transferencia Cisco recibe señal similar a la señal de ocupado durante 20 segundos.
|-
|Llamada externa entrante al jefe, recibida por la secretaria y trasferida después al jefe||Tanto si la secretaria marca el número de extensión física del jefe como si marca el número de usuario.
Para realizar la transferencia es necesario esperar que el destino de la transferencia comience a sonar.
Las extensiones que quedan al habla presentan en pantalla información del teléfono conectado.
Transcurrido el tiempo de no contesta, la llamada no vuelve a la extensión que inicio la transferencia.
Al realizar la transferencia Cisco recibe señal similar a la señal de ocupado durante 20 segundos.
|-
|}

=== 7911 ===
{| class="wikitable"
|-
! Item !! Observaciones
|-
!BOTONES DEL PANEL!!
|-
|Se comprueba la funcionalidad esperada al actuar sobre el botón.
|-
!NOMBRE DEL BOTÓN Y ACCIÓN!!
|-
|Botón de Aplicaciones: Muestra el menú de aplicaciones (Mensajes de voz, Directorios, Configuración, Servicios, Ayuda).||Solo son operativas las opciones Directorios y Configuración. Quizá podría ponerse en funcionamiento la opción Mensajes si se configura el acceso al buzón de voz en el terminal.
|-
!BOTONES PROGRAMADOS|| 4 botones bajo el Display.!!
|-
| ||Cambian su funcionalidad según el estado del terminal y/o la llamada en curso. Se comprueba que efectivamente se ejecuta la opción indicada para el botón en cada situación"
|-
|OPCIÓN PROGRAMADA
|-
|NvaLlam: Para realizar una llamada nueva.||Arranca tono de invitación a marcar y espera la marcación de cifras
|-
|Msjes:||'''NO OK'''. Quizá por falta de programación del acceso al buzón (en terminal).
|-
|NoMlsta: Evita que las llamadas entrantes suenen en el teléfono||La activació se señaliza con un mensaje en el display "No molestar está activo".
|-
|Dsvinc: Activa/desactiva el desvío incondicional de las llamadas a otra extensión predeterminada en el proceso de activación||Se desvían todas las llamadas dirigidas al teléfono.
|-
|Monitor: Permite escuchar a nuestro interlocutor a través del altavoz||El terminal no es manos libres, podemos escuchar pero no nos escucharán mientras esté activada esta función.
|-
|MonDes: Desconecta la función monitor.||Recuperamos la comunicación con nuestro interlocutor a través del micro-receptor.
|-
|Confr: Iniciar una conferencia||En una conferencia a tres establecida, la acción sobre el botón "Espera" pone en espera a los dos conferenciantes.
|-
!TAREAS TELEFÓNICAS COMUNES!!
|-
|DESCRIPCIÓN DE LA TAREA
|-
|Realizar una llamada interna y otra externa descolgando el auricular y marcando. Con auricular colgado, pulsando tecla "Nvallam" y marcando.||Retardo apreciable desde que se envían las cifras hasta que se establece la conexión.
|-
|Utilizar los registros de llamadas para hacer una llamada||Secuencia: Botón de Aplicaciones-Directorios- Seleccionar una de las opciones (Received, Placed, Missed, Speed)- Seleccionar el destino deseado-Dial.
|-
|Cambiar a altavoz o auricular durante una llamada.||Monitor/MonDes. Solo sirve para escuchar por el altavoz a nuestro interlocutor.
|-
|Recibir una llamada en espera y contestarla||Con una llamada establecida y configurado para recibir llamadas en espera, cuando se recibe la segunda llamada, ésta se señaliza en el display con el icono de un teléfono oscilando y un tono espaciado en el auricular. Pulsando la tecla de navegación (arriba) el display presenta información del llamante. Pulsamos la tecla programada Contes y establecemos comunicación con el llamante dejando la llamada anterior en espera.
|-
|Transferir la llamada actual a un nuevo número sin consulta||No puede realizar una transferencia directa, la opción transferir no aparece en el display hasta que se produce llamada en el lado C (extensión que recibe la transferencia). Si transferimos en llamada antes de que descuelgue el lado C se produce el reparo general identificado para este caso de transferencia.
|-
|Iniciar una conferencia a tres||Para acceder al botón de opción "Confr". Pulsar antes "más"
|-
|Activar No Molestar||Las llamadas entrantes se señalizan en el display y no suena el timbre del teléfono
|-
|Activar el desvío incondicional de las llamadas entrantes con función del teléfono||La situación de desvío activado se señaliza en el terminal.
|-
|Captura de llamadas. Captura de una llamada dirigida a otra extensión del mismo nodo (Cod. Captura+número de exten.)||Hay un retardo evidente desde que se envía la combinación de cifras de la captura hasta que se establece la conexión. Cuando se produce la captura, el display del 7911 presenta el número conectado.
|-
|Grupo de Captura: Captura llamadas dirigidas a cualquier extensión del grupo al que pertenece (Cod. Función *8)||El retardo en establecimiento es mucho menos evidente (aceptable) que en el caso anterior. Al producirse la captura el display del 7911 presenta información del conectado (origen de la llamada capturada).
|-
|BUZÓN DE VOZ
|-
|Señalización en el terminal de mensajes nuevos pendientes.||Indicación luminosa en led del micro-receptor y símbolo en display.
|-
|Acceso al buzón de voz||Tiempo de espera apreciable (9s.) hasta que se produce el establecimiento de la conexión con el buzón.
Si habilitamos el acceso a través de la tecla programada ""Msjes"" no hay retardo en el establecimiento de la llamada al buzón de voz.
|-
|Consulta de mensajes||Una vez consultados los mensajes en la carpeta nuevos, desaparece la señalización en el terminal de mensajes nuevos pendientes.
|-
|SUPERVISIÓN (BLF)||'''NO OK'''. El terminal no dispone de botones en los que se pueda configurar esta función.
|}

=== 7912 ===
El terminal 7912 presenta un mecanismo de aprovisionamiento diferente al habitual; no queda integrado en el esquema de aprovisionamiento de la plataforma VIVait
El único idioma disponible para este terminal cuando funciona en SIP es el inglés de Estados Unidos.

OTROS: Con la configuración probada o bien por causa del terminal. El gancho NO ACTUA. Para finalizar la llamada actual utilizar la tecla Endcall.

{| class="wikitable"
|-
! Item !! Observaciones
|-
!BOTONES!!
|-
!NOMBRE DEL BOTÓN Y ACCIÓN!!
|-
|Botón de Aplicaciones: Muestra el menú de acceso a Información de Directorios y a Configuración.|| Si tenemos configurado el acceso al buzón de voz. No son todas las opciones del menú que indica la guía de usuario. Faltan las opciones "mensajería de voz", "servicios". La opción "mensajería de voz" aparece cuando el fichero de configuración del terminal incluye el acceso al buzón de voz.
|-
!BOTONES PROGRAMADOS: 4!!
|-
|Bajo la pantalla del teléfono. corresponden a opciones de funciones que aparecen en la parte inferior de la pantalla del teléfono. Las funciones de los botones programadas se modifican según el estado del teléfono.
Se comprueba que efectivamente se ejecuta la opción indicada para el botón en cada situación"
|-
!OPCIÓN PROGRAMADA!!
|-
|'''DND:''' Aparece si la función NO MOLESTAR se ha activado desde el menú de configuración|| Al pulsar DND cancelamos la función NO MOLESTAR.
|-
|'''Message:''' acceder al buzón de voz||Aparece si hemos configurado previamente este acceso (Botón Menú-Settings-Call apreferences-Voice Mail Number).
|-
|'''ToVM:''' Desvía la llamada entrante al buzón de voz sin que sea necesario responderla.||"CON REPAROS: Aparece, si hemos configurado previamente el acceso al buzón de voz, cuando suena el timbre en una llamada entrante.
'''PROBLEMA:''' El buzón de voz responde en modo ""consulta de mensajes"" no permite que el llamante deje su mensaje."
|-
|'''Monitor:''' Permite escuchar una llamada en el altavoz.|| El terminal no es manos libres, podemos escuchar pero no nos escucharán mientras esté activada esta función.
|-
|'''MonOff:''' Desactiva la función Monitor.||Recuperamos la comunicación con nuestro interlocutor a través del micro-receptor.
|-
|'''DroP:''' En una conferencia a tres establecida por el 7912, finaliza la llamada con el último participante incorporado.||Aparece cuando tenemos establecida una conferencia a tres.
|-
|'''CFwdAll:''' Aparece cuando se activa desde el menú de Configuración el desvío incondicional, a otro número, de las llamadas recibidas.||Al pulsar el botón asociado a la función Cancelamos el desvío incondicional programado.
|-
!TAREAS TELEFÓNICAS COMUNES!!
|-
!DESCRIPCIÓN DE LA TAREA!!
|-
|Utilizar los registros de llamadas para hacer una llamada.|| Secuencia: Botón de Aplicaciones-Directorios- Seleccionar una de las opciones (Received, Placed, Missed, Speed)- Seleccionar el destino deseado-Dial.
|-
|Configurar teclas de marcación rápida y realizar una llamada de marcación rápida.|| "Configuración, secuencia: Botón de Aplicaciones-Directories-Speed Dials-Seleccionar una posición del 1 al 9-Edit-introducir Nombre y Número-Save.
Para marcar: Pulsar un número del teclado del 1 al 9 y la tecla programada ""Dial""."
|-
|Cambiar a altavoz o auricular durante una llamada.|| Monitor/MonDes. Solo sirve para escuchar por el altavoz a nuestro interlocutor.
|-
|Recibir una llamada en espera y contestarla: Este terminal se puede Configurar, a través del menú "Call Preferences", para que "Call Waiting" esté permitida o prohibida.|| Con una llamada establecida y configurado para recibir llamadas en espera, cuando se recibe la segunda llamada, ésta se señaliza en el display que presenta la información del llamante encima de la información de la llamada conectada. Además se escucha un tono espaciado en el auricular. Pulsamos la tecla programada "Answer" y establecemos comunicación con el llamante dejando la llamada anterior en espera.
|-
|Transferir la llamada actual a un nuevo número sin consulta.|| Con la llamada establecida pulsar la secuencia: more-BlndXfr-introducimos las cifras del teléfono destino.
|-
|Activar No Molestar. Secuencia: Botón de Aplicaciones-Settings- Call Preferences-Do Not Disturb-poner a YES. ||Con la función activada en el terminal el llamante recibe tono de ocupado
|-
|Activar el desvío incondicional de las llamadas entrantes con función del teléfono. Secuencia: Botón de Aplicaciones-Settings- Call Preferences-Call Forward Number-Edit-número de posición de desvío-accept-save.|| Con el desvío activo la pantalla del terminal informa "Forwarded to xxxx…"
|-
|Captura de llamadas. Captura de una llamada dirigida a otra extensión (Cod. Captura+número de exten.).||'''CON REPAROS:''' Cuando captura la llamada, la pantalla del Cisco 7912 no cambia para presentar el número conectado, sigue presentando la combinación de cifras marcada (*41* Nº de extensión en llamada).
|-
|Grupo de Captura: Captura llamadas dirigidas a cualquier extensión del grupo al que pertenece (Cod. Función *8).||'''CON REPAROS:''' Cuando captura la llamada, la pantalla del Cisco 7912 no cambia para presentar el número conectado, sigue presentando la combinación de cifras marcada (*8).
|-
|Retrollamada, activación y cancelación: Uso de *43# y *44#.||'''PENDIENTE.''' De momento no hemos conseguido configurar el dial plan del teléfono para el envío correcto de #.
|-
!BUZÓN DE VOZ!!
|-
|Desvío incondicional al buzón de voz (activación, funcionamiento, desactivación).|| '''PENDIENTE.''' (*21#) está implicado el envío de #
|-
|SUPERVISIÓN (BLF).||El terminal no dispone de botones en los que se pueda configurar esta función.
|}

=== 7940 G ===
{| class="wikitable"
|-
! Item !! Observaciones
|-
|Idioma||No se puede cambiar. No pide idioma en el proceso de carga
|-
|Acceso al terminal||No se puede acceder al terminal vía web
|-
|Realiazar una llamada||No se puede marcar con el teléfono colgado, siempre hay que coger línea
|-
|Cisco inicia la llamada y realiza la transferencia||En un entorno de terminales Cisco, se pierde audio en un sentido.
|-
|Cisco inicia la llamada, luego es transferido por la extensión a la que llamó||En un entorno de terminales Cisco, se pierde audio en un sentido.
|-
|Activación/desactivción desvió extensión por fuera de servicio (código *213* Vivait Call)||El llamante escucha silencio 30 segundos y después se produce el desvío. La situación no se informa en pantalla. Al llamante no se le informa del desvío hasta que la extensión destino del desvío descuelga.
|-
|Activación/desactivción desvió extensión por fuera de servicio a mensajería (código *213# Vivait Call)||El llamante escucha silencio 30 segundos y después se produce el desvío. La situación no se informa en pantalla.
|-
|Configuración de BLF||No se puede configurar BLF en Cisco 7940.
|-
|CFwdALL: Desvío incondicional (Activa y cancela el desvío de todas las llamadas dirigidas al terminal)||Permite configurar el desvío de toda llamada entrante a otro número. La situación de desvío no se señaliza en la pantalla del terminal.
|}

=== 7941IP ===
{| class="wikitable"
|-
! Item !! Observaciones
|-
|Botón ayuda||Acceso al menú de ayuda. No muestra información de ayuda.
|-
|Activar una retrollamada sobre no contesta (código *43 de Vivait Call)||No se puede activar la retrollamada
|-
|Cancelar una retrollamada sobre no contesta (código *44 de Vivait Call)||No se puede activar la retrollamada
|-
|Activar una retrollamada sobre ocupado (código *43 de Vivait Call)||No se puede activar la retrollamada
|-
|Cancelar una retrollamada sobre ocupado (código *44 de Vivait Call)||No se puede activar la retrollamada
|-
|Con retrollamada activa, lado A realiza una llamada finalizándola antes de activarse||No se puede activar la retrollamada
|-
|Con retrollamada activa, lado A realiza una llamada finalizandola después de activarse|No se puede activar la retrollamada
|-
|Recibir desde el cabecera del grupo con diferentes estrategias||Aunque la extensión pertenece al grupo nunca le entran llamadas
|-
|Activar PAUSA en extensiones del Grupo de Salto (*491)||Aunque la extensión pertenece al grupo nunca le entran llamadas
|-
|Activar REANUDAR en extensiones del Grupo de Salto (*492)||Aunque el sistema informa de que el agente está en línea, la extensión no recibe llamadas
|-
|Logout de extensiones declaradas como no permanentes en un Grupo de Salto (*48)||Aunque la extensión pertenece al grupo nunca le entran llamadas
|-
|Login de extensiones declaradas como no permanentes en un Grupo de Salto (*47)||Aunque el sistema informa de agente conectado, la extensión no recibe llamadas
|-
|Llamada interna entrante a una de las extensiones del Grupo y captura desde el Cisco (con código de Asterisk *8)||No puede capturar la llamada entrante a otra extensión del grupo de captura
|-
|Llamada externa entrante a una de las extensiones del Grupo y captura desde el Cisco (con código de Asterisk *8)||No puede capturar la llamada entrante a otra extensión del grupo de captura
|-
|Activación/desactivación desvió extensión incondicional (código *23 Vivait Call) (1)||La situación no se informa en pantalla. Solo funciona el desvío cuando la llamada es externa
|-
|Activación/desactivación desvió extensión incondicional a mensajería (código *21 Vivait Call) (1)||La situación no se informa en pantalla. Solo funciona el desvío cuando la llamada es externa
|-
|}

- '''Nota 1:''' Cuando se programa el desvío inmediato desde Vivait Call y desde el terminal, el desvío programado en Vivait Call es prioritario sobre el programado en el terminal.

=== 7942 ===
'''Incompatible la convivencia de las funciones "Conferencia a tres" y "Supervisión (BLF)".'''

''Los cambios en el fichero de configuración del terminal para habilitar la supervisión mediante BLF dejan sin afecto la función "Conferencia a tres"''
{| class="wikitable"
|-
! Item !! Observaciones
|-
!Botones!!
|-
|Se comprueba la funcionalidad esperada al actuar sobre el botón.
|-
!Nombre del botón y acción!!
|-
|Botón Auriculares:Activa/desactiva los auriculares.|| '''Pendiente de prueba'''
|-
|Botón de directorios:Abre y cierra el menú Directorios.|| Da acceso al Histórico de llamadas (perdidas, recibidas, realizadas).
|-
|Botón Mensajes:Marca automáticamente el número de acceso a la mensajería||'''No funciona''', puede ser defecto de configuración.
|-
|Botón Servicios:Abre y cierra el menú de servicios.|| '''Al accionarlo el display presenta "Host no encontrado"'''
|-
|Botón Ayuda:Acceso al menú de ayuda.|| '''Se pierde el acceso a este servicio'''
|-
!Botones programados!!
|-
|Se trata de botones que dan acceso a opciones de funciones que aparecen en la pantalla LCD y que varían dependiendo del estado del teléfono y de la llamada en curso.Se comprueba que efectivamente se ejecuta la opción indicada para el botón en cada situación.
|-
!Opción programada!!
|-
|NoMlsta: Activa/desactiva la función Mo Molestar.|| Es una función configurable por el administrador. La configuración probada es "la llamada entrante se señaliza con un destello ámbar del botón de línea, no hay indicación sonora".
|-
|Dsvinc: Activa/desactiva el desvío incondicional de las llamadas a otra extensión predeterminada en el proceso de activación.||El desvío se produce tanto al marcar el número de usuario como al marcar el número de la extensión física.
|-
|Espera: Pone una llamada en espera.|| El lado de la comunicación en espera recibe música en espera En una conferencia a tres establecida, la acción sobre el botón "Espera" pone en espera a los dos conferenciantes.
|-
|Confr: Iniciar una conferencia a tres.||Siempre que en el terminal no se haya configurado la supervisión por BLF.
|-
!Tareas telefónicas comunes!!
|-
|'''Descripción de la terea'''
|-
|Realizar una llamada interna y otra externa descolgando el auricular y marcando, y en modo manos libres (pulso botón altavoz y marco)||Retardo apreciable desde que se envían las cifras hasta que se establece la conexión.
|-
|Transferir la llamada actual a un nuevo número sin consulta (Transferencia Directa).||No puede realizar una transferencia directa, la opción transferir no aparece en el display hasta que se produce llamada en el lado C (extensión que recibe la transferencia). Si transferimos en llamada antes de que descuelgue el lado C se produce el reparo general identificado para este caso de transferencia.
|-
|Iniciar una conferencia a tres: Para acceder al botón de opción "Confr". Pulsar antes "más".||'''Funciona siempre que en el terminal no se haya configurado la supervisión por BLF'''.
|-
|Captura de llamadas. Captura de una llamada dirigida a otra extensión del mismo nodo (Cod. Captura+número de exten.)||Transcurren varios segundos desde que se envían las cifras hasta que se establece la conexión por captura. Al producirse la captura el display del 7942 presenta información del conectado (origen de la llamada capturada).
|-
|Grupo de Captura: Captura llamadas dirigidas a cualquier extensión del grupo al que pertenece (Cod. Función *8)||El retardo en establecimiento es mucho menos evidente que en el caso anterior. Al producirse la captura el display del 7942 presenta información del conectado (origen de la llamada capturada).
|-
!Buzón de voz!!
|-
|Señalización en el terminal de mensajes nuevos pendientes.||Indicación luminosa en led del micro-receptor y símbolo en display.
|-
|Acceso al buzón de voz:Tiempo de espera apreciable (12s.) hasta que se produce el establecimiento de la conexión con el buzón. ||Si habilitamos el acceso a través del botón mensajes no hay retardo en el establecimiento de la llamada al buzón de voz.
|-
|Consulta de mensajes||Una vez consultados los mensajes en la carpeta nuevos, desaparece la señalización en el terminal de mensajes nuevos pendientes.
|-
!Servicio Jefe/secretaria!!
|-
|SUPERVISIÓN Cuando se habilita se pierde la función "Conferencia a tres"||La lámpara asociada a la tecla configurada como BLF luce:
Cuando el teléfono supervisado recibe llamada entrante (ámbar, parpadeo rápido).
Cuando el teléfono supervisado responde a una llamada (rojo, fijo).
Cuando el teléfono supervisado envía las cifras en una llamada originada por él (rojo, fijo).
|-
|Transferencia de una llamada desde la secretaria al Jefe sin consulta.||La transferencia directa pura no es posible. Se puede transferir mientras el jefe recibe señal de llamada, en ese caso se produce el reparo general identificado para este caso de transferencia (Al descolgar el display del terminal del Jefe no cambia para mostrar el número conectado).
|-
|Transferencia de una llamada desde el Jefe a la secretaria.||Funciona dentro de los límites identificados, en este modelo, para la transferencia (No hay transferencia directa).
|}

=== 7945 ===
{| class="wikitable"
|-
! Item !! Observaciones
|-
|Botón de ayuda||Acceso al menú de ayuda. No muestra información de ayuda.
|-
|-
!Transferencias con Consulta!!
|-
|Cisco inicia la llamada y realiza la transferencia
|-
|Cisco inicia la llamada, luego es transferido por la extensión a la que llamó||La pantalla no se actualiza con la parte conectada en la transferencia. Cuando la parte remota cuelga la pantalla no se actualiza a la nueva situación.
|-
|Cisco recibe una llamada transferida tras ser consultado||La pantalla no se actualiza con la parte conectada en la transferencia. Cuando la parte remota cuelga la pantalla no se actualiza a la nueva situación.
|-
!Transferencia sin consulta!!
|-
|Cisco inicia la llamada y realiza la transferencia||Las extensiones que quedan al habla presentan en pantalla información del teléfono conectado. Transcurrido el tiempo de no contesta, la llamada no vuelve a la extensión que inicio la transferencia.
|-
|Cisco inicia la llamada, luego es transferido por la extensión a la que llamó||Se actualiza la información de la parte conectada.
|-
1Cisco recibe una llamada transferida directamente||Se actualiza la información de la parte conectada.
|-
!MENSAJERÍA VOCAL!!
|-
|Señalización en el terminal de mensajes nuevos pendientes.||Indicador de mensaje con parpadeo en rojo de la banda luminosa del auricular. También aparece información de mensaje en el display.
|-
|Acceso al buzón de voz con tecla específica de mensajería (tecla sobre)||Una vez que se accede a la mensajería, ésta nos pide clave de acceso.
|-
|Acceso al buzón de voz con código *42# de Vivait Call||Una vez que se accede a la mensajería, ésta nos pide número de buzón y clave de acceso.
|-
!GRUPO DE CAPTURA!!
|-
1Llamada interna entrante a una de las extensiones del Grupo y captura desde el Cisco (con código de Asterisk *8)||El display de la extensión que captura la llamada se actualiza con la información del número llamante.
|-
|Llamada externa entrante a una de las extensiones del Grupo y captura desde el Cisco (con código de Asterisk *8)||El display de la extensión que captura la llamada se actualiza con la información del número llamante.
|-
|Sacamos del Grupo la extensión del Cisco y se comprueba que ella NO puede capturar y el resto sí puede||Si se intenta capturar con código *8 se recibe señal de no progreso.
|-
!DESVÍOS!!
|-
|Desvío de extensión con códigos de Vivait Call
|-
|Activación/desactivción desvió extensión incondicional (código *21* Vivait Call) (1)||La situación no se informa en pantalla.
|-
|Activación/desactivción desvió extensión incondicional a mensajería (código *21# Vivait Call) (1)||La situación no se informa en pantalla.
|-
|Activación/desactivción desvió extensión por no contesta (código *211* Vivait Call)||La situación no se informa en pantalla.
|-
|Activación/desactivción desvió extensión por no contesta a mensajería (código *211# Vivait Call)||La situación no se informa en pantalla.
|-
|Activación/desactivción desvió extensión por ocupado (código *212* Vivait Call)||No se puede desactivar llamada en espera. La situación no se informa en pantalla.
|-
|Activación/desactivción desvió extensión por ocupado a mensajería (código *212# Vivait Call)||No se puede desactivar llamada en espera. La situación no se informa en pantalla.
|-
1Activación/desactivción desvió extensión por fuera de servicio (código *213* Vivait Call)||El llamante escucha silencio 30 segundos y después se produce libera la llamada. Pasado un tiempo bastante largo, sin determinar, el desvío se produce inmediatamente. La situación no se informa en pantalla.
|-
|Activación/desactivción desvió extensión por fuera de servicio a mensajería (código *213# Vivait Call)||El llamante escucha silencio 30 segundos y después se produce libera la llamada. Pasado un tiempo bastante largo, sin determinar, el desvío se produce inmediatamente. La situación no se informa en pantalla.
|-
!Desvío de usuario con códigos de Vivait Call!!
|-
|Activación/desactivación desvió usuario incondicional (código *22* Vivait Call) (1)||La situación no se informa en pantalla.
Al llamante no se le informa del desvío hasta que la extensión destino del desvío descuelga.
|-
|Activación/desactivación desvió extensión incondicional a mensajería (código *22# Vivait Call) (1)||La situación no se informa en pantalla.
|-
|Activación/desactivación desvió usuario por no contesta (código *221* Vivait Call)||La situación no se informa en pantalla.
Al llamante no se le informa del desvío hasta que la extensión destino del desvío descuelga.
|-
|Activación/desactivación desvió usuario por no contesta a mensajería (código *221# Vivait Call)||La situación no se informa en pantalla.
|-
|Activación/desactivación desvió usuario por ocupado (código *222* Vivait Call)||No se puede desactivar la llamada en espera. La situación no se informa en pantalla.
|-
|Activación/desactivación desvió usuario por ocupado a mensajería (código *222# Vivait Call)||No se puede desactivar la llamada en espera. La situación no se informa en pantalla.
|-
|Activación/desactivación desvió usuario por logout (código *223* Vivait Call)||La situación no se informa en pantalla.
No se informa del desvío hasta que la posición destino del desvío descuelga.
|-
|Activación/desactivación desvió usuario por logout a mensajería (código *223# Vivait Call)||La situación no se informa en pantalla.
|-
!Desvío desde el terminal (funcionan tanto si se llama a la extensión como al usuario)!!
|-
|Desvió incondicional (1)||La situación se informa en pantalla.
|-
|Nota 1 Cuando se programa el desvío inmediato desde Vivait Call y desde el terminal, el desvío programado en Vivait Call es prioritario sobre el programado en el terminal.
|-
!"SERVICIO JEFE SECRETARIA Terminales telefónicos Cisco 7911 (jefe) y 7945 (secretaria)"!!
|-
|Llamadas al servicio JEFE/SECRETARIA||Para estas pruebas se ha configurado la extensión sin RTP directo. Parámetro "directmedia=update" en el perfil de la extensión en Asterisk.
|-
|Llamada interna entrante a la extensión del Jefe||Se produce el desvío. El display de la secretaria presenta información del llamante. El display del llamante presenta información del conectado una vez que la secretaria ha descolgado.
|-
|Llamada interna entrante al usuario del Jefe||Se produce el desvío. El display de la secretaria presenta información del llamante. El display del llamante presenta información del conectado una vez que la secretaria ha descolgado.
|-
|Llamada externa entrante al Jefe||Se produce el desvío. El display de la secretaria presenta información del llamante. El display del llamante presenta número marcado.
|-
|Llamada externa entrante a la secretaria||La señalización de la llamada en el terminal de la secretaria no se diferencia del caso anterior.
|-
|Tránsito a través de Secretaria de llamada interna entrante a jefe y saliente originada en secretaria||Se comprueba el desvío de la llamada interna a la secretaria y que ésta puede llamar al exterior y transferir la llamada. En transferencia el display del llamante muestra información de la transferencia.
|-
|Supervisión del Jefe en el terminal de la Secretaria mediante BLF||Solo cambia el estado del botón de supervisión cuando se completa el envío de cifras por la extensión supervisada.
|-
!Transferencia con consulta!!
|-
|Llamada local originada en secretaria, primero llama al jefe y luego transfiere||Tanto si la secretaria marca el número de extensión física del jefe como si marca el número de usuario.
Se actualiza información en display de parte conectada.
|-
|Llamada local originada en secretaria, llama a otra extensión y luego transfiere al jefe||Tanto si la secretaria marca el número de extensión física del jefe como si marca el número de usuario.
Se actualiza información en display de parte conectada.
|-
|Llamada externa originada en secretaria, llama al jefe y luego transferida al exterior||Tanto si la secretaria marca el número de extensión física del jefe como si marca el número de usuario.
Se actualiza información en display de parte conectada.
|-
|Llamada externa originada en secretaria, llama al exterior y luego transferida al jefe||Tanto si la secretaria marca el número de extensión física del jefe como si marca el número de usuario.
Se actualiza información en display de parte conectada.
|-
|Llamada local entrante a la secretaria y luego transfiere al jefe||Tanto si la secretaria marca el número de extensión física del jefe como si marca el número de usuario.
Se actualiza información en display de parte conectada.
|-
|Llamada externa entrante a la secretaria y luego transfiere al jefe||Tanto si la secretaria marca el número de extensión física del jefe como si marca el número de usuario.
Se actualiza información en display de parte conectada.
|-
|Llamada local entrante al jefe, recibida por la secretaria y trasferida después al jefe||Tanto si la secretaria marca el número de extensión física del jefe como si marca el número de usuario.
No se actualiza información en display de parte conectada.
|-
|Llamada externa entrante al jefe, recibida por la secretaria y trasferida después al jefe||Tanto si la secretaria marca el número de extensión física del jefe como si marca el número de usuario.
Se actualiza información en display de parte conectada.
|-
!Transferencia sin consulta!!
|-
|Llamada local originada en secretaria, primero llama al jefe y luego transfiere||Tanto si la secretaria marca el número de extensión física del jefe como si marca el número de usuario.
Para realizar la transferencia es necesario esperar que el destino de la transferencia comience a sonar.
Las extensiones que quedan al habla presentan en pantalla información del teléfono conectado.
Transcurrido el tiempo de no contesta, la llamada no vuelve a la extensión que inicio la transferencia.
|-
|Llamada local originada en secretaria, llama a otra extensión y luego transfiere al jefe||Tanto si la secretaria marca el número de extensión física del jefe como si marca el número de usuario.
Para realizar la transferencia es necesario esperar que el destino de la transferencia comience a sonar.
Las extensiones que quedan al habla presentan en pantalla información del teléfono conectado.
Transcurrido el tiempo de no contesta, la llamada no vuelve a la extensión que inicio la transferencia.
|-
|Llamada externa originada en secretaria, llama al jefe y luego transferida al exterior||Tanto si la secretaria marca el número de extensión física del jefe como si marca el número de usuario.
Para realizar la transferencia es necesario esperar que el destino de la transferencia comience a sonar.
Las extensiones que quedan al habla presentan en pantalla información del teléfono conectado.
Transcurrido el tiempo de no contesta, la llamada no vuelve a la extensión que inicio la transferencia.
|-
|Llamada externa originada en secretaria, llama al exterior y luego transferida al jefe||Tanto si la secretaria marca el número de extensión física del jefe como si marca el número de usuario.
Para realizar la transferencia es necesario esperar que el destino de la transferencia comience a sonar.
Las extensiones que quedan al habla presentan en pantalla información del teléfono conectado.
Transcurrido el tiempo de no contesta, la llamada no vuelve a la extensión que inicio la transferencia.
|-
|Llamada local entrante a la secretaria y luego transfiere al jefe||Tanto si la secretaria marca el número de extensión física del jefe como si marca el número de usuario.
Para realizar la transferencia es necesario esperar que el destino de la transferencia comience a sonar.
Las extensiones que quedan al habla presentan en pantalla información del teléfono conectado.
Transcurrido el tiempo de no contesta, la llamada no vuelve a la extensión que inicio la transferencia.
|-
|Llamada externa entrante a la secretaria y luego transfiere al jefe||Tanto si la secretaria marca el número de extensión física del jefe como si marca el número de usuario.
Para realizar la transferencia es necesario esperar que el destino de la transferencia comience a sonar.
Las extensiones que quedan al habla presentan en pantalla información del teléfono conectado.
Transcurrido el tiempo de no contesta, la llamada no vuelve a la extensión que inicio la transferencia.
|-
|Llamada local entrante al jefe, recibida por la secretaria y trasferida después al jefe||Tanto si la secretaria marca el número de extensión física del jefe como si marca el número de usuario.
Para realizar la transferencia es necesario esperar que el destino de la transferencia comience a sonar.
Las extensiones que quedan al habla presentan en pantalla información del teléfono conectado.
Transcurrido el tiempo de no contesta, la llamada no vuelve a la extensión que inicio la transferencia.
|-
|Llamada externa entrante al jefe, recibida por la secretaria y trasferida después al jefe||Tanto si la secretaria marca el número de extensión física del jefe como si marca el número de usuario.
Para realizar la transferencia es necesario esperar que el destino de la transferencia comience a sonar.
Las extensiones que quedan al habla presentan en pantalla información del teléfono conectado.
Transcurrido el tiempo de no contesta, la llamada no vuelve a la extensión que inicio la transferencia.
|}

=== 7965 ===
'''NO ES POSIBLE REALIZAR CONFERENCIA A TRES.'''

''Se probó parche desarrollado para Asterisk 11 con resultado positivo (la conferencia a tres era posible en este terminal cuando lo aprivisionamos en Asterisk 11 y el parche está instalado)''

{| class="wikitable"
|-
! Item !! Observaciones
|-
!BOTONES (Se comprueba la funcionalidad esperada al actuar sobre el botón)!!
|-
!NOMBRE DEL BOTÓN Y ACCIÓN!!
|-
|Botones Programables (6 botones a la derecha de la pantalla)||En función de la configuración, los botones programables proporcionan acceso a:
-Líneas de teléfono y líneas de intercomunicación (botones de línea) PROBADO.
-Números de marcación rápida (botones de marcación rápida, incluida la función de marcación rápida BLF) PROBADO.
-Servicios basados en la Web (por ejemplo, el botón de libreta personal de direcciones) NO PROBADO.
-Funciones del teléfono (por ejemplo, un botón de privacidad, espera o transferencia) NO PROBADO.
|-
|Botón de Pantalla: Saca a la pantalla del modo suspendido (protección de pantalla)||Luce en verde fijo cuando la pantalla está en modo suspendido.
|-
|Botón Mensajes: Marca de forma automática el número del servicio de mensajes de voz.||Es posible incorporar al fichero de configuración del terminal la marcación de acceso al buzón de voz. Esto habilita la funcionalidad de este botón.
|-
|Botón de directorios: Abre y cierra el menú Directorios.||En la configuración del terminal probada permite acceder a los registros de llamadas perdidas, recibidas, realizadas. No da acceso a directorios ni local ni corporativo.
|-
|Botón de ayuda (?): Activa el menú Ayuda.||Se pierde el acceso al Servicio de Ayuda.
|-
|Botón Servicios: Abre y cierra el menú de servicios||Al accionarlo el display presenta "Host no encontrado"
|-
|Botón Auriculares: Activa o desactiva los auriculares. Cuando los auriculares están activados,el botón está encendido.||'''Pendiente de prueba'''
|-
|'''BOTONES PROGRAMADOS''': Se trata de botones que dan acceso a opciones de funciones que aparecen en la pantalla LCD y que varían dependiendo del estado del teléfono y de la llamada en curso.||Se comprueba que efectivamente se ejecuta la opción indicada para el botón en cada situación
|-
!OPCIÓN PROGRAMADA!!
|-
|NoMlsta: Activa/desactiva la función Mo Molestar.||Es una función configurable por el administrador. La configuración probada es "la llamada entrante se señaliza con un destello ámbar del botón de línea, no hay indicación sonora".
|-
|Dsvinc: Activa/desactiva el desvío incondicional de las llamadas a otra extensión predeterminada en el proceso de activación||Después de Configurar el número de teléfono de la posición de desvío no dispongo de la opción aceptar (NO SE PUEDE COMPLETAR LA ACCIÓN).
|-
|Espera: Pone una llamada en espera.||El lado de la comunicación en espera recibe música en espera
|-
|Trnsf: Inicia la transferencia y transfiere la llamada en curso. Pone en espera la llamada actual e inicia una nueva llamada.|| Cuando el destino llamado contesta, permite la transferencia de la llamada en espera.
más: muestra el resto de botones con opciones programadas disponibles
|-
|Confr: Iniciar una conferencia a tres.||Con el teléfono conectado a Asterisk 13 la conferencia NO FUNCIONA.
|-
!TAREAS TELEFÓNICAS COMUNES!!
|-
|DESCRIPCIÓN DE LA TAREA
|-
|Realizar una llamada interna y otra externa descolgando el auricular y marcando, y en modo manos libres (pulso botón altavoz y marco)||Retardo apreciable desde que se envían las cifras hasta que se establece la conexión.
|-
|Transferir la llamada actual a un nuevo número sin consulta (Transferencia Directa)||No puede realizar una transferencia directa, la opción transferir no aparece en el display hasta que se produce llamada en el lado C (extensión que recibe la transferencia). Si transferimos en llamada antes de que descuelgue el lado C se produce el reparo general identificado para este caso de transferencia (el display del terminal que recibe la llamada transferida no actualiza para presentar el número conectado).
|-
|Iniciar una conferencia a tres||No es posible en Asterisk 13.
|-
|Activar el desvío incondicional de las llamadas entrantes con función del teléfono||La configuración del terminal probada no permite activar el desvío de las llamadas dirigidas al terminal haciendo uso de "Dsvinc".
|-
|Captura de llamadas. Captura de una llamada dirigida a otra extensión del mismo nodo (Cod. Captura+número de exten.)||Transcurren varios segundos (8 a 10) desde que se envían las cifras hasta que se establece la conexión por captura. Al producirse la captura el display del 7965 presenta información del conectado (origen de la llamada capturada).
|-
|Grupo de Captura: Captura llamadas dirigidas a cualquier extensión del grupo al que pertenece (Cod. Función *8)||El retardo en establecimiento es mucho menos evidente (aceptable) que en el caso anterior. Al producirse la captura el display del 7965 presenta información del conectado (origen de la llamada capturada).
|-
!BUZÓN DE VOZ!!
|-
|Señalización en el terminal de mensajes nuevos pendientes.||Indicación luminosa en led del micro teléfono y símbolo en display.
|-
|Acceso al buzón de voz||Tiempo de espera apreciable (9s.) hasta que se produce el establecimiento de la conexión con el buzón. Si habilitamos el acceso a través de la tecla messages no hay retardo en el establecimiento de la llamada al buzón de voz.
|-
|Consulta de mensajes||Una vez consultados los mensajes en la carpeta nuevos, desaparece la señalización en el terminal de mensajes nuevos pendientes.
|-
!Servicio Jefe/secretaria!!
|-
|SUPERVISIÓN:La lámpara asociada a la tecla configurada como BLF luce:|| Cuando el teléfono supervisado recibe llamada entrante (ámbar, parpadeo rápido).
Cuando el teléfono supervisado responde a una llamada (rojo, fijo).
Cuando el teléfono supervisado envía las cifras en una llamada originada por él (rojo, fijo).
|-
|Transferencia de una llamada desde la secretaria al Jefe sin consulta.||La transferencia directa pura no es posible. Se puede transferir mientras el jefe recibe señal de llamada, en ese caso se produce el reparo general identificado para este caso de transferencia (Al descolgar el desplaye del terminal del Jefe no cambia para mostrar el número conectado).
|-
|Transferencia de una llamada desde el Jefe a la secretaria.||Funciona dentro de los límites identificados, en este modelo, para la transferencia (No hay transferencia directa).
|}

=== 8811IP ===
{| class="wikitable"
|-
! Item !! Observaciones
|-
|Botón mensajes||Marca automáticamente el número de sistema de mensajería de voz
|-
|Eliminar un interlocutor de la conferencia||"Al no poder visualizarse la lista de participantes no se puede eliminar un participante de la conferencia.
Si uno de los participantes en la conferencia libera su comunicación la conferencia continua.
Si el líder abandona la conferencia, ésta finaliza."
|-
|Acceso al buzón de voz con tecla específica de mensajería (tecla grabadora)||Al pulsar la tecla aparece la información: “Mensajes no disponibles”
|-
|Acceso al buzón de voz con tecla de sesión de mensajería (icono grabadora)||Al pulsar la tecla aparece la información: “Mensajes no disponibles”
|-
|Supervisión del Jefe en el terminal de la Secretaria mediante BLF||La supervisión del teléfono del jefe en una tecla de función se pierde pasado un tiempo no determinado.
|-
|Llamada a un destino externo desde la aplicación||La llamada se indica en el terminal pero no progresa
|-
|Conferencia con supervisor desde el terminal||Aparece el mensaje “No se puede completar conferencia”
|-
|Conferencia con no supervisor desde el terminal||Aparece el mensaje “No se puede completar conferencia”
|-
|Establecida comunicación con agente, consulta destino externo desde VIVA desk||La llamada se indica en el terminal pero no progresa
|-
|Conferencia desde el terminal||Aparece el mensaje “No se puede completar conferencia”
|-
|Establecida comunicación con agente, consulta destino externo desde VIVA desk||La llamada se indica en el terminal pero no progresa
|-
|Conferencia desde el terminal||Aparece el mensaje “No se puede completar conferencia”
|-
|Establecida comunicación con agente, consulta destino externo desde VIVA desk||La llamada se indica en el terminal pero no progresa
|-
|Establecida comunicación con agente, consulta destino externo desde el terminal||La llamada se indica en el terminal pero no progresa
|-
|Conferencia desde el terminal||Aparece el mensaje “No se puede completar conferencia”
|-
|Establecida comunicación con agente, consulta destino externo desde VIVA desk||La llamada se indica en el terminal pero no progresa
|-
|Establecida comunicación con agente, consulta destino externo desde el terminal||La llamada se indica en el terminal pero no progresa
|-
|Conferencia desde el terminal||Aparece el mensaje “No se puede completar conferencia”
|}

-'''Nota:''' Cuando se programa el desvío inmediato desde Vivait Call y desde el terminal, el desvío programado en Vivait Call es prioritario sobre el programado en el terminal.

=== 512G ===

{| class="wikitable"
|-
! Item !! Observaciones
|-
|Llamada local entrante a la Secretaria que luego transfiere al Jefe||La llamada vuelve a la secretaria. Se puede utilizar la función de transferencia con consulta y cuando el teléfono del jefe comience a sonar realizar la transferencia.
|-
|Llamada internodos entrante a la Secretaria que luego transfiere al Jefe||La llamada vuelve a la secretaria. Se puede utilizar la función de transferencia con consulta y cuando el teléfono del jefe comience a sonar realizar la transferencia.
|-
|Llamada externa entrante a la Secretaria que luego transfiere al Jefe||La llamada vuelve a la secretaria. Se puede utilizar la función de transferencia con consulta y cuando el teléfono del jefe comience a sonar realizar la transferencia.
|-
|Llamada local entrante al jefe, recibida por la secretaria y trasferida después al jefe||La llamada vuelve a la secretaria. Se puede utilizar la función de transferencia con consulta y cuando el teléfono del jefe comience a sonar realizar la transferencia.
|-
|Llamada local entrante al jefe, recibida por la secretaria y trasferida después al jefe||La llamada vuelve a la secretaria. Se puede utilizar la función de transferencia con consulta y cuando el teléfono del jefe comience a sonar realizar la transferencia.
|-
|Llamada externa entrante al jefe, recibida por la secretaria y luego transferida al jefe||La llamada vuelve a la secretaria. Se puede utilizar la función de transferencia con consulta y cuando el teléfono del jefe comience a sonar realizar la transferencia.
|}

=== 514G ===

{| class="wikitable"
|-
! Item !! Observaciones
|-
|Llamada local entrante a la secretaria y luego transfiere al jefe||La llamada vuelve a la secretaria. Se puede utilizar la función de transferencia con consulta y cuando el teléfono del jefe comience a sonar realizar la transferencia.
|-
|Llamada externa entrante a la secretaria y luego transfiere al jefe||La llamada vuelve a la secretaria. Se puede utilizar la función de transferencia con consulta y cuando el teléfono del jefe comience a sonar realizar la transferencia.
|-
|Llamada local entrante al jefe, recibida por la secretaria y trasferida después al jefe||La llamada vuelve a la secretaria. Se puede utilizar la función de transferencia con consulta y cuando el teléfono del jefe comience a sonar realizar la transferencia.
|-
|Llamada externa entrante al jefe, recibida por la secretaria y luego transferida al jefe||La llamada vuelve a la secretaria. Se puede utilizar la función de transferencia con consulta y cuando el teléfono del jefe comience a sonar realizar la transferencia.
|}

=== VG224 ===
Los gateways VG224 son compatibles con SIP, pero sus funcionalidades quedan muy limitadas al configurarlos '''en SIP''' tal y como se muestra en la siguiente tabla (tercera columna):

[[Archivo:vg224.png|center]]

=== Skinny en VIVAit Call ===

Con los terminales '''Cisco''' es posible cargar módulos SCCP y MGCP en VIVAit, si bien, desconocemos la funcionalidad (qué funciona y qué no), la estabilidad (se cae o no se cae) y la escalabilidad (cuantos elementos se soportan y cuanto afecta cada elemento adicional a las prestaciones del sistema) en un entorno que no se considere de uso '''testimonial''', por lo que '''no podemos asegurar su funcionalidad ni su funcionamiento'''.

Los terminales de '''Cisco''' identificados que utilizan únicamente estos módulos son:
* Cisco Unified Wireless IP Phone 7921 Series
* Cisco IP Conference Station Model 7937



== Grandstream ==

=== DP715_EU ===
{| class="wikitable"
|-
! Item !! Observaciones
|-
|Realizar una llamada interna a un teléfono desviado || El display del terminal inalámbrico NO CAMBIA para mostrar información del conectado (posición de desvío).
|-
| Hacer una llamada, ponerla en espera y reanudarla || El lado en espera NO recibe música en espera
|-
| Iniciar una conferencia a tres || Con el DP715 conectado a la llamada actual, pulsar R. La llamada actual queda retenida SIN MÚSICA EN ESPERA
|-
| Capturar una llamada dirigida a otra extensión *41*Nº || Cuando se establece la conexión el display del DP 715 presenta la combinación de cifras marcada para la captura. NO SE ACTUALIZA CON LA INFORMACIÓN DEL LLAMANTE (NÚMERO CONECTADO).
|-
|Activar/Desactivar NO MOLESTEN en DP 715: Marque *78 para activar. Marque *79 para desactivar||El estado (NO MOLESTEN) NO se informa en la pantalla del terminal. Con no molesten activo las llamadas serán rechazadas (El llamante recibe ocupado)
|-
|DP 715 inicia la llamada, luego es transferido por la extensión a la que llamó.||Tras la transferencia, la pantalla del DP 715 sigue presentando el número que marcó, NO se actualiza para presentar el conectado
|-
|DP 715 recibe una llamada transferida tras ser consultado.||Tras la transferencia, la pantalla del DP 715 sigue presentando el número del llamante, NO se actualiza para presentar el conectado.
|-
|-
|}

=== GXP 2135 ===
{| class="wikitable"
|-
! Item !! Observaciones
|-
|Gestión de desvíos de USUARIO por código de facilidad: Uso de *31x|| '''NO OK'''
En GXP 2135 se utiliza *30 y *31 para bloquear/desbloquear el envío de la identidad del llamante.
|}
=== GXP 2140 ===
{| class="wikitable"
|-
! Item !! Observaciones
|-
|Gestión de desvíos de USUARIO por código de facilidad: Uso de *31x|| '''NO OK'''
En GXP 2140 se utiliza *30 y *31 para bloquear/desbloquear el envío de la identidad del llamante.
|}

=== GXP 2170 ===
{| class="wikitable"
|-
! Item !! Observaciones
|-
|Gestión de desvíos de USUARIO por código de facilidad: Uso de *31x|| '''NO OK'''
En GXP 2170 se utiliza *30 y *31 para bloquear/desbloquear el envío de la identidad del llamante.
|}

=== GXV 3240 ===
{| class="wikitable"
|-
! Item !! Observaciones
|-
|SE PRODUCEN ERRORES AL APLICAR LOS CAMBIOS DE CONFIGURACIÓN REALIZADOS EN EL PORTAL DEL TELÉFONO||
Aunque el portal responda con el mensaje ""Aplicado exitoso"" Se ha comprobado que en unos casos el cambio no produce el efecto esperado o, en otros, que la aplicación de los cambios deja al terminal sin posibilidad de llamar a ningún número (Call failed: error 404, NOT FOUND). La razón es que la aplicación de los cambios deja al terminal sin registro en Asterisk.
En la ""Barra de Estado"" aparecen notificaciones de error en la descarga de ficheros.
|}

=== GXV 3275 ===
{| class="wikitable"
|-
! Item !! Observaciones
|-
|SE PRODUCEN ERRORES AL APLICAR LOS CAMBIOS DE CONFIGURACIÓN REALIZADOS EN EL PORTAL DEL TELÉFONO||
Aunque el portal responda con el mensaje ""Aplicado exitoso"" Se ha comprobado que en unos casos el cambio no produce el efecto esperado o, en otros, que la aplicación de los cambios deja al terminal sin posibilidad de llamar a ningún número (Call failed: error 404, NOT FOUND). La razón es que la aplicación de los cambios deja al terminal sin registro en Asterisk.
En la ""Barra de Estado"" aparecen notificaciones de error en la descarga de ficheros.
|-
|Realizar y recibir una llamada de video||
La calidad observada es peor que la de otros terminales probados que soportan video llamada. Puede ser achacable al entorno de prueba.
|-
|Acciones del menú (Opciones del Buzón). El submenú Opciones del Buzón permite al usuario grabar mensajes personalizados como saludo temporal o grabar mensajes personalizados para los casos de "no disponible" u "ocupado" o grabar su nombre||
Hay un escenario en el que después de haber grabado; el mensaje personal para ocupado, el mensaje personal para no disponible, el mensaje con el nombre o un saludo temporal, la consulta del archivo que contiene la grabación (opción 2 del submenú) produce la desconexión de la llamada establecida con el Buzón de Voz, sin que se pueda comprobar el mensaje que se grabó.
Este fallo sólo se produce si accedemos al Buzón de Voz haciendo uso de la tecla programada para ello.
|}

== Huawei ==

=== eSpace 7910 ===
Multiples consideraciones de funcionamiento debidas aprovisionamiento especifico (pendiente de confirmar)
{| class="wikitable"
|-
! Item !! Observaciones
|-
|Botón Mensajes||No operativo al acceder la pantalla muestra BUZÓN y nada más
|-
|DND: Función "No Molesten"||'''NO OK'''
No se puede configurar la función
|-
Realizar una llamada interna a un teléfono ocupado||El Huawei informa de la situación de ocupado del llamado con un mensaje en pantalla (presentación muy corta en pantalla). No se recibe tono de ocupado.
|-
|Realizar una llamada interna a un teléfono desviado||El Display presenta el número marcado. NO el conectado (Posición de desvío)
|-
|HUAWEI 7910 inicia la llamada e inicia la transferencia.||Las extensiones que quedan al habla presentan en pantalla información del teléfono conectado. Si el teléfono que recibe la llamada transferida es Huawey su pantalla presenta el número de la extensión que lo llamó, NO el conectado
|-
|HUAWEI 7910 inicia la llamada, luego es transferido por la extensión a la que llamó.||Tras la transferencia, en la pantalla del Huawey aparece el número que marcó, NO el Conectado
|-
HUAWEI 7910 recibe una llamada transferida tras ser consultado.||En la pantalla del Huawey aparece el número de la extensión que lo llamó, NO el Conectado
|-
|Activar el desvío de las llamadas entrantes (locales y externas).En la pantalla de Inicio seleccionamos Aplic, Luego Pref-Func llamadas-Desvío llam. En esta situación presenta las opciones ""Todas a"", ""Por ocupado a"", ""Por no contesta a"","" Por fuera de línea a"""||'''NO OK'''
No se puede configurar ninguna opción de desvío a través de este menú. Parecen estar deshabilitadas
|-
|Capturar una llamada dirigida a otro teléfono.En Huawey marcamos (código de captura + nº extensión recibiendo llamada).||Tras la captura en la pantalla del Huawey aparece la combinación de dígitos marcada, NO el conectado.
|-
|Señalización en el terminal de mensajes nuevos pendientes.||'''INEXISTENTE'''
Hay una barra led que se nombra cómo MWI en el guía que se entrega con el terminal que podría estar relacionada con esta funcionalidad.
|-
|SUPERVISIÓN||'''NO OK'''
No se ha podido configurar un BLF
|-
|Transferencia de una llamada desde la secretaria al Jefe con consulta.||En la extensión del jefe se produce el defecto de presentación del número conectado explicado en: "Recepción de la llamada transferida a un Huawei tras ser consultado.
|}

=== eSpace 7950 ===


{| class="wikitable"
|-
! Item !! Observaciones
|-
|Botón Mensajes||'''No operativo''' al acceder la pantalla muestra BUZÓN y nada más
|-
|Botón Desvíos||'''NO OK'''
No es posible configurar ninguna de las opciones de desvío. El teléfono responde "Error de ajustes"
|-
|Realizar una llamada interna || El Display presenta el número marcado. Cuando aparece el Nombre es porque el número marcado está en la lista de contactos y el Nombre que vemos es el que tiene asociado en ella.
|-
|Realizar una llamada interna a un teléfono desviado || El Display presenta el número marcado. NO el conectado (Posición de desvío).
|-
|HUAWEY 7950 inicia la llamada, luego es transferido por la extensión a la que llamó||En la pantalla del Huawey aparece el número marcado, NO el Conectado
|-
|HUAWEY 7950 recibe una llamada transferida tras ser consultado|| En la pantalla del Huawey aparece el número de la extensión que lo llamó, NO el Conectado
|-
|HUAWEY 7950 inicia la llamada, luego es transferido por la extensión a la que llamó.||En la pantalla del Huawey aparece el número marcado, NO el Conectado
|-
|Activación del desvío de llamadas con el Menú del HUAWEY||'''NO OK''' 
No se puede configurar ninguna opción de desvío a través de este menú. Parecen estar deshabilitadas
|-
|Capturar una llamada dirigida a otro teléfono.||Tras la captura en la pantalla del Huawey aparece la combinación de dígitos marcada, NO el conectado.
|-
|SUPERVISIÓN||'''NO OK''' No se ha podido configurar un BLF
|-
|Transferencia de una llamada desde la secretaria al Jefe '''con consulta'''||En la extensión del jefe se produce el defecto de presentación del número conectado explicado en: "Recepción de la llamada transferida a un Huawey tras ser consultado.
|}

== Innovaphone ==

=== IP110 ===
Configuración sin aprovisionamiento

MUY IMPORTANTE: Para que la marcación con el teléfono descolgado y tono de invitación a marcar sea posible, debemos configurar algún valor para el parámetro "Enblock Dialing Timeout".
Nos conectamos a la página de configuración del fabricante. En la pestaña ""Phone""- "General" el parámetro viene en blanco. Configurar un valor (Son los segundos de espera para el envío de las cifras en bloque).

== Mitel ==
Se ha detectado que terminales Aastra utilizan el campo PAI en lugar del RPID para realizar el envío del nombre del llamante; esto genera limitaciones cuando se realizan llamadas a terminales que usan el campo RPID --> Por ejemplo terminales Cisco
=== 5212 ===

{| class="wikitable"
|-
! Item !! Observaciones
|-
|Llamada local entrante a la secretaria y luego transfiere al jefe||La llamada vuelve a la secretaria. La llamada se identifica en el jefe con número llamante el inicialmente concectado por lo que no puede saltarse el desvío.
|-
|Llamada externa entrante a la secretaria y luego transfiere al jefe||La llamada vuelve a la secretaria. La llamada se identifica en el jefe con número llamante el inicialmente concectado por lo que no puede saltarse el desvío.
|-
|Llamada local entrante al jefe, recibida por la secretaria y trasferida después al jefe || La llamada vuelve a la secretaria. La llamada se identifica en el jefe con número llamante el inicialmente concectado por lo que no puede saltarse el desvío.
|-
|Llamada externa entrante al jefe, recibida por la secretaria y luego transferida al jefe || La llamada vuelve a la secretaria. La llamada se identifica en el jefe con número llamante el inicialmente concectado por lo que no puede saltarse el desvío.
|}

== Mobotix ==

=== T25 ===
* Pruebas básicas de registro SIP
* Comprobado funcionamiento de audio y vídeo

'''Procedimiento de configuración básica:'''

* Entrar a la web e ir a Admin Menu
* Configurar la extensión en SIP Client Settings
* Para configurar a donde llama cuando se pulse la campana:
:# Outgoing Call Settings: añadir un nuevo perfil, con la extensión a la que se quiere que se llame cuando se pulse la campana.
:# En Bell Behavior and Video Mailbox, dentro de Set Remote Stations for Door Station / Outgoing Call Profiles seleccionar el perfil creado en el punto anterior y pulsar Add selected devices.
* Para que los cambios sean permanentes (si se quita la alimentación, se pierden los cambios), pulsar en Configuration / Store. En la nueva ventana, pulsar en el botón Store Permanently.

== Panasonic ==
=== KX-TGP600 ===

{| class="wikitable"
|-
! Item !! Observaciones
|-
|Llamada local entrante a la secretaria y luego transfiere al jefe||La llamada vuelve a la secretaria. Se puede utilizar la función de transferencia con consulta y cuando el teléfono del jefe comience a sonar realizar la transferencia.
|-
|Llamada externa entrante a la secretaria y luego transfiere al jefe||La llamada vuelve a la secretaria. Se puede utilizar la función de transferencia con consulta y cuando el teléfono del jefe comience a sonar realizar la transferencia.
|-
|Llamada local entrante al jefe, recibida por la secretaria y trasferida después al jefe || La llamada vuelve a la secretaria. Se puede utilizar la función de transferencia con consulta y cuando el teléfono del jefe comience a sonar realizar la transferencia.
|-
|Llamada externa entrante al jefe, recibida por la secretaria y luego transferida al jefe || La llamada vuelve a la secretaria. Se puede utilizar la función de transferencia con consulta y cuando el teléfono del jefe comience a sonar realizar la transferencia.
|}
==Siemens==
===OpenStage 15===

{| class="wikitable"
|-
! Item !! Observaciones
|-
!ESC 05: MENSAJERÍA VOCAL !!OBSERVACIONES/RESULTADOS
|-
|Acceso al buzón de voz con tecla específica de mensajería (tecla sobre)||No funciona el acceso directo al buzón, descolgando y pulsando la tecla sobre.
|-
!ESC 09: SERVICIO JEFE SECRETARIA !!
|-
!SUBESC 09.04: Transferencia sin consulta !!
|-
|Llamada local entrante a la secretaria y luego transfiere al jefe||"'''NOK''' La llamada vuelve a la secretaria.
Se puede utilizar la transferencia sobre señal de llamada"
|-
|Llamada externa entrante a la secretaria y luego transfiere al jefe|| "'''NOK''' La llamada vuelve a la secretaria.
Se puede utilizar la transferencia sobre señal de llamada"
|-
|Llamada local entrante al jefe, recibida por la secretaria y trasferida después al jefe|| "'''NOK''' La llamada vuelve a la secretaria.
Se puede utilizar la transferencia sobre señal de llamada"
|-
|Llamada externa entrante a la secretaria y luego transfiere al jefe|| "'''NOK''' La llamada vuelve a la secretaria.
Se puede utilizar la transferencia sobre señal de llamada"
|}

== Yealink ==
=== T18P ===
{| class="wikitable"
|-
! Item !! Observaciones
|-
|Realizar una llamada interna/externa||
retardo en el establecimiento de la comunicación
Desde que se termina la marcación del número hasta que se establece la llamada pasa un tiempo apreciable (en este terminal, cuando se desconfigura el # como tecla de envío no hay otra que se pueda utilizar para ello y solo queda esperar a que suene la señal de llamada). Este efecto se minimiza en remarcaciones o marcaciones rápidas.
|-
|Activar NO MOLESTEN en Yealink T18P||
LIMITACIONES:
Es necesaria la configuración de la función DND en una de las teclas DSS (usar la página web de configuración del terminal).
Activar DND: Con el micro receptor colgado o descolgado, pulsar una vez la tecla configurada como DND.
Desactivar DND: Con el micro receptor colgado, pulsar una vez la tecla configurada como DND. También, descolgando el micro receptor.
La limitación está en como señaliza el estado NO MOLESTAR el Terminal. En condiciones normales, el Led situado en la esquina superior izquierda del terminal cambia de lucir en verde fijo a parpadear en verde. Pero si hay mensajes pendientes de leer en el buzón de voz (Led fijo en color rojo), esta situación no cambia al activar NO MOLESTEN.
|}

=== SIP-T58V ===

{| class="wikitable"
|-
! Item !! Observaciones
|-
!ESC 09: VIDEOLLAMADAS !!
|-
!SUBESC 09.01: Realizar una videollamada
|-
|Realizar una videollamada mediante la función Llamada Reciente||'''NOK''' El terminal no proporciona la opción de llamada reciente con videollamada
|-
!SUBESC 09.02: Recibir una videollamada
|-
|Recibir una videollamada en modo de respuesta automática||'''NOK''' No se activa la videollamada
|-
!ESC 10: SERVICIO JEFE SECRETARIA !!
|-
!SUBESC 10.02: Tecla de supervisión
|-
|Realizar videollamada al jefe con tecla de supervisión||'''NOK''' El terminal no ofrece la posibilidad de invocar el servicio de vídeo al realizar una llamada con la tecla de supervisión
|-
!SUBESC 10.04: Transferencia sin consulta
|-
|Llamada local entrante a la secretaria y luego transfiere al jefe||'''NOK''' La llamada vuelve a la secretaria, no se pude saltar el desvío
|-
|Llamada externa entrante a la secretaria y luego transfiere al jefe||'''NOK''' La llamada vuelve a la secretaria, no se pude saltar el desvío
|-
|Llamada local entrante al jefe, recibida por la secretaria y trasferida después al jefe||'''NOK''' La llamada vuelve a la secretaria, no se pude saltar el desvío
|-
|Llamada externa entrante al jefe, recibida por la secretaria y trasferida después al jefe||'''NOK''' La llamada vuelve a la secretaria, no se pude saltar el desvío
|-
!ESC 12: AGENTE ACD
|-
!SUBESC 12.08: Grabación de llamadas entrantes a VDN. En modo de grabación (VDN, cola y perfil) “Grabación bajo demanda Inicio sin grabar”, y agente “Grabar todo = SI”
|-
|Activar grabación solo en VDN sin bip periódico||'''NOK''' Se graba segmento VDN, no se graba segmento Agente grabación en la sombra
Cuando se activa algún tipo de grabación no aparece el formulario en el agente
|-
|Activar grabación solo en VDN con bip periódico||'''NOK''' Se graba segmento VDN, no se graba segmento Agente grabación en la sombra
Cuando se activa al gún tipo de grabación no aparece el formulario en el agente
|-
|Yealink graba el audio y el video de una videollamada establecida||'''NOK''' No se activa la videollamada
|}

(*)Pruebas realizadas entre Videoterminales: Yealink T58V y Grandstream GXV3275
[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:VIVAit Suite]]

Manual Openfire

2018-03-22T07:06:37Z

Imatarrubias:

== Instalación de Openfire (versión 4.0.1) ==

'''IMPORTANTE: LA FUNCIONALIDAD DE LLAMAR DESDE EL CLIENTE SPARK SOLO FUNCIONA PARA LA VERSIÓN 4.1.3 DE OPENFIRE Y 2.7.5 DE SPARK'''

'''Openfire''' es un sistema de mensajería instantánea GPL, hecho en java y que utiliza el protocolo XMPP, con el podrás tener tu
propio servidor de mensajería puedes administrar a tus usuarios, compartir archivos, auditar mensajes, mensajes offline, mensajes
broadcast, grupos, etc

Nos bajamos '''openfire''' '''(recuerda, este manual está basado en la versión 4.0.1)''' para linux a través de la siguiente página: http://www.igniterealtime.org/downloads/index.jsp.

Seleccionamos .deb
Lo guardamos en el directorio '''/tmp'''

A continuación ejecutamos los siguientes comandos para extraer e instalar openfire:

# cd /tmp
# dpkg -i openfire_4_0_1.deb

Tendremos que tener en nuestra máquina instalado '''JAVA.'''

=='''Instalamos MYSQL'''==

La instalación de MYSQL se realiza a partir de este comando:

# apt-get install mysql-server

En la Openfire setup tool, que será mas adelante, usaremos los siguientes valores:

:• driver: com.mysql.jdbc.Driver
:• server: jdbc:mysql://[YOUR_HOST]/[DATABASE_NAME]

''Creamos'' la ''base e datos'' a partir del siguiente comando:

create database databaseName

''Importamos'' el ''esquema'' de la ''base de datos:''

mysql -u root -p databaseName < /usr/src/openfire/resources/database/openfire_mysql.sql

Una vez hecho esto vamos a ''instalar Java:''

# apt-get update 
# apt-get install openjdk-7-jre

Abrimos navegador y escribimos la siguiente URL http://IP:9090, donde IP es donde hemos instalado openfire.
Si está todo bien nos aparecerá la siguiente pantalla:

[[Archivo:Ip-9090.png |center]]

Configuramos el dominio del servidor:

[[Archivo:Configurar_dom_servidor.png |center]]

Donde el dominio es el nombre del Host o IP del servidor.

Configuración de base de datos para nuestro ejemplo seleccionamos base de datos interna, si vamos a usar base de datos externa '''(OPCION RECOMENDADA)''' seleccionamos la otra opción.

[[Archivo:Configurar base datos.png |center]]

Seteos de perfil

[[Archivo:Seteos_perfil.png |center]]

Seteos de perfil: Seteos de conexión, configuramos como sigue:

[[Archivo:Seteo conexion.png |center]]

Seteos de perfil: Mapeos de usuarios, dejamos las opciones por defecto

[[Archivo:Seteo_mapeo_usuario.png |center]]

Seteos de perfil: Mapeos de grupo, dejamos las opciones por defecto

[[Archivo:Seteo_mapeo_grupo.png |center]]

Cuenta del administrador: usuario que administre openfire exixtentes en el LDAP, los buscamos y agregamos:

[[Archivo:Cuenta_administrador.png |center]]

Finalizamos si todo esta ok.

[[Archivo:Todo_ok.png |center]]

Tras finalizar la instalación ingresaremos con la cuenta de administrador y si las credenciales son las correctas se nos mostrará la siguiente pantalla:

[[Archivo:Credenciales_correctas.png |center ]]

=='''Integración con asterisk'''==

Requisitos:

• haber instalado openfire con una base de datos externa (Mysql) 
• haber puesto el parámetro '''callevents=yes''' en la parte general del archivo sip.conf 
• haber configurado un usuario en el archivo manager.conf

Primero vamos a modificar el archivo ''manager.conf''

# nano /etc/asterisk/manager.conf

La parte general debe aparecer de la siguiente manera:

''[general]'' 
''enabled = yes'' 
''port = 5038'' 
''bindaddr = 0.0.0.0'' 

Luego, añadimos un nuevo usuario;

''[openfire]'' 
''secret = miclave'' 
''displayconnects = yes'' 
''read = all'' 
''write = all''

Actualizamos la configuración de asterisk:

# /etc/init.d/asterisk reload

En el caso que el servidor jabber (openfire) y el servidor Asterisk estén en dos servidores distintos, en la configuración del cortafuegos, si no lo han hecho antes, tienen que abrir el puerto 5038 tcp.

Arrancamos iptables:

# nano /etc/sysconfig/iptables

y añadimos estas dos líneas:

# Asterisk Manager
-A INPUT -p tcp --dport 5038 -j ACCEPT

Guardamos el archivo y volvemos a arrancar iptables

# service iptables restart

Ahora el archivo sip.conf

# nano /etc/asterisk/sip.conf

añadimos y/o modificamos la siguiente línea en la parte general

''callevents=yes''

Desde la consola de Asterisk:

# asterisk -rvvvvvvvvvvvvvv
CLI> sip reload

Ahora instalamos el ''plugin en Openfire.''

Desde la página web hay un plugin para la ''integracion de openfire con asterisk''. Descargamos dicho plugin desde http://www.igniterealtime.org/projects/openfire/plugins/asterisk-im.jar

Tras descargarlo lo guardamos en '''/usr/src/openfire/plugins'''

Reiniciamos el servicio openfire:

/etc/init.d/openfire stop
/etc/init.d/openfire start

Una vez instalado el plugin de asterisk, nos debe aparecer al lado de plugins algo así:

[[Archivo:Instalado_plugin_asterisk.png |center]]

Clicamos en '''Asterisk-IM''' y luego en '''General Settings.'''
''Habilitamos'' el Asterisk-IM y salvamos.

Agregamos el servidor asterisk:

• Server Name: asterisk 
• Server Address: xxx.xxx.xxx.xxx 
• Port: 5038 
• Username: Usuario creado en manager.conf 
• Password: Password del usuario creado en manager.conf

[[Archivo:Agregamos_serv_asterisk.png |center]]

Guardamos y pasamos al menú '''Phone Mappings'''

Configuramos todos los usuarios de Openfire que queremos asociar con una extensión SIP de nuestro servidor Asterisk.

[[Archivo:Usuarios_openfire.png |center]]

=='''Instalación de Jitsi-Videobridge'''==

'''Jitsi-Videobridge''' es un WebRTC que permite la comunicación de vídeo multiusuario.

Lo primero que haremos es habilitar los Componentes Externos en Openfired:

[[Archivo:Habilitar_comp_externos_openfired.png |center]]

Para instalar Jitsi Videobridge, lo descargamos de la siguiente URL:

https://download.jitsi.org/jitsi-videobridge/linux/

Simplemente ''extraeremos y ejecutaremos'' el script jvb.sh. Si lo ejecutamos sin parámetros se nos mostrará los diferentes argumentos que hay. Para arrancar el servicio basta con poner jvb.sh

--secret=xxxxx

Siendo el secret la clave que hemos configurado en el Componente Externo.

Para verificar que '''Jitsi esta correctamente conectado al Openfired''' iremos:
[[Archivo:Jitsi_correctamente_conectado.png |center]]

=='''Instalación de Jitsi'''==
Para sistemas de '''32 bits:'''

https://download.jitsi.org/jitsi/debian/jitsi_2.2-latest_i386.deb

Para sistemas de '''64 bits:'''

https://download.jitsi.org/jitsi/debian/jitsi_2.2-latest_amd64.deb

=='''Instalación Spark'''==

Lo descargamos de la siguiente URL:

'''* Windows:''' http://www.igniterealtime.org/downloads/download-landing.jsp?file=spark/spark_2_7_5.exe

'''* Linux:''' http://www.igniterealtime.org/downloads/download-landing.jsp?file=spark/spark_2_7_5.tar.gz 
y ejecutamos en el terminal:

tar -xvf spark_2.6.3.tar.gz
sudo mv Spark /opt/

Para correr el servicio: /bin/bash /opt/Spark

Si lo que queremos es crear un '''“desktop launcher”''':

sudo nano /usr/share/applications/spark.desktop

Y añadimos lo siguiente:

'''[Desktop Entry]''' 
Name=Spark 
Version=2.6.3 
GenericName=Spark 
X-GNOME-FullName=Spark 
Comment=ignite realtime Spark IM client 
Type=Application 
Categories=Application;Utility; 
Path=/opt/spark 
Exec=/bin/bash Spark 
Terminal=false 
StartupNotify=true 
Icon=/opt/spark/logo-spark.png 
TargetEnvironment=Unity

Para añadir el logo:
cd /tmp 
wget http://www.thefanclub.co.za/sites/default/files/images/howto/logo-spark_256x256.png 
sudo mv logo-spark_256x256.png /opt/Spark/logo-spark.png

=='''Instalación de LDAP'''==

El proceso de instalación es realmente sencillo. Básicamente consiste en instalar el paquete '''slapd,''' aunque nosotros también instalaremos el paquete que contiene las utilidades de administración de LDAP: '''ldap-utils.'''

# apt-get install slapd ldap-utils

Durante la instalación, aparece en la consola un mensaje que nos solicita la contraseña de administración para ''LDAP''

El sistema nos pide que volvamos a escribirla.

A continuación, instalaremos la librería '''NSS para LDAP.'''

# apt-get install libnss-ldap

En el primar paso, nos solicita la dirección URi del servidor LDAP.

A continuación escribiremos el nombre global único (Distinguished Name – DN).

En el siguiente paso, indicaremos la versión del protocolo LDAP que vamos a utilizar. Salvo que dispongamos en nuestra red de clientes muy antiguos, lo normal será elegir el valor más alto.

A continuación, indicaremos si las utilidades que utilicen PAM deberán comportarse del mismo modo que cuando cambiamos contraseñas locales. Esto hará que las contraseñas se guarden en un archivo independiente que sólo podrá ser leído por el superusuario. Yes y pulsamos Intro.

A continuación, el sistema nos pregunta si queremos que sea necesario identificarse para realizar consultas en la base de datos de LDAP. No y pulsamos Intro.

Ya sólo nos queda indicar el nombre de la cuenta LDAP que tendrá privilegios para realizar cambios en las contraseñas.

En el último paso, el asistente nos solicita la contraseña que usará la cuenta anterior. Deberá coincidir con la que escribimos en el apartado ''Instalar OpenLDAP en el servidor.''

=='''Configurar el demonio SLAPD'''==

'''SLAPD''' (Standalone LDAP Daemon) es un programa multiplataforma, que se ejecuta en segundo plano, atendiendo las solicitudes de autenticación LDAP que se reciban en el servidor.

# sudo dpkg-reconfigure slapd

Elegimos la opción ''No'' y pulsamos la tecla ''Intro''.

A continuación, deberemos escribir el nombre DNS que utilizamos para crear el DN base ''(Distinguished Name)'' del directorio LDAP.

Después, escribiremos el nombre de la entidad en la que estamos instalando el directorio ''LDAP''.

En el siguiente paso, deberemos escribir la contraseña de'' administración del directorio.''

A continuación, elegiremos el motor de la base de datos que usaremos para el directorio. Se recomienda ''HDB'' porque nos permitirá, en el futuro, cambiar los nombres de los subárboles si fuese necesario.

Lo siguiente que nos pregunta el asistente es si queremos que se borre la base de datos anterior del directorio cuando terminemos la configuración de slapd. Usamos la tecla ''<tabulador>'' para elegir ''No'' y pulsamos ''Intro.''

A continuación, como hemos decidido no borrar la base de datos antigua, el asistente nos pregunta si queremos cambiarla de sitio. Elegiremos la opción ''Sí'' y pulsaremos ''Intro.''

En algunas redes, con clientes muy antiguos, puede ser necesario mantener ''la versión 2 del protocolo LDAP.'' Por ese motivo, antes de terminar, el asistente nos pregunta queremos permitir el protocolo LDAPv2. Elegimos que ''No.''

Con esto habremos terminado la configuración del servidor LDAP. Ahora está listo para ''autenticar usuarios.''

A continuación vamos a instalar '''phpmyadmin''', para la configuración gráfica del LDAP. Para ello escribimos:

# apt-get install phpldapadmin

Acceder a phpLDAPadmin es tan sencillo como abrir cualquier navegador web en el servidor y, en la barra de direcciones, escribir la siguiente URL:

http://IP/phpldapadmin/

El esquemático de pruebas es el que se muestra a continuación:

[[Archivo:Esquematico_pruebas.png |center]]

=='''Funcionamiento del Spark'''==

'''Spark''' es un cliente gratuito de mensajería instantánea para Jabber el cual cuenta con una sencilla interface de usuario
orientada a negocios y a corporaciones, estando actualmente disponibles para Windows, Mac y Linux.
Entre sus características se encuentran ''grupos de chat, integración con Asterisk-IM, transferencias de archivos, corrección automática y conversaciones mediante pestañas.''

Una vez que hayas instalado la aplicación de Spark, deberás configurar el cliente para que se conecte con el ''servidor Openfire'' (Jabber o XMPP).

Para configurar tu cuenta de Chat:

:# Abre la aplicación de Spark
:# Como tenemos nuestro servidor Openfire conectado a un LDAP, introducir el usuario y contraseña creado en el LDAP y dirección del servidor Openfire.

Y con ello ya estaría creada la cuenta de chat.

[[Archivo:Creada_cuenta_chat.png |center]]

Con esta configuración, si agregamos un contacto, podremos chatear con el, ver la presencia de cada contacto, compartir documentos, realizar llamadas a través de nuestro asterisk...

Al realizar llamadas desde la aplicación, primeramente nos llamara a nuestro número y una vez cogido, llamará al contacto que queríamos llamar.

=='''Funcionamiento del Jitsi'''==
'''Jitsi (antes SIP Communicator)''' es una aplicación de videoconferencia, VoIP, y mensajería instantánea para Windows, Linux y Mac
OS X.
Es compatible con varios protocolos populares de mensajería instantánea y de telefonía como por ejemplo Bonjour, . NET Messenger
Service, OSCAR, SIP, XMPP...
Para crear una cuenta XMPP iremos a '''Archivo > Agregar una nueva cuenta'''

Y seleccionaremos '''XMPP'''

[[Archivo:Seleccionamos_xmpp.png |center]]

Como nuestro servidor Openfire lo tenemos conectado al LDAP ingresaremos el usuario y contraseña que hemos creado dentro del LDAP.

[[Archivo:Ingresar_usuariocontraseña.png |center]]

Con solamente esta configuración, podemos chatear con los contactos, llamarles, ver la disponibilidad de cada contacto, hacer vídeo conferencias y compartir nuestro escritorio, pero tanto la voz como el vídeo no pasa por el asterisk, por lo que esta configuración no nos vale.

Hay una especificación llamada ''CUSAX'' (Combined Use of SIP And XMPP) que jitsi soporta y en la que nos apoyaremos. Esta especificación establece la combinación de una cuenta SIP y XMPP para realizar los diferentes servicios de comunicación. Por lo que el video y el audio irá por SIP, es
decir por nuestro ''asterisk'' y la mensajería y presencia por ''XMPP.''

Para configurarlo, primeramente tendremos que deshabilitar el audio y vídeo por XMPP. Esto se encuentra en opciones de la cuenta ''XMPP > >Telefonía''

[[Archivo:Deshabilitar_audioyvideo.png |center]]

Sin realizar ninguna configuración vemos que solo podremos establecer un chat con los diferentes contactos. Para poder realizar llamadas, vídeo llamadas y compartir el escritorio es necesario crearnos una cuenta SIP.

[[Archivo:Crear_cuenta_sip.png‎ |center]]

Al tener ahora una combinación de cuenta SIP y XMPP podremos realizar las diferentes acciones sobre un contacto. Sin embargo ahora vemos que la mensajería la trata de enviar también por SIP y no funciona, queremos que los mensajes se envíen por XMPP. Para solucionarlo hay que añadir la siguiente propiedad:

net.java.sip.communicator.impl.protocol.sip.MESSAGING_DISABLED=true

Vamos a ''Opciones > Avanzado > Editor de propiedades''

[[Archivo:Mensajes_xmpp.png |center]]

Otra limitación que hemos visto al configurar CUSAX es que a la hora de compartir el escritorio no funciona el que otro tome el control sobre este.

Para tener los contactos que hay en el LDAP y así evitar el crearlos uno a uno realizaremos lo siguiente.

Vamos a ''Opciones > Avanzado > Fuentes de contacto'' 
y seleccionamos LDAP, añadimos uno nuevo y rellenamos los datos.

[[Archivo:Fuentes de contacto.png |center]]

Una vez que hemos configurado que el jitsi se conecte al LDAP, buscaremos el contacto bien por el nombre o por el número.

[[Archivo:Buscar_contacto.png |center]]

=='''Funcionamiento del Microsoft Outlook'''==

El servidor de correos microsoft outlook permite la integración con un servidor XMPP. Se realiza automáticamente por lo que no hay que hacer ningún tipo de configuración, solamente poner en el LDAP, en la cuenta deseada, la dirección de correo del contacto.

Desde la propia bandeja de correo veo el estado del contacto, iniciar un chat o llamarle.

=='''Referencias'''==

http://www.igniterealtime.org/projects/openfire/ 
http://www.igniterealtime.org/builds/openfire/docs/latest/documentation/index.html 
https://www.voztovoice.org/?q=node/120 
http://www.razametal.org/asterisk/library/how-to/openfire+asterisk.pdf

Howto's

2017-10-31T10:53:53Z

Imatarrubias: /* Simple_bridge y native_rtp */

{| class="wikitable"
|-
! '''Producto: '''!! VIVAit Call
VIVAit Suite

VIVAit Fax
|-
|}

== Como parar asterisk ==
En situaciones límite en el que es necesario parar el asterisk y volver a arrancarlo hay que realizar los siguientes pasos:

Entrar en la consola de asterisk e introducir el comando core stop now

Si esto no funciona, tendremos que matar el proceso a mano. Esto es, primero el safe asterisk y luego el asterisk mediante el comando
kill -9 nºPID

Tras estos pasos, volveremos a arrancar el servicio asterisk mediante /etc/init.d/asterisk start

== Como configurar la megafonía ==

El servicio de megafonía se basa en el protocolo multicast.

Para configurar la megafonía tenemos que activar en los teléfonos que para que estén "escuchando" en una dirección multicast y tener un emisor en esa dirección multicast.

Los teléfonos suelen tener en su configuración un apartado para configurar el multicast. Por ejemplo en los yealink está en la pestaña directory sección multicast IP.

En los teléfonos se puede configurar manualmente o incluirlo en las plantillas de aprovisionamiento.

El asterisk tiene un canal para hacer multicast. Este canal es MulticastRTP.

Para esto podemos crear un VDN que contenga la siguiente línea. (en el ejemplo la dirección multicast es 239.0.126.1 y el puerto es el 10001).

[Cen_VDN_90000]
exten => _X.,1,NoOp(MDVDN_90000*****EXTEN=${EXTEN}**CID=${CALLERID(NUM)}**UCID=${UCID}*)
same => n,Answer
same => n,Dial(MulticastRTP/basic/239.0.126.1:10001)
include => Cen_finLlamada

== Como configurar el candado ==
El candado permite prohibir temporalmente la posibilidad de realizar llamadas hacia fuera. Sí se pueden seguir haciendo llamadas a extensiones fijas de la plataforma, es decir, llamadas sin coste.

Para configurar dicha funcionalidad basta con crear extensiones con la categoría mas restrictiva posible y habilitar la movilidad, con lo que la extensión solo tendrá "permisos" para realizar llamadas internas.

Para permitir llamadas externas solo hay que "mover" a un usuario con categoría suficiente a la extensión deseada.
== Como crear un grupo de captura y que se vea en cada teléfono el número que llama ==

'''ATENCIÓN: SE CREAN CONFIGURACIONES NO REFLEJADAS EN PORTAL DE ADMINISTRACIÓN'''

Para la simulación de grupos de captura y conseguir que todos los terminales vean el ANI del llamante:

- Hacen falta teléfonos con dos líneas

- Cada teléfono del grupo tiene en la línea 1 su extensión habitual (por ejemplo 40000)

- Además, en el fichero "sip_Estatico.conf", creamos una segunda extensión para cada teléfono, que le ocupará la segunda línea (por ejemplo 42000)

- En esta segunda linea ponemos que cuando se llame tenga otro tono de llamada (un beep o nada...) que se asemeje en funcionamiento al de un mensaje de llamada en otra extension de mi grupo de captura

- Se ha creado una variable global por cada teléfono en el fichero de variables "ext_MDtel_Particular.conf" de nombre EXTxxxxx (por ejemplo EXT40000); esa variable contiene las otras extensiones virtuales del grupo
por ejemplo EXT40000=>SIP/42001&SIP/42005

- Hemos creado en el dialplan programación para que cuando exista esa variable global se añada a la marcación el contenido

== Como crear supletorios ==

'''ATENCIÓN: SE CREAN CONFIGURACIONES NO REFLEJADAS EN PORTAL DE ADMINISTRACIÓN'''

Igual que el caso anterior pero en la variable ponemos números reales. Debido a un bug en el enrutador, que no devuelve la variable R_PARA, en el fichero ext_MARCAR_Extension.conf hay que sustituir la siguiente linea:

;same => n,ExecIf($["${EXT${R_PARA}}"=""]?NoOp:Set(ENR_CADMARCAR=${ENR_CADMARCAR}&${EXT${R_PARA}}))
Por esta otra:
same => n,ExecIf($["${EXT${R_DEST_${ENR_RUTA_CAD}}}"=""]?NoOp:Set(ENR_CADMARCAR=${ENR_CADMARCAR}&${EXT${R_DEST_${ENR_RUTA_CAD}}}))
ATENCIÓN !!! en las llamadas salientes cada uno presenta su número

Para emplear números externos en los supletorios hay que poner, al crear la variable que hemos explicado en el apartado anterior en el ext_MDtel_Particular.conf:

EXT335=>SIP/0999999999@Trunk_Movil ;En este caso suena en la ext 335 y en el móvil 999999999

== Generación de llamada automática ==

Para activar la funcionalidad es necesario lo siguiente:

* Definir una variable ID_LISTA_LLAMAME con el ID de la lista que se va a usar para generar la llamada. Cuando se cree la lista hay que asegurarse que el campo "Nº segundos límite" tiene un valor lo suficientemente amplio para evitar que la llamada caduque antes de ejecutarse.

* Establecer un timeout para la cola (en el Gosub Cen_Sub_GrupoACD se indica justo después de ${COLA})

* Llamar a la función de MySQL ACD_FUNC_LLAMAME_CREAR a través de MDintz

* En la función se usan los siguientes elementos variables:

${ID_LISTA_LLAMAME}: Definida antes clienteTOCola:
Nombre del cliente. Al no tener ningún nombre, se usa un denominador genérico
${CALLERID}: Número llamante, donde se dirigirá la llamada.

Ejemplo:

[Cen_VDN_99001]
;----------------------------------------------------------------------------------------------------------------
;----------------------- VDN 99001 ------------------------------------------------------------
;----------------------------------------------------------------------------------------------------------------
exten => _X.,1,NoOp(MDENTGW_99001*****EXTEN=${EXTEN}**CID=${CALLERID(NUM)}**UCID=${UCID}*)
same => n,Set(__COLA=89001)
same => n,Set(ctiDiriTrato=0)
same => n,Set(ctiDiriInterface=)
same => n,Set(ID_LISTA_LLAMAME=2)
same => n(cola),Gosub(Cen_Sub_GrupoACD,${EXTEN},1(${COLA},10,,Si,))
same => n,GotoIf($["${QUEUESTATUS}"!="TIMEOUT"]?colgar)
same => n,MDintz(nimitz|bd|sqlDato|select ACD_FUNC_LLAMAME_CREAR(CURRENT_TIMESTAMP\,${ID_LISTA_LLAMAME}\,""\,"clienteTOCola"\,""\,""\,""\,""\,""\,""\,""\,""\,1\,""\,"${CALLERID(NUM)}"\,1\,3\,1\,""\,0\,0\,0\,""\,""\,""\,""))
same => n,GotoIf($["${MDintzRes}"="OK"]?colgar)
same => n,NoOp(ACD_FUNC_LLAMAME_CREAR ${MDintzRes})
same => n(colgar),Hangup

== Cancelación de eco en la plataforma ==

Comprobar que el chan_dahdi.conf este configurado los parametros:
echocancel=yes
echocancelwhenbridged=yes
Jugar con los valores txgain y rxgain

Si esto no es suficiente el siguiente paso sería emplear una canceladora de echo por hardware.

== Como "dar paso" a través de un enlace exterior si hay una llamada para una extensión creada en el sistema pero no registrada ==

Este procedimiento es de utilidad en procesos de migración, en los que recibimos las llamadas de la RTC, nos las quedamos si la extensión ya está registrada en VIVAit y la mandamos hacia la plataforma a migrar si aún sigue migrada ahí

El procedimiento es:
* Activar desvío por no contesta en la extensión (portal de administración - VIVAit Call - Dispositivos - Extensiones - campo "Desvio no contesta", indicando como destino un prefijo (por ejemplo "99") seguido de la extensión destino

* Creamos una preruta en vivait-call - rutas -prerutas con origen "99", le quitamos el prefijo en campo "Destino saliente 1" (valor -2) e indicamos en campo "Tipo destino sal. 1" como "Ruta externa"

* Debera existir una ruta externa para esa numeración

== Comprobación de versiones de elementos de la plataforma ==

'''Aplicaciones'''
:* Botón derecho del ratón, Acerca De

'''Portales'''
:* En el Vivait-Call, en la pantalla de inicio de sesión pone el número de versión del portal.
:* Tanto en el Monitor como en el Tracker no se puede saber.

'''Demonios'''
:* Mediante el comando nc localhost <Puerto demonio>. Ejemplo:
::nc localhost 1120
::motorSal sis ver='03.02.00' inic='20150427 123457' alarmas=0 ultAlar='00000000000000'
::motorSal gmp msj=253/256 buf=256/256 tarea=99/102
::motorSal tmp uptime=12624 (0d 3h 30m 24s)
::motorSal mtr mys=1 ocup=0% planif=13(0) intento=11(0)

::Ejemplos puertos demonios:
:::*1111: vivait-cti
:::*1112: myAcdSuperv
:::*1113: recordNodo
:::*1114: recordCentral
:::*1115: intz-nimitz
:::*1120: motorSal
:::*1123: phoneprov-tftp

'''Base de datos'''
:* No se puede saber la versión a no ser que se comparen esquemáticos con los subidos en el redmine

[[Category:tecnico]]
[[Category:administrador]]
[[Category:VIVAit Call]]
[[Category:VIVAit Suite]]
[[Category:VIVAit Fax]]

== Añadir Auto-Answer a la cabecera SIP ==

Si queremos que un teléfono tenga autoanswer:
* En el peer poner: headeraa=Call-Info: answer-after=0, esto tiene que ir en la plantilla de la extensión o como campo en la extensión. Dependiendo del terminal que utilicemos el valor de este campo variará:

Aastra: Alert-Info: info=alert-autoanswer
Grandstream: Call-Info: answer-after=0
Linksys: Call-Info:\;Answer-After=0
Polycom: Alert-Info: Ring Answer
Snom: Call-Info: answer-after=0
Snom (nuevo firmware): Call-Info: <sip:IP>\;answer-after=0
Yealink: Call-Info: answer-after=0

* Luego en el diaplan añadir lo siguiente: exten => _[*#%0-9a-zA-Z].,n,set(__AutoAnswer=AA) (Esto tendremos que ver como ponerlo de manera automática). De manera provisional si queremos que sea para llamadas salientes pondremos esto en el ext_n_marcador.conf. Si queremos que sea llamadas entrantes lo pondremos en ext_n_MARCAR.conf

== Configuración de los portales web en HTTPS ==

Desde /usr/lib/jvm/default-java/bin/ ejecutamos:

keytool -genkey -alias tomcat -keyalg RSA -keystore /usr/share/tomcat7/.keystore

Escriba la contraseña del almacén de claves: (t0mc4t)
Volver a escribir la contraseña nueva: (t0mc4t)
*Personalizar para el cliente
¿Cuáles son su nombre y su apellido?
[Unknown]: VIVAit Suite
¿Cuál es el nombre de su unidad de organización?
[Unknown]: Desarrollo
¿Cuál es el nombre de su organización?
[Unknown]: MDtel
¿Cuál es el nombre de su ciudad o localidad?
[Unknown]: Madrid
¿Cuál es el nombre de su estado o provincia?
[Unknown]: Madrid
¿Cuál es el código de país de dos letras de la unidad?
[Unknown]: es
¿Es correcto CN=VIVAit Suite, OU=Desarrollo, O=MDtel, L=es, ST=Madrid,
C=Unknown?
[no]: si
Escriba la contraseña clave para <tomcat>
(INTRO si es la misma contraseña que la del almacén de claves)

nano /var/lib/tomcat7/conf/server.xml

Descomentar la línea:

<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"

maxThreads="150" scheme="https" secure="true"

clientAuth="false" sslProtocol="TLS"/>

Añadir después de sslProtocol="TLS":

keystorePass="t0mc4t"

== Crear un motivo desconexión para el Supervisor en '''''VIVA'''''it Suite==

Para crear motivos de desconexión adicionales a los que ya ofrece la aplicación tendremos que añadir una nueva entrada en la BD. El comando que emplearíamos seria el siguiente:

INSERT INTO `nimitz`.`COM_ENUMERADOS` (`ID`, `C_NOMBRE`, `C_TEXTO`, `N_POSICION`, `C_OBSERV`) VALUES(1000700, 'TSesAgMotDesc', 'Nombre Motivo de desconexión', 60, ' ');

El ID debe ser mayor o igual a 1000700 y menor a 1000800. El N_POSICION debe ser mayor o igual a 60 y menor que 100.

== Envío de variables CTI al ACD ante un GW con asterisk 13==
Dado que para un GW con asterisk 13 un nodo ACD es considerado un elemento externo, por defecto, no se envían variables CTI (UCID, ...). En una fututa versión del nodo ACD, ya no se considerará un elemento externo por lo que si se enviarán dichas variables. Para lograrlo en la versión 3.0 de la plataforma Vivait hay que modificar el fichero ext_MARCAR_Externo_Particular.conf del GW. Deberemos poner la siguiente linea.

same => n,Macro(escribirDatosCti)

== Script para cambio automático de claves en salas de conferencia estáticas ==

Para cambiar la clave de las salas de conferencias crear un script llamado cambioClaveConfe.sh con el siguiente contenido:

#!/bin/bash
CLAVE=$(shuf -i 1111-9999 -n 1)

echo $CLAVE

echo "update CEN_SALAS_CONFERENCIAS set C_PIN='$CLAVE' WHERE C_NOMBRE='$1'" | mysql -u nimitz -pivivanimitz nimitz

FROM=sat@mdtel.es
FECHA=`date +"%Y%m%d%H%M%S"`
CLIENTE=<PONER EL CLIENTE>
TO=<DESTINATARIOS>
ASUNTO="Nueva clave en sala $1"
CUERPO="La nueva clave para la sala $1 es: $CLAVE"
/usr/sbin/sendmail -oi -t -v -f $FROM <<EOF
From: $FROM
To: $TO
Bcc: $BCC
Subject: $ASUNTO

$CUERPO
EOF

El script cambiará la clave de la sala pasada por parámetro por una aleatoria de 4 dígitos y la enviará por correo a los <DESTINATARIOS> (direcciones de correo electrónico separadas por coma).

Hay que crear una tarea en /etc/crontab añadiendo una linea como la siguiente:
30 6 * * 7 root cambioClaveConfe.sh 6173

Esto ejecutará el script todos los domingos a las 6:30 horas cambiando la clave de la sala 6173. Añadir tantas linéas como salas.

==ZABBIX ==

=== Como crear un TRIGGER en Zabbix ===

'''1.''' Hay '''dos posibilidades''' dependiendo si el trigger es para un solo host o es para varios, los cuales tienen en común un template:

:# Si es para ''un host'': Ir a '''Configuración/Hosts'''
:# Si es para ''un template'': Ir a '''Configuración/Templates'''

'''2.''' En la fila correspondiente al host/template al que queramos añadirle el trigger, pulsar sobre la '''columna triggers.''' 
'''3.''' En la ventana de triggers, pulsar sobre el botón '''Create trigger''', situado en la esquina superior derecha. 
'''4.''' Aparecerá la ventana de creación de triggers, que tiene los siguientes campos:
:1. '''Name:''' Nombre del trigger, que deberá ser lo ''suficientemente descriptivo''. Aparecerá cuando se
active, en la ventana principal de Zabbix así como en los correos de aviso.
:2. '''Expression:''' Define la fórmula cuyo resultado activará el trigger. Hay que pulsar el botón '''Add'''. Se mostrará una
nueva ventana donde habrá que elegir el item (medida) sobre el que se basará el trigger (evidentemente la medida deberá
existir previamente) y la función necesaria para el cálculo. Para una descripción de las disponibles dirigirse a
https://www.zabbix.com/documentation/2.2/manual/appendix/triggers/functions. 
Tras rellenar los campos anteriores y dar a la función los valores que necesite pulsar el botón '''Insert.'''
:3. '''Expression constructor:''' Permite crear expresiones complejas, uniendo varias.
:4. '''Description:''' Una explicación del trigger
:5. '''Severity:''' Criticidad el trigger
:6. Para una descripción del resto de campos visitar la página: https://www.zabbix.com/documentation/2.2/manual/config/triggers/trigger
'''5.''' Tras rellenar los campos, pulsar el botón '''Save'''. 
'''6.''' Si el trigger se ha añadido en un template, aparecerá en todos los hosts que tienen el template configurado. 
'''7.''' '''El trigger por si solo no envía ningún aviso''', solo se activa si se cumple la expresión definida.
Para enviar un aviso (normalmente un correo electrónico) cuando se active el trigger, será necesario definir una acción (Configuración/Actions).

'''NOTA.-''' Para consultar cualquier cuestión relativa a Zabbix, se encuentra a su disposición el manual: 
https://www.zabbix.com/documentation/2.2/manual

=== Monitorización en Zabbix de un trunk caído ===
Para monitorizar un o varios trunk por separado y saber el estado de cada uno es necesario lo siguiente:

*Añadir el UserParameter adjunto que contiene el siguiente texto:

UserParameter=asterisk.trunkEstado[*],sudo /usr/sbin/asterisk -rx 'sip show peers' | grep --text -i '$1' | grep OK >/dev/null; if [ $? -eq 0 ]; then echo 1; else echo 0; fi

*Añadir en el portal de zabbix un item por cada trunk. En el campo Key se pondrá "asterisk.trunkEstado[nombre_trunk]", donde nombre_trunk es el nombre del trunk tal y como se ve en Asterisk.
[[File:zabbix_item_trunkEstado.png]]

*Crear un trigger que avise cuando el último valor sea 0. Por ejemplo:
{corp-bdtr:asterisk.trunkEstado[PrePro-ACD].last()}=0

[[File:zabbix_trigger_trunkEstado.png]]

== Agendas en terminales Yealink ==
En la agenda se mostrará como nombre lo que contenga el campo CEN_AGENDAS.C_NOMBRE_MOSTRAR y como teléfono el indicado en CEN_AGENDAS_TELEFONOS.C_TELEFONO
Para hacer funcionar la agenda:

*En el archivo de aprovisionamiento correspondiente (Yealink-XXXX-comun.cfg) establecer los siguientes parámetros:

remote_phonebook.data.1.url = http://<direc IP>/vivait-agenda/yealink/contactData1.xml
remote_phonebook.data.1.name = NOMBRE DE LA AGENDA EN EL TELEFONO

*En el archivo /etc/apache2/apache2.conf añadir tras el último Directory:

<Directory /var/www/html/vivait-agenda/>
AddType application/x-httpd-php .xml
Options Indexes FollowSymLinks MultiViews
AllowOverride None
Order allow,deny
allow from all
</Directory>

*Ejecutar el comando:

/etc/init.d/apache2 reload

== Calendarios ==

=== Enrutamiento inteligente ===

Ante una llamada a un destino, si hay cita de ocupado en el calendario se desvia al número indicado en el campo "location" del calendario o a su buzon de voz si hay valor en dicho campo

same => n,Set(CalendarBusy=${CALENDAR_BUSY(GoogleCalendar)})
same => n,Set(id=${CALENDAR_QUERY(GoogleCalendar)})
same => n,NoOP(hay ${CALENDAR_QUERY_RESULT(${id},getnum)} eventos)
same => n,Verbose(3,The state of GoogleCalendar is $
{DEVICE_STATE(Calendar:GoogleCalendar)})
same => n,Set(CalendarLocation=${CALENDAR_QUERY_RESULT(GoogleCalendar,location)})
same => n,GotoIf($["${CalendarBusy}"=="1"]?:conCategoria)
same => n,GotoIf($["${CalendarLocation}"==""]?buzon)
same => n,Goto(Cen_iniLlam,${CalendarLocation},1)
same => n(buzon),Playback(Particular/buzon)
same => n,Hangup
same=> n(conCategoria),Goto(Cen_iniLlam,${EXTEN},1)

=== Conexión de cliente Outlook a calendarios VIVAit mediante Caldav===
Por defecto, el cliente outlook no soporta Caldav; si queremos disponer de calendarios de VIVAit en Outlook tendríamos dos opciones:
# Tener los calendarios en el servidor Exchange
# Instalar un plugin en el cliente outlook que permita conectar vía Caldav los calendarios que estén ubicados en el servidor de calendarios de VIVAit

Este howto se centra en esta segunda posibilidad

Procedimiento:

1.- Instalar Calldavsincronizer (valdrían otros plugin de Caldav para Outlook)

[https://sourceforge.net/projects/outlookcaldavsynchronizer/ https://sourceforge.net/projects/outlookcaldavsynchronizer/]

2.- Entrar en Synchronization Profiles en la nueva pestaña Calldav Syncronizer de outlook [[File:Syncronizer.png]]

3.- Añadir nuevo perfil (tecla +)

[[File:Nuevo.png|center|600px]]

A tener en cuenta:

*Crear un nuevo “Outlook folder”, entendemos que es adecuado (quizás necesario) para que las entradas de calendario de VIVAit queden diferenciadas.
*Lo mejor es haber creado antes el calendario en el servidor para que al darlo de alta en oulook comprobemos que se conecta.
*Dando al botón “Test or discover settings” se nos muestran todos los calendarios del servidor y elegimos el que queramos; en “elementos de la carpeta” diremos “elementos de calendario”.

[[File:Calendario.png|center|800px]]

== Uso de reloj hardware en nodos de procesamiento ==

=== En nodo de procesamiento ACD ===
En un nodo de procesamiento ACD es obligatorio instalar dahdi y una tarjeta de primario para emplear reloj hardware, ya que el reloj software que va en el asterisk 1.4 es defectuoso.
Para configurarlo basta con instalar la tarjeta en el servidor, instalar dahdi y posteriormente ejecutar el siguiente comando:

dahdi_cfg

Este comando generaŕa el fichero /etc/dahdi/system.conf

Para comprobar que el comando se ha ejecutado satisfactoriamente lo abriremos y tendrá que tener un formato semejante al siguiente ejemplo:

# Autogenerated by /usr/sbin/dahdi_genconf on Tue Oct 22 17:42:59 2013
# If you edit this file and execute /usr/sbin/dahdi_genconf again,
# your manual changes will be LOST.
# Dahdi Configuration File
#
# This file is parsed by the Dahdi Configurator, dahdi_cfg
#
# Span 1: WCT1/0 "Digium Wildcard TE110P T1/E1 Card 0" HDB3/CCS/CRC4
span=1,1,0,ccs,hdb3,crc4
# termtype: te
bchan=1-15,17-31
dchan=16
echocanceller=oslec,1-15,17-31
# Global data
loadzone = es
defaultzone = es

=== En nodo de procesamiento de corporativa ===
En un nodo de procesamiento de corporativa no obligatorio instalar dahdi y una tarjeta de primario para emplear reloj hardware, ya que el no se han detectado errores en el reloj por software. Sin embargo si instalamos dahdi y una tarjeta de primario para emplear reloj hardware, el sistema funcionará mejor.
Para configurarlo basta con instalar la tarjeta en el servidor, instalar dahdi y posteriormente ejecutar el siguiente comando:

dahdi_cfg

Este comando generaŕa el fichero /etc/dahdi/system.conf

Para comprobar que el comando se ha ejecutado satisfactoriamente lo abriremos y tendrá que tener un formato semejante al siguiente ejemplo:

# Autogenerated by /usr/sbin/dahdi_genconf on Tue Oct 22 17:42:59 2013
# If you edit this file and execute /usr/sbin/dahdi_genconf again,
# your manual changes will be LOST.
# Dahdi Configuration File
#
# This file is parsed by the Dahdi Configurator, dahdi_cfg
#
# Span 1: WCT1/0 "Digium Wildcard TE110P T1/E1 Card 0" HDB3/CCS/CRC4
span=1,1,0,ccs,hdb3,crc4
# termtype: te
bchan=1-15,17-31
dchan=16
echocanceller=oslec,1-15,17-31
# Global data
loadzone = es
defaultzone = es

== Aprovisionamiento terminales Cisco ==
=== Configurar protocolo SIP TCP o UDP en terminal Cisco ===

Configuración de terminal Cisco para para funcionar bajo TCP o UDP:
Modificar parámetro
<transportLayerProtocol>X</transportLayerProtocol>

Donde X es:
1: TCP
2: UDP
4: Valor por defecto del firmware (al menos en la última versión equivale a TCP)

=== Habilitar/Deshabilitar llamada en espera en terminales Cisco ===

En el fichero de aprovisionamiento del terminal añadiremos la siguiente linea
<callWaiting>X</callWaiting>

Donde X es:
0=off but can be changed through the settings menu.
1=on but can be changed through the settings menu.
2=off and locked so it can't be changed through the settings menu.
3=on and locked so it can't be changed through the settings menu.

== Como configurar servicio DHCP en Ubuntu Linux ==
'''¿Que es un servicio DHCP?'''

Un servidor Dynamic Host Configuration Protocol (DHCP) asigna dinámicamente las direcciones IP y otras configuraciones de red a otros terminales que están conectados a la red.

'''Instalar un servicio DHCP'''

Para instalar el servidor de asignacion automatica de direccion IP ejecutamos el comando:
sudo apt-get install isc-dhcp-server

'''Configurando el servicio DHCP'''

Editamos el archivo /etc/dhcp/dhcpd.conf creando primero un backup del mismo:
mv /etc/dhcp/dhcpd.conf /etc/dhcp/dhcpd.conf.original
nano /etc/dhcp/dhcpd.conf

El archivo debe quedar de una forma muy similar a esta:
authoritative
subnet 10.254.239.0 netmask 255.255.255.254
{
range dynamic-bootp 10.254.239.40 10.254.239.60;
option domain-name-servers ns1.example.org, ns2.example.org;
option domain-name "example.org";
option routers rtr-239-0-1.example.org, rtr-239-0-2.example.org ;
option broadcast-address 10.254.239.255;
default-lease-time 3600;
max-lease-time 7200;
option option-150 10.254.239.25
}

Donde los campos:
*subnet: Direccion de red
*netmask: Máscara de red
*range dynamic-bootp: Rango de IPs que va a proporcionar el DHCP
*option domain-name-servers: Direcciones IPs de los DNS
*option domain-name: Nombre de dominio
*option routers:IPs de las puertas de enlace
*option broadcast-address: Dirección de broadcast
*default-lease-time: Tiempo de concesión por defecto
*max-lease-time: Valor máximo del tiempo de concesión
*option option-150: IPs de los servidores TFTPs que tiene la red

'''Reiniciamos el servicio'''

service isc-dhcp-server restart

'''Direcciones IP estáticas basadas en la MAC'''

Pueden conocerse las MAC de las máquinas conectadas a la red ejecutando el comando arp desde la terminal.

host ejemplo {
hardware ethernet 00:0B:82:19:A8:04;
option option-150 10.254.239.0;
# fixed-address 10.254.239.52;
}

== Protocolo Skinny en VIVAit Call mediante uso de Chan-SCCP ==
'''Instalación de chan_sccp'''

*Copiar el fichero chan-sccp-4.2.1.1.tar.gz en el directorio donde estén los fuentes de Asterisk (normalmente /usr/src/MDtel)
*Descomprimir
*Entrar al directorio chan-sccp-4.2.1.1
*Ejecutar: ./configure --with-asterisk=../DIRECTORIO_ASTERISK --enable-conference. Donde DIRECTORIO_ASTERISK es el nombre del directorio donde están los fuentes de asterisk.
*Tras el ejecutar el configure (si todo va bien al final se verá un resumen con el S.O, arquitectura, etc), ejecutar make y make install
*El nuevo módulo chan_sccp.so se generará dentro del DIRECTORIO_ASTERISK en lib/asterisk/modules/ y se deberá copiar en /usr/lib/asterisk/modules/
*Copiar el fichero sccp.conf a /etc/asterisk
*Entra a Asterisk y ejecutar: module load chan_sccp.so
*Si se ha cargado correctamente, desde dentro de Asterisk, si se teclea sccp show version deberá devolver: "Skinny Client Control Protocol (SCCP). Release: 4.3.0 4.3.0 - unknown (built by 'root' on '2016-06-01 10:42:32 UTC')"

'''Crear extensiones'''

*En el portal crear una nueva clase de dispositivo (Vivait-Call/Dispositivos/Clases de dispositivos), donde la clase sea extensión la subclase H323 (todavía no existe la subclase SCCP) y el formato SCCP/${DEST}
*Crear la nueva extensión, pero el dispositivo debe ser el creado en el campo anterior.
*Las extensiones creadas habrá que añadirlas al fichero sccp.conf así como los teléfonos que las usarán. En el fichero sccp.conf incluido hay ejemplos.

'''Aprovisionamiento'''
Los terminales se aprovisionan de la misma manera que los SIP, exceptuando que las plantillas XML no tiene referencias a SIP. Se incluye un xml genérico con todas las opciones.
Dentro del directorio chan-sccp-4.2.1.1 hay un directorio conf con todos los archivos de configuración necesarios. Las versiones annotated contienen todas las opciones posibles comentadas.

== Instalación y configuración Postfix en RedHat7 ==

'''Postfix''' es un ''servidor de correo'' de software libre/código abierto, un programa informático para el enrutamiento y envío de correo electrónico.

'''Instalación'''

yum install postfix

'''Configuración'''

Sobre la configuración de postfix por defecto (recién instalado):
Editar el fichero /etc/postfix/main.cf
inet_protocols = ipv4
relayhost = smtp.renfe.es
Revisar la configuración:
postfix check
Configurar postfix como servicio (sólo en redhat y similares)
chkconfig postfix on
Iniciar postfix:
service postfix start
Instalar mailx para disponer de los comandos mail y sendmail:
yum install mailx
Probar configuración:
echo "Prueba de correo" | mail -vs "Prueba" correo@destino.soy

== FOP2 ==

=== Como mostrar callername queues FOP2 ===

Es necesario añadir el siguiente código al contexto de entrada:

exten => _X.,n,MYSQL(Connect connid localhost usuario clave bd)
exten => _X.,n,MYSQL(Query resultid ${connid} SELECT\ firstname\,lastname\ from\ fop2\ where\ phone1=${CALLERID(num)}\ OR\ phone2=${CALLERID(num)})
exten => _X.,n,MYSQL(Fetch fetchid ${resultid} nombre apellidos)
exten => _X.,n,GotoIf($[${fetchid} = 1]?:noExiste)
exten => _X.,n,Set(CALLERID(name)=${nombre}${apellidos})
exten => _X.,n(noExiste),Continuar

En la primera línea cambiar según lo necesario:

*localhost: Dirección IP del servidor de MySQL donde está la BBDD de FOP2
*usuario: Usuario con permisos de acceso a la bbdd de FOP2
*clave: Clave del usuario
*bd: Nombre de la BBDD

=== FOP2. Problemas en transferencias asistidas ===

Para habilitar la transferencia atendida del asterisk (funcion atxfer), hay que poner la opción tT en el queue() si la llamada origen
la realiza a una cola o al dial() de las extensiones.
Con eso vemos como al intentar hacer la llamada de consulta ya se va a nuestro dialplan. Sin embargo la llamada no funciona ya que
el enrutador nos da error de enrutamiento porque no tenemos ID_DISPOSITIVO origen ya que el fop no es un elemento creado desde el portal.
Por lo que se propone como solución crear un contexto de inicio del fop y asignarle un ID_DISPOSITIVO para que así se enrute la llamada.
El contexto tienen que ser similar a ext_InicioLlamada_Chrome.conf

Para que funcione las transferencias supervisadas desde el fop2 hay que realizar lo siguiente:

*El usuario del manager debe tener permisos Atxfer para poder realizar transferencias.
*Habilitar la transferencia atxfer en el fuatures.conf del asterisk. atxfer => *2
*Crear el fichero ext_InicioLlamada_FOP.conf con el siguiente contenido:

[Cen_Inicio_FOP]
exten => [*#%0-9].,1,NoOp(MDINICHR**EXTEN=${EXTEN}**CID=${CHROME_ANI}*)
same => n,dumpchan()
;same => n,Set(CALLERID=${CHROME_ANI})
same => n,Gosub(Cen_Sub_getIdExtension,s,1(${R_CID_NUM_00}))
same => n,ExecIf($["${GOSUB_RETVAL}"!="OK" | "${sqlDato}"=""]?HangUp)
same => n,Set(ID_DISPOSITIVO=${sqlDato})
; . Modificar MARCAR en funcion de reglas de marcacion saliente (prefijo 0, ...)
; Esto se modificara en el contexto Cen_Inicio_Chrome_Particular
same => n,Set(MARCAR=${EXTEN})
;---------------------------------

;--- Llamada a contexto particular
;---------------------------------
; Esta llamada es para hacer cosas especificas del cliente (cambiar callerid...)
; La subrutina Cen_Inicio_Chrome_Particular esta en el archivo ext_InicioLlamada_Chrome_Particular.conf
; Si no existe el archivo copiar el archivo ext_InicioLlamada_Chrome_Particular.conf.ejemplo como ext_Inicio_Chrome_Particular.conf
; y realizar las modificaciones necesarias
; El fichero ext_InicioLlamada_Chrome_Particular.conf se carga automaticamente al ser creado con el include de ext_InicioLlamada.conf
; #include "ext_InicioLlamada*.conf"
;
same => n,GosubIf($[${DIALPLAN_EXISTS(Cen_Inicio_FOP_Particular,${EXTEN},1)}>0]?Cen_Inicio_FOP_Particular,${EXTEN},1)
same => n,Goto(Cen_Inicio_SIP,${MARCAR},1)

*En el fichero /usr/local/fop2/buttons.cfg poner como contexto de las extensiones el creado anteriormente (Cen_Inicio_FOP)
*Modificar el fichero /usr/local/fop2/fop2.cfg:

blind_transfer = 0
supervised_transfer = 1

Para realizar la transferencia con consulta, hay que pulsar el supervised transfer del FOP2 y una vez se haya establecido la llamada, seleccionar la extensión que "sobra" en la conversación y pulsar la tecla de hangup y colgar la llamada.

== Como ver los directorios de un NAS a montar con NFS ==

Con el siguiente comando vemos los diferentes volúmenes de un NAS:

showmount -e IP_NAS

Ejemplo de salida:

Export list for 192.168.10.10:
/Backup/backup *
/DISCOS_1/VOL1_AUDIO *

== Instalación de ActivaSTP con VIVAit Call 3 y marcación desde Outlook ==

Instalamos ActivaSTP desde:

(http://activa.sourceforge.net/)



La configuración necesaria se muestra en la siguiente imagen:

[[File:Ventana ActivaTSP.jpg]]

El usuario del manager debe tener permisos originate para poder realizar llamadas.

Se han realizado pruebas con Outlook 2013.

Se ha comprobado la correcta realización de pruebas utilizando ActivaSTP, realizadon llamadas desde la pestaña "personas" con la vista en modo tarjeta de Pesentación, tarjeta, teléfono o lista.

Outlook 2013 no da la opción de llamar si la vista está en modo personas.

== Como volver a procesar grabaciones con error ==

Las grabaciones con error son aquellas que tienen el valor E_GRABACION=120 en la tabla DAT_GRABACIONES.

Las grabaciones con error se producen normalmente por la pérdida de conexión entre el nodo servidor de grabaciones y el resto.

Para reprocesar la grabación hay que modificar el campo E_GRABACION de la tabla DAT_GRABACIONES y ponerlo con valor 20 para que así el recordCentral la vuelva a procesar.



== Como borrar contenido de la tabla BDTR con el script borraRegistrosNimitz.pl ==

Este script se ejecuta mediante una tarea del crontab, tal como la siguiente:

SHELL=/bin/sh
PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
# m h dom mon dow user command
00 01 * * * root /usr/local/sbin/borraRegistrosNimitz.pl --hDB localhost

Para establecer el número de días que vamos a dejar en la base de datos debemos editar el archivo borraRegistrosNimitz.pl, el campo my $numDias.

== Ocasionalmente No saltan los formularios en '''VIVAit Suite''' cuando existen marcadores ==
En los sistemas con marcadores, se ha observado que, en un porcentaje muy bajo, cuando entra una llamada a un agente no se presenta el formulario.
En una traza del vivait-desk se pudo comprobar que no había eventos CTI de la llamada, pero telefónicamente la llamada si quedaba establecida.

El problema viene ocasionado porque el CTI tiene auditorías para descartar llamadas,evitando que se queden enganchadas.

Una de esas auditorías es el tiempo máximo de las llamadas no contestadas.

El marcador tiene puesto a fuego que el tiempo que permanece una llamada en cola a la espera de un agente libre es de 10 minutos.

Hay que poner el tiempo de auditoría en un valor superior (por ejemplo 12 minutos)

En el archivo de configuración '''vivait-cti.conf'''

audit_call_minutNoContestada = 12

El paŕametro audit_call_minutContestada, es el tiempo que el cti "conserva" una llamada, dado que el dialplan tiene puesto el timeout absolute a 7200 (120 minutos), deberiamos modificar este parámetro para que esté sincronizado

audit_call_minutContestada = 120

Estos cambios se implementarán en el instalador de la próxima versión.

== Generación de un Core ==
Un Core es la memoria de un programa.

Para generar un Core rápido con Asterisk hay que hacer lo siguiente:

Ejecutar ps aux | grep asterisk y coger el PID del programa
gdb /usr/sbin/asterisk [PID]
gcore [file]

== Activación de la movilidad para un usuario ==

Una vez configurada la movilidad e intentar activarla nos da error cuando le ponemos el usuario y la contraseña.

La configuración del usuario es la siguiente:

[[File:Problema.jpg|center]]

Para que la movilidad funcione hay que asignar un teléfono a la extensión, quedando la configuración de esta manera:

[[File:Asignacion_de_telefono.jpg|center]]

== Como se muestra el número llamante en transferencia desde operadora ==
Para tener el número ANI en las transferencias con consulta hay que realizar lo siguiente:
Copiar el archivo adjunto (app_esConsulta.c) en el directorio apps de Asterisk (normalmente /usr/src/vivait-call/asterisk/apps).
Situarse en el directorio raiz de Asterisk (normalmente /usr/src/vivait-call/asterisk/).
Compilar: make
Instalar: make install
Habilitar el nuevo módulo: asterisk -rx 'module load app_esConsulta.so'
Si la carga del módulo no funcionara, hay que el reiniciar Asterisk para que cargue el módulo.

Posteriormente modificar el fichero ext_Enrutador_Particular.conf de la siguiente forma:

[Cen_Enrutador_Particular]
exten => [*#%0-9].,1,NoOp(MDENRUPAR**EXTEN=${EXTEN}**CID=${CALLERID(NUM)}*)
same => n,NoOp(calleridAntes=${CALLERID(num)})
same => n,esConsulta
same => n,GotoIf($["${consultaANI}"=""]?noConsulta)
;same => n,Set(CALLERID(name)=\Transfer:${consultaANI}\)
same => n,Set(_R_CID_NUM_00=${consultaANI})
same => n,GotoIf($["${consultaNOM}"=""]?noNom)
;same => n,Set(CALLERID(name)=\Transfer:${consultaNOM}\)
same => n,Set(_R_CID_NAME_00=${consultaNOM})
same => n(noNom),Set(_R_CID_NUM_00=${consultaANI})
same => n,NoOp(callerIDdespues=${CALLERID(num)})
same => n(noConsulta),NoOP(noConsulta)
;same => n,Set(CALLERID(num)=${consultaANI})
same => n,Return

En caso de que ya haya algo añadido en el fichero, hay que analizar en que posición se pondrá el contenido anterior para que no se vea modificado el funcionamiento de la centralita

== Como conseguir que los tonos dtmf no sean regenerados por Asterisk ==

Para que los tonos dtmf no sean regenerados por Asterisk hay que:

cd /usr/src/MDtel/asterisk/apps/
cp /tmp/app_setoption.c .
ls -l app_setoption.c
cd ..
make menuconfig (comprobar que todo está bien)
make (comprobar que compila la nueva app)
make install

EJEMPLO: los tonos dtmf entran por "Trunk_GW_MAQUETAS" y va a la extensión 4175.

Creamos un nuevo contexto por el trunk de entrada que queremos activar esta opción (o lo aplicamos a todos si procede, dependerá de cada instalación)

'''PARA LA ENTRADA:'''
sip_trunkExt_WEB.conf
Trunk_GW_MAQUETAS
context=Cen_Inicio_TrunkSip_Maqueta
dtmfmode=inband
directmedia=no
disallow=all
allow=alaw

ext_InicioLlamada_TrunkSIP_Particular.conf
[Cen_Inicio_TrunkSip_Maqueta]
exten => _X.,1,NoOp(MDINITRUNSIPPAR**EXTEN=${EXTEN}**CID=${CALLERID(NUM)}*)
same => n,SetChannelOption(14,0)
same => n,Goto(Cen_Inicio_TrunkSip,${EXTEN},1)
same => n,Return()

'''PARA LA SALIDA:'''
ext_MARCAR_Extension_Dial.conf
[Cen_Marcar_Extension_Dial_Gosub]
same => n,ExecIf($["${PASARTONOS}"="1"]?SetChannelOption(14,0)) (AÑADIMOS)

sip_WEB.conf
El peer debe tener:
PASARTONOS => 1 ;Variable declarada para el contexto ext_MARCAR_Externo_Dial en la macro
dtmfmode=inband
directmedia=no
disallow=all
allow=alaw

Paramos y arrancamos Asterisk (ya que hemos compilado y aprovechamos para recargar DialPlan)

Para comprobar el funcionamiento:

'''En Asterisk:'''

core set debug 1
Hacer llamada descolgando la misma
core set debug 0

Revisar el log de Asterisk y comprobar que en ambos canales de la llamada aparece "Disabling digit detection" (si no aparece, algo falta por configurar):
chan_sip.c: Disabling digit detection on SIP/4175-00000031
chan_sip.c: Disabling digit detection on SIP/Trunk_GW_MAQUETAS-00000030

== Problemas en la bbdd de replica, tabla COM_COMUNICADOS ==

De forma intermitente en esta tabla se generan registros duplicados y hay que borrar registros y arrancar la Réplica para que todo vuelva a funcionar.

El problema consiste en el el script borraRegistrosNimitz.pl borra la tabla entera, sin tener en cuenta el número de días que queremos dejar de backup; esto provoca que se vuelvan a repetir los índices de la BD.

Hay que modificar el script de la siguiente forma:

dentro de la sentencia elsif($tablas[$i] eq "COM_COMUNICADOS")

Hay que sustituir la sentencia
$query = "DELETE FROM $tablas[$i;

Por esta otra:
$query = "DELETE FROM $tablas[$i] where D_HORA_FIN < DATE_SUB(NOW, INTERVAL $numDias DAY) LIMIT 100";

== Simple_bridge y native_rtp ==

Para ver en que modo de funcionamiento esta la llamada escribiremos el siguiente comando.

homologacion-corp0*CLI> bridge show all

Bridge-ID Chans Type Technology
b40f41e3-0028-46d4-8c7c-34999090680f 2 basic native_rtp

El simple_bridge es el peor funcionamiento posible en el asterisk, hay que intentar estar siempre en native_rtp.

El native_rtp tiene dos modos de funcionamiento que se ve al ejecutar el comando siguiente:

homologacion-corp0*CLI> sip show channel 6d7c7a13176fc340180528281d4bcc3a@172.25.128.91:5060
Audio IP: 172.25.129.102 (Outside bridge)

En el campo Auidio Bridge podemos ver el valor Local o Outside bridge. En el modo local no se maneja al el audio por lo que no hay RTP directo entre teléfonos y pasa a través del asterisk, mientras que en modo Outside bridge si que hay rtp directo.

Howto's

2017-10-31T10:53:31Z

Imatarrubias: /* Simple_bridge y native_rtp */

{| class="wikitable"
|-
! '''Producto: '''!! VIVAit Call
VIVAit Suite

VIVAit Fax
|-
|}

== Como parar asterisk ==
En situaciones límite en el que es necesario parar el asterisk y volver a arrancarlo hay que realizar los siguientes pasos:

Entrar en la consola de asterisk e introducir el comando core stop now

Si esto no funciona, tendremos que matar el proceso a mano. Esto es, primero el safe asterisk y luego el asterisk mediante el comando
kill -9 nºPID

Tras estos pasos, volveremos a arrancar el servicio asterisk mediante /etc/init.d/asterisk start

== Como configurar la megafonía ==

El servicio de megafonía se basa en el protocolo multicast.

Para configurar la megafonía tenemos que activar en los teléfonos que para que estén "escuchando" en una dirección multicast y tener un emisor en esa dirección multicast.

Los teléfonos suelen tener en su configuración un apartado para configurar el multicast. Por ejemplo en los yealink está en la pestaña directory sección multicast IP.

En los teléfonos se puede configurar manualmente o incluirlo en las plantillas de aprovisionamiento.

El asterisk tiene un canal para hacer multicast. Este canal es MulticastRTP.

Para esto podemos crear un VDN que contenga la siguiente línea. (en el ejemplo la dirección multicast es 239.0.126.1 y el puerto es el 10001).

[Cen_VDN_90000]
exten => _X.,1,NoOp(MDVDN_90000*****EXTEN=${EXTEN}**CID=${CALLERID(NUM)}**UCID=${UCID}*)
same => n,Answer
same => n,Dial(MulticastRTP/basic/239.0.126.1:10001)
include => Cen_finLlamada

== Como configurar el candado ==
El candado permite prohibir temporalmente la posibilidad de realizar llamadas hacia fuera. Sí se pueden seguir haciendo llamadas a extensiones fijas de la plataforma, es decir, llamadas sin coste.

Para configurar dicha funcionalidad basta con crear extensiones con la categoría mas restrictiva posible y habilitar la movilidad, con lo que la extensión solo tendrá "permisos" para realizar llamadas internas.

Para permitir llamadas externas solo hay que "mover" a un usuario con categoría suficiente a la extensión deseada.
== Como crear un grupo de captura y que se vea en cada teléfono el número que llama ==

'''ATENCIÓN: SE CREAN CONFIGURACIONES NO REFLEJADAS EN PORTAL DE ADMINISTRACIÓN'''

Para la simulación de grupos de captura y conseguir que todos los terminales vean el ANI del llamante:

- Hacen falta teléfonos con dos líneas

- Cada teléfono del grupo tiene en la línea 1 su extensión habitual (por ejemplo 40000)

- Además, en el fichero "sip_Estatico.conf", creamos una segunda extensión para cada teléfono, que le ocupará la segunda línea (por ejemplo 42000)

- En esta segunda linea ponemos que cuando se llame tenga otro tono de llamada (un beep o nada...) que se asemeje en funcionamiento al de un mensaje de llamada en otra extension de mi grupo de captura

- Se ha creado una variable global por cada teléfono en el fichero de variables "ext_MDtel_Particular.conf" de nombre EXTxxxxx (por ejemplo EXT40000); esa variable contiene las otras extensiones virtuales del grupo
por ejemplo EXT40000=>SIP/42001&SIP/42005

- Hemos creado en el dialplan programación para que cuando exista esa variable global se añada a la marcación el contenido

== Como crear supletorios ==

'''ATENCIÓN: SE CREAN CONFIGURACIONES NO REFLEJADAS EN PORTAL DE ADMINISTRACIÓN'''

Igual que el caso anterior pero en la variable ponemos números reales. Debido a un bug en el enrutador, que no devuelve la variable R_PARA, en el fichero ext_MARCAR_Extension.conf hay que sustituir la siguiente linea:

;same => n,ExecIf($["${EXT${R_PARA}}"=""]?NoOp:Set(ENR_CADMARCAR=${ENR_CADMARCAR}&${EXT${R_PARA}}))
Por esta otra:
same => n,ExecIf($["${EXT${R_DEST_${ENR_RUTA_CAD}}}"=""]?NoOp:Set(ENR_CADMARCAR=${ENR_CADMARCAR}&${EXT${R_DEST_${ENR_RUTA_CAD}}}))
ATENCIÓN !!! en las llamadas salientes cada uno presenta su número

Para emplear números externos en los supletorios hay que poner, al crear la variable que hemos explicado en el apartado anterior en el ext_MDtel_Particular.conf:

EXT335=>SIP/0999999999@Trunk_Movil ;En este caso suena en la ext 335 y en el móvil 999999999

== Generación de llamada automática ==

Para activar la funcionalidad es necesario lo siguiente:

* Definir una variable ID_LISTA_LLAMAME con el ID de la lista que se va a usar para generar la llamada. Cuando se cree la lista hay que asegurarse que el campo "Nº segundos límite" tiene un valor lo suficientemente amplio para evitar que la llamada caduque antes de ejecutarse.

* Establecer un timeout para la cola (en el Gosub Cen_Sub_GrupoACD se indica justo después de ${COLA})

* Llamar a la función de MySQL ACD_FUNC_LLAMAME_CREAR a través de MDintz

* En la función se usan los siguientes elementos variables:

${ID_LISTA_LLAMAME}: Definida antes clienteTOCola:
Nombre del cliente. Al no tener ningún nombre, se usa un denominador genérico
${CALLERID}: Número llamante, donde se dirigirá la llamada.

Ejemplo:

[Cen_VDN_99001]
;----------------------------------------------------------------------------------------------------------------
;----------------------- VDN 99001 ------------------------------------------------------------
;----------------------------------------------------------------------------------------------------------------
exten => _X.,1,NoOp(MDENTGW_99001*****EXTEN=${EXTEN}**CID=${CALLERID(NUM)}**UCID=${UCID}*)
same => n,Set(__COLA=89001)
same => n,Set(ctiDiriTrato=0)
same => n,Set(ctiDiriInterface=)
same => n,Set(ID_LISTA_LLAMAME=2)
same => n(cola),Gosub(Cen_Sub_GrupoACD,${EXTEN},1(${COLA},10,,Si,))
same => n,GotoIf($["${QUEUESTATUS}"!="TIMEOUT"]?colgar)
same => n,MDintz(nimitz|bd|sqlDato|select ACD_FUNC_LLAMAME_CREAR(CURRENT_TIMESTAMP\,${ID_LISTA_LLAMAME}\,""\,"clienteTOCola"\,""\,""\,""\,""\,""\,""\,""\,""\,1\,""\,"${CALLERID(NUM)}"\,1\,3\,1\,""\,0\,0\,0\,""\,""\,""\,""))
same => n,GotoIf($["${MDintzRes}"="OK"]?colgar)
same => n,NoOp(ACD_FUNC_LLAMAME_CREAR ${MDintzRes})
same => n(colgar),Hangup

== Cancelación de eco en la plataforma ==

Comprobar que el chan_dahdi.conf este configurado los parametros:
echocancel=yes
echocancelwhenbridged=yes
Jugar con los valores txgain y rxgain

Si esto no es suficiente el siguiente paso sería emplear una canceladora de echo por hardware.

== Como "dar paso" a través de un enlace exterior si hay una llamada para una extensión creada en el sistema pero no registrada ==

Este procedimiento es de utilidad en procesos de migración, en los que recibimos las llamadas de la RTC, nos las quedamos si la extensión ya está registrada en VIVAit y la mandamos hacia la plataforma a migrar si aún sigue migrada ahí

El procedimiento es:
* Activar desvío por no contesta en la extensión (portal de administración - VIVAit Call - Dispositivos - Extensiones - campo "Desvio no contesta", indicando como destino un prefijo (por ejemplo "99") seguido de la extensión destino

* Creamos una preruta en vivait-call - rutas -prerutas con origen "99", le quitamos el prefijo en campo "Destino saliente 1" (valor -2) e indicamos en campo "Tipo destino sal. 1" como "Ruta externa"

* Debera existir una ruta externa para esa numeración

== Comprobación de versiones de elementos de la plataforma ==

'''Aplicaciones'''
:* Botón derecho del ratón, Acerca De

'''Portales'''
:* En el Vivait-Call, en la pantalla de inicio de sesión pone el número de versión del portal.
:* Tanto en el Monitor como en el Tracker no se puede saber.

'''Demonios'''
:* Mediante el comando nc localhost <Puerto demonio>. Ejemplo:
::nc localhost 1120
::motorSal sis ver='03.02.00' inic='20150427 123457' alarmas=0 ultAlar='00000000000000'
::motorSal gmp msj=253/256 buf=256/256 tarea=99/102
::motorSal tmp uptime=12624 (0d 3h 30m 24s)
::motorSal mtr mys=1 ocup=0% planif=13(0) intento=11(0)

::Ejemplos puertos demonios:
:::*1111: vivait-cti
:::*1112: myAcdSuperv
:::*1113: recordNodo
:::*1114: recordCentral
:::*1115: intz-nimitz
:::*1120: motorSal
:::*1123: phoneprov-tftp

'''Base de datos'''
:* No se puede saber la versión a no ser que se comparen esquemáticos con los subidos en el redmine

[[Category:tecnico]]
[[Category:administrador]]
[[Category:VIVAit Call]]
[[Category:VIVAit Suite]]
[[Category:VIVAit Fax]]

== Añadir Auto-Answer a la cabecera SIP ==

Si queremos que un teléfono tenga autoanswer:
* En el peer poner: headeraa=Call-Info: answer-after=0, esto tiene que ir en la plantilla de la extensión o como campo en la extensión. Dependiendo del terminal que utilicemos el valor de este campo variará:

Aastra: Alert-Info: info=alert-autoanswer
Grandstream: Call-Info: answer-after=0
Linksys: Call-Info:\;Answer-After=0
Polycom: Alert-Info: Ring Answer
Snom: Call-Info: answer-after=0
Snom (nuevo firmware): Call-Info: <sip:IP>\;answer-after=0
Yealink: Call-Info: answer-after=0

* Luego en el diaplan añadir lo siguiente: exten => _[*#%0-9a-zA-Z].,n,set(__AutoAnswer=AA) (Esto tendremos que ver como ponerlo de manera automática). De manera provisional si queremos que sea para llamadas salientes pondremos esto en el ext_n_marcador.conf. Si queremos que sea llamadas entrantes lo pondremos en ext_n_MARCAR.conf

== Configuración de los portales web en HTTPS ==

Desde /usr/lib/jvm/default-java/bin/ ejecutamos:

keytool -genkey -alias tomcat -keyalg RSA -keystore /usr/share/tomcat7/.keystore

Escriba la contraseña del almacén de claves: (t0mc4t)
Volver a escribir la contraseña nueva: (t0mc4t)
*Personalizar para el cliente
¿Cuáles son su nombre y su apellido?
[Unknown]: VIVAit Suite
¿Cuál es el nombre de su unidad de organización?
[Unknown]: Desarrollo
¿Cuál es el nombre de su organización?
[Unknown]: MDtel
¿Cuál es el nombre de su ciudad o localidad?
[Unknown]: Madrid
¿Cuál es el nombre de su estado o provincia?
[Unknown]: Madrid
¿Cuál es el código de país de dos letras de la unidad?
[Unknown]: es
¿Es correcto CN=VIVAit Suite, OU=Desarrollo, O=MDtel, L=es, ST=Madrid,
C=Unknown?
[no]: si
Escriba la contraseña clave para <tomcat>
(INTRO si es la misma contraseña que la del almacén de claves)

nano /var/lib/tomcat7/conf/server.xml

Descomentar la línea:

<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"

maxThreads="150" scheme="https" secure="true"

clientAuth="false" sslProtocol="TLS"/>

Añadir después de sslProtocol="TLS":

keystorePass="t0mc4t"

== Crear un motivo desconexión para el Supervisor en '''''VIVA'''''it Suite==

Para crear motivos de desconexión adicionales a los que ya ofrece la aplicación tendremos que añadir una nueva entrada en la BD. El comando que emplearíamos seria el siguiente:

INSERT INTO `nimitz`.`COM_ENUMERADOS` (`ID`, `C_NOMBRE`, `C_TEXTO`, `N_POSICION`, `C_OBSERV`) VALUES(1000700, 'TSesAgMotDesc', 'Nombre Motivo de desconexión', 60, ' ');

El ID debe ser mayor o igual a 1000700 y menor a 1000800. El N_POSICION debe ser mayor o igual a 60 y menor que 100.

== Envío de variables CTI al ACD ante un GW con asterisk 13==
Dado que para un GW con asterisk 13 un nodo ACD es considerado un elemento externo, por defecto, no se envían variables CTI (UCID, ...). En una fututa versión del nodo ACD, ya no se considerará un elemento externo por lo que si se enviarán dichas variables. Para lograrlo en la versión 3.0 de la plataforma Vivait hay que modificar el fichero ext_MARCAR_Externo_Particular.conf del GW. Deberemos poner la siguiente linea.

same => n,Macro(escribirDatosCti)

== Script para cambio automático de claves en salas de conferencia estáticas ==

Para cambiar la clave de las salas de conferencias crear un script llamado cambioClaveConfe.sh con el siguiente contenido:

#!/bin/bash
CLAVE=$(shuf -i 1111-9999 -n 1)

echo $CLAVE

echo "update CEN_SALAS_CONFERENCIAS set C_PIN='$CLAVE' WHERE C_NOMBRE='$1'" | mysql -u nimitz -pivivanimitz nimitz

FROM=sat@mdtel.es
FECHA=`date +"%Y%m%d%H%M%S"`
CLIENTE=<PONER EL CLIENTE>
TO=<DESTINATARIOS>
ASUNTO="Nueva clave en sala $1"
CUERPO="La nueva clave para la sala $1 es: $CLAVE"
/usr/sbin/sendmail -oi -t -v -f $FROM <<EOF
From: $FROM
To: $TO
Bcc: $BCC
Subject: $ASUNTO

$CUERPO
EOF

El script cambiará la clave de la sala pasada por parámetro por una aleatoria de 4 dígitos y la enviará por correo a los <DESTINATARIOS> (direcciones de correo electrónico separadas por coma).

Hay que crear una tarea en /etc/crontab añadiendo una linea como la siguiente:
30 6 * * 7 root cambioClaveConfe.sh 6173

Esto ejecutará el script todos los domingos a las 6:30 horas cambiando la clave de la sala 6173. Añadir tantas linéas como salas.

==ZABBIX ==

=== Como crear un TRIGGER en Zabbix ===

'''1.''' Hay '''dos posibilidades''' dependiendo si el trigger es para un solo host o es para varios, los cuales tienen en común un template:

:# Si es para ''un host'': Ir a '''Configuración/Hosts'''
:# Si es para ''un template'': Ir a '''Configuración/Templates'''

'''2.''' En la fila correspondiente al host/template al que queramos añadirle el trigger, pulsar sobre la '''columna triggers.''' 
'''3.''' En la ventana de triggers, pulsar sobre el botón '''Create trigger''', situado en la esquina superior derecha. 
'''4.''' Aparecerá la ventana de creación de triggers, que tiene los siguientes campos:
:1. '''Name:''' Nombre del trigger, que deberá ser lo ''suficientemente descriptivo''. Aparecerá cuando se
active, en la ventana principal de Zabbix así como en los correos de aviso.
:2. '''Expression:''' Define la fórmula cuyo resultado activará el trigger. Hay que pulsar el botón '''Add'''. Se mostrará una
nueva ventana donde habrá que elegir el item (medida) sobre el que se basará el trigger (evidentemente la medida deberá
existir previamente) y la función necesaria para el cálculo. Para una descripción de las disponibles dirigirse a
https://www.zabbix.com/documentation/2.2/manual/appendix/triggers/functions. 
Tras rellenar los campos anteriores y dar a la función los valores que necesite pulsar el botón '''Insert.'''
:3. '''Expression constructor:''' Permite crear expresiones complejas, uniendo varias.
:4. '''Description:''' Una explicación del trigger
:5. '''Severity:''' Criticidad el trigger
:6. Para una descripción del resto de campos visitar la página: https://www.zabbix.com/documentation/2.2/manual/config/triggers/trigger
'''5.''' Tras rellenar los campos, pulsar el botón '''Save'''. 
'''6.''' Si el trigger se ha añadido en un template, aparecerá en todos los hosts que tienen el template configurado. 
'''7.''' '''El trigger por si solo no envía ningún aviso''', solo se activa si se cumple la expresión definida.
Para enviar un aviso (normalmente un correo electrónico) cuando se active el trigger, será necesario definir una acción (Configuración/Actions).

'''NOTA.-''' Para consultar cualquier cuestión relativa a Zabbix, se encuentra a su disposición el manual: 
https://www.zabbix.com/documentation/2.2/manual

=== Monitorización en Zabbix de un trunk caído ===
Para monitorizar un o varios trunk por separado y saber el estado de cada uno es necesario lo siguiente:

*Añadir el UserParameter adjunto que contiene el siguiente texto:

UserParameter=asterisk.trunkEstado[*],sudo /usr/sbin/asterisk -rx 'sip show peers' | grep --text -i '$1' | grep OK >/dev/null; if [ $? -eq 0 ]; then echo 1; else echo 0; fi

*Añadir en el portal de zabbix un item por cada trunk. En el campo Key se pondrá "asterisk.trunkEstado[nombre_trunk]", donde nombre_trunk es el nombre del trunk tal y como se ve en Asterisk.
[[File:zabbix_item_trunkEstado.png]]

*Crear un trigger que avise cuando el último valor sea 0. Por ejemplo:
{corp-bdtr:asterisk.trunkEstado[PrePro-ACD].last()}=0

[[File:zabbix_trigger_trunkEstado.png]]

== Agendas en terminales Yealink ==
En la agenda se mostrará como nombre lo que contenga el campo CEN_AGENDAS.C_NOMBRE_MOSTRAR y como teléfono el indicado en CEN_AGENDAS_TELEFONOS.C_TELEFONO
Para hacer funcionar la agenda:

*En el archivo de aprovisionamiento correspondiente (Yealink-XXXX-comun.cfg) establecer los siguientes parámetros:

remote_phonebook.data.1.url = http://<direc IP>/vivait-agenda/yealink/contactData1.xml
remote_phonebook.data.1.name = NOMBRE DE LA AGENDA EN EL TELEFONO

*En el archivo /etc/apache2/apache2.conf añadir tras el último Directory:

<Directory /var/www/html/vivait-agenda/>
AddType application/x-httpd-php .xml
Options Indexes FollowSymLinks MultiViews
AllowOverride None
Order allow,deny
allow from all
</Directory>

*Ejecutar el comando:

/etc/init.d/apache2 reload

== Calendarios ==

=== Enrutamiento inteligente ===

Ante una llamada a un destino, si hay cita de ocupado en el calendario se desvia al número indicado en el campo "location" del calendario o a su buzon de voz si hay valor en dicho campo

same => n,Set(CalendarBusy=${CALENDAR_BUSY(GoogleCalendar)})
same => n,Set(id=${CALENDAR_QUERY(GoogleCalendar)})
same => n,NoOP(hay ${CALENDAR_QUERY_RESULT(${id},getnum)} eventos)
same => n,Verbose(3,The state of GoogleCalendar is $
{DEVICE_STATE(Calendar:GoogleCalendar)})
same => n,Set(CalendarLocation=${CALENDAR_QUERY_RESULT(GoogleCalendar,location)})
same => n,GotoIf($["${CalendarBusy}"=="1"]?:conCategoria)
same => n,GotoIf($["${CalendarLocation}"==""]?buzon)
same => n,Goto(Cen_iniLlam,${CalendarLocation},1)
same => n(buzon),Playback(Particular/buzon)
same => n,Hangup
same=> n(conCategoria),Goto(Cen_iniLlam,${EXTEN},1)

=== Conexión de cliente Outlook a calendarios VIVAit mediante Caldav===
Por defecto, el cliente outlook no soporta Caldav; si queremos disponer de calendarios de VIVAit en Outlook tendríamos dos opciones:
# Tener los calendarios en el servidor Exchange
# Instalar un plugin en el cliente outlook que permita conectar vía Caldav los calendarios que estén ubicados en el servidor de calendarios de VIVAit

Este howto se centra en esta segunda posibilidad

Procedimiento:

1.- Instalar Calldavsincronizer (valdrían otros plugin de Caldav para Outlook)

[https://sourceforge.net/projects/outlookcaldavsynchronizer/ https://sourceforge.net/projects/outlookcaldavsynchronizer/]

2.- Entrar en Synchronization Profiles en la nueva pestaña Calldav Syncronizer de outlook [[File:Syncronizer.png]]

3.- Añadir nuevo perfil (tecla +)

[[File:Nuevo.png|center|600px]]

A tener en cuenta:

*Crear un nuevo “Outlook folder”, entendemos que es adecuado (quizás necesario) para que las entradas de calendario de VIVAit queden diferenciadas.
*Lo mejor es haber creado antes el calendario en el servidor para que al darlo de alta en oulook comprobemos que se conecta.
*Dando al botón “Test or discover settings” se nos muestran todos los calendarios del servidor y elegimos el que queramos; en “elementos de la carpeta” diremos “elementos de calendario”.

[[File:Calendario.png|center|800px]]

== Uso de reloj hardware en nodos de procesamiento ==

=== En nodo de procesamiento ACD ===
En un nodo de procesamiento ACD es obligatorio instalar dahdi y una tarjeta de primario para emplear reloj hardware, ya que el reloj software que va en el asterisk 1.4 es defectuoso.
Para configurarlo basta con instalar la tarjeta en el servidor, instalar dahdi y posteriormente ejecutar el siguiente comando:

dahdi_cfg

Este comando generaŕa el fichero /etc/dahdi/system.conf

Para comprobar que el comando se ha ejecutado satisfactoriamente lo abriremos y tendrá que tener un formato semejante al siguiente ejemplo:

# Autogenerated by /usr/sbin/dahdi_genconf on Tue Oct 22 17:42:59 2013
# If you edit this file and execute /usr/sbin/dahdi_genconf again,
# your manual changes will be LOST.
# Dahdi Configuration File
#
# This file is parsed by the Dahdi Configurator, dahdi_cfg
#
# Span 1: WCT1/0 "Digium Wildcard TE110P T1/E1 Card 0" HDB3/CCS/CRC4
span=1,1,0,ccs,hdb3,crc4
# termtype: te
bchan=1-15,17-31
dchan=16
echocanceller=oslec,1-15,17-31
# Global data
loadzone = es
defaultzone = es

=== En nodo de procesamiento de corporativa ===
En un nodo de procesamiento de corporativa no obligatorio instalar dahdi y una tarjeta de primario para emplear reloj hardware, ya que el no se han detectado errores en el reloj por software. Sin embargo si instalamos dahdi y una tarjeta de primario para emplear reloj hardware, el sistema funcionará mejor.
Para configurarlo basta con instalar la tarjeta en el servidor, instalar dahdi y posteriormente ejecutar el siguiente comando:

dahdi_cfg

Este comando generaŕa el fichero /etc/dahdi/system.conf

Para comprobar que el comando se ha ejecutado satisfactoriamente lo abriremos y tendrá que tener un formato semejante al siguiente ejemplo:

# Autogenerated by /usr/sbin/dahdi_genconf on Tue Oct 22 17:42:59 2013
# If you edit this file and execute /usr/sbin/dahdi_genconf again,
# your manual changes will be LOST.
# Dahdi Configuration File
#
# This file is parsed by the Dahdi Configurator, dahdi_cfg
#
# Span 1: WCT1/0 "Digium Wildcard TE110P T1/E1 Card 0" HDB3/CCS/CRC4
span=1,1,0,ccs,hdb3,crc4
# termtype: te
bchan=1-15,17-31
dchan=16
echocanceller=oslec,1-15,17-31
# Global data
loadzone = es
defaultzone = es

== Aprovisionamiento terminales Cisco ==
=== Configurar protocolo SIP TCP o UDP en terminal Cisco ===

Configuración de terminal Cisco para para funcionar bajo TCP o UDP:
Modificar parámetro
<transportLayerProtocol>X</transportLayerProtocol>

Donde X es:
1: TCP
2: UDP
4: Valor por defecto del firmware (al menos en la última versión equivale a TCP)

=== Habilitar/Deshabilitar llamada en espera en terminales Cisco ===

En el fichero de aprovisionamiento del terminal añadiremos la siguiente linea
<callWaiting>X</callWaiting>

Donde X es:
0=off but can be changed through the settings menu.
1=on but can be changed through the settings menu.
2=off and locked so it can't be changed through the settings menu.
3=on and locked so it can't be changed through the settings menu.

== Como configurar servicio DHCP en Ubuntu Linux ==
'''¿Que es un servicio DHCP?'''

Un servidor Dynamic Host Configuration Protocol (DHCP) asigna dinámicamente las direcciones IP y otras configuraciones de red a otros terminales que están conectados a la red.

'''Instalar un servicio DHCP'''

Para instalar el servidor de asignacion automatica de direccion IP ejecutamos el comando:
sudo apt-get install isc-dhcp-server

'''Configurando el servicio DHCP'''

Editamos el archivo /etc/dhcp/dhcpd.conf creando primero un backup del mismo:
mv /etc/dhcp/dhcpd.conf /etc/dhcp/dhcpd.conf.original
nano /etc/dhcp/dhcpd.conf

El archivo debe quedar de una forma muy similar a esta:
authoritative
subnet 10.254.239.0 netmask 255.255.255.254
{
range dynamic-bootp 10.254.239.40 10.254.239.60;
option domain-name-servers ns1.example.org, ns2.example.org;
option domain-name "example.org";
option routers rtr-239-0-1.example.org, rtr-239-0-2.example.org ;
option broadcast-address 10.254.239.255;
default-lease-time 3600;
max-lease-time 7200;
option option-150 10.254.239.25
}

Donde los campos:
*subnet: Direccion de red
*netmask: Máscara de red
*range dynamic-bootp: Rango de IPs que va a proporcionar el DHCP
*option domain-name-servers: Direcciones IPs de los DNS
*option domain-name: Nombre de dominio
*option routers:IPs de las puertas de enlace
*option broadcast-address: Dirección de broadcast
*default-lease-time: Tiempo de concesión por defecto
*max-lease-time: Valor máximo del tiempo de concesión
*option option-150: IPs de los servidores TFTPs que tiene la red

'''Reiniciamos el servicio'''

service isc-dhcp-server restart

'''Direcciones IP estáticas basadas en la MAC'''

Pueden conocerse las MAC de las máquinas conectadas a la red ejecutando el comando arp desde la terminal.

host ejemplo {
hardware ethernet 00:0B:82:19:A8:04;
option option-150 10.254.239.0;
# fixed-address 10.254.239.52;
}

== Protocolo Skinny en VIVAit Call mediante uso de Chan-SCCP ==
'''Instalación de chan_sccp'''

*Copiar el fichero chan-sccp-4.2.1.1.tar.gz en el directorio donde estén los fuentes de Asterisk (normalmente /usr/src/MDtel)
*Descomprimir
*Entrar al directorio chan-sccp-4.2.1.1
*Ejecutar: ./configure --with-asterisk=../DIRECTORIO_ASTERISK --enable-conference. Donde DIRECTORIO_ASTERISK es el nombre del directorio donde están los fuentes de asterisk.
*Tras el ejecutar el configure (si todo va bien al final se verá un resumen con el S.O, arquitectura, etc), ejecutar make y make install
*El nuevo módulo chan_sccp.so se generará dentro del DIRECTORIO_ASTERISK en lib/asterisk/modules/ y se deberá copiar en /usr/lib/asterisk/modules/
*Copiar el fichero sccp.conf a /etc/asterisk
*Entra a Asterisk y ejecutar: module load chan_sccp.so
*Si se ha cargado correctamente, desde dentro de Asterisk, si se teclea sccp show version deberá devolver: "Skinny Client Control Protocol (SCCP). Release: 4.3.0 4.3.0 - unknown (built by 'root' on '2016-06-01 10:42:32 UTC')"

'''Crear extensiones'''

*En el portal crear una nueva clase de dispositivo (Vivait-Call/Dispositivos/Clases de dispositivos), donde la clase sea extensión la subclase H323 (todavía no existe la subclase SCCP) y el formato SCCP/${DEST}
*Crear la nueva extensión, pero el dispositivo debe ser el creado en el campo anterior.
*Las extensiones creadas habrá que añadirlas al fichero sccp.conf así como los teléfonos que las usarán. En el fichero sccp.conf incluido hay ejemplos.

'''Aprovisionamiento'''
Los terminales se aprovisionan de la misma manera que los SIP, exceptuando que las plantillas XML no tiene referencias a SIP. Se incluye un xml genérico con todas las opciones.
Dentro del directorio chan-sccp-4.2.1.1 hay un directorio conf con todos los archivos de configuración necesarios. Las versiones annotated contienen todas las opciones posibles comentadas.

== Instalación y configuración Postfix en RedHat7 ==

'''Postfix''' es un ''servidor de correo'' de software libre/código abierto, un programa informático para el enrutamiento y envío de correo electrónico.

'''Instalación'''

yum install postfix

'''Configuración'''

Sobre la configuración de postfix por defecto (recién instalado):
Editar el fichero /etc/postfix/main.cf
inet_protocols = ipv4
relayhost = smtp.renfe.es
Revisar la configuración:
postfix check
Configurar postfix como servicio (sólo en redhat y similares)
chkconfig postfix on
Iniciar postfix:
service postfix start
Instalar mailx para disponer de los comandos mail y sendmail:
yum install mailx
Probar configuración:
echo "Prueba de correo" | mail -vs "Prueba" correo@destino.soy

== FOP2 ==

=== Como mostrar callername queues FOP2 ===

Es necesario añadir el siguiente código al contexto de entrada:

exten => _X.,n,MYSQL(Connect connid localhost usuario clave bd)
exten => _X.,n,MYSQL(Query resultid ${connid} SELECT\ firstname\,lastname\ from\ fop2\ where\ phone1=${CALLERID(num)}\ OR\ phone2=${CALLERID(num)})
exten => _X.,n,MYSQL(Fetch fetchid ${resultid} nombre apellidos)
exten => _X.,n,GotoIf($[${fetchid} = 1]?:noExiste)
exten => _X.,n,Set(CALLERID(name)=${nombre}${apellidos})
exten => _X.,n(noExiste),Continuar

En la primera línea cambiar según lo necesario:

*localhost: Dirección IP del servidor de MySQL donde está la BBDD de FOP2
*usuario: Usuario con permisos de acceso a la bbdd de FOP2
*clave: Clave del usuario
*bd: Nombre de la BBDD

=== FOP2. Problemas en transferencias asistidas ===

Para habilitar la transferencia atendida del asterisk (funcion atxfer), hay que poner la opción tT en el queue() si la llamada origen
la realiza a una cola o al dial() de las extensiones.
Con eso vemos como al intentar hacer la llamada de consulta ya se va a nuestro dialplan. Sin embargo la llamada no funciona ya que
el enrutador nos da error de enrutamiento porque no tenemos ID_DISPOSITIVO origen ya que el fop no es un elemento creado desde el portal.
Por lo que se propone como solución crear un contexto de inicio del fop y asignarle un ID_DISPOSITIVO para que así se enrute la llamada.
El contexto tienen que ser similar a ext_InicioLlamada_Chrome.conf

Para que funcione las transferencias supervisadas desde el fop2 hay que realizar lo siguiente:

*El usuario del manager debe tener permisos Atxfer para poder realizar transferencias.
*Habilitar la transferencia atxfer en el fuatures.conf del asterisk. atxfer => *2
*Crear el fichero ext_InicioLlamada_FOP.conf con el siguiente contenido:

[Cen_Inicio_FOP]
exten => [*#%0-9].,1,NoOp(MDINICHR**EXTEN=${EXTEN}**CID=${CHROME_ANI}*)
same => n,dumpchan()
;same => n,Set(CALLERID=${CHROME_ANI})
same => n,Gosub(Cen_Sub_getIdExtension,s,1(${R_CID_NUM_00}))
same => n,ExecIf($["${GOSUB_RETVAL}"!="OK" | "${sqlDato}"=""]?HangUp)
same => n,Set(ID_DISPOSITIVO=${sqlDato})
; . Modificar MARCAR en funcion de reglas de marcacion saliente (prefijo 0, ...)
; Esto se modificara en el contexto Cen_Inicio_Chrome_Particular
same => n,Set(MARCAR=${EXTEN})
;---------------------------------

;--- Llamada a contexto particular
;---------------------------------
; Esta llamada es para hacer cosas especificas del cliente (cambiar callerid...)
; La subrutina Cen_Inicio_Chrome_Particular esta en el archivo ext_InicioLlamada_Chrome_Particular.conf
; Si no existe el archivo copiar el archivo ext_InicioLlamada_Chrome_Particular.conf.ejemplo como ext_Inicio_Chrome_Particular.conf
; y realizar las modificaciones necesarias
; El fichero ext_InicioLlamada_Chrome_Particular.conf se carga automaticamente al ser creado con el include de ext_InicioLlamada.conf
; #include "ext_InicioLlamada*.conf"
;
same => n,GosubIf($[${DIALPLAN_EXISTS(Cen_Inicio_FOP_Particular,${EXTEN},1)}>0]?Cen_Inicio_FOP_Particular,${EXTEN},1)
same => n,Goto(Cen_Inicio_SIP,${MARCAR},1)

*En el fichero /usr/local/fop2/buttons.cfg poner como contexto de las extensiones el creado anteriormente (Cen_Inicio_FOP)
*Modificar el fichero /usr/local/fop2/fop2.cfg:

blind_transfer = 0
supervised_transfer = 1

Para realizar la transferencia con consulta, hay que pulsar el supervised transfer del FOP2 y una vez se haya establecido la llamada, seleccionar la extensión que "sobra" en la conversación y pulsar la tecla de hangup y colgar la llamada.

== Como ver los directorios de un NAS a montar con NFS ==

Con el siguiente comando vemos los diferentes volúmenes de un NAS:

showmount -e IP_NAS

Ejemplo de salida:

Export list for 192.168.10.10:
/Backup/backup *
/DISCOS_1/VOL1_AUDIO *

== Instalación de ActivaSTP con VIVAit Call 3 y marcación desde Outlook ==

Instalamos ActivaSTP desde:

(http://activa.sourceforge.net/)



La configuración necesaria se muestra en la siguiente imagen:

[[File:Ventana ActivaTSP.jpg]]

El usuario del manager debe tener permisos originate para poder realizar llamadas.

Se han realizado pruebas con Outlook 2013.

Se ha comprobado la correcta realización de pruebas utilizando ActivaSTP, realizadon llamadas desde la pestaña "personas" con la vista en modo tarjeta de Pesentación, tarjeta, teléfono o lista.

Outlook 2013 no da la opción de llamar si la vista está en modo personas.

== Como volver a procesar grabaciones con error ==

Las grabaciones con error son aquellas que tienen el valor E_GRABACION=120 en la tabla DAT_GRABACIONES.

Las grabaciones con error se producen normalmente por la pérdida de conexión entre el nodo servidor de grabaciones y el resto.

Para reprocesar la grabación hay que modificar el campo E_GRABACION de la tabla DAT_GRABACIONES y ponerlo con valor 20 para que así el recordCentral la vuelva a procesar.



== Como borrar contenido de la tabla BDTR con el script borraRegistrosNimitz.pl ==

Este script se ejecuta mediante una tarea del crontab, tal como la siguiente:

SHELL=/bin/sh
PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
# m h dom mon dow user command
00 01 * * * root /usr/local/sbin/borraRegistrosNimitz.pl --hDB localhost

Para establecer el número de días que vamos a dejar en la base de datos debemos editar el archivo borraRegistrosNimitz.pl, el campo my $numDias.

== Ocasionalmente No saltan los formularios en '''VIVAit Suite''' cuando existen marcadores ==
En los sistemas con marcadores, se ha observado que, en un porcentaje muy bajo, cuando entra una llamada a un agente no se presenta el formulario.
En una traza del vivait-desk se pudo comprobar que no había eventos CTI de la llamada, pero telefónicamente la llamada si quedaba establecida.

El problema viene ocasionado porque el CTI tiene auditorías para descartar llamadas,evitando que se queden enganchadas.

Una de esas auditorías es el tiempo máximo de las llamadas no contestadas.

El marcador tiene puesto a fuego que el tiempo que permanece una llamada en cola a la espera de un agente libre es de 10 minutos.

Hay que poner el tiempo de auditoría en un valor superior (por ejemplo 12 minutos)

En el archivo de configuración '''vivait-cti.conf'''

audit_call_minutNoContestada = 12

El paŕametro audit_call_minutContestada, es el tiempo que el cti "conserva" una llamada, dado que el dialplan tiene puesto el timeout absolute a 7200 (120 minutos), deberiamos modificar este parámetro para que esté sincronizado

audit_call_minutContestada = 120

Estos cambios se implementarán en el instalador de la próxima versión.

== Generación de un Core ==
Un Core es la memoria de un programa.

Para generar un Core rápido con Asterisk hay que hacer lo siguiente:

Ejecutar ps aux | grep asterisk y coger el PID del programa
gdb /usr/sbin/asterisk [PID]
gcore [file]

== Activación de la movilidad para un usuario ==

Una vez configurada la movilidad e intentar activarla nos da error cuando le ponemos el usuario y la contraseña.

La configuración del usuario es la siguiente:

[[File:Problema.jpg|center]]

Para que la movilidad funcione hay que asignar un teléfono a la extensión, quedando la configuración de esta manera:

[[File:Asignacion_de_telefono.jpg|center]]

== Como se muestra el número llamante en transferencia desde operadora ==
Para tener el número ANI en las transferencias con consulta hay que realizar lo siguiente:
Copiar el archivo adjunto (app_esConsulta.c) en el directorio apps de Asterisk (normalmente /usr/src/vivait-call/asterisk/apps).
Situarse en el directorio raiz de Asterisk (normalmente /usr/src/vivait-call/asterisk/).
Compilar: make
Instalar: make install
Habilitar el nuevo módulo: asterisk -rx 'module load app_esConsulta.so'
Si la carga del módulo no funcionara, hay que el reiniciar Asterisk para que cargue el módulo.

Posteriormente modificar el fichero ext_Enrutador_Particular.conf de la siguiente forma:

[Cen_Enrutador_Particular]
exten => [*#%0-9].,1,NoOp(MDENRUPAR**EXTEN=${EXTEN}**CID=${CALLERID(NUM)}*)
same => n,NoOp(calleridAntes=${CALLERID(num)})
same => n,esConsulta
same => n,GotoIf($["${consultaANI}"=""]?noConsulta)
;same => n,Set(CALLERID(name)=\Transfer:${consultaANI}\)
same => n,Set(_R_CID_NUM_00=${consultaANI})
same => n,GotoIf($["${consultaNOM}"=""]?noNom)
;same => n,Set(CALLERID(name)=\Transfer:${consultaNOM}\)
same => n,Set(_R_CID_NAME_00=${consultaNOM})
same => n(noNom),Set(_R_CID_NUM_00=${consultaANI})
same => n,NoOp(callerIDdespues=${CALLERID(num)})
same => n(noConsulta),NoOP(noConsulta)
;same => n,Set(CALLERID(num)=${consultaANI})
same => n,Return

En caso de que ya haya algo añadido en el fichero, hay que analizar en que posición se pondrá el contenido anterior para que no se vea modificado el funcionamiento de la centralita

== Como conseguir que los tonos dtmf no sean regenerados por Asterisk ==

Para que los tonos dtmf no sean regenerados por Asterisk hay que:

cd /usr/src/MDtel/asterisk/apps/
cp /tmp/app_setoption.c .
ls -l app_setoption.c
cd ..
make menuconfig (comprobar que todo está bien)
make (comprobar que compila la nueva app)
make install

EJEMPLO: los tonos dtmf entran por "Trunk_GW_MAQUETAS" y va a la extensión 4175.

Creamos un nuevo contexto por el trunk de entrada que queremos activar esta opción (o lo aplicamos a todos si procede, dependerá de cada instalación)

'''PARA LA ENTRADA:'''
sip_trunkExt_WEB.conf
Trunk_GW_MAQUETAS
context=Cen_Inicio_TrunkSip_Maqueta
dtmfmode=inband
directmedia=no
disallow=all
allow=alaw

ext_InicioLlamada_TrunkSIP_Particular.conf
[Cen_Inicio_TrunkSip_Maqueta]
exten => _X.,1,NoOp(MDINITRUNSIPPAR**EXTEN=${EXTEN}**CID=${CALLERID(NUM)}*)
same => n,SetChannelOption(14,0)
same => n,Goto(Cen_Inicio_TrunkSip,${EXTEN},1)
same => n,Return()

'''PARA LA SALIDA:'''
ext_MARCAR_Extension_Dial.conf
[Cen_Marcar_Extension_Dial_Gosub]
same => n,ExecIf($["${PASARTONOS}"="1"]?SetChannelOption(14,0)) (AÑADIMOS)

sip_WEB.conf
El peer debe tener:
PASARTONOS => 1 ;Variable declarada para el contexto ext_MARCAR_Externo_Dial en la macro
dtmfmode=inband
directmedia=no
disallow=all
allow=alaw

Paramos y arrancamos Asterisk (ya que hemos compilado y aprovechamos para recargar DialPlan)

Para comprobar el funcionamiento:

'''En Asterisk:'''

core set debug 1
Hacer llamada descolgando la misma
core set debug 0

Revisar el log de Asterisk y comprobar que en ambos canales de la llamada aparece "Disabling digit detection" (si no aparece, algo falta por configurar):
chan_sip.c: Disabling digit detection on SIP/4175-00000031
chan_sip.c: Disabling digit detection on SIP/Trunk_GW_MAQUETAS-00000030

== Problemas en la bbdd de replica, tabla COM_COMUNICADOS ==

De forma intermitente en esta tabla se generan registros duplicados y hay que borrar registros y arrancar la Réplica para que todo vuelva a funcionar.

El problema consiste en el el script borraRegistrosNimitz.pl borra la tabla entera, sin tener en cuenta el número de días que queremos dejar de backup; esto provoca que se vuelvan a repetir los índices de la BD.

Hay que modificar el script de la siguiente forma:

dentro de la sentencia elsif($tablas[$i] eq "COM_COMUNICADOS")

Hay que sustituir la sentencia
$query = "DELETE FROM $tablas[$i;

Por esta otra:
$query = "DELETE FROM $tablas[$i] where D_HORA_FIN < DATE_SUB(NOW, INTERVAL $numDias DAY) LIMIT 100";

== Simple_bridge y native_rtp ==

Para ver en que modo de funcionamiento esta la llamada escribiremos el siguiente comando.

homologacion-corp0*CLI> bridge show all
Bridge-ID Chans Type Technology
b40f41e3-0028-46d4-8c7c-34999090680f 2 basic native_rtp

El simple_bridge es el peor funcionamiento posible en el asterisk, hay que intentar estar siempre en native_rtp.

El native_rtp tiene dos modos de funcionamiento que se ve al ejecutar el comando siguiente:

homologacion-corp0*CLI> sip show channel 6d7c7a13176fc340180528281d4bcc3a@172.25.128.91:5060
Audio IP: 172.25.129.102 (Outside bridge)

En el campo Auidio Bridge podemos ver el valor Local o Outside bridge. En el modo local no se maneja al el audio por lo que no hay RTP directo entre teléfonos y pasa a través del asterisk, mientras que en modo Outside bridge si que hay rtp directo.

Howto's

2017-10-31T10:53:21Z

Imatarrubias:

{| class="wikitable"
|-
! '''Producto: '''!! VIVAit Call
VIVAit Suite

VIVAit Fax
|-
|}

== Como parar asterisk ==
En situaciones límite en el que es necesario parar el asterisk y volver a arrancarlo hay que realizar los siguientes pasos:

Entrar en la consola de asterisk e introducir el comando core stop now

Si esto no funciona, tendremos que matar el proceso a mano. Esto es, primero el safe asterisk y luego el asterisk mediante el comando
kill -9 nºPID

Tras estos pasos, volveremos a arrancar el servicio asterisk mediante /etc/init.d/asterisk start

== Como configurar la megafonía ==

El servicio de megafonía se basa en el protocolo multicast.

Para configurar la megafonía tenemos que activar en los teléfonos que para que estén "escuchando" en una dirección multicast y tener un emisor en esa dirección multicast.

Los teléfonos suelen tener en su configuración un apartado para configurar el multicast. Por ejemplo en los yealink está en la pestaña directory sección multicast IP.

En los teléfonos se puede configurar manualmente o incluirlo en las plantillas de aprovisionamiento.

El asterisk tiene un canal para hacer multicast. Este canal es MulticastRTP.

Para esto podemos crear un VDN que contenga la siguiente línea. (en el ejemplo la dirección multicast es 239.0.126.1 y el puerto es el 10001).

[Cen_VDN_90000]
exten => _X.,1,NoOp(MDVDN_90000*****EXTEN=${EXTEN}**CID=${CALLERID(NUM)}**UCID=${UCID}*)
same => n,Answer
same => n,Dial(MulticastRTP/basic/239.0.126.1:10001)
include => Cen_finLlamada

== Como configurar el candado ==
El candado permite prohibir temporalmente la posibilidad de realizar llamadas hacia fuera. Sí se pueden seguir haciendo llamadas a extensiones fijas de la plataforma, es decir, llamadas sin coste.

Para configurar dicha funcionalidad basta con crear extensiones con la categoría mas restrictiva posible y habilitar la movilidad, con lo que la extensión solo tendrá "permisos" para realizar llamadas internas.

Para permitir llamadas externas solo hay que "mover" a un usuario con categoría suficiente a la extensión deseada.
== Como crear un grupo de captura y que se vea en cada teléfono el número que llama ==

'''ATENCIÓN: SE CREAN CONFIGURACIONES NO REFLEJADAS EN PORTAL DE ADMINISTRACIÓN'''

Para la simulación de grupos de captura y conseguir que todos los terminales vean el ANI del llamante:

- Hacen falta teléfonos con dos líneas

- Cada teléfono del grupo tiene en la línea 1 su extensión habitual (por ejemplo 40000)

- Además, en el fichero "sip_Estatico.conf", creamos una segunda extensión para cada teléfono, que le ocupará la segunda línea (por ejemplo 42000)

- En esta segunda linea ponemos que cuando se llame tenga otro tono de llamada (un beep o nada...) que se asemeje en funcionamiento al de un mensaje de llamada en otra extension de mi grupo de captura

- Se ha creado una variable global por cada teléfono en el fichero de variables "ext_MDtel_Particular.conf" de nombre EXTxxxxx (por ejemplo EXT40000); esa variable contiene las otras extensiones virtuales del grupo
por ejemplo EXT40000=>SIP/42001&SIP/42005

- Hemos creado en el dialplan programación para que cuando exista esa variable global se añada a la marcación el contenido

== Como crear supletorios ==

'''ATENCIÓN: SE CREAN CONFIGURACIONES NO REFLEJADAS EN PORTAL DE ADMINISTRACIÓN'''

Igual que el caso anterior pero en la variable ponemos números reales. Debido a un bug en el enrutador, que no devuelve la variable R_PARA, en el fichero ext_MARCAR_Extension.conf hay que sustituir la siguiente linea:

;same => n,ExecIf($["${EXT${R_PARA}}"=""]?NoOp:Set(ENR_CADMARCAR=${ENR_CADMARCAR}&${EXT${R_PARA}}))
Por esta otra:
same => n,ExecIf($["${EXT${R_DEST_${ENR_RUTA_CAD}}}"=""]?NoOp:Set(ENR_CADMARCAR=${ENR_CADMARCAR}&${EXT${R_DEST_${ENR_RUTA_CAD}}}))
ATENCIÓN !!! en las llamadas salientes cada uno presenta su número

Para emplear números externos en los supletorios hay que poner, al crear la variable que hemos explicado en el apartado anterior en el ext_MDtel_Particular.conf:

EXT335=>SIP/0999999999@Trunk_Movil ;En este caso suena en la ext 335 y en el móvil 999999999

== Generación de llamada automática ==

Para activar la funcionalidad es necesario lo siguiente:

* Definir una variable ID_LISTA_LLAMAME con el ID de la lista que se va a usar para generar la llamada. Cuando se cree la lista hay que asegurarse que el campo "Nº segundos límite" tiene un valor lo suficientemente amplio para evitar que la llamada caduque antes de ejecutarse.

* Establecer un timeout para la cola (en el Gosub Cen_Sub_GrupoACD se indica justo después de ${COLA})

* Llamar a la función de MySQL ACD_FUNC_LLAMAME_CREAR a través de MDintz

* En la función se usan los siguientes elementos variables:

${ID_LISTA_LLAMAME}: Definida antes clienteTOCola:
Nombre del cliente. Al no tener ningún nombre, se usa un denominador genérico
${CALLERID}: Número llamante, donde se dirigirá la llamada.

Ejemplo:

[Cen_VDN_99001]
;----------------------------------------------------------------------------------------------------------------
;----------------------- VDN 99001 ------------------------------------------------------------
;----------------------------------------------------------------------------------------------------------------
exten => _X.,1,NoOp(MDENTGW_99001*****EXTEN=${EXTEN}**CID=${CALLERID(NUM)}**UCID=${UCID}*)
same => n,Set(__COLA=89001)
same => n,Set(ctiDiriTrato=0)
same => n,Set(ctiDiriInterface=)
same => n,Set(ID_LISTA_LLAMAME=2)
same => n(cola),Gosub(Cen_Sub_GrupoACD,${EXTEN},1(${COLA},10,,Si,))
same => n,GotoIf($["${QUEUESTATUS}"!="TIMEOUT"]?colgar)
same => n,MDintz(nimitz|bd|sqlDato|select ACD_FUNC_LLAMAME_CREAR(CURRENT_TIMESTAMP\,${ID_LISTA_LLAMAME}\,""\,"clienteTOCola"\,""\,""\,""\,""\,""\,""\,""\,""\,1\,""\,"${CALLERID(NUM)}"\,1\,3\,1\,""\,0\,0\,0\,""\,""\,""\,""))
same => n,GotoIf($["${MDintzRes}"="OK"]?colgar)
same => n,NoOp(ACD_FUNC_LLAMAME_CREAR ${MDintzRes})
same => n(colgar),Hangup

== Cancelación de eco en la plataforma ==

Comprobar que el chan_dahdi.conf este configurado los parametros:
echocancel=yes
echocancelwhenbridged=yes
Jugar con los valores txgain y rxgain

Si esto no es suficiente el siguiente paso sería emplear una canceladora de echo por hardware.

== Como "dar paso" a través de un enlace exterior si hay una llamada para una extensión creada en el sistema pero no registrada ==

Este procedimiento es de utilidad en procesos de migración, en los que recibimos las llamadas de la RTC, nos las quedamos si la extensión ya está registrada en VIVAit y la mandamos hacia la plataforma a migrar si aún sigue migrada ahí

El procedimiento es:
* Activar desvío por no contesta en la extensión (portal de administración - VIVAit Call - Dispositivos - Extensiones - campo "Desvio no contesta", indicando como destino un prefijo (por ejemplo "99") seguido de la extensión destino

* Creamos una preruta en vivait-call - rutas -prerutas con origen "99", le quitamos el prefijo en campo "Destino saliente 1" (valor -2) e indicamos en campo "Tipo destino sal. 1" como "Ruta externa"

* Debera existir una ruta externa para esa numeración

== Comprobación de versiones de elementos de la plataforma ==

'''Aplicaciones'''
:* Botón derecho del ratón, Acerca De

'''Portales'''
:* En el Vivait-Call, en la pantalla de inicio de sesión pone el número de versión del portal.
:* Tanto en el Monitor como en el Tracker no se puede saber.

'''Demonios'''
:* Mediante el comando nc localhost <Puerto demonio>. Ejemplo:
::nc localhost 1120
::motorSal sis ver='03.02.00' inic='20150427 123457' alarmas=0 ultAlar='00000000000000'
::motorSal gmp msj=253/256 buf=256/256 tarea=99/102
::motorSal tmp uptime=12624 (0d 3h 30m 24s)
::motorSal mtr mys=1 ocup=0% planif=13(0) intento=11(0)

::Ejemplos puertos demonios:
:::*1111: vivait-cti
:::*1112: myAcdSuperv
:::*1113: recordNodo
:::*1114: recordCentral
:::*1115: intz-nimitz
:::*1120: motorSal
:::*1123: phoneprov-tftp

'''Base de datos'''
:* No se puede saber la versión a no ser que se comparen esquemáticos con los subidos en el redmine

[[Category:tecnico]]
[[Category:administrador]]
[[Category:VIVAit Call]]
[[Category:VIVAit Suite]]
[[Category:VIVAit Fax]]

== Añadir Auto-Answer a la cabecera SIP ==

Si queremos que un teléfono tenga autoanswer:
* En el peer poner: headeraa=Call-Info: answer-after=0, esto tiene que ir en la plantilla de la extensión o como campo en la extensión. Dependiendo del terminal que utilicemos el valor de este campo variará:

Aastra: Alert-Info: info=alert-autoanswer
Grandstream: Call-Info: answer-after=0
Linksys: Call-Info:\;Answer-After=0
Polycom: Alert-Info: Ring Answer
Snom: Call-Info: answer-after=0
Snom (nuevo firmware): Call-Info: <sip:IP>\;answer-after=0
Yealink: Call-Info: answer-after=0

* Luego en el diaplan añadir lo siguiente: exten => _[*#%0-9a-zA-Z].,n,set(__AutoAnswer=AA) (Esto tendremos que ver como ponerlo de manera automática). De manera provisional si queremos que sea para llamadas salientes pondremos esto en el ext_n_marcador.conf. Si queremos que sea llamadas entrantes lo pondremos en ext_n_MARCAR.conf

== Configuración de los portales web en HTTPS ==

Desde /usr/lib/jvm/default-java/bin/ ejecutamos:

keytool -genkey -alias tomcat -keyalg RSA -keystore /usr/share/tomcat7/.keystore

Escriba la contraseña del almacén de claves: (t0mc4t)
Volver a escribir la contraseña nueva: (t0mc4t)
*Personalizar para el cliente
¿Cuáles son su nombre y su apellido?
[Unknown]: VIVAit Suite
¿Cuál es el nombre de su unidad de organización?
[Unknown]: Desarrollo
¿Cuál es el nombre de su organización?
[Unknown]: MDtel
¿Cuál es el nombre de su ciudad o localidad?
[Unknown]: Madrid
¿Cuál es el nombre de su estado o provincia?
[Unknown]: Madrid
¿Cuál es el código de país de dos letras de la unidad?
[Unknown]: es
¿Es correcto CN=VIVAit Suite, OU=Desarrollo, O=MDtel, L=es, ST=Madrid,
C=Unknown?
[no]: si
Escriba la contraseña clave para <tomcat>
(INTRO si es la misma contraseña que la del almacén de claves)

nano /var/lib/tomcat7/conf/server.xml

Descomentar la línea:

<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"

maxThreads="150" scheme="https" secure="true"

clientAuth="false" sslProtocol="TLS"/>

Añadir después de sslProtocol="TLS":

keystorePass="t0mc4t"

== Crear un motivo desconexión para el Supervisor en '''''VIVA'''''it Suite==

Para crear motivos de desconexión adicionales a los que ya ofrece la aplicación tendremos que añadir una nueva entrada en la BD. El comando que emplearíamos seria el siguiente:

INSERT INTO `nimitz`.`COM_ENUMERADOS` (`ID`, `C_NOMBRE`, `C_TEXTO`, `N_POSICION`, `C_OBSERV`) VALUES(1000700, 'TSesAgMotDesc', 'Nombre Motivo de desconexión', 60, ' ');

El ID debe ser mayor o igual a 1000700 y menor a 1000800. El N_POSICION debe ser mayor o igual a 60 y menor que 100.

== Envío de variables CTI al ACD ante un GW con asterisk 13==
Dado que para un GW con asterisk 13 un nodo ACD es considerado un elemento externo, por defecto, no se envían variables CTI (UCID, ...). En una fututa versión del nodo ACD, ya no se considerará un elemento externo por lo que si se enviarán dichas variables. Para lograrlo en la versión 3.0 de la plataforma Vivait hay que modificar el fichero ext_MARCAR_Externo_Particular.conf del GW. Deberemos poner la siguiente linea.

same => n,Macro(escribirDatosCti)

== Script para cambio automático de claves en salas de conferencia estáticas ==

Para cambiar la clave de las salas de conferencias crear un script llamado cambioClaveConfe.sh con el siguiente contenido:

#!/bin/bash
CLAVE=$(shuf -i 1111-9999 -n 1)

echo $CLAVE

echo "update CEN_SALAS_CONFERENCIAS set C_PIN='$CLAVE' WHERE C_NOMBRE='$1'" | mysql -u nimitz -pivivanimitz nimitz

FROM=sat@mdtel.es
FECHA=`date +"%Y%m%d%H%M%S"`
CLIENTE=<PONER EL CLIENTE>
TO=<DESTINATARIOS>
ASUNTO="Nueva clave en sala $1"
CUERPO="La nueva clave para la sala $1 es: $CLAVE"
/usr/sbin/sendmail -oi -t -v -f $FROM <<EOF
From: $FROM
To: $TO
Bcc: $BCC
Subject: $ASUNTO

$CUERPO
EOF

El script cambiará la clave de la sala pasada por parámetro por una aleatoria de 4 dígitos y la enviará por correo a los <DESTINATARIOS> (direcciones de correo electrónico separadas por coma).

Hay que crear una tarea en /etc/crontab añadiendo una linea como la siguiente:
30 6 * * 7 root cambioClaveConfe.sh 6173

Esto ejecutará el script todos los domingos a las 6:30 horas cambiando la clave de la sala 6173. Añadir tantas linéas como salas.

==ZABBIX ==

=== Como crear un TRIGGER en Zabbix ===

'''1.''' Hay '''dos posibilidades''' dependiendo si el trigger es para un solo host o es para varios, los cuales tienen en común un template:

:# Si es para ''un host'': Ir a '''Configuración/Hosts'''
:# Si es para ''un template'': Ir a '''Configuración/Templates'''

'''2.''' En la fila correspondiente al host/template al que queramos añadirle el trigger, pulsar sobre la '''columna triggers.''' 
'''3.''' En la ventana de triggers, pulsar sobre el botón '''Create trigger''', situado en la esquina superior derecha. 
'''4.''' Aparecerá la ventana de creación de triggers, que tiene los siguientes campos:
:1. '''Name:''' Nombre del trigger, que deberá ser lo ''suficientemente descriptivo''. Aparecerá cuando se
active, en la ventana principal de Zabbix así como en los correos de aviso.
:2. '''Expression:''' Define la fórmula cuyo resultado activará el trigger. Hay que pulsar el botón '''Add'''. Se mostrará una
nueva ventana donde habrá que elegir el item (medida) sobre el que se basará el trigger (evidentemente la medida deberá
existir previamente) y la función necesaria para el cálculo. Para una descripción de las disponibles dirigirse a
https://www.zabbix.com/documentation/2.2/manual/appendix/triggers/functions. 
Tras rellenar los campos anteriores y dar a la función los valores que necesite pulsar el botón '''Insert.'''
:3. '''Expression constructor:''' Permite crear expresiones complejas, uniendo varias.
:4. '''Description:''' Una explicación del trigger
:5. '''Severity:''' Criticidad el trigger
:6. Para una descripción del resto de campos visitar la página: https://www.zabbix.com/documentation/2.2/manual/config/triggers/trigger
'''5.''' Tras rellenar los campos, pulsar el botón '''Save'''. 
'''6.''' Si el trigger se ha añadido en un template, aparecerá en todos los hosts que tienen el template configurado. 
'''7.''' '''El trigger por si solo no envía ningún aviso''', solo se activa si se cumple la expresión definida.
Para enviar un aviso (normalmente un correo electrónico) cuando se active el trigger, será necesario definir una acción (Configuración/Actions).

'''NOTA.-''' Para consultar cualquier cuestión relativa a Zabbix, se encuentra a su disposición el manual: 
https://www.zabbix.com/documentation/2.2/manual

=== Monitorización en Zabbix de un trunk caído ===
Para monitorizar un o varios trunk por separado y saber el estado de cada uno es necesario lo siguiente:

*Añadir el UserParameter adjunto que contiene el siguiente texto:

UserParameter=asterisk.trunkEstado[*],sudo /usr/sbin/asterisk -rx 'sip show peers' | grep --text -i '$1' | grep OK >/dev/null; if [ $? -eq 0 ]; then echo 1; else echo 0; fi

*Añadir en el portal de zabbix un item por cada trunk. En el campo Key se pondrá "asterisk.trunkEstado[nombre_trunk]", donde nombre_trunk es el nombre del trunk tal y como se ve en Asterisk.
[[File:zabbix_item_trunkEstado.png]]

*Crear un trigger que avise cuando el último valor sea 0. Por ejemplo:
{corp-bdtr:asterisk.trunkEstado[PrePro-ACD].last()}=0

[[File:zabbix_trigger_trunkEstado.png]]

== Agendas en terminales Yealink ==
En la agenda se mostrará como nombre lo que contenga el campo CEN_AGENDAS.C_NOMBRE_MOSTRAR y como teléfono el indicado en CEN_AGENDAS_TELEFONOS.C_TELEFONO
Para hacer funcionar la agenda:

*En el archivo de aprovisionamiento correspondiente (Yealink-XXXX-comun.cfg) establecer los siguientes parámetros:

remote_phonebook.data.1.url = http://<direc IP>/vivait-agenda/yealink/contactData1.xml
remote_phonebook.data.1.name = NOMBRE DE LA AGENDA EN EL TELEFONO

*En el archivo /etc/apache2/apache2.conf añadir tras el último Directory:

<Directory /var/www/html/vivait-agenda/>
AddType application/x-httpd-php .xml
Options Indexes FollowSymLinks MultiViews
AllowOverride None
Order allow,deny
allow from all
</Directory>

*Ejecutar el comando:

/etc/init.d/apache2 reload

== Calendarios ==

=== Enrutamiento inteligente ===

Ante una llamada a un destino, si hay cita de ocupado en el calendario se desvia al número indicado en el campo "location" del calendario o a su buzon de voz si hay valor en dicho campo

same => n,Set(CalendarBusy=${CALENDAR_BUSY(GoogleCalendar)})
same => n,Set(id=${CALENDAR_QUERY(GoogleCalendar)})
same => n,NoOP(hay ${CALENDAR_QUERY_RESULT(${id},getnum)} eventos)
same => n,Verbose(3,The state of GoogleCalendar is $
{DEVICE_STATE(Calendar:GoogleCalendar)})
same => n,Set(CalendarLocation=${CALENDAR_QUERY_RESULT(GoogleCalendar,location)})
same => n,GotoIf($["${CalendarBusy}"=="1"]?:conCategoria)
same => n,GotoIf($["${CalendarLocation}"==""]?buzon)
same => n,Goto(Cen_iniLlam,${CalendarLocation},1)
same => n(buzon),Playback(Particular/buzon)
same => n,Hangup
same=> n(conCategoria),Goto(Cen_iniLlam,${EXTEN},1)

=== Conexión de cliente Outlook a calendarios VIVAit mediante Caldav===
Por defecto, el cliente outlook no soporta Caldav; si queremos disponer de calendarios de VIVAit en Outlook tendríamos dos opciones:
# Tener los calendarios en el servidor Exchange
# Instalar un plugin en el cliente outlook que permita conectar vía Caldav los calendarios que estén ubicados en el servidor de calendarios de VIVAit

Este howto se centra en esta segunda posibilidad

Procedimiento:

1.- Instalar Calldavsincronizer (valdrían otros plugin de Caldav para Outlook)

[https://sourceforge.net/projects/outlookcaldavsynchronizer/ https://sourceforge.net/projects/outlookcaldavsynchronizer/]

2.- Entrar en Synchronization Profiles en la nueva pestaña Calldav Syncronizer de outlook [[File:Syncronizer.png]]

3.- Añadir nuevo perfil (tecla +)

[[File:Nuevo.png|center|600px]]

A tener en cuenta:

*Crear un nuevo “Outlook folder”, entendemos que es adecuado (quizás necesario) para que las entradas de calendario de VIVAit queden diferenciadas.
*Lo mejor es haber creado antes el calendario en el servidor para que al darlo de alta en oulook comprobemos que se conecta.
*Dando al botón “Test or discover settings” se nos muestran todos los calendarios del servidor y elegimos el que queramos; en “elementos de la carpeta” diremos “elementos de calendario”.

[[File:Calendario.png|center|800px]]

== Uso de reloj hardware en nodos de procesamiento ==

=== En nodo de procesamiento ACD ===
En un nodo de procesamiento ACD es obligatorio instalar dahdi y una tarjeta de primario para emplear reloj hardware, ya que el reloj software que va en el asterisk 1.4 es defectuoso.
Para configurarlo basta con instalar la tarjeta en el servidor, instalar dahdi y posteriormente ejecutar el siguiente comando:

dahdi_cfg

Este comando generaŕa el fichero /etc/dahdi/system.conf

Para comprobar que el comando se ha ejecutado satisfactoriamente lo abriremos y tendrá que tener un formato semejante al siguiente ejemplo:

# Autogenerated by /usr/sbin/dahdi_genconf on Tue Oct 22 17:42:59 2013
# If you edit this file and execute /usr/sbin/dahdi_genconf again,
# your manual changes will be LOST.
# Dahdi Configuration File
#
# This file is parsed by the Dahdi Configurator, dahdi_cfg
#
# Span 1: WCT1/0 "Digium Wildcard TE110P T1/E1 Card 0" HDB3/CCS/CRC4
span=1,1,0,ccs,hdb3,crc4
# termtype: te
bchan=1-15,17-31
dchan=16
echocanceller=oslec,1-15,17-31
# Global data
loadzone = es
defaultzone = es

=== En nodo de procesamiento de corporativa ===
En un nodo de procesamiento de corporativa no obligatorio instalar dahdi y una tarjeta de primario para emplear reloj hardware, ya que el no se han detectado errores en el reloj por software. Sin embargo si instalamos dahdi y una tarjeta de primario para emplear reloj hardware, el sistema funcionará mejor.
Para configurarlo basta con instalar la tarjeta en el servidor, instalar dahdi y posteriormente ejecutar el siguiente comando:

dahdi_cfg

Este comando generaŕa el fichero /etc/dahdi/system.conf

Para comprobar que el comando se ha ejecutado satisfactoriamente lo abriremos y tendrá que tener un formato semejante al siguiente ejemplo:

# Autogenerated by /usr/sbin/dahdi_genconf on Tue Oct 22 17:42:59 2013
# If you edit this file and execute /usr/sbin/dahdi_genconf again,
# your manual changes will be LOST.
# Dahdi Configuration File
#
# This file is parsed by the Dahdi Configurator, dahdi_cfg
#
# Span 1: WCT1/0 "Digium Wildcard TE110P T1/E1 Card 0" HDB3/CCS/CRC4
span=1,1,0,ccs,hdb3,crc4
# termtype: te
bchan=1-15,17-31
dchan=16
echocanceller=oslec,1-15,17-31
# Global data
loadzone = es
defaultzone = es

== Aprovisionamiento terminales Cisco ==
=== Configurar protocolo SIP TCP o UDP en terminal Cisco ===

Configuración de terminal Cisco para para funcionar bajo TCP o UDP:
Modificar parámetro
<transportLayerProtocol>X</transportLayerProtocol>

Donde X es:
1: TCP
2: UDP
4: Valor por defecto del firmware (al menos en la última versión equivale a TCP)

=== Habilitar/Deshabilitar llamada en espera en terminales Cisco ===

En el fichero de aprovisionamiento del terminal añadiremos la siguiente linea
<callWaiting>X</callWaiting>

Donde X es:
0=off but can be changed through the settings menu.
1=on but can be changed through the settings menu.
2=off and locked so it can't be changed through the settings menu.
3=on and locked so it can't be changed through the settings menu.

== Como configurar servicio DHCP en Ubuntu Linux ==
'''¿Que es un servicio DHCP?'''

Un servidor Dynamic Host Configuration Protocol (DHCP) asigna dinámicamente las direcciones IP y otras configuraciones de red a otros terminales que están conectados a la red.

'''Instalar un servicio DHCP'''

Para instalar el servidor de asignacion automatica de direccion IP ejecutamos el comando:
sudo apt-get install isc-dhcp-server

'''Configurando el servicio DHCP'''

Editamos el archivo /etc/dhcp/dhcpd.conf creando primero un backup del mismo:
mv /etc/dhcp/dhcpd.conf /etc/dhcp/dhcpd.conf.original
nano /etc/dhcp/dhcpd.conf

El archivo debe quedar de una forma muy similar a esta:
authoritative
subnet 10.254.239.0 netmask 255.255.255.254
{
range dynamic-bootp 10.254.239.40 10.254.239.60;
option domain-name-servers ns1.example.org, ns2.example.org;
option domain-name "example.org";
option routers rtr-239-0-1.example.org, rtr-239-0-2.example.org ;
option broadcast-address 10.254.239.255;
default-lease-time 3600;
max-lease-time 7200;
option option-150 10.254.239.25
}

Donde los campos:
*subnet: Direccion de red
*netmask: Máscara de red
*range dynamic-bootp: Rango de IPs que va a proporcionar el DHCP
*option domain-name-servers: Direcciones IPs de los DNS
*option domain-name: Nombre de dominio
*option routers:IPs de las puertas de enlace
*option broadcast-address: Dirección de broadcast
*default-lease-time: Tiempo de concesión por defecto
*max-lease-time: Valor máximo del tiempo de concesión
*option option-150: IPs de los servidores TFTPs que tiene la red

'''Reiniciamos el servicio'''

service isc-dhcp-server restart

'''Direcciones IP estáticas basadas en la MAC'''

Pueden conocerse las MAC de las máquinas conectadas a la red ejecutando el comando arp desde la terminal.

host ejemplo {
hardware ethernet 00:0B:82:19:A8:04;
option option-150 10.254.239.0;
# fixed-address 10.254.239.52;
}

== Protocolo Skinny en VIVAit Call mediante uso de Chan-SCCP ==
'''Instalación de chan_sccp'''

*Copiar el fichero chan-sccp-4.2.1.1.tar.gz en el directorio donde estén los fuentes de Asterisk (normalmente /usr/src/MDtel)
*Descomprimir
*Entrar al directorio chan-sccp-4.2.1.1
*Ejecutar: ./configure --with-asterisk=../DIRECTORIO_ASTERISK --enable-conference. Donde DIRECTORIO_ASTERISK es el nombre del directorio donde están los fuentes de asterisk.
*Tras el ejecutar el configure (si todo va bien al final se verá un resumen con el S.O, arquitectura, etc), ejecutar make y make install
*El nuevo módulo chan_sccp.so se generará dentro del DIRECTORIO_ASTERISK en lib/asterisk/modules/ y se deberá copiar en /usr/lib/asterisk/modules/
*Copiar el fichero sccp.conf a /etc/asterisk
*Entra a Asterisk y ejecutar: module load chan_sccp.so
*Si se ha cargado correctamente, desde dentro de Asterisk, si se teclea sccp show version deberá devolver: "Skinny Client Control Protocol (SCCP). Release: 4.3.0 4.3.0 - unknown (built by 'root' on '2016-06-01 10:42:32 UTC')"

'''Crear extensiones'''

*En el portal crear una nueva clase de dispositivo (Vivait-Call/Dispositivos/Clases de dispositivos), donde la clase sea extensión la subclase H323 (todavía no existe la subclase SCCP) y el formato SCCP/${DEST}
*Crear la nueva extensión, pero el dispositivo debe ser el creado en el campo anterior.
*Las extensiones creadas habrá que añadirlas al fichero sccp.conf así como los teléfonos que las usarán. En el fichero sccp.conf incluido hay ejemplos.

'''Aprovisionamiento'''
Los terminales se aprovisionan de la misma manera que los SIP, exceptuando que las plantillas XML no tiene referencias a SIP. Se incluye un xml genérico con todas las opciones.
Dentro del directorio chan-sccp-4.2.1.1 hay un directorio conf con todos los archivos de configuración necesarios. Las versiones annotated contienen todas las opciones posibles comentadas.

== Instalación y configuración Postfix en RedHat7 ==

'''Postfix''' es un ''servidor de correo'' de software libre/código abierto, un programa informático para el enrutamiento y envío de correo electrónico.

'''Instalación'''

yum install postfix

'''Configuración'''

Sobre la configuración de postfix por defecto (recién instalado):
Editar el fichero /etc/postfix/main.cf
inet_protocols = ipv4
relayhost = smtp.renfe.es
Revisar la configuración:
postfix check
Configurar postfix como servicio (sólo en redhat y similares)
chkconfig postfix on
Iniciar postfix:
service postfix start
Instalar mailx para disponer de los comandos mail y sendmail:
yum install mailx
Probar configuración:
echo "Prueba de correo" | mail -vs "Prueba" correo@destino.soy

== FOP2 ==

=== Como mostrar callername queues FOP2 ===

Es necesario añadir el siguiente código al contexto de entrada:

exten => _X.,n,MYSQL(Connect connid localhost usuario clave bd)
exten => _X.,n,MYSQL(Query resultid ${connid} SELECT\ firstname\,lastname\ from\ fop2\ where\ phone1=${CALLERID(num)}\ OR\ phone2=${CALLERID(num)})
exten => _X.,n,MYSQL(Fetch fetchid ${resultid} nombre apellidos)
exten => _X.,n,GotoIf($[${fetchid} = 1]?:noExiste)
exten => _X.,n,Set(CALLERID(name)=${nombre}${apellidos})
exten => _X.,n(noExiste),Continuar

En la primera línea cambiar según lo necesario:

*localhost: Dirección IP del servidor de MySQL donde está la BBDD de FOP2
*usuario: Usuario con permisos de acceso a la bbdd de FOP2
*clave: Clave del usuario
*bd: Nombre de la BBDD

=== FOP2. Problemas en transferencias asistidas ===

Para habilitar la transferencia atendida del asterisk (funcion atxfer), hay que poner la opción tT en el queue() si la llamada origen
la realiza a una cola o al dial() de las extensiones.
Con eso vemos como al intentar hacer la llamada de consulta ya se va a nuestro dialplan. Sin embargo la llamada no funciona ya que
el enrutador nos da error de enrutamiento porque no tenemos ID_DISPOSITIVO origen ya que el fop no es un elemento creado desde el portal.
Por lo que se propone como solución crear un contexto de inicio del fop y asignarle un ID_DISPOSITIVO para que así se enrute la llamada.
El contexto tienen que ser similar a ext_InicioLlamada_Chrome.conf

Para que funcione las transferencias supervisadas desde el fop2 hay que realizar lo siguiente:

*El usuario del manager debe tener permisos Atxfer para poder realizar transferencias.
*Habilitar la transferencia atxfer en el fuatures.conf del asterisk. atxfer => *2
*Crear el fichero ext_InicioLlamada_FOP.conf con el siguiente contenido:

[Cen_Inicio_FOP]
exten => [*#%0-9].,1,NoOp(MDINICHR**EXTEN=${EXTEN}**CID=${CHROME_ANI}*)
same => n,dumpchan()
;same => n,Set(CALLERID=${CHROME_ANI})
same => n,Gosub(Cen_Sub_getIdExtension,s,1(${R_CID_NUM_00}))
same => n,ExecIf($["${GOSUB_RETVAL}"!="OK" | "${sqlDato}"=""]?HangUp)
same => n,Set(ID_DISPOSITIVO=${sqlDato})
; . Modificar MARCAR en funcion de reglas de marcacion saliente (prefijo 0, ...)
; Esto se modificara en el contexto Cen_Inicio_Chrome_Particular
same => n,Set(MARCAR=${EXTEN})
;---------------------------------

;--- Llamada a contexto particular
;---------------------------------
; Esta llamada es para hacer cosas especificas del cliente (cambiar callerid...)
; La subrutina Cen_Inicio_Chrome_Particular esta en el archivo ext_InicioLlamada_Chrome_Particular.conf
; Si no existe el archivo copiar el archivo ext_InicioLlamada_Chrome_Particular.conf.ejemplo como ext_Inicio_Chrome_Particular.conf
; y realizar las modificaciones necesarias
; El fichero ext_InicioLlamada_Chrome_Particular.conf se carga automaticamente al ser creado con el include de ext_InicioLlamada.conf
; #include "ext_InicioLlamada*.conf"
;
same => n,GosubIf($[${DIALPLAN_EXISTS(Cen_Inicio_FOP_Particular,${EXTEN},1)}>0]?Cen_Inicio_FOP_Particular,${EXTEN},1)
same => n,Goto(Cen_Inicio_SIP,${MARCAR},1)

*En el fichero /usr/local/fop2/buttons.cfg poner como contexto de las extensiones el creado anteriormente (Cen_Inicio_FOP)
*Modificar el fichero /usr/local/fop2/fop2.cfg:

blind_transfer = 0
supervised_transfer = 1

Para realizar la transferencia con consulta, hay que pulsar el supervised transfer del FOP2 y una vez se haya establecido la llamada, seleccionar la extensión que "sobra" en la conversación y pulsar la tecla de hangup y colgar la llamada.

== Como ver los directorios de un NAS a montar con NFS ==

Con el siguiente comando vemos los diferentes volúmenes de un NAS:

showmount -e IP_NAS

Ejemplo de salida:

Export list for 192.168.10.10:
/Backup/backup *
/DISCOS_1/VOL1_AUDIO *

== Instalación de ActivaSTP con VIVAit Call 3 y marcación desde Outlook ==

Instalamos ActivaSTP desde:

(http://activa.sourceforge.net/)



La configuración necesaria se muestra en la siguiente imagen:

[[File:Ventana ActivaTSP.jpg]]

El usuario del manager debe tener permisos originate para poder realizar llamadas.

Se han realizado pruebas con Outlook 2013.

Se ha comprobado la correcta realización de pruebas utilizando ActivaSTP, realizadon llamadas desde la pestaña "personas" con la vista en modo tarjeta de Pesentación, tarjeta, teléfono o lista.

Outlook 2013 no da la opción de llamar si la vista está en modo personas.

== Como volver a procesar grabaciones con error ==

Las grabaciones con error son aquellas que tienen el valor E_GRABACION=120 en la tabla DAT_GRABACIONES.

Las grabaciones con error se producen normalmente por la pérdida de conexión entre el nodo servidor de grabaciones y el resto.

Para reprocesar la grabación hay que modificar el campo E_GRABACION de la tabla DAT_GRABACIONES y ponerlo con valor 20 para que así el recordCentral la vuelva a procesar.



== Como borrar contenido de la tabla BDTR con el script borraRegistrosNimitz.pl ==

Este script se ejecuta mediante una tarea del crontab, tal como la siguiente:

SHELL=/bin/sh
PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
# m h dom mon dow user command
00 01 * * * root /usr/local/sbin/borraRegistrosNimitz.pl --hDB localhost

Para establecer el número de días que vamos a dejar en la base de datos debemos editar el archivo borraRegistrosNimitz.pl, el campo my $numDias.

== Ocasionalmente No saltan los formularios en '''VIVAit Suite''' cuando existen marcadores ==
En los sistemas con marcadores, se ha observado que, en un porcentaje muy bajo, cuando entra una llamada a un agente no se presenta el formulario.
En una traza del vivait-desk se pudo comprobar que no había eventos CTI de la llamada, pero telefónicamente la llamada si quedaba establecida.

El problema viene ocasionado porque el CTI tiene auditorías para descartar llamadas,evitando que se queden enganchadas.

Una de esas auditorías es el tiempo máximo de las llamadas no contestadas.

El marcador tiene puesto a fuego que el tiempo que permanece una llamada en cola a la espera de un agente libre es de 10 minutos.

Hay que poner el tiempo de auditoría en un valor superior (por ejemplo 12 minutos)

En el archivo de configuración '''vivait-cti.conf'''

audit_call_minutNoContestada = 12

El paŕametro audit_call_minutContestada, es el tiempo que el cti "conserva" una llamada, dado que el dialplan tiene puesto el timeout absolute a 7200 (120 minutos), deberiamos modificar este parámetro para que esté sincronizado

audit_call_minutContestada = 120

Estos cambios se implementarán en el instalador de la próxima versión.

== Generación de un Core ==
Un Core es la memoria de un programa.

Para generar un Core rápido con Asterisk hay que hacer lo siguiente:

Ejecutar ps aux | grep asterisk y coger el PID del programa
gdb /usr/sbin/asterisk [PID]
gcore [file]

== Activación de la movilidad para un usuario ==

Una vez configurada la movilidad e intentar activarla nos da error cuando le ponemos el usuario y la contraseña.

La configuración del usuario es la siguiente:

[[File:Problema.jpg|center]]

Para que la movilidad funcione hay que asignar un teléfono a la extensión, quedando la configuración de esta manera:

[[File:Asignacion_de_telefono.jpg|center]]

== Como se muestra el número llamante en transferencia desde operadora ==
Para tener el número ANI en las transferencias con consulta hay que realizar lo siguiente:
Copiar el archivo adjunto (app_esConsulta.c) en el directorio apps de Asterisk (normalmente /usr/src/vivait-call/asterisk/apps).
Situarse en el directorio raiz de Asterisk (normalmente /usr/src/vivait-call/asterisk/).
Compilar: make
Instalar: make install
Habilitar el nuevo módulo: asterisk -rx 'module load app_esConsulta.so'
Si la carga del módulo no funcionara, hay que el reiniciar Asterisk para que cargue el módulo.

Posteriormente modificar el fichero ext_Enrutador_Particular.conf de la siguiente forma:

[Cen_Enrutador_Particular]
exten => [*#%0-9].,1,NoOp(MDENRUPAR**EXTEN=${EXTEN}**CID=${CALLERID(NUM)}*)
same => n,NoOp(calleridAntes=${CALLERID(num)})
same => n,esConsulta
same => n,GotoIf($["${consultaANI}"=""]?noConsulta)
;same => n,Set(CALLERID(name)=\Transfer:${consultaANI}\)
same => n,Set(_R_CID_NUM_00=${consultaANI})
same => n,GotoIf($["${consultaNOM}"=""]?noNom)
;same => n,Set(CALLERID(name)=\Transfer:${consultaNOM}\)
same => n,Set(_R_CID_NAME_00=${consultaNOM})
same => n(noNom),Set(_R_CID_NUM_00=${consultaANI})
same => n,NoOp(callerIDdespues=${CALLERID(num)})
same => n(noConsulta),NoOP(noConsulta)
;same => n,Set(CALLERID(num)=${consultaANI})
same => n,Return

En caso de que ya haya algo añadido en el fichero, hay que analizar en que posición se pondrá el contenido anterior para que no se vea modificado el funcionamiento de la centralita

== Como conseguir que los tonos dtmf no sean regenerados por Asterisk ==

Para que los tonos dtmf no sean regenerados por Asterisk hay que:

cd /usr/src/MDtel/asterisk/apps/
cp /tmp/app_setoption.c .
ls -l app_setoption.c
cd ..
make menuconfig (comprobar que todo está bien)
make (comprobar que compila la nueva app)
make install

EJEMPLO: los tonos dtmf entran por "Trunk_GW_MAQUETAS" y va a la extensión 4175.

Creamos un nuevo contexto por el trunk de entrada que queremos activar esta opción (o lo aplicamos a todos si procede, dependerá de cada instalación)

'''PARA LA ENTRADA:'''
sip_trunkExt_WEB.conf
Trunk_GW_MAQUETAS
context=Cen_Inicio_TrunkSip_Maqueta
dtmfmode=inband
directmedia=no
disallow=all
allow=alaw

ext_InicioLlamada_TrunkSIP_Particular.conf
[Cen_Inicio_TrunkSip_Maqueta]
exten => _X.,1,NoOp(MDINITRUNSIPPAR**EXTEN=${EXTEN}**CID=${CALLERID(NUM)}*)
same => n,SetChannelOption(14,0)
same => n,Goto(Cen_Inicio_TrunkSip,${EXTEN},1)
same => n,Return()

'''PARA LA SALIDA:'''
ext_MARCAR_Extension_Dial.conf
[Cen_Marcar_Extension_Dial_Gosub]
same => n,ExecIf($["${PASARTONOS}"="1"]?SetChannelOption(14,0)) (AÑADIMOS)

sip_WEB.conf
El peer debe tener:
PASARTONOS => 1 ;Variable declarada para el contexto ext_MARCAR_Externo_Dial en la macro
dtmfmode=inband
directmedia=no
disallow=all
allow=alaw

Paramos y arrancamos Asterisk (ya que hemos compilado y aprovechamos para recargar DialPlan)

Para comprobar el funcionamiento:

'''En Asterisk:'''

core set debug 1
Hacer llamada descolgando la misma
core set debug 0

Revisar el log de Asterisk y comprobar que en ambos canales de la llamada aparece "Disabling digit detection" (si no aparece, algo falta por configurar):
chan_sip.c: Disabling digit detection on SIP/4175-00000031
chan_sip.c: Disabling digit detection on SIP/Trunk_GW_MAQUETAS-00000030

== Problemas en la bbdd de replica, tabla COM_COMUNICADOS ==

De forma intermitente en esta tabla se generan registros duplicados y hay que borrar registros y arrancar la Réplica para que todo vuelva a funcionar.

El problema consiste en el el script borraRegistrosNimitz.pl borra la tabla entera, sin tener en cuenta el número de días que queremos dejar de backup; esto provoca que se vuelvan a repetir los índices de la BD.

Hay que modificar el script de la siguiente forma:

dentro de la sentencia elsif($tablas[$i] eq "COM_COMUNICADOS")

Hay que sustituir la sentencia
$query = "DELETE FROM $tablas[$i;

Por esta otra:
$query = "DELETE FROM $tablas[$i] where D_HORA_FIN < DATE_SUB(NOW, INTERVAL $numDias DAY) LIMIT 100";

== Simple_bridge y native_rtp ==

Para ver en que modo de funcionamiento esta la llamada escribiremos el siguiente comando.

homologacion-corp0*CLI> bridge show all
Bridge-ID Chans Type Technology
b40f41e3-0028-46d4-8c7c-34999090680f 2 basic native_rtp

El simple_bridgfe es el peor funcionamiento posible en el asterisk, hay que intentar estar siempre en native_rtp.

El native_rtp tiene dos modos de funcionamiento que se ve al ejecutar el comando siguiente:

homologacion-corp0*CLI> sip show channel 6d7c7a13176fc340180528281d4bcc3a@172.25.128.91:5060
Audio IP: 172.25.129.102 (Outside bridge)

En el campo Auidio Bridge podemos ver el valor Local o Outside bridge. En el modo local no se maneja al el audio por lo que no hay RTP directo entre teléfonos y pasa a través del asterisk, mientras que en modo Outside bridge si que hay rtp directo.

BD.ACD COLAS

2017-10-11T09:39:51Z

Imatarrubias: /* N_PESO_OBJ_SERV */

==Descripción==

Listado de grupos ACD

==Campos==

===ID===
INT NOT NULL AUTO_INCREMENT,
===C_NOMBRE===
VARCHAR(45) NOT NULL COMMENT 'Valor de la extensión de la cola',
===ID_CAMPANNA===
INT NULL COMMENT 'Valor del ID de la campaña asociada a la cola',
===ID_PLANTILLA===
INT NULL COMMENT 'Valor ID de la plantilla asociada a la cola',
===ID_SUPERCOLA===
INT NULL COMMENT 'Valor del ID de la supercola asociada',
===ID_MUSICA_ESPERA===
INT NULL COMMENT 'Valor del ID de la música en espera asociada a la cola',
===ID_NODO===
INT NULL COMMENT 'Valor del ID del equipo donde esta instalado el asterisk',
===C_DESCRIPCION===
VARCHAR(1024) NULL COMMENT 'Descripción de la cola',
===C_NOTAS===
VARCHAR(1024) NULL,
===N_OBJ_SERV===
INT NULL COMMENT 'Objetivo de servicio de la cola. Este valor lo consulta el intz-nimitz por cada llamada que se realiza a la cola',

===N_PESO_OBJ_SERV===
INT NULL COMMENT 'Peso de la cola, a valor más alto, más prioritaria es la cola. Este valor lo consulta el intz-nimitz por cada llamada que se realiza a la cola',

===ID_FORMULARIO===
INT(11) NULL DEFAULT NULL COMMENT 'Valor del ID del formulario asociado a la cola',
===C_ACCION_SAL===
VARCHAR(255) NULL COMMENT 'Campo acción si el formulario es Integrado o Integrado URL',
===N_ACCION_SAL_PAR1===
INT NULL COMMENT 'Valor del primer parámetro del campo acción',
===N_ACCION_SAL_PAR2===
INT NULL COMMENT 'Valor del segundo parámetro del campo acción',
===C_ACCION_SAL_PAR3===
VARCHAR(128) NULL COMMENT 'Valor del tercero parámetro del campo acción',
===C_ACCION_SAL_PAR4===
VARCHAR(128) NULL COMMENT 'Valor del cuarto parámetro del campo acción',
===N_TIEMPO_ADMINISTRATIVO===
INT NULL COMMENT 'Valor del tiempo administrativo de la cola',
===E_TIPO_COLA===
INT NULL

[[BD.ENUM.TTipoCola|TTipoCola]]

===C_CALLERID_SAL===
VARCHAR(45) CHARACTER SET 'utf8' NULL DEFAULT NULL COMMENT '\n',
===C_CALLERID_NAME_SAL===
VARCHAR(45) CHARACTER SET 'utf8' NULL DEFAULT NULL COMMENT '\n',
===B_FINALES_GENERICOS===
TINYINT(1) NULL COMMENT 'Habilitar o no finales genéricos a la cola',
===ID_EJE1===
INT NULL COMMENT 'Eje perteneciente a la cola',
===ID_EJE2===
INT NULL COMMENT 'Eje perteneciente a la cola',
===ID_EJE3===
INT NULL COMMENT 'Eje perteneciente a la cola',
===ID_EJE4===
INT NULL COMMENT 'Eje perteneciente a la cola',
===N_LLAM_SAL_MAX===
INT(11) NULL DEFAULT NULL COMMENT 'Numero maximo de llamadas salientes simultaneas de agentes en colas de marcación saliente ',
===B_AGEN_TMP_ADMIN_NO_DISP===
TINYINT(1) NULL COMMENT 'No permitir tiempo administrativo al agente ',
===ID_ALGORITMO_PREDICTIVO===
INT NULL COMMENT 'Algoritmo predictivo de marcación saliente asociado a la cola',
===N_PARAM1_PREDICTIVO===
INT NULL COMMENT 'Valor del primer parámetro del algoritmo predictivo',
===N_PARAM2_PREDICTIVO===
INT NULL COMMENT 'Valor del segundo parámetro del algoritmo predictivo',
===N_PARAM3_PREDICTIVO===
INT NULL COMMENT 'Valor del tercer parámetro del algoritmo predictivo',
===N_PARAM4_PREDICTIVO===
INT NULL COMMENT 'Valor del cuarto parámetro del algoritmo predictivo',
===N_PARAM5_PREDICTIVO===
INT NULL COMMENT 'Valor del quinto parámetro del algoritmo predictivo',
===N_PARAM6_PREDICTIVO===
INT NULL COMMENT 'Valor del sexto parámetro del algoritmo predictivo',
===N_PARAM7_PREDICTIVO===
INT NULL COMMENT 'Valor del septimo parámetro del algoritmo predictivo',
===N_PARAM8_PREDICTIVO===
INT NULL COMMENT 'Valor del octavo parámetro del algoritmo predictivo',
===C_NOMBRE_COD_CLIENTE===
VARCHAR(45) NULL COMMENT 'Nombre o código del cliente',
===N_WRAPUPTIME===
INT NOT NULL DEFAULT 2 COMMENT 'Parámetro wrapuptime de las colas de asterisk, diferente del tiempo administrativo que lo utiliza el desk',
===E_MODO_GRABACION===
INT NULL

[[BD.ENUM.TModoGrabacion|TModoGrabacion]].

Lo usa vivait-desk y el enrutador para ver si se graba.

===B_GRABAR_SEG_COLA===
TINYINT(1) NOT NULL DEFAULT 0,
===E_ENRU_GRABAR===
TINYINT(1) NOT NULL DEFAULT 0 COMMENT 'TTipoEnruGrabar',
===C_NOMBRE_MOSTRAR===
VARCHAR(45) NULL,
===ID_CATEGORIA===
INT NULL,
===ID_INFORME_CALIDAD===
INT NULL

ID dela tabla de informes de calidad. [[BD.ACD_INFORMES_CALIDAD|ACD_INFORMES_CALIDAD]]

===B_NO_USAR===
TINYINT(1) NOT NULL DEFAULT 0 COMMENT 'Habilitar o no el uso de la cola',

==índices==

PRIMARY KEY (`ID`),
INDEX `IDX_NOMBRE` (`C_NOMBRE` ASC)

==índices réplica==

BD.ACD COLAS

2017-10-11T09:39:40Z

Imatarrubias: /* N_OBJ_SERV */

==Descripción==

Listado de grupos ACD

==Campos==

===ID===
INT NOT NULL AUTO_INCREMENT,
===C_NOMBRE===
VARCHAR(45) NOT NULL COMMENT 'Valor de la extensión de la cola',
===ID_CAMPANNA===
INT NULL COMMENT 'Valor del ID de la campaña asociada a la cola',
===ID_PLANTILLA===
INT NULL COMMENT 'Valor ID de la plantilla asociada a la cola',
===ID_SUPERCOLA===
INT NULL COMMENT 'Valor del ID de la supercola asociada',
===ID_MUSICA_ESPERA===
INT NULL COMMENT 'Valor del ID de la música en espera asociada a la cola',
===ID_NODO===
INT NULL COMMENT 'Valor del ID del equipo donde esta instalado el asterisk',
===C_DESCRIPCION===
VARCHAR(1024) NULL COMMENT 'Descripción de la cola',
===C_NOTAS===
VARCHAR(1024) NULL,
===N_OBJ_SERV===
INT NULL COMMENT 'Objetivo de servicio de la cola. Este valor lo consulta el intz-nimitz por cada llamada que se realiza a la cola',

===N_PESO_OBJ_SERV===
INT NULL COMMENT 'Peso de la cola, a valor más alto, más prioritaria es la cola.',
===ID_FORMULARIO===
INT(11) NULL DEFAULT NULL COMMENT 'Valor del ID del formulario asociado a la cola',
===C_ACCION_SAL===
VARCHAR(255) NULL COMMENT 'Campo acción si el formulario es Integrado o Integrado URL',
===N_ACCION_SAL_PAR1===
INT NULL COMMENT 'Valor del primer parámetro del campo acción',
===N_ACCION_SAL_PAR2===
INT NULL COMMENT 'Valor del segundo parámetro del campo acción',
===C_ACCION_SAL_PAR3===
VARCHAR(128) NULL COMMENT 'Valor del tercero parámetro del campo acción',
===C_ACCION_SAL_PAR4===
VARCHAR(128) NULL COMMENT 'Valor del cuarto parámetro del campo acción',
===N_TIEMPO_ADMINISTRATIVO===
INT NULL COMMENT 'Valor del tiempo administrativo de la cola',
===E_TIPO_COLA===
INT NULL

[[BD.ENUM.TTipoCola|TTipoCola]]

===C_CALLERID_SAL===
VARCHAR(45) CHARACTER SET 'utf8' NULL DEFAULT NULL COMMENT '\n',
===C_CALLERID_NAME_SAL===
VARCHAR(45) CHARACTER SET 'utf8' NULL DEFAULT NULL COMMENT '\n',
===B_FINALES_GENERICOS===
TINYINT(1) NULL COMMENT 'Habilitar o no finales genéricos a la cola',
===ID_EJE1===
INT NULL COMMENT 'Eje perteneciente a la cola',
===ID_EJE2===
INT NULL COMMENT 'Eje perteneciente a la cola',
===ID_EJE3===
INT NULL COMMENT 'Eje perteneciente a la cola',
===ID_EJE4===
INT NULL COMMENT 'Eje perteneciente a la cola',
===N_LLAM_SAL_MAX===
INT(11) NULL DEFAULT NULL COMMENT 'Numero maximo de llamadas salientes simultaneas de agentes en colas de marcación saliente ',
===B_AGEN_TMP_ADMIN_NO_DISP===
TINYINT(1) NULL COMMENT 'No permitir tiempo administrativo al agente ',
===ID_ALGORITMO_PREDICTIVO===
INT NULL COMMENT 'Algoritmo predictivo de marcación saliente asociado a la cola',
===N_PARAM1_PREDICTIVO===
INT NULL COMMENT 'Valor del primer parámetro del algoritmo predictivo',
===N_PARAM2_PREDICTIVO===
INT NULL COMMENT 'Valor del segundo parámetro del algoritmo predictivo',
===N_PARAM3_PREDICTIVO===
INT NULL COMMENT 'Valor del tercer parámetro del algoritmo predictivo',
===N_PARAM4_PREDICTIVO===
INT NULL COMMENT 'Valor del cuarto parámetro del algoritmo predictivo',
===N_PARAM5_PREDICTIVO===
INT NULL COMMENT 'Valor del quinto parámetro del algoritmo predictivo',
===N_PARAM6_PREDICTIVO===
INT NULL COMMENT 'Valor del sexto parámetro del algoritmo predictivo',
===N_PARAM7_PREDICTIVO===
INT NULL COMMENT 'Valor del septimo parámetro del algoritmo predictivo',
===N_PARAM8_PREDICTIVO===
INT NULL COMMENT 'Valor del octavo parámetro del algoritmo predictivo',
===C_NOMBRE_COD_CLIENTE===
VARCHAR(45) NULL COMMENT 'Nombre o código del cliente',
===N_WRAPUPTIME===
INT NOT NULL DEFAULT 2 COMMENT 'Parámetro wrapuptime de las colas de asterisk, diferente del tiempo administrativo que lo utiliza el desk',
===E_MODO_GRABACION===
INT NULL

[[BD.ENUM.TModoGrabacion|TModoGrabacion]].

Lo usa vivait-desk y el enrutador para ver si se graba.

===B_GRABAR_SEG_COLA===
TINYINT(1) NOT NULL DEFAULT 0,
===E_ENRU_GRABAR===
TINYINT(1) NOT NULL DEFAULT 0 COMMENT 'TTipoEnruGrabar',
===C_NOMBRE_MOSTRAR===
VARCHAR(45) NULL,
===ID_CATEGORIA===
INT NULL,
===ID_INFORME_CALIDAD===
INT NULL

ID dela tabla de informes de calidad. [[BD.ACD_INFORMES_CALIDAD|ACD_INFORMES_CALIDAD]]

===B_NO_USAR===
TINYINT(1) NOT NULL DEFAULT 0 COMMENT 'Habilitar o no el uso de la cola',

==índices==

PRIMARY KEY (`ID`),
INDEX `IDX_NOMBRE` (`C_NOMBRE` ASC)

==índices réplica==

Manual de operación plataforma VIVAit

2017-08-07T09:58:07Z

Imatarrubias: /* Generación de un Core */

{| class="wikitable"
|-
! '''Producto: '''!! '''''VIVA'''''it Call
'''''VIVA'''''it Suite
|-
|}

== Introducción ==

En este documento se describe la arquitectura general de la plataforma '''''VIVA'''''it, detallando aquellos procesos principales que componen cada uno de los elementos del sistema, y sus principales elementos de diagnóstico
Quedan fuera del ámbito de este documento:
* Uso de aplicación de agente ('''''VIVA'''''it Desk)
* Uso de aplicación de supervisor ('''''VIVA'''''it Supervisor), incluyendo sus módulos autónomos ('''''VIVA'''''it reporting, '''''VIVA'''''it Tracker)
* Uso de portal de administración
* Uso de portal de traceo de llamadas y agentes ('''''VIVA'''''it Tracker web)
* Uso de portal de monitorización zabbix

== Arquitectura ==

[[Archivo:Arquitectura plataforma VIVAit.png|center|700px]]

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

== Descripción de los elementos, diagnósticos y operaciones ==
Las siguientes tablas definen los principales elementos software de la plataforma '''''VIVA'''''it, que son detallados en apartados siguientes:

{| class="wikitable"
|-
|+ <big>'''Nivel de sistema operativo'''</big>
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
| Ubuntu Server LTS 64 bits || Uno por servidor|| ||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
|| Actualmente (Oct-2015) 14.04
Bajo proyecto puede cambiarse
|-
| Almacenamiento de grabaciones|| Uno por sistema|| Almacenamiento de las grabaciones, ya sean de entorno corporativo o de contact center||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
|| Típicamente un espacio grande de almacenamiento proporcionado por el cliente y que se monta como un sistema de archivos local en los servidores de la plataforma
Pueden existir sistemas secundarios de almacenamiento de grabaciones
|-
|-
|}

{| class="wikitable"
|-
|+ <big>'''Nivel de conmutación de voz'''</big>
|-
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
|Asterisk 1.4.24 by MDtel||Uno por servidor ACD||Núcleo de conmutación de voz basado en Asterisk 1.4 y modificado por MDtel||'''''VIVA'''''it Suite||Fuertemente modificado por MDtel
En el futuro migrará a Asterisk 13 Certified
|-
|Dialplan ACD by MDtel||Uno por servidor ACD||Configuración de voz||'''''VIVA'''''it Suite||En el futuro se unificará con corporativa
|-
|Asterisk 13 Certified by MDtel||Uno por servidor corporativo/gateway||Núcleo de conmutación de voz basado en Asterisk 13 y modificado por MDtel||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Actualmente asterisk estándar (10/15)
La instalación contempla descargar de la red el más actualizado, siempre CERTIFIED"
|-
|Dialplan corporativo||Uno por servidor corporativo/gateway||Configuración de voz||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||En el futuro se unificará con ACD
|-
|}

{| class="wikitable"
|-
|+ <big>'''Nivel de base de datos'''</big>
|-
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
|MySQL 5.5||Donde haya BBDD de cualquier tipo (incluso zabbix)||Motor de Base de Datos||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||A efectos prácticos va a ser en todos los servidores con casi total seguridad
|-
|BBDD tiempo real||Una por sistema||Base de Datos sobre la que trabaja todo el entorno de tiempo real||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
|-
|BBDD réplica||Una por sistema multinodo||Base de Datos para acceso a información de reporting…y similar||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Bajo proyecto puede existir más de una
En el nodo en el que exista réplica existirá además copia (excepto nodo ACD)
|-
|BBDD copia||Uno por servidor corporativo/gateway||Copias de tablas de configuración para respaldo de la misma||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Local en cada nodo
Los nodos de ACD actualmente no trabajan con copia; en caso de fallo de BBDD TR se usa el modo emergencia
|-
|}

{| class="wikitable"
|-
|+ <big>'''Nivel de procesos ''VIVA''it'''</big>
|-
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
|Intz-Nimitz||Donde haya una BBDD de tiempo real o copia||Interfaz entre el dialplan y la base de datos||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||No donde haya BBDD de réplica
Sistemas grandes pueden contemplar mas de un intz-nimitz central"
|-
|vivait-cti||Uno por servidor ACD||Interfaz entre '''''VIVA'''''it Desk, supervisor y el manager de asterisk||'''''VIVA'''''it Suite||
|-
|myAcdSuperv||Uno por servidor ACD||Recopilador de datos de asterisk y actualiza en la BBDD
Genera llamadas en el marcador
||'''''VIVA'''''it Suite
||
|-
|motorSal||Uno por sistema con ACD||Motor de marcador saliente automático||'''''VIVA'''''it Suite||Solo si hay marcación saliente
Junto a la BBDD de tiempo real
|-
|recordCentral||Uno por sistema||Servidor de grabaciones, se conectan los agentes a el||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Se arrancan varias instancias en función del número de nodos
Debe instalarse en un servidor que tenga el almacenamiento de grabaciones en su sistema de archivos
|-
|recordNodo||Uno por servidor corporativo/gateway||Agente de grabación||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|bdCentral||Uno, en el nodo con la BBDD de tiempo real||Genera la base de datos que se copiará para respaldo a otros nodos||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|bdNodo||En cada nodo con BBDD de copia||Recoge la base de datos del servidor central con el objeto de tener el respaldo||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|Actualizador||Uno por sistema con ACD||Se encarga de proporcionar las versiones actualizadas de las aplicaciones de puesto de trabajo||'''''VIVA'''''it Suite||En el mismo servidor que el portal de administración
|-
|phoneProv-tftp||Uno por sistema||Se encarga del aprovisionamiento masivo de terminales||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||En instalaciones grandes habrá más de uno, quizás uno por sede grande; depende de la infraestructura de DHCP
|-
|borraregistrosnimitz||||||||
|-
|Mover grabaciones a nube||||||||
|-
|}

{| class="wikitable"
|-
|+ <big>'''Administración'''</big>
|-
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
|Tomcat 7||Uno por servidor con portales||Servidor de aplicaciones JAVA||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
|-
|Portal de administración ||Uno por sistema||Portal de administración del sistema||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Bajo proyecto puede existir más de uno
|-
|Portal usuario||Uno por sistema||Portal de usuario, para acceso a buzones, su configuración||'''''VIVA'''''it Call||Bajo proyecto puede existir más de uno
|-
|Tracker web||Uno por sistema||Portal de seguimiento de llamadas||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Debe instalarse en un servidor que tenga los ficheros de grabación montados en su sistema de archivos
Ligado a recordCentral
Bajo proyecto puede existir más de uno
|-
|Monitor||Uno por sistema||Portal de monitores de pared de Call Center||'''''VIVA'''''it Suite||Bajo proyecto puede existir más de uno
|-
|Apache||Uno por servidor de calendarios||Servidor de portales WEB||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|Servidor de calendarios||Uno por sistema||Aloja calendarios para su uso en diferentes entornos de NIMITZ||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Bajo proyecto puede existir más de uno
|-
|}

{| class="wikitable"
|-
|+ <big>'''Monitorización'''</big>
|-
! Elemento!! Instancias!! Propósito!! Producto!! Observaciones
|-
|Servidor zabbix||Uno por instalación||Monitorización técnica y de negocio||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||Bajo proyecto puede existir más de uno
Tipicamente irá o en BBDD replica o en nodo de gestión en instalaciones grandes
|-
|Templates zabbix||Uno por instalación||Adaptaciones específicas||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|Agente Zabbix||Uno por servidor||Agente de monitorización||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
||Scripts monitorización zabbix||Uno por servidor||Agente de monitorización||'''''VIVA'''''it Call
'''''VIVA'''''it Suite
||
|-
|}
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

===Versiones de módulos===

{| class="wikitable"
|-
! Módulo !! VSuite
V.3.10
! VSuite
V.3.2.0
! VSuite
V.3.3.0
! VIVAit V.3.0.0
(VSuite 3.4+VCall3.0)
! VIVAit V.3.1.0
(VSuite 3.5+VCall3.1)
|-
| Sistema Operativo || || || ||
|| Ubuntu 14.0.4
Server 64 Kb
|-
| Asterisk || 1.4 || 1.4 || 1.4 || 1.4 Nodo ACD
13 resto nodos
|| 1.4 Nodo ACD
13 resto nodos
|-
| Asterisk ACD '''(VS)''' || || || || 3.3.1 || 3.4.1
|-
| Dialplan ACD '''(VS)''' || || || || || 3.5.0
|-
| Asterisk Corp '''(C)''' || || || || 3.3.4 || 3.4.4
|-
| Asterisk Cisco '''(VC)''' || || || || 3.3.4 || 3.4.4
|-
| Dialplan Corp '''(C)''' || || || || 3.3.1 || 3.5.0
|-
| Lazarus común '''(VS)''' || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0 || 3.5.0
|-
| BD '''(C)''' || 3.2.0 || 3.4.0 || 3.5.0 || 3.6.0 || 3.8.0
|-
| Generaconf '''(C)''' || 3.0.0 || 3.0.0 || 3.2.0 || 3.4.0 || 3.5.0
|-
| Instalador '''(C)''' || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0 || 3.5.0
|-
| Intz-nimitz '''(C)''' || 2.6.0 || 3.0.1 || 3.0.3 || 3.4.1 || 3.4.2
|-
| recordgwd '''(C)''' || 1.3.0 || 1.3.0 || 3.1.0 || ----- || -----
|-
| recordNodo '''(C)''' || ----- || ----- || ----- || 4.0.0 || 4.0.0
|-
| recordprocesad '''(C)''' || 1.2.0 ||1.2.0|| 3.0.0 || ----- || -----
|-
| recordCentral '''(C)''' || ----- || ----- || -----|| 4.0.0 || 4.0.1
|-
| MyACDSuperv '''(VS)''' || 5.2.0 || 5.3.0 || 5.3.0 || 5.3.2 || 5.3.2
|-
| Motorsal '''(VS)''' || 1.4.0 || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0
|-
| Vivait-cti '''(VS)''' || 3.0.0 || 3.0.1 || 3.0.1 || 3.0.1 || 3.0.2
|-
| Multimonitorweb '''(VS)''' || 3.0.1 || 3.0.2 || 3.1.0 || 3.1.0 || 3.2.0
|-
| Portal de administración '''(C)''' || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0 || 3.5.0
|-
| Tracker Web '''(C)''' || 3.0.2 || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0
|-
| VIVA supervisor '''(VS)''' || 3.0.0 || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0
|-
| Tracker windows '''(C)''' || 3.0.0 || 3.1.0 || 3.2.0 || 3.3.0 || 3.4.0
|-
| VIVA report '''(VS)''' || 1.2.0 || 3.1.0 || 3.2.0 || 3.2.2 || 3.3.0
|-
| VIVA desk '''(VS)''' || 3.0.2 || 3.2.0 || 3.3.0 || 3.4.0 || 3.5.0
|-
| VIVA designer '''(VS)''' || 1.0.23 || 3.0.1 || 3.1.0 || 3.1.0 || 3.2.0
|-
| Preview '''(VS)''' || 1.0.18 || 3.2.0 || 3.3.0 || 3.4.0 || 3.5.0
|-
| Phone_prov '''(C)''' || ------ || ------ || 3.0.1 || 3.0.3 || 3.0.3
|-
| Portal usuario '''(VC)''' || ------ || ------ || ------ || 3.0.0 || 3.1.0
|}

'''(C)''': Módulo común

'''(VC)''': Módulo de VIVAit Call

'''(VS)''': Módulo de VIVAit Suite

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Sistema Operativo ===
Los sistemas operativos de nuestra plataforma se corresponden a las versiones de Ubuntu Server LTS , ya que son las versiones estables, con un soporte continuado y mas estables a actualizaciones desde la salida Ubuntu 14.04.1. En concreto el sistema operativo utilizado para la plataforma '''''VIVA'''''it es Ubuntu Server 14.04.4 LTS. Para más información https://help.ubuntu.com/lts/serverguide/index.html.

[[Archivo:Ubuntu Kernel Release Schedule.png|750px]]

==== Funcionamiento en cluster ====

Un clúster es un grupo de múltiples ordenadores unidos mediante una red de alta velocidad, de tal forma que el conjunto es visto como un único ordenador.

De un clúster se espera que presente combinaciones de los siguientes servicios:

# Alto rendimiento
# Alta disponibilidad
# Balanceo de carga
# Escalabilidad

Tal y como esta definido el cluster de MDtel, este comprueba conectividad con la otra máquina que lo forma y con un punto de confianza. Si la máquina no tiene conectividad con la otra y si con el punto de confianza es que el servidor está vivo, mientas que si no tengo conectividad ni con la otra máquina ni con el punto de confianza es que el muerto soy yo, por lo que balanceo.

Por lo que las máquinas balancean en los casos siguientes:

* Todo lo que tenga que ver con la red, es decir, caída de la tarjeta de red, apagado de la máquina, corte en la red..

Y no balancea en los siguientes:

* No balancea en los demás casos, es decir, todo lo que tenga que ver con procesos de una máquina (caída asterisk, base de datos, intz-nimitz)

El funcionamiento en cluster se basa en:

* Heartbeat: IP flotante entre las dos máquinas que componen el cluster; típicamente este "latido" entre máquinas se realizará mediante conexión directa con cable cruzado para asegurar que no existan problemas de comunicaciones tales como retardo, pérdida de paquetes, etc en este latido y pueda ser causa de un balanceo inadecuado.

{| class="wikitable"
|-
| '''Nota 17-11-2015:''' Se ha realizado en un cliente un cluster distribuido, con dos servidores en diferentes sedes, realizando el heartbeat mediante enlace Gigabit. Si bien la solución no está validada por desarrollo, se está observando el funcionamiento.
|}

* DRBD que se encargar de mantener una serie de carpetas totalmente replicadas entre los dos nodos; dichas las carpetas son:

El cluster es <big>'''activo/pasivo'''</big>; la máquina activa posee la IP flotante y tiene arrancados los servicios.

==== Configuración del cluster ====
Para montar un cluster de asterisk partimos de la siguiente situación inicial:
* Dos maquinas con '''''VIVA'''''it Call 3.0 instalado.
* El driver bonding de Interfaces de Red en Ubuntu Server.

Los pasos a seguir para la configuración en el Ubuntu Server son los siguientes:
* Instalar ifenslave:
:{|
|-
|
aptitude install ifenslave.
|}
: Finalizada la instalación, comprobamos que la instalación de Bonding se ha configurado para empezar desde el arranque del sistema operativo desde el fichero '''/etc/modules''':
:{|
|-
| vi /etc/modules
# /etc/modules: kernel modules to load at boot time.
#
# This file contains the names of kernel modules that should be loaded
# at boot time, one per line. Lines beginning with "#" are ignored.
# Parameters can be specified after the module name.
lp
rtc
bonding
|}

* Crear o editar el archivo llamado '''/etc/modprobe.d/bonding.conf''' y añadir la siguiente linea en negrita:
:{|
|-
|
echo "alias bond0 bonding"> /etc/modprobe.d/bonding.conf
|}

* Editar el fichero /etc/network/interfaces y añadir lo que esta en negrita:
:{|
|-
|
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).
# The loopback network interface
auto lo
iface lo inet loopback

'''# Bonding'''

'''#em1 ip manual y esclavo en el "bond0" NIC'''
'''auto em1'''
'''iface em1 inet manual'''
'''bond-master bond0'''
'''bond-primary em0'''

'''#em2 ídem, creando así un vínculo de enlace 2.'''
'''auto em2'''
'''iface em2 inet manual'''
'''bond-master bond0'''
'''auto bond0'''
'''iface bond0 inet static'''
'''address 10.255.255.11'''
'''netmask 255.255.255.0'''
'''gateway 10.255.255.254'''
'''bond-mode active-backup'''
'''bond-miimon 100'''
'''bond-slaves none'''

'''# em3 replica entre servidores'''
'''auto em3'''
'''iface em3 inet static'''
'''address 10.255.254.10'''
'''netmask 255.255.255.0'''

'''# em4 gestion'''
'''auto em4'''
'''iface em4 inet static'''
'''address 172.17.47.255'''
'''netmask 255.255.0.0'''
|}

* Reiniciamos el sistema para que el kernel tome los cambios.

* Comprobación que en las dos maquinas el archivo '''/etc/host''' contenga el los nombre de las dos maquinas a vincular. En el ejemplo el archivo en ambas maquinas es:

:{|
|-
|
127.0.0.1 localhost

10.255.255.11 vivaitcall-CL-UAH-1

10.255.255.12 vivaitcall-CL-UAH-2

10.255.255.10 vivaitcall-CL-UAH

10.255.255.10 BDTR

10.255.254.10 vivaitcall-CL-UAH-1-em3

10.255.254.11 vivaitcall-CL-UAH-2-em3
|}

* Creamos dos particiones iguales en ambos ordenadores , usando el comando '''parted'''.
:{|
|-
|
root@vivaitcall-CL-UAH-1:~# '''parted /dev/sda'''
GNU Parted 2.3
Using /dev/sda
Welcome to GNU Parted! Type 'help' to view a list of commands.
(parted) p free
Model: HP LOGICAL VOLUME (scsi)
Disk /dev/sda: 1000GB
Sector size (logical/physical): 512B/512B
Partition Table: gpt
Number Start End Size File system Name Flags
17,4kB 262kB 245kB Free Space

1 262kB 1000MB 1000MB fat32 boot
2 1000MB 201GB 200GB ext4
3 201GB 217GB 16,0GB linux-swap(v1)
4 217GB 237GB 20,0GB ext4
237GB 1000GB 763GB Free Space

(parted) mkpart primary 237GB 1000GB
(parted) p free
Model: HP LOGICAL VOLUME (scsi)
Disk /dev/sda: 1000GB
Sector size (logical/physical): 512B/512B
Partition Table: gpt
Number Start End Size File system Name Flags
17,4kB 262kB 245kB Free Space
1 262kB 1000MB 1000MB fat32 boot
2 1000MB 201GB 200GB ext4
3 201GB 217GB 16,0GB linux-swap(v1)
4 217GB 237GB 20,0GB ext4
5 237GB 1000GB 763GB primary  No File System como ext4
1000GB 1000GB 204kB Free Space
(parted)quit
mkfs.ext4 /dev/sda5
root@vivaitcall-CL-UAH-1:~# '''parted /dev/sda'''
GNU Parted 2.3
Using /dev/sda
Welcome to GNU Parted! Type 'help' to view a list of commands.
(parted) p free
Model: HP LOGICAL VOLUME (scsi)
Disk /dev/sda: 1000GB
Sector size (logical/physical): 512B/512B
Partition Table: gpt
Number Start End Size File system Name Flags
17,4kB 262kB 245kB Free Space
1 262kB 1000MB 1000MB fat32 boot
2 1000MB 201GB 200GB ext4
3 201GB 217GB 16,0GB linux-swap(v1)
4 217GB 237GB 20,0GB ext4
5 237GB 1000GB 763GB primary
1000GB 1000GB 204kB Free Space
(parted) rm 5
(parted) mkpart primary 237GB 1000GB
(parted) p free
Model: HP LOGICAL VOLUME (scsi)
Disk /dev/sda: 1000GB
Sector size (logical/physical): 512B/512B
Partition Table: gpt

Number Start End Size File system Name Flags
17,4kB 262kB 245kB Free Space
1 262kB 1000MB 1000MB fat32 boot
2 1000MB 201GB 200GB ext4
3 201GB 217GB 16,0GB linux-swap(v1)
4 217GB 237GB 20,0GB ext4
5 237GB 1000GB 763GB ext4 primary  Si File Sytem ext4
1000GB 1000GB 204kB Free Space
(parted)quit
|}

* Instalar los paquetes necesarios para el drbd. '''En Ubuntu server 14.04 ya está instalado.'''
:{|
|-
|
aptitude install drbd8-utils
aptitude update (si no instala el drbd8-utils actualizar)
aptitude install drbd8-utils (volver a lanzar)
|}

* Creamos el archivo '''/etc/drbd.conf''' en ambas maquinas:
:{|
|-
|
# You can find an example in /usr/share/doc/drbd.../drbd.conf.example
include "drbd.d/global_common.conf";
include "drbd.d/*.res";
resource MDcluster {
protocol C;
on vivaitcall-CL-UAH-1 {
device /dev/drbd0;
disk /dev/sda5;
address 10.255.254.10:7788;
meta-disk internal;
}
on vivaitcall-CL-UAH-2 {
device /dev/drbd0;
disk /dev/sda5;
address 10.255.254.11:7788;
meta-disk internal;
}
disk {
on-io-error detach;
}
net {
max-buffers 2048;
ko-count 4;
}
syncer {
rate 100M;
al-extents 257;
}
startup {
wfc-timeout 0;
degr-wfc-timeout 120;
}
}
|}

* Reiniciamos el sistema para que el kernel tome los cambios.
* Inicializamos el recurso, para ello primero deberemos crear los recursos DRBD teclearemos en ambas maquinas. Desde /etc.
:{|
|-
|
drbdadm create-md MDcluster (no y yes )
|}

:Si tenemos algún problema porque ya exista sistema de ficheros.
:{|
|-
|
dd if=/dev/zero of=/dev/sda5 bs=1M count=128
drbdadm create-md MDcluster (no y yes )
|}

* Reiniciamos ambas maquinas para que su kernel tome los cambios.
* Levantamos el servicio del DRBD en ambos servidores (nos preguntara que si queremos enviar los datos a los desarrolladores de drbd) tecleando no, no se envían.
:{|
|-
|
service drbd start
/etc/init.d/drbd start
|}

: Ahora ambas maquinas son secundarias.
: Indicar cual de las dos maquinas usaremos como primaria, por tanto en la maquina elegida habra que ejecutar:
:{|
|-
|
drbdadm -- --overwrite-data-of-peer primary all (en una máquina)
:'''Nota:''' La ip virtual que va a estar asignada a la maquina activa es 172.25.129.70.

|}

: Podemos teclear el comando '''''cat''''' para ver si esta sincronizando y su progreso:

:{|
|-
|
cat /proc/drbd
'''Nota:''' El servicio DRBD aparecera como '''''Primary/Secondary''''' si ejecutamos en el primario ;
y aparecerá ''''Secondary/Primary'''' si lo ejecutamos en el secundario. 
|}

* Instalación de los script de arranque:
:{|
|-
|
update-rc.d -f drbd remove (en las dos maquinas)
update-rc.d drbd start 13 2 3 4 5 . stop 87 0 1 6 . (en las dos máquinas)
|}
* Seleccionar la fuente de sincronización.
:Formateamos un disco de la maquina que queramos que funcione como fuente del servicio DRBD, para evitar conflictos:
:{|
|-
|
mkfs.ext4 /dev/drbd0
|}
: Creamos el directorio sobre el que vamos a montar el disco, en ambas maquinas.
:{|
|-
|
mkdir /HDcluster
|}

: Creamos un archivo dentro '''''/HDcluster''''' de que se verá solo cuando el disco no está montado en ambas maquinas.
:{|
|-
|
touch sinMontar
'''Nota:''' Este archivo nos puede servir para monitorizar mediante zabbix, nagios, ... que el disco no está montado.
|}

: En una de las maquinas montamos el disco (desde fuera del directorio HDcluster)
:{|
|-
|
mount /dev/drbd0 /HDcluster
|}
* Procedemos a mover todos los datos que necesitemos en este disco y a crear accesos directos, los directorios que vamos a mover son los siguientes:
:{|
|-
|
/etc/asterisk
/var/lib/asterisk
/usr/lib/asterisk
/usr/spool/asterisk
/var/lib/mysql
/var/tftp/
|}
: El procedimiento que vamos a seguir es el siguiente, en el primer ordenador:
:{|
|-
|
'''Cd /HDcluster'''
'''tar -zcvf etc-asterisk.tgz /etc/asterisk'''
'''tar -zxvf etc-asterisk.tgz'''
'''rm -rf /etc/asterisk'''
'''ln -s /HDcluster/etc/asterisk /etc/asterisk'''
'''tar -zcvf var-lib-asterisk.tgz /var/lib/asterisk'''
'''tar -zxvf var-lib-asterisk.tgz'''
'''rm -rf /var/lib/asterisk'''
'''ln -s /HDcluster/var/lib/asterisk /var/lib/asterisk'''
'''tar -zcvf usr-lib-asterisk.tgz /usr/lib/asterisk'''
'''tar -zxvf usr-lib-asterisk.tgz'''
'''rm -rf /usr/lib/asterisk'''
'''ln -s /HDcluster/usr/lib/asterisk /usr/lib/asterisk'''
'''tar -zcvf var-spool-asterisk.tgz /var/spool/asterisk'''
'''tar -zxvf var-spool-asterisk.tgz'''
'''rm -rf /var/spool/asterisk'''
'''ln -s /HDcluster/var/spool/asterisk /var/spool/asterisk'''
'''tar -zcvf var-lib-mysql.tgz /var/lib/mysql'''
'''tar -zxvf var-lib-mysql.tgz'''
'''rm -rf /var/lib/mysql'''
'''ln -s /HDcluster/var/lib/mysql /var/lib/mysql'''
'''tar -zcvf var-lib-phoneprov-tftp.tgz /var/lib/phoneprov-tftp/'''
'''tar -zxvf var-lib-phoneprov-tftp.tgz'''
'''rm -rf /var/lib/phoneprov-tftp/'''
'''ln -s /HDcluster/var/lib/phoneprov-tftp /var/lib/phoneprov-tftp'''
|}

: En la segunda maquina debemos borrar los directorios y crear los accesos directos.
:{|
|-
|
'''rm -rf /etc/asterisk'''
'''ln -s /HDcluster/etc/asterisk /etc/asterisk'''
'''rm -rf /var/lib/asterisk'''
'''ln -s /HDcluster/var/lib/asterisk /var/lib/asterisk'''
'''rm -rf /usr/lib/asterisk'''
'''ln -s /HDcluster/usr/lib/asterisk /usr/lib/asterisk'''
'''rm -rf /var/spool/asterisk'''
'''ln -s /HDcluster/var/spool/asterisk /var/spool/asterisk'''
'''rm -rf /var/lib/mysql'''
'''ln -s /HDcluster/var/lib/mysql /var/lib/mysql'''
'''rm -rf /var/lib/phoneprov-tftp'''
'''ln -s /HDcluster/var/lib/phoneprov-tftp /var/lib/phoneprov-tftp'''
|}

* Configurar heartbeat para las dos maquinas.
: Instalamos heartbeat en las dos maquinas. '''En UBUNTU Server 14.04 ya está instalado.'''
:{|
|-
|
aptitude install heartbeat
|}
: Debemos modificar 3 ficheros en cada una de las maquinas, estos se encuentran en '''/etc/ha.d'''. El primer fichero a modificar es '''''ha.cf.''''':
:: En la maquina ''vivaitcall-CL-UAH-1'' es:
::{|
|-
|
root@vivaitcall-CL-UAH-1:~# cat /etc/ha.d/ha.cf
'''# Explicacion en /usr/share/doc/heartbeat/ha.cf.gz'''

'''udpport 694'''
'''baud 19200'''
'''auto_failback off'''
'''use_logd yes'''
'''crm no'''

'''# Temporizaciones en segs'''
'''logfacility local0'''
'''keepalive 2'''
'''deadtime 8'''
'''warntime 16'''
'''initdead 64'''
'''deadping 6'''

'''#ucast bond0 vivaitcall-CL-UAH-1'''
'''ucast bond0 vivaitcall-CL-UAH-2'''

'''#ucast em3 vivaitcall-CL-UAH-1-em3'''
'''ucast em3 vivaitcall-CL-UAH-2-em3'''

'''#Ping a puerta de enlace,gw1,gw2,gw3,gw4'''
'''ping_group red_local 10.255.255.12'''

'''respawn hacluster /usr/lib/heartbeat/ipfail'''
'''apiauth ipfail gid=haclient uid=hacluster'''

'''node vivaitcall-CL-UAH-1'''
'''node vivaitcall-CL-UAH-2'''
|}

:: Y en la maquina ''vivaitcall-CL-palacio-2'' es:
::{|
|-
|
root@vivaitcall-CL-UAH-1:~# cat /etc/ha.d/ha.cf
'''# Explicacion en /usr/share/doc/heartbeat/ha.cf.gz'''

'''udpport 694'''
'''baud 19200'''
'''auto_failback off'''
'''use_logd yes'''
'''crm no'''

'''# Temporizaciones en segs'''
'''logfacility local0'''
'''keepalive 2'''
'''deadtime 8'''
'''warntime 16'''
'''initdead 64'''
'''deadping 6'''

'''ucast bond0 vivaitcall-CL-UAH-1'''
'''#ucast bond0 vivaitcall-CL-UAH-2'''

'''ucast em3 vivaitcall-CL-UAH-1-em3'''
'''#ucast em3 vivaitcall-CL-UAH-2-em3'''

'''#Ping a puerta de enlace gw1 gw2 gw3 gw4'''
'''ping_group red_local 10.255.255.12'''

'''respawn hacluster /usr/lib/heartbeat/ipfail'''
'''apiauth ipfail gid=haclient uid=hacluster'''

'''node vivaitcall-CL-UAH-1'''
'''node vivaitcall-CL-UAH-2'''
|}
::'''Nota:''' El parámetro '''auto_failback''' se utiliza para indicar si queremos que al recuperarse una maquina adquiera los recursos sobre los que tiene prioridad.
:El segundo fichero es '''''authkeys''''',, este fichero es el mismo en ambas maquinas:
:{|
|-
|
chmod 600 authkeys '''(importante)'''
auth 1
1 sha1 claveSecretaATope
|}

:El tercer fichero '''haresources''', donde especificaremos en las dos maquinas que deben apuntar a la maquina que queremos que tenga prioridad en la adquisición de los recursos, este fichero es el mismo en las dos maquinas:
:{|
|-
|
MÁQUINA 1 -> vivaitcall-CL-palacio-1 hb_mdtel
MÁQUINA 2-> vivaitcall-CL-palacio-1 hb_mdtel
|}
: Copiaremos en el directorio '''/etc/ha.d/resource.d/''' los scripts de arranque con permisos 755 (lo podemos hacer mediante WINSCP). Los scripts se encuentran en '''''C:\Documents and Settings\javier.gutierrez.MDTEL\Mis documentos\Centrales\Asterisk\Cluster\scripts'''''.
:{|
|-
|
chmod 755 hb_catalina
chmod 755 hb_mdtel
chmod 755 hb_mdtel_firewall
|}
: Deberemos editar el archivo '''hb_mdtel'''
:{|
|-
|
(IP flotante a.b.c.d./mask) 10.255.255.10
CAD_IP_FLOTA=10.255.255.10/24/bond0
|}
:

* Paramos el proceso '''myAcdSuperv'''.
:{|
|-
|
mv /etc/rc2.d/S02myAcdSuperv s02myAcdSuperv
|}
* Reiniciamos ambas maquinas para que su kernel tome los cambios.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== Comprobación de buen funcionamiento del cluster ====
* La maquina activa tiene que tener en HDcluster montado el disco con todos sus directorios y la maquina inactiva no (tenemos que ver el archivo que hemos creado "sinMontar").
* La ip virtual tiene que estar en la maquina activa (ifconfig) y no tiene que estar en la inactiva.
* El asterisk tiene que estar arrancado en la maquina activa y parado en la inactiva.
* Tecleando la ip de la maquina activa en un navegador debemos acceder al portal de vivait-call y en la inactiva no debe de estar activo.
* Para cambiar el cluster manualmente podemos utilizar los siguientes comandos:
:{|
|-
|
/usr/share/heartbeat/hb_takeover
|}
: La maquina desde la que se ejecuta se convierte en la maquina activa
:{|
|-
|
/usr/share/heartbeat/hb_standby
|}
: La maquina desde la que se ejecuta deja de ser la maquina activa

==== Notas para MySQL ====
Si mysql es parte del cluster tenemos que tener en cuenta dos cosas:

* El archivo '''/etc/mysql/debían.cnf''' contiene una clave que debe ser igual en ambas maquinas y debe ser la clave de la máquina de donde cojamos la base de datos. 
:{|
|-
|
# Automatically generated for Debian scripts. DO NOT TOUCH!
[client]
host = localhost
user = debian-sys-maint
password = AI6AdPtnhLUrNm1S
socket = /var/run/mysqld/mysqld.sock
[mysql_upgrade]
user = debian-sys-maint
password = AI6AdPtnhLUrNm1S
socket = /var/run/mysqld/mysqld.sock
basedir = /usr
|} 
* El archivo '''/etc/apparmor.d/usr.sbin.mysqld''' contiene donde pueden estar ubicados los archivos de mysql, al cambiar su ubicación y poner un enlace directo en /var/lib/mysql si no modificamos este archivo mysql no arrancara al no tener la nueva ubicación entre sus localizaciones permitidas. Este es un ejemplo de las líneas que debemos añadir. 
:{|
|-
|
/var/run/mysqld/mysqld.sock w, (copiar después de esta linea)

#//!!
/HDcluster/var/lib/mysql/ r,
/HDcluster/var/lib/mysql/** rwk,
#//!!
|}

==== Notas de desincronización ====
EL servicio del DRBD esta iniciado pero al teclear el comando cat /proc/drbd para ver si esta sincronizando se presenta "'''primary/unknown" y/o secondary/unknown''' ".
* En el nodo primary
:{|
|-
|
drbdadm connect all
|}

* En el nodo secondary
:{|
|-
|
drbdadm disconnect all
drbdadm -- --discard-my-data connect all
|}

==== Adaptar red a cliente ====
Para adaptar la red de los equipos al entorno del cliente hay que editar los siguientes ficheros:
{|
|-
|
/etc/network/interfaces
/etc/resolv.conf
/etc/hosts
/etc/ha.d/resource.d/hb_mdtel
/etc/ha.d/ha.cf
- TFTP:
/etc/inetd.conf (IP del cluster)

|}
Tras la modificaciones oportunas, se debe reiniciar las dos máquinas para cargar las nuevas configuraciones.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Matriz de conmutación ===

Encontramos dos diferentes núcleos de conmutación en la plataforma VIVAit:

* Para los nodos de procesamiento ACD el núcleo de conmutación es asterisk 1.4 RSP con fuertes modificaciones realizadas por MDtel en determinados módulos (queues, chan_spy entre otros)

* Para los nodos que realizan funcionalidad de gateway y/o procesamiento de telefonía corporativa, se utiliza como núcleo de conmutación asterisk 13, versión certified
https://wiki.asterisk.org/wiki/display/AST/Asterisk+13+Documentation

==== Modificaciones realizadas sobre Asterisk 13 certified 2 ====

===== Archivos añadidos por '''MD'''tel =====
Los archivos añadidos son los siguientes:

* '''apps/app_ucid.c'''
* '''apps/app_cli.c'''
* '''apps/app_crash.c'''
* '''apps/app_mdintz.c'''
* '''apps/app_mdintz.exports.in'''
* '''include/asterisk/mdintz.h'''
* '''include/asterisk/ucid.h'''
* '''res/res_mdcal.c'''

'''→ apps/app_mdintz.exports.in '''

Este archivo sirve para la exportación de funciones del mdintz para el uso por aplicaciones externas

===== Modificaciones de archivos =====

Los archivos modificados por '''MD'''tel son los mostrados a continuación:

* '''apps/app_mixmonitor.c'''
* '''res/res_calendar_caldav.c'''
* '''contrib/scripts/safe_asterisk'''
* '''contrib/init.d/rc.debian.asterisk'''
* '''channels/sig_pri.c'''
* '''channels/chan_sip.c'''

'''→ main/audiohook.c''' 

'''audiohook.c''' ha sido modificado para solucionar un crash de asterisk al utilizar en el mixmonitor las opciónes r y t

'''→ app_crash.c '''

Esta nueva aplicación es sólo compatible con '''Asterisk 13'''.

La documentación de la misma se encuentra en el comando: '''"core show application Crash"'''

Esta nueva aplicación ''permite añadir'' al plan de pruebas:

* Generación de una parada de asterisk.
* Verificación de su impacto. Por ejemplo, no deben cortarse las llamadas en curso, si así está previsto por la topología.
* Correcta generación de los "core", comprobando que funciona "backtrace" (bt).

'''Nota.-''' Esta aplicación no debería estar presente en una instalación de '''Asterisk 13'''

'''→ app_mdintz.c y mdintz.h''' 

Esta aplicación sirve como interfaz a entornos (funcionalidades) creados por MDtel

Para mas información consultar la página de [[MDintz|MDintz]].

Las rutas de estos archivos son las siguientes:

'''apps/app_mdintz.c''' 
'''include/asterisk/mdintz.h '''

'''app_mdintz.c''' :

'''app_mdintz.c''' orientada al proceso de enrutamiento a implementar en ''intz-nimitz.''

El archivo '''.c''' es casi igual para asterisk 1.4.24 y asterisk 13.
'''Nota.-''' Cuando se compila para asterisk 13, es necesario comentar la línea que pone '''"#define ASTERISK_OLD".'''

Los cambios implementados son:

* Unificación de código entre las versiones de asterisk
* Nuevo comando "qry"
* Posible resolución de "Mal write" en intz-nimitz (a verificar)

En cuanto al nuevo comando, el formato es:

'''mdintz qry <nHostFijo> <entorno> <servicio> <par1>...<parN>'''

Permite interrogar a un servidor de igual modo que hace el dialplan con '''fines de diagnóstico'''. La única diferencia es que se ha añadido el parámetro '''"nHostFijo"''' que puede tomar como valor '''"*"''' (lo que solicita una interrogación secuencial a todos los servidores definidos, igual a la funcionalidad del dialplan) ó '''"0"''' a '''"3"''' (que solicita un interrogación dirigida el host indicado como hostN, y sólo a él, en archivo de configuración).

Para instalarlo, es necesario copiar:

* '''asterisk/apps/app_mdintz.c'''
* '''asterisk/include/asterisk/mdintz.h'''
* En asterisk 1.4.24 conviene asegurar que se ha actualizado '''"asterisk/apps/app_queue.o"''' y '''"asterisk/apps/app_queue.so"'''
* Luego '''"make", "make install"''' y module '''"unload/load"''' (mejor "stop now" y start)

'''→ scripts y rc.debian.asterisk'''

cambiado contrib/scripts por el modificado por MDtel 
cambiado contrib/init.d/rc.debian.asterisk por el modificado por MDtel

'''→ Carpeta mp3 añadida al directorio addons'''

La carpeta mp3 en addons permite la reproducción desde el diaplan de los mensajes en mp3. En make menuselect hay que marcar el format_mp3 y app_mp3 e instalar el paquete mpg123 de ubuntu

'''→ sig_pri.c'''

Modificado para enviar/recibir el ucid en un primario qsig

Para que se envie el ucis tenemos que habilitar el envio de facilidades en el chan_dahdi.conf

facilityenable = yes

'''→ init.d''' 

* Uno de los archivos modificados ha sido '''init.d''', se encuentra en la ruta: '''/etc/init.d/asterisk'''. La modificación realizada es la siguiente:

{|style="background-color:#ffffcc;" class="wikitable"
|-
|-
| SAFE_ASTEISK=/usr/sbin/safe_asterisk 
if [ -x $SAFE_ASTERISK ] ; then 
:# //!! wkw 
:DAEMON=$SAFE_ASTERISK 
fi
|}



'''→ safe-asterisk'''
* Se encuentra en la siguiente ruta:'''/usr/sbin/safe-asterisk''' .En este archivo se ha modificado MAXFILES=32768

'''→ default'''

* Este fichero podemos encontrarlo en: '''/etc/default/asterisk'''. La finalidad de la modificación de este fichero es poder correr como usuario Asterisk, grupo asterisk y generar cores (descomentar línea)
Las modificaciones realizadas han sido:

{|style="background-color:#ffffcc;" class="wikitable"
|-
|-
| AST_USER="asterisk"
AST_GROUP="asterisk"

COREDUMP=yes
|}

===== Nueva función de asterisk: app_cli.so =====

Esta función permite ejecutar desde el '''dialplan''' un comando de línea de consola de '''asterisk (CLI).''' Su primer uso (y esperamos que no último) será para lanzar los '''notify''' que los teléfonos necesitan para el ''reaprovisionamiento'' desde el portal o desde la facilidad de movilidad de usuario.

Básicamente ejecuta un comando y devuelve su salida. Utiliza un archivo intermedio que puede ser:

* '''/dev/null''' si el campo se deja vacío, por tanto, no se puede recuperar la salida.
* '''TEMP''', en cuyo caso se crea un archivo temporal que se borra antes de finalizar la ejecución de la función.
* Un nombre de fichero que es responsabilidad del dialplan el borrarlo cuando proceda.

Para instalarlo basta copiar '''apps/app_cli.c''' en el directorio ''' "apps" ''' de los fuentes y luego ejecutar '''"make" y "make install".'''

A continuación se pasa el resultado de '''"core show function CLI" '''

'''[Synopsis]'''

Lanza un comando CLI desde dialplan

'''[Description]''' 
- CLI(nomArchSal,cmd) 
- Si 'nomArchSal' está vacio, se usa '/dev/null' y no se recupera resultado 
- Si 'nomArchSal'=TEMP, Se crea un archivo temporal que se borra al final 
- En otro caso, se crea el archivo y no se borra

'''[Syntax]''' 
CLI(nomArchSal,cmd)

'''[Arguments]''' 
'''nomArchSal'''
Archivo de salida (si se omite, /dev/null)
'''cmd'''
Comando a ejecutar via CLI

==== Dialplan ====

El Dialplan podría considerarse la columna vertebral del sistema ''Asterisk''.

Es una colección ordenada de acciones que se llevan a cabo cuando un usuario marca una serie de números. Hace la función de una tabla de enrutamiento de llamadas.

Todas las configuraciones generales de Asterisk están accesibles en la ruta '''/etc/asterisk'''

'''CONCEPTOS BÁSICOS'''

♦ '''EXTENSIONES'''

Una extensión es una marcación en el teclado de un teléfono. Dicha configuración podemos encontrarla en el archivo '''extensions.conf'''

Por ejemplo, un usuario podría marcar “3001” en su teléfono, y eso sería una extensión. También podría marcar un número de teléfono nacional, como por ejemplo “915881000”, y también sería una extensión.

En Asterisk pueden definirse también extensiones como texto, por tanto no debemos relacionar las extensiones únicamente con números.

Algunas reglas que sería interesante conocer serían las siguientes:

{| class="wikitable"
|-
! '''Regla''' !! '''Descripción'''
|-
| '''X''' || Cualquier cifra de 0 a 9
|-
|'''Z'''||Cualquier cifra de 1 a 9
|-
|'''N'''||Cualquier cifra de 2 a 9
|-
|'''[x-y]'''||Cualquier cifra de "x" a "y"
|-
|'''[xyz]'''|| Las cifras "x", "y" o "z"
|-
|'''.'''||Una o más repeticiones del símbolo anterior
|-
|'''!'''||Cero o más repeticiones del símbolo anterior
|}

Estas reglas son necesarias a la hora de definir por ejemplo todos los números de teléfono posibles en España

♦ '''PRIORIDADES'''

En lenguaje scripting, las acciones se van ejecutando de arriba a abajo en orden. En cambio, en Asterisk, el orden en el que se ejecutan las acciones es el indicado mediante números.
Primero se ejecutará la acción 1, luego la 2...así sucesivamente.

Es decir no basta con definir las acciones que se llevarán a cabo, también debemos indicar el orden en el que se llevarán a cabo.

♦ '''CONTEXTOS'''

Es mecanismo que nos permite variar el comportamiento del sistema en función del número que se marque. Su misión es aumentar la seguridad del sistema ofreciendo servicios diferenciados en función del usuario.

La sintaxis típica es el nombre del contexto englobado entre corchetes [nombre_contexto]. Si un dispositivo no tiene un contexto definido se redirige directamente al contexto por defecto.

Los ficheros que conforman el Dialplan se clasifican en:

* '''Generales'''
* '''Particulares'''
* '''Web'''

{| class="wikitable"
|-
! '''Fichero''' !! '''Función'''
|-
| '''Generales''' || Se encuentran los ficheros de propios de MDtel y Asterisk. Es importante remarcar que estos ficheros NO pueden ser modificados por el usuario.
|-
|'''Particular'''||Estos ficheros son los únicos que puede modificar el usuario
|-
|'''Web'''|| Se encierran aquí los archivos generados automáticamente por la plataforma, a través del portal
|}

En función del nodo en el que estemos trabajando, encontraremos dos tipos de dialplan:

'''* Dialplan ACD''' --> Dialplan que aplica a nodos ACD

'''* Dialplan corporativa''' --> Dialplan que aplica a nodos de corporativa o gateways (ya sean de corporativa o ACD)

A continuación se muestran las tablas con los ficheros correspondientes a cada Dialplan.

{| border="1" align="center" bgcolor="FloralWhite"
|+ '''Ficheros de configuración Dialplan Corporativo'''
| '''GENERALES'''
| '''PARTICULARES'''
| '''WEB'''
|-
| ext_Grabaciones.conf ext_InicioLlamada.conf ext_InicioLlamada_Dahdi.conf ext_InicioLlamada_ExtSIP.conf ext_InicioLlamada_TrunkSIP.conf ext_MARCAR_ColaCentralita.conf ext_MARCAR_ColaCentralita_Dial.conf ext_MARCAR_Cola.conf ext_MARCAR_Cola_Dial.conf ext_MARCAR.conf ext_MARCAR_DejarMensaje.conf ext_MARCAR_DejarMensaje_Dial.conf ext_MARCAR_Extension.conf ext_MARCAR_Extension_Dial.conf ext_MARCAR_Externo.conf ext_MARCAR_Externo_Dial.conf ext_MARCAR_Facilidad.conf ext_MARCAR_Facilidad_Dial.conf ext_MARCAR_Facilidad_nimitz.conf ext_MARCAR_Interno.conf ext_MARCAR_LeerMensaje.conf ext_MARCAR_LeerMensaje_Dial.conf ext_MARCAR_Nodo.conf ext_MARCAR_Nodo_Dial.conf ext_MARCAR_SalasConf.conf ext_MARCAR_SalasConf_Dial.conf ext_MARCAR_Servicios.conf ext_MARCAR_VDN.conf MARCAR_VDN_Dial.conf ext_MDtel.conf ext_MDtel_Var.conf ext_Subrutinas_AnchoBanda.conf ext_Subrutinas_BD.conf ext_Subrutinas_BD_Facilidad.conf ext_Subrutinas_BD_Facilidad.conf ext_Subrutinas_Colas.conf ext_Subrutinas.conf ext_Subrutinas_Enrutamiento.conf ext_Subrutinas_finLlamada.conf ext_Subrutinas_Grabacion.conf ext_Subrutinas_nimitz.conf ext_Subrutinas_Varias.conf ext_Subscribe.conf ext_Transfer.conf ext_Transfer_ExtSIP.conf ext_Transfer_TrunkInternos.conf ext_TrunkInternos.conf ext_TrunkInternos_Dial.conf sip_Estatico.conf sip_GENCUST.conf sip_notify.conf queues.conf queues_GENERAL.conf queues_PLANTILLACOLAS.conf 

| ext_Enrutador_Particular.conf ext_InicioLlamada_Dahdi_Particular.conf ext_InicioLlamada_ExtSIP_Particular.conf ext_InicioLlamada_Particular.conf ext_InicioLlamada_TrunkSIP_Particular.conf ext_MARCAR_Extension_Particular.conf ext_MARCAR_Externo_Particular.conf ext_MARCAR_Facilidad_Particular.conf ext_MARCAR_VDN_Particular.conf ext_MDtel_Particular.conf ext_TrunkInternos_Particular.conf 

|asterisk_WEB.conf ext_MDtel_WEB.conf sip_trunkExt_WEB.conf sip_trunkInt_WEB.conf sip_trunk_WEB.conf sip_WEB.conf queues_WEB.conf
|}

{| border="1" align="center" bgcolor="FloralWhite"
|+ '''Ficheros de configuración Dialplan ACD'''
| '''GENERALES'''
| '''PARTICULARES'''
| '''WEB'''
|-
| ext_Enrutador.conf ext_Grabaciones.conf ext_InicioLlamada.conf ext_InicioLlamada_CTI.conf ext_InicioLlamada_Dahdi.conf ext_InicioLlamada_ExtSIP.conf ext_InicioLlamada_Marcador.conf ext_InicioLlamada_TrunkSIP.conf ext_MARCAR_ColaCentralita.conf ext_MARCAR_ColaCentralita_Dial.conf ext_MARCAR_Cola.conf ext_MARCAR_Cola_Dial.conf ext_MARCAR.conf ext_MARCAR_DejarMensaje.conf ext_MARCAR_DejarMensaje_Dial.conf ext_MARCAR_Extension.conf ext_MARCAR_Extension_Dial.conf ext_MARCAR_Externo.conf ext_MARCAR_Externo_Dial.conf ext_MARCAR_Facilidad.conf ext_MARCAR_Facilidad_Dial.conf ext_MARCAR_Facilidad_nimitz.conf ext_MARCAR_LeerMensaje.conf ext_MARCAR_LeerMensaje_Dial.conf ext_MARCAR_Nodo.conf ext_MARCAR_Nodo_Dial.conf ext_MARCAR_SalasConf.conf ext_MARCAR_SalasConf_Dial.conf ext_MARCAR_Servicios.conf ext_MARCAR_VDN.conf ext_MARCAR_VDN_Dial.conf ext_MDtel.conf ext_MDtel_Var.conf ext_Subrutinas_AnchoBanda.conf ext_Subrutinas_BD.conf ext_Subrutinas_BD_Facilidad.conf ext_Subrutinas_Colas.conf ext_Subrutinas.conf ext_Subrutinas_Enrutamiento.conf ext_Subrutinas_finLlamada.conf ext_Subrutinas_Grabacion.conf ext_Subrutinas_nimitz.conf ext_Subrutinas_Varias.conf ext_Subscribe.conf ext_Transfer.conf ext_Transfer_ExtSIP.conf ext_Transfer_TrunkInternos.conf ext_TrunkInternos.conf ext_TrunkInternos_Dial.conf queues_GENERAL.conf queues_PLANTILLACOLAS.conf sip_GENCUST.conf sip_GENERAL.conf sip_notify.conf sip_PLANTILLAEXT.conf sip_supervision.conf 

| ext_Enrutador_Particular.conf ext_InicioLlamada_CTI_Particular.conf ext_InicioLlamada_Dahdi_Particular.conf ext_InicioLlamada_ExtSIP_Particular.conf ext_InicioLlamada_Marcador_Particular.conf ext_InicioLlamada_Particular.conf. ext_InicioLlamada_TrunkSIP_Particular.conf ext_MARCAR_Externo_Particular.conf ext_MARCAR_Facilidad_Particular.conf ext_MARCAR_VDN_Particular.conf ext_MDtel_Particular.conf ext_TrunkInternos_Particular.conf 

|asterisk_WEB.conf ext_MDtel_WEB.conf queues_WEB.conf sip_trunkInt_WEB.conf sip_WEB.conf 
|}
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Servicios networking ===
Son muy importantes las configuraciones adecuadas de los servicios de:

* '''NTP''': El sistema en global ha de estar sincronizado; todos los servidores y puestos de trabajo (en el caso de ''VIVA''it Suite) han de estar perfectamente sincronizados; los servidores de la plataforma se sincronizarán con el NTP del cliente; si el cliente no tiene NTP será necesario que un servidor de la plataforma se sincronice con un NTP externo y este sea el servidor para el resto de la plataforma

* '''DNS''': La configuración de DNS de la plataforma será coherente con el resto de la plataforma IT del cliente

* '''DHCP''': Es necesario coordinar con el cliente la asignación de direcciones para los diferentes elementos de la plataforma '''''VIVA'''''it, fundamentalmente para terminales telefónicos; en este caso además será necesario activa la opción 66 que permitirá definir el servidor TFTP del que los terminales cogerán sus ficheros de aprovisionamiento

=== Bases de datos (BBDD)===

La base de datos del sistema se basa en el motor de base de datos MySQL, es un elemento crítico del sistema, en el que insertan y del que obtiene mucha información múltiples procesos.
Muchas comunicaciones entre procesos se realizan vía Base de Datos (tabla COM_COMUNICADOS). Pueden existir distintas instancias de base de datos que explicadas en las siguientes secciones, nuestra base de datos tiene la siguiente estructura: [[Base de datos|Información completa de la BD]]. Podéis ampliar más información en https://dev.mysql.com/doc/

==== BBDD Tiempo Real ====
En la base de datos de tiempo real insertan información todos los procesos del sistema, y se realizan los cambios en configuración utilizando como herramienta el portal de administración y '''''VIVA'''''it Supervisor

De la base de datos de tiempo real leen los procesos que requieren información, y las aplicaciones:
*'''''VIVA'''''it Supervisor (para reporting de tiempo real)
*PanelWeb
*Datos de sesión de '''''VIVA'''''it Desk
*Monitorización Zabbix
* Otros

El portal de administración se encarga de escribir las configuraciones añadidas o modificadas en la base de datos

Para cuando la BDTR contienen un número masivo de datos, existe un script que borra el contenido de ciertas tablas de la BD (tablas DAT_) dejando solamente datos de un cierto número de días configurable.
Este script se llama borraRegistrosNimitz.pl; para más información consultar el apartado de Howto's.

==== BBDD Réplica ====
A efectos de asegurar las prestaciones del sistema, se establece una réplica de la base de datos, sincronizada con la de tiempo real; los procesos y aplicaciones pesados, que realicen consultas a las base de datos que puedan comprometer las prestaciones del sistema atacan a la réplica y nunca a la base de datos de tiempo real

Es posible que en instalaciones pequeñas no exista réplica, en cuyo caso se establece una base de datos unificada sobre la de tiempo real, en la que se añaden índices y procedimientos almacenados que típicamente residen en la de réplica.

Es posible establecer tantas réplicas como sean necesarias si diferentes procesos pesados se penalizan en exceso, si bien una implantación tipo contemplará una sola

Algunos procesos que utilizan la base de datos de réplica son:
*'''''VIVA'''''it Reporting
*'''''VIVA'''''it Tracker
*Histórico en tiempo real de '''''VIVA'''''it Supervisor

'''IMPORTANTE: Ningún proceso, programa, aplicación, etc. escribe en la base de datos de réplica; tan solo se extrae información'''

==== BBDD de copia ====
A efectos de asegurar el funcionamiento y como medida de contingencia ante un problema puntual de comunicación con la BD de tiempo real, en cada nodo disponemos de una BD de copia local. Posiblemente de un tamaño menor que la BD de tiempo real, dependiendo de cuanto tiempo pase hasta la próxima sincronización con la base de tiempo real.Esta base de datos llamada '''nimitzCopia'''.

Solo entrara en funcionamiento,cuando se produzca el problema mencionado, dejando acceder a los datos y poder dar servicio a la empresa mientras se soluciona el problema.

===== Backup y restore =====

Se utilizan dos script, para realizar la copia de seguridad y restaurar en la base de datos de copia local que son:

* El proceso '''bdCentral.sh''' que es el encargado de realizar la copia de seguridad. Tiene un archivo de configuración bdCentral.conf. En este archivo hay un parámetro (IGNORE_TABLAS) que indica las tablas de las que NO se realizará copia de seguridad. Toda tabla que no se indique formará parte de la copia de seguridad. Vuelca los resultados en /var/log/bdCentral.log
* El proceso '''bdNodo.sh''' que es el encargado de descargar la copia de seguridad y restaurarla en local. Tiene un archivo de configuración bdNodo.conf. Vuelca los resultados en /var/log/bdNodo.log. El fichero de backup se copia mediante el usuario sincroniza, que deberá poder acceder sin contraseña al servidor donde reside la copia.

En caso de producirse algún error en alguno de los procesos, marcarán dicho error en el log con una línea que comienza con la cadena "*ERROR".

==== Diagnósticos y operaciones sobre bases de datos ====

=====Comprobación que una base de datos está arrancada=====
Para comprobar si la base de datos está arrancada debemos poner en el terminal : '''ps aux | grep mysql'''

Si la base de datos está arrancada y funcionando correctamente se nos mostrará en el terminal:
[[Archivo:Base_Datos_bien.png‎ |500px|center]]

Por el contrario, si la base de datos presenta algun problema el mensaje mostrado será:

[[Archivo:Base_datos_mal.png |center]]

=====Comprobación que la base de datos de réplica está sincronizada con la base de datos de tiempo real.=====

Si se necesita verificar que la base de réplica está sincronizada con la base de datos en tiempo real basta con acudir al comando : '''show slave status\G'''.

Una vez introducido veremos:

[[Archivo:Replica.png |980px|center]]

Comandos importantes, desde dentro consola de Mysql:

'''show master status''': Realizado desde el master
'''show slave status''': Realizado desde el esclavo; el valor "seconds behind master" nos indica
cuanto está retrasada la réplica con respecto a la base de datos de tiempo real. Si el valor de este campo es elevado nos indicará
que la base de datos real con la réplica no estará sincronizada, por tanto, nos interesa que este valor sea lo más pequeño posible.
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Procesos propios ===

==== bdCentral ====

El proceso ''bdCentral.sh'' es el encargado de realizar la copia de seguridad. Tiene un archivo de configuración ''bdCentral.conf'' el cual puede encontrarse en la ruta '''/etc/MDtel/bdCentral.conf'''. En este archivo hay un parámetro (IGNORE_TABLAS) que indica las tablas de las que NO se realizará copia de seguridad. Toda tabla que no se indique formará parte de la copia de seguridad. Vuelca los resultados en /var/log/bdCentral.log

En caso de producirse algún error, se marcará dicho error en el log con una línea que comienza con la cadena "*ERROR".

Para ejecutar bdCentral:
bdCentral.sh /etc/MDtel/bdCentral.conf

Estos procesos se ejecutan automáticamente. Para ello está copiado el fichero bdCentral a /etc/cron.d.

Por defecto la programación vienen comentada por lo que será necesario activarlo.

Para que se roten los logs hay que copiar el fichero bdCentral.logrotate a /etc/logrotate.d (como bdCentral)
La ruta donde se encuentran los logs es la siguiente: '''/var/log/myAcdSuperv.log'''


[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== bdNodo ====
El proceso bdNodo.sh es el encargado de descargar la copia de seguridad y restaurarla en local. Tiene un archivo de configuración bdNodo.conf, este archivo puede encontrarse en la ruta '''/etc/MDtel/bdNodo.conf.''' Vuelca los resultados en /var/log/bdNodo.log. El fichero de backup se copia mediante el usuario sincroniza, que deberá poder acceder sin contraseña al servidor donde reside la copia.

En caso de producirse algún error, se marcará dicho error en el log con una línea que comienza con la cadena "*ERROR".

Para ejecutar bdNodo:

bdNodo.sh /etc/MDtel/bdNodo.conf

Estos procesos se ejecutan automáticamente. Para ello está copiado el fichero bdNodo a /etc/cron.d.

Por defecto la programación vienen comentada por lo que será necesario activarlo.

Para que se roten los logs hay que copiar el fichero bdNodo.logrotate a /etc/logrotate.d (como bdNodo)

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== Intz-Nimitz ====

Permite integrar procesos de asterisk (del dialplan) con la base de datos; por ejemplo es el que graba segmentos, inspecciona donde esta registrado un agente…etc. La estabilidad de este proceso es importante para el funcionamiento del sistema, si bien las llamadas entran en caso de no estar disponible.

Para mas información consultar la página de [[intz-nimitz|intz-nimitz]].

Desde un SSH ejecuta el comando “nc ip_maquina 1115”

'''root@vivait-acd:~# nc localhost 1115'''
intz-nimitz sis ver='V02.6' inic='20140401 110116' alarmas=21 ultAlar='20140414 171244'
intz-nimitz gmp msj=942/1024 buf=1024/1024 tarea=16/102
intz-nimitz tmp uptime=1816550 (21d 0h 35m 50s)
intz-nimitz vic identif='cms1' entorno='nimitz' conx=0/128 numConx=1018(0)
intz-nimitz mys curro=80/0/0/0 soli=1012(0) soliErr=6(0) soliEncol=0(0/0)
intz-nimitz cache colas=128/10/0/0 vdn=128/8/0/0 usuExten=10/0/0/0

Donde cada parámetro monitorizado indica:
{| class="wikitable"
|-
!Parámetro!!Descripción
|-
|sis/ver||Versión del proceso
|-
|sis/inic||Fecha de de arranque del proceso
|-
|Sis/alarmas||Alarmas desde arranque
|-
|Sis/ultAlar||Fecha de última alarma
|-
|Gmp/msj||
|-
|Gmp/buf||
|-
|Gmp/tarea||
|-
|Tmp/uptime||Tiempo que lleva el servicio activo
|-
|Vic/identif||Etiqueta de identificación del servicio
|-
|Vic/entorno||Entorno de base de datos
|-
|Vic/conx||Conexiones activas/conexiones máximas
|-
|Vic/numConx||Conexiones totales (último minuto)
|-
|Mys/curro||Número de hilos contra la base de datos
|-
|Mys/soli||Conexiones solicitadas (último minuto)
|-
|Mys/soliErr||Conexiones solicitadas con error (último minuto)
|-
|Mys/soliEncol||Conexiones encoladas
|-
|Cache/cola|| Colas monitorizadas/
|-
|Cache/vdn||VDN’s monitorizados
|-
|Cache/usuExten||
|-
|}

Como complemento a los diagnósticos:

* Podremos examinar el fichero de configuración del proceso en '''/etc/MDtel/intz-nimitz.conf'''
* Podremos examinar los logs del proceso en '''/var/log/intz-nimitz.log'''



[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== motorSal ====
Parte fundamental del proceso de marcación saliente, gestiona como hay que llamar a los diferentes contactos asignados a las campañas. Transforma los contactos en intentos de marcación.

A efectos de diagnósticos, desde un SSH ejecuta el comando “nc ip_maquina 1120”

'''root@vivait-acd:~# nc localhost 1120'''
motorSal sis ver='V01.4' inic='20140725 140832' alarmas=1 ultAlar='20140725 140832'
motorSal gmp msj=253/256 buf=256/256 tarea=99/102
motorSal tmp uptime=600165 (6d 22h 42m 45s)
motorSal mtr mys=1 ocup=0% planif=28(0) intento=26(0)

Donde cada parámetro monitorizado indica:

{| class="wikitable"
|-
!Parámetro!!Descripción
|-
|SIS/ver||Versión del proceso
|-
|SIS/inic||Fecha de de arranque del proceso
|-
|SIS/alarmas||Alarmas desde arranque
|-
|SIS/ultAlar||Fecha de última alarma
|-
|Gmp/msj||
|-
|Gmp/buf||
|-
|Gmp/tarea||
|-
|Tmp/uptime||Tiempo que lleva corriendo
|-
|mtr/mys||Si está conectado al MySQL
|-
|mtr/ocup||Porcentaje de ocupación
|-
|mtr/planif||Contactos planificados Totales (Último minuto)
|-
|mtr/intento||Intentos totales (Ültimo minuto)
|-
|}

* Posee un fichero de configuración llamado ''motorSal.conf'' en la ruta '''/etc/MDtel/motorSal.conf'''.


* Respecto a los logs del motorSal consultar el siguiente apartado: [[Trazas motorSal]]. Los logs pueden verse en la ruta '''/var/log/intz-nimitz.log'''

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== MyACDSuperv ====
Refleja el estado de las colas de asterisk en la base de datos; tiene sentido a efectos de estadísticas e informes, pero no a efectos de funcionamiento de la conmutación de voz

Es también el proceso que genera las llamadas en el marcador automático de '''''VIVA'''''it Suite

A efectos de diagnósticos, desde un SSH se ejecuta el comando “nc ip_maquina 1112”

'''root@vivait-acd:~# nc localhost 1112'''
myAcdSuperv SIS ver='04.6' inic='20140416 081613' alarmas=6 ultAlar='20140416 121652'
myAcdSuperv AMI cnx=1 ocup=28% exten=2/2/511 asig=0/11/4095
myAcdSuperv MYSQL cnx=1 ms=316

Donde cada parámetro monitorizado indica:
{| class="wikitable"
|-
!Parámetro!!Descripción
|-
|SIS/ver||Versión del proceso
|-
|SIS/inic||Fecha de de arranque del proceso
|-
|SIS/alarmas||Alarmas desde arranque
|-
|SIS/ultAlar||Fecha de última alarma
|-
|AMI/cnx||Conectado (1) a asterisk
|-
|AMI/ocup||Porcentaje de ocupación de MyACDSuperv
|-
|AMI/exten||Extensiones/Extensiones/Extensiones monitorizadas|-
|-
|AMI/asig||
|-
|MYSQL/cnx||Conectado (1) a MySQL
|-
|MYSQL/ms||Tiempo de última operación en ejecutarse
|-
|}

Como complemento a los diagnósticos:

* Podremos examinar el fichero de configuración del proceso en '''/etc/MDtel/myAcdSuperv.cnf'''
* Podremos examinar los logs del proceso en '''/var/log/myAcdSuperv.log'''

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== Proceso escoba ====
El proceso escoba se encarga de resolver y consolidar todos aquellos segmentos de grabación que han quedado almacenados en los gateways por falta de información o incoherencias. Existen dos tipos de procesos escobas:
# Proceso escoba perteneciente a nodo con agente de grabación (recordNodo) llamado '''''escobaGW.pl'''''.
# Proceso escoba perteneciente o no a un servidor de grabación (recordCentral) llamado '''''escobaGrabsBd.pl'''''.

===== escobaGW.pl =====
Proceso que se ejecuta en los nodos busca en el disco RAM , las grabaciones de segmentos cuya antigüedad sea superior a mas de un día, es decir, si el proceso por ejemplo se ejecuta a la 01:00 a.m. del día 24/03/2016 buscara todas aquellas grabacionesn de segmentos realizadas antes de la 01:00 a.m del día 22/03/2016.
Una vez realizada la busqueda, obtendra el UCID a traves del nombre del fichero, y comprobara su correspondencia con la tabla DAT_LLAMADAS. Si existe una llamada con ese UCID, cambiara el estado de la llamada para que sea procesada correctamente. En caso contrario, es movida a la carpeta ''/var/lib/recordNodo/grabError''.

===== escobaGrabsBd.pl =====
Se ejecuta sobre la base de datos de histórico, normalmente se ejecuta en un servidor de grabación (recordCentral). El proceso hace una búsqueda en dos tablas:
* En DAT_SEGMENTOS obtiene todos aquellos segmentos con grabaciones que dieron error, su estado tendrá valor 120.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]
* En DAT_LLAMADAS obtendremos todos los registros correspondiente al segmentos anteriores.
Después hace una búsqueda en el sistema, usando como ruta el campo D_HORA_INICIO de cada llamada, que indica la ruta entera donde se encuentra el archivo. Una vez encontrado el archivo cambia el estado del segmento que tenia un error a estado de grabación disponible , que tendrá valor 100. Si no encontramos el segmento, no realizara nada.

==== recordCentral ====
Se considera como un servidor de grabaciones. Todas las grabaciones de llamadas son un activo importante y una empresa con Contact Center pueda recibir millones de llamadas que necesitan estar registradas y almacenadas en discos duros con gran capacidad, dichas maquinas donde suelen alojarse estos servidores poseen discos duros limitados, lo que hace necesario en algunos casos incorporar ''dispositivos NAS''.

Los ''dispositivos NAS'' son dispositivos de almacenamiento conectados a una red que permite el almacenamiento y la recuperación de datos desde una ubicación centralizada, flexibles y escalables, lo que significa que a medida que necesite almacenamiento adicional, puede añadirlo al que tiene. Esto no indica que sea necesario poseer de ''dispositivos NAS'' para funcionar, sino que puede tomar datos de diferentes sitios.

En '''recordCentral''' pueden existir tres tipos de dispositivos NAS:
* Uno dedicado para las llamadas
* Uno dedicado para los segmentos
* Uno mixto para todas las llamadas y segmentos.

El '''recordCentral''' se encarga de recoger todas las grabaciones de segmentos que tienen de estado proceso(3) en cada nodo gestionado, es decir, coger aquellos segmentos de llamadas marcados como llamadas disponibles, intenta descargar los segmentos de las llamadas y convertirlas al formato adecuado (MP3).
Como una característica particular cada diez minutos, siempre que no tenga ninguna otra tarea, intenta ver si puede establecer conexión con un nodo en cuarentena, para sacarlos de cuarentena y recoger todas las grabaciones de segmentos disponibles, para intentar convertir y descargar todas las grabaciones.

A efectos de diagnósticos, desde un SSH se ejecuta el comando '''''nc ip_maquina 1114''''' en la maquina donde creamos que debe estar ejecutando el proceso recordCentral. Ejemplo:
'''root@smadavacdrecord1:~# nc localhost 1114'''
recordCentral SIS ver='01.2' inic='20140423 094058' alarmas=11041 ultAlar='20140423 160112'
recordCentral MYSQL cnx=1
recordCentral NAS llamadas=1 segmentos=1
recordCentral REC llamNum=24901 llamErr=0 segmNum=38906 segmErr=0 retraso=305
recordCentral NODO fase=0 cuarentena='' descarga='8,6,4,7,10,9' gestion='4,6,7,8,9,10'
La explicación de los campos se muestra en la tabla siguiente:

{| class="wikitable"
|-
! Parámetro !! Descripción
|-
| SIS/ver || Versión del proceso
|-
| SIS/inic || Fecha de de arranque del proceso
|-
| SIS/alarmas || Alarmas desde arranque
|-
| SIS/ultAlar || Fecha de última alarma
|-
| MYSQL/cnx || Conectado (1) a MySQL
|-
| NAS/llamadas || Alojamiento en NAS de llamadas activo (grabación de llamada completa en un único archivo)
|-
| NAS/segmentos || Alojamiento en NAS de segmentos activo
|-
| REC/llamNum || Llamadas procesadas
|-
| REC/llamErr || Llamadas con error
|-
| REC/segmNum || Segmentos procesados
|-
| REC/segmErr || Segmentos con error
|-
| NODO/fase || Número de proceso de recordCentral
|-
| NODO/cuarentena || Lista de nodos en cuarentena, separada por comas
|-
| NODO/descarga || Lista de nodos en descarga, separada por comas
|-
| NODO/gestion || Lista de nodos gestionados, separada por comas (cuarentena + descarga = gestión)
|}

Como complemento a los diagnósticos:
* Podremos examinar el fichero de configuración del proceso en '''/etc/MDtel/recordCentral.pconf'''



* Podremos examinar los logs del proceso en '''/var/log/recordCentral.log'''

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==== recordNodo ====
Se considera como proceso con función de agente de grabación para un nodo. Solo debe existir uno por maquina o por nodo (configurado como grabador) en el '''portal de administración de ''VIVA''it'''.

Para su funcionamiento utiliza un ''disco RAM'' por que su tiempo de acceso mejora drásticamente, debido a que la memoria RAM es varios órdenes de magnitud más rápida que las unidades de disco reales, haciendo que la velocidad de procesamiento de las grabaciones sea mucho mas rápida.

Este ''disco RAM'' normalmente ocupa la mitad de la memoria RAM de una maquina pero no es obligatorio pues dependerá de la memoria disponible en cada maquina, y además, se configura con un tamaño no superior a 2GB de memoria RAM. Hay que tener especial cuidado en que no se llene en espacio ni tampoco los i-nodos. Se puede monitorizar a través de la aplicación '''zabbix'''.

El '''''recordNodo''''' se encarga de recoger todas las grabaciones de segmentos que tienen de estado ''proceso(2)'', es decir, aquellos segmentos de llamadas que han sido grabadas pero no están siendo procesadas, moviéndolas del ''disco RAM'' a su carpeta correspondiente.

La forma de obtener la carpeta correspondiente es obteniendo el dato del campo D_HORA_INICIO en la tabla DAT_LLAMADAS para cada segmento,tras un tratamiento del campo creara la subruta correspondientes: /año/mes/dia/hora/min. Entonces, la ruta correcta seria /var/lib/recordNodo/grabaciones/año/mes/dia/hora/min, donde año, mes, dia , hora y min son los valores numéricos obtenidos del campo D_HORA_INICIO.

A efectos de diagnósticos, desde un SSH se ejecuta el comando '''''nc ip_maquina 1113''''' en la maquina donde creamos que debe estar ejecutando el proceso recordNodo:

root@smadavgw5:~#nc localhost 1113
recordNodo SIS ver='04.00.00' inic='20160326 105137' alarmas=2 ultAlar='20160326 105542'
recordNodo MYSQL cnx=1
recordNodo REC grabNum=0 grabErr=0

La explicación de los campos se muestra en la tabla siguiente:
{| class="wikitable"
|-
! Parámetro !! Descripción
|-
| SIS/ver || Versión del proceso
|-
| SIS/inic || Fecha de arranque del proceso
|-
| SIS/amarmas || Alarmas desde arranque
|-
| SIS/ultAlar || Fecha de última alarma
|-
| MYSQL/cnx || Conectado (1) a MySQL
|-
| REC/llamNum || Llamadas procesadas
|-
| REC/llamErr || Llamadas con error
|-
| REC/segmNum || Segmentos procesados
|-
| REC/segmErr || Segmentos con error
|}

Como complemento a los diagnósticos:
* Podremos examinar el fichero de configuración del proceso en '''/etc/MDtel/recordNodo.pconf'''


* Podremos examinar los logs del proceso en '''/var/log/recordNodo.log'''

==== Vivait-CTI ====
Permite la comunicación entre la aplicación '''''VIVA'''''it Desk de agente y el asterisk, sincronizando; convierte el protocolo “asterisk manager” a CSTA ('''''VIVA'''''it Desk “habla” CSTA).

Es un proceso importante para que el uso de '''''VIVA'''''it Desk, y que los agentes puedan realizar su operativa normal con la entrada y salida de llamadas… si bien el cursado telefónico de llamadas es factible, no disponer de las facilidades de '''''VIVA'''''it Desk y formularios hace el sistema difícilmente manejable

A efectos de diagnósticos, desde un SSH se ejecuta el comando “nc ip_maquina 1111”

'''root@vivait-acd:~# nc localhost 1111'''
vivait-cti sis ver='V01.5' inic='20140414 104312' alarmas=13 ultAlar='20140415 173152'
vivait-cti gmp msj=1018/1024 buf=1023/1024 tarea=97/102
vivait-cti tmp uptime=694748 (8d 0h 59m 8s)
vivait-cti cti numConx=(0/511) numPend=(0/127) numMakeCallPend=0 numCall=(0/2047)
numChan=(0/4095) numAuxStr=(0/511) numMoniColas=(0/511) numMoniDevice=0
numMoniCall=0 numMoniCallAuto=0 numMoniCallByDevice=0 numMoni=(0/511)
auditCallErr=0 auditAuxStrErr=0 auditMsjReqErr=0 araChanID=0 araUniqueID=0 araMoni=0
vivait-cti ami esta=conx resp=652(0) evs=1397(0) descar=556(0) err=16 errConx=16
numAct(0/0/127) auditErrAct=0

Donde cada parámetro monitorizado indica:

{| class="wikitable"
|-
!ver!!Versión del proceso
|-
|sis/inic||Fecha de de arranque del proceso
|-
|Sis/alarmas||Alarmas desde arranque
|-
|Sis/ultAlar||Fecha de última alarma
|-
|Gmp/msj||
|-
|Gmp/buf||
|-
|Gmp/tarea||
|-
|Tmp/uptime||
|-
|Cti/numConx||Número de conexiones actuales / Número de conexiones máximo
|-
|Cti/numPend||
|-
|Cti/numMakeCallPend||Llamadas pendientes de realizar
|-
|Cti/numcall||
|-
|Cti/numChan||
|-
|Cti/numAuxStr||
|-
|Cti/numMoniColas||Número de colas monitorizadas
|-
|Cti/numMoniDevice||
|-
|Cti/numMoniCall||
|-
|Cti/numMoniCallAuto||
|-
|Cti/numMoniCallByDevice||
|-
|Cti/numMoni||
|-
|Cti/auditCallErr||
|-
|Cti/auditAuxStrErr||
|-
|Cti/ auditMsjReqErr||
|-
|Cti/ araChanID||
|-
|Cti/ araUniqueID||
|-
|Cti/ araMoni||
|-
|Ami/esta||Estado de conexión contra manarger de asterisk
|-
|Ami/resp||
|-
|Ami/evs||Número de eventos (último minuto)
|-
||Ami/descar
|-
|Ami/err||Errores
|-
|Ami/errConx||Errores de conexión
|-
|Ami/numAct||
|-
|Ami/auditErrAct||
|-
|}

Como complemento a los diagnósticos:

* Podremos examinar el fichero de configuración del proceso en '''/etc/MDtel/vivait-cti.conf'''
* Podremos examinar los logs del proceso en '''/var/log/vivait-cti.conf'''

==== Phoneprov-TFTP ====

==== Introducción al aprovisionamiento ====

En cada Centralita Telefónica existente, se puede configurar sus teléfonos IP y asignarles extensiones a cada teléfono. Para hacer un ''aprovisionamiento'' de los teléfonos es necesario que el técnico configure uno a uno manualmente utilizando su interfaz web, esto no es práctico, ya que genera muchos errores y el tiempo de implementación se incrementa drásticamente. Además, es casi imposible la administración cotidiana de los teléfonos IP. Desde '''MD'''tel se utiliza una herramienta que permite que los teléfonos IP soportados y homologados por '''MD'''tel ([[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_3.0#Terminales_telef.C3.B3nicos ver Terminales telefónicos]]) se puedan aprovisionar automáticamente, brindando una fácil implementación y administración cotidiana.

===== ¿Qué es aprovisionar? =====

Aprovisionar un teléfono es el proceso de configuración automático de teléfonos IP para su uso con una Centralita Telefónica de forma remota. Una vez que aprovisione un teléfono, el teléfono automáticamente se configurará correctamente y podrá administrar los teléfonos de forma centralizada y remota, sin tener que iniciar sesión en la interfaz web de cada uno de los teléfonos.

El aprovisionamiento de teléfono facilita enormemente la administración cotidiana de los teléfonos IP. Esto hace que sea fácil de cambiar las contraseñas de extensión,realizar desvíos de llamadas, nombre a mostrar, mensajería y demás configuraciones, ya que puede hacerlo de forma centralizada para todos los teléfonos desde el portal de administración y luego transferir los cambios al teléfono.

===== TFTP =====

'''TFTP''' son las siglas de '''T'''rivial '''F'''ile '''T'''ransfer '''P'''rotocol ''(Protocolo de transferencia de archivos trivial)''.

Es un protocolo de transferencia muy simple semejante a una versión básica de FTP. TFTP a menudo se utiliza para transferir pequeños archivos entre terminales en una red.

Algunos detalles del TFTP:

* Utiliza UDP (puerto 69) como protocolo de transporte (a diferencia de FTP que utiliza los
puertos 20 y 21 TCP).
* No puede listar el contenido de los directorios.
* No existen mecanismos de autenticación o cifrado.
* Se utiliza para leer o escribir archivos de un servidor remoto.
* Soporta tres modos diferentes de transferencia, "netascii", "octet" y "mail”.

===== Funcionamiento del servidor phoneprove-TFTP =====

A continuación se muestra un esquema que facilita el entendimiento del funcionamiento del servidor phoneprove-TFTP:

[[Archivo:Funcionamiento_Servidor.png‎ |center]]

El servidor Phoneprove-TFTP se ''encarga del aprovisionamiento masivo de terminales'', es de gran utilidad porque cualquier cambio en los teléfonos pueden ser realizados a nivel DHCP y todos los teléfonos tomarán la nueva configuración luego de reiniciarlos.

Desde phoneprove-TFTP se generara los archivos necesarios para cada teléfono y que sirven para ser aprovisionados automáticamente.
El servidor phoneprove-TFTP tiene alojados los ficheros de configuración están ordenados según las direcciones MAC de los teléfonos. El teléfono “preguntará” al servidor cual es su fichero de configuración utilizando su dirección MAC. Este a través de su MAC , consulta en la base de datos para ofrecer al terminal los datos de configuración según su plantilla, cual sera su extensión , cual sera el usuario propietario, entre otras cosas.

{|
|-
|
'''Nota:''' En instalaciones grandes habrá más de uno, quizás uno por sede grande; depende de la infraestructura de DHCP.
|}

===== Parámetros necesarios de Aprovisionamiento de Teléfonos =====

'''Notas:''' el aprovisionamiento desarrollador por '''MD'''tel, no emplea un fichero por cada
teléfono, sino que emplea una plantilla por cada modelo de teléfono.
Debe haber una '''configuración previa del servidor DHCP''' es necesario coordinar con el cliente la asignación de direcciones para
los diferentes elementos de la plataforma '''''VIVA'''''it, fundamentalmente para terminales telefónicos; en este caso además será necesario
activar la opción 66 que permitirá definir el servidor TFTP del que los terminales cogerán sus ficheros de aprovisionamiento.
El aprovisionamiento desde el portal de administración solo es posible para aquellos teléfonos IP homologados y probados desde '''MD'''tel
[[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_3.0#Terminales_telef.C3.B3nicos ver Terminales telefónicos]]

Como existen parámetros comunes de todos los teléfonos de la misma marca de fabricante, muchos de los parámetros necesarios para el aprovisionamiento como comentamos se han generado desde MDtel en forma de plantillas, que estarán disponibles en el portal de administración VIVAit [[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Plantillas | ver plantilla del portal de administración VIVAit]].

La configuración de un teléfono SIP es muy sencilla y en no es necesario tener conocimientos avanzados de informática o de telefonía. Cada una de estas plantillas que sirven para aprovisionar un teléfono IP homologado, algunos de los parámetros predeterminados se explicarán a continuación .

====== Parámetros de Aprovisionamiento globales ======

* Configuración de la red y MAC.
* Zona horaria.

====== Parámetros de Aprovisionamiento Personales ======

Además de los parámetros de aprovisionamiento globales, el teléfono también obtendrá información de configuración individual, tales como:

*Número de Extensión.
*Nombre y Contraseña de usuario SIP.
*Configuración de Teclas BLF.
*Contraseña de la Interfaz Web del Teléfono IP.
*Idioma de la Pantalla.
*Orden de Preferencia de los Codecs.

===== Aprovisionamiento de teléfonos nivel usuario =====

{|
|-
|
'''Notas:''' La dirección MAC debe estar especificada en letras mayúsculas.
La dirección MAC del teléfono se puede encontrar en la etiqueta adhesiva en la parte inferior del teléfono, o de lo contrario se deberá acceder desde
el menú del propio terminal.
|}

Los pasos a seguir son los siguientes:

'''1)''' Dar de alta el teléfono en el portal de administración, se debe seleccionar el modelo del teléfono, e indicar la dirección MAC del teléfono a aprovisionar, todo ello desde el portal de administración VIVAit.
Para mas información ver [[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Aprovisionamiento del portal de administracion| aprovisionamiento del portal de administración VIVAit]].

'''2)''' En el mismo portal de administración se deberá crear una extensión , asignar a la extensión el teléfono que se quiera aprovisionar, elegir la plantilla adecuada del teléfono y el usuario propietario (solo si sera un puesto fijo) desde [[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Extensiones | extensiones del portal de administración]].

'''3)''' Conectar el teléfono a la red LAN informática (conectarlo al router o switch) para que tenga acceso a Internet:

:*El teléfono enviará un mensaje de multidifusión a través de la LAN.
:*Este será captado por la Central Telefónica siempre que esté en la misma LAN.
:*Al teléfono se le enviará una URL de aprovisionamiento.

'''4)''' Como la mayoría de teléfonos IP del mercado al arrancar una vez sabiendo la URL de aprovisionamiento piden una serie de archivos de configuración para aprovisionarse vía TFTP. EL servidor phoneprove-TFTP, detectara la petición y a través de la MAC y datos del usuario, consultará en la base de datos los datos necesarios para aprovisionar al teléfono y si todo funciona correctamente mandara al teléfono IP los datos de configuración necesarios para funcionar.

'''5)''' Asegúrese de que el teléfono encuentren el servidor TFTP, para ello esperar un tiempo adecuado para que termine el aprovisionamiento.

'''6)''' Finalmente aparecerá como registrado en la centralita, obtendrá una dirección IP y podra funcionar según la configuración establecida.

{|
|-
|
'''Nota''': Si no se reaprovisiona tras un periodo largo de tiempo, desenchufe el cable de alimentación eléctrica o el cable Ethernet (si se utiliza la alimentación en línea PoE) para reiniciar los teléfonos.
|}

===== Aprovisionamiento de teléfonos nivel técnico =====

====== Plantilla de configuración ======

La plantilla de configuración empleadas en el apartado [[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Plantillas | plantilla del portal de administración VIVAit]] de cada modelo está formada por una serie de variables.

Los valores se obtienen de la tabla de la base de datos CEN_TELEFONOS, CEN_USUARIOS, ACD_EXTENSIONES, ACD_NODOS, COM_NODOS... correspondientes a la extensión del teléfono, usuario, nodo, etc.

variable ${NODO1_C_NOMBRE}='corp-ast13'
variable ${EXTEN_C_CLAVE_REGISTRO}='Tel21002'
variable ${USU_C_CODIGO_POSTAL}=''28034'
variable ${SEDE_C_CODIGO_POSTAL}='28034'
variable ${USU_C_NOMBRE}='Juan Antonio'
variable ${USU_C_APELLIDO2}='Ramirez'
variable ${SEDE_C_NOMBRE}='RED_LAB'
variable ${NODO2_C_NOMBRE}= NULL
variable ${EXTEN_C_NOMBRE}='' 21002
variable ${USU_C_LOCALIDAD}=''
variable ${USU_C_NOMBRE_MOSTRAR}='Juan'
variable ${NODO1_C_IP}='175.25.129.70'
variable ${MODEL_C_PREFIJO_PLANTILLA_MAC}='T28P'
variable ${SEDE_C_LOCALIDAD}='Madrid'
variable ${USU_C_APELLIDO1}='Casas'
variable ${NODO2_C_IP}= NULL
variable ${TF_ID_EXTENSION}='5'
cargando campos idExten=5

====== Ficheros y paquetes necesarios ======

'''Paquetes previos:''' libnet-tftpd-perl, tftp-hpa, libnet-address-ip-local-perl
'''Usuario de funcionamiento:''' root

{|
|-
|
'''Nota:''' los archivos y directorios que generemos podrian necesitar que se permitiera el acceso al archivo de lectura y escritura en el servidor TFTP.
|}

'''Archivos necesarios:'''

/usr/local/sbin/phoneprov-tftp.pl
/usr/local/sbin/phoneprov-tftp.pm
/etc/MDtel/phoneprov-tftp.pconf
/etc/init/phoneprov-tftp.conf
/etc/logrotate.d/phoneprov-tftp

'''Directorios a crear:'''

/var/lib/phoneprov-tftp/plt
/var/lib/phoneprov-tftp/bin

==== Watchdog ====

Se trata de una aplicación del asterisk que monitoriza el SIP y en caso de fallo, pasado un cierto tiempo, reinicia el asterisk y genera un core.
Si escribimos en CLI de asterisk perro tenemos los siguientes comandos:

{| class="wikitable" border="0" style="background:#ffffff" align="top"
|-
|Activar||Activar el Watchdog
|-
|Desactivar||Desactiva el Watchdog
|-
|Parada||Reinicia el asterisk y genera un core para pruebas
|-
|Reload||Realiza una recarga del Watchdog y aplica cambios en su configuración
|-
|Show||Ver el estado del Watchdog

perro avisado=0 activo=1 segsDormir=1 segsInic=60 segsGuarda=30 maxErr=3
perro nombre=sip_monitor_udp lwp=[15437] segsInic=60 segsGuarda=30 hace=11 err=0/5
|-
|}

El dato "hace" informa de cuanto tiempo ha transcurrido desde el último tick. Facilita la calibración del parámetro de configuración "segs_guarda", normalmente es 30

Tiene un fichero de configuración ubicado en /etc/asterisk/MDcrash.conf

{| class="wikitable" border="0" style="background:#ffffff" align="top"
|-
|Sección [perro]
||activo=yes (Si esta o no activo)
segs_dormir=1 (Un tick por segundo)

segs_inic=60

segs_guarda=30

max_errores=3
|-
|Sección [sip_monitor_udp]
||segs_inic=60

segs_guarda=30 (Cada 30 segundos si no reciba trafico SIP genera core)

max_errores=5 (Número máximo de errores)
|-
|}



==== Proceso de Backup ====
Las plataformas '''''VIVA'''''it Call y '''''VIVA'''''it Suite incluyen un script para realizar un proceso de backup.

Se utilizará el script '''backup.sh''', que se encuentra en el directorio '''etc/MDTel'''.

Se ejecuta automaticamente mediante el uso de un cron

'''texto del cron:'''

SHELL=/bin/sh
PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
# m h dom mon dow user command
0 2 * * * root /etc/MDtel/backup.sh /etc/MDtel/backup.cfg

Para activar el script hay que descomentar la línea
# m h dom mon dow user command

Los directorios de los que se hace copia son:
* DIR=var/lib/asterisk/sounds/Particular
* DIR=var/lib/asterisk/moh
* DIR=etc
* DIR=etc/asterisk
* DIR=etc/cron.d
* DIR=etc/dahdi
* DIR=etc/exim4
* DIR=etc/ha.d
* DIR=etc/logrotate.d
* DIR=etc/MDtel
* DIR=etc/mysql
* DIR=etc/network
* DIR=etc/zabbix
* DIR=usr/local/sbin

Por defecto se realiza un backup cada dos horas en la carpeta '''/var/spool/MDtel/backup'''.

Para cambiar la ruta de destino del backup habrá que modificar el fichero backup.sh, en concreto modificar la variable MDTEL.

El fichero ''' backup.cfg''' que se genera incluye copia de la siguiente información:
* Ficheros de configuración de la aplicación.
* Base de Datos.
* Dialplan.

Se guardarán 10 copias del fichero ''' backup.cfg '''

Para recuperar una plataforma utilizando el backup, habrá que instalar una máquina nueva y cargar los ficheros de configuración, Base de Datos y Dialplan guardados en el proceso de backup.

=== Requerimientos de conectividad ===

El esquema siguiente muestra como ejemplo todos los flujos de información existentes en un entorno típico de <big>'''telefonía corporativa (sin presencia)'''</big> ('''''VIVA'''''it Call)

[[Archivo:Flujos corporativa.png|cebter]]

En el entorno de <big>'''Contact Center'''</big>, encontramos los siguientes flujos <big>'''entre servicios'''</big> (comunicaciones entre servidores, ('''''VIVA'''''it Suite))

[[Archivo:Flujos Contact servicios.png|650px|center]]

y <big>'''entre usuarios y servicios'''</big> los reflejados a continuación:

[[Archivo:Flujos Contact puestos.png|600px|center]]

{| class="wikitable"
|-
!Lado A!!Lado B!!Puertos!!Sentido!!Observ.
|-
|Terminal telefónico||Servidor||TCP 5060||A -> B||Señalización SIP
|-
|Terminal telefónico||Servidor||UDP 5060||A -> B||Señalización SIP
|-
|Terminal telefónico||Servidor||10000 a 20000||A -> B
B -> A
||RTP
|-
|Terminal telefónico||Servidor TFTP||UDP 69||A -> B
B -> A
||Para actualización de terminales por TFTP
|-
|Terminal telefónico||Servidor NTP||UDP 123||A -> B||
|-
|'''''VIVA'''''it Desk||Servidor||TCP 4500||A -> B||Comunicación CTI
|-
|'''''VIVA'''''it Desk||Servidor||TCP 3306||A -> B||Acceso a Mysql Base de datos
|-
|'''''VIVA'''''it Desk||Servidor Syslog||UDP 514||A -> B||Para envio de logs de agente
|-
|'''''VIVA'''''it Supervisor||Servidor||TCP 3306||A -> B||Acceso a Mysql Base de datos
|-
|'''''VIVA'''''it Tracker||Servidor||TCP 3306||A -> B||Acceso a Mysql Base de datos
|-
|'''''VIVA'''''it Tracker||Servidor||TCP 8180||A -> B||
|-
|Actualizador||Servidor||TCP 80||A -> B||Necesario para actualizaciones de versiones de aplicaciones de agente y supervisores
|-
|Portal de administración||Servidor||TCP 8180||A -> B||Acceso al portal de administración '''''VIVA'''''it Suite
|-
|'''''VIVA'''''it Tracker Web||Servidor||TCP 8180||A -> B||
|-
|Monitor||Servidor||TCP 8180||A -> B||Wallboard
|-
|Monitorización||Servidor||TCP 80||A -> B||Acceso a portal monitorización (Zabbix)
|-
|}

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Gateways ===
El concepto de gateway como tal no existe en la plataforma '''''VIVA'''''it; existen nodos de ACD y nodos de corporativa.

A efectos de operación un nodo de corporativa es el que en cualquier caso asumirá las funcionalidades de gateway, y recibirá las conexiones (analógicas, digitales o IP) a sistemas externos o a la RTC

El concepto gateway queda pues suscrito a entornos meramente comerciales

Incluimos no obstante en este apartado los diagnósticos y operaciones básicos de conexiones a sistemas externos o RTC

Para verificar los enlaces establecidos ejecutamos el siguiente comando en el terminal: '''sip show peers'''

Al ejecutar este comando obtenemos la salida:

[[Archivo:Enlace_Exterior.png |center]]

Las columnas ''Host'' y ''Port'' nos muestran las conexiones establecidas y nos informa de un posible problema de conexión.

Sabremos que ''no existe conexión'' cuando la columna Host tiene el valor '''Unspecified''' y en la columna Port aparece un '''0''' , a continuación se muestra un ejemplo:

[[Archivo:Ejemplo_no_conexion.png |center]]



=== Servidor de grabación ===
==== Almacenamiento en la nube ====
Almacenamiento en la nube.
Existe la posibilidad de que tras un determinado periodo de tiempo las grabaciones sean movidas a un almacenamiento externo. De esta operativa se encarga el proceso /usr/local/sbin/mueveGrabaciones.pl que recibe como parámetro la ruta al archivo de configuración. Dicho archivo tiene los siguientes elementos:

*$db: Nombre de la base de datos.
*$dbHost: servidor de MySQL
*$dbPort: Puerto del MySQL.
*$dbUsuario: Usuario de conexión a MySQL.
*$dbClave: Clave del usuario anterior.
*$dirBase: Directorio donde residen las grabaciones
*$diasCaducidad: Dias de antigüedad para mover las grabaciones
*$sftpHost: Servidor SFTP de destino
*$sftpPort: Puerto SFTP.
*$sftpUsuario: Usuario SFTP.
*$sftpClave: Clave del usuario SFTP.
*$simula: Si este campo vale 1, las grabaciones se copian, pero no se borran del directorio original, ni se actualiza su ubicación en la base de datos.

La grabación indica donde se encuentra mediante el campo E_UBICACION_GRABACION, que puede tener los siguientes valores:
*Sin definir (0)
*En línea (10): Las grabaciones se encuentran en el servidor de grabaciones.
*Fuera de línea (20): las grabaciones se encuentran en una ubicación externa.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Reporting ===
La aplicación de reporting en general no tiene procesos habituales de operación y mantenimiento.
Los informes son obtenidos desde la interfaz gráfica o mediante un procedimiento de scripting, descritos en “Formato de fichero de intercambio para '''''VIVA'''''it Reporting”.

==== Formato de fichero de intercambio para '''''VIVA'''''it Reporting ====
{| class="wikitable"
|-
! Nombre !! Descripción !! Ejemplo
|-
| colspan="3"| Selección de registros
|-
| SQL_selec || Expresión SQL que se añadirá al where a la SQL principal. || C_ORIGEN like '6%' and C_COD_CLIENTE= '023'
|-
| SQL_select_leido || Filtro de selección legible
|| Skill igual a 60310
|-
| SQL_orden || Lista de campos por los que se ordenará, después de los que estén ya definidos en la plantilla. || C_ORIGEN, C_COD_CLIENTE
|-
| colspan="3"| Salida
|-
| FIC_extension || Extensión de fichero de salida: PDF, XLSX, CSV || PDF
|-
| FIC_tipo_entrega || 'P': Pantalla, 'D': Directorio, 'C': Correo || D
|-
| FIC_destino || Si 'C', dirección de correo, si 'D', ruta del directorio || D:\informes\
|-
| colspan="3"| Plantilla
|-
| INF_modelo || Ruta del fichero de plantilla || C:\Modelos\llamadas.rep
|-
| INF_descripción || Descripción del informe || Informe detallado de llamadas
|-
| colspan="3"| Base de datos
|-
| BD_ip || IP o nombre de máquina ||
|-
| BD_puerto || Puerto de MySQL ||
|-
| BD_base_datos || Nombre de base de datos ||
|-
| BD_usuario || Usuario de base de datos ||
|-
| BD_clave || Clave de acceso cifrada ||
|-
| colspan="3"| Parámetros
|-
| PAR_desde_vis || Fecha inicial de selección en formato legible (o '-' si no hay) || 01/01/2016
|-
| PAR_hasta_vis || Fecha final de selección en formato legible (o '-' si no hay) || 31/01/2016
|-
| PAR_01 || Parámetro opcional ||
|-
| .. || .. ||
|-
| PAR_20 || Parámetro opcional ||
|}

El fichero tendrá un nombre único para permitir la generación simultánea de informes.
El fichero es borrado por la aplicación de forma automática.
Se pasa a la aplicación de generación de informes como parámetro. Por ejemplo:
“C:\Archivos de Programa\MDtel\Nimitz\LanzaInformes\LanzaInformes.exe”
“C:\Archivos de Programa\MDtel\Nimitz\LanzaInformes\NIM00001.tmp”

Ejemplo de fichero:
{| class="wikitable"
|-
| SQL_selec=(DAT_ACUMULADOS_COLAS.ID_COLA in (11))

SQL_select_leido=Skill igual a 60310

SQL_orden=
FIC_extension=pdf

FIC_tipo_entrega=P

FIC_destino=C:\

INF_modelo=skill_setsi.rep

INF_descripcion=Skill. SETSI

BD_ip=172.25.1.2

BD_puerto=3306

BD_base_datos=nimitz

BD_usuario=nimitz

BD_clave=UIk5jNY9PVX5ogg=

PAR_desde_vis=-

PAR_hasta_vis=-

PAR_01=
|}

==== Resumen de significado de columnas en reporting histórico ====
Esta información se puede consultar en el siguiente enlace:

http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Documentacion_de_usuario_VIVAit_Suite_3.3#Resumen_del_valor_de_las_columnas_que_aparecen_en_los_informes



===== Consideraciones adicionales =====

Los tiempos se insertan en el intervalo en el que se deja ese "estado", esto provoca que en un intervalo pueda ser mayor el tiempo ACD que el tiempo conectado.

''* Ejemplo:''

-Llamada: Duración 15 minutos Hora fin de la llamada 13:01
-Llamada: Duración 20 minutos Hora fin de la llamada 13:24
Suma de las duraciones de las llamadas para el intervalo ''35 minutos'' tiempo
conectado del agente en el intervalo ''30 minutos.''
Cuando los periodos consultados sean mas amplios (diario, mensual) los
desfases tenderán a desaparecer.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

== Otros Diagnósticos y operaciones básicas ==
=== Arranque y apagado de la plataforma ===

En general el arranque y apagado de cada nodo de una plataforma '''''VIVA'''''it es el estándar de un procedimiento ordenado de apagado en una máquina linux: '''"Shutdown -h now"''' o comando de apagado inmediato o programado equivalente

El orden de arranque de la plataforma deberá ser:
# En primer lugar arrancar el nodo con la base de datos de tiempo real
# Una vez finalizado el arranque del punto 1, arrancar el nodo con la base de datos de réplica
# Una vez finalizado el arranque del punto 2, arrancar el resto de nodos en cualquier orden

Al respecto del orden de apagado de nodos, es el siguiente:
# En primer lugar se apagarán, en cualquier orden, los nodos que NO CONTENGAN bases de datos de tiempo real ni bases de datos de réplica
# Una vez apagados totalmente todos los nodos del punto 1, apagaremos el nodo (o nodos) con bases de datos de réplica
# Una vez apagados totalmente todos los nodos del punto 2, se apagará el nodo con la base de datos de tiempo real

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]


=== Grabación ===

==== Configuración de la grabación en la plataforma corporativa ====
Para que una llamada se grabe, lo primero de todo es que alguien tenga la capacidad de grabar. Esto se consigue diciendo al nodo que sea grabador. Esto provoca que el nodo llame al mixmonitor para grabar y se inserte un registro en el DAT_GRABACIONES. Esto no significa que ya las llamadas se vayan a grabar, ya que para eso tiene que ser procesadas por un nodo que sea grabador. Hay tres, llamémosle elementos, que se pueden grabar:

* El nodo, es decir todo lo que el nodo enrute
* Prerutas
* Objetos: que son las extensiones, usuarios, grupos corporativos, etc.

Tenemos tres formas de grabar:

* Grabar con beep periódico
* Grabar sin beep periódico
* Descartar grabación

Si de los tres elementos tenemos que uno grabe, ya sea con o sin beep periódico, esa llamada se va a grabar ya que son OR, en cuanto haya un elemento que diga que grabe se va a grabar.

Al igual pasa si tenemos que un elemento tenga descartar la grabación. La grabación no se inicia.

Referente al campo de Modo de grabación en infraestructura, este no se emplea para la grabación de corporativo, sino que solo tiene validez en ACD. Para grabación en el ACD hay que, como se ha dicho anteriormente poner un nodo que sea grabador y especificar un elemento de los tres que hay cual es el que se va a grabar.

Para que exista una grabación a de existir un segmento asociado a esta. Los segmentos se tratan en las prerutas. Hay un campo es las prerutas que es Generar segmento al enrutar. Si está se generará el segmento del tipo de la preruta y su correspondiente grabación si esta está configurada. Si le decimos que no genere segmentos al enrutar y el sistema está configurado para que grabe, el recordCentral creará un tipo de segmento llamado externo para esa grabación. Podemos configurar si queremos que se cree o no ese segmento, para eso hay que modificar el fichero de configuración del recordCentral y poner un tiempo muy alto al campo $segmExternoMinSegs. También podemos configurar que segmentos queremos que se graben. Por defecto el recordCentral va configurado para que se graben todos los segmentos. Para decirle que solo grabe cierto tipo de segmentos hay que ponerlos los que queramos que si se graben en la variable $tiposSegmentoGrabar del fichero de configuración del recordCentral.

==== Comprobación de que el servidor de grabación esta activo ====

Si al ejecutar el comando '''''nc ip_maquina 1114''''',si no se recibe ninguna respuesta, significa el servidor de grabación no estaría activo.
También usando el comando ''''' ps aux | grep recordCentral ''''', donde si no escribe ningún resultado implica que tampoco esta activo.

==== Comprobación de que los nodos están conectados al servidor de grabación ====

Debemos fijarnos en la linea de respuesta del comando '''''nc ip_maquina 1114''''', que seria:
{| class="wikitable"
|-
| root@smadavacdrecord1:~# nc localhost 1114
recordCentral SIS ver='01.2' inic='20140423 094058' alarmas=11041 ultAlar='20140423
160112'

recordCentral MYSQL cnx=1

recordCentral NAS llamadas=1 segmentos=1

recordCenral REC llamNum=24901 llamErr=0 segmNum=38906 segmErr=0 retraso=305

'''recordCentral NODO fase=0 cuarentena='' descarga='8,6,4,7,10,9' gestion='4,6,7,8,9,10''''
|}

Sabiendo que el parámetro "fase=0" es el numero que identifica el recordCentral, los demás parámetros nos indicaran los nodos disponibles , que funcionan o no en el servidor. Entonces "gestión=4,6,7,8,9,10" indica el id de los nodos que maneja el proceso.

==== Comprobación de que un nodo tiene activo el agente de grabación ====
Si al ejecutar el comando '''''nc ip_maquina 1113''''', no se recibe ninguna respuesta, significa que el nodo no tiene activo el agente de grabación.
También usando el comando ''''' ps aux | grep recordNodo''''', donde si no escribe ningun resultado implica que tampoco esta activo.

==== Comprobación de que un nodo está subiendo archivos de grabación al servidor ====
Debemos fijarnos en la linea de respuesta del comando '''''nc ip_maquina 1114''''', que seria:

{| class="wikitable"
|-
| root@smadavacdrecord1:~# nc localhost 1114
recordCentral SIS ver='01.2' inic='20140423 094058' alarmas=11041 ultAlar='20140423
160112'

recordCentral MYSQL cnx=1

recordCentral NAS llamadas=1 segmentos=1

recordCenral REC llamNum=24901 llamErr=0 segmNum=38906 segmErr=0 retraso=305

'''recordCentral NODO fase=0 cuarentena='' descarga='8,6,4,7,10,9' gestion='4,6,7,8,9,10''''
|}

Fijándonos en "descarga=8,6,4,7,10,9" nos confirma que todos los nodos que maneja el proceso funcionan perfectamente y el servidor puede manejar las grabaciones.

==== Comprobación de grabaciones que se hayan quedado enganchadas en un nodo ====
Podemos fijarnos en los dos comandos, para '''''nc ip_maquina 1114''''':
{| class="wikitable"
|-
| root@smadavacdrecord1:~# nc localhost 1114
recordCentral SIS ver='01.2' inic='20140423 094058' alarmas=11041 ultAlar='20140423
160112'

recordCentral MYSQL cnx=1

recordCentral NAS llamadas=1 segmentos=1

recordCenral REC llamNum=24901 llamErr=0 segmNum=38906 segmErr=0 retraso=305

'''recordCentral NODO fase=0 cuarentena='' descarga='8,6,4,7,10,9' gestion='4,6,7,8,9,10''''
|}

Fijándonos en el campo "cuarentena=''" indica que ninguno de los nodos tiene problemas.

==== Comprobación del estado de ocupación del almacenamiento temporal de grabaciones en un nodo. ====

Desde un SSH ejecuta el comando '''''df - h''''' en la maquina donde creamos que debe estar ejecutando el proceso recordNod:

{|class="wikitable"
|-
! Filesystem !! Size !! Used !! Avail !! Use% !! Mounted on
|-
| udev || 486M || 4,0K || 486M || 1,00% || /dev
|-
| tmpfs || 100M || 416K || 99M || 1,00% || /run
|-
| '''/dev/vda1''' ||''' 236M''' ||''' 68M''' ||''' 156M''' ||''' 31,00% '''||''' /boot'''
|-
| tmpfs || 100M || 48K || 100M || 1,00% || /var/spool/asterisk/monitor

|}

Nos fijaríamos en la línea marcada en negrita, el campo "Use%" indicara el porcentaje de almacenamiento temporal de grabaciones en un nodo.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

===Escuchas e intrusiones en asterisk===
'''CallSpy''' es una aplicación elaborada para asterisk que permite a un usuario realizar escuchas e
intrusiones en llamadas.
En realidad tenemos dos aplicaciones en asterisk, CallSpy y CallSpyee.
====CallSpy ====
{|
|-
|
'''Nota:''' Como mucho se pueden tener a dieciséis personas al mismo tiempo usando esta aplicación.
|}

Como hemos mencionado anteriormente, esta aplicación permite la escucha de llamadas y,
opcionalmente, realiza la función de intrusión. Tiene tres opciones de configuración obligatorios
que mostramos a continuación:

{|
|-
|
CallSpy(<tipoEspiado>,<expRegEspiado>,<parametrosConf>)

|}
La opción '''<tipoEspiado>''' se refiere a que tipo de objeto que podemos espiar correspondiente, solo debe elegirse un único tipo:
*'''c:''' escuchar una cola
*'''v:''' escuchar un vdn
*'''a:''' escuchar a un agente
*'''e:''' escuchar extensión
La opción '''<expRegEspiado>''' representa el número de la cola, VDN, agente o extensión que queremos escuchar. Tiene que ser una expresión regular.
La opción '''<parametrosConf>''' se refiera a los parámetros de configuración para la llamada que podemos espiar, se pueden combinar o juntar :
*'''q:''' Desactiva el 'beep' al comienzo de cada nueva llamada.
*'''v([value]):''' Ajusta el volumen en el rango -4 a 4 (más alto, mas volumen).
*'''e:''' Habilita el que se pueda cambiar a otra llamada de la misma extensión.
*'''w:''' Habilita el que se pueda activar la intrusión (whisper).
Una vez iniciada la escucha, solo falta que entre una llamada al objetivo que estemos espiando. Al
iniciar la escucha, se puede hacer lo siguiente:
*Pulsando '''#''' modifica el volumen de escucha.
*Pulsando '''*''' cambia a una nueva llamada.
*Pulsando '''1''' si esta habilitado, cambia a otra llamada de la misma extensión.
*Pulsando '''2''' si esta habilitado, inicia la función de intrusión.
*Pulsando '''3''' desactiva la función de intrusión.
====CallSpyee (espiado)====
Mediante esta aplicación indicamos los parámetros que permite a una llamada ser seleccionada para
escuchar. Las opciones de configuración son:
{|
|-
|
CallSpyee([CID_NUM],[cola],[vdn],[agen],[exten])
'''Nota:'''No son parámetros obligatorios, por lo que no hace falta rellenar todos los campos pero si respetar sus posiciones separadas por comas.
|}
La explicación de los parámetros es la siguiente:
*'''CID_NUM:''' representa el call ID de la llamadas
*'''cola:'''representa el número de la cola que se quiere espiar (${QUEUE} ).
*'''vdn:''' representa el número del VDN que se quiere espiar (${VDN} ).
*'''agen:''' representa el número del agente que se quiere espiar.
*'''exten:''' representa el número de la extensión que se quiere espiar (${EXTENSION}) .

Por ejemplo si queremos escuchar todas las llamadas en las que participa una extensión determinada pondremos en la macro de extensiones:
{|
|-
|
exten => s,n,CallSpyee(,,,${EXTENSION})
|}

====Cambios para el dialplan de asterisk====
El funcionamiento de este tipo de servicio conlleva un cambio en el dialplan de asterisk. En cada macro correspondiente se pondrá los diferentes CallSpyee para VDN, colas , extensiones y agentes.
Pasos a seguir:
*Paso 1. Creación de un código de intrusión para cada tipo según necesidad (cola, VDN, agente y
extensión).
{|
|-
|
Ejemplo '''MD'''tel: declaramos como código de intrusión a Agente *44*NUMERO
;==========================================
;======== Intrusion a Agente
;==========================================
exten => _*44*X.,1,set(CadMarcar=intrusionEspiado)
exten => _*44*X.,n,set(DesL=SERVICIO)
exten => _*44*X.,n,set(datoServicio=^${EXTEN:4})
exten => _*44*X.,n,Goto(finMacro,1)
'''Nota:''' En la tercera línea podemos observar la expresión regular que se le pasara al CallSpy correspondiente con el número marcado por el espia. 
|}

*Paso 2.Llamar a CallSpy con la configuración deseada.
{|
|-
|
Ejemplo '''MD'''tel: llamada a CallSpy especificando que vamos a espiar una cola (la c del primer parámetro, con la
extensión introducida en el código de intrusión y con whisper, es decir, función de intrusión habilitada.
;------------------------------------------------------------------------
; Intrusion a Espiado
;------------------------------------------------------------------------
exten => intrusionEspiado,1,NoOp
exten => intrusionEspiado,n,GotoIf($["${datoServicio}"=""]?colgar)
exten => intrusionEspiado,n,CallSpy(c,${datoServicio},w)
exten => intrusionEspiado,n(colgar),Hangup
|}
* Paso 3. Llamar a CallSpyee con la configuración de las llamadas candidatas a ser escuchadas.
{|
|-
|
Ejemplo '''MD'''tel:
exten => s,n,CallSpyee(,,,,${EXTENSION}) → Para extensiones
exten => s,n,CallSpyee(,${QUEUE},,,) → Llamadas espiadas por cola
exten => s,n,CallSpyee(,,${VDN},,) → Llamadas espiadas por VDN
|}

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Calendarios ===

Para la configuración de los Calendarios se hace uso de '''CalDAV''', estándar de Internet que permite a un cliente acceder a información de planificación en un servidor remoto. Permite que varios clientes accedan a la misma información, facilitando la cooperación. Muchas aplicaciones, tanto clientes como servidores, son compatibles con este protocolo.

Si deseamos crear un calendario en la plataforma '''VIVAit''' podemos hacerlo siguiendo el siguiente enlace:
Para comprobar que el servidor de calendarios funciona correctamente bastaría con cargar en la barra de direcciones la siguiente url: [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Calendarios |Calendarios]]

http://${NODO.HOST}/dav/html/cal.php/calendars/${DAV.CUENTA}/${DAV.CALENDARIO}

donde,

* '''NODO.HOST:''' es la ip del servidor calendar
* '''DAV.CUENTA:''' hace referencia a la cuenta de usuario
* '''DAV.CALENDARIO:''' hace referencia el nombre de la cuenta

Una vez que se carga la url sabremos que el servidor funciona correctamente si visualizamos lo siguiente:

[[Archivo:Captura de pantalla de 2016-07-21 12_43_58.png || 1020px|center]]

Si el sistema nos pide usuario y clave querrá decir que el servidor de calendarios está operativo en esa maquina

Para comprobar que funciona en la consola de asterisk usaremos los comandos
calendar show calendars
calendar show calendar [nombreCalendario]

'''Nota:''' Debido bugs detectados, el proceso requerirá:
- La realización de una sincronización manual de la sección "mdcal" desde el portal de administración
- Añadir la línea '''''#include "/etc/asterisk/mdcal.conf"''''' en el fichero calendars.conf y hacer "reload" de asterisk
- En la máquina donde esté instalado el servidor de calendarios apuntar a la IP de la BDTR (/var/www/dav/config.php)

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Syslog de agentes ===
'''''Syslog''''' es un estándar para el envío de mensajes de registro en una red informática IP. Por '''''Syslog''''' se conoce tanto al protocolo de red como a la aplicación o biblioteca que envía los mensajes de registro. Se lanza automáticamente al arrancar un sistema Unix, y es el encargado de guardar informes sobre el funcionamiento de la máquina (eventos, seguridad del sistema, etc) pero puede contener también cualquier información como mensajes de las diferentes partes del sistema (núcleo, programas...) y los envía y/o almacena en diferentes localizaciones transmitiéndose mediante un puerto UDP. Esto permite concentrar los registros de múltiples máquinas en un único punto simplificando la labor de gestión al administrador siendo habitual que múltiples dispositivos lo soporten.

El formato del mensaje se compone de tres campos :

* La cabecera contiene la prioridad, fecha y hora del mensaje, máquina, proceso (nombre e identificador) que lo ha generado y la versión del protocolo utilizado.
* Una serie de pares clave-valor con metadatos.
* El texto del mensaje.

Si es necesario podemos activar el registro de todos los eventos telefónicos que realiza un agente ACD llamado '''Syslog de agentes'''. Su activación se realiza mediante el '''portal de administración ''VIVA''it''' configurando unos parámetros para un usuario llamado ''Rastreo BBDD" y ''Rastreo Syslog''. Para más información[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Pesta.C3.B1a_ACD | ver sección Portal de administración - General - Usuarios - Pestaña ACD ]].

{| class="wikitable" border="0" align="top"
|-
| align="center" style="background:Lavender; color:Black" |<big>'''Elemento'''</big>
|align="center" style="background:Lavender; color:Black" | <big>'''Procedimiento'''</big>
|-
!colspan="2" width="60 px" style="background:Lavender; color:Black"|Operacion
|-
|Ubicación del proceso||Script arranque: /etc/init/ rsyslog.conf
Configuración :
/etc/rsyslog.d/30-vivait-
desk.conf
|-
|Arranque||service rsyslog start
|-
|Parada||service rsyslog stop
|-
|Reinicio||service rsyslog reload
|-
!colspan="2" width="60 px" style="background:Lavender; color:Black"|Diagnostico
|-
|Registro de logs||/var/log/MDtel/vivait-desk.log
Fichero del día actual. se guardan los 30
anteriores comprimidos en tar.g
|}

=== Generación de un Core ===
Un Core es la memoria de un programa.

Para generar un Core rápido con Asterisk hay que hacer lo siguiente:

Ejecutar ps aux | grep asterisk y coger el PID del programa
gdb /usr/sbin/asterisk [PID]
gcore [file]

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

==Funcionalidades específicas ==
=== Mecanismo de prioridad adaptativa ===

El mecanismo de prioridad adaptativa permite en una plataforma '''''VIVA'''''it Suite establecer prioridades en las que se tenga en cuenta el tiempo de espera de las llamadas en cola, proporcionando una alternativa al mecanismo de prioridad absoluta que existe por defecto

==== Introducción ====

Este documento presenta una propuesta de mecanismo de asignación de llamadas en colas a agentes basado no solo en las prioridades de agente a cola,
sino en un factor de corrección de prioridad derivado del tiempo de espera de una llamada

==== Terminología ====

* '''Prioridad de llamada:''' A cada llamada susceptible de ser atendida en el ''Call Center'' se le asignará una prioridad de llamada; dicha prioridad será asignada cada vez que un agente quede disponible.
* '''Prioridad de grupo ACD:''' Los agentes del ''Call Center'' tendrán configurada una prioridad para cada grupo ACD al que pertenecen
* '''Tiempo de espera:''' Tiempo que una llamada lleva en espera en un determinado grupo ACD; si la llamada cambia de un grupo ACD a otro el tiempo de espera pasa a cero
* '''Objetivo de servicio:''' Tiempo objetivo máximo de espera por cada grupo ACD

'''Nota.-''' ''En terminología Asterisk el aumento de prioridad corresponde con números descendentes, es decir, 
prioridad 50 es mejor que prioridad 70''

==== Mecanismo de asignación de llamadas ====

En el momento en que exista un agente disponible para recibir llamada, el agente recepcionará la llamada con mejor prioridad de llamada (menor número). La prioridad de llamada para cada llamada se establecerá de la siguiente manera:

- Agentes con prioridad de grupo ACD de 1 a 99 utilizarán el mecanismo convencional de asterisk de prioridad absoluta; será útil para grupos ACD críticos o en Call Centers muy convencionales

'''Si un agente tiene prioridad menor de 100 en grupos ACD y hay llamadas en dichos grupos, estas llamadas serán atendidas por el agente con prioridad absoluta.'''

- Agentes con prioridad de colas de 100 en adelante; se utilizará el siguiente mecanismo de prioridad ponderada:

:*Si el grupo ACD de la llamada está dentro del objetivo de servicio, la prioridad de llamada será la prioridad de grupo ACD (a efectos prácticos se aplicará el mecanismo convencional de asignación de llamada a agente, equitativo entre grupos ACD con misma prioridad)

:*Si el grupo ACD de la llamada está fuera del objetivo de servicio, se aplicará una ponderación que mejorará la prioridad de la llamada a medida que aumente el tiempo de espera:

[[Archivo:Formula.png |center]]

En una configuración de igualdad de prioridad de agente y objetivo de servicio, el tiempo de espera influiría de manera determinante (más o menos en
función del peso) en la asignación de la siguiente llamada
El peso podrá adquirir tres posibles valores: 0, 1 y 10

[[Archivo:Esquema.png |center]]

- Calculo prioridad de llamada: se calcula por llamada cada vez que un agente queda libre
- Agente atiende llamada con mejor prioridad de llamada



[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Marcación saliente ===
Dentro del ACD hay un comportamiento especial que es la marcación saliente. Esta puede ser de tres tipos:
* '''Vista previa''': El agente demanda la siguiente llamada a realizar.
* '''Progresivo''': Se llama al agente y se lanza la llamada al contacto.
* '''Predictivo''': El sistema calcula cuando va a estar libre el agente y se adelanta lanzando varias llamadas (configurables por parámetros). La llamada que es contestada primero, se pasa a una cola (el resto se cuelgan) a la espera que el agente se quede libre.

====Esquema de funcionamiento====
[[Archivo:esquema funcionamiento marcador.jpg|center|500px]]

Los contactos se agrupan en listas para su facilidad de asignación a campañas, aunque finalmente lo que se asigna a una campaña es un contacto.

Las campañas tienen estrategias. Las estrategias definen como se ha de llamar (del primero al último, sólo los pares, etc.). Tienen una serie de parámetros que dependiendo de la estrategia pueden tener distinta utilidad. Desde el punto de vista de la base de datos, las estrategias se definirían en la tabla ACD_CLASES_ESTRATEGIAS y se les da valor en la tabla ACD_ESTRATEGIAS_MARCADOR.
Una vez establecida la campaña y asignados sus contactos y dependiendo del modo de marcación (que se define en las colas) el proceso motorSal crea los intentos de marcación (siempre y cuando no estén en las listas Robinson), que serán leídos por el proceso myAcdSuperv que los convierte en llamadas para el Asterisk.

====Flujo de estados====

El flujo de estados es el reflejado en la figura siguiente:

[[Archivo:diagrama de flujo motorsal.png|center|800px]]

Los diferentes estados de un contacto son:
{| class="wikitable sortable"
|-
! Estado !! ID_Estado!! Descripción
|-
| Planificable || 0|| El contacto está preparado para que lo gestione motorSal y según la estrategia definida se establece el campo ACD_CONTACTOS_CAMPANNAS.D_HORA_PROXIMA
|-
|Planificado||10||Cuando ha llegado el tiempo marcado en HORA PROXIMA, motorSal ejecuta la 2ª fase de la estrategia, generando el intento de marcación.
|-
|Intento||20||El control pasa a myAcdSuperv, que a su vez genera la llamada en Asterisk. Cuando termina, se pasa a Planificable o Finalizado.
|-
|Finalizado||100||Las gestiones con este contacto han terminado.
|-
|Abortado||110||
|-
|Obsoleto||200||Se ha agotado el tiempo para contactar sin agotar todos los intentos. No se le vuelve a llamar nunca.
|-
|}

====Carga de contactos====

===== Descripción =====

A continuación se explica la configuración y funcionamiento de la utilidad encargada de asignar contactos a campañas.

===== Configuración =====

El archivo de configuración recibe el nombre de '''cargaContactos.pconf.''' Este archivo reside en '''/etc/MDtel.''' El formato se describe en la tabla siguiente. Hay que tener en cuenta que las columnas empiezan a numerarse en 0.

{| class="wikitable" style="text-align:center;"
|-
! Parámetro !! Valor !! Obligatorio !! Defecto
|-
| db|| Nombre de la base de datos|| SI || nimitz
|-
| dbHost|| Host MySQL || SI || localhost
|-
| dbPort|| Puerto MySQL || NO || 3306
|-
| dbUsuario || Usuario de acceso a la base de datos|| SI ||
|-
| dbClave || Clave del usuario || SI ||
|-
| rutaContactos || Ruta hasta el archivo de contactos || NO || /var/spool/MDtel/contactos
|-
| obsoletos || Si vale 1, marcar como obsoletos los contactos anteriores || NO || 0
|-
| diasCaducidad || Número de dias a partir de los cuales caducarán los contactos || SI ||
|-
| idCampanna || Número de columna que contiene el ID de la campaña || SI||
|-
| idLista || Numero de columna que contiene el ID de la lista || SI ||
|-
| prioridad || Número de columna que contiene la prioridad || NO || Nota: El valor es de 0 a 99. A mayor número menor prioridad (se le llamará más tarde)
|-
| tipoTarea|| Número de columna que contiene el tipo de tarea || NO || Nota: los posibles valores de la columna son : *A: Alta *M: Modificación *B: Baja Por defecto el valor es A
|-
| codCli || Número de columna del CSV que contiene el código de cliente || SI ||
|-
| nombreCon || Número de columna del CSV que contiene el nombre || NO ||
|-
| apellido1 || Número de columna del CSV que contiene el primer apellido|| NO ||
|-
| apellido2 || Número de columna del CSV que contiene el segundo apellido || NO ||
|-
| empresa || Número de columna del CSV que contiene la empresa || NO ||
|-
| direccion1 || Número de columna del CSV que contiene la dirección || NO ||
|-
| direccion2 || Número de columna del CSV que contiene la dirección 2 || NO ||
|-
| codPostal || Número de columna del CSV que contiene el código postal || NO ||
|-
| localidad || Número de columna del CSV que contiene la localidad || NO ||
|-
| provin || Número de columna del CSV que contiene la provincia || NO ||
|-
| email || Número de columna del CSV que contiene el email || NO ||
|-
| valFijo_1 || Número de columna del CSV que contiene el primer número fijo del contacto || SI ||
|-
| valFijo_2 || Número de columna del CSV que contiene el segundo número fijo del contacto || NO ||
|-
| valFijo_3 || Número de columna del CSV que contiene el tercer número fijo del contacto || NO ||
|-
| valFijo_4 || Número de columna del CSV que contiene el cuarto número fijo del contacto || NO ||
|-
| valMovil_1 || Número de columna del CSV que contiene el primer número móvil del contacto || SI ||
|-
| valMovil_2 || Número de columna del CSV que contiene el segundo número móvil del contacto || NO ||
|-
| valMovil_3 || Número de columna del CSV que contiene el tercer número móvil del contacto || NO ||
|-
| valMovil_4 || Número de columna del CSV que contiene el CUARTO número móvil del contacto || NO ||
|-
| edad || Número de columna del CSV que contiene la edad || NO ||
|-
| nOpc1|| Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc2 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc3 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc4 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc5 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc6 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc7 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| nOpc8 || Número de columna del CSV que contiene dato numérico opcional || NO ||
|-
| cOpc1 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc2 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc3 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc4 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc5 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc6 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc7 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| cOpc8 || Número de columna del CSV que contiene cadena opcional || NO ||
|-
| Idioma || Idioma del contacto || NO ||
|-
|}

===== Funcionamiento =====

Para ejecutar la utilidad se debe teclear la siguiente orden en la línea de comandos:

'''cmd# cargaContactos.pl /<ruta hasta el conf>/cargaContactos.pconf <archivo CSV>'''

El archivo con los contactos deberá ser un CSV con los campos separados por ';'. La utilidad parsea el archivo conforme a la distribución indicada en la configuración y crea las correspondientes entradas en las tablas '''ACD_CONTACTOS''' y '''ACD_CONTACTOS_CAMPANNAS.'''

La utilidad crea un log en '''/var/log/cargaContactos.log''' en el que vuelca toda la operativa.
Por pantalla se va mostrando un lista con el ID asignado al contacto y el ID de campaña al que se le ha asignado.

Un ejemplo de fichero de carga de contactos sería el siguiente:

#
# Configuracion de recordGwd.pl
#
# Conexion de base de datos
$db='nimitz';
$dbHost = 'localhost';
$dbPort = '3306';
$dbUsuario = 'nimitz';
$dbClave = 'LA QUE SEA';
$diasCaducidad='300';
$rutaGrab = '/var/spool/MDtel/contactos';
$idCampanna = '31';
$idLista = '32';
$obsoletos = 0;
$codCli = '1';
$nombreCon = '2';
$apellido1 = '3';
$apellido2 = '4';
$empresa = '5';
$direccion1 = '6';
$direccion2 = '7';
$codPostal = '8';
$localidad = '9';
$provin = '10';
$email = '11';
$valFijo_1 = '12';
$valFijo_2 = '13';
$valFijo_3 = '14';
$valFijo_4 = '15';
$valMovil_1 = '16';
$valMovil_2 = '17';
$valMovil_3 = '18';
$valMovil_4 = '19';
$edad = '20';
$nOpc1 = '21';
$nOpc2 = '22';
$nOpc3 = '23';
$nOpc4 = '24';
$cOpc1 = '25';
$cOpc2 = '26';
$cOpc3 = '27';
$cOpc4 = '28';
$prioridad = '29';
$tipoTarea = '30';

====Comportamiento de reprogramaciones de llamadas en función del estado del agente====

Se ha preparado la sigueinte maqueta:

Campaña saliente.
Cola saliente progresiva.
Dos agentes logados en VIVAit Suite.

En el formulario de la llamada se indica: llamada redirigida
Se selecciona el "check dirigida"

Las posibilidades de prueba son dos: "'''Cualquier agente'''" y "'''Solo agente'''"

Resultados son los siguientes:

{| class="wikitable sortable"
|-
| '''Estado del agente''' || '''Modo Cualquier Agente'''|| '''Modo Solo Agente'''
|-
| '''Agente Preparado''' || Entra llamada a agente|| Entra llamada a agente
|-
|'''Agente en Pausa'''||Entra llamada a otro agente disponible||Espera a agente y entra llamada.
|-
|'''Agente Hablando'''||Espera a agente y entra llamada||Espera a agente y entra llamada.
|-
|'''Agente en Tiempo administrativo'''||Espera a agente y entra llamada||Espera a agente y entra llamada.
|-
|'''Agente no logado'''||Entra llamada a otro agenete disponible||Consume intento.
|-
|'''Agente con una pestaña de chat abierta y el otro agente en pausa'''||Entra llamada a otro agente disponible||Espera a agente y entra llamada.
|-
|'''Agente con dos pestañas de chat abiertas'''||Espera a agente y entra llamada||Espera a agente y entra llamada.
|-
|}

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Movilidad ===
La movilidad es una función integral de las comunicaciones en la empresa. Cualquier empleado (usuario) es móvil en cierto grado, sea dentro o fuera de la organización.La solución óptima debe proporcionar continuidad de servicios y acceso a nuestros servicios, sin importar donde se esté.

==== Ofrecer movilidad a un usuario ====

Para permitir la movilidad a un usuario, puede ser en el momento de crear o editar un usuario en el apartado ''Administración de usuario'' en ''General'' del '''portal de administración ''VIVA''it'''. Asignándole un '''''numero login''''' (numero personal corporativo para el usuario) y una '''''clave login''''' ( se debe asignar una clave por defecto, pero puede cambiarla en el [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Documentaci%C3%B3n_de_usuario_VIVAit_Call_3.0#Portal_de_usuario |portal de usuario]]). Para más información[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Pesta.C3.B1a_Centralita | ver sección Portal de administración - General - Usuarios - administración de usuarios - Pestaña Centralita]].

Además, de crear un permiso de la '''aplicación ''Centralita''''' a cualquier nivel, desde el apartado ''Permisos de usuarios'' en ''General'' del '''portal de administración ''VIVA''it'''. Para más información[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Asignaci.C3.B3n_de_Permisos_de_Usuario_por_Administrador | ver sección Portal de administración - General - Usuarios - Permisos a usuarios]]

'''La movilidad permite''' disponer de las extensiones telefónicas empresariales en cualquier lugar. Por
ejemplo, con un ordenador portátil o smartphone en una ubicación remota con conexión a Internet,
podríamos tener registrada nuestra extensión remotamente, y así las llamadas hacia/desde nuestra
oficina serían enrutadas por Internet hasta el equipo en cuestión sin coste alguno.


Todo terminal tiene asociado una extensión y deberá permitir la movilidad de usuarios. La extensión se configura cambiando a '''''SI''''' el campo '''''Hay Movilidad''''' desde el apartado ''Extensiones'' de ''Dispositivos'' en ''VIVAit Call'' del '''portal de administración ''VIVA''it'''. Para más información [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Extensiones | ver sección Portal de administración - VIVAit Call - Dispositivos - Extensiones]]

==== ¿Cómo funcionan las extensiones? ====

Primeramente el usuario debe tener los ejes apropiados en la tabla '''COM_USUARIOS_APLICACION''' (aplicación centralita).

La extensión debe de tener ''un teléfono'' y por tanto ''un modelo de teléfono asociado.''

Es tan simple como especificar '''la extensión, el usuario y la clave de este.'''

Para corroborar el funcionamiento de esta hay ''dos métodos'':

'''* CLI asterisk:'''

'''mdintz qry * nimitz bd extenEntraUsuarioMovil 25001 20001 1234'''

Y como resultado obtenemos lo siguiente:

mdintz Variables: 
MdintzIdentif='cms1' 
MOVIL_TIPO_RESET='10' 
MOVIL_CAD_RESET='notify_yealink' 
MdintzRes='OK'

El usuario con el login numérico 20001 se ha "movido" a la extensión 25001

Ahora ''nos quitamos de esa extensión mediante el siguiente comando:''

'''mdintz qry * nimitz bd extenSaleUsuarioMovil 25001'''

Resultado del comando:

mdintz Variables: 
MdintzIdentif='cms1' 
MOVIL_TIPO_RESET='10' 
MOVIL_CAD_RESET='notify_yealink' 
MdintzRes='OK'

Las pruebas anteriores han sido '''con extensiones con movilidad y con usuario con/sin
propietario.'''

Ahora las realizamos '''con extensiones sin movilidad'''

'''mdintz qry * nimitz bd extenEntraUsuarioMovil 25002 20001 1234'''

Obteniendo:

mdintz Variables: 
MdintzIdentif='cms1' 
MdintzRes='movil_error_datos'

Como era lo previsible no nos deja "movernos" a esa extensión ya que no tiene movilidad.


'''Si un usuario ya se ha movido a una extensión y se mueve a otra, el sistema lo deslogará de la primera para logarlo en la segunda.'''

'''mdintz qry * nimitz bd extenEntraUsuarioMovil 21000 20001 1234'''

Con salida:

mdintz Variables: 
MdintzIdentif='cms1' 
MOVIL_EXTEN='25001' 
MDintzRes='movil_ya_login'

'''* Dialplan'''

Para llamar a la función de movilidad hay que marcar el '''9992.'''

Nota.- Para comprobar que se realiza todo correctamente habría que mirar las trazas de Asterisk

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Grabación ===

La grabación en '''''VIVA'''''it Call está diseñada para ser lo mas flexible posible.

====Configuración====

Si deseamos grabar, debemos activar que alguno de los dispositivos/elementos que intervienen en la llamada se grabe.

Estos dispositivos/elementos son:

* Nodo.
* Usuario con Centralita.
* Agente.
* Grupo ACD corporativo y de Contact Center.
* Enlace exterior.
* Extensión.
* Facilidades.
* Grupo: grupo de salto o grupo de operadoras.
* Sala de conferencia.
* VDN corporativo y de Contact Center.
* Pre-rutas.

Por otro lado necesitaremos que la llamada pase por un nodo que sea grabador, es decir, que si la llamada esta configurada para que se grabe pero no pasa por ningún nodo grabador, la llamada no se grabará.

Al configurar un nodo existen cuatro campos que intervienen en la grabación.

''''Grabador''''

Se configura en el portal en la sección general/nodos.

Este campo corresponde con el campo [[BD.COM_NODOS#B_ES_GRABADOR|B_ES_GRABADOR]] de la tabla [[BD.COM_NODOS|COM_NODOS]] , este campo define si el nodo va a grabar las llamas que pasen por el que necesiten ser grabadas y no se estén grabando ya.

Es un campo booleano los posibles valores en el portal son si/no y en la base de datos 1/0.

''''Modo grabación infraestructura''''

Su configuración se realiza en el portal, en la sección general/nodos.

Este campo define como está configurada la infraestructura, este campo existe por compatibilidad con '''''VIVA'''''it suite y para poder configurar la grabación bajo demanda.

Este campo corresponde con el campo [[BD.COM_NODOS#E_MODO_GRABACION_INFRAESTRUCTURA|E_MODO_GRABACION_INFRAESTRUCTURA]] de la tabla [[BD.COM_NODOS|COM_NODOS]], Este campo usa los valores del enumerado BD.ENUM.TModoGrabacionInfraestructura|TModoGrabacionInfraestructura]].

La formula que se seguiría para ver si una llamada se graba en ese nodo es:
{|
|
|-
|
(NODO.E_MODO_GRABACION_INFRAESTRUCTURA) AND (NODO.B_ENRU_GRABAR OR CEN_PRE_RUTA.B_ENRU_GRABAR OR "OBJETO".B_ENRU_GRABAR)
|}

Que sería que si la infraestructura esta en NoGraba no se graba nada de lo que se rute en ese nodo y en cualquiera de los 2 otros caso (GrabaTodo o GrabaPorPeticion) se grabaría dependiendo de la configuración del Nodo, la ruta o el objeto en cuestión (preruta, grupo ACD, extension,...).

''''Grabar enrutamiento''''

Se configura en el portal en la sección general/nodos.

Este campo define si van a grabar las llamadas que se enruten en este nodo.

Campo [[BD.COM_NODOS#E_ENRU_GRABAR|E_ENRU_GRABAR]] de la tabla [[BD.COM_NODOS|COM_NODOS]] que usa los valores del enumerado [[BD.ENUM.TTipoEnruGrabar|TTipoEnruGrabar]].

''''RecordCentral''''

Se configura en el portal en la sección general/nodos.

Define que instancia del recordCentral es la encargada de tratar las grabaciones de este nodo.

Para aumentar el rendimiento a la hora de traerse las grabaciones, se pueden definir varias instancias de proceso recordCentral, este campo define cual de estas instancias se encargara de este nodo.

====Vivait Tracker====

Desde '''''VIVA'''''it Supervisor, que es la aplicación dirigida a Supervisores, ofrece la posibilidad de supervisar y gestionar grupos ACD, agentes, asignaciones, prioridades,etc. Se puede obtener acceso directo a las aplicaciones de grabación ('''''VIVA'''''it tracker)


Esquematico actual del proyecto tracker
[[Archivo:Esquematico_tracker_1.jpg|center]]

1º El tracker web llama al web service Remote login para iniciar sesión y determinar si tiene permisos para la escucha y descarga de grabaciones.

2º Si la ubicación de la grabación es local, mira la ruta de esta y se procede a la escucha o descarga de esta.

3º Si la ubicación de la grabación es remota, entra en escena el proxy. Es el que realiza la petición.

4º Si utilizamos el tracker windows, este, como el tracker web, llama primero al web service remote login para la autenticación y tema de Permisos.

5º Para descargar o escuchar una grabación desde el tracker windows, se llama al web service servidor de grabaciones pasándole simplemente el ID de segmento.mp3. Este web service, con el ID de segmento, se encarga de determinar la ubicación de la grabación.

Esquematico actual del proyecto tracker
[[Archivo:Esquematico_tracker_2_https.jpg|center]]

1º El tracker web llama al web service Remote login para iniciar sesión (comunicación https) y determinar si tiene permisos para la escucha y descarga de grabaciones. Se elimina el proxy

2º Si la ubicación de la grabación es local, mira la ruta de esta y se procede a la escucha o descarga de esta.

3º Si la ubicación de la grabación es remota, se realiza una petición al host remoto. El tipo de petición vendrá fijada por base de datos (http, https, ftp,ftps)

4º Si utilizamos el tracker windows, este, como el tracker web, llama primero al web service remote login para la autenticación y tema de permisos (comunicación https extremo a extremo).

5º Para descargar o escuchar una grabación desde el tracker windows, se llama al web service servidor de grabaciones pasándole simplemente el ID de segmento.mp3. Este web service, con el ID de segmento, se encarga de determinar la ubicación de la grabación.

[[#Grabación_(Vivait_Tracker)| Volver arriba]]
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operación_plataforma_VIVAit Volver al indice]]

=== Enrutamiento ===

[[Archivo:Enrutamiento.png|885px |center]]

==== Funcionamiento ====
El proceso de enrutamiento, como vemos en el esquemático, se compone de dos fases:

# Preenrutameinto, que se encarga de tratar todas las llamadas
# Enrutamiento externo, que tiene módulos dedicados al enrutamiento hacia:
:*Enlaces externos.
:*Extensiones.
:*Usuarios de telefonía corporativa.
:*Facilidades.
:*Salas de conferencia.
:*Agentes de grupos ACD.
:*Grupos ACD.
:*Vdn.
:*Buzones para dejar mensaje.
:*Buzones para su gestión.

Se asume que existen rutas directas entre todos los nodos de la red.

Se asume que están directamente enrutadas todas las direcciones IP involucradas, tanto nodos, como terminales.

Se asume que todas las facilidades están disponibles en todos los nodos, aunque es posible que la implementación sea diferente entre ellos.

Los datos de entrada básicos al proceso de enrutamiento (pdEntr) son:
* Dispositivo
* Cola
* Origen
* Nodo entrada
* UCID
* CALLER_ID_NAME
* CALLER_ID_NUM
* DNIS
* Desvío por dialplan

A partir de los datos de entrada básicos anteriores se pueden deducir los siguientes valores:
* Sede del dispositivo de entrada
* Sede del nodo de entrada
* Ancho de banda disponible en la sede del dispositivo
* Ancho de banda disponible en la sede del nodo
* Categoría entrante
* Valor del eje1 asignado a la llamadas
* CALLER_ID_NUM_EXTERNO

Los datos de salida globales del proceso de enrutamiento (pdSale) son:
* Categoría saliente
* Código de cliente (opcional)
* Tipo de destino:
:* No existe
:* Ruta externa
:* Extensión
:* Usuario de telefonía corporativa
:* Facilidad
:* Salas de conferencia
:* Agentes de grupos ACD
:* Grupos ACD
:* VDN
:* Buzón para dejar mensaje.
:* Buzón para dejar mensaje por ocupado.
:* Buzón para dejar mensaje por no contestación.
:* Buzón para su gestión.
* Destinatario (cuando se trata de un usuario o de un agente)
* Valor del eje1 asignado a la llamada
* Buzón de las extensiones y usuarios que los tengan asignados
* Si el buzón está en nodo distinto al de entrada
* DESVIO_INCONDICIONAL (sólo extensiones y usuarios) (valor MENSA=desvio_mensajeria en variable)
* DESVIO_NO_CONTESTA (sólo extensiones y usuarios) (valor MENSA=desvio_mensajeria en variable)
* DESVIO_OCUPADO (sólo extensiones y usuarios) (valor MENSA=desvio_mensajeria en variable)
* DESVIO_FUERA_SERV (sólo extensiones y usuarios) (valor MENSA=desvio_mensajeria en variable)

Los datos de salida para cada una de las posibles rutas en orden son (nn va de 01 maxRutas [nn son dos dígitos decimales]):
* CONTADOR_ABDE_nn (contador para control de ancho de banda en sede de dispositivo de entrada).
* CONTADOR_ABNE_nn (contador para control de ancho de banda en sede de nodo de entrada).
* CONTADOR_ABDS_nn (contador para control de ancho de banda en sede de dispositivo de salida).
* CONTADOR_ABNS_nn (contador para control de ancho de banda en sede de nodo de salida).
* CALLER_NAME_SAL_nn , puede salir de una extensión, un usuario o de un agente.
* CALLER_NUM_SAL_nn, puede salir de una extensión, un usuario o de un agente.
* DESTINO_SAL_nn , en general, el valor C_NOMBRE o destino de salida.
* RUTA_NODO_nn , Cadena de marcación para ir la nodo que soporta DESTINO_SAL_nn, si es distinto del nodo de entrada.
* RUTA_SAL_nn
:* Extensión: cadena marcación.
:* Facilidad: E_CODIGO_FACILIDAD obtenido de la tabla CEN_FACILIDADES.
:* Usuario: cadena marcación de la extensión asignada al usuario en movilidad o en propiedad.
:* Agente: cadena marcación de la extensión a la que está conectado el agente.
:* Ruta externa: contexto que gestiona la llamada saliente.

=====Fase preenrutamiento =====

La fase de preenrutamiento (basada en la tabla CEN_PRE_RUTA) se usa en todas las llamadas entrantes, tanto internas, como externas. Permite desarrollar un “prerouting” estándar para ACD y para telefonía corporativa.

Los datos de entrada al proceso de enrutamiento son iguales a los del proceso global de enrutamiento, excepto en que este proceso no usa el nodo de entrada ya que es independiente de éste.

Los datos de salida de la fase de preenrutamiento:
* D_CATEGORIA_SAL
* COD_CLIENTE (opcional)
* TIPO_DESTINO_SAL
:* No existe.
:* Volver a preenrutar.
:* Ruta externa.
:* Extensión.
:* Usuario de telefonía corporativa.
:* Facilidad.
:* Sala de conferencia.
:* Agente de grupos ACD.
:* Grupos ACD.
:* VDN.
:* Buzón para dejar mensaje.
:* Buzón para dejar mensaje por ocupado.
:* Buzón para dejar mensaje por no contestación.
:* Buzón para su gestión.
* COD_CLIENTE
* Valor del eje1 asignado a la llamada
* CALLER_NAME
* CALLER_NUM
* DESTINO

El proceso de preenrutamiento consiste en seleccionar un único registro de la tabla CEN_PRE_RUTA y, con sus valores y con los valores de entrada al proceso, generar los datos de salida.

Un posible tipo de salida es "Volver a preenrutar". Esto permite realimentar el proceso un máximo de "max_pre_ruta_regs" veces (en archivo .conf) para simplificar configuración. Sólo tiene sentido realimentar si se ha hecho alguna modificación en los datos de selección de registro, ya que en caso contrario se produciría un bucle que el proceso de preenrutamiento es capaz de detectar y evitar.

Para elegir el registro de CEN_PRE_RUTA, se tienen en cuenta los datos de entrada de la llamada, de modo que se cumpla con todos los puntos siguientes:
* ID_CATEGORIA_ENT igual a la del dispositivo de entrada.
* CALLER_NUM de entrada
:* Debe comenzar por la cadena C_ORIGEN_ENT_PREF o C_ORIGEN_ENT_PREF=NULL, con menos prioridad. Es conveniente rellenar este dato del modo más restrictivo que sea posible, independientemente de C_ORIGEN_ENT_EXPR. Ello permite disminuir el uso innecesario de recursos de evaluación de expresiones regulares.
:* Debe de tener un número de dígitos igual o superior a N_ORIGEN_ENT_MIN_DIGITOS, si este valor no es NULL o cero.
:* Debe de tener un número de dígitos igual o inferior a N_ORIGEN_ENT_MAX_DIGITOS, si este valor no es NULL o cero.
:* Debe cumplir la expresión regular C_ORIGEN_ENT_EXPR, si ésta no es NULL.
* DNIS empiece con C_DESTINO_ENT_PREF o C_DESTINO_ENT_PREF=NULL. Es conveniente rellenar este dato del modo más restrictivo que sea posible, independientemente de C_DESTINO_ENT_EXPR. Ello permite disminuir el uso innecesario de recursos de evaluación de expresiones regulares.
* Si varias entradas cumplen la condición anterior, se prueba primero la que el campo C_DESTINO_ENT_PREF tenga una longitud mayor y, de entre éstas, la que C_ORIGEN_ENT_PREF tenga una longitud mayor.
* DNIS tenga un número de dígitos igual o superior a N_DESTINO_ENT_MIN_DIGITOS, si este valor no es NULL o cero.
* DNIS tenga un número de dígitos igual o inferior a N_ORIGEN_ENT_MIN_DIGITOS, si este valor no es NULL o cero.
* DNIS cumpla la expresión regular C_DESTINO_ENT_EXPR, si ésta no es NULL.

Si no se encuentra ninguna entrada adecuada, quiere decir que es una llamada prohibida y se devuelve el tipo de destino "No existe".

Puede conseguirse un destino "por defecto" diferente, creando una entrada que encaje siempre para cada categoría: C_ORIGEN_ENT, C_ORIGEN_ENT_MIN_DIGITOS, C_ORIGEN_ENT_MAX_DIGITOS, C_ORIGEN_ENT_EXPR, C_DESTINO_ENT_PREF, N_DESTINO_ENT_MIN_DIGITOS, N_DESTINO_ENT_MAX_DIGITOS y C_DESTINO_ENT_EXPR a valor NULL.

Una vez elegida una entrada, ésta puede transformar o sustituir el valor de ID_CATEGORIA, CALLER_NAME, CALLER_NUM, DESTINO, COD_CLIENTE y/o EJE1_MSK a la salida del proceso.

Si ID_CATEGORIA_SAL es cero, se propaga a la salida el valor de la entrada. En caso contrario, se sustituye.

Si C_CALLER_NAME está vacío, se mantiene el valor hubiese a la entrada. En caso contrario, se sustituye.

C_CALLER_NUM puede contener una cadena que identifica el nuevo CALLER_NUM. Además, si la cadena comienza por los caracteres que se indican, el significado es especial:
* "=" o cadena vacía, el nuevo CALLER_NUM es igual al de entrada al proceso.
* "+" el nuevo CALLER_NUM es igual al de entrada al proceso, con los caracteres a continuación de "+" como prefijo.
* "-" se quita el número de caracteres que se indica a continuación de "-".
* "_" lo que sigue al carácter es una expresión regular que se aplica al CALLER_NUM de entrada. Dicha expresión regular tiene obligatoriamente que contener una subcadena (definida entre paréntesis, según el estándar de expresiones regulares) que nos da el nuevo CALLER_NUM de salida. Si la expresión regular no se cumpliese, se propagará el valor de entrada al proceso.
* cualquier otro valor del primer carácter determina que es una constante que sustituye el valor a la entrada.

Cada vez que se utilice una preruta, se incrementará el valor de N_CONTA si el valor de N_UMBRAL es mayor que cero.

Un valor N_UMBRAL mayor que cero permite modificar el destino de salida cuando el valor de actual de N_CONTA (antes de incrementarse) supere o sea igual el valor de N_UMBRAL. Si se cumple la condición indicada, se usa como destino tras el preenrutamiento, los valores de los campos E_TIPO_DESTINO_SAL_2 y C_DESTINO_SAL_2.

Si el valor de N_UMBRAL es menor o igual a cero o si N_CONTA es inferior a N_UMBRAL, se usa como destino tras el preenrutamiento, los valores de los campos E_TIPO_DESTINO_SAL_1 y C_DESTINO_SAL_1.
Con este mecanismo de N_CONTA y N_UMBRAL, se pretende facilitar el discriminar a los llamantes reincidentes, cuando sea necesario.

Un proceso periódico externo debe encargarse de poner a cero o decrementar el valor de N_CONTA.
Como resultado de los procesos de filtrado y de verificación anteriores, se habrá obtenido un TIPO_DESTINO_SAL y un C_DESTINO_SAL a partir de los campos con sufijo "_1" o "_2", con una metodología similar al caso C_CALLER_NUM.

C_DESTINO_SAL_x puede contener cadena que permite obtener el nuevo destino. Además, si la cadena comienza por los caracteres que se indican, el significado es especial:
* "=" o cadena vacía, el nuevo destino es igual al de entrada al proceso.
* "+" el nuevo destino es igual al de entrada al proceso, con los caracteres a continuación de "+" como prefijo.
* "-" se quita el número de caracteres que se indica a continuación de "-".
* "_" lo que sigue al carácter es una expresión regular que se aplica al destino de entrada. Dicha expresión regular tiene obligatoriamente que contener una subcadena (definida entre paréntesis, según el estándar de expresiones regulares) que nos da el nuevo destino de salida. Si la expresión regular no se cumpliese, quiere decir que es una llamada prohibida y se encaminará hacia una facilidad por defecto.
* cualquier otro valor del primer carácter determina que es una constante que sustituye el valor a la entrada.
Información de salida del proceso de preenrutamiento: Cuando TIPO_DESTINO_SAL_x toma los valores que se indican, el proceso global de enrutamiento sólo requiere de preenrutamiento y la información a devolver se obtiene dependiendo de TIPO_DESTINO_SAL_x:
* No existe: Se asume que no se conoce un destino para los datos de entrada, por lo que la llamada se encamina hacia una facilidad por defecto que gestiona su tratamiento.
* Extensión: A partir de las tablas CEN_DISPOSITIVOS, CEN_EXTENSIONES y CEN_NODOS, se devolverán los valores que permiten alcanzar la extensión en el nodo principal y en el secundario.
* Facilidad: A partir de las tablas CEN_DISPOSITIVOS, CEN_FACILIDADES y CEN_NODOS.
* Usuario de telefonía corporativa: A partir de las tablas CEN_USUARIOS, CEN_DISPOSITIVOS, CEN_EXTENSIONES y CEN_NODOS, se devolverán los valores que permiten alcanzar al usuario en el nodo principal y en el secundario de la extensión que corresponde en base a movilidad, con prioridad, o en base a propiedad. El caso de movilidad no se tiene en cuenta si el proceso de enrutamiento se realiza en "modo supervivencia".
* Sala conferencia: A partir de las tablas CEN_SALAS_CONFERENCIAS y CEN_NODOS.
* Agente de ACD: A partir de las tablas ACD_USUARIOS, DAT_TR_ACD_EXTENSIONES, CEN_DISPOSITIVOS, CEN_EXTENSIONES y CEN_NODOS, se devolverán los valores que permiten alcanzar al agente en el nodo principal y en el secundario.
* VDN: A partir de las tablas ACD_VDN y CEN_NODOS, se devolverán los valores que permiten alcanzar al VDN en su nodo.
* Grupo ACD: A partir de las tablas ACD_COLAS y CEN_NODOS, se devolverán los valores que permiten alcanzar al grupo ACD en su nodo.

El campo B_GENERAR_SEGMENTO de la tabla CEN_PRE_RUTA indica al proceso de preenrutamiento que es preciso generar un segmento de tipo "preenrutamiento". En el segmento generado, se rellena el campo C_ETIQUETA1 del nuevo segmento con el valor que contiene el campo homónimo del registro asociado en la tabla CEN_LISTA_PRE_RUTAS.

===== Fase de enrutamiento en casos en que el destino no es externo =====
Datos de entrada al proceso de enrutamiento externo: iguales a los de salida del proceso de preenrutamiento (pdPreSale), uniéndose a éstos los datos globales de entrada al proceso (pdEntr).

Datos de salida de la fase de enrutamiento: iguales que los del proceso global de enrutamiento (pdSale).

Específicamente y sólo para los casos en que el destino es una extensión (tipo de destino extensión, usuario de telefonía corporativa o agente) es cuando son válidos los datos correspondientes al buzón asociado y los datos de los posibles desvíos previstos.

También en este caso, se prevén dos posibles rutas, una se corresponde con el acceso a la extensión en el nodo principal de ésta y la otra en el nodo secundario.

En el resto de tipos de destino, sólo se prevé una ruta que puede incluir o no un enlace internodal.

===== Fase de enrutamiento en el caso de destino externo =====
Datos de entrada al proceso de enrutamiento externo: iguales a los de salida del proceso de preenrutamiento (pdPreSale), uniéndose a éstos los datos globales de entrada al proceso (pdEntr).
Datos de salida de la fase de enrutamiento: iguales que los del proceso global de enrutamiento (pdSale).

Se elige los primeros "max_ruta" registros (configurado en archivo .conf) en CEN_DESTINOS_EXTERNOS unido con CEN_RELACION_DESTINOS_ENLACES_EXTERNOS que, teniendo en cuenta los datos de entrada al proceso de enrutamiento, cumpla con todos los puntos siguientes:
* ID_CATEGORIA_ENT igual a la de salida del proceso de preenrutamiento.
* C_DESTINO_SAL de proceso de preenrutamiento empiece con C_DESTINO_ENT_PREF.
* Si varias entradas cumplen la condicion anterior, se prueba primero la que el campo C_DESTINO_ENT_PREF tenga una longitud mayor.
* C_DESTINO_SAL tenga un número de dígitos igual o superior a N_DESTINO_ENT_MIN_DIGITOS, si este valor no es NULL o cero.
* C_DESTINO_SAL tenga un número de dígitos igual o inferior a N_DESTINO_ENT_MAX_DIGITOS, si este valor no es NULL o cero.
* C_DESTINO_SAL cumpla la expresión regular C_DESTINO_ENT_EXPR, si ésta no es NULL.

Aparte de la longitud del campo C_DESTINO_ENT_PREF, se usa N_PRIORIDAD como campo para ordenar los registros y seleccionar lo "max_ruta" primeros.

Una vez que un registro es válido, se descartan todos los registros cuyo C_DESTINO_ENT_PREF es diferente del primero seleccionado.

Como resultado de los procesos de filtrado y de verificación anteriores, se habrá obtenido hasta un máximo de "max_rutas" valores para posibles rutas. Las posibles propagaciones y transformaciones en los datos de cada ruta son función de los datos de cada registro seleccionado:

CALLER_NAME_nn: Si C_CALLER_NAME está vacío, se propaga el valor de entrada. En caso contrario, se sustituye.

CALLER_NUM_nn: Sale de C_CALLER_NUM que puede contener una cadena que identifica el nuevo CALLER_NUM_n. Además, si C_CALLER_NUM comienza por los caracteres que se indican, el significado es especial:
* "=" o cadena vacía, el nuevo CALLER_NUM_nn es igual al de entrada al proceso.
* "+" el nuevo CALLER_NUM_nn es igual al de entrada al proceso, con los caracteres a continuación de "+" como prefijo.
* "-" se quita el número de caracteres que se indica a continuación de "-".
* "_" lo que sigue al carácter es una expresión regular que se aplica al CALLER_NUM de entrada. Dicha expresión regular tiene obligatoriamente que contener una subcadena (definida entre paréntesis, según el estándar de expresiones regulares) que nos da el nuevo CALLER_NUM de salida. Si la expresión regular no se cumpliese, se propaga el valor de entrada al proceso.
* ">" Si existe valor para CALLER_NUM_EXTERNO, se propagará éste a la salida. En caso contrario y si no está vacía la cadena que queda al eliminar el prefijo ">", se susituye en la salida por el valor de la cadena sin prefijo. Si la cadena estuviese únicamente constituida por el valor ">", se propaga el valor de entrada.
* cualquier otro valor del primer carácter determina que es una constante sin ninguna modificación.

C_DESTINO_SAL_nn: Se obtiene a partir de C_DESTINO_SAL que puede contener una cadena que identifica el nuevo destino. Además, si la cadena comienza por los caracteres que se indican, el significado es especial:
* "=" o cadena vacía, el nuevo destino es igual al de entrada al proceso.
* "+" el nuevo destino es igual al de entrada al proceso, con los caracteres a continuación de "+" como prefijo.
* "-" se quita el número de caracteres que se indica a continuación de "-".
* "_" lo que sigue al carácter es una expresión regular que se aplica al destino de entrada. Dicha expresión regular tiene obligatoriamente que contener una subcadena (definida entre paréntesis, según el estándar de expresiones regulares) que nos da el nuevo destino de salida. Si la expresión regular no se cumpliese, se propaga el valor de entrada al proceso.
* cualquier otro valor del primer carácter determina que es una constante sin ninguna modificación.

RUTA_NODO_nn: Sólo se usa si el nodo de salida es diferente del nodo de entrada. Contiene la cadena de marcación para ir la nodo que soporta DESTINO_SAL_nn. Sale del campo C_FORMATO_DIAL (sustituyendo variables) correspondiente al tipo de dispositivo del enlace exterior.

RUTA_SAL_nn: Es el campo C_DATO_ASTERISK obtenido a partir del registro en la tabla CEN_ENLACE_EXTERIOR que se corresponde con ID_ENLACE_EXTERIOR de la tabla CEN_RELACION_DESTINOS_ENLACES_EXTERNOS.

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

=== Control de ancho de banda ===

Para el control de ancho de banda, primero hemos de tener en consideración que una llamada puede tener asociadas hasta cuatro sedes
:* Sede del terminal origen (terminal A)
:* Sede del nodo de registro del terminal origen (nodo A)
:* Sede del terminal destino (terminal B)
:* Sede del nodo de registro del terminal destino (nodo B)

Además hemos de tener en cuenta que el audio de la conversación podrá ir:
:* De manera directa entre terminal A y terminal B
:* De manera indirecta, a través de los nodos A y B

[[Archivo:ancho de banda.png|700px]]

Cuando se va a cursar una llamada de terminal A a terminal B, el proceso de enrutamiento del nodo A devuelve 4 variables de canal al dialplan:

{| class="wikitable"
|-
! Variable!!Campos
|-
|R_ABDE_xx||R = Variable de rutas --- AB = ancho de banda --- D = dispositivo --- E = Entrante --- xx = de 0 a 3
|-
|R_ABNE_xx||R = Variable de rutas --- AB = ancho de banda --- N = nodo --- E = Entrante --- xx = de 0 a 3
|-
|R_ABDS_xx||R = Variable de rutas --- AB = ancho de banda --- D = dispositivo --- S = Saliente --- xx = de 0 a 3
|-
|R_ABNS_xx||R = Variable de rutas --- AB = ancho de banda --- N = nodo --- S = Saliente --- xx = de 0 a 3
|-
|}

El valor de cada variable es una cadena del tipo '''AB.wwww.xxxx.y.z''' donde cada valor es:
:* '''wwww''' --> id de sede
:* '''xxxx''' --> ancho de banda total de la sede
:* '''y''' --> número de llamadas a sumar si conversación directa
:* '''z''' --> número de llamadas a sumar si conversación indirecta

Por otro lado tenemos que tener en cuenta que el dialplan tiene control de las llamadas que cada sede puede cursar

De esta forma, cuando existe una nueva llamada el dialplan aplica la fórmula, suma el resultado al número de llamadas en curso y lo compara con el máximo...si el resultado es mayor que le máximo la llamada no se cursará por congestión

Configuraremos el ancho de banda por sede en el portal de administración y el consumo que hace cada llamada en la variable '''AB_CONSUMO_LLAMADA''' del fichero '''ext_MDtel_particular.conf''' de cada nodo de conmutación; el valor por defecto es 32

[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

== Puesto de trabajo ==
El puesto de trabajo del agente en la plataforma '''''VIVA'''''it (para el producto '''''VIVA'''''it Suite) estará compuesto por:
* PC (típicamente windows) en el que reside la aplicación '''''VIVA'''''it Desk
* Terminal telefónico con extensión física asociada.

Para más información [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Puestos | ver sección Portal de administración-VIVAit Suite ACD+ - Puestos]].

=== Relación PC/teléfono en puesto de trabajo ===

Existirá una relación única entre nombre PC y extensión física asociada, si bien los agentes se identificarán por su login que les acompaña al puesto de trabajo en el que se loguen
Existe un procedimiento documentado para la operativa de cambio de puesto de trabajo, en caso de ser necesario el cambio de PC o de teléfono de un puesto de trabajo.
==== Procedimiento para un cambio de puesto de trabajo ====
Se basa en una asignación de PC a teléfono relaccionando la extensión telefónica del terminal físico con el nombre del puesto de trabajo. La configuración de dicha asociación se realiza en el portal de administración de la plataforma.

Cualquier cambio que se realice en terminal telefónico o PC de agente ha de mantener la asociación en el portal a efectos de permitir el funcionamiento del sistema.

A continuación se reflejan los cambios más habituales:

{| class="wikitable"
|-
! Cambio !! Procedimiento !! Punto de acción
|-
|rowspan="2"| Cambio de ubicación de un PC || Opción 1.- Renombrar el PC para que conserve el nombre que tenía el anterior en esa ubicación || PC de agente
|-
| Opción 2.- Rehacer la asignación extensión/puesto || Portal de administración
|-
| rowspan="2"| Instalación de PC nuevo en puesto existente || Opción 1.- Renombrar el PC para que conserve el nombre que tenía el anterior en esa ubicación || PC de agente
|-
| Opción 2.- Rehacer la asignación extensión/puesto || Portal de administración
|-
| Cambio de nombre en un PC || Rehacer asignación extensión/puesto || Rehacer asignación extensión/puesto
|-
|Cambio de ubicación de un teléfono || Rehacer la asignación extensión/puesto
|| Portal de administración
|-
| Instalación de un teléfono nuevo en puesto existente || Rehacer la asignación extensión/puesto || Portal de administración
|-
| Instalación de un nuevo puesto de agente|| Hacer asignación extensión/puesto || Portal de administración
|}


=== Estructura de aplicaciones en puesto de trabajo ===
Las aplicaciones del puesto de trabajo pueden estar ubicadas en cualquier carpeta del sistema. Es importante tener en cuenta que los procesos de actualización, logs… escriben en dichas carpetas, por lo que el usuario de windows deberá tener permisos de lectura/escritura y borrado sobre dichas carpetas
La instalación del puesto de trabajo es muy liviana para el sistema; las aplicaciones ocupan poco espacio y no se modifican ficheros del sistema operativo (registry o similares)
Los ficheros importantes son
{| class="wikitable"
|-
! Fichero !! Descrición
|-
| Vivait-desk.exe || Contiene la aplicación '''''VIVA'''''it Desk de agente
|-
| vivait_desk_dll.dll||Este fichero contiene controles sobre los formularios (controles de
texto, algunas reglas de obligatoriedad…)
|-
| nimitz.ini || Configuración del puesto de agente
|-
| lanzador.exe || Aplicación de actualización de versiones
|-
| lanzador.ini || Configuración del actualizador de aplicaciones
|-
| Carpeta forms || En esta carpeta están ubicados los formularios que se abren ante llamada entrante o saliente
|-
| Carpeta imágenes || Contiene las imágenes izquierda y derecha de la barra de '''''VIVA'''''it Desk
|-
|}

=== Secciones de utilidad en nimitz.ini ===

==== Configuración del puesto de agente ====

El fichero nimitz.ini contiene la configuración del puesto de agente; sus principales parámetros son:

{| class="wikitable" border="0" style="background:#ffffff" align="top"
|-
| |''' Fichero'''
|| '''Descripción'''
|-
|Sección [bd1]
||host="ip_BBDD_tiempo_real"
puerto="Nº puerto"
basedatos="nimitz"
usuario="nimitz"
clave="UIk5jMY9PVX6ogg="

Contiene información para la conexión a BBDD de tiempo real, en la que '''''VIVA'''''it Desk fundamentalmente inserta información
|-
|Sección [bd2]
||host=" ip_BBDD_replica "
puerto="Nº puerto"
basedatos="nimitz"
usuario="nimitz"
clave="UIk5jMY9PVX6ogg="

Contiene información para la conexión a BBDD de réplica, en la que '''''VIVA'''''it Desk solo leerá información
|-
|Sección [telefono]
||pruebas=1 (Valores válidos 0 ó 1)
Activación de funcionalidad "servicio técnico" en '''''VIVA'''''it Desk.

puesto="Nombre puesto"
|-
|Sección [trazas]
|| nivel=3

archivo=1

consola=0

sobreescribir=1

Activación de generación de ficheros de trazas "viva-desk.log" en carpeta de aplicaciones
|}

=== Parámetros en invocación a '''''VIVA'''''it Desk ===

La aplicación '''''VIVA'''''it Desk puede ser invocada con una serie de parámetros que condicionan su funcionamiento; los parámetros son:
* Primer parámetro: Nombre del archivo .ini; usado como alternativa al fichero por defecto "nimitz.ini"
* Segundo parámetro: Nombre de puesto; usado como alternativa al nombre de puesto del ordenador
* Tercer parámetro: Nombre de login; para forzar un usuario; es de utilidad si el sistema está configurado como "confiar en sistema operativo", en cuyo caso no permite seleccionar un login de agente para acceder a la aplicación

=== Instalación y actualización de aplicaciones de puestos de trabajo ===
La instalación y actualización de las aplicaciones en el puesto de trabajo pasan por disponer de los ficheros “lanzador.exe” y “lanzador.ini” (debidamente configurado) dentro de la carpeta en la que se desee instalar.
Lanzando la aplicación “lanzador.exe” se instalará o actualizará el sistema.

El fichero “lanzador.ini” tiene el siguiente aspecto:
URL="http://IP_Servidor:8180/WSActualizaXML/actualizar.xml"
BASE_URL_DESCARGAS="http://IP_servidor:8180/XMLFILES/"

=== Servicio técnico en '''''VIVA'''''it Desk ===
La activación de la funcionalidad de servicio técnico en '''''VIVA'''''it Desk nos permite realizar sincronizaciones manuales de la aplicación y activar trazas a nivel de Base de Datos o a nivel de log sobre el propio '''''VIVA'''''it Desk. Pulsando el botón derecho del ratón sobre la barra '''''VIVA'''''it Desk accederemos a las capacidades de soporte técnico
[[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

== Funcionamiento de la plataforma en modo emergencia ==
== Accesos Web ==

{| class="wikitable"
|-
! Aplicación !! Enlace
|-
|Portal de administración '''''VIVA'''''it Suite || http://ip_admin:8180/Vivait-Call
|-
|'''''VIVA'''''it Tracker||http://ip_tracker:8180/Vivait-Tracker
|-
|Monitor Web||http://ip_monitor:8180/MonitorWeb
|-
|Monitorización Zabbix||http://ip_zabbix:80/zabbix
|-
|Base de datos tiempo real||http://ip_bbdd_tr:80/phpmyadmin/
|-
|Base de datos réplica||http://ip_bbdd_replica:80/phpmyadmin
|}

=== Permisos de aplicaciones ===
Se crean a través del '''portal de administración ''VIVA''it''' . Debe conocerse como funcionan los ejes [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Ejes| ver sección Portal de administracion - General - Ejes]] y que existen cuatro aplicaciones creadas en la plataforma:

[[Archivo:17_2 Pestaña Genera - Usuarios - Explicacion permisos.png|center]]

La forma como dar permisos de aplicaciones a un usuario esta explicada en la [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Portal_de_administraci%C3%B3n_VIVAit#Asignaci.C3.B3n_de_Permisos_de_Usuario_por_Administrador | sección Portal de administracion - General - Usuarios ]].

== Elementos monitorizados del sistema ==
===Generalidades de Zabbix===
====Zabbix ====
Zabbix es una solución de código abierto que ofrece características de monitorización avanzada de forma tecnica y para el negocio, para todo tipo de servidores, aplicaciones y equipos que forman parte de una red. La versión que utilizamos en '''md'''tel es Zabbix 2.2.2.

Zabbix monitoriza los recursos de un equipo en forma remota, permite centralizar la información en un servidor que permite visualizar el monitoreo, cuenta con una interfaz de administración vía web y utiliza un mecanismo flexible de la notificación que permita que los usuarios configuren las alarmas basadas email para informar virtualmente cualquier acontecimiento. Esto permite una reacción rápida a los problemas del servidor.

Para acceder al servidor Zabbix abrimos el navegador y ponemos la dirección de red (IP) de la maquina donde se encuentra instalado el servidor de Zabbix seguido de "/Zabbix.
{|
|-
|
Direccion.IP.Zabbix.Server/zabbix
|}

Zabbix posee documentación tanto en wiki, foros y comunidades.Para ampliar la información se puede visitar:
[[http://www.zabbix.com Sitio oficial de Zabbix]]
===== Glosario Zabbix =====
Se trata de una lista de conceptos básicos de Zabbix, pero para ampliar la información sobre otros términos, visite el [[http://www.zabbix.com Sitio oficial de Zabbix]].
* '''host'''
:En Zabbix, un host es una entidad que define el elemento en red que se desea monitorizar/supervisar activamente sus recursos locales y aplicaciones. Este puede ser una impresa, router, switch, sensores de temperatura, un servidor, un ordenador,etc, o también una aplicación. La característica de un host es que debe poseer una dirección de red (IP).

* '''host group'''
:En Zabbix, un host group (grupo host) es una agrupación lógica de los host, como una forma de organizar los dispositivos "Host" registrados en Zabbix para su monitorización. Puede contener hosts y templates. Los grupos host se utilizan en la asignación de derechos de acceso a los hosts para diferentes grupos de usuarios.

* '''item'''
:En Zabbix, un item (medida) es el parámetro que deseamos obtener del host, básicamente es una medida especifica que el servidor Zabbix recogerá de los agentes de Zabbix instalados en los host.

* '''trigger'''
:En Zabbix, un trigger(disparador) es una entidad que define un umbral para detectar la existencia de un problema en un dispositivo. Son valores recolectados por los "items", se usa para "evaluar" los datos recibidos con condiciones definidas. Las condiciones son de tipo aritmético y lógico.
* '''event'''
:En Zabbix, un event (evento) es la aparición de un suceso en Zabbix que necesita atención. Por ejemplo, el cambio de estado a raíz de un trigger, el descubrimiento de un nuevo agente (autoregistro),etc.
* '''action'''
:En Zabbix, una action(acción) son reglas predefinidas para reaccionar a un evento disparado por los triggers, es decir, define qué hacer ante un evento. Consta de operaciones (por ejemplo, una notificacion, comandos remotos) y condiciones (cuando la operación se lleva a cabo).
* '''notification'''
:En Zabbix, una notification (notificacion) es la entidad con que Zabbix nos puede notificar (Correo Electrónico,mensajes vía "SMS" o Jabber).
* '''template'''
:En Zabbix, un témplate (plantilla) viene predefinida en la instalación de Zabbix Server, con el fin de ser aplicada en base al tipo de sistema operativo(Linux, Mac, Window, etc) o en elementos que comparten los mismos parámetros de medición, por ejemplo la carga del procesador, uso de memoria y uso de recursos de red. Las plantillas son un conjunto de módulos "ITEM, TRIGGERS y GRÁFICAS", que están preconfigurados y listas para ser aplicadas a uno o varios hosts.
* '''application'''
:En Zabbix, una application (aplicación) es una agrupación lógica de los items.
* '''Zabbix server'''
:El Zabbix server (servidor de Zabbix) es el proceso central donde están definidas las configuraciones y donde se almacenan todos los datos y estadísticas recogidas de los agentes Zabbix.Consta de una base de datos, una interfaz web y el propio server. Como servidor, se encarga de recoger los datos de los agentes, calcular los triggers, enviar notificaciones, etc.
* '''Zabbix agent'''
:El zabbix agent (agente de Zabbix) es un proceso desplegado en los host que son supervisados, que funciona como un servicio y puede funcionar de forma activa y pasiva simultáneamente.

=====Discovery=====
La funcionalidad discovery(detección) lista los dispositivos que se integran en nuestra red y el tipo de servicios que proporciona. Por ejemplo, si la empresa tuviera cien colas ACDs, y veinticinco VDNS, y en cada cola como veinte medidas, seria muy laborioso registrar una por uno cada uno.
Gracias a esta funcionalidad, se descubre todas las interfaces de red que se tiene, automáticamente y tanto para colas nodos o IVR. Para utilizar esta funcionalidad , se hace el uso de dos script, que se instalan en el momento de instalación de Zabbix en el directorio "/usr/local/sbin", que son:
{|
|-
|
'''zabbixDiscoveryQueues.pl''' : script utilizado para buscar colas ACD.

'''zabbixDiscoveryVDN.pl''' : script utilizado para buscar VDNS.
|}
La explicación de como configurarla se encuentra en el manual oficial [[https://www.zabbix.com/documentation/2.2/manual/discovery/network_discovery/rule | Zabbix detección de redes]].

=====Notificaciones=====

Necesariamente, debe darse de alta al usuario y darse de alta el servidor de correo electrónico para poder ser capaz de enviar correos.

Por otro lado, el formato del correo electrónico y las condiciones de envío de correo al usuario se configura en las acciones. Véase el [[https://www.zabbix.com/documentation/2.2/manual/quickstart/notification | manual oficial de Zabbix 2.2]]

=====Usuarios=====
Zabbix permite la organización de usuarios en grupos para establecer los permisos adecuados de acuerdo al tipo de perfil que deseemos crear. Necesariamente un usuario debe permanecer a un grupo o varios grupos.Todos los usuarios acceden a la aplicación de Zabbix a través de la interfaz Web.

Cada usuario Zabbix se le asigna un nombre de usuario único , una contraseña y podemos indicarle que tipo de comunicación que posee, normalmente es vía email, pero puede ser vía a otro tipo de medios. Para mas información ver el [[https://www.zabbix.com/documentation/2.2/manual/web_interface/user_profile || manual oficial ]].

=====Visualización=====
Con Zabbix es posible visualizar los datos como gráficos, pantallas, mapas y hasta presentaciones cambiantes, entre otros. En este apartado solo nombraremos características esenciales que se tendra que completar con el [[https://www.zabbix.com/documentation/2.2/manual/config/visualisation | manual oficial]]
======Graphs======
{|
|-
|
'''Nota:''' Debe crearse algun item dentro del host para poder utilizar una gráfica.
|}
En Zabbix una gráfica sirve para representar gráficamente los resultados obtenidos de uno item o varios items.
[[File:EjemploGrafica.png|center|750px]]
Los valores min / avg / max que Zabbix obtiene y representa son de un registro de datos de la tabla tendencias.

======Screens======
La pantalla refiere a otra característica adaptable de ZABBIX cuál permite que los usuarios creen las pantallas personalizadas dentro de ZABBIX para exhibir la información. Se considera como una colección de gráficas y no depende del host. Una pantalla puede consistir en gráficos simples, gráficos personalizados, integrar mapas, Alertas, gráficos estadísticos o texto llano tal como los 5 valores pasados de un item particular entre otros; y mostrar la información de forma dinámica.

[[File:EjemploScreen.png|center|750px]]

======Maps======
En Zabbix, un map (mapa) es una representación gráfica de la situacion de nuestros dispositivos en red. Es un escenario que muestra nuestra red, aplicaciones y servicios a través de figuras o iconos. Dichas figuras toman vida en respuesta a los eventos que se dan en nuestro entorno.
[[File:EjemploMaps.png|center|750px]]
[[File:EstadosMaps.png|center|750px]]
===Zabbix en '''MD'''tel===

==== Configuraciones de Zabbix ====

===== Agentes Zabbix =====
{|-
|
|
'''Nota:''' Hay que instalar un agente Zabbix en cada maquina que se quiera monitorizar.
|}

El agente de Zabbix puede recoger datos:
*'''De forma pasiva:''' el server contacta al agente pidiéndole un dato (por ejemplo el consumo de CPU en ese instante) y el agente responde al server con ese dato. A esta acción del agente le llamaremos '''Agente activo'''.
*'''De forma activa:''' en un primer momento, el server le enviará al agente el listado de items a monitorizar. A partir de ese momento, será el agente que de forma periódica recogerá datos sobre esos ítems y se los hará llegar al server. A esta acción del agente le llamaremos ''''''Agente pasivo''''''.

====== Configurar agente de forma pasiva======
Para configurar el agente de Zabbix necesitamos acceder a la maquina que actuará como agente, y en el directorio /etc/zabbix modificar el fichero '''zabbix_agentd.conf''' e indicar cual es la dirección de red (IP) del servidor Zabbix.

{|
|-
|
##### Passive checks related
### Option: Server
# List of comma delimited IP addresses (or hostnames) of Zabbix servers.
# Incoming connections will be accepted only from the hosts listed here.
# If IPv6 support is enabled then '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1'
# are treated equall$
#
# Mandatory: no
# Default:
Server= IP.Server Zabbix.
|}
Tras la configuración del fichero, debemos reiniciar el servicio de los agentes.
{|
|-
|
sudo service zabbix-agent restart
|}

====== Configurar agente de forma activa ======

Para configurar el agente de Zabbix necesitamos acceder a la máquina que actuará como agente, y en el directorio /etc/zabbix modificar el fichero '''zabbix_agentd.conf''' e indicar cual es la dirección de red (IP) del servidor Zabbix.

{|
|-
|
##### Active checks related
### Option: ServerActive
# List of comma delimited IP:port (or hostname:port) pairs of Zabbix serv$
# If port is not specified, default port is used.
# IPv6 addresses must be enclosed in square brackets if port for that hos$
# If port is not specified, square brackets for IPv6 addresses are option$
# If this parameter is not specified, active checks are disabled.
# Example: ServerActive=127.0.0.1:20051,zabbix.domain,[::1]:30051,::1,[12$
#
# Mandatory: no
# Default:
ServerActive=127.0.0.1
--------------------------sección separada----------------------------
### Option: UserParameter
# User-defined parameter to monitor. There can be several user-defined pa$
# Format: UserParameter=<key>,<shell command>
# See 'zabbix_agentd' directory for examples.
#
# Mandatory: no
# Default:
# UserParameter=
User_parameters:asterisk.pid, /usr/bin/asterisk -rx 'core show chanels'|grep 'active calls'| cat -d -f 1
|}

El parámetro '''User_parameters''' tiene un formato de este estilo:
{|
|-
|
User_parameters: NombreMedida, comando.
|}

El nombre de la medida se refiere al nombre que demos a la aplicación , no hace falta que exista una aplicación con ese nombre en Zabbix, y el comando , es el comando remoto que tiene que ejecutar el servidor Zabbix. Posiblemente necesita darse permisos para ejecutar el comando y siempre debe devolver un valor (un numero o un tiempo) que el servidor Zabbix puede manejar.
Tras la configuración del fichero, debemos reiniciar el servicio de los agentes.
{|
|-
|
sudo service zabbix-agent restart
|}

===== Scripts del Servidor Zabbix =====
{|
|
|
'''Nota''': No olvidar que en la misma maquina del server Zabbix, debe configurarse como agente de Zabbix.
|}
Después de realizar la [[# Instalación de Zabbix | Instalación de Zabbix ]] correctamente. Se han creado otros ficheros scripts (''scripts propios de '''md'''tel'') que facilitarán la petición del servidor a los agentes activos, para poder parametrizar todos los elementos del negocio que suelen monitorizarse.
Dependiendo de lo que vaya a monitorizarse necesitaremos algún script o todos. Algunos nos informan sobre elementos de negocio, saber si asterisk funciona , monitorizar el CTI (lanzara nc localhost 1111) , controlar el Intz-Nimitz, comprobar si funciona motalsal, ect.

Cada script se exportara a los host, para que pueda facilitar los datos que pide el servidor Zabbix y configurarse.
Por ejemplo,para monitorizar las llamadas en curso del ACD, agentes conectados, agentes desconectados, etc.
Todos los scripts se deben colocar en el directorio /usr/local/sbin con permisos 755, su nombre es parecido a "zabbixSenderXXXXX.pl"
{|
|-
|
ls /usr/local/sbin/ |grep zabbixSender
'''zabbixSenderACDBD.pl'''
'''zabbixSenderACD.pl'''
'''zabbixSenderCTI.pl'''
'''zabbixSender-intz-nimitz.pl'''
'''zabbixSenderMotorSal.pl'''
'''zabbixSenderMyACDSuperv.pl'''
'''zabbixSenderRecordNodo.pl'''
'''zabbixSenderRecordCentral.pl'''
|}

Se crea una tarea programada en linux para poder ejecutarse los scripts, programando el tiempo en que debe ejecutarse.

Si visualizo que "............" aparece:

***** root zabbix

======zabbixSenderACDBD.pl======

'''Uso:''' Obtiene diversos valores por cada cola, estados de agente por cola y estados de agente generales.

'''Ubicación:''' Servidor BDTR.

'''Parámetros:''' Ruta al archivo de configuración (Por ejemplo: ''/etc/MDtel/zabbixSenderACDBD.pconf'')

'''Archivo de configuración:''' zabbixSenderACDBD.pconf

{|
|-
|
'''$db:''' Nombre de la BBDD (normalmente nimitz)
'''$dbHost:''' Dirección IP del servidor de BBDD de TR (normalmente BDTR)
'''$dbPort:''' Puerto MySQL (normalmente 3306)
'''$dbUsuario:''' Usuario MySQL (normalmente nimitz)
'''$dbClave:''' Clave del usuario
'''$sZab:''' Dirección IP del servidor Zabbix
'''$hZab:''' Nombre del host Zabbix (normalmente el nombre de máquina, tal y como se configura en
zabbix_agentd.conf o en el host en la web de Zabbix)
|}

======zabbixSenderACD.pl======

'''Uso:''' Obtener el PID de Asterisk para revisar si se ha reiniciado en caso de que cambie.

'''Ubicación:''' Servidor ACD.

'''Parámetros:''' Ruta al archivo de configuración (Por ejemplo: ''/etc/MDtel/zabbixSenderACD.pconf'').

'''Archivo de configuración:''' zabbixSenderACDBD.pconf.

{|
|-
|
'''$db:''' Nombre de la BBDD (normalmente nimitz)
'''$dbHost:''' Dirección IP del servidor de BBDD de TR (normalmente BDTR)
'''$dbPort:''' Puerto MySQL (normalmente 3306)
'''$dbUsuario:''' Usuario MySQL (normalmente nimitz)
'''$dbClave:''' Clave del usuario
'''$sZab:''' Dirección IP del servidor Zabbix
'''$hZab:''' Nombre del host Zabbix (normalmente el nombre de máquina, tal y como se configura en
zabbix_agentd.conf o en el host en la web de Zabbix)
|}

======zabbixSenderCTI.pl======

'''Uso:''' Obtener estado y los distintos valores de vivait-cti.

'''Ubicación:''' Servidor donde se ejecute vivait-cti. Normalmente el servidor ACD.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

======zabbixSender-intz-nimitz.pl======

'''Uso:''' Obtener estado y los distintos valores de intz-nimitz.

'''Ubicación:''' Servidor donde se ejecute intz-nimitz.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

======zabbixSenderMotorSal.pl======

'''Uso:''' Obtener estado y los distintos valores de motorSal.

'''Ubicación:''' Servidor donde se ejecute motorSal.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

======zabbixSenderMyACDSuperv.pl======

'''Uso:''' Obtener estado y los distintos valores de myAcdSuperv.

'''Ubicación:''' Servidor donde se ejecute myAcdSuperv.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

======zabbixSenderRecordNodo.pl======

'''Uso:''' Obtener estado y los distintos valores de recordNodo.

'''Ubicación:''' Servidor donde se ejecute recordNodo.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

======zabbixSenderRecordCentral.pl======
'''Uso:''' Obtener estado y los distintos valores de recordCentral.

'''Ubicación:''' Servidor donde se ejecute recordCentral.

'''Parámetros:'''
{|
|-
|
'''--sZab:''' Ip del servidor Zabbix. Si se omite, se asume localhost.
'''--hZab:''' Nombre del host Zabbix. Si se omite, se asume el nombre de máquina local.
|}

A continuación se muestra una tabla resumen de los distintos scripts y sus funcionalidades:

[[Archivo:Zabbix_scripts.png |960px]]

====== Dimensionamiento del servidor (Startpollers) ======
{|
|
|
'''Nota''': EL parámetro StartPollers es un parámetro numérico que forma parte del fichero de configuración
del servidor Zabbix(zabbix_server.conf). Por defecto el servidor Zabbix esta configurado para
iniciar con cinco startpollers.
|}

El servidor Zabbix puede hace peticiones a los agentes de las medidas que necesita o quiere. O en caso contrario los agentes envian en un tiempo determinado la información al servidor. Para recibir todas estas peticiones necesitamos los pollers.

Los poller son los procesos encargados de recibir todas las peticiones de medidas. Aumentaremos su cantidad dependiendo de la necesitad que tengamos. Para ello podemos observar la queue , que es la encargada de almacenar un listado de todas las cosas que están pedidas para medirse y recibirse. SI por ejemplo esta cola (queue) muestra mas de mil medidas seguramente estos pollers sean un cuello de botella y habrá que aumentar su numero.

=====Templates=====

Zabbix cuenta con templates (plantillas) que facilitan la tarea de "Registrar Equipos y Dispositivos" y agregarles métricas; acelerar el despliegue de las tareas de supervisión en un host; aplicar cambios masivos a tareas de supervisión. En '''md'''tel hemos creado plantillas propias que facilitan estos procesos, los cuales necesitaremos [[#Importar templates |importar templates]].

Las plantillas están vinculados directamente a los hosts individuales, por tanto se necesitaran utilizar en cada host.

Automáticamente, cada template rellena por item las aplicaciones, trigers, alarmas,gráficos,... etc.

A continuación, se muestran los distintos bloques de funciones de la instalación en función de cada template:

{| class="wikitable" style="text-align:center;"
|-
! Templates !! Se instalan en general
|-
| DRBD|| SI (si clúster)
|-
| motorSal|| -
|-
| Vivait-Suite ACD|| -
|-
| Vivait-Suite BBDD|| -
|-
| Vivait-Suite Record|| -
|-
| Vivait-Suite GW|| -
|-
| Vivait-Call Asterisk|| -
|-
| Vivait-Call bdCentral|| -
|-
| Vivait-Call bdNodo|| si
|-
| cambiarPerfil_Cal|| -
|-
| Template App Zabbix Server|| -
|-
| Template_OS_Linux*|| si(si no posee ip virtuales de clúster)
|-
| Template_App_MySQL|| si
|-
|}

{| class="wikitable" style="text-align:center;"
|+ '''Dependiendo del tipo de nodo:'''
|-
! Templates !! ACD !! Corporativo/GW
|-
| DRBD|| - || -
|-
| motorSal|| - || -
|-
| Vivait-Suite ACD|| Si || -
|-
| Vivait-Suite BBDD|| - || -
|-
| Vivait-Suite Record|| - || -
|-
| Vivait-Suite GW|| - || Si
|-
| Vivait-Call Asterisk|| - || Si
|-
| Vivait-Call bdCentral|| - || -
|-
| Vivait-Call bdNodo|| - || -
|-
| cambiarPerfil_Cal|| - || -
|-
| Template App Zabbix Server|| - || -
|-
| Template_OS_Linux*|| - || -
|-
| Template_App_MySQL|| - || -
|-
|}

{| class="wikitable" style="text-align:center;"
|+ '''Dependiendo del tipo de Base de dato'''s:
|-
! Templates !! BBDD Tiempo Real !! BBDD Réplica !! BBDD Copia
|-
| DRBD|| - || - || -
|-
| motorSal|| Si(si ACD) || - || -
|-
| Vivait-Suite ACD|| - || - || -
|-
| Vivait-Suite BBDD|| si || si || si
|-
| Vivait-Suite Record|| - || - || -
|-
| Vivait-Suite GW|| - || - || -
|-
| Vivait-Call Asterisk|| - || - || -
|-
| Vivait-Call bdCentral|| si || - || -
|-
| Vivait-Call bdNodo|| - || - || -
|-
| cambiarPerfil_Cal|| - || - || -
|-
| Template App Zabbix Server|| - || - || -
|-
| Template_OS_Linux*|| - || - || -
|-
| Template_App_MySQL|| - || - || -
|-
|}

{| class="wikitable" style="text-align:center;"
|-
! Templates !! Administración
|-
| DRBD|| -
|-
| motorSal|| -
|-
| Vivait-Suite ACD|| -
|-
| Vivait-Suite BBDD|| -
|-
| Vivait-Suite Record|| -
|-
| Vivait-Suite GW|| -
|-
| Vivait-Call Asterisk|| -
|-
| Vivait-Call bdCentral|| -
|-
| Vivait-Call bdNodo|| -
|-
| cambiarPerfil_Cal||SI (si posee servidor calendarios)
|-
| Template App Zabbix Server|| -
|-
| Template_OS_Linux*|| -
|-
| Template_App_MySQL|| -
|-
|}

{| class="wikitable" style="text-align:center;"
|-
! Templates !! Servidor de grabaciones
|-
| DRBD|| -
|-
| motorSal|| -
|-
| Vivait-Suite ACD|| -
|-
| Vivait-Suite BBDD|| -
|-
| Vivait-Suite Record|| Si
|-
| Vivait-Suite GW|| -
|-
| Vivait-Call Asterisk|| -
|-
| Vivait-Call bdCentral|| -
|-
| Vivait-Call bdNodo|| -
|-
| cambiarPerfil_Cal||-
|-
| Template App Zabbix Server|| -
|-
| Template_OS_Linux*|| -
|-
| Template_App_MySQL|| -
|-
|}

{| class="wikitable" style="text-align:center;"
|+ '''Monitorización'''
|-
! Templates !! General !! Contact Center
|-
| DRBD|| - || -
|-
| motorSal|| - || -
|-
| Vivait-Suite ACD|| - || -
|-
| Vivait-Suite BBDD|| - || -
|-
| Vivait-Suite Record|| - || -
|-
| Vivait-Suite GW|| - || -
|-
| Vivait-Call Asterisk|| - || -
|-
| Vivait-Call bdCentral|| - || -
|-
| Vivait-Call bdNodo|| - || -
|-
| cambiarPerfil_Cal|| - || -
|-
| Template App Zabbix Server|| si || -
|-
| Template_OS_Linux*|| - || -
|-
| Template_App_MySQL|| - || -
|-
|}

* El template OS Linux tiene asociado el Template App Zabbix Agent.
Una '''base de datos unificada''' es una base de datos de tiempo real junto a una base de datos de replica

====== Importar templates======

Las plantillas propias de '''md'''tel se encuentran en la ruta "'''/usr/src/nimitz/archivos'''" y empiezan con el nombre de "TemplateXXX.xml".

{|
|-
|
ls /usr/src/nimitz/archivos | grep Template
'''Template DRBD.xml'''
'''Template motorSal.xml'''
'''Templates Vivait-Suite_GW.xml'''
'''Templates Vivait-Suite.xml'''
'''Template Vivait-Call Asterisk.xml'''
'''Template Vivait-Call bdCentral.xml'''
'''Template Vivait-Call bdNodo.xml'''
'''Template Vivait-Call cambiarPerfil_Cal.xml'''

|}

La importación se realizara una vez a través de la web, no hace falta desde el servidor Zabbix, puede ser en cualquier computadora con acceso a la interfaz web de Zabbix.

[[File:ImportarTemplates.png|750px|center]]

Hay opciones varias opciones a elegir para importación de templates, pero podemos dejar por defecto las señaladas y pulsar el botón "import".

===Configuración para un primer funcionamiento de Zabbix===
Se describe una básica configuracion de Zabbix para cualquier equipo que utilice Windows o linux. Pues mediante la definición de hosts, items, triggers y acciones, Zabbix permite efectuar un monitoreo efectivo de plataformas IT heterogéneas.

====Configuración de los equipost (host) para la monitorización====
{|
|-
|
'''Nota''': Tenga en cuenta que debe de estar previamente configurado el agente Zabbix del
dispositivo a ser monitorizado apuntando a la IP del "Servidor Zabbix".
|}
Existen dos tipos de host:
* '''Host físico''': donde la dirección de red que registramos en Zabbix, corresponde al dispositivo que deseamos monitorizar.
* '''Host virtual''': es una dirección IP virtual, que puede relacionarse con un servidor Web, clusters, etc.

[[File:CreacionHost.png|750px|center]]

Las opciones basicas para configurar un host son las siguientes:
{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center ;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Host Name'''
| | Definir un nombre para el host.
||Se puede utilizar números, letras, espacios y guiones bajos están permitidos.
|-
| font-weight: bold;" | '''Visible Name'''
| | Identificar con un nombre, la maquina a la que se refiere el host.
||Si no tiene valor, se mostrara como nombre "Host Name".
|-
| font-weight: bold;" | '''Groups'''
| | Seleccionar al grupo de host que pertence.Seleccione uno o varios grupos de la caja derecha.
|| Los valores que puede seleccionar por defecto:
Discoverd hosts.

Switches.

Templates.

Templates MDtel.

Zabbix servers.

Linux Servers.

Hypervisors.

Virtual machines.

O crear uno nuevo en '''New group'''.

|-
| font-weight: bold;" | '''Agent interfaces'''
| |Se recomienda usar una dirección IP, en vez de un nombre de la maquina para resolver por un servidor de DNS que puede fallar.
| | 10050 por defecto
|}

Cuando termine, haga clic en nel boton "Save". Su nuevo "Host" debe ser visible en la lista de "Host registrados".Despues el zabbix, intentara configurarse el zabbix para conectarse a la IP.... cada x tiempo hace un barrido.

===== Comprobación de disponibilidad del host=====
Para saber si todo esta bien debemos ver la Z de disponibilidad.

[[File:EstadosZHost.png|750px|center]]

Indicacion de los colores del icono Z:

* Si el icono Z en la columna de disponibilidad es de color rojo, indica que hay un error en la comunicación - mueva el cursor del ratón sobre él para ver el mensaje de error.

* Si el icono es gris, significa que esta en proceso de comunicación con el "Agente Zabbix". Compruebe que el servidor Zabbix está en marcha, y pruebe a actualizar la página más tarde. El tiempo estimado para revisar si existe problemas es de 5 minutos.

* Si el icono es verde, esta funcionando correctamente.

====Indicar que plantilla(template) tendra el host [opcional]====
Tras [[#Importar templates |importar templates]] nos dirigimos al host ya configurado, y en su pestaña de templates pulsamos "add" y añadimos la plantilla/s adecuadas.

====Asignar items al host ====
{|
|-
|
'''Nota''':Un host puede tener un ITEM sin necesitad de tener template.
|}

Todos lo ITEMS se agrupan por HOST, esto significa que cada HOST tiene sus propios "Módulos que recogen datos del Host". Para agregar un nuevo módulo vamos a "Configuration → Hosts" y localizamos el "Host" al cual queremos agregarle un nuevo "Item".

[[File:CrearItemEjemplo.png|750px|center]]

Parametros o campos a rellenar para una configuración básica :

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center ;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Name'''
| | Definir un nombre para el item. Este nombre va a ser nuestro identificador para todas la gestiones en donde lo involucremos como el caso de Triggers.
||
|-
| font-weight: bold;" | '''Type'''
|| Indicar de que entidad queremos recibir informacion.
||Puede ser al "Agente Zabbix" o a el Hardware como impresoras, switch o routers.
|-
| font-weight: bold;" | '''Key'''
| | los "Items" utilizan "Key" que son parámetros de Zabbix. Los "Key" nos permiten indicar específicamente que tipo de información vamos a solicitara a la entidad. Se puede considerar también como el nombre de alguna aplicación.
||
|-
| font-weight: bold;" | '''host interface'''
| |Es la direccion de red del servidor zabbix (puede ser uno o mas)
| |
||
|-
| font-weight: bold;" | '''Units'''
| |Es la dirección de red del servidor zabbix (puede ser uno o mas)
| |
|-
| font-weight: bold;" | '''Type of information'''
| |Tipo de unidades con el que mostrar Zabbix el valor segundos, minutos, euros,....
||
|}

Cuando termine, haga clic en Guardar. El nuevo elemento debe aparecer en la ITEMLIST.
Para mas informacion [[http://entation/1.8/manual/config/items#zabbix_agent. ver documentación Zabbix]]

===== Ver la información recolectada por el item =====
{|
|-
|
'''Nota:''' Normalmente para ver la información lo encontraremos en "Monitoring → Latest data",luego
clic en el signo "+" en "other" siempre que no pertenezca a una aplicación.
En caso contrario, estará bajo el nombre de la aplicación.
|}

Después de definir el "Item" vamos a revisar la información que esta recolectando. . La información comenzará a ser recolectada según el tiempo que le indicamos en el "Item".

[[File:VerInfoITEM.png|750px|center]]

La espera para recibir la información varía dependiendo del tiempo de recolección del item, la mayoría suele ser aproximadamente al minuto de generar el "Item". Zabbix le ofrece la opción de visualizar la información en forma gráfica (sencilla). En el "Item" en lista haga clic en la columna "History - Graph".

[[File:VIsualGraficaValorItem.png|center|750px]]
Si en un caso usted no observa información le recomendamos:

* Ingrese al "Item" y revise que la información del "Key" este igual al ejemplo "system.cpu.load"
* Verifique que el agente este funcionando en el "Servidor a ser monitoreado" y que "El Servidor recolector Zabbix" este funcionando.
* El icono "Z" en el host debe estar en color verde.
* Asegure que esta monitoreando el servidor que le agregó este "Item"

====Configurar los Triggers para los host====
A partir de la información que captura los agentes , el servidor de Zabbix comienza a efectuar la recolección de estos items en la base de datos. Con esto se tiene un registro histórico de tales mediciones, que pueden ser tan simples como un simple ping hasta datos de uso de disco, memoria, cpu, etc.
A partir de los datos que se reciben de los agentes lo que sigue es definir y configurar Triggers, que son evaluaciones que hace Zabix de estos datos para determinar la existencia de un Problema en un dispositivo.
{|
|-
|
Nota: Un trigger necesita una accion, que indica que hacer cuando se activa el trigger.
|}

Un trigger(disparador) es un tipo de reacción ante unas medidas, como un disparador en el que si pasa algo se activa. Los Trigger en Zabbix son módulos que creamos a uno o múltiples "Items" para evaluar o comparar los valores recolectados por los "Items" con condiciones que nosotros definamos. Las condiciones son de tipo aritmético y lógico.

Para configurar un "Trigger o Disparador" seleccionamos "Configuration → Hosts" localizamos el "Host" de ejemplo que creamos y luego hacemos clic en "Trigger", después haga clic en "Create Trigger".

Parametros o campos a rellenar para una configuración básica :

{| class="wikitable" style="margin-left: auto; margin-right: auto; border: none;"
! align=center ;border-top:0.05pt solid #000000;border-bottom:0.05pt solid #000000;border-left:0.05pt solid #000000;border-right:none;padding:0cm;color:#ffffff;" | '''''Campos'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Explicación'''''
! align=center ;border:0.05pt solid #000000;padding:0cm;color:#ffffff;" | '''''Valores posibles'''''
|-
| font-weight: bold;" | '''Name'''
| | Definir un nombre para el trigger. Este nombre va a ser nuestro identificador para todas la gestiones en donde lo involucremos como el caso de los eventos.
||
|-
| font-weight: bold;" | '''Expression'''
|| Hay que indicar para que medida se crea (item) y sus funciones con los parametros adecuados. '''''Recomendación usar expression constructor que pedirá siempre al crearlo, para que item es y sus funciones...'''''
||Ejemplo: {New host:system.cpu.load.avg(180)}>2
|-
| font-weight: bold;" | '''Key'''
| | los "Items" utilizan "Key" que son parámetros de Zabbix. Los "Key" nos permiten indicar específicamente que tipo de información vamos a solicitara a la entidad. Se puede considerar tambien como el nombre de alguna aplicacion.
||
|-
| font-weight: bold;" | '''Descripción'''
| | Una descripción breve sobre el trigger.
||
|-
| font-weight: bold;" | '''Severity'''
| | everidad distinguida por colores,
|| No classified
Information
Warning
Average
High
Disaster
|}

===== Comprobar el estado del trigger =====
Podemos ver el estado del "Trigger" en "Monitoring → Triggers".El color en caso de que se active depende de la severidad definida. Por ejemplo, si el "Trigger" esta en color verde indica que el resultado de la métrica se mantiene por debajo de la condición que indicamos. Por el contrario si el resultado esta "sobre lo indicado" su color sera rojo.

[[File:EstadoTrigger.png|center|750px]]

====Asociar un Action al trigger====

Una action(acción) sirve para configurar un mensaje de alerta o una accion para Zabbix, ante un problema. Hay varias formas de gestionar un problema a través de una acción:

# A través de mensajes simples, alertando al instante.
# Escalar los mensajes hacia el jefe y/o otros grupos.
# Ejecución de commandos remotos.
# Notificaciones repetidas hasta que se resuelve el problema.
# Notificaciones y comandos retardados.
# Escenario complejo, la combinación de todo lo anterior.

Para crear una configuración en "Configuration-Actions". La explicación esta en la [[ https://www.zabbix.com/documentation/2.0/manual/config/notifications/action documentación de Zabbix]].
-->

== Integraciones con servicios externos ==

=== Presencia con Openfire ===
'''''VIVA'''''it se integra con servidor XMPP Openfire en su versión 3.10.2 (última probada)

Además del servidor, es necesario instalar un plugin de integración con asterisk 13, denominado "asterisk IM", versión 1.4.1

La instalación del servidor Openfire es una instalación estándar, realizada de paquete

La instalación del plugin es un "jar" que se carga desde la pagina de plugins de openfire

Con esto conseguiremos comunicar asterisk y OPenfire de manera que:
*Los estados telefónicos de una extensión '''''VIVA'''''it se reflejen en Openfire
*Poder marcar desde los clientes de IM instalados en los puestos
*Ver en el cliente llamadas entrantes al teléfono

-----

'''<big>Enlaces de interes:</big>'''

[http://www.igniterealtime.org/projects/openfire/ Página proyecto openfire]

[https://community.igniterealtime.org/thread/56076 Página proyecto "asterisk IM"]

=== Reuniones virtuales con Openmeetings ===
'''OpenMeetings''' es un sistema de vídeo web-conferencia en tiempo real. Usando recursos como audio (micrófono), vídeo (cámara web), posibilidad de subir y convertir presentaciones (en PDF , PPT o ODP que se convierten a Flash), compartición de la pantalla de tu ordenador, o pizarra digital compartida, panel de administración, posibilidad de grabar las sesiones… y completo soporte multiplataforma, es decir, que aparte de poder grabar las sesiones, se puede compartir un escritorio también desde una máquina Linux.

Para instalar '''OpenMettings''' debe seguir el [[http://vivait-wiki.mdtel.net/wiki/vivait/index.php/Manuales_de_instalaci%C3%B3n#Instalaci.C3.B3n_de_Openmeetings | manual de Instalación de Openmeetings]]

[[http://vivait-wiki.MDtel.net/wiki/vivait/index.php/Manual_de_operaci%C3%B3n_plataforma_VIVAit | Volver al índice]]

[[Category:tecnico]]
[[Category:VIVAit Call]]
[[Category:VIVAit Suite]]

Howto's

2017-08-07T09:57:42Z

Imatarrubias: /* Generación de un Core */

{| class="wikitable"
|-
! '''Producto: '''!! VIVAit Call
VIVAit Suite

VIVAit Fax
|-
|}

== Como parar asterisk ==
En situaciones límite en el que es necesario parar el asterisk y volver a arrancarlo hay que realizar los siguientes pasos:

Entrar en la consola de asterisk e introducir el comando core stop now

Si esto no funciona, tendremos que matar el proceso a mano. Esto es, primero el safe asterisk y luego el asterisk mediante el comando
kill -9 nºPID

Tras estos pasos, volveremos a arrancar el servicio asterisk mediante /etc/init.d/asterisk start

== Como configurar la megafonía ==

El servicio de megafonía se basa en el protocolo multicast.

Para configurar la megafonía tenemos que activar en los teléfonos que para que estén "escuchando" en una dirección multicast y tener un emisor en esa dirección multicast.

Los teléfonos suelen tener en su configuración un apartado para configurar el multicast. Por ejemplo en los yealink está en la pestaña directory sección multicast IP.

En los teléfonos se puede configurar manualmente o incluirlo en las plantillas de aprovisionamiento.

El asterisk tiene un canal para hacer multicast. Este canal es MulticastRTP.

Para esto podemos crear un VDN que contenga la siguiente línea. (en el ejemplo la dirección multicast es 239.0.126.1 y el puerto es el 10001).

[Cen_VDN_90000]
exten => _X.,1,NoOp(MDVDN_90000*****EXTEN=${EXTEN}**CID=${CALLERID(NUM)}**UCID=${UCID}*)
same => n,Answer
same => n,Dial(MulticastRTP/basic/239.0.126.1:10001)
include => Cen_finLlamada

== Como configurar el candado ==
El candado permite prohibir temporalmente la posibilidad de realizar llamadas hacia fuera. Sí se pueden seguir haciendo llamadas a extensiones fijas de la plataforma, es decir, llamadas sin coste.

Para configurar dicha funcionalidad basta con crear extensiones con la categoría mas restrictiva posible y habilitar la movilidad, con lo que la extensión solo tendrá "permisos" para realizar llamadas internas.

Para permitir llamadas externas solo hay que "mover" a un usuario con categoría suficiente a la extensión deseada.
== Como crear un grupo de captura y que se vea en cada teléfono el número que llama ==

'''ATENCIÓN: SE CREAN CONFIGURACIONES NO REFLEJADAS EN PORTAL DE ADMINISTRACIÓN'''

Para la simulación de grupos de captura y conseguir que todos los terminales vean el ANI del llamante:

- Hacen falta teléfonos con dos líneas

- Cada teléfono del grupo tiene en la línea 1 su extensión habitual (por ejemplo 40000)

- Además, en el fichero "sip_Estatico.conf", creamos una segunda extensión para cada teléfono, que le ocupará la segunda línea (por ejemplo 42000)

- En esta segunda linea ponemos que cuando se llame tenga otro tono de llamada (un beep o nada...) que se asemeje en funcionamiento al de un mensaje de llamada en otra extension de mi grupo de captura

- Se ha creado una variable global por cada teléfono en el fichero de variables "ext_MDtel_Particular.conf" de nombre EXTxxxxx (por ejemplo EXT40000); esa variable contiene las otras extensiones virtuales del grupo
por ejemplo EXT40000=>SIP/42001&SIP/42005

- Hemos creado en el dialplan programación para que cuando exista esa variable global se añada a la marcación el contenido

== Como crear supletorios ==

'''ATENCIÓN: SE CREAN CONFIGURACIONES NO REFLEJADAS EN PORTAL DE ADMINISTRACIÓN'''

Igual que el caso anterior pero en la variable ponemos números reales. Debido a un bug en el enrutador, que no devuelve la variable R_PARA, en el fichero ext_MARCAR_Extension.conf hay que sustituir la siguiente linea:

;same => n,ExecIf($["${EXT${R_PARA}}"=""]?NoOp:Set(ENR_CADMARCAR=${ENR_CADMARCAR}&${EXT${R_PARA}}))
Por esta otra:
same => n,ExecIf($["${EXT${R_DEST_${ENR_RUTA_CAD}}}"=""]?NoOp:Set(ENR_CADMARCAR=${ENR_CADMARCAR}&${EXT${R_DEST_${ENR_RUTA_CAD}}}))
ATENCIÓN !!! en las llamadas salientes cada uno presenta su número

Para emplear números externos en los supletorios hay que poner, al crear la variable que hemos explicado en el apartado anterior en el ext_MDtel_Particular.conf:

EXT335=>SIP/0999999999@Trunk_Movil ;En este caso suena en la ext 335 y en el móvil 999999999

== Generación de llamada automática ==

Para activar la funcionalidad es necesario lo siguiente:

* Definir una variable ID_LISTA_LLAMAME con el ID de la lista que se va a usar para generar la llamada. Cuando se cree la lista hay que asegurarse que el campo "Nº segundos límite" tiene un valor lo suficientemente amplio para evitar que la llamada caduque antes de ejecutarse.

* Establecer un timeout para la cola (en el Gosub Cen_Sub_GrupoACD se indica justo después de ${COLA})

* Llamar a la función de MySQL ACD_FUNC_LLAMAME_CREAR a través de MDintz

* En la función se usan los siguientes elementos variables:

${ID_LISTA_LLAMAME}: Definida antes clienteTOCola:
Nombre del cliente. Al no tener ningún nombre, se usa un denominador genérico
${CALLERID}: Número llamante, donde se dirigirá la llamada.

Ejemplo:

[Cen_VDN_99001]
;----------------------------------------------------------------------------------------------------------------
;----------------------- VDN 99001 ------------------------------------------------------------
;----------------------------------------------------------------------------------------------------------------
exten => _X.,1,NoOp(MDENTGW_99001*****EXTEN=${EXTEN}**CID=${CALLERID(NUM)}**UCID=${UCID}*)
same => n,Set(__COLA=89001)
same => n,Set(ctiDiriTrato=0)
same => n,Set(ctiDiriInterface=)
same => n,Set(ID_LISTA_LLAMAME=2)
same => n(cola),Gosub(Cen_Sub_GrupoACD,${EXTEN},1(${COLA},10,,Si,))
same => n,GotoIf($["${QUEUESTATUS}"!="TIMEOUT"]?colgar)
same => n,MDintz(nimitz|bd|sqlDato|select ACD_FUNC_LLAMAME_CREAR(CURRENT_TIMESTAMP\,${ID_LISTA_LLAMAME}\,""\,"clienteTOCola"\,""\,""\,""\,""\,""\,""\,""\,""\,1\,""\,"${CALLERID(NUM)}"\,1\,3\,1\,""\,0\,0\,0\,""\,""\,""\,""))
same => n,GotoIf($["${MDintzRes}"="OK"]?colgar)
same => n,NoOp(ACD_FUNC_LLAMAME_CREAR ${MDintzRes})
same => n(colgar),Hangup

== Cancelación de eco en la plataforma ==

Comprobar que el chan_dahdi.conf este configurado los parametros:
echocancel=yes
echocancelwhenbridged=yes
Jugar con los valores txgain y rxgain

Si esto no es suficiente el siguiente paso sería emplear una canceladora de echo por hardware.

== Como "dar paso" a través de un enlace exterior si hay una llamada para una extensión creada en el sistema pero no registrada ==

Este procedimiento es de utilidad en procesos de migración, en los que recibimos las llamadas de la RTC, nos las quedamos si la extensión ya está registrada en VIVAit y la mandamos hacia la plataforma a migrar si aún sigue migrada ahí

El procedimiento es:
* Activar desvío por no contesta en la extensión (portal de administración - VIVAit Call - Dispositivos - Extensiones - campo "Desvio no contesta", indicando como destino un prefijo (por ejemplo "99") seguido de la extensión destino

* Creamos una preruta en vivait-call - rutas -prerutas con origen "99", le quitamos el prefijo en campo "Destino saliente 1" (valor -2) e indicamos en campo "Tipo destino sal. 1" como "Ruta externa"

* Debera existir una ruta externa para esa numeración

== Comprobación de versiones de elementos de la plataforma ==

'''Aplicaciones'''
:* Botón derecho del ratón, Acerca De

'''Portales'''
:* En el Vivait-Call, en la pantalla de inicio de sesión pone el número de versión del portal.
:* Tanto en el Monitor como en el Tracker no se puede saber.

'''Demonios'''
:* Mediante el comando nc localhost <Puerto demonio>. Ejemplo:
::nc localhost 1120
::motorSal sis ver='03.02.00' inic='20150427 123457' alarmas=0 ultAlar='00000000000000'
::motorSal gmp msj=253/256 buf=256/256 tarea=99/102
::motorSal tmp uptime=12624 (0d 3h 30m 24s)
::motorSal mtr mys=1 ocup=0% planif=13(0) intento=11(0)

::Ejemplos puertos demonios:
:::*1111: vivait-cti
:::*1112: myAcdSuperv
:::*1113: recordNodo
:::*1114: recordCentral
:::*1115: intz-nimitz
:::*1120: motorSal
:::*1123: phoneprov-tftp

'''Base de datos'''
:* No se puede saber la versión a no ser que se comparen esquemáticos con los subidos en el redmine

[[Category:tecnico]]
[[Category:administrador]]
[[Category:VIVAit Call]]
[[Category:VIVAit Suite]]
[[Category:VIVAit Fax]]

== Añadir Auto-Answer a la cabecera SIP ==

Si queremos que un teléfono tenga autoanswer:
* En el peer poner: headeraa=Call-Info: answer-after=0, esto tiene que ir en la plantilla de la extensión o como campo en la extensión. Dependiendo del terminal que utilicemos el valor de este campo variará:

Aastra: Alert-Info: info=alert-autoanswer
Grandstream: Call-Info: answer-after=0
Linksys: Call-Info:\;Answer-After=0
Polycom: Alert-Info: Ring Answer
Snom: Call-Info: answer-after=0
Snom (nuevo firmware): Call-Info: <sip:IP>\;answer-after=0
Yealink: Call-Info: answer-after=0

* Luego en el diaplan añadir lo siguiente: exten => _[*#%0-9a-zA-Z].,n,set(__AutoAnswer=AA) (Esto tendremos que ver como ponerlo de manera automática). De manera provisional si queremos que sea para llamadas salientes pondremos esto en el ext_n_marcador.conf. Si queremos que sea llamadas entrantes lo pondremos en ext_n_MARCAR.conf

== Configuración de los portales web en HTTPS ==

Desde /usr/lib/jvm/default-java/bin/ ejecutamos:

keytool -genkey -alias tomcat -keyalg RSA -keystore /usr/share/tomcat7/.keystore

Escriba la contraseña del almacén de claves: (t0mc4t)
Volver a escribir la contraseña nueva: (t0mc4t)
*Personalizar para el cliente
¿Cuáles son su nombre y su apellido?
[Unknown]: VIVAit Suite
¿Cuál es el nombre de su unidad de organización?
[Unknown]: Desarrollo
¿Cuál es el nombre de su organización?
[Unknown]: MDtel
¿Cuál es el nombre de su ciudad o localidad?
[Unknown]: Madrid
¿Cuál es el nombre de su estado o provincia?
[Unknown]: Madrid
¿Cuál es el código de país de dos letras de la unidad?
[Unknown]: es
¿Es correcto CN=VIVAit Suite, OU=Desarrollo, O=MDtel, L=es, ST=Madrid,
C=Unknown?
[no]: si
Escriba la contraseña clave para <tomcat>
(INTRO si es la misma contraseña que la del almacén de claves)

nano /var/lib/tomcat7/conf/server.xml

Descomentar la línea:

<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"

maxThreads="150" scheme="https" secure="true"

clientAuth="false" sslProtocol="TLS"/>

Añadir después de sslProtocol="TLS":

keystorePass="t0mc4t"

== Crear un motivo desconexión para el Supervisor en '''''VIVA'''''it Suite==

Para crear motivos de desconexión adicionales a los que ya ofrece la aplicación tendremos que añadir una nueva entrada en la BD. El comando que emplearíamos seria el siguiente:

INSERT INTO `nimitz`.`COM_ENUMERADOS` (`ID`, `C_NOMBRE`, `C_TEXTO`, `N_POSICION`, `C_OBSERV`) VALUES(1000700, 'TSesAgMotDesc', 'Nombre Motivo de desconexión', 60, ' ');

El ID debe ser mayor o igual a 1000700 y menor a 1000800. El N_POSICION debe ser mayor o igual a 60 y menor que 100.

== Envío de variables CTI al ACD ante un GW con asterisk 13==
Dado que para un GW con asterisk 13 un nodo ACD es considerado un elemento externo, por defecto, no se envían variables CTI (UCID, ...). En una fututa versión del nodo ACD, ya no se considerará un elemento externo por lo que si se enviarán dichas variables. Para lograrlo en la versión 3.0 de la plataforma Vivait hay que modificar el fichero ext_MARCAR_Externo_Particular.conf del GW. Deberemos poner la siguiente linea.

same => n,Macro(escribirDatosCti)

== Script para cambio automático de claves en salas de conferencia estáticas ==

Para cambiar la clave de las salas de conferencias crear un script llamado cambioClaveConfe.sh con el siguiente contenido:

#!/bin/bash
CLAVE=$(shuf -i 1111-9999 -n 1)

echo $CLAVE

echo "update CEN_SALAS_CONFERENCIAS set C_PIN='$CLAVE' WHERE C_NOMBRE='$1'" | mysql -u nimitz -pivivanimitz nimitz

FROM=sat@mdtel.es
FECHA=`date +"%Y%m%d%H%M%S"`
CLIENTE=<PONER EL CLIENTE>
TO=<DESTINATARIOS>
ASUNTO="Nueva clave en sala $1"
CUERPO="La nueva clave para la sala $1 es: $CLAVE"
/usr/sbin/sendmail -oi -t -v -f $FROM <<EOF
From: $FROM
To: $TO
Bcc: $BCC
Subject: $ASUNTO

$CUERPO
EOF

El script cambiará la clave de la sala pasada por parámetro por una aleatoria de 4 dígitos y la enviará por correo a los <DESTINATARIOS> (direcciones de correo electrónico separadas por coma).

Hay que crear una tarea en /etc/crontab añadiendo una linea como la siguiente:
30 6 * * 7 root cambioClaveConfe.sh 6173

Esto ejecutará el script todos los domingos a las 6:30 horas cambiando la clave de la sala 6173. Añadir tantas linéas como salas.

== Monitorización en Zabbix de un trunk caído ==
Para monitorizar un o varios trunk por separado y saber el estado de cada uno es necesario lo siguiente:

*Añadir el UserParameter adjunto que contiene el siguiente texto:

UserParameter=asterisk.trunkEstado[*],sudo /usr/sbin/asterisk -rx 'sip show peers' | grep --text -i '$1' | grep OK >/dev/null; if [ $? -eq 0 ]; then echo 1; else echo 0; fi

*Añadir en el portal de zabbix un item por cada trunk. En el campo Key se pondrá "asterisk.trunkEstado[nombre_trunk]", donde nombre_trunk es el nombre del trunk tal y como se ve en Asterisk.
[[File:zabbix_item_trunkEstado.png]]

*Crear un trigger que avise cuando el último valor sea 0. Por ejemplo:
{corp-bdtr:asterisk.trunkEstado[PrePro-ACD].last()}=0

[[File:zabbix_trigger_trunkEstado.png]]

== Agendas en terminales Yealink ==
En la agenda se mostrará como nombre lo que contenga el campo CEN_AGENDAS.C_NOMBRE_MOSTRAR y como teléfono el indicado en CEN_AGENDAS_TELEFONOS.C_TELEFONO
Para hacer funcionar la agenda:

*En el archivo de aprovisionamiento correspondiente (Yealink-XXXX-comun.cfg) establecer los siguientes parámetros:

remote_phonebook.data.1.url = http://<direc IP>/vivait-agenda/yealink/contactData1.xml
remote_phonebook.data.1.name = NOMBRE DE LA AGENDA EN EL TELEFONO

*En el archivo /etc/apache2/apache2.conf añadir tras el último Directory:

<Directory /var/www/html/vivait-agenda/>
AddType application/x-httpd-php .xml
Options Indexes FollowSymLinks MultiViews
AllowOverride None
Order allow,deny
allow from all
</Directory>

*Ejecutar el comando:

/etc/init.d/apache2 reload

== Calendarios ==

=== Enrutamiento inteligente ===

Ante una llamada a un destino, si hay cita de ocupado en el calendario se desvia al número indicado en el campo "location" del calendario o a su buzon de voz si hay valor en dicho campo

same => n,Set(CalendarBusy=${CALENDAR_BUSY(GoogleCalendar)})
same => n,Set(id=${CALENDAR_QUERY(GoogleCalendar)})
same => n,NoOP(hay ${CALENDAR_QUERY_RESULT(${id},getnum)} eventos)
same => n,Verbose(3,The state of GoogleCalendar is $
{DEVICE_STATE(Calendar:GoogleCalendar)})
same => n,Set(CalendarLocation=${CALENDAR_QUERY_RESULT(GoogleCalendar,location)})
same => n,GotoIf($["${CalendarBusy}"=="1"]?:conCategoria)
same => n,GotoIf($["${CalendarLocation}"==""]?buzon)
same => n,Goto(Cen_iniLlam,${CalendarLocation},1)
same => n(buzon),Playback(Particular/buzon)
same => n,Hangup
same=> n(conCategoria),Goto(Cen_iniLlam,${EXTEN},1)

=== Conexión de cliente Outlook a calendarios VIVAit mediante Caldav===
Por defecto, el cliente outlook no soporta Caldav; si queremos disponer de calendarios de VIVAit en Outlook tendríamos dos opciones:
# Tener los calendarios en el servidor Exchange
# Instalar un plugin en el cliente outlook que permita conectar vía Caldav los calendarios que estén ubicados en el servidor de calendarios de VIVAit

Este howto se centra en esta segunda posibilidad

Procedimiento:

1.- Instalar Calldavsincronizer (valdrían otros plugin de Caldav para Outlook)

[https://sourceforge.net/projects/outlookcaldavsynchronizer/ https://sourceforge.net/projects/outlookcaldavsynchronizer/]

2.- Entrar en Synchronization Profiles en la nueva pestaña Calldav Syncronizer de outlook [[File:Syncronizer.png]]

3.- Añadir nuevo perfil (tecla +)

[[File:Nuevo.png|center|600px]]

A tener en cuenta:

*Crear un nuevo “Outlook folder”, entendemos que es adecuado (quizás necesario) para que las entradas de calendario de VIVAit queden diferenciadas.
*Lo mejor es haber creado antes el calendario en el servidor para que al darlo de alta en oulook comprobemos que se conecta.
*Dando al botón “Test or discover settings” se nos muestran todos los calendarios del servidor y elegimos el que queramos; en “elementos de la carpeta” diremos “elementos de calendario”.

[[File:Calendario.png|center|800px]]

== Uso de reloj hardware en nodos de procesamiento ==

=== En nodo de procesamiento ACD ===
En un nodo de procesamiento ACD es obligatorio instalar dahdi y una tarjeta de primario para emplear reloj hardware, ya que el reloj software que va en el asterisk 1.4 es defectuoso.
Para configurarlo basta con instalar la tarjeta en el servidor, instalar dahdi y posteriormente ejecutar el siguiente comando:

dahdi_cfg

Este comando generaŕa el fichero /etc/dahdi/system.conf

Para comprobar que el comando se ha ejecutado satisfactoriamente lo abriremos y tendrá que tener un formato semejante al siguiente ejemplo:

# Autogenerated by /usr/sbin/dahdi_genconf on Tue Oct 22 17:42:59 2013
# If you edit this file and execute /usr/sbin/dahdi_genconf again,
# your manual changes will be LOST.
# Dahdi Configuration File
#
# This file is parsed by the Dahdi Configurator, dahdi_cfg
#
# Span 1: WCT1/0 "Digium Wildcard TE110P T1/E1 Card 0" HDB3/CCS/CRC4
span=1,1,0,ccs,hdb3,crc4
# termtype: te
bchan=1-15,17-31
dchan=16
echocanceller=oslec,1-15,17-31
# Global data
loadzone = es
defaultzone = es

=== En nodo de procesamiento de corporativa ===
En un nodo de procesamiento de corporativa no obligatorio instalar dahdi y una tarjeta de primario para emplear reloj hardware, ya que el no se han detectado errores en el reloj por software. Sin embargo si instalamos dahdi y una tarjeta de primario para emplear reloj hardware, el sistema funcionará mejor.
Para configurarlo basta con instalar la tarjeta en el servidor, instalar dahdi y posteriormente ejecutar el siguiente comando:

dahdi_cfg

Este comando generaŕa el fichero /etc/dahdi/system.conf

Para comprobar que el comando se ha ejecutado satisfactoriamente lo abriremos y tendrá que tener un formato semejante al siguiente ejemplo:

# Autogenerated by /usr/sbin/dahdi_genconf on Tue Oct 22 17:42:59 2013
# If you edit this file and execute /usr/sbin/dahdi_genconf again,
# your manual changes will be LOST.
# Dahdi Configuration File
#
# This file is parsed by the Dahdi Configurator, dahdi_cfg
#
# Span 1: WCT1/0 "Digium Wildcard TE110P T1/E1 Card 0" HDB3/CCS/CRC4
span=1,1,0,ccs,hdb3,crc4
# termtype: te
bchan=1-15,17-31
dchan=16
echocanceller=oslec,1-15,17-31
# Global data
loadzone = es
defaultzone = es

== Aprovisionamiento terminales Cisco ==
=== Configurar protocolo SIP TCP o UDP en terminal Cisco ===

Configuración de terminal Cisco para para funcionar bajo TCP o UDP:
Modificar parámetro
<transportLayerProtocol>X</transportLayerProtocol>

Donde X es:
1: TCP
2: UDP
4: Valor por defecto del firmware (al menos en la última versión equivale a TCP)

=== Habilitar/Deshabilitar llamada en espera en terminales Cisco ===

En el fichero de aprovisionamiento del terminal añadiremos la siguiente linea
<callWaiting>X</callWaiting>

Donde X es:
0=off but can be changed through the settings menu.
1=on but can be changed through the settings menu.
2=off and locked so it can't be changed through the settings menu.
3=on and locked so it can't be changed through the settings menu.

== Como configurar servicio DHCP en Ubuntu Linux ==
=== ¿Que es un servicio DHCP? ===
Un servidor Dynamic Host Configuration Protocol (DHCP) asigna dinámicamente las direcciones IP y otras configuraciones de red a otros terminales que están conectados a la red.

=== Instalar un servicio DHCP ===
Para instalar el servidor de asignacion automatica de direccion IP ejecutamos el comando:
sudo apt-get install isc-dhcp-server

=== Configurando el servicio DHCP ===
Editamos el archivo /etc/dhcp/dhcpd.conf creando primero un backup del mismo:
mv /etc/dhcp/dhcpd.conf /etc/dhcp/dhcpd.conf.original
nano /etc/dhcp/dhcpd.conf

El archivo debe quedar de una forma muy similar a esta:
authoritative
subnet 10.254.239.0 netmask 255.255.255.254
{
range dynamic-bootp 10.254.239.40 10.254.239.60;
option domain-name-servers ns1.example.org, ns2.example.org;
option domain-name "example.org";
option routers rtr-239-0-1.example.org, rtr-239-0-2.example.org ;
option broadcast-address 10.254.239.255;
default-lease-time 3600;
max-lease-time 7200;
option option-150 10.254.239.25
}

Donde los campos:
*subnet: Direccion de red
*netmask: Máscara de red
*range dynamic-bootp: Rango de IPs que va a proporcionar el DHCP
*option domain-name-servers: Direcciones IPs de los DNS
*option domain-name: Nombre de dominio
*option routers:IPs de las puertas de enlace
*option broadcast-address: Dirección de broadcast
*default-lease-time: Tiempo de concesión por defecto
*max-lease-time: Valor máximo del tiempo de concesión
*option option-150: IPs de los servidores TFTPs que tiene la red

=== Reiniciamos el servicio ===
service isc-dhcp-server restart

=== Direcciones IP estáticas basadas en la MAC ===
Pueden conocerse las MAC de las máquinas conectadas a la red ejecutando el comando arp desde la terminal.

host ejemplo {
hardware ethernet 00:0B:82:19:A8:04;
option option-150 10.254.239.0;
# fixed-address 10.254.239.52;
}

== Protocolo Skinny en VIVAit Call mediante uso de Chan-SCCP ==
=== Instalación de chan_sccp ===
*Copiar el fichero chan-sccp-4.2.1.1.tar.gz en el directorio donde estén los fuentes de Asterisk (normalmente /usr/src/MDtel)
*Descomprimir
*Entrar al directorio chan-sccp-4.2.1.1
*Ejecutar: ./configure --with-asterisk=../DIRECTORIO_ASTERISK --enable-conference. Donde DIRECTORIO_ASTERISK es el nombre del directorio donde están los fuentes de asterisk.
*Tras el ejecutar el configure (si todo va bien al final se verá un resumen con el S.O, arquitectura, etc), ejecutar make y make install
*El nuevo módulo chan_sccp.so se generará dentro del DIRECTORIO_ASTERISK en lib/asterisk/modules/ y se deberá copiar en /usr/lib/asterisk/modules/
*Copiar el fichero sccp.conf a /etc/asterisk
*Entra a Asterisk y ejecutar: module load chan_sccp.so
*Si se ha cargado correctamente, desde dentro de Asterisk, si se teclea sccp show version deberá devolver: "Skinny Client Control Protocol (SCCP). Release: 4.3.0 4.3.0 - unknown (built by 'root' on '2016-06-01 10:42:32 UTC')"

=== Crear extensiones ===
*En el portal crear una nueva clase de dispositivo (Vivait-Call/Dispositivos/Clases de dispositivos), donde la clase sea extensión la subclase H323 (todavía no existe la subclase SCCP) y el formato SCCP/${DEST}
*Crear la nueva extensión, pero el dispositivo debe ser el creado en el campo anterior.
*Las extensiones creadas habrá que añadirlas al fichero sccp.conf así como los teléfonos que las usarán. En el fichero sccp.conf incluido hay ejemplos.

=== Aprovisionamiento ===
Los terminales se aprovisionan de la misma manera que los SIP, exceptuando que las plantillas XML no tiene referencias a SIP. Se incluye un xml genérico con todas las opciones.
Dentro del directorio chan-sccp-4.2.1.1 hay un directorio conf con todos los archivos de configuración necesarios. Las versiones annotated contienen todas las opciones posibles comentadas.

== Instalación y configuración Postfix en RedHat7 ==

'''Postfix''' es un ''servidor de correo'' de software libre/código abierto, un programa informático para el enrutamiento y envío de correo electrónico.

=== Instalación ===
yum install postfix

=== Configuración ===
Sobre la configuración de postfix por defecto (recién instalado):
Editar el fichero /etc/postfix/main.cf
inet_protocols = ipv4
relayhost = smtp.renfe.es
Revisar la configuración:
postfix check
Configurar postfix como servicio (sólo en redhat y similares)
chkconfig postfix on
Iniciar postfix:
service postfix start
Instalar mailx para disponer de los comandos mail y sendmail:
yum install mailx
Probar configuración:
echo "Prueba de correo" | mail -vs "Prueba" correo@destino.soy

== Como crear un TRIGGER en Zabbix ==

'''1.''' Hay '''dos posibilidades''' dependiendo si el trigger es para un solo host o es para varios, los cuales tienen en común un template:

:# Si es para ''un host'': Ir a '''Configuración/Hosts'''
:# Si es para ''un template'': Ir a '''Configuración/Templates'''

'''2.''' En la fila correspondiente al host/template al que queramos añadirle el trigger, pulsar sobre la '''columna triggers.''' 
'''3.''' En la ventana de triggers, pulsar sobre el botón '''Create trigger''', situado en la esquina superior derecha. 
'''4.''' Aparecerá la ventana de creación de triggers, que tiene los siguientes campos:
:1. '''Name:''' Nombre del trigger, que deberá ser lo ''suficientemente descriptivo''. Aparecerá cuando se
active, en la ventana principal de Zabbix así como en los correos de aviso.
:2. '''Expression:''' Define la fórmula cuyo resultado activará el trigger. Hay que pulsar el botón '''Add'''. Se mostrará una
nueva ventana donde habrá que elegir el item (medida) sobre el que se basará el trigger (evidentemente la medida deberá
existir previamente) y la función necesaria para el cálculo. Para una descripción de las disponibles dirigirse a
https://www.zabbix.com/documentation/2.2/manual/appendix/triggers/functions. 
Tras rellenar los campos anteriores y dar a la función los valores que necesite pulsar el botón '''Insert.'''
:3. '''Expression constructor:''' Permite crear expresiones complejas, uniendo varias.
:4. '''Description:''' Una explicación del trigger
:5. '''Severity:''' Criticidad el trigger
:6. Para una descripción del resto de campos visitar la página: https://www.zabbix.com/documentation/2.2/manual/config/triggers/trigger
'''5.''' Tras rellenar los campos, pulsar el botón '''Save'''. 
'''6.''' Si el trigger se ha añadido en un template, aparecerá en todos los hosts que tienen el template configurado. 
'''7.''' '''El trigger por si solo no envía ningún aviso''', solo se activa si se cumple la expresión definida.
Para enviar un aviso (normalmente un correo electrónico) cuando se active el trigger, será necesario definir una acción (Configuración/Actions).

'''NOTA.-''' Para consultar cualquier cuestión relativa a Zabbix, se encuentra a su disposición el manual: 
https://www.zabbix.com/documentation/2.2/manual

== Como mostrar callername queues FOP2 ==

Es necesario añadir el siguiente código al contexto de entrada:

exten => _X.,n,MYSQL(Connect connid localhost usuario clave bd)
exten => _X.,n,MYSQL(Query resultid ${connid} SELECT\ firstname\,lastname\ from\ fop2\ where\ phone1=${CALLERID(num)}\ OR\ phone2=${CALLERID(num)})
exten => _X.,n,MYSQL(Fetch fetchid ${resultid} nombre apellidos)
exten => _X.,n,GotoIf($[${fetchid} = 1]?:noExiste)
exten => _X.,n,Set(CALLERID(name)=${nombre}${apellidos})
exten => _X.,n(noExiste),Continuar

En la primera línea cambiar según lo necesario:

*localhost: Dirección IP del servidor de MySQL donde está la BBDD de FOP2
*usuario: Usuario con permisos de acceso a la bbdd de FOP2
*clave: Clave del usuario
*bd: Nombre de la BBDD

== Como ver los directorios de un NAS a montar con NFS ==

Con el siguiente comando vemos los diferentes volúmenes de un NAS:

showmount -e IP_NAS

Ejemplo de salida:

Export list for 192.168.10.10:
/Backup/backup *
/DISCOS_1/VOL1_AUDIO *

== Instalación de ActivaSTP con VIVAit Call 3 y marcación desde Outlook ==

Instalamos ActivaSTP desde:

(http://activa.sourceforge.net/)



La configuración necesaria se muestra en la siguiente imagen:

[[File:Ventana ActivaTSP.jpg]]

El usuario del manager debe tener permisos originate para poder realizar llamadas.

Se han realizado pruebas con Outlook 2013.

Se ha comprobado la correcta realización de pruebas utilizando ActivaSTP, realizadon llamadas desde la pestaña "personas" con la vista en modo tarjeta de Pesentación, tarjeta, teléfono o lista.

Outlook 2013 no da la opción de llamar si la vista está en modo personas.

== Como volver a procesar grabaciones con error ==

Las grabaciones con error son aquellas que tienen el valor E_GRABACION=120 en la tabla DAT_GRABACIONES.

Las grabaciones con error se producen normalmente por la pérdida de conexión entre el nodo servidor de grabaciones y el resto.

Para reprocesar la grabación hay que modificar el campo E_GRABACION de la tabla DAT_GRABACIONES y ponerlo con valor 20 para que así el recordCentral la vuelva a procesar.

== FOP2. Problemas en transferencias asistidas ==

Para habilitar la transferencia atendida del asterisk (funcion atxfer), hay que poner la opción tT en el queue() si la llamada origen la realiza a una cola o
al dial() de las extensiones.
Con eso vemos como al intentar hacer la llamada de consulta ya se va a nuestro dialplan. Sin embargo la llamada no funciona ya que el enrutador nos da error de
enrutamiento porque no tenemos ID_DISPOSITIVO origen ya que el fop no es un elemento creado desde el portal.
Por lo que se propone como solución crear un contexto de inicio del fop y asignarle un ID_DISPOSITIVO para que así se enrute la llamada. El contexto tienen que
ser similar a ext_InicioLlamada_Chrome.conf

Para que funcione las transferencias supervisadas desde el fop2 hay que realizar lo siguiente:

*El usuario del manager debe tener permisos Atxfer para poder realizar transferencias.
*Habilitar la transferencia atxfer en el fuatures.conf del asterisk. atxfer => *2
*Crear el fichero ext_InicioLlamada_FOP.conf con el siguiente contenido:

[Cen_Inicio_FOP]
exten => [*#%0-9].,1,NoOp(MDINICHR**EXTEN=${EXTEN}**CID=${CHROME_ANI}*)
same => n,dumpchan()
;same => n,Set(CALLERID=${CHROME_ANI})
same => n,Gosub(Cen_Sub_getIdExtension,s,1(${R_CID_NUM_00}))
same => n,ExecIf($["${GOSUB_RETVAL}"!="OK" | "${sqlDato}"=""]?HangUp)
same => n,Set(ID_DISPOSITIVO=${sqlDato})
; . Modificar MARCAR en funcion de reglas de marcacion saliente (prefijo 0, ...)
; Esto se modificara en el contexto Cen_Inicio_Chrome_Particular
same => n,Set(MARCAR=${EXTEN})
;---------------------------------

;--- Llamada a contexto particular
;---------------------------------
; Esta llamada es para hacer cosas especcificas del cliente (cambiar callerid...)
; La subrutina Cen_Inicio_Chrome_Particular esta en el archivo ext_InicioLlamada_Chrome_Particular.conf
; Si no existe el archivo copiar el archivo ext_InicioLlamada_Chrome_Particular.conf.ejemplo como ext_Inicio_Chrome_Particular.conf
; y realizar las modificaciones necesarias
; El fichero ext_InicioLlamada_Chrome_Particular.conf se carga automaticamente al ser creado con el include de ext_InicioLlamada.conf
; #include "ext_InicioLlamada*.conf"
;
same => n,GosubIf($[${DIALPLAN_EXISTS(Cen_Inicio_FOP_Particular,${EXTEN},1)}>0]?Cen_Inicio_FOP_Particular,${EXTEN},1)
same => n,Goto(Cen_Inicio_SIP,${MARCAR},1)

*En el fichero /usr/local/fop2/buttons.cfg poner como contexto de las extensiones el creado anteriormente (Cen_Inicio_FOP)
*Modificar el fichero /usr/local/fop2/fop2.cfg:

blind_transfer = 0
supervised_transfer = 1

Para realizar la transferencia con consulta, hay que pulsar el supervised transfer del FOP2 y una vez se haya establecido la llamada, seleccionar la extensión que "sobra" en la conversación y pulsar la tecla de hangup y colgar la llamada.



== Como borrar contenido de la tabla BDTR con el script borraRegistrosNimitz.pl ==

Este script se ejecuta mediante una tarea del crontab, tal como la siguiente:

SHELL=/bin/sh
PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
# m h dom mon dow user command
00 01 * * * root /usr/local/sbin/borraRegistrosNimitz.pl --hDB localhost

Para establecer el número de días que vamos a dejar en la base de datos debemos editar el archivo borraRegistrosNimitz.pl, el campo my $numDias.

== Ocasionalmente No saltan los formularios en '''VIVAit Suite''' cuando existen marcadores ==
En los sistemas con marcadores, se ha observado que, en un porcentaje muy bajo, cuando entra una llamada a un agente no se presenta el formulario.
En una traza del vivait-desk se pudo comprobar que no había eventos CTI de la llamada, pero telefónicamente la llamada si quedaba establecida.

El problema viene ocasionado porque el CTI tiene auditorías para descartar llamadas,evitando que se queden enganchadas.

Una de esas auditorías es el tiempo máximo de las llamadas no contestadas.

El marcador tiene puesto a fuego que el tiempo que permanece una llamada en cola a la espera de un agente libre es de 10 minutos.

Hay que poner el tiempo de auditoría en un valor superior (por ejemplo 12 minutos)

En el archivo de configuración '''vivait-cti.conf'''

audit_call_minutNoContestada = 12

El paŕametro audit_call_minutContestada, es el tiempo que el cti "conserva" una llamada, dado que el dialplan tiene puesto el timeout absolute a 7200 (120 minutos), deberiamos modificar este parámetro para que esté sincronizado

audit_call_minutContestada = 120

Estos cambios se implementarán en el instalador de la próxima versión.

== Generación de un Core ==
Un Core es la memoria de un programa.

Para generar un Core rápido con Asterisk hay que hacer lo siguiente:

Ejecutar ps aux | grep asterisk y coger el PID del programa
gdb /usr/sbin/asterisk [PID]
gcore [file]

Howto's

2017-07-26T07:02:41Z

Imatarrubias: /* Como borrar contenido de la tabla BDTR con el script borraRegistrosNimitz.pl */

{| class="wikitable"
|-
! '''Producto: '''!! VIVAit Call
VIVAit Suite

VIVAit Fax
|-
|}

== Como parar asterisk ==
En situaciones límite en el que es necesario parar el asterisk y volver a arrancarlo hay que realizar los siguientes pasos:

Entrar en la consola de asterisk e introducir el comando core stop now

Si esto no funciona, tendremos que matar el proceso a mano. Esto es, primero el safe asterisk y luego el asterisk mediante el comando
kill -9 nºPID

Tras estos pasos, volveremos a arrancar el servicio asterisk mediante /etc/init.d/asterisk start

== Como configurar la megafonía ==

El servicio de megafonía se basa en el protocolo multicast.

Para configurar la megafonía tenemos que activar en los teléfonos que para que estén "escuchando" en una dirección multicast y tener un emisor en esa dirección multicast.

Los teléfonos suelen tener en su configuración un apartado para configurar el multicast. Por ejemplo en los yealink está en la pestaña directory sección multicast IP.

En los teléfonos se puede configurar manualmente o incluirlo en las plantillas de aprovisionamiento.

El asterisk tiene un canal para hacer multicast. Este canal es MulticastRTP.

Para esto podemos crear un VDN que contenga la siguiente línea. (en el ejemplo la dirección multicast es 239.0.126.1 y el puerto es el 10001).

[Cen_VDN_90000]
exten => _X.,1,NoOp(MDVDN_90000*****EXTEN=${EXTEN}**CID=${CALLERID(NUM)}**UCID=${UCID}*)
same => n,Answer
same => n,Dial(MulticastRTP/basic/239.0.126.1:10001)
include => Cen_finLlamada

== Como configurar el candado ==
El candado permite prohibir temporalmente la posibilidad de realizar llamadas hacia fuera. Sí se pueden seguir haciendo llamadas a extensiones fijas de la plataforma, es decir, llamadas sin coste.

Para configurar dicha funcionalidad basta con crear extensiones con la categoría mas restrictiva posible y habilitar la movilidad, con lo que la extensión solo tendrá "permisos" para realizar llamadas internas.

Para permitir llamadas externas solo hay que "mover" a un usuario con categoría suficiente a la extensión deseada.
== Como crear un grupo de captura y que se vea en cada teléfono el número que llama ==

'''ATENCIÓN: SE CREAN CONFIGURACIONES NO REFLEJADAS EN PORTAL DE ADMINISTRACIÓN'''

Para la simulación de grupos de captura y conseguir que todos los terminales vean el ANI del llamante:

- Hacen falta teléfonos con dos líneas

- Cada teléfono del grupo tiene en la línea 1 su extensión habitual (por ejemplo 40000)

- Además, en el fichero "sip_Estatico.conf", creamos una segunda extensión para cada teléfono, que le ocupará la segunda línea (por ejemplo 42000)

- En esta segunda linea ponemos que cuando se llame tenga otro tono de llamada (un beep o nada...) que se asemeje en funcionamiento al de un mensaje de llamada en otra extension de mi grupo de captura

- Se ha creado una variable global por cada teléfono en el fichero de variables "ext_MDtel_Particular.conf" de nombre EXTxxxxx (por ejemplo EXT40000); esa variable contiene las otras extensiones virtuales del grupo
por ejemplo EXT40000=>SIP/42001&SIP/42005

- Hemos creado en el dialplan programación para que cuando exista esa variable global se añada a la marcación el contenido

== Como crear supletorios ==

'''ATENCIÓN: SE CREAN CONFIGURACIONES NO REFLEJADAS EN PORTAL DE ADMINISTRACIÓN'''

Igual que el caso anterior pero en la variable ponemos números reales. Debido a un bug en el enrutador, que no devuelve la variable R_PARA, en el fichero ext_MARCAR_Extension.conf hay que sustituir la siguiente linea:

;same => n,ExecIf($["${EXT${R_PARA}}"=""]?NoOp:Set(ENR_CADMARCAR=${ENR_CADMARCAR}&${EXT${R_PARA}}))
Por esta otra:
same => n,ExecIf($["${EXT${R_DEST_${ENR_RUTA_CAD}}}"=""]?NoOp:Set(ENR_CADMARCAR=${ENR_CADMARCAR}&${EXT${R_DEST_${ENR_RUTA_CAD}}}))
ATENCIÓN !!! en las llamadas salientes cada uno presenta su número

Para emplear números externos en los supletorios hay que poner, al crear la variable que hemos explicado en el apartado anterior en el ext_MDtel_Particular.conf:

EXT335=>SIP/0999999999@Trunk_Movil ;En este caso suena en la ext 335 y en el móvil 999999999

== Generación de llamada automática ==

Para activar la funcionalidad es necesario lo siguiente:

* Definir una variable ID_LISTA_LLAMAME con el ID de la lista que se va a usar para generar la llamada. Cuando se cree la lista hay que asegurarse que el campo "Nº segundos límite" tiene un valor lo suficientemente amplio para evitar que la llamada caduque antes de ejecutarse.

* Establecer un timeout para la cola (en el Gosub Cen_Sub_GrupoACD se indica justo después de ${COLA})

* Llamar a la función de MySQL ACD_FUNC_LLAMAME_CREAR a través de MDintz

* En la función se usan los siguientes elementos variables:

${ID_LISTA_LLAMAME}: Definida antes clienteTOCola:
Nombre del cliente. Al no tener ningún nombre, se usa un denominador genérico
${CALLERID}: Número llamante, donde se dirigirá la llamada.

Ejemplo:

[Cen_VDN_99001]
;----------------------------------------------------------------------------------------------------------------
;----------------------- VDN 99001 ------------------------------------------------------------
;----------------------------------------------------------------------------------------------------------------
exten => _X.,1,NoOp(MDENTGW_99001*****EXTEN=${EXTEN}**CID=${CALLERID(NUM)}**UCID=${UCID}*)
same => n,Set(__COLA=89001)
same => n,Set(ctiDiriTrato=0)
same => n,Set(ctiDiriInterface=)
same => n,Set(ID_LISTA_LLAMAME=2)
same => n(cola),Gosub(Cen_Sub_GrupoACD,${EXTEN},1(${COLA},10,,Si,))
same => n,GotoIf($["${QUEUESTATUS}"!="TIMEOUT"]?colgar)
same => n,MDintz(nimitz|bd|sqlDato|select ACD_FUNC_LLAMAME_CREAR(CURRENT_TIMESTAMP\,${ID_LISTA_LLAMAME}\,""\,"clienteTOCola"\,""\,""\,""\,""\,""\,""\,""\,""\,1\,""\,"${CALLERID(NUM)}"\,1\,3\,1\,""\,0\,0\,0\,""\,""\,""\,""))
same => n,GotoIf($["${MDintzRes}"="OK"]?colgar)
same => n,NoOp(ACD_FUNC_LLAMAME_CREAR ${MDintzRes})
same => n(colgar),Hangup

== Cancelación de eco en la plataforma ==

Comprobar que el chan_dahdi.conf este configurado los parametros:
echocancel=yes
echocancelwhenbridged=yes
Jugar con los valores txgain y rxgain

Si esto no es suficiente el siguiente paso sería emplear una canceladora de echo por hardware.

== Como "dar paso" a través de un enlace exterior si hay una llamada para una extensión creada en el sistema pero no registrada ==

Este procedimiento es de utilidad en procesos de migración, en los que recibimos las llamadas de la RTC, nos las quedamos si la extensión ya está registrada en VIVAit y la mandamos hacia la plataforma a migrar si aún sigue migrada ahí

El procedimiento es:
* Activar desvío por no contesta en la extensión (portal de administración - VIVAit Call - Dispositivos - Extensiones - campo "Desvio no contesta", indicando como destino un prefijo (por ejemplo "99") seguido de la extensión destino

* Creamos una preruta en vivait-call - rutas -prerutas con origen "99", le quitamos el prefijo en campo "Destino saliente 1" (valor -2) e indicamos en campo "Tipo destino sal. 1" como "Ruta externa"

* Debera existir una ruta externa para esa numeración

== Comprobación de versiones de elementos de la plataforma ==

'''Aplicaciones'''
:* Botón derecho del ratón, Acerca De

'''Portales'''
:* En el Vivait-Call, en la pantalla de inicio de sesión pone el número de versión del portal.
:* Tanto en el Monitor como en el Tracker no se puede saber.

'''Demonios'''
:* Mediante el comando nc localhost <Puerto demonio>. Ejemplo:
::nc localhost 1120
::motorSal sis ver='03.02.00' inic='20150427 123457' alarmas=0 ultAlar='00000000000000'
::motorSal gmp msj=253/256 buf=256/256 tarea=99/102
::motorSal tmp uptime=12624 (0d 3h 30m 24s)
::motorSal mtr mys=1 ocup=0% planif=13(0) intento=11(0)

::Ejemplos puertos demonios:
:::*1111: vivait-cti
:::*1112: myAcdSuperv
:::*1113: recordNodo
:::*1114: recordCentral
:::*1115: intz-nimitz
:::*1120: motorSal
:::*1123: phoneprov-tftp

'''Base de datos'''
:* No se puede saber la versión a no ser que se comparen esquemáticos con los subidos en el redmine

[[Category:tecnico]]
[[Category:administrador]]
[[Category:VIVAit Call]]
[[Category:VIVAit Suite]]
[[Category:VIVAit Fax]]

== Añadir Auto-Answer a la cabecera SIP ==

Si queremos que un teléfono tenga autoanswer:
* En el peer poner: headeraa=Call-Info: answer-after=0, esto tiene que ir en la plantilla de la extensión o como campo en la extensión. Dependiendo del terminal que utilicemos el valor de este campo variará:

Aastra: Alert-Info: info=alert-autoanswer
Grandstream: Call-Info: answer-after=0
Linksys: Call-Info:\;Answer-After=0
Polycom: Alert-Info: Ring Answer
Snom: Call-Info: answer-after=0
Snom (nuevo firmware): Call-Info: <sip:IP>\;answer-after=0
Yealink: Call-Info: answer-after=0

* Luego en el diaplan añadir lo siguiente: exten => _[*#%0-9a-zA-Z].,n,set(__AutoAnswer=AA) (Esto tendremos que ver como ponerlo de manera automática). De manera provisional si queremos que sea para llamadas salientes pondremos esto en el ext_n_marcador.conf. Si queremos que sea llamadas entrantes lo pondremos en ext_n_MARCAR.conf

== Configuración de los portales web en HTTPS ==

Desde /usr/lib/jvm/default-java/bin/ ejecutamos:

keytool -genkey -alias tomcat -keyalg RSA -keystore /usr/share/tomcat7/.keystore

Escriba la contraseña del almacén de claves: (t0mc4t)
Volver a escribir la contraseña nueva: (t0mc4t)
*Personalizar para el cliente
¿Cuáles son su nombre y su apellido?
[Unknown]: VIVAit Suite
¿Cuál es el nombre de su unidad de organización?
[Unknown]: Desarrollo
¿Cuál es el nombre de su organización?
[Unknown]: MDtel
¿Cuál es el nombre de su ciudad o localidad?
[Unknown]: Madrid
¿Cuál es el nombre de su estado o provincia?
[Unknown]: Madrid
¿Cuál es el código de país de dos letras de la unidad?
[Unknown]: es
¿Es correcto CN=VIVAit Suite, OU=Desarrollo, O=MDtel, L=es, ST=Madrid,
C=Unknown?
[no]: si
Escriba la contraseña clave para <tomcat>
(INTRO si es la misma contraseña que la del almacén de claves)

nano /var/lib/tomcat7/conf/server.xml

Descomentar la línea:

<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"

maxThreads="150" scheme="https" secure="true"

clientAuth="false" sslProtocol="TLS"/>

Añadir después de sslProtocol="TLS":

keystorePass="t0mc4t"

== Crear un motivo desconexión para el Supervisor en '''''VIVA'''''it Suite==

Para crear motivos de desconexión adicionales a los que ya ofrece la aplicación tendremos que añadir una nueva entrada en la BD. El comando que emplearíamos seria el siguiente:

INSERT INTO `nimitz`.`COM_ENUMERADOS` (`ID`, `C_NOMBRE`, `C_TEXTO`, `N_POSICION`, `C_OBSERV`) VALUES(1000700, 'TSesAgMotDesc', 'Nombre Motivo de desconexión', 60, ' ');

El ID debe ser mayor o igual a 1000700 y menor a 1000800. El N_POSICION debe ser mayor o igual a 60 y menor que 100.

== Envío de variables CTI al ACD ante un GW con asterisk 13==
Dado que para un GW con asterisk 13 un nodo ACD es considerado un elemento externo, por defecto, no se envían variables CTI (UCID, ...). En una fututa versión del nodo ACD, ya no se considerará un elemento externo por lo que si se enviarán dichas variables. Para lograrlo en la versión 3.0 de la plataforma Vivait hay que modificar el fichero ext_MARCAR_Externo_Particular.conf del GW. Deberemos poner la siguiente linea.

same => n,Macro(escribirDatosCti)

== Script para cambio automático de claves en salas de conferencia estáticas ==

Para cambiar la clave de las salas de conferencias crear un script llamado cambioClaveConfe.sh con el siguiente contenido:

#!/bin/bash
CLAVE=$(shuf -i 1111-9999 -n 1)

echo $CLAVE

echo "update CEN_SALAS_CONFERENCIAS set C_PIN='$CLAVE' WHERE C_NOMBRE='$1'" | mysql -u nimitz -pivivanimitz nimitz

FROM=sat@mdtel.es
FECHA=`date +"%Y%m%d%H%M%S"`
CLIENTE=<PONER EL CLIENTE>
TO=<DESTINATARIOS>
ASUNTO="Nueva clave en sala $1"
CUERPO="La nueva clave para la sala $1 es: $CLAVE"
/usr/sbin/sendmail -oi -t -v -f $FROM <<EOF
From: $FROM
To: $TO
Bcc: $BCC
Subject: $ASUNTO

$CUERPO
EOF

El script cambiará la clave de la sala pasada por parámetro por una aleatoria de 4 dígitos y la enviará por correo a los <DESTINATARIOS> (direcciones de correo electrónico separadas por coma).

Hay que crear una tarea en /etc/crontab añadiendo una linea como la siguiente:
30 6 * * 7 root cambioClaveConfe.sh 6173

Esto ejecutará el script todos los domingos a las 6:30 horas cambiando la clave de la sala 6173. Añadir tantas linéas como salas.

== Monitorización en Zabbix de un trunk caído ==
Para monitorizar un o varios trunk por separado y saber el estado de cada uno es necesario lo siguiente:

*Añadir el UserParameter adjunto que contiene el siguiente texto:

UserParameter=asterisk.trunkEstado[*],sudo /usr/sbin/asterisk -rx 'sip show peers' | grep --text -i '$1' | grep OK >/dev/null; if [ $? -eq 0 ]; then echo 1; else echo 0; fi

*Añadir en el portal de zabbix un item por cada trunk. En el campo Key se pondrá "asterisk.trunkEstado[nombre_trunk]", donde nombre_trunk es el nombre del trunk tal y como se ve en Asterisk.
[[File:zabbix_item_trunkEstado.png]]

*Crear un trigger que avise cuando el último valor sea 0. Por ejemplo:
{corp-bdtr:asterisk.trunkEstado[PrePro-ACD].last()}=0

[[File:zabbix_trigger_trunkEstado.png]]

== Agendas en terminales Yealink ==
En la agenda se mostrará como nombre lo que contenga el campo CEN_AGENDAS.C_NOMBRE_MOSTRAR y como teléfono el indicado en CEN_AGENDAS_TELEFONOS.C_TELEFONO
Para hacer funcionar la agenda:

*En el archivo de aprovisionamiento correspondiente (Yealink-XXXX-comun.cfg) establecer los siguientes parámetros:

remote_phonebook.data.1.url = http://<direc IP>/vivait-agenda/yealink/contactData1.xml
remote_phonebook.data.1.name = NOMBRE DE LA AGENDA EN EL TELEFONO

*En el archivo /etc/apache2/apache2.conf añadir tras el último Directory:

<Directory /var/www/html/vivait-agenda/>
AddType application/x-httpd-php .xml
Options Indexes FollowSymLinks MultiViews
AllowOverride None
Order allow,deny
allow from all
</Directory>

*Ejecutar el comando:

/etc/init.d/apache2 reload

== Calendarios ==

=== Enrutamiento inteligente ===

Ante una llamada a un destino, si hay cita de ocupado en el calendario se desvia al número indicado en el campo "location" del calendario o a su buzon de voz si hay valor en dicho campo

same => n,Set(CalendarBusy=${CALENDAR_BUSY(GoogleCalendar)})
same => n,Set(id=${CALENDAR_QUERY(GoogleCalendar)})
same => n,NoOP(hay ${CALENDAR_QUERY_RESULT(${id},getnum)} eventos)
same => n,Verbose(3,The state of GoogleCalendar is $
{DEVICE_STATE(Calendar:GoogleCalendar)})
same => n,Set(CalendarLocation=${CALENDAR_QUERY_RESULT(GoogleCalendar,location)})
same => n,GotoIf($["${CalendarBusy}"=="1"]?:conCategoria)
same => n,GotoIf($["${CalendarLocation}"==""]?buzon)
same => n,Goto(Cen_iniLlam,${CalendarLocation},1)
same => n(buzon),Playback(Particular/buzon)
same => n,Hangup
same=> n(conCategoria),Goto(Cen_iniLlam,${EXTEN},1)

=== Conexión de cliente Outlook a calendarios VIVAit mediante Caldav===
Por defecto, el cliente outlook no soporta Caldav; si queremos disponer de calendarios de VIVAit en Outlook tendríamos dos opciones:
# Tener los calendarios en el servidor Exchange
# Instalar un plugin en el cliente outlook que permita conectar vía Caldav los calendarios que estén ubicados en el servidor de calendarios de VIVAit

Este howto se centra en esta segunda posibilidad

Procedimiento:

1.- Instalar Calldavsincronizer (valdrían otros plugin de Caldav para Outlook)

[https://sourceforge.net/projects/outlookcaldavsynchronizer/ https://sourceforge.net/projects/outlookcaldavsynchronizer/]

2.- Entrar en Synchronization Profiles en la nueva pestaña Calldav Syncronizer de outlook [[File:Syncronizer.png]]

3.- Añadir nuevo perfil (tecla +)

[[File:Nuevo.png|center|600px]]

A tener en cuenta:

*Crear un nuevo “Outlook folder”, entendemos que es adecuado (quizás necesario) para que las entradas de calendario de VIVAit queden diferenciadas.
*Lo mejor es haber creado antes el calendario en el servidor para que al darlo de alta en oulook comprobemos que se conecta.
*Dando al botón “Test or discover settings” se nos muestran todos los calendarios del servidor y elegimos el que queramos; en “elementos de la carpeta” diremos “elementos de calendario”.

[[File:Calendario.png|center|800px]]

== Uso de reloj hardware en nodos de procesamiento ==

=== En nodo de procesamiento ACD ===
En un nodo de procesamiento ACD es obligatorio instalar dahdi y una tarjeta de primario para emplear reloj hardware, ya que el reloj software que va en el asterisk 1.4 es defectuoso.
Para configurarlo basta con instalar la tarjeta en el servidor, instalar dahdi y posteriormente ejecutar el siguiente comando:

dahdi_cfg

Este comando generaŕa el fichero /etc/dahdi/system.conf

Para comprobar que el comando se ha ejecutado satisfactoriamente lo abriremos y tendrá que tener un formato semejante al siguiente ejemplo:

# Autogenerated by /usr/sbin/dahdi_genconf on Tue Oct 22 17:42:59 2013
# If you edit this file and execute /usr/sbin/dahdi_genconf again,
# your manual changes will be LOST.
# Dahdi Configuration File
#
# This file is parsed by the Dahdi Configurator, dahdi_cfg
#
# Span 1: WCT1/0 "Digium Wildcard TE110P T1/E1 Card 0" HDB3/CCS/CRC4
span=1,1,0,ccs,hdb3,crc4
# termtype: te
bchan=1-15,17-31
dchan=16
echocanceller=oslec,1-15,17-31
# Global data
loadzone = es
defaultzone = es

=== En nodo de procesamiento de corporativa ===
En un nodo de procesamiento de corporativa no obligatorio instalar dahdi y una tarjeta de primario para emplear reloj hardware, ya que el no se han detectado errores en el reloj por software. Sin embargo si instalamos dahdi y una tarjeta de primario para emplear reloj hardware, el sistema funcionará mejor.
Para configurarlo basta con instalar la tarjeta en el servidor, instalar dahdi y posteriormente ejecutar el siguiente comando:

dahdi_cfg

Este comando generaŕa el fichero /etc/dahdi/system.conf

Para comprobar que el comando se ha ejecutado satisfactoriamente lo abriremos y tendrá que tener un formato semejante al siguiente ejemplo:

# Autogenerated by /usr/sbin/dahdi_genconf on Tue Oct 22 17:42:59 2013
# If you edit this file and execute /usr/sbin/dahdi_genconf again,
# your manual changes will be LOST.
# Dahdi Configuration File
#
# This file is parsed by the Dahdi Configurator, dahdi_cfg
#
# Span 1: WCT1/0 "Digium Wildcard TE110P T1/E1 Card 0" HDB3/CCS/CRC4
span=1,1,0,ccs,hdb3,crc4
# termtype: te
bchan=1-15,17-31
dchan=16
echocanceller=oslec,1-15,17-31
# Global data
loadzone = es
defaultzone = es

== Aprovisionamiento terminales Cisco ==
=== Configurar protocolo SIP TCP o UDP en terminal Cisco ===

Configuración de terminal Cisco para para funcionar bajo TCP o UDP:
Modificar parámetro
<transportLayerProtocol>X</transportLayerProtocol>

Donde X es:
1: TCP
2: UDP
4: Valor por defecto del firmware (al menos en la última versión equivale a TCP)

=== Habilitar/Deshabilitar llamada en espera en terminales Cisco ===

En el fichero de aprovisionamiento del terminal añadiremos la siguiente linea
<callWaiting>X</callWaiting>

Donde X es:
0=off but can be changed through the settings menu.
1=on but can be changed through the settings menu.
2=off and locked so it can't be changed through the settings menu.
3=on and locked so it can't be changed through the settings menu.

== Como configurar servicio DHCP en Ubuntu Linux ==
=== ¿Que es un servicio DHCP? ===
Un servidor Dynamic Host Configuration Protocol (DHCP) asigna dinámicamente las direcciones IP y otras configuraciones de red a otros terminales que están conectados a la red.

=== Instalar un servicio DHCP ===
Para instalar el servidor de asignacion automatica de direccion IP ejecutamos el comando:
sudo apt-get install isc-dhcp-server

=== Configurando el servicio DHCP ===
Editamos el archivo /etc/dhcp/dhcpd.conf creando primero un backup del mismo:
mv /etc/dhcp/dhcpd.conf /etc/dhcp/dhcpd.conf.original
nano /etc/dhcp/dhcpd.conf

El archivo debe quedar de una forma muy similar a esta:
authoritative
subnet 10.254.239.0 netmask 255.255.255.254
{
range dynamic-bootp 10.254.239.40 10.254.239.60;
option domain-name-servers ns1.example.org, ns2.example.org;
option domain-name "example.org";
option routers rtr-239-0-1.example.org, rtr-239-0-2.example.org ;
option broadcast-address 10.254.239.255;
default-lease-time 3600;
max-lease-time 7200;
option option-150 10.254.239.25
}

Donde los campos:
*subnet: Direccion de red
*netmask: Máscara de red
*range dynamic-bootp: Rango de IPs que va a proporcionar el DHCP
*option domain-name-servers: Direcciones IPs de los DNS
*option domain-name: Nombre de dominio
*option routers:IPs de las puertas de enlace
*option broadcast-address: Dirección de broadcast
*default-lease-time: Tiempo de concesión por defecto
*max-lease-time: Valor máximo del tiempo de concesión
*option option-150: IPs de los servidores TFTPs que tiene la red

=== Reiniciamos el servicio ===
service isc-dhcp-server restart

=== Direcciones IP estáticas basadas en la MAC ===
Pueden conocerse las MAC de las máquinas conectadas a la red ejecutando el comando arp desde la terminal.

host ejemplo {
hardware ethernet 00:0B:82:19:A8:04;
option option-150 10.254.239.0;
# fixed-address 10.254.239.52;
}

== Protocolo Skinny en VIVAit Call mediante uso de Chan-SCCP ==
=== Instalación de chan_sccp ===
*Copiar el fichero chan-sccp-4.2.1.1.tar.gz en el directorio donde estén los fuentes de Asterisk (normalmente /usr/src/MDtel)
*Descomprimir
*Entrar al directorio chan-sccp-4.2.1.1
*Ejecutar: ./configure --with-asterisk=../DIRECTORIO_ASTERISK --enable-conference. Donde DIRECTORIO_ASTERISK es el nombre del directorio donde están los fuentes de asterisk.
*Tras el ejecutar el configure (si todo va bien al final se verá un resumen con el S.O, arquitectura, etc), ejecutar make y make install
*El nuevo módulo chan_sccp.so se generará dentro del DIRECTORIO_ASTERISK en lib/asterisk/modules/ y se deberá copiar en /usr/lib/asterisk/modules/
*Copiar el fichero sccp.conf a /etc/asterisk
*Entra a Asterisk y ejecutar: module load chan_sccp.so
*Si se ha cargado correctamente, desde dentro de Asterisk, si se teclea sccp show version deberá devolver: "Skinny Client Control Protocol (SCCP). Release: 4.3.0 4.3.0 - unknown (built by 'root' on '2016-06-01 10:42:32 UTC')"

=== Crear extensiones ===
*En el portal crear una nueva clase de dispositivo (Vivait-Call/Dispositivos/Clases de dispositivos), donde la clase sea extensión la subclase H323 (todavía no existe la subclase SCCP) y el formato SCCP/${DEST}
*Crear la nueva extensión, pero el dispositivo debe ser el creado en el campo anterior.
*Las extensiones creadas habrá que añadirlas al fichero sccp.conf así como los teléfonos que las usarán. En el fichero sccp.conf incluido hay ejemplos.

=== Aprovisionamiento ===
Los terminales se aprovisionan de la misma manera que los SIP, exceptuando que las plantillas XML no tiene referencias a SIP. Se incluye un xml genérico con todas las opciones.
Dentro del directorio chan-sccp-4.2.1.1 hay un directorio conf con todos los archivos de configuración necesarios. Las versiones annotated contienen todas las opciones posibles comentadas.

== Instalación y configuración Postfix en RedHat7 ==

'''Postfix''' es un ''servidor de correo'' de software libre/código abierto, un programa informático para el enrutamiento y envío de correo electrónico.

=== Instalación ===
yum install postfix

=== Configuración ===
Sobre la configuración de postfix por defecto (recién instalado):
Editar el fichero /etc/postfix/main.cf
inet_protocols = ipv4
relayhost = smtp.renfe.es
Revisar la configuración:
postfix check
Configurar postfix como servicio (sólo en redhat y similares)
chkconfig postfix on
Iniciar postfix:
service postfix start
Instalar mailx para disponer de los comandos mail y sendmail:
yum install mailx
Probar configuración:
echo "Prueba de correo" | mail -vs "Prueba" correo@destino.soy

== Como crear un TRIGGER en Zabbix ==

'''1.''' Hay '''dos posibilidades''' dependiendo si el trigger es para un solo host o es para varios, los cuales tienen en común un template:

:# Si es para ''un host'': Ir a '''Configuración/Hosts'''
:# Si es para ''un template'': Ir a '''Configuración/Templates'''

'''2.''' En la fila correspondiente al host/template al que queramos añadirle el trigger, pulsar sobre la '''columna triggers.''' 
'''3.''' En la ventana de triggers, pulsar sobre el botón '''Create trigger''', situado en la esquina superior derecha. 
'''4.''' Aparecerá la ventana de creación de triggers, que tiene los siguientes campos:
:1. '''Name:''' Nombre del trigger, que deberá ser lo ''suficientemente descriptivo''. Aparecerá cuando se
active, en la ventana principal de Zabbix así como en los correos de aviso.
:2. '''Expression:''' Define la fórmula cuyo resultado activará el trigger. Hay que pulsar el botón '''Add'''. Se mostrará una
nueva ventana donde habrá que elegir el item (medida) sobre el que se basará el trigger (evidentemente la medida deberá
existir previamente) y la función necesaria para el cálculo. Para una descripción de las disponibles dirigirse a
https://www.zabbix.com/documentation/2.2/manual/appendix/triggers/functions. 
Tras rellenar los campos anteriores y dar a la función los valores que necesite pulsar el botón '''Insert.'''
:3. '''Expression constructor:''' Permite crear expresiones complejas, uniendo varias.
:4. '''Description:''' Una explicación del trigger
:5. '''Severity:''' Criticidad el trigger
:6. Para una descripción del resto de campos visitar la página: https://www.zabbix.com/documentation/2.2/manual/config/triggers/trigger
'''5.''' Tras rellenar los campos, pulsar el botón '''Save'''. 
'''6.''' Si el trigger se ha añadido en un template, aparecerá en todos los hosts que tienen el template configurado. 
'''7.''' '''El trigger por si solo no envía ningún aviso''', solo se activa si se cumple la expresión definida.
Para enviar un aviso (normalmente un correo electrónico) cuando se active el trigger, será necesario definir una acción (Configuración/Actions).

'''NOTA.-''' Para consultar cualquier cuestión relativa a Zabbix, se encuentra a su disposición el manual: 
https://www.zabbix.com/documentation/2.2/manual

== Como mostrar callername queues FOP2 ==

Es necesario añadir el siguiente código al contexto de entrada:

exten => _X.,n,MYSQL(Connect connid localhost usuario clave bd)
exten => _X.,n,MYSQL(Query resultid ${connid} SELECT\ firstname\,lastname\ from\ fop2\ where\ phone1=${CALLERID(num)}\ OR\ phone2=${CALLERID(num)})
exten => _X.,n,MYSQL(Fetch fetchid ${resultid} nombre apellidos)
exten => _X.,n,GotoIf($[${fetchid} = 1]?:noExiste)
exten => _X.,n,Set(CALLERID(name)=${nombre}${apellidos})
exten => _X.,n(noExiste),Continuar

En la primera línea cambiar según lo necesario:

*localhost: Dirección IP del servidor de MySQL donde está la BBDD de FOP2
*usuario: Usuario con permisos de acceso a la bbdd de FOP2
*clave: Clave del usuario
*bd: Nombre de la BBDD

== Como ver los directorios de un NAS a montar con NFS ==

Con el siguiente comando vemos los diferentes volúmenes de un NAS:

showmount -e IP_NAS

Ejemplo de salida:

Export list for 192.168.10.10:
/Backup/backup *
/DISCOS_1/VOL1_AUDIO *

== Instalación de ActivaSTP con VIVAit Call 3 y marcación desde Outlook ==

Instalamos ActivaSTP desde:

(http://activa.sourceforge.net/)



La configuración necesaria se muestra en la siguiente imagen:

[[File:Ventana ActivaTSP.jpg]]

El usuario del manager debe tener permisos originate para poder realizar llamadas.

Se han realizado pruebas con Outlook 2013.

Se ha comprobado la correcta realización de pruebas utilizando ActivaSTP, realizadon llamadas desde la pestaña "personas" con la vista en modo tarjeta de Pesentación, tarjeta, teléfono o lista.

Outlook 2013 no da la opción de llamar si la vista está en modo personas.

== Como volver a procesar grabaciones con error ==

Las grabaciones con error son aquellas que tienen el valor E_GRABACION=120 en la tabla DAT_GRABACIONES.

Las grabaciones con error se produce normalmente a perdida de conexión entre el nodo servidor de grabaciones y el resto.

Para reprocesar la grabación hay que modificar el campo E_GRABACION de la tabla DAT_GRABACIONES y ponerlo con valor 20 para que así el recordCentral la vuelva a procesar.

== FOP2. Problemas en transferencias asistidas ==

Para habilitar la transferencia atendida del asterisk (funcion atxfer), hay que poner la opción tT en el queue() si la llamada origen la realiza a una cola o
al dial() de las extensiones.
Con eso vemos como al intentar hacer la llamada de consulta ya se va a nuestro dialplan. Sin embargo la llamada no funciona ya que el enrutador nos da error de
enrutamiento porque no tenemos ID_DISPOSITIVO origen ya que el fop no es un elemento creado desde el portal.
Por lo que se propone como solución crear un contexto de inicio del fop y asignarle un ID_DISPOSITIVO para que así se enrute la llamada. El contexto tienen que
ser similar a ext_InicioLlamada_Chrome.conf

Para que funcione las transferencias supervisadas desde el fop2 hay que realizar lo siguiente:

*El usuario del manager debe tener permisos Atxfer para poder realizar transferencias.
*Habilitar la transferencia atxfer en el fuatures.conf del asterisk. atxfer => *2
*Crear el fichero ext_InicioLlamada_FOP.conf con el siguiente contenido:

[Cen_Inicio_FOP]
exten => [*#%0-9].,1,NoOp(MDINICHR**EXTEN=${EXTEN}**CID=${CHROME_ANI}*)
same => n,dumpchan()
;same => n,Set(CALLERID=${CHROME_ANI})
same => n,Gosub(Cen_Sub_getIdExtension,s,1(${R_CID_NUM_00}))
same => n,ExecIf($["${GOSUB_RETVAL}"!="OK" | "${sqlDato}"=""]?HangUp)
same => n,Set(ID_DISPOSITIVO=${sqlDato})
; . Modificar MARCAR en funcion de reglas de marcacion saliente (prefijo 0, ...)
; Esto se modificara en el contexto Cen_Inicio_Chrome_Particular
same => n,Set(MARCAR=${EXTEN})
;---------------------------------

;--- Llamada a contexto particular
;---------------------------------
; Esta llamada es para hacer cosas especcificas del cliente (cambiar callerid...)
; La subrutina Cen_Inicio_Chrome_Particular esta en el archivo ext_InicioLlamada_Chrome_Particular.conf
; Si no existe el archivo copiar el archivo ext_InicioLlamada_Chrome_Particular.conf.ejemplo como ext_Inicio_Chrome_Particular.conf
; y realizar las modificaciones necesarias
; El fichero ext_InicioLlamada_Chrome_Particular.conf se carga automaticamente al ser creado con el include de ext_InicioLlamada.conf
; #include "ext_InicioLlamada*.conf"
;
same => n,GosubIf($[${DIALPLAN_EXISTS(Cen_Inicio_FOP_Particular,${EXTEN},1)}>0]?Cen_Inicio_FOP_Particular,${EXTEN},1)
same => n,Goto(Cen_Inicio_SIP,${MARCAR},1)

*En el fichero /usr/local/fop2/buttons.cfg poner como contexto de las extensiones el creado anteriormente (Cen_Inicio_FOP)
*Modificar el fichero /usr/local/fop2/fop2.cfg:

blind_transfer = 0
supervised_transfer = 1

Para realizar la transferencia con consulta, hay que pulsar el supervised transfer del FOP2 y una vez se haya establecido la llamada, seleccionar la extensión que "sobra" en la conversación y pulsar la tecla de hangup y colgar la llamada.



== Como borrar contenido de la tabla BDTR con el script borraRegistrosNimitz.pl ==

Este script se ejecuta mediante una tarea del crontab, tal como la siguiente:

SHELL=/bin/sh
PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
# m h dom mon dow user command
00 01 * * * root /usr/local/sbin/borraRegistrosNimitz.pl --hDB localhost

Para establecer el número de días que vamos a dejar en la base de datos debemos editar el archivo borraRegistrosNimitz.pl, el campo my $numDias.

Howto's

2017-07-26T06:59:30Z

Imatarrubias: /* Como borrar contenido de la tabla BDTR con el script borraRegistrosNimitz.pl */

{| class="wikitable"
|-
! '''Producto: '''!! VIVAit Call
VIVAit Suite

VIVAit Fax
|-
|}

== Como parar asterisk ==
En situaciones límite en el que es necesario parar el asterisk y volver a arrancarlo hay que realizar los siguientes pasos:

Entrar en la consola de asterisk e introducir el comando core stop now

Si esto no funciona, tendremos que matar el proceso a mano. Esto es, primero el safe asterisk y luego el asterisk mediante el comando
kill -9 nºPID

Tras estos pasos, volveremos a arrancar el servicio asterisk mediante /etc/init.d/asterisk start

== Como configurar la megafonía ==

El servicio de megafonía se basa en el protocolo multicast.

Para configurar la megafonía tenemos que activar en los teléfonos que para que estén "escuchando" en una dirección multicast y tener un emisor en esa dirección multicast.

Los teléfonos suelen tener en su configuración un apartado para configurar el multicast. Por ejemplo en los yealink está en la pestaña directory sección multicast IP.

En los teléfonos se puede configurar manualmente o incluirlo en las plantillas de aprovisionamiento.

El asterisk tiene un canal para hacer multicast. Este canal es MulticastRTP.

Para esto podemos crear un VDN que contenga la siguiente línea. (en el ejemplo la dirección multicast es 239.0.126.1 y el puerto es el 10001).

[Cen_VDN_90000]
exten => _X.,1,NoOp(MDVDN_90000*****EXTEN=${EXTEN}**CID=${CALLERID(NUM)}**UCID=${UCID}*)
same => n,Answer
same => n,Dial(MulticastRTP/basic/239.0.126.1:10001)
include => Cen_finLlamada

== Como configurar el candado ==
El candado permite prohibir temporalmente la posibilidad de realizar llamadas hacia fuera. Sí se pueden seguir haciendo llamadas a extensiones fijas de la plataforma, es decir, llamadas sin coste.

Para configurar dicha funcionalidad basta con crear extensiones con la categoría mas restrictiva posible y habilitar la movilidad, con lo que la extensión solo tendrá "permisos" para realizar llamadas internas.

Para permitir llamadas externas solo hay que "mover" a un usuario con categoría suficiente a la extensión deseada.
== Como crear un grupo de captura y que se vea en cada teléfono el número que llama ==

'''ATENCIÓN: SE CREAN CONFIGURACIONES NO REFLEJADAS EN PORTAL DE ADMINISTRACIÓN'''

Para la simulación de grupos de captura y conseguir que todos los terminales vean el ANI del llamante:

- Hacen falta teléfonos con dos líneas

- Cada teléfono del grupo tiene en la línea 1 su extensión habitual (por ejemplo 40000)

- Además, en el fichero "sip_Estatico.conf", creamos una segunda extensión para cada teléfono, que le ocupará la segunda línea (por ejemplo 42000)

- En esta segunda linea ponemos que cuando se llame tenga otro tono de llamada (un beep o nada...) que se asemeje en funcionamiento al de un mensaje de llamada en otra extension de mi grupo de captura

- Se ha creado una variable global por cada teléfono en el fichero de variables "ext_MDtel_Particular.conf" de nombre EXTxxxxx (por ejemplo EXT40000); esa variable contiene las otras extensiones virtuales del grupo
por ejemplo EXT40000=>SIP/42001&SIP/42005

- Hemos creado en el dialplan programación para que cuando exista esa variable global se añada a la marcación el contenido

== Como crear supletorios ==

'''ATENCIÓN: SE CREAN CONFIGURACIONES NO REFLEJADAS EN PORTAL DE ADMINISTRACIÓN'''

Igual que el caso anterior pero en la variable ponemos números reales. Debido a un bug en el enrutador, que no devuelve la variable R_PARA, en el fichero ext_MARCAR_Extension.conf hay que sustituir la siguiente linea:

;same => n,ExecIf($["${EXT${R_PARA}}"=""]?NoOp:Set(ENR_CADMARCAR=${ENR_CADMARCAR}&${EXT${R_PARA}}))
Por esta otra:
same => n,ExecIf($["${EXT${R_DEST_${ENR_RUTA_CAD}}}"=""]?NoOp:Set(ENR_CADMARCAR=${ENR_CADMARCAR}&${EXT${R_DEST_${ENR_RUTA_CAD}}}))
ATENCIÓN !!! en las llamadas salientes cada uno presenta su número

Para emplear números externos en los supletorios hay que poner, al crear la variable que hemos explicado en el apartado anterior en el ext_MDtel_Particular.conf:

EXT335=>SIP/0999999999@Trunk_Movil ;En este caso suena en la ext 335 y en el móvil 999999999

== Generación de llamada automática ==

Para activar la funcionalidad es necesario lo siguiente:

* Definir una variable ID_LISTA_LLAMAME con el ID de la lista que se va a usar para generar la llamada. Cuando se cree la lista hay que asegurarse que el campo "Nº segundos límite" tiene un valor lo suficientemente amplio para evitar que la llamada caduque antes de ejecutarse.

* Establecer un timeout para la cola (en el Gosub Cen_Sub_GrupoACD se indica justo después de ${COLA})

* Llamar a la función de MySQL ACD_FUNC_LLAMAME_CREAR a través de MDintz

* En la función se usan los siguientes elementos variables:

${ID_LISTA_LLAMAME}: Definida antes clienteTOCola:
Nombre del cliente. Al no tener ningún nombre, se usa un denominador genérico
${CALLERID}: Número llamante, donde se dirigirá la llamada.

Ejemplo:

[Cen_VDN_99001]
;----------------------------------------------------------------------------------------------------------------
;----------------------- VDN 99001 ------------------------------------------------------------
;----------------------------------------------------------------------------------------------------------------
exten => _X.,1,NoOp(MDENTGW_99001*****EXTEN=${EXTEN}**CID=${CALLERID(NUM)}**UCID=${UCID}*)
same => n,Set(__COLA=89001)
same => n,Set(ctiDiriTrato=0)
same => n,Set(ctiDiriInterface=)
same => n,Set(ID_LISTA_LLAMAME=2)
same => n(cola),Gosub(Cen_Sub_GrupoACD,${EXTEN},1(${COLA},10,,Si,))
same => n,GotoIf($["${QUEUESTATUS}"!="TIMEOUT"]?colgar)
same => n,MDintz(nimitz|bd|sqlDato|select ACD_FUNC_LLAMAME_CREAR(CURRENT_TIMESTAMP\,${ID_LISTA_LLAMAME}\,""\,"clienteTOCola"\,""\,""\,""\,""\,""\,""\,""\,""\,1\,""\,"${CALLERID(NUM)}"\,1\,3\,1\,""\,0\,0\,0\,""\,""\,""\,""))
same => n,GotoIf($["${MDintzRes}"="OK"]?colgar)
same => n,NoOp(ACD_FUNC_LLAMAME_CREAR ${MDintzRes})
same => n(colgar),Hangup

== Cancelación de eco en la plataforma ==

Comprobar que el chan_dahdi.conf este configurado los parametros:
echocancel=yes
echocancelwhenbridged=yes
Jugar con los valores txgain y rxgain

Si esto no es suficiente el siguiente paso sería emplear una canceladora de echo por hardware.

== Como "dar paso" a través de un enlace exterior si hay una llamada para una extensión creada en el sistema pero no registrada ==

Este procedimiento es de utilidad en procesos de migración, en los que recibimos las llamadas de la RTC, nos las quedamos si la extensión ya está registrada en VIVAit y la mandamos hacia la plataforma a migrar si aún sigue migrada ahí

El procedimiento es:
* Activar desvío por no contesta en la extensión (portal de administración - VIVAit Call - Dispositivos - Extensiones - campo "Desvio no contesta", indicando como destino un prefijo (por ejemplo "99") seguido de la extensión destino

* Creamos una preruta en vivait-call - rutas -prerutas con origen "99", le quitamos el prefijo en campo "Destino saliente 1" (valor -2) e indicamos en campo "Tipo destino sal. 1" como "Ruta externa"

* Debera existir una ruta externa para esa numeración

== Comprobación de versiones de elementos de la plataforma ==

'''Aplicaciones'''
:* Botón derecho del ratón, Acerca De

'''Portales'''
:* En el Vivait-Call, en la pantalla de inicio de sesión pone el número de versión del portal.
:* Tanto en el Monitor como en el Tracker no se puede saber.

'''Demonios'''
:* Mediante el comando nc localhost <Puerto demonio>. Ejemplo:
::nc localhost 1120
::motorSal sis ver='03.02.00' inic='20150427 123457' alarmas=0 ultAlar='00000000000000'
::motorSal gmp msj=253/256 buf=256/256 tarea=99/102
::motorSal tmp uptime=12624 (0d 3h 30m 24s)
::motorSal mtr mys=1 ocup=0% planif=13(0) intento=11(0)

::Ejemplos puertos demonios:
:::*1111: vivait-cti
:::*1112: myAcdSuperv
:::*1113: recordNodo
:::*1114: recordCentral
:::*1115: intz-nimitz
:::*1120: motorSal
:::*1123: phoneprov-tftp

'''Base de datos'''
:* No se puede saber la versión a no ser que se comparen esquemáticos con los subidos en el redmine

[[Category:tecnico]]
[[Category:administrador]]
[[Category:VIVAit Call]]
[[Category:VIVAit Suite]]
[[Category:VIVAit Fax]]

== Añadir Auto-Answer a la cabecera SIP ==

Si queremos que un teléfono tenga autoanswer:
* En el peer poner: headeraa=Call-Info: answer-after=0, esto tiene que ir en la plantilla de la extensión o como campo en la extensión. Dependiendo del terminal que utilicemos el valor de este campo variará:

Aastra: Alert-Info: info=alert-autoanswer
Grandstream: Call-Info: answer-after=0
Linksys: Call-Info:\;Answer-After=0
Polycom: Alert-Info: Ring Answer
Snom: Call-Info: answer-after=0
Snom (nuevo firmware): Call-Info: <sip:IP>\;answer-after=0
Yealink: Call-Info: answer-after=0

* Luego en el diaplan añadir lo siguiente: exten => _[*#%0-9a-zA-Z].,n,set(__AutoAnswer=AA) (Esto tendremos que ver como ponerlo de manera automática). De manera provisional si queremos que sea para llamadas salientes pondremos esto en el ext_n_marcador.conf. Si queremos que sea llamadas entrantes lo pondremos en ext_n_MARCAR.conf

== Configuración de los portales web en HTTPS ==

Desde /usr/lib/jvm/default-java/bin/ ejecutamos:

keytool -genkey -alias tomcat -keyalg RSA -keystore /usr/share/tomcat7/.keystore

Escriba la contraseña del almacén de claves: (t0mc4t)
Volver a escribir la contraseña nueva: (t0mc4t)
*Personalizar para el cliente
¿Cuáles son su nombre y su apellido?
[Unknown]: VIVAit Suite
¿Cuál es el nombre de su unidad de organización?
[Unknown]: Desarrollo
¿Cuál es el nombre de su organización?
[Unknown]: MDtel
¿Cuál es el nombre de su ciudad o localidad?
[Unknown]: Madrid
¿Cuál es el nombre de su estado o provincia?
[Unknown]: Madrid
¿Cuál es el código de país de dos letras de la unidad?
[Unknown]: es
¿Es correcto CN=VIVAit Suite, OU=Desarrollo, O=MDtel, L=es, ST=Madrid,
C=Unknown?
[no]: si
Escriba la contraseña clave para <tomcat>
(INTRO si es la misma contraseña que la del almacén de claves)

nano /var/lib/tomcat7/conf/server.xml

Descomentar la línea:

<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"

maxThreads="150" scheme="https" secure="true"

clientAuth="false" sslProtocol="TLS"/>

Añadir después de sslProtocol="TLS":

keystorePass="t0mc4t"

== Crear un motivo desconexión para el Supervisor en '''''VIVA'''''it Suite==

Para crear motivos de desconexión adicionales a los que ya ofrece la aplicación tendremos que añadir una nueva entrada en la BD. El comando que emplearíamos seria el siguiente:

INSERT INTO `nimitz`.`COM_ENUMERADOS` (`ID`, `C_NOMBRE`, `C_TEXTO`, `N_POSICION`, `C_OBSERV`) VALUES(1000700, 'TSesAgMotDesc', 'Nombre Motivo de desconexión', 60, ' ');

El ID debe ser mayor o igual a 1000700 y menor a 1000800. El N_POSICION debe ser mayor o igual a 60 y menor que 100.

== Envío de variables CTI al ACD ante un GW con asterisk 13==
Dado que para un GW con asterisk 13 un nodo ACD es considerado un elemento externo, por defecto, no se envían variables CTI (UCID, ...). En una fututa versión del nodo ACD, ya no se considerará un elemento externo por lo que si se enviarán dichas variables. Para lograrlo en la versión 3.0 de la plataforma Vivait hay que modificar el fichero ext_MARCAR_Externo_Particular.conf del GW. Deberemos poner la siguiente linea.

same => n,Macro(escribirDatosCti)

== Script para cambio automático de claves en salas de conferencia estáticas ==

Para cambiar la clave de las salas de conferencias crear un script llamado cambioClaveConfe.sh con el siguiente contenido:

#!/bin/bash
CLAVE=$(shuf -i 1111-9999 -n 1)

echo $CLAVE

echo "update CEN_SALAS_CONFERENCIAS set C_PIN='$CLAVE' WHERE C_NOMBRE='$1'" | mysql -u nimitz -pivivanimitz nimitz

FROM=sat@mdtel.es
FECHA=`date +"%Y%m%d%H%M%S"`
CLIENTE=<PONER EL CLIENTE>
TO=<DESTINATARIOS>
ASUNTO="Nueva clave en sala $1"
CUERPO="La nueva clave para la sala $1 es: $CLAVE"
/usr/sbin/sendmail -oi -t -v -f $FROM <<EOF
From: $FROM
To: $TO
Bcc: $BCC
Subject: $ASUNTO

$CUERPO
EOF

El script cambiará la clave de la sala pasada por parámetro por una aleatoria de 4 dígitos y la enviará por correo a los <DESTINATARIOS> (direcciones de correo electrónico separadas por coma).

Hay que crear una tarea en /etc/crontab añadiendo una linea como la siguiente:
30 6 * * 7 root cambioClaveConfe.sh 6173

Esto ejecutará el script todos los domingos a las 6:30 horas cambiando la clave de la sala 6173. Añadir tantas linéas como salas.

== Monitorización en Zabbix de un trunk caído ==
Para monitorizar un o varios trunk por separado y saber el estado de cada uno es necesario lo siguiente:

*Añadir el UserParameter adjunto que contiene el siguiente texto:

UserParameter=asterisk.trunkEstado[*],sudo /usr/sbin/asterisk -rx 'sip show peers' | grep --text -i '$1' | grep OK >/dev/null; if [ $? -eq 0 ]; then echo 1; else echo 0; fi

*Añadir en el portal de zabbix un item por cada trunk. En el campo Key se pondrá "asterisk.trunkEstado[nombre_trunk]", donde nombre_trunk es el nombre del trunk tal y como se ve en Asterisk.
[[File:zabbix_item_trunkEstado.png]]

*Crear un trigger que avise cuando el último valor sea 0. Por ejemplo:
{corp-bdtr:asterisk.trunkEstado[PrePro-ACD].last()}=0

[[File:zabbix_trigger_trunkEstado.png]]

== Agendas en terminales Yealink ==
En la agenda se mostrará como nombre lo que contenga el campo CEN_AGENDAS.C_NOMBRE_MOSTRAR y como teléfono el indicado en CEN_AGENDAS_TELEFONOS.C_TELEFONO
Para hacer funcionar la agenda:

*En el archivo de aprovisionamiento correspondiente (Yealink-XXXX-comun.cfg) establecer los siguientes parámetros:

remote_phonebook.data.1.url = http://<direc IP>/vivait-agenda/yealink/contactData1.xml
remote_phonebook.data.1.name = NOMBRE DE LA AGENDA EN EL TELEFONO

*En el archivo /etc/apache2/apache2.conf añadir tras el último Directory:

<Directory /var/www/html/vivait-agenda/>
AddType application/x-httpd-php .xml
Options Indexes FollowSymLinks MultiViews
AllowOverride None
Order allow,deny
allow from all
</Directory>

*Ejecutar el comando:

/etc/init.d/apache2 reload

== Calendarios ==

=== Enrutamiento inteligente ===

Ante una llamada a un destino, si hay cita de ocupado en el calendario se desvia al número indicado en el campo "location" del calendario o a su buzon de voz si hay valor en dicho campo

same => n,Set(CalendarBusy=${CALENDAR_BUSY(GoogleCalendar)})
same => n,Set(id=${CALENDAR_QUERY(GoogleCalendar)})
same => n,NoOP(hay ${CALENDAR_QUERY_RESULT(${id},getnum)} eventos)
same => n,Verbose(3,The state of GoogleCalendar is $
{DEVICE_STATE(Calendar:GoogleCalendar)})
same => n,Set(CalendarLocation=${CALENDAR_QUERY_RESULT(GoogleCalendar,location)})
same => n,GotoIf($["${CalendarBusy}"=="1"]?:conCategoria)
same => n,GotoIf($["${CalendarLocation}"==""]?buzon)
same => n,Goto(Cen_iniLlam,${CalendarLocation},1)
same => n(buzon),Playback(Particular/buzon)
same => n,Hangup
same=> n(conCategoria),Goto(Cen_iniLlam,${EXTEN},1)

=== Conexión de cliente Outlook a calendarios VIVAit mediante Caldav===
Por defecto, el cliente outlook no soporta Caldav; si queremos disponer de calendarios de VIVAit en Outlook tendríamos dos opciones:
# Tener los calendarios en el servidor Exchange
# Instalar un plugin en el cliente outlook que permita conectar vía Caldav los calendarios que estén ubicados en el servidor de calendarios de VIVAit

Este howto se centra en esta segunda posibilidad

Procedimiento:

1.- Instalar Calldavsincronizer (valdrían otros plugin de Caldav para Outlook)

[https://sourceforge.net/projects/outlookcaldavsynchronizer/ https://sourceforge.net/projects/outlookcaldavsynchronizer/]

2.- Entrar en Synchronization Profiles en la nueva pestaña Calldav Syncronizer de outlook [[File:Syncronizer.png]]

3.- Añadir nuevo perfil (tecla +)

[[File:Nuevo.png|center|600px]]

A tener en cuenta:

*Crear un nuevo “Outlook folder”, entendemos que es adecuado (quizás necesario) para que las entradas de calendario de VIVAit queden diferenciadas.
*Lo mejor es haber creado antes el calendario en el servidor para que al darlo de alta en oulook comprobemos que se conecta.
*Dando al botón “Test or discover settings” se nos muestran todos los calendarios del servidor y elegimos el que queramos; en “elementos de la carpeta” diremos “elementos de calendario”.

[[File:Calendario.png|center|800px]]

== Uso de reloj hardware en nodos de procesamiento ==

=== En nodo de procesamiento ACD ===
En un nodo de procesamiento ACD es obligatorio instalar dahdi y una tarjeta de primario para emplear reloj hardware, ya que el reloj software que va en el asterisk 1.4 es defectuoso.
Para configurarlo basta con instalar la tarjeta en el servidor, instalar dahdi y posteriormente ejecutar el siguiente comando:

dahdi_cfg

Este comando generaŕa el fichero /etc/dahdi/system.conf

Para comprobar que el comando se ha ejecutado satisfactoriamente lo abriremos y tendrá que tener un formato semejante al siguiente ejemplo:

# Autogenerated by /usr/sbin/dahdi_genconf on Tue Oct 22 17:42:59 2013
# If you edit this file and execute /usr/sbin/dahdi_genconf again,
# your manual changes will be LOST.
# Dahdi Configuration File
#
# This file is parsed by the Dahdi Configurator, dahdi_cfg
#
# Span 1: WCT1/0 "Digium Wildcard TE110P T1/E1 Card 0" HDB3/CCS/CRC4
span=1,1,0,ccs,hdb3,crc4
# termtype: te
bchan=1-15,17-31
dchan=16
echocanceller=oslec,1-15,17-31
# Global data
loadzone = es
defaultzone = es

=== En nodo de procesamiento de corporativa ===
En un nodo de procesamiento de corporativa no obligatorio instalar dahdi y una tarjeta de primario para emplear reloj hardware, ya que el no se han detectado errores en el reloj por software. Sin embargo si instalamos dahdi y una tarjeta de primario para emplear reloj hardware, el sistema funcionará mejor.
Para configurarlo basta con instalar la tarjeta en el servidor, instalar dahdi y posteriormente ejecutar el siguiente comando:

dahdi_cfg

Este comando generaŕa el fichero /etc/dahdi/system.conf

Para comprobar que el comando se ha ejecutado satisfactoriamente lo abriremos y tendrá que tener un formato semejante al siguiente ejemplo:

# Autogenerated by /usr/sbin/dahdi_genconf on Tue Oct 22 17:42:59 2013
# If you edit this file and execute /usr/sbin/dahdi_genconf again,
# your manual changes will be LOST.
# Dahdi Configuration File
#
# This file is parsed by the Dahdi Configurator, dahdi_cfg
#
# Span 1: WCT1/0 "Digium Wildcard TE110P T1/E1 Card 0" HDB3/CCS/CRC4
span=1,1,0,ccs,hdb3,crc4
# termtype: te
bchan=1-15,17-31
dchan=16
echocanceller=oslec,1-15,17-31
# Global data
loadzone = es
defaultzone = es

== Aprovisionamiento terminales Cisco ==
=== Configurar protocolo SIP TCP o UDP en terminal Cisco ===

Configuración de terminal Cisco para para funcionar bajo TCP o UDP:
Modificar parámetro
<transportLayerProtocol>X</transportLayerProtocol>

Donde X es:
1: TCP
2: UDP
4: Valor por defecto del firmware (al menos en la última versión equivale a TCP)

=== Habilitar/Deshabilitar llamada en espera en terminales Cisco ===

En el fichero de aprovisionamiento del terminal añadiremos la siguiente linea
<callWaiting>X</callWaiting>

Donde X es:
0=off but can be changed through the settings menu.
1=on but can be changed through the settings menu.
2=off and locked so it can't be changed through the settings menu.
3=on and locked so it can't be changed through the settings menu.

== Como configurar servicio DHCP en Ubuntu Linux ==
=== ¿Que es un servicio DHCP? ===
Un servidor Dynamic Host Configuration Protocol (DHCP) asigna dinámicamente las direcciones IP y otras configuraciones de red a otros terminales que están conectados a la red.

=== Instalar un servicio DHCP ===
Para instalar el servidor de asignacion automatica de direccion IP ejecutamos el comando:
sudo apt-get install isc-dhcp-server

=== Configurando el servicio DHCP ===
Editamos el archivo /etc/dhcp/dhcpd.conf creando primero un backup del mismo:
mv /etc/dhcp/dhcpd.conf /etc/dhcp/dhcpd.conf.original
nano /etc/dhcp/dhcpd.conf

El archivo debe quedar de una forma muy similar a esta:
authoritative
subnet 10.254.239.0 netmask 255.255.255.254
{
range dynamic-bootp 10.254.239.40 10.254.239.60;
option domain-name-servers ns1.example.org, ns2.example.org;
option domain-name "example.org";
option routers rtr-239-0-1.example.org, rtr-239-0-2.example.org ;
option broadcast-address 10.254.239.255;
default-lease-time 3600;
max-lease-time 7200;
option option-150 10.254.239.25
}

Donde los campos:
*subnet: Direccion de red
*netmask: Máscara de red
*range dynamic-bootp: Rango de IPs que va a proporcionar el DHCP
*option domain-name-servers: Direcciones IPs de los DNS
*option domain-name: Nombre de dominio
*option routers:IPs de las puertas de enlace
*option broadcast-address: Dirección de broadcast
*default-lease-time: Tiempo de concesión por defecto
*max-lease-time: Valor máximo del tiempo de concesión
*option option-150: IPs de los servidores TFTPs que tiene la red

=== Reiniciamos el servicio ===
service isc-dhcp-server restart

=== Direcciones IP estáticas basadas en la MAC ===
Pueden conocerse las MAC de las máquinas conectadas a la red ejecutando el comando arp desde la terminal.

host ejemplo {
hardware ethernet 00:0B:82:19:A8:04;
option option-150 10.254.239.0;
# fixed-address 10.254.239.52;
}

== Protocolo Skinny en VIVAit Call mediante uso de Chan-SCCP ==
=== Instalación de chan_sccp ===
*Copiar el fichero chan-sccp-4.2.1.1.tar.gz en el directorio donde estén los fuentes de Asterisk (normalmente /usr/src/MDtel)
*Descomprimir
*Entrar al directorio chan-sccp-4.2.1.1
*Ejecutar: ./configure --with-asterisk=../DIRECTORIO_ASTERISK --enable-conference. Donde DIRECTORIO_ASTERISK es el nombre del directorio donde están los fuentes de asterisk.
*Tras el ejecutar el configure (si todo va bien al final se verá un resumen con el S.O, arquitectura, etc), ejecutar make y make install
*El nuevo módulo chan_sccp.so se generará dentro del DIRECTORIO_ASTERISK en lib/asterisk/modules/ y se deberá copiar en /usr/lib/asterisk/modules/
*Copiar el fichero sccp.conf a /etc/asterisk
*Entra a Asterisk y ejecutar: module load chan_sccp.so
*Si se ha cargado correctamente, desde dentro de Asterisk, si se teclea sccp show version deberá devolver: "Skinny Client Control Protocol (SCCP). Release: 4.3.0 4.3.0 - unknown (built by 'root' on '2016-06-01 10:42:32 UTC')"

=== Crear extensiones ===
*En el portal crear una nueva clase de dispositivo (Vivait-Call/Dispositivos/Clases de dispositivos), donde la clase sea extensión la subclase H323 (todavía no existe la subclase SCCP) y el formato SCCP/${DEST}
*Crear la nueva extensión, pero el dispositivo debe ser el creado en el campo anterior.
*Las extensiones creadas habrá que añadirlas al fichero sccp.conf así como los teléfonos que las usarán. En el fichero sccp.conf incluido hay ejemplos.

=== Aprovisionamiento ===
Los terminales se aprovisionan de la misma manera que los SIP, exceptuando que las plantillas XML no tiene referencias a SIP. Se incluye un xml genérico con todas las opciones.
Dentro del directorio chan-sccp-4.2.1.1 hay un directorio conf con todos los archivos de configuración necesarios. Las versiones annotated contienen todas las opciones posibles comentadas.

== Instalación y configuración Postfix en RedHat7 ==

'''Postfix''' es un ''servidor de correo'' de software libre/código abierto, un programa informático para el enrutamiento y envío de correo electrónico.

=== Instalación ===
yum install postfix

=== Configuración ===
Sobre la configuración de postfix por defecto (recién instalado):
Editar el fichero /etc/postfix/main.cf
inet_protocols = ipv4
relayhost = smtp.renfe.es
Revisar la configuración:
postfix check
Configurar postfix como servicio (sólo en redhat y similares)
chkconfig postfix on
Iniciar postfix:
service postfix start
Instalar mailx para disponer de los comandos mail y sendmail:
yum install mailx
Probar configuración:
echo "Prueba de correo" | mail -vs "Prueba" correo@destino.soy

== Como crear un TRIGGER en Zabbix ==

'''1.''' Hay '''dos posibilidades''' dependiendo si el trigger es para un solo host o es para varios, los cuales tienen en común un template:

:# Si es para ''un host'': Ir a '''Configuración/Hosts'''
:# Si es para ''un template'': Ir a '''Configuración/Templates'''

'''2.''' En la fila correspondiente al host/template al que queramos añadirle el trigger, pulsar sobre la '''columna triggers.''' 
'''3.''' En la ventana de triggers, pulsar sobre el botón '''Create trigger''', situado en la esquina superior derecha. 
'''4.''' Aparecerá la ventana de creación de triggers, que tiene los siguientes campos:
:1. '''Name:''' Nombre del trigger, que deberá ser lo ''suficientemente descriptivo''. Aparecerá cuando se
active, en la ventana principal de Zabbix así como en los correos de aviso.
:2. '''Expression:''' Define la fórmula cuyo resultado activará el trigger. Hay que pulsar el botón '''Add'''. Se mostrará una
nueva ventana donde habrá que elegir el item (medida) sobre el que se basará el trigger (evidentemente la medida deberá
existir previamente) y la función necesaria para el cálculo. Para una descripción de las disponibles dirigirse a
https://www.zabbix.com/documentation/2.2/manual/appendix/triggers/functions. 
Tras rellenar los campos anteriores y dar a la función los valores que necesite pulsar el botón '''Insert.'''
:3. '''Expression constructor:''' Permite crear expresiones complejas, uniendo varias.
:4. '''Description:''' Una explicación del trigger
:5. '''Severity:''' Criticidad el trigger
:6. Para una descripción del resto de campos visitar la página: https://www.zabbix.com/documentation/2.2/manual/config/triggers/trigger
'''5.''' Tras rellenar los campos, pulsar el botón '''Save'''. 
'''6.''' Si el trigger se ha añadido en un template, aparecerá en todos los hosts que tienen el template configurado. 
'''7.''' '''El trigger por si solo no envía ningún aviso''', solo se activa si se cumple la expresión definida.
Para enviar un aviso (normalmente un correo electrónico) cuando se active el trigger, será necesario definir una acción (Configuración/Actions).

'''NOTA.-''' Para consultar cualquier cuestión relativa a Zabbix, se encuentra a su disposición el manual: 
https://www.zabbix.com/documentation/2.2/manual

== Como mostrar callername queues FOP2 ==

Es necesario añadir el siguiente código al contexto de entrada:

exten => _X.,n,MYSQL(Connect connid localhost usuario clave bd)
exten => _X.,n,MYSQL(Query resultid ${connid} SELECT\ firstname\,lastname\ from\ fop2\ where\ phone1=${CALLERID(num)}\ OR\ phone2=${CALLERID(num)})
exten => _X.,n,MYSQL(Fetch fetchid ${resultid} nombre apellidos)
exten => _X.,n,GotoIf($[${fetchid} = 1]?:noExiste)
exten => _X.,n,Set(CALLERID(name)=${nombre}${apellidos})
exten => _X.,n(noExiste),Continuar

En la primera línea cambiar según lo necesario:

*localhost: Dirección IP del servidor de MySQL donde está la BBDD de FOP2
*usuario: Usuario con permisos de acceso a la bbdd de FOP2
*clave: Clave del usuario
*bd: Nombre de la BBDD

== Como ver los directorios de un NAS a montar con NFS ==

Con el siguiente comando vemos los diferentes volúmenes de un NAS:

showmount -e IP_NAS

Ejemplo de salida:

Export list for 192.168.10.10:
/Backup/backup *
/DISCOS_1/VOL1_AUDIO *

== Instalación de ActivaSTP con VIVAit Call 3 y marcación desde Outlook ==

Instalamos ActivaSTP desde:

(http://activa.sourceforge.net/)



La configuración necesaria se muestra en la siguiente imagen:

[[File:Ventana ActivaTSP.jpg]]

El usuario del manager debe tener permisos originate para poder realizar llamadas.

Se han realizado pruebas con Outlook 2013.

Se ha comprobado la correcta realización de pruebas utilizando ActivaSTP, realizadon llamadas desde la pestaña "personas" con la vista en modo tarjeta de Pesentación, tarjeta, teléfono o lista.

Outlook 2013 no da la opción de llamar si la vista está en modo personas.

== Como volver a procesar grabaciones con error ==

Las grabaciones con error son aquellas que tienen el valor E_GRABACION=120 en la tabla DAT_GRABACIONES.

Las grabaciones con error se produce normalmente a perdida de conexión entre el nodo servidor de grabaciones y el resto.

Para reprocesar la grabación hay que modificar el campo E_GRABACION de la tabla DAT_GRABACIONES y ponerlo con valor 20 para que así el recordCentral la vuelva a procesar.

== FOP2. Problemas en transferencias asistidas ==

Para habilitar la transferencia atendida del asterisk (funcion atxfer), hay que poner la opción tT en el queue() si la llamada origen la realiza a una cola o
al dial() de las extensiones.
Con eso vemos como al intentar hacer la llamada de consulta ya se va a nuestro dialplan. Sin embargo la llamada no funciona ya que el enrutador nos da error de
enrutamiento porque no tenemos ID_DISPOSITIVO origen ya que el fop no es un elemento creado desde el portal.
Por lo que se propone como solución crear un contexto de inicio del fop y asignarle un ID_DISPOSITIVO para que así se enrute la llamada. El contexto tienen que
ser similar a ext_InicioLlamada_Chrome.conf

Para que funcione las transferencias supervisadas desde el fop2 hay que realizar lo siguiente:

*El usuario del manager debe tener permisos Atxfer para poder realizar transferencias.
*Habilitar la transferencia atxfer en el fuatures.conf del asterisk. atxfer => *2
*Crear el fichero ext_InicioLlamada_FOP.conf con el siguiente contenido:

[Cen_Inicio_FOP]
exten => [*#%0-9].,1,NoOp(MDINICHR**EXTEN=${EXTEN}**CID=${CHROME_ANI}*)
same => n,dumpchan()
;same => n,Set(CALLERID=${CHROME_ANI})
same => n,Gosub(Cen_Sub_getIdExtension,s,1(${R_CID_NUM_00}))
same => n,ExecIf($["${GOSUB_RETVAL}"!="OK" | "${sqlDato}"=""]?HangUp)
same => n,Set(ID_DISPOSITIVO=${sqlDato})
; . Modificar MARCAR en funcion de reglas de marcacion saliente (prefijo 0, ...)
; Esto se modificara en el contexto Cen_Inicio_Chrome_Particular
same => n,Set(MARCAR=${EXTEN})
;---------------------------------

;--- Llamada a contexto particular
;---------------------------------
; Esta llamada es para hacer cosas especcificas del cliente (cambiar callerid...)
; La subrutina Cen_Inicio_Chrome_Particular esta en el archivo ext_InicioLlamada_Chrome_Particular.conf
; Si no existe el archivo copiar el archivo ext_InicioLlamada_Chrome_Particular.conf.ejemplo como ext_Inicio_Chrome_Particular.conf
; y realizar las modificaciones necesarias
; El fichero ext_InicioLlamada_Chrome_Particular.conf se carga automaticamente al ser creado con el include de ext_InicioLlamada.conf
; #include "ext_InicioLlamada*.conf"
;
same => n,GosubIf($[${DIALPLAN_EXISTS(Cen_Inicio_FOP_Particular,${EXTEN},1)}>0]?Cen_Inicio_FOP_Particular,${EXTEN},1)
same => n,Goto(Cen_Inicio_SIP,${MARCAR},1)

*En el fichero /usr/local/fop2/buttons.cfg poner como contexto de las extensiones el creado anteriormente (Cen_Inicio_FOP)
*Modificar el fichero /usr/local/fop2/fop2.cfg:

blind_transfer = 0
supervised_transfer = 1

Para realizar la transferencia con consulta, hay que pulsar el supervised transfer del FOP2 y una vez se haya establecido la llamada, seleccionar la extensión que "sobra" en la conversación y pulsar la tecla de hangup y colgar la llamada.



== Como borrar contenido de la tabla BDTR con el script borraRegistrosNimitz.pl ==

Este script se ejecuta mediante una tarea del crontab, tal como la siguiente:

SHELL=/bin/sh
PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
# m h dom mon dow user command
00 01 * * * root /usr/local/sbin/borraRegistrosNimitz.pl --hDB localhost

Para establecer el número de días que vamos a dejar en la base de datos debemos editar el archivo borraRegistrosNimitz.pl, el campo my $numDias