Migrar de ViciBox a VICIdial administrado
Qué mueve en realidad la migración automática desde ViciBox, qué deja en el servidor anterior, qué reconstruye a mano y qué ventana de cambio reservar.
Antes de los pasos, conviene aclarar algo, porque cambia lo que es esta página. ViciBox es una ISO de instalación gratuita basada en openSUSE, publicada por los mantenedores de VICIdial; no es un servicio de hosting. La comparación VICIfast vs ViciBox lo explica en detalle, y el hosting del mismo grupo se vende por separado como VICIhost. Así que "migrar desde ViciBox" significa mover un servidor que usted o su proveedor construyeron a partir de esa ISO. El software de fondo es VICIdial estándar, y por eso casi todo esto se puede automatizar.
Tenemos una migración automática exactamente para esto: Migrar desde ViciBox, que se ejecuta desde el panel del servidor. No es un traslado de un clic ni sin tiempo de inactividad, y esta página es el relato honesto de dónde están realmente el trabajo y la inactividad.
Qué se transfiere
El destino extrae un mysqldump directamente de su servidor de origen por SSH y lo importa. Lo que llega:
- Campañas y todas las tablas asociadas a cada campaña, listas, leads (
vicidial_list), sus tablascustom_<list>y las definiciones de campos de lista - Agentes (
vicidial_users) y sus grupos de usuarios - Estados y tipificaciones, incluidas sus categorías y grupos de estados
- Su lista DNC (
vicidial_dnc) - Grupos entrantes, DIDs entrantes y menús de llamada: sus árboles de IVR pasan tal cual
- Teléfonos con su identidad intacta: extensión, usuario, contraseña,
conf_secret, nombre completo, identificador de llamadas saliente y configuración del buzón de voz - Historial de llamadas:
vicidial_log,vicidial_closer_log,vicidial_agent_log,recording_log,call_logy sus gemelas_archive. Los reportes de fechas anteriores al cambio siguen funcionando - Registros de reloj de asistencia, de auditoría y de tiempo libre
- Scripts AGI no estándar de
/var/lib/asterisk/agi-bin. Los AGI estándar de VICIdial se omiten: el nuevo servidor ya trae versiones actuales - Grabaciones de
/var/spool/asterisk/monitor,/var/spool/asterisk/monitorDONEy/var/spool/asterisk/voicemail, además del almacén de audio bajo su webroot
Qué no se transfiere
El nuevo servidor manda sobre su propia identidad, así que estas tablas no se copian nunca, a propósito. Esta lista es donde las migraciones sorprenden a la gente:
- Sus carriers y troncales.
vicidial_carriers,vicidial_server_carriersyvicidial_server_trunksse omiten por completo. Nada de su conectividad SIP se mueve. /etc/asterisk. No se copia ningún archivo de ese directorio. Dialplan escrito a mano, contextos personalizados, unmanager.confeditado: nada de eso pasa. El nuevo servidor conserva la configuración con la que se aprovisionó.- Las tablas
servers,system_settings,web_servers, de conferencias y de plantillas de conferencia, los colores de pantalla y las tablas de la lista de IP permitidas (que se vacían, conallow_ip_listsforzado a desactivado). - El estado en ejecución: hopper, agentes en vivo, llamadas automáticas, canales estacionados, sesiones. Todo eso apunta a procesos de un servidor que usted está dejando.
- Los sonidos personalizados de
/var/lib/asterisk/sounds/custom. El sondeo mide ese directorio para que conozca su tamaño, pero nada lo copia. Muévalo usted si lo usa. - Su versión de VICIdial. El nuevo servidor ejecuta la serie VICIdial 2.14, tomada del trunk SVN del propio VICIdial cuando se preparó su imagen, sobre Asterisk 22.5.1 y Ubuntu 22.04. La revisión exacta queda registrada en el servidor, en
servers.svn_revision. La restauración conserva el esquema más nuevo del destino e importa sus filas en él. No obtiene su compilación anterior en hardware nuevo: obtiene sus datos en una compilación actual. - Sus DIDs. Esos están con su carrier, y siempre lo estuvieron.
Qué reconstruye
Reserve tiempo de verdad para esto. Esto es la migración.
- Troncales. Vuelva a agregar cada carrier en el nuevo servidor. El panel tiene plantillas de socios para los carriers más comunes; si no, son los mismos datos PJSIP que tenía su servidor anterior.
- La lista de IP permitidas del carrier. Su nuevo servidor tiene otra IP de salida. Hasta que su carrier la acepte, no se marca nada.
- Dialplan personalizado. Todo lo que tenía en
/etc/asteriskhay que volver a aplicarlo a mano. Cópielo del servidor anterior antes de cancelarlo. - Protocolo de los teléfonos. Todos los teléfonos migrados, salvo el
6666propio de la plataforma, pasan a PJSIP con la plantilla WebRTC yis_webphoneactivado. Los agentes que usan softphone en el navegador no tienen problema; quien use un teléfono físico con chan_sip tendrá que reconfigurarlo. - Todo lo que esté fuera del servidor y conociera su dirección: un CRM que lee directamente el MySQL anterior, webhooks, monitoreo, marcadores del navegador.
Orden de las operaciones
El panel recorre estos pasos como Conectar → Pegar clave → Revisión → Migrar → Sincronizar → Listo.
- Pida primero el servidor de destino. Tiene que estar recién creado: la restauración se niega a ejecutarse en un servidor que ya tenga historial de llamadas en
vicidial_logocall_log. El aprovisionamiento tarda unos 40 segundos. - Conectar. Ingrese el nombre de host de origen, el puerto SSH y el usuario. Generamos un par de claves ed25519 de un solo uso con un TTL de 15 minutos y le mostramos la mitad pública para que la agregue a
~/.ssh/authorized_keysen el origen. Si el firewall del origen nos bloquea, la pantalla muestra la IP de destino y reglas defirewall-cmd/iptableslistas para pegar. - Sondeo. De solo lectura, sin escrituras de ningún tipo. Lee las credenciales de la base de datos en
/etc/astguiclient.conf(las líneasVARDB_*) en lugar de pedírselas, luego hace el inventario de cada tablavicidial_*ycustom_*con conteos de filas y tamaños, mide los directorios de grabaciones y de buzón de voz, encuentra el almacén de audio bajo/srv/www/htdocso/var/www/html, calcula el hash de los scripts AGI no estándar, lee sus filas deservers, confirma Asterisk y la compilación de VICIdial, y comprueba que tenga al menos 10 GB libres en/var/tmp. Usted revisa ese manifiesto antes de que pase cualquier otra cosa. - Vacíe el origen. Aquí se deja de marcar. La copia no se ejecuta mientras
vicidial_live_agentstenga filas o alguna campaña esté enactive = 'Y': el proceso vuelve a comprobarlo al ejecutarse y se detiene. Cierre la sesión de todos los agentes y desactive todas las campañas. - Confirmar. Escriba
WIPEpara aceptar que la base de datos del destino está a punto de reemplazarse. Ese es el punto sin retorno para el destino, no para su origen. - Migrar. Se emite una segunda clave de un solo uso, esta con un TTL de 4 horas porque la sincronización de grabaciones la reutiliza. Luego el destino se conecta por SSH de vuelta a su origen y transmite
mysqldump | gzipdirectamente: sin almacenamiento de objetos en medio, sin archivo temporal en su origen, y con--skip-lock-tablespara que la base de datos de origen nunca se bloquee. Los scripts AGI no estándar viajan después en un tarball, y el almacén de audio va incluido si pesa menos de 500 MB. - Restauración. En el nuevo servidor: se detienen cron y los daemons de
astguiclientpara que el watchdog de keepalive no compita con la importación, primero se hace un volcado completo del destino en/var/tmp, se vacían las tablas del destino, se importan sus filas en el esquema del destino, se reponen las filas propias de la plataforma, se vuelve a ejecutarinstall.pl, se reescribe cada referencia aserver_ipde la IP anterior a la nueva, se reiniciavicidial.servicey se hace una prueba rápida del CLI de Asterisk y de un viaje de ida y vuelta a la base de datos. Si algo de eso falla, el destino se restaura desde el volcado hecho en el primer paso. - Sincronizar grabaciones. El destino las copia desde su origen con rsync y
--partial --append-verify, así que una ejecución interrumpida se reanuda en lugar de empezar de cero. Puede fijar un límite de ancho de banda. Esto corre en segundo plano: el nuevo servidor se puede usar mientras trabaja. - Hacer el cambio. Actualice la lista de IP permitidas de su carrier, apunte el DNS y los marcadores del navegador al nuevo nombre de host, y luego deje entrar a los agentes.
- Limpieza. Cuando la sincronización termina bien, quitamos nuestras propias claves públicas del
authorized_keysde su origen. Si ese paso no pudo llegar a su servidor, el panel le muestra el comandosedde una línea para que lo ejecute usted.
Límites que conviene conocer antes de empezar
- Las bases de datos muy grandes se rechazan. La herramienta estima el volcado a partir del tamaño de sus tablas y rechaza cualquier cosa que se proyecte por encima de unas dos horas, y en su lugar lo remite a soporte para una migración manual. El sondeo le dice el tamaño total de sus tablas, así que se entera antes de vaciar nada.
- Solo orígenes IPv4. No se admite un servidor de origen solo IPv6.
- Solo el propietario de la cuenta. Los subusuarios no pueden ejecutar una migración.
- No cancele a mitad de la copia. Una migración cancelada puede dejar el destino restaurado a medias, lo que obliga a un restablecimiento de fábrica antes de poder reintentar. Si algo sale mal, deje que falle por sí sola: revierte el destino por usted.
Sobre el tiempo de inactividad
No planifique esto como un traslado sin inactividad, porque no lo es. Se deja de marcar cuando vacía el origen en el paso 4, y no se vuelve a marcar hasta que su carrier acepta la nueva IP. Entre esos dos puntos están la copia de la base de datos (que crece con el tamaño de sus tablas, y en un servidor con años de uso domina vicidial_log), la restauración, la reconstrucción de sus troncales y lo que tarde su carrier en aplicar un cambio en la lista de IP permitidas. Las grabaciones son lo único que de verdad corre en segundo plano después.
Reserve una ventana de mantenimiento fuera del horario de marcación y conserve el servidor anterior hasta terminar las pruebas. El volcado que hacemos del destino antes de la importación protege al destino, no a sus datos: su plan de reversión es el servidor anterior, apagado pero intacto.
Qué probar antes de pasar a los agentes
- El admin carga por HTTPS, y los conteos de campañas, listas y leads coinciden con el manifiesto del sondeo
- Una llamada saliente por cada troncal que reconstruyó, no solo por la primera
- Una llamada entrante a cada DID e In-Group, incluidas sus rutas de IVR
- Una grabación se completa, llega a
monitorDONEy se reproduce desde el reporte - Un agente real inicia sesión en el teléfono que de verdad va a usar: recuerde el cambio a PJSIP/WebRTC
- Sus scripts AGI no estándar están presentes y son ejecutables en
/var/lib/asterisk/agi-bin - Un reporte sobre un rango de fechas anterior al cambio devuelve las mismas cifras que el servidor anterior
- El conteo de su lista DNC coincide con lo que encontró el sondeo
Próximos pasos
- VICIfast vs ViciBox: la ISO de instalación gratuita frente al hosting administrado, y dónde la ISO sigue ganando.
- Migrar desde ViciBox: la migración automática descrita arriba.
- Precios de VICIfast: la tabla de planes a la que llega, con cobro por servidor.
- Inicie una prueba: aprovisione el servidor de destino antes de vaciar nada.