Configuración y resolución de problemas del servicio de directorio en CME

Introducción

Este documento describe cómo configurar y solucionar problemas de servicios de directorio en Cisco Unified Communications Manager Express (CME).

Colaborado por Srinivasa Dee Conda y editado por Ramiro Amaya, Ingenieros del TAC de Cisco.

Prerequisites

Requirements

Cisco recomienda que tenga un conocimiento básico de estos temas:

• Solución de problemas y configuración de CME
• Teléfonos IP

Componentes Utilizados 

Este documento no se limita a una versión de software específica. Sin embargo, los componentes utilizados en estos documentos son:

• CME
• Teléfonos IP

Antecedentes

1. Directorio local

• CME crea un directorio local que se presenta a cada teléfono IP registrado.
• Este directorio local incluye todos los DN de teléfono creados en CME.
• Además, CME admin puede agregar números al directorio local manualmente.
• El usuario del teléfono puede navegar por este directorio de esta manera:
• Pulse el botón de función Directorios del teléfono
  1. Seleccionar directorio local
  2. Escriba el nombre y los apellidos del usuario objetivo que desea buscar. En caso de que estos campos queden en blanco, se mostrarán todos los usuarios del directorio local
• La página de directorio local se muestra al usuario del teléfono en formato XML al que se accede mediante HTTP sin protección de contraseña. Una vez que se presionó el botón Directories, el teléfono envía la solicitud HTTP al CME para la URL http://#CME-IP#/localdirectory. CME analiza la URL y responde con XML uno.
• Esta URL se proporciona al botón de función Directorios del teléfono como parte del archivo de configuración del teléfono durante el registro del teléfono.

2. Directorio externo

• Cada botón de función del teléfono IP (Mensajes, Directorios, Configuración, etc.) admite asociación de URL
• La función del botón se basa en la URL asociada
• Basándose en esto, puede asignar una URL externa al botón de función Directorios. Una vez hecho esto, el teléfono IP navega por un directorio externo en lugar del directorio local en CME
• Una vez creada la URL de directorio externo, los servicios de directorio local se desactivan automáticamente en CME

Nota: El teléfono IP debe restablecerse para obtener la nueva URL 

3. Visualización del nombre de la llamada

• Esta función habilita la visualización del nombre del receptor de la llamada en el teléfono del receptor de la llamada
• El nombre de la persona a la que se llama se obtiene del directorio local. Éste puede ser el nombre asignado al DN del teléfono o agregado manualmente al directorio local.
• En caso de superposición entre el nombre del DN del teléfono y la entrada manual del directorio, la entrada manual tiene prioridad.

Configuraciones

telephony-service
 service dnis dir-lookup
 directory entry 1 3011 name Test-Phone1
!
ephone-dn 1 dual-line
 number 3011 
 name Test-Phone1

 

Plantilla de configuración

ip http server

!

telephony-service

 directory {first-name-first | last-name-first}         !!!... Change the display mode of directory entries

 directory entry {directory-tag number name name | clear}           !!!... Manually add directory entries

 no service local-directory           !!!... Manually disable local directory services

 url directories url           !!!... Configure external directory URL

 service dnis dir-lookup           !!!... Enable called-name display feature

!

voice register global

 url directory url

!

ephone-dn dn-tag

 name name

!

voice register dn dn-tag

 name name

 

Restricciones

1. La configuración del servicio de directorio externo sólo funciona con teléfonos no basados en Java. Cualquier teléfono basado en Java mostrará directorios duplicados para lo siguiente:

• Perdido
• Recibido
• Realizado

2. En caso de que desee utilizar CUCM como directorio externo, los teléfonos deben configurarse en CUCM para obtener sus direcciones MAC. No es necesario que los teléfonos se registren con CUCM o asignen DNs, pero deben configurarse para el propósito de la dirección MAC.

Troubleshoot

Recopile captura de paquetes en CME y recopile "debug ip http all" en el CME para verificar la interacción entre CME y el teléfono IP para el servicio de directorio local.

Este fragmento de código explica la interacción paso a paso entre el teléfono IP y el CME para una búsqueda en el directorio.

Situación de búsqueda correcta

1. Pulse el botón Directorio del teléfono

Router2811#
101245: Mar 24 07:29:24.992: %RITE-5-CAPTURE_START: Started IP traffic capture for interface FastEthernet0/0
101246: Mar 24 07:29:33.424: lds_urlhook, url=/localdirectory
101247: Mar 24 07:29:33.424: Mon, 24 Mar 2014 07:29:33 GMT 10.65.47.115 /localdirectory ok
 Protocol = HTTP/1.1 Method = GET Query = locale=English_United_States&name=SEP000000000002
