Contenido

Introducción

Prerequisites

Requirements

Componentes Utilizados

Antecedentes

Flujo de trabajo

Prerequisites

Configurar

Agregar credenciales

Agregar la dirección de red

Aplicaciones de clúster

Página de descripción general

Informe de SI CUCDM

Troubleshoot

Verificación

Introducción

Este documento describe cómo se crean los informes del inventario de servicios (SI) en una implementación de Hosted Collaboration Solution (HCS) 9.2.1 y las interacciones entre el inventario de servicios de Cisco Hosted Collaboration Mediation Fulfillment (HCM-F) y Cisco Unified Communications Domain Manager (CUCDM) 8.1.X durante este proceso.

Prerequisites

Requirements

No hay requisitos específicos para este documento.

Componentes Utilizados

La información que contiene este documento se basa en las siguientes versiones de software y hardware.

- CUCDM 8.1.X

- HCM-F 9.2.1

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, make sure that you understand the potential impact of any command.

Antecedentes

Cisco HCS SI es una aplicación que proporciona informes a los proveedores de servicios con fines de facturación. Estos informes contienen datos sobre clientes, suscriptores, dispositivos y otros detalles que se aprovisionan actualmente en CUCDM. Además, SI puede generar informes directamente desde los servidores de aplicaciones de Cisco Unified Communications Manager y Cisco Unity Connection para clientes que se aprovisionan en Cisco HCM-F y que no tienen un CUCDM configurado. SI transfiere automáticamente los archivos de informe a intervalos configurables regulares a servidores SFTP remotos. Los proveedores de servicios utilizan estos informes para generar registros de facturación para sus clientes.

Flujo de trabajo

1. El administrador programa y configura los informes de inventario de servicios mediante la configuración del inventario de servicios.

2. Según una programación establecida, el servicio web de SI envía una solicitud de protocolo simple de acceso a objetos (SOAP) a CUCDM.

3. CUCDM recibe esta solicitud SOAP y activa una transacción para crear datos relacionados con el inventario de servicios y CUCDM envía estos datos al HCM-F SI a través de SFTP.

4. SI ve los nuevos archivos, los descomprime y los procesa.

5. El SI finalmente envía un archivo .si.

6. SI crea copias de seguridad de todos los archivos, que incluyen .si, para su posterior recuperación y soporte de campo si es necesario.

7. SI transfiere los archivos .si a los host SFTP tal como se configuró en la GUI.

Prerequisites

HCM-F y CUCDM deben instalarse y configurarse. Estos servicios deben activarse e iniciarse en HCM-F:

- Base de datos CDM de Cisco

- Tomcat de Cisco

- IU SI de Cisco HCS

Utilice Cisco HCS North Bound Interface Web Service si planea configurar SI a través de la interfaz administrativa de SI. Utilice Cisco HCS Fulfillment Service si planea configurar SI a través de Cisco HCM-F NBI. Asegúrese de que el servicio CUCDMSync de Cisco HCS se está ejecutando si tiene previsto ejecutar el servicio CUCDMSync de Cisco HCS. Utilice el servicio Cisco HCS Provisioning Adapter para que la sincronización automática pueda propagar los datos de CUCDM al repositorio de datos compartidos. SI obtiene los datos de conexión para CUCDM del repositorio de datos compartidos. El Servicio de adaptador de aprovisionamiento de Cisco HCS proporciona credenciales e información SNMP, así como datos de Syslog remotos en los dispositivos de Cisco Unified Communications Manager.

Los servicios requeridos difieren entre un informe de CUCDM y un informe de aplicación de UC compatible.

Para los informes de CUCDM, necesita estos servicios:

- Servicio de adaptador de aprovisionamiento de Cisco HCS

- Tomcat de Cisco

- Inventario de servicios de Cisco HCS

- IU SI de Cisco HCS

- Base de datos CDM de Cisco

- Servicio de cumplimiento de Cisco HCS

- Servicio CUCDMSync de Cisco HCS

- Servicio UCSMSync de Cisco HCS

- Servicio VCenterSync de Cisco HCS

Para los informes de aplicaciones de UC compatibles, necesita estos servicios:

- Servicio de adaptador de aprovisionamiento de Cisco HCS

- Tomcat de Cisco

