vicidial_sapian/Custom

==========================================
BACKUP DE VICIBOX - AMBIENTE DE CONFIGURACIÓN
==========================================

Fecha de creación: Fri Feb  6 04:46:49 PM UTC 2026


INSTRUCCIONES RÁPIDAS (instalación automática):
----------------------------------------------
1. Instalar git zypper install git
2. git clone https://git.sapian.cloud/Sapian/vicidial_sapian.git (Se descargan los archivos instalador voe y custom)

1. Copiar este directorio al servidor destino, debe quedar en la ruta /home/ ej. /home/backvicibox).

2. Ejecutar el instalador (instala dependencias, restore, parches y express):
   cd /home/backvicibox
   sudo chmod +x install-vicibox.sh restore.sh apply-vicibox-patches.sh
   sudo ./install-vicibox.sh

   NOTA
   El script ./install-vicibox.sh ejecuta todos los sh necesarios para la instalacion

3. Revisar el log si algo falla: install-vicibox.log




ARCHIVOS INCLUIDOS:
-------------------
1. vicibox-scripts.tar.gz
   - Todos los scripts de instalación y configuración de Vicibox
   - Ubicación original: /usr/share/vicibox/

2. astguiclient-trunk.tar.gz
   - Código fuente completo de ViciDial
   - Ubicación original: /usr/src/astguiclient/trunk/

3. restore.sh
   - Script para restaurar los archivos en el servidor destino

4. install-vicibox.sh (NUEVO)
   - Instalación completa en orden: Perl → MariaDB → PHP → Apache
   - Instala php8-mbstring junto con PHP (evita fatal error UTF-8 en la web)
   - Configura Apache para apuntar a /vicidial/welcome.php
   - Ejecuta restore.sh, aplica parches a vicibox-install.pl y lanza --vicibox-express
   - Uso: sudo ./install-vicibox.sh

5. apply-vicibox-patches.sh (NUEVO)
   - Aplica parches a vicibox-install.pl (socket MySQL, random_pass, DBI)
   - Se usa automáticamente desde install-vicibox.sh si no existe patches/vicibox-install.pl

6. patches/
   - vicibox-install.pl: copia del instalador con parches ya aplicados (recomendado)
   - README.txt: descripción de los parches

7. version-info.txt
   - Información de versiones y sistema



INSTRUCCIONES MANUALES (paso a paso):
------------------------------------
1. Instalar dependencias: Perl (y DBI, DBD-mysql, LWP::Simple), Subversion,
   MariaDB, PHP 8 (y apache2-mod_php8, php8-mysql, php8-mbstring), Apache2.
2. Configurar Apache para que la URL principal sirva /vicidial/welcome.php.
3. Ejecutar: sudo ./restore.sh
4. Aplicar parches (copiar patches/vicibox-install.pl a /usr/share/vicibox/
   o ejecutar apply-vicibox-patches.sh).
5. Ejecutar: echo y | sudo /usr/share/vicibox/vicibox-install.pl --vicibox-express
6. En /etc/astguiclient.conf poner VARDB_server => 127.0.0.1 para la web.

REQUISITOS DEL SERVIDOR DESTINO:
--------------------------------
- Sistema operativo: openSUSE Leap / SUSE Linux Enterprise (SLE 15 SP6)
- install-vicibox.sh instala: Perl, DBI, DBD-mysql, libwww-perl, subversion,
  MariaDB, PHP 8 (incl. php8-mbstring), Apache2. Asterisk se gestiona por el
  instalador ViciBox.
- Acceso a internet (recomendado para repos y actualizaciones).

NOTAS:
------
- El tamaño total comprimido es aproximadamente 50-70 MB.
- Log de install-vicibox.sh: install-vicibox.log en este directorio.
- Log del instalador ViciBox: /var/log/vicibox.log.
- Acceso web tras instalación: http://<IP>/vicidial/welcome.php

PERMISOS DE USUARIOS VICIDIAL (pendiente de revisión):
------------------------------------------------------
Los usuarios de VICIdial no cuentan con permisos suficientes para poder
gestionar grupos. Se va a revisar qué es lo que sucede para encontrar una
solución.

SOLUCIÓN / INSTALADOR (mbstring y Apache):
------------------------------------------
La instalación de php8-mbstring y la recarga de Apache quedaron incorporadas
en install-vicibox.sh (paquete php8-mbstring en el mismo zypper install que PHP,
y systemctl reload apache2 tras ajustes de php.ini), para evitar el fatal error
por funciones multi-byte (UTF-8) en la interfaz web.

Si instalaste a mano o falta la extensión y la página se corta:

  sudo zypper in php8-mbstring

  Instala php8-mbstring (extensión mbstring): agrega funciones como mb_strlen()
  necesarias para UTF-8; sin ella VICIdial puede dar fatal error.

  sudo systemctl restart apache2

  Reinicia Apache para que PHP cargue mbstring recién instalada.

==========================================