VICIfast
ENES
Todas las migraciones

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 tablas custom_<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_log y 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/monitorDONE y /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_carriers y vicidial_server_trunks se 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, un manager.conf editado: 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, con allow_ip_lists forzado 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.

  1. 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.
  2. 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.
  3. Dialplan personalizado. Todo lo que tenía en /etc/asterisk hay que volver a aplicarlo a mano. Cópielo del servidor anterior antes de cancelarlo.
  4. Protocolo de los teléfonos. Todos los teléfonos migrados, salvo el 6666 propio de la plataforma, pasan a PJSIP con la plantilla WebRTC y is_webphone activado. Los agentes que usan softphone en el navegador no tienen problema; quien use un teléfono físico con chan_sip tendrá que reconfigurarlo.
  5. 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.

  1. 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_log o call_log. El aprovisionamiento tarda unos 40 segundos.
  2. 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_keys en el origen. Si el firewall del origen nos bloquea, la pantalla muestra la IP de destino y reglas de firewall-cmd / iptables listas para pegar.
  3. Sondeo. De solo lectura, sin escrituras de ningún tipo. Lee las credenciales de la base de datos en /etc/astguiclient.conf (las líneas VARDB_*) en lugar de pedírselas, luego hace el inventario de cada tabla vicidial_* y custom_* 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/htdocs o /var/www/html, calcula el hash de los scripts AGI no estándar, lee sus filas de servers, 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.
  4. Vacíe el origen. Aquí se deja de marcar. La copia no se ejecuta mientras vicidial_live_agents tenga filas o alguna campaña esté en active = '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.
  5. Confirmar. Escriba WIPE para 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.
  6. 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 | gzip directamente: sin almacenamiento de objetos en medio, sin archivo temporal en su origen, y con --skip-lock-tables para 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.
  7. Restauración. En el nuevo servidor: se detienen cron y los daemons de astguiclient para 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 ejecutar install.pl, se reescribe cada referencia a server_ip de la IP anterior a la nueva, se reinicia vicidial.service y 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.
  8. 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.
  9. 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.
  10. Limpieza. Cuando la sincronización termina bien, quitamos nuestras propias claves públicas del authorized_keys de su origen. Si ese paso no pudo llegar a su servidor, el panel le muestra el comando sed de 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 monitorDONE y 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

Más migraciones

El mismo VICIdial. Nosotros operamos el servidor.

Obtenga un servidor VICIdial dedicado en 40 segundos. Gratis durante 7 días.

Ver precios