- Inventario de servicios de Cisco HCS

- IU SI de Cisco HCS

- Base de datos CDM de Cisco

Los servicios web deben activarse e iniciarse en CUCDM 8.1.X.

=>[webservices] #

show

|OPTION |VALUE |DESCRIPTION |

|------ |----- |----------- |

|Enabled |True |Enable Webservice |

|8.1.0 |True |Enable version 8.1.0 webservices interface |

|8.0.0 |False |Enable version 8.0.0 compatible webservices interface |

Configurar

Nota: Use la Command Lookup Tool (clientes registrados solamente) para obtener más información sobre los comandos usados en esta sección.

Asegúrese de haber agregado CUCDM como una instancia de aplicación de administración en HCM-F. Esto se debe a que el inventario de servicios de HCM-F se basa en los datos de CUCDM para generar informes de inventario de servicios, por lo que es necesario agregarlos.

Para hacerlo, elija Administrador de infraestructura > Red de administración > Aplicación de administración > Agregar nuevo.

- Versión de la API: en esta lista desplegable, elija 8.1.0 u 8.0.
Cuando se integra con una versión de CUCDM anterior a 8.1.2, la versión de la API debe configurarse en 8.0. La versión de la API se puede establecer en 8.0 u 8.1 cuando se integra con CUCDM 8.1.2 o posterior. Además, tenga en cuenta que si se configura la versión 8.0 de la API, los troncales SIP no se sincronizarán y sólo se sincronizará el nombre de la ubicación para la ubicación del cliente.

- Port (Puerto): El puerto predeterminado es 8181. Este es el puerto SOAP que utiliza el SI para enviar el primer mensaje SOAP al CUCDM.

- Credenciales: elija el tipo de credencial ADMIN y proporcione una ID de usuario (en este caso hcmf). Este usuario se utiliza para acceder a CUCDM.

Nota: Este usuario también debe existir en CUCDM con la misma contraseña. Para verificar esto, desde la GUI de CUCDM elija Administración General > Administración Usuarios.

Cuando agregue/configure este usuario, asegúrese de que el acceso al servicio web se ha activado. (Este usuario es utilizado por HCM-F SI para enviar una solicitud de servicio web a CUCDM, por lo que es necesario activarlo).

La generación de informes procedente de CUCDM ya se ha tratado. SI, sin embargo, también puede generar informes directamente desde una aplicación de UC admitida, Cisco Unified Communications Manager y los servidores de aplicaciones de Cisco Unity Connection para clientes que se aprovisionan en Cisco HCM-F y que no tienen un CUCDM configurado.

Si no tiene un CUCDM configurado, debe agregar servidores de aplicaciones Cisco Unified Communications Manager (CUCM) y Cisco Unity Connection (CUC) manualmente para ejecutar un informe de inventario de servicios.

1. Elija Infrastructure Manager > Customer Management > Customer > Cluster. Elija la aplicación en cuestión. Por ejemplo, su servidor CUCM o CUC, como se muestra en esta imagen.

2. Agregue las credenciales PLATFORM y ADMIN a cada una de las aplicaciones como se muestra en esta imagen.

Agregar credenciales

Para agregar credenciales,

1. Haga clic en la pestaña Credenciales.

2. Haga clic en Agregar nuevo.

3. Elija el tipo de credencial.
Nota: TANTO PLATAFORM como ADMIN son necesarios para ejecutar la colección de informes de aplicaciones de UC.

4. Complete los campos User ID, Password y Re-enter Password.

5. Click Save.

6. Repita esta acción para agregar el siguiente tipo de credencial.

Agregar la dirección de red

1. Haga clic en la pestaña Dirección de red.

2. Haga clic en Agregar nuevo.

3. Seleccione el espacio de red : Espacio para proveedores de servicios.

4. Introduzca la dirección IPV4.
Esto es necesario tanto para Cisco Unified Communications Manager como para Cisco Unity Connection.

Aplicaciones de clúster

Repita todo para la siguiente aplicación de clúster.

A continuación, configure el artículo del inventario de servicios en la página de configuración del inventario de servicios en HCM-F, como se muestra en esta imagen.

Página de descripción general

Aquí puede establecer la programación que define cuándo desea que comience el informe.

