Instalación

El instalador es install.sh. Es idempotente: puede ejecutarlo de nuevo después de una actualización para refrescar las units, los temporizadores y los paquetes.

1. Coloque el software en /opt/dtvsol

Desde un tarball de versión:

sudo mkdir -p /opt/dtvsol
sudo tar xzf dtvsol-router-<rev>.tar.gz -C /opt/dtvsol

O desde el repositorio al que se le dio acceso:

sudo git clone <repository-url> /opt/dtvsol

Copie los binarios con licencia que recibió en /opt/dtvsol/bin/: dtvsold y el driver de OLT dtvsol-olt-<vendor>.

2. Ejecute el instalador

cd /opt/dtvsol
sudo ./install.sh

Si el servidor todavía no tiene una dirección IPv4 con ruta por defecto, el instalador lista los puertos (nombre, MAC, enlace) y pide la interfaz, la dirección, el gateway y los servidores DNS. También puede indicarlos en la línea de comandos:

sudo ./install.sh --iface eno1 --ip XXX.XXX.XXX.10/24 --gw XXX.XXX.XXX.1 --dns XXX.XXX.XXX.53,XXX.XXX.XXX.54

Luego el instalador:

1. Instala los paquetes de Ubuntu.
2. Coloca los archivos en /opt/dtvsol y pone dtvsol en el PATH.
3. Activa el reenvío (forwarding) IPv4 e IPv6 y carga los módulos del kernel 8021q e ifb.
4. Escribe una configuración DHCP base (solo si no existe ninguna).
5. Instala las units de systemd, los temporizadores, las tareas de cron, el filtro y la jail de fail2ban, y el autocompletado con Tab para dtvsol.
6. Genera una clave de API aleatoria y la imprime una sola vez. Guárdela: su sistema de facturación la necesita.
7. Crea el usuario de sistema dtvsol (un acceso con sudo para los operadores).
8. Pasa la configuración a la base de datos data/dtvsol.db, guarda la configuración de red propia del router e inicia los servicios.
9. Configura chrony para que el router pueda servir la hora a sus OLT.

Al final imprime los siguientes pasos.

3. Asegure el equipo

Precaución

Haga esto antes de que el router entre en producción.

Defina su propia contraseña para el usuario dtvsol:

sudo passwd dtvsol

Agregue sus redes de administración al ignoreip de fail2ban, para que un operador que escriba mal una contraseña no quede bloqueado:

sudo nano /etc/fail2ban/jail.d/dtvsol.conf
sudo systemctl restart fail2ban

Permita que su NOC llegue a la API (puerto 8880) y al monitor (puerto 8881). Solo localhost está permitido hasta que usted agregue una red:

dtvsol protect add XXX.XXX.XXX.0/24 "NOC"
dtvsol protect list

4. Enrole la licencia

Use el id de router y el token que DTVSOL le entregó. Indique el token como - para escribirlo en lugar de dejarlo en el historial de la shell:

dtvsol licence enrol <router-id> -
dtvsol licence status

La licencia se renueva con un temporizador diario. Consulte Solución de problemas si reporta un problema.

5. Revise la configuración de red

El router guarda su propia red (puertos, bonds, sus direcciones, la ruta por defecto y el DNS) en la base de datos y escribe el archivo de netplan a partir de ella. El instalador guardó lo que encontró. Revíselo:

dtvsol netcfg show
dtvsol netcfg diff

Si el servidor ya tenía una red configurada a mano, impórtela una vez:

dtvsol netcfg import          # shows what would be stored, key by key
dtvsol netcfg import --save

Consulte Cambios de red antes de cambiar algo aquí.

6. Cree el primer usuario del monitor

El primer usuario debe ser un administrador (admin). Se le pedirá la contraseña dos veces:

dtvsol monitor user add alice admin
dtvsol monitor

dtvsol monitor imprime la dirección a abrir, por ejemplo https://XXX.XXX.XXX.10:8881/. El certificado es autofirmado: acéptelo una vez en el navegador. Consulte el monitor.

7. Configuración opcional

Si su sistema de facturación aprovisiona routers MikroTik, defina el acceso de MK-api. El instalador guarda una contraseña provisional que usted debe cambiar:

dtvsol mkapi set user billing password '<a-strong-password>'

Si monitorea con un NMS por SNMP:

dtvsol snmp set community '<secret>' location "POP 1" contact "noc@example.net"

8. Verifique el resultado

dtvsol version
dtvsol doctor --no-olt

dtvsol doctor no debe reportar hallazgos críticos. Continúe con Primeros pasos.

Actualización

Reemplace los archivos en /opt/dtvsol con la nueva versión (o git pull) y luego ejecute el instalador de nuevo:

cd /opt/dtvsol
sudo ./install.sh

Su configuración en data/ y sus logs en log/ se conservan.