Actualización de CallCenter Community a RC 5.1.1
Issabel 5
Actualización desde una versión anterior
Cuando ya existe una versión anterior de CallCenter Community para Issabel 5 instalada en el servidor, se recomienda realizar una actualización controlada de la plataforma.
El procedimiento consiste en:
Desinstalar de forma controlada la versión anterior.
Conservar la base de datos existente.
Eliminar el código fuente anterior.
Descargar la versión actualizada desde el repositorio oficial.
Instalar la nueva versión CallCenter Community RC 5.1.1.
Verificar posteriormente el funcionamiento del CallCenter.
Compatibilidad con Asterisk
La versión CallCenter Community RC 5.1.1 está orientada principalmente a Issabel 5 con Asterisk 18 o superior.
Asterisk 18 o superior
La combinación recomendada para esta versión es:
Issabel 5 + Asterisk 18 o superior + CallCenter Community RC 5.1.1
Esta es la plataforma sobre la cual se está realizando la validación principal de la nueva versión.
Por lo tanto, para instalaciones nuevas o sistemas de producción, se recomienda utilizar Asterisk 18 o superior.
Compatibilidad con Asterisk 16
Es posible realizar una adaptación del instalador para intentar instalar CallCenter Community RC 5.1.1 sobre Asterisk 16.
Sin embargo, esta modalidad requiere realizar modificaciones en el script de instalación, debido a las diferencias existentes entre las versiones de Asterisk.
Actualmente, la compatibilidad con Asterisk 16 debe considerarse experimental.
La instalación sobre Asterisk 16:
Requiere modificaciones en el script de instalación.
No corresponde al procedimiento estándar documentado en este manual.
Todavía no está completamente comprobada.
Faltan realizar pruebas adicionales de compatibilidad.
No se puede garantizar actualmente el funcionamiento completo y estable de todas las funciones.
No se recomienda utilizar esta combinación en producción hasta finalizar las pruebas correspondientes.
IMPORTANTE: Aunque técnicamente se puede adaptar el instalador para Asterisk 16, actualmente no se considera una plataforma completamente validada para CallCenter Community RC 5.1.1. Para instalaciones de producción se recomienda utilizar Asterisk 18 o superior.
Recomendación antes de actualizar
Antes de iniciar el proceso, se recomienda realizar un respaldo completo del servidor o, como mínimo, de la información relacionada con CallCenter.
Se recomienda respaldar:
Base de datos del CallCenter.
Configuración de campañas.
Agentes.
Configuración de extensiones.
Configuración de Asterisk.
Grabaciones, si corresponde.
Cualquier modificación personalizada realizada en el sistema.
Aunque el procedimiento está diseñado para conservar la información existente, el respaldo es una medida de seguridad fundamental antes de realizar una actualización.
RECOMENDACIÓN: Realizar la actualización preferiblemente durante una ventana de mantenimiento, evitando llamadas activas o campañas en ejecución.
- Ejecutar el script de desinstalación
Ingresar al directorio donde se encuentra el instalador de la versión anterior:
cd /usr/src/callcenter-issabel5
Verificar que el directorio exista:
ls -la
Debe encontrarse allí el código fuente de la versión actualmente instalada.
Dar permisos al script de desinstalación
Ejecutar:
chmod +x build/5.0/remove-issabel-callcenter.sh
Ejecutar la desinstalación
Ejecutar:
./build/5.0/remove-issabel-callcenter.sh
Durante la ejecución, el sistema mostrará las opciones disponibles para la eliminación o conservación de la información existente.
- Conservar la base de datos
Este es uno de los pasos más importantes de todo el procedimiento.
Durante la ejecución del script de desinstalación, cuando el sistema solicite información relacionada con la base de datos, se debe seleccionar la opción que permita:
Conservar la base de datos existente.
No se debe seleccionar una opción que elimine la base de datos si el objetivo es actualizar el CallCenter conservando la información existente.
Al conservar la base de datos se busca mantener información como:
Campañas.
Agentes.
Configuraciones.
Listas.
Registros.
Información histórica.
Datos utilizados por el CallCenter.
Información necesaria para los reportes.
ADVERTENCIA: La eliminación de la base de datos puede provocar la pérdida de información histórica y configuración del CallCenter.
- Esperar a que finalice la desinstalación
Una vez ejecutado:
./build/5.0/remove-issabel-callcenter.sh
esperar a que el proceso termine completamente.
Revisar los mensajes mostrados por el instalador y comprobar que no existan errores críticos.
Si aparecen errores
Si el proceso muestra errores importantes durante la desinstalación, no continuar inmediatamente con los siguientes pasos.
En ese caso se recomienda:
Guardar el mensaje de error.
Revisar el estado del sistema.
Comprobar que la base de datos continúe disponible.
Analizar el problema antes de eliminar el directorio anterior.
4. Eliminar el directorio del instalador anterior
Una vez confirmada la correcta finalización de la desinstalación, eliminar el código fuente anterior:
rm -rf /usr/src/callcenter-issabel5
ADVERTENCIA: Este comando elimina permanentemente el directorio /usr/src/callcenter-issabel5. Ejecutarlo solamente después de comprobar que la desinstalación terminó correctamente y que la información necesaria fue conservada y respaldada.
Este comando elimina el código fuente del instalador anterior, no debe utilizarse para eliminar manualmente la base de datos del CallCenter.
- Descargar la nueva versión
Ingresar nuevamente al directorio /usr/src:
cd /usr/src
Clonar el repositorio actualizado:
git clone https://github.com/ISSABELPBX/callcenter-issabel5.git
Una vez finalizada la descarga, ingresar al directorio:
cd callcenter-issabel5
6. Preparar el instalador
Dar permisos de ejecución al script de instalación:
chmod +x build/5.0/install-issabel-callcenter.sh
Comprobar que el archivo exista:
ls -l build/5.0/install-issabel-callcenter.sh
7. Instalar CallCenter Community RC 5.1.1
Ejecutar el instalador en modo local:
./build/5.0/install-issabel-callcenter.sh --local
El instalador realizará las operaciones necesarias para instalar la nueva versión de CallCenter Community RC 5.1.1.
Durante el proceso:
No interrumpir la ejecución.
Revisar los mensajes mostrados en pantalla.
Prestar atención a errores.
Esperar a que el instalador finalice completamente.
IMPORTANTE: No cerrar la sesión SSH ni reiniciar el servidor mientras el instalador esté ejecutando operaciones críticas, salvo que el propio instalador lo solicite.
- Verificación posterior de la instalación
Una vez finalizado el instalador, ingresar al panel web de Issabel.
Comprobar que el módulo:
CallCenter
esté disponible correctamente.
La actualización no debe considerarse finalizada solamente porque el módulo aparezca en el menú. Se deben realizar pruebas funcionales.
- Verificar campañas
Ingresar al módulo CallCenter y comprobar que las campañas existentes continúen disponibles.
Revisar:
Nombre de las campañas.
Estado.
Agentes asociados.
Listas.
Parámetros de campaña.
Horarios.
Configuración de marcación.
Configuración específica de cada campaña.
10. Verificar agentes
Comprobar que los agentes existentes continúen disponibles.
Revisar:
Usuarios.
Extensiones.
Agentes.
Campañas asignadas.
Estado de los agentes.
Configuración relacionada con el CallCenter.
Realizar una prueba de inicio de sesión de un agente para confirmar que pueda trabajar normalmente.
- Verificar listas y registros
Comprobar que las listas utilizadas por las campañas continúen disponibles.
Verificar:
Contactos.
Números telefónicos.
Estados.
Registros procesados.
Información de campañas.
Esto es especialmente importante cuando el servidor contiene campañas que ya tienen información histórica.
- Verificar información histórica
Comprobar que la información histórica continúe disponible después de la actualización.
Según la configuración utilizada, revisar:
Llamadas realizadas.
Llamadas recibidas.
Registros de campañas.
Estados de llamadas.
Resultados.
Información de agentes.
Datos utilizados para reportes.
La conservación de estos datos depende principalmente de que durante la desinstalación se haya seleccionado correctamente la opción de conservar la base de datos.
- Verificar Asterisk y servicios relacionados
Después de finalizar la actualización, comprobar que los servicios relacionados continúen funcionando correctamente.
Se recomienda verificar el estado de Asterisk:
systemctl status asterisk
También se puede comprobar que Asterisk responda correctamente:
asterisk -rx "core show version"
Si el servicio está funcionando, debe mostrar la información correspondiente de la versión instalada.
NOTA: Estos comandos se incluyen como herramientas de diagnóstico posteriores a la actualización y no como una validación obligatoria que impida utilizar Asterisk 16.
- Realizar pruebas de llamadas
Después de la actualización se deben realizar pruebas reales de funcionamiento.
Llamadas salientes
Realizar una llamada desde una campaña y comprobar:
Marcación.
Establecimiento de llamada.
Audio.
Identificación de la llamada.
Estado del agente.
Finalización.
Registro de la llamada.
Llamadas entrantes
Si la instalación utiliza llamadas entrantes, comprobar:
Entrada de la llamada.
Entrega al agente.
Audio.
Estado del agente.
Finalización.
Registro de la llamada.
15. Verificar el funcionamiento de las campañas
Realizar una prueba completa de una campaña.
El flujo recomendado es:
Campaña
↓
Lista de contactos
↓
Marcación
↓
Llamada
↓
Agente
↓
Conversación
↓
Finalización
↓
Registro
↓
Reporte
Comprobar que todo el flujo funcione correctamente.
- Verificar reportes
Ingresar a las opciones de reportes del CallCenter y comprobar que la información esté disponible.
Revisar que los reportes puedan consultar correctamente:
Llamadas.
Agentes.
Campañas.
Resultados.
Estados.
Información histórica.
Si los reportes dependen de información histórica, comprobar especialmente que los datos anteriores a la actualización continúen disponibles.
- Verificación final
Antes de considerar terminada la actualización, se recomienda realizar la siguiente lista de comprobación:
Plataforma
Issabel 5 funcionando correctamente.
Asterisk funcionando.
CallCenter Community RC 5.1.1 instalado.
CallCenter
Módulo CallCenter disponible.
Campañas disponibles.
Agentes disponibles.
Listas disponibles.
Configuración conservada.
Información histórica disponible.
Reportes funcionando.
Telefonía
Llamadas salientes funcionando.
Llamadas entrantes funcionando.
Audio correcto.
Agentes reciben llamadas.
Las llamadas se registran correctamente.
Procedimiento resumido
El procedimiento completo de actualización es:
1. Entrar al directorio del instalador anterior
cd /usr/src/callcenter-issabel5
2. Dar permisos al desinstalador
chmod +x build/5.0/remove-issabel-callcenter.sh
3. Desinstalar la versión anterior
./build/5.0/remove-issabel-callcenter.sh
IMPORTANTE:
Cuando solicite conservar la base de datos,
seleccionar la opción para conservarla.
4. Eliminar el instalador anterior
rm -rf /usr/src/callcenter-issabel5
5. Ir a /usr/src
cd /usr/src
6. Descargar la nueva versión
git clone https://github.com/ISSABELPBX/callcenter-issabel5.git
7. Entrar al nuevo instalador
cd callcenter-issabel5
8. Dar permisos de ejecución
chmod +x build/5.0/install-issabel-callcenter.sh
9. Instalar CallCenter Community RC 5.1.1
./build/5.0/install-issabel-callcenter.sh --local
10. Comprobar Asterisk después de la instalación
systemctl status asterisk
11. Comprobar que Asterisk responda
asterisk -rx "core show version"
Compatibilidad y recomendaciones
Componente Situación
Issabel 5 Plataforma objetivo
Asterisk 18 o superior Recomendado y principal plataforma de validación
Asterisk 16 Posible mediante modificación del instalador
Asterisk 16 + RC 5.1.1 Experimental / pendiente de más pruebas
Base de datos existente Debe conservarse durante la actualización
Respaldo Altamente recomendado antes de actualizar
Servidor de producción Utilizar preferentemente Asterisk 18 o superior
Consideración especial para Asterisk 16
La posibilidad de ejecutar CallCenter Community RC 5.1.1 sobre Asterisk 16 no debe confundirse con una compatibilidad completamente validada.
Para Asterisk 16 es necesario modificar el proceso de instalación y realizar pruebas adicionales.
Actualmente se considera:
Asterisk 16 → Adaptación posible → Requiere cambios en el script → Compatibilidad pendiente de validación completa.
Por este motivo, si se necesita instalar RC 5.1.1 en un servidor con Asterisk 16, se recomienda realizar primero pruebas en un entorno de laboratorio.
Una vez confirmada la estabilidad de:
Registro de agentes.
Campañas.
Marcación.
Llamadas.
Audio.
Estados.
Reportes.
Procesamiento de llamadas.
Integración con Asterisk.
podrá determinarse si la combinación puede utilizarse de forma confiable en producción.
Resultado esperado
Al finalizar correctamente el procedimiento, el servidor deberá disponer de:
Issabel 5
CallCenter Community RC 5.1.1
manteniendo la información existente del CallCenter, siempre que durante la desinstalación se haya seleccionado correctamente la opción de conservar la base de datos.
La plataforma recomendada para producción es:
Issabel 5 + Asterisk 18 o superior + CallCenter Community RC 5.1.1
La utilización de Asterisk 16 queda actualmente como una alternativa experimental que requiere modificaciones del instalador y pruebas adicionales de compatibilidad.