1. Asegúrese de marcar la casilla de Habilitar programación.
Nota: La versión del formato del informe es clave aquí.

2. Seleccione la versión de formato de informe que desea que proporcione la aplicación SI. Asegúrese de utilizar las versiones compatibles de SI y cualquier aplicación de UC admitida. Para obtener información sobre compatibilidad, vea Matriz de compatibilidad para la solución de colaboración alojada de Cisco.
La versión de formato de informe de Cisco HCS 9.1(1) sólo es compatible con la versión 8.1 y posteriores de CUCDM. La versión de formato de informe de Cisco HCS 9.0(1) es compatible con la versión 8.0 y posteriores de CUCDM. Si ejecuta una versión anterior del software CUCDM, elija la versión de formato de informe 8.6(2).

Informe de SI CUCDM

1. Para asegurarse de que los formatos de informe HCS de la versión 9.1(1) y 9.0(1) se generen correctamente, navegue hasta Infrastructure Manager > Management Application. En esta página, asegúrese de elegir la versión 8.0 o 8.1 del software CUCDM y no la versión 7.4.

2. A continuación, configure la página de configuración en la página de configuración del inventario de servicios en HCM-F.

3. En la sección Configuración del inventario de servicios, configure el nombre de host/dirección IP del servidor SI. El nombre de host del SI debe ingresarse como una dirección IP o un nombre de dominio completo. Si el servidor CUCDM no está configurado con DNS habilitado, introduzca una dirección IP en el campo Nombre de host.
El campo Nombre de usuario aparece atenuado (codificado).

CUCDM utiliza el nombre de usuario, adminsftp, para transferir datos a la aplicación SI. No puede actualizar este campo.

4. En el campo Contraseña, introduzca la contraseña de la cuenta de usuario adminsftp. Este paso es obligatorio como confirmación de identidad por motivos de seguridad. Esta contraseña es la misma que la del administrador de HCS que configuró durante la instalación de Cisco HCM-F (o que cambió después de la instalación).
Nota: CUCDM aprende esta contraseña de SI cuando SI envía la solicitud SOAP original.

5. En la sección Service Provider SFTP Settings, configure el nombre de host y el puerto (22) junto con el nombre de usuario/la contraseña para el servidor SFTP al que enviará los archivos de informe .si.

Troubleshoot

En esta sección se brinda información que puede utilizar para resolver problemas en su configuración.

Los registros importantes son:

- activelog tomcat/logs/catalina.out - incluye mensajes de solicitud y respuesta hacia y desde CUCDM.

- activelog tomcat/logs/si/log4j - contiene todas las operaciones específicas de SI.

Nota: Si utiliza SI sin CUCDM, revise también estos registros:

- /var/log/active/hcs/chpa - Archivos de registro del servicio del adaptador de abastecimiento

- /var/log/active/hcs/ucpa - archivos de registro de servicio ucpa

Complete estos pasos para establecer los niveles de registro en el nivel Detallado (debug):

1. Introduzca el comando:
admin:

set trace tracelevel

2. Ingrese el traclevel (utilice el comando CLI show tracelevels para encontrar los tracelevels permitidos) - Detallado

3. Introduzca el nombre del servicio - Tomcat de Cisco
Los registros se actualizan correctamente.

Una vez hecho esto, espere a la siguiente generación de informes según lo programado. Lo primero que hay que comprobar es si puede ver la transacción en VOSS. Busque una transacción denominada CreateServiceInventory. Esta transacción debe realizarse correctamente.

Observe que puede ver el ID de usuario en el resultado de la transacción es el usuario hcmf que se configuró anteriormente tanto en HCM-F como en CUCDM.

Una vez hecho esto, verifique si los archivos lo han hecho en SI correctamente. Es importante comprender cómo funciona la estructura de datos de informes en SI. El formato de un archivo SI es un archivo basado en ASCII con la extensión de archivo ".si". (La extensión de archivo del formato común del inventario de servicios de aplicaciones de UC es .ucsi)