101248: Mar 24 07:29:33.424:
101249: Mar 24 07:29:33.428: local_directory_search_get_action: minor = 0, uri_index =locale=English_United_States&name=SEP000000000002
101250: Mar 24 07:29:33.428: ipkeyswitch_ldir_send_file 1: page 0
101251: Mar 24 07:29:33.428: ipkeyswitch_ldir_send_file 3: to send prologue
Router2811#

2. Seleccionar directorio

Router2811#
101252: Mar 24 07:29:54.696: lds_urlhook, url=/localdirectory/query
101253: Mar 24 07:29:54.696: Mon, 24 Mar 2014 07:29:54 GMT 10.65.47.115 /localdirectory/query ok
 Protocol = HTTP/1.1 Method = GET
101254: Mar 24 07:29:54.696:
101255: Mar 24 07:29:54.700: local_directory_search_get_action: minor = 1, uri_index =
101256: Mar 24 07:29:54.700: ipkeyswitch_ldir_send_file 1: page 1
101257: Mar 24 07:29:54.700: ipkeyswitch_ldir_send_file 3: to send prologue
Router2811#

3.  Introduzca el nombre del usuario y pulse Enviar (ejemplo first name=Prueba)

Router2811#
101258: Mar 24 07:30:15.909: lds_urlhook, url=/localdirectory/search
101259: Mar 24 07:30:15.909: Mon, 24 Mar 2014 07:30:15 GMT 10.65.47.115 /localdirectory/search ok
 Protocol = HTTP/1.1 Method = GET Query = f=Test
101260: Mar 24 07:30:15.909:
101261: Mar 24 07:30:15.913: local_directory_search_get_action: minor = 2, uri_index =f=Test
101262: Mar 24 07:30:15.913: ipkeyswitch_ldir_send_file 1: page 2
101263: Mar 24 07:30:15.913: ipkeyswitch_ldir_send_file 3: to send prologue
101264: Mar 24 07:30:15.913: ipkeyswitch_dir_search_result 1: f=Test
101265: Mar 24 07:30:15.913: ipkeyswitch_dir_search_result 2: f=Test
101266: Mar 24 07:30:15.913: ipkeyswitch_dir_search_result token:f=Test, l=, p=
101267: Mar 24 07:30:15.913: ipkeyswitch_dir_search_result length:f=4, l=0, p=0
101268: Mar 24 07:30:15.913: valid_ephone_dn check for number: 3001
101269: Mar 24 07:30:15.913: valid_ephone_dn check for number: 3002
101270: Mar 24 07:30:15.917: valid_ephone_dn check for number: 3003
101271: Mar 24 07:30:15.917: valid_ephone_dn check for number: 3004
101272: Mar 24 07:30:15.917: valid_ephone_dn check for number: 3005
101273: Mar 24 07:30:15.917: valid_ephone_dn check for number: 3006
101274: Mar 24 07:30:15.917: valid_ephone_dn check for number: 3007
101275: Mar 24 07:30:15.917: valid_ephone_dn check for number: 19990000
101276: Mar 24 07:30:15.917: valid_ephone_dn invalid dn 9 number: 19990000
101277: Mar 24 07:30:15.917: valid_ephone_dn check for number: 3101
101278: Mar 24 07:30:15.917: valid_ephone_dn check for number: 3102
101279: Mar 24 07:30:15.917: valid_ephone_dn check for number:
101280: Mar 24 07:30:15.917: valid_ephone_dn check for number: 28282
101281: Mar 24 07:30:15.917: valid_ephone_dn check for number: 3998
101282: Mar 24 07:30:15.917: valid_ephone_dn check for number: 3457
101283: Mar 24 07:30:15.921: valid_ephone_dn check for number:
101284: Mar 24 07:30:15.921: valid_ephone_dn check for number: 3011
101285: Mar 24 07:30:15.921: ip_keyswitch_search_ephone_dn:
 f=Test-Phone1, l=
101286: Mar 24 07:30:15.921: ip_keyswitch_search_ephone_dn:
 matches: 1
101287: Mar 24 07:30:15.921: valid_ephone_dn check for number: 3012
101288: Mar 24 07:30:15.921: ip_keyswitch_search_sip_phone:
 f=cisco, l=
101289: Mar 24 07:30:15.921: ip_keyswitch_search_sip_phone:
 f=Harp, l=Test
101290: Mar 24 07:30:15.921: ip_keyswitch_search_directory_entry :
 f=Test-Phone1, l=
101291: Mar 24 07:30:15.921: ip_keyswitch_search_directory_entry: 2