Easy UC para Cisco · Documentación
Documentación técnica completa con todos los contenidos sobre instalación, aprovisionamiento y portal de usuario final.
Introducción
Easy UC es una appliance virtual que simplifica radicalmente la gestión de su entorno Cisco Unified Communications. Ahorre hasta el 90% del trabajo manual de configuración.
Concepto en resumen
Virtual Appliance (OVA)
Una VM Linux preconfigurada con todo lo necesario: servicio Easy UC, base de datos, servidor web.
Integración API con CUCM
Easy UC se comunica mediante las APIs oficiales de CUCM (AXL, RIS, CDR) – sin cambios en CUCM.
Basado en LDAP
Los nuevos usuarios de Active Directory o LDAP se detectan y aprovisionan automáticamente.
Portal de autoservicio
Los usuarios gestionan softphones, SNR, marcaciones rápidas y bloqueos sin tickets de TI.
Componentes principales
- Easy UC Core – Motor de aprovisionamiento, interfaz web, planificador
- Servicio LDAP-Sync – Detecta cambios en AD/LDAP en tiempo real
- Template Engine – Gestiona snapshots de configuración de dispositivos CUCM
- Portal de usuarios – Subdominio propio para autoservicio de usuarios
Requisitos
Easy UC requiere algunos requisitos técnicos para funcionar en su entorno CUCM.
Máquina virtual
| Recurso | Mínimo | Recomendado |
|---|---|---|
| vCPU | 2 Cores | 4 Cores |
| RAM | 4 GB | 8 GB |
| Almacenamiento | 60 GB | 100 GB (SSD) |
| VMware | ESXi 6.7 | ESXi 7.0+ / vSphere 8 |
| Red | 1× vNIC | 1× vNIC, Static IP |
Entorno Cisco UC
| Componente | Versiones |
|---|---|
| Cisco CUCM | 11.5 · 12.5 · 14 · 15 |
| Cisco Unity Connection | 11.5+ (opcional, para buzón) |
| Cisco Jabber | 11+ (Windows/macOS/Mobile) |
| LDAP / Active Directory | Windows Server 2012+ / OpenLDAP / 389DS |
Requisitos de red
Easy UC se comunica con varios servicios Cisco. Los siguientes puertos deben ser accesibles desde Easy UC a CUCM:
| Servicio | Destino | Puerto | Protocolo |
|---|---|---|---|
| CUCM AXL API | CUCM Publisher | 8443 | HTTPS |
| CUCM RIS | CUCM Publisher | 8443 | HTTPS |
| CUCM CDR (FTP/SFTP) | Easy UC | 22 / 21 | SFTP / FTP |
| Unity Connection REST | Unity Publisher | 8443 | HTTPS |
| LDAP | AD/LDAP Server | 389 / 636 | LDAP / LDAPS |
| SMTP | Mail Relay | 25 / 587 | SMTP |
| Easy UC Web | Easy UC | 443 | HTTPS |
Instalación OVA
La instalación de Easy UC se hace en pocos pasos. El tiempo típico de setup es de aproximadamente 1 hora.
Paso a paso
Obtener acceso al portal
Tras procesar su solicitud le enviamos credenciales del portal de clientes por correo. Allí encontrará la OVA actual, releasenotes y áreas de licencia y soporte.
Descargar OVA
En el portal en "Downloads → OVA Files" está la versión actual. Recomendamos usar siempre la última versión estable. Tamaño: ~3 GB.
Desplegar OVA en VMware
Vía vSphere Web Client en Hosts and Clusters → Deploy OVF Template. Seleccione el OVA, nombre la VM y elija datastore y red. Los recursos se toman del perfil OVF.
Encender la VM
Tras el primer arranque la consola muestra una IP por DHCP. Es temporal – en el siguiente paso definimos una IP estática.
Configurar la red
Vea la sección de configuración de red. Después Easy UC es accesible en https://<ip>/setup.
Ejecutar el webinstaller
El webinstaller guía por la conexión CUCM, LDAP, primer admin y carga de licencia. Duración: ~15–30 min.
Activar licencia
Tras el setup, cree una solicitud de licencia – la respondemos en un día laborable con una licencia demo de 30 días.
Configuración de red
Tras el primer arranque configure la dirección IP estática directamente en la consola de la VM.
Definir IP estática
- Abra la consola de la VM en vSphere
- Inicie sesión con la cuenta por defecto:
easyuc/easyuc - Inicie la herramienta de red:
sudo easyuc-network - Introduzca los siguientes valores:
| Parámetro | Ejemplo |
|---|---|
| Dirección IP | 10.10.20.50 |
| Máscara de subred | 255.255.255.0 |
| Puerta de enlace | 10.10.20.1 |
| DNS primario | 10.10.10.10 |
| DNS secundario | 10.10.10.11 |
| Hostname | easyuc-prod |
| Dominio | company.local |
Tras confirmar, la pila de red se reinicia. Easy UC queda accesible en la IP configurada.
easyuc.company.local). Simplifica referencias y configuración de CUCM.Webinstaller
El webinstaller es un asistente vía navegador que guía la configuración inicial de Easy UC.
Fases de configuración
Conexión CUCM
FQDN/IP del publisher, credenciales del usuario AXL, prueba de conexión.
Integración LDAP
Servidor LDAP, bind DN, base de búsqueda, intervalo de sync.
Cuenta de admin
Crea el primer administrador Easy UC (credenciales propias).
Licencia
Crear solicitud de licencia o importar una existente.
Actualizar el webinstaller
Easy UC y el webinstaller se actualizan por separado. En la interfaz de admin, en Sistema → Updates, se puede actualizar manualmente.
Standard AXL API Access, Standard CCM Admin Users y Standard CTI Enabled.Licenciamiento
Easy UC está disponible como licencia demo y productiva. Ambas conceden el conjunto completo de funciones.
Tipos de licencia
Licencia demo
30 días gratis · Funciones completas · Soporte de setup · Se envía tras la solicitud de licencia.
Licencia productiva
Precio personalizado · Suscripción o perpetua · Mantenimiento y updates · Soporte extendido · Bajo petición.
Crear solicitud de licencia
- En el webinstaller (o en Sistema → Licencia) pulse "Crear solicitud de licencia"
- Easy UC genera una solicitud firmada con ID de servidor y módulos deseados
- Descargue el archivo y envíelo a nuestro equipo
- En un día laborable recibe el archivo de licencia
- Súbalo en el mismo menú en "Importar licencia"
Ampliación de disco
Si el disco se llena por CDRs o logs, puede ampliar el disco virtual:
- Apagar la VM en vSphere
- En VM Hardware → Disk defina el nuevo tamaño
- Reiniciar la VM
- En la consola: ejecutar
sudo easyuc-disk-extend - El sistema de archivos se amplía automáticamente
Ubicaciones
Las ubicaciones mapean sedes físicas a conceptos de Cisco CUCM como Device Pools y rangos de números.
Concepto
Cada ubicación agrupa:
- Datos geográficos (ciudad, país, dirección) – también para enrutamiento de emergencia
- CUCM Device Pool – al que se asignan todos los dispositivos creados
- Rangos E.164 – de los que Easy UC toma números libres en el onboarding
- Package por defecto – la configuración que reciben los nuevos usuarios por defecto
- Reglas de asignación – la lógica para asignar usuarios a esta ubicación
Tres modos de asignación
Custom User Field
Evaluación de un atributo LDAP (p. ej. department, physicalDeliveryOfficeName). Recomendado para estructuras HR claras.
Phone Numbers
Asignación según el número ya asignado (rango E.164). Recomendado con plan existente.
Modo normal
Asignación manual desde la interfaz Easy UC. Recomendado para casos especiales o grupos piloto.
Crear ubicación
Navegar a Configuration → Locations
En la interfaz de admin pulse "+ New Location".
Introducir datos maestros
Nombre, país, ciudad, dirección (para Emergency Calling), zona horaria e idioma.
Configurar mapeo CUCM
Asignar Device Pool, Common Device Configuration, Region, Date/Time Group, Calling Search Spaces.
Añadir rangos de números
Definir uno o más rangos E.164, p. ej. +4940604294800 – +4940604294899.
Elegir modo de asignación
Elegir y configurar Custom User Field, Phone Numbers o Normal Mode.
Asignar package por defecto
Qué package se aplica automáticamente a nuevos usuarios.
Packages y Templates
Los templates son snapshots de configuración de sus dispositivos CUCM. Los packages los agrupan lógicamente.
Entender los templates
Un template es un snapshot de un dispositivo CUCM existente. Easy UC lee la configuración completa y la guarda como plantilla. Al aprovisionar un nuevo dispositivo se copia el template y solo se sobrescriben los campos específicos del usuario (MAC, descripción, owner).
Se recomienda un template por tipo de dispositivo y ubicación:
- Templates IP Phone – Cisco 7841, 8841, 8851, 9971, etc.
- Templates Softphone – Jabber Windows (CSF), Mac (TCT), Mobile (TAB / BOT)
- Templates Remote Destination – para Single Number Reach
Crear template
- Cree un dispositivo de referencia en CUCM con la configuración deseada
- En Easy UC en Templates → New Template
- Elija el tipo y el dispositivo origen del clúster CUCM
- Easy UC lee la configuración y la guarda como template
- Nombre el template de forma significativa (p. ej.
HH_8841_Standard)
Copiar templates
Los templates pueden duplicarse entre ubicaciones – sin recrear un dispositivo de referencia. Al copiar, los campos específicos (Device Pool, CSS, Locations) se adaptan al destino.
Entender los packages
Un package es un grupo lógico de templates. Ejemplos:
| Package | Contiene | Uso |
|---|---|---|
| Standard | IP Phone 8841 | Empleados regulares |
| Manager | IP Phone 8851 + Jabber Win + SNR | Nivel directivo |
| Mobile | Jabber Win + Jabber Mobile | Comerciales externos |
| Reception | IP Phone 9971 + Pickup Group | Recepción |
Por ubicación se puede definir un package por defecto, que se usa automáticamente durante Auto User Setup.
Gestión de usuarios
La página central de usuario muestra todos los aspectos de un usuario CUCM en un solo lugar.
Datos básicos
En <em>User Basics</em> gestiona las propiedades centrales de un usuario que normalmente se mantienen vía la interfaz admin de CUCM:
| Campo | Descripción |
|---|---|
| Telefon-PIN | 4–8 dígitos, para voicemail y Extension Mobility |
| Password | Para CUCM Self-Care y login de Jabber (solo usuarios locales) |
| Home Cluster | En entornos multi-clúster, el CUCM primario |
| IM & Presence | Activa las funciones de chat de Jabber |
| User Locale | Idioma y locale para los menús del teléfono |
| Roles | Roles de permisos CUCM (Standard CCM End User, etc.) |
Directory Number Settings
Cada Directory Number asignado tiene sus propios ajustes:
- Display Caller ID – Cómo se muestra al receptor
- External Phone Number Mask – Máscara para llamadas salientes
- Call Forward – No Answer, Busy, All Calls (destino y buzón)
- Voicemail Profile – Qué perfil Unity está activo
- Calling Search Space – Qué rutas puede usar este número
- Maximum Number of Calls / Busy Trigger – Comportamiento de llamada
Dispositivos
Por usuario se pueden asignar tantos dispositivos como desee – teléfonos IP, softphones y Remote Destinations.
Añadir dispositivo
Abrir el usuario
Navegue al usuario, pulse la pestaña "Devices".
Pulse "+ Add Device"
Elija el tipo y el template correspondiente (p. ej. HH_8841_Standard).
Introducir dirección MAC
Los IP phones requieren MAC. Para softphones, Easy UC genera un device ID único automáticamente.
Iniciar aprovisionamiento
Easy UC copia el template, ajusta los campos del usuario y crea el dispositivo en CUCM. Duración: 2–5 s.
Phone Recreation
Si un dispositivo se borró por error en CUCM, puede restaurarse con un clic vía Recreate. Easy UC guarda la última configuración conocida y la repone 1:1.
Pickup y Hunt Groups
Pickup Groups y Hunt Groups son conceptos CUCM para distribuir llamadas. Easy UC simplifica su gestión.
Pickup Groups
Una Pickup Group permite contestar una llamada que suena en el teléfono de un compañero – con combinación de teclas o softkey.
- En el perfil del usuario en "Pickup Groups" se puede asignar a una o varias grupos
- Las nuevas Pickup Groups se crean en CUCM y están disponibles enseguida
- Easy UC muestra los miembros asignados de cada Pickup Group
Hunt Groups
Una Hunt Group distribuye llamadas entrantes entre varios miembros (Sequential, Longest Idle, Broadcast, Circular).
- Hunt Pilot, Hunt List y Line Group se gestionan conjuntamente vía Easy UC
- Los miembros se añaden o eliminan con arrastrar y soltar
- Easy UC muestra para cada usuario de un vistazo en qué Hunt Groups participa
Call Detail Records (CDRs)
CUCM crea un CDR para cada llamada. Easy UC importa estos datos y los muestra directamente en el perfil de usuario.
Fuente de datos
CUCM envía los CDRs a Easy UC por FTP/SFTP. En CUCM, en Serviceability → CDR Management, se añade Easy UC como Billing Server. Easy UC importa los archivos cada hora y los procesa en la base de datos interna.
Análisis
- Por usuario – historial de llamadas en el perfil
- Hunt Group Reporting – Cantidad de llamadas, quién contestó, tiempo medio de espera
- Informes globales – Top llamantes, destinos, utilización por ubicación
Quick Tasks
Las tareas recurrentes están disponibles como Quick Tasks – completadas con pocos clics.
Copy User
Crea un usuario nuevo con la configuración de uno existente. Ideal para "Persona X pasa al mismo puesto que Persona Y".
Delete User
Elimina un usuario junto con todos los dispositivos, grupos y buzón. Con confirmación y registro de auditoría.
Replace User
Transfiere todos los dispositivos y configuraciones de un usuario a otro. Ejemplo: el empleado A se va, B asume el rol.
Copy User – paso a paso
- Seleccione el usuario origen
- Pulse Quick Tasks → Copy User
- Seleccione el usuario destino (debe existir en LDAP)
- Seleccione qué elementos se copian:
- ☑ Devices & Templates
- ☑ Directory Number Settings
- ☑ Pickup Groups / Hunt Groups
- ☐ Buzón de voz (aprovisionamiento separado recomendado)
- Confirme – Easy UC ejecuta todos los pasos automáticamente
Auto User Setup
En cuanto un nuevo usuario se importa en CUCM vía LDAP, Easy UC aprovisiona automáticamente todos los recursos.
Flujo
El sync LDAP detecta nuevo usuario
Durante el sync LDAP regular de CUCM (típicamente cada 6h) Easy UC detecta el nuevo usuario.
Asignación de ubicación
Según las reglas configuradas (Custom Field / Phone Number) se determina la ubicación.
Aplicar package
Se aplica el package por defecto. Opcionalmente puede usarse otro según un atributo LDAP (p. ej. title = Manager → package Manager).
Crear dispositivos
Todos los dispositivos del package se crean en CUCM: IP phone (si se conoce la MAC), softphones Jabber, Remote Destinations.
Crear buzón
Si está habilitado, se crea automáticamente un buzón en Unity Connection.
Informe por correo
Easy UC envía un informe diario al grupo de admins con todas las acciones.
Sincronizar cambios de nombre en LDAP
Cuando se renombra un usuario en LDAP (matrimonio, divorcio, etc.), Easy UC lo detecta en el siguiente sync y actualiza automáticamente:
- Display Name en todos los dispositivos del usuario
- Configuración de Caller ID
- Display Caller ID en Hunt Groups donde el usuario es miembro
- Display name del buzón
Wizard / Operaciones masivas
Para despliegues grandes o cambios de ubicación, Easy UC ofrece un wizard para acciones masivas.
Seleccionar usuarios
Por CSV
Suba un CSV con una columna "userid" (o "mail"). Easy UC empareja los usuarios y los añade a la selección.
userid,department,location
mmueller,Sales,Hamburg
aschmidt,Marketing,Berlin
tklein,Support,Hamburg
Seleccionar manualmente
Añada usuarios individualmente mediante la búsqueda. Filtros por ubicación, departamento o tipo de dispositivo posibles.
Acciones masivas
- Apply Package – Aplicar un package a todos los seleccionados
- Move Location – Cambio de ubicación para todos (incl. nuevo número)
- Change Template – Cambiar template en todos los dispositivos
- Add to Pickup/Hunt Group – Asignación masiva a grupos
- Mass Voicemail Reset – Restablecer PINs, reinicializar buzones
Buzón de voz
Los buzones de voz de Cisco Unity Connection se gestionan directamente desde Easy UC.
Crear buzón
- En el perfil → pestaña "Voicemail"
- Pulse "Create Voicemailbox"
- Elija template (p. ej.
Standard_EScon idioma español y saludos por defecto) - La extensión se toma del número principal automáticamente
- El PIN inicial se genera automáticamente y puede enviarse por correo
Saludos
Easy UC permite subir y asignar saludos del buzón de forma central:
- Saludo estándar – Saludo regular
- Saludo cerrado – Fuera de horario
- Saludo ocupado – Cuando la línea está ocupada
- Saludo interno – Solo audible para llamantes internos
- Saludo alternativo – P. ej. vacaciones
Acceso al buzón
Easy UC ofrece la quick action "Send Mailbox Access Link" – envía un correo con credenciales y un enlace directo a la interfaz web de Unity Connection.
Plan de numeración
El plan visual muestra todos los números de su clúster CUCM de un vistazo.
Funciones
- Filtro por ubicación – Mostrar solo números de la ubicación elegida
- Estado – Libre / Usado / Reservado / Hunt Pilot / Conference Bridge, etc.
- Asignación – Quién tiene el número, qué dispositivo
- Vista de rangos libres – Ver de un vistazo dónde hay huecos
- Reserva masiva – Reservar varios números a la vez para un proyecto
Escribir números en LDAP
Easy UC puede escribir automáticamente los números asignados en el atributo LDAP telephoneNumber (o un campo configurable). Así el directorio se mantiene consistente y Outlook / Teams muestran los números correctos.
Tareas diarias de aprovisionamiento
Las tareas de aprovisionamiento más frecuentes explicadas paso a paso.
Crear usuario
La creación habitual va por LDAP sync y Auto User Setup. Creación manual:
- Users → New User
- Introducir UserID (único) y display name
- Elegir ubicación y package
- Ajustar requisitos especiales (PIN, idioma, permisos)
- "Create" – Easy UC crea usuario y dispositivos en CUCM
Cambiar número
- Abrir usuario → pestaña "Directory Number"
- Elegir número actual del desplegable → "Change Number"
- Elegir nuevo número del pool (solo se ven libres)
- Opcional: marcar "Actualizar LDAP"
- Confirmar – Easy UC actualiza la DN en todos los dispositivos y en CUCM
Cambiar nombre en los teléfonos
Easy UC actualiza el display name (p. ej. tras matrimonio) en todos los dispositivos y grupos con un clic. Quick Tasks → Update Display Name.
Configurar Call Forward
- Abrir usuario → pestaña "Directory Number"
- En "Call Forward" elija un perfil (All Calls / Busy / No Answer)
- Introduzca número destino (externo: con prefijo, interno: solo extensión)
- "Voice Mail" como destino se elige directamente con checkbox
- Save – la configuración CUCM se actualiza inmediatamente
Configurar Single Number Reach
SNR permite que una llamada entrante al número de oficina suene también en el móvil en paralelo:
- Abrir usuario → pestaña "Remote Destinations"
- "+ Add Remote Destination" → indique móvil
- Opcional: definir horario (p. ej. Lun-Vie 08:00–18:00)
- Elegir template
Mobile_SNR_Standard - Save – SNR se activa al instante
Añadir Pickup / Hunt Group
Abrir usuario → pestaña "Groups" → seleccionar grupo por búsqueda → "Add". Easy UC actualiza la lista de miembros en CUCM en tiempo real.
IP Phone sin usuario
Para teléfonos de sala de reuniones, lobby, etc. se pueden crear dispositivos sin usuario:
- Devices → New Device → Standalone
- Elegir template, indicar MAC
- Pongan descripción (p. ej. "Sala Luna, planta 4")
- Opcional: pertenencia a Pickup o Hunt Group
Portal de usuario final
El portal de autoservicio da a los usuarios finales control sobre su propia configuración – sin tickets de TI.
Funciones para usuarios
Solicitar softphone
Los empleados solicitan Jabber Windows / Mac / iOS / Android por sí mismos. Easy UC crea el softphone automáticamente y envía instrucciones de instalación.
Single Number Reach
Redirigir llamadas a la oficina al móvil en paralelo. Con horario y botón de activación.
Directorio personal
Añadir contactos personales, agruparlos y sincronizarlos en todos los dispositivos.
Bloquear números
Bloquear llamantes no deseados por autoservicio – sin ticket de TI.
Marcaciones rápidas
Asignar teclas de marcación rápida en el IP Phone usted mismo – sin acceso admin CUCM.
Multilingüe
Portal disponible en alemán e inglés – más idiomas bajo petición.
Autenticación
El login es vía LDAP/AD (SSO) o vía SAML/OAuth con su Identity Provider (Azure AD, Okta, Keycloak). Opcionalmente con credenciales de usuario final CUCM.
Configurar permisos
Puede configurar por ubicación o grupo qué funciones están disponibles. Por ejemplo, los comerciales pueden activar SNR ellos mismos, mientras que el personal interno solo puede configurar marcaciones rápidas.
Dashboard y Logs
El dashboard de Easy UC ofrece una visión general del entorno en todo momento.
Logs de Easy UC
Todas las actividades del sistema quedan registradas:
- Provisioning Log – Qué dispositivos/usuarios se crearon/cambiaron/eliminaron y cuándo
- Admin Audit – Quién inició sesión y qué cambios de configuración hizo
- System Log – Errores de conexión, reinicios de servicios, actualizaciones
- API Calls – Llamadas API entrantes y salientes (para troubleshooting)
Automatically Setup Log
Log especial para Auto User Setup. Muestra para cada aprovisionamiento automático:
- Momento del sync LDAP
- Nuevos usuarios detectados
- Asignación de ubicación y package aplicada
- Dispositivos creados con estado de éxito/error
- Informes por correo enviados
Historial de registro de teléfonos
¿Qué teléfonos están registrados en CUCM? Easy UC lo recoge vía la API RIS:
- Estado: Online / Offline / Unregistered
- Última hora de registro
- Dirección IP del teléfono
- Versión de firmware
- Puerto de switch conectado (LLDP)
Resolución de problemas
Conexión AXL falla
Causa: Credenciales erróneas o permisos faltantes del usuario de servicio.
Solución: Verifique en CUCM que el Application User tiene los roles Standard AXL API Access, Standard CCM Admin Users y Standard CTI Enabled. La contraseña no debe contener caracteres especiales que requieran URL-encoding.
El sync LDAP no encuentra usuarios
Causa: Search-Base demasiado restrictivo o bind user sin permisos de lectura.
Solución: Use una OU superior, pruebe con ldapsearch desde la consola Easy UC, revise permisos del bind user.
Disco lleno
Causa: Los CDRs o logs llenan el disco.
Solución: Ajuste retenciones en System → Retention, o amplíe el disco según "Ampliación de disco".
El webinstaller no arranca
Causa: Versión obsoleta o instalación corrupta.
Solución: En la consola ejecute sudo systemctl restart easyuc-webinstaller. Si persiste, contacte con soporte.
El teléfono muestra "Configuration mismatch"
Causa: La configuración del template en Easy UC difiere de la TFTP en CUCM.
Solución: En CUCM pulse el teléfono → "Apply Config" → "Reset". Easy UC sincroniza la configuración en segundo plano.
¿Necesita más ayuda?
Nuestro equipo de soporte le ayuda con cualquier duda. Durante la fase demo el soporte es totalmente gratuito. → Contactar