Por lo tanto, en circunstancias normales, CUCDM envía los archivos SI sin procesar (comprimidos) al HCM-F. A continuación, HCM-F (SI) hace un masaje de los datos. (SI ve los nuevos archivos, descomprime los archivos y los procesa.) Dentro de la estructura de archivos hay varios directorios y cada uno de ellos tiene su propio significado dependiendo del estado de los datos. El Centro de asistencia técnica (TAC) sólo puede acceder a estas carpetas durante una sesión de resolución de problemas a través de la cuenta raíz.

Específicamente, todos los archivos se almacenan aquí en SI: /opt/hcs/si/backup/

- dmunzip/ - aquí es donde descomprime y coloca los archivos recibidos de CUCDM.

- cntranslation/ - luego los archivos se traducen como un paso intermedio y se dirigen a este directorio.

- cisco-normalized/ - luego se produce un solo archivo (copia del resultado final) y entra aquí.

- sp-normalized/ - basado en el tamaño máximo de archivo configurado en la GUI, el archivo mencionado anteriormente se divide en fragmentos según el tamaño máximo de relleno configurado (luego se renumeran para secuenciación).

/opt/hcs/si/backup/dmuncompressed

[root@hcmf921 dmuncompressed]#

20150522210000GMT+1+CUCDM+1+1.dsi  20150622121500GMT+1+CUCDM+1+1.dsi

20150523210000GMT+1+CUCDM+1+1.dsi  20150623121500GMT+1+CUCDM+1+1.dsi

20150524210000GMT+1+CUCDM+1+1.dsi  20150624121500GMT+1+CUCDM+1+1.dsi

20150525210000GMT+1+CUCDM+1+1.dsi  20150625121500GMT+1+CUCDM+1+1.dsi

20150526210000GMT+1+CUCDM+1+1.dsi  20150626121500GMT+1+CUCDM+1+1.dsi

[root@hcmf921 dmuncompressed]#

/opt/hcs/si/backup/cntranslated

[root@hcmf921 cntranslated]#

20150602210000GMT+1+CUCDM+1+1.tsi  20150703121500GMT+1+CUCDM+1+1.tsi

20150603210000GMT+1+CUCDM+1+1.tsi  20150704121500GMT+1+CUCDM+1+1.tsi

20150604210000GMT+1+CUCDM+1+1.tsi  20150705121500GMT+1+CUCDM+1+1.tsi

20150605210000GMT+1+CUCDM+1+1.tsi  20150706121500GMT+1+CUCDM+1+1.tsi

[root@hcmf921 cntranslated]#

/opt/hcs/si/backup/cisco-normalized

[root@hcmf921 cisco-normalized]#

10000GMT+1+CUCDM+1+1.csi  20150703121500GMT+1+CUCDM+1+1.csi

20150603210000GMT+1+CUCDM+1+1.csi  20150704121500GMT+1+CUCDM+1+1.csi

20150604210000GMT+1+CUCDM+1+1.csi  20150705121500GMT+1+CUCDM+1+1.csi

20150605210000GMT+1+CUCDM+1+1.csi  20150706121500GMT+1+CUCDM+1+1.csi

20150606210000GMT+1+CUCDM+1+1.csi  20150707121500GMT+1+CUCDM+1+1.csi

20150607210000GMT+1+CUCDM+1+1.csi  20150708121500GMT+1+CUCDM+1+1.csi

20150608210000GMT+1+CUCDM+1+1.csi  20150709090000GMT+1+CUCDM+1+1.csi

/opt/hcs/si/backup/sp-normalized

[root@hcmf921 sp-normalized]#

20150528210000GMT+1+CUCDM+1+1.si  20150628121500GMT+1+CUCDM+1+1.si

20150529210000GMT+1+CUCDM+1+1.si  20150629121500GMT+1+CUCDM+1+1.si

20150530210000GMT+1+CUCDM+1+1.si  20150630121500GMT+1+CUCDM+1+1.si

20150531210000GMT+1+CUCDM+1+1.si  20150701121500GMT+1+CUCDM+1+1.si

20150601210000GMT+1+CUCDM+1+1.si  20150702121500GMT+1+CUCDM+1+1.si

Para extraer los archivos de registro del SI, ingrese estos comandos

file get activelog  tomcat/logs/catalina.out

file get activelog tomcat/logs/si/log4j/XXXXXX (where XXXX are the filenames

you want to gather)

Verificación

Actualmente, no hay un procedimiento de verificación disponible para esta configuración.