Backups (UCS) y QKview
Resumen
El UCS es el respaldo completo del BIG-IP: configuración, licencia, hostname, IP de gestión, usuarios, certificados y llaves privadas. Sirve para volver atrás después de un cambio o upgrade fallido, para recuperarse de un desastre y para configurar un equipo de reemplazo (RMA). El QKview es otra cosa: una foto de configuración, logs y estadísticas que se sube a iHealth o se envía a soporte para diagnóstico. Esta nota cubre crear, cifrar, guardar fuera del equipo y restaurar un UCS, y generar un QKview.
Requisitos previos
- Espacio en disco (
df -h) - Una passphrase segura para cifrar el UCS
- Un lugar fuera del BIG-IP para guardar los UCS (servidor de backups)
- Cuenta en my.f5.com para usar iHealth
Conceptos clave
| Concepto | Qué es |
|---|---|
| UCS | Backup completo; se guarda en /var/local/ucs/ |
| Passphrase | Cifra el UCS |
| no-private-key | Crea el UCS sin llaves privadas (para enviarlo a F5) |
| no-license | Restaura sin sobrescribir la licencia (equipos RMA) |
| QKview | Diagnóstico para iHealth/soporte; se guarda en /var/tmp/ |
| iHealth | ihealth.f5.com: analiza el QKview (heurísticas, problemas conocidos, objetos sin uso, upgrade advisor) |
El UCS contiene secretos
Incluye llaves privadas y hashes de contraseñas. Cífralo y no lo dejes solo en el BIG-IP: si el equipo muere, el respaldo muere con él.
Configuración (Ejemplo, Lab CBT Nuggets)
1. Crear un UCS desde la GUI
System > Archives > Create > File Name: bigip1-antes-del-cambio > Encryption: Enabled > Passphrase y confirmación > Finished.
2. Crear un UCS por tmsh
tmsh save /sys ucs bigip1-2026-10-26.ucs passphrase <clave>
tmsh save /sys ucs soporte-f5.ucs passphrase <clave> no-private-key
tmsh list /sys ucs
3. Copiarlo fuera del equipo
Desde la GUI: System > Archives > el archivo > Download. O por SCP desde tu PC:
scp root@192.168.121.11:/var/local/ucs/bigip1-2026-10-26.ucs .
4. Restaurar
GUI: System > Archives > el archivo > Passphrase > Restore. Si lo pide, reinicia: System > Configuration > Device > General > Operations: Reboot.
tmsh load /sys ucs bigip1-2026-10-26.ucs passphrase <clave>
tmsh load /sys ucs bigip1-2026-10-26.ucs passphrase <clave> no-license
Usa no-license cuando restauras en un equipo de reemplazo (RMA): así conserva su propia licencia.
5. Generar un QKview y subirlo a iHealth
- System > Support > New Support Snapshot > Generate QKview > Download.
- En ihealth.f5.com > Uploads > Upload > elige el archivo.
- Revisa Diagnostics (problemas por severidad) y Config Explorer → Unused Objects (objetos huérfanos).
tmsh run /util qkview
ls -lh /var/tmp/*.qkview
Verificación
| Comando o lugar | Qué debes ver | Si no lo ves |
|---|---|---|
tmsh list /sys ucs | El UCS con fecha y tamaño | Repite el paso 1 o 2 |
| Servidor de backups | Copia del UCS fuera del equipo | Paso 3 |
| Después de restaurar | Objetos y estado iguales al momento del backup | Revisa /var/log/ltm |
| iHealth | El QKview procesado con su diagnóstico | Revisa que el archivo no esté truncado |
Errores comunes
La restauración falla con error de versión
- Causa: el UCS se creó en otra versión de software.
- Solución: restaura en la misma versión (o sigue el procedimiento de F5 para otra versión).
Después de restaurar en un equipo nuevo la licencia quedó inválida
- Causa: se restauró la licencia del equipo viejo.
- Solución: restaura con
no-licensey reactiva la licencia del equipo nuevo.
No recuerdo la passphrase
- Causa: UCS cifrado sin passphrase documentada.
- Solución: no hay forma de abrirlo. Guarda la passphrase en el gestor de contraseñas del equipo.
Envié el UCS a soporte con llaves privadas
- Causa: no se usó
no-private-key. - Solución: para soporte usa QKview o un UCS con
no-private-key; si una llave se expuso, renueva el certificado.