Actualizar
Actualizar StreamVault Engine es un comando en el servidor. Esta página explica qué hace ese comando, qué garantiza, y qué pasa cuando su derecho a actualizaciones vence.
Por qué no hay un botón en el panel
El panel le enseña qué versión tiene, cuál es la última publicada, las notas de cada una y el comando exacto que hay que ejecutar. Lo que no hace es ejecutarlo.
Para que un botón del panel pudiera recrear los servicios habría que darle a ese panel
acceso a Docker. El panel está expuesto a internet: un fallo de ejecución remota ahí se
convertiría en control total de su servidor. La actualización la hace sve, que vive
fuera de los contenedores, y por eso pide una sesión en la máquina.
Es un paso manual más. Es deliberado, y es la razón por la que un fallo en el panel se queda dentro del panel.
El comando
sudo sve update
Sin más, instala la última versión que su proveedor haya publicado para usted. Para ir a una concreta:
sudo sve update --to 1.12.1
Antes de eso conviene mirar dónde está:
sudo sve status
Enseña la versión instalada, el estado de la licencia y, si hay algo más nuevo publicado,
una línea disponible: X.Y.Z → sve update.
Qué garantiza
La regla que gobierna toda la operación: una actualización que sale mal no puede dejar la instalación peor que como estaba. De ahí el orden de los pasos, y de ahí que la copia de seguridad sea obligatoria y no una opción que se pueda saltar con una bandera.
Los pasos, en orden:
- Comprueba el derecho a actualizar antes de descargar nada. Si su licencia no lo permite, se para aquí y no ha gastado varios gigabytes ni media hora en algo que iba a rebotar.
- Copia la base de datos entera, comprimida, en
<sus-datos>/backups/. Si la copia falla, o sale sospechosamente pequeña, no sigue: una copia vacía no es una copia, es un error que salió por la salida estándar. - Anota la versión desde la que sale, antes de descargar nada. Si el proceso muere a
la mitad —se corta la sesión, se va la luz—,
sve rollbacksigue sabiendo a dónde volver. - Descarga las imágenes de la versión nueva. Si la descarga falla, deja la versión anterior puesta y no ha cambiado nada.
- Recambia los servicios.
- Espera a que todo quede sano, hasta cinco minutos. Cinco y no menos porque el arranque en frío de una instalación con muchos canales incluye migraciones, reconciliación y el arranque escalonado de los procesos de emisión; ser impaciente convertiría un arranque lento en una vuelta atrás innecesaria, que es peor que esperar.
- Si algo no queda sano, vuelve sola a la versión anterior y espera a que esa quede sana. No hace falta que usted esté delante para arreglarlo: eso es lo que separa una actualización de una apuesta.
Al terminar bien, dice dónde quedó la copia. Consérvela.
Lo que la vuelta atrás no hace
No restaura la base de datos. Es deliberado y conviene entenderlo antes de necesitarlo.
Las migraciones de este producto solo van hacia delante: nunca borran ni transforman de forma destructiva, solo añaden. Un esquema ya migrado funciona con la versión nueva y casi siempre también con la anterior. Restaurar la base por las bravas tiraría todo lo que sus clientes y sus canales hayan hecho entre medias — altas, pagos, cambios — para arreglar un problema que casi nunca está en los datos.
Así que la copia está hecha, se le dice dónde está, y si además hace falta recuperar datos
eso lo decide una persona, con sve restore.
Volver atrás a mano
Si la versión nueva arrancó sana pero no le gusta lo que ve:
sudo sve rollback
Vuelve a la versión anotada en el último sve update. También hace una copia antes de
tocar nada, y también espera a que todo quede sano.
Si no hay ninguna versión anterior anotada, se lo dice y no hace nada.
Recuperar los datos de una copia
Esto es la operación más destructiva de la herramienta: sustituye la base de datos actual por el contenido de una copia, y todo lo que haya cambiado desde entonces se pierde.
sudo sve restore /opt/streamvault/data/backups/20260905-0833-pre-update-1.12.0.sql.gz
Pide escribir la palabra RESTAURAR entera, no una letra: una tecla de más en una terminal
cansada no puede costarle el día de trabajo. Antes de sustituir nada hace una copia de lo
que hay ahora, para que la marcha atrás de la marcha atrás también exista.
Para el proceso para los servicios que escriben mientras restaura. Restaurar por debajo de una API viva deja filas a medias de dos versiones distintas.
sve status no lista las copias. Están en <sus-datos>/backups/:
ls -lh /opt/streamvault/data/backups/
Qué pasa cuando el derecho a actualizaciones vence
Su licencia lleva dos fechas distintas, y la diferencia es toda la promesa del producto:
- Hasta cuándo vale la licencia. Es lo que mantiene el motor emitiendo.
- Hasta cuándo tiene derecho a instalar versiones nuevas (
updates_until).
Una licencia perpetua con un año de actualizaciones es un producto normal, y «perpetua» tiene que significar que sigue funcionando.
La regla
El derecho a actualizaciones vencido nunca impide arrancar ni emitir. Lo único que hace es degradar.
Lo que sigue funcionando, exactamente igual que ayer:
- La emisión, todos los canales, todos los espectadores.
- El panel completo, con todas sus funciones.
- La versión que tiene instalada, indefinidamente, mientras su licencia valga.
Lo que deja de poder hacer:
-
Instalar una versión nueva.
sve updatese niega antes de tocar nada, así que no le deja la instalación a medias:error: el derecho a actualizaciones vencio el 2026-08-31; la instalacion siguefuncionando, pero para instalar una version nueva hay que renovarlo -
Recibir las correcciones de seguridad publicadas después de esa fecha. Esto es lo que hay que tener en cuenta de verdad al decidir si renovar, y se dice con esas palabras porque disimularlo sería peor.
El panel también lo enseña, con la fecha hasta la que valía.
Por qué no se bloquea el arranque
Sería fácil tratar esa fecha como una segunda caducidad y negarse a arrancar. Es lo que hacen algunos productos, y es una trampa para el cliente honrado: actualiza por un aviso de seguridad, descubre después que su derecho venció el mes pasado, y se queda con la emisión parada sin camino de vuelta rápido.
Aquí no pasa eso. Si por cualquier vía acaba con una versión posterior a su fecha instalada, arranca y funciona con normalidad.
Otras razones por las que sve update se niega
| Mensaje | Qué significa |
|---|---|
esta instalacion no tiene licencia activada | Actívela primero, en el panel o con el instalador. |
la licencia esta en estado restringida: renuevela antes de actualizar | La licencia lleva días sin renovarse. Sigue emitiendo, pero en solo lectura. |
la licencia esta en estado bloqueada: renuevela antes de actualizar | La licencia venció hace tiempo. Al renovar, todo vuelve solo; no se ha borrado nada. |
no se sabe cual es la ultima version publicada; indique una con --to X.Y.Z | Este servidor no ha podido preguntar qué hay publicado. Indique la versión a mano o revise su salida a internet. |
Los estados de la licencia van por etapas y con margen: primero una temporada de gracia con todo funcionando, después una temporada en solo lectura, y solo al final se detiene la emisión. Cuánto dura cada etapa depende de su plan. Nunca se borra nada.
Actualizar la propia herramienta
sve también se actualiza:
sudo sve self-update
Pide la última publicada al servidor de licencias usando la misma credencial con la que ya descarga las imágenes —no hay nada nuevo que guardar ni que renovar—, comprueba su suma de comprobación y se reemplaza. Si ya tiene la última, lo dice y no toca nada.
La comprobación de la suma no es un adorno: una descarga cortada a la mitad se parece a una entera hasta que se intenta usar, y para entonces la herramienta rota sería justo la que arregla las cosas.
Para una versión concreta: sudo sve self-update --to 1.12.1.
Si algo falla
«la copia fallo, asi que no se sigue» / «la copia salio vacia»
No se ha tocado nada. El problema está en la base de datos, no en la actualización:
sudo sve doctor
sudo sve logs postgres
Compruebe también que hay espacio libre en el disco donde viven sus datos.
«no se pudieron descargar las imagenes de la X; nada ha cambiado»
La versión anterior sigue puesta y corriendo. Suele ser la salida a internet o una
licencia que dejó de valer para el registro. Compruebe sve status y vuelva a intentarlo.
«no quedo sano; volviendo a la X» seguido de «se volvio a la X y esta sana»
Funcionó como debe: la versión nueva no levantó bien y su instalación está otra vez en la anterior, emitiendo. Guarde la salida completa y mande a su proveedor:
sudo sve logs api -n 300
No vuelva a lanzar la misma actualización sin saber qué pasó: va a fallar igual.
«se volvio a la X pero tampoco queda sana»
Este es el caso malo, y es el único que necesita atención inmediata. Ni la versión nueva ni la anterior arrancan bien, lo que casi siempre apunta a algo fuera del producto: disco lleno, memoria agotada, Docker en mal estado. Empiece por:
sudo sve doctor
docker compose ps
df -h
La copia previa está hecha y sve doctor le dice cuántas hay.
«ya esta la X instalada»
No hay nada que hacer: ya tiene esa versión.
Antes de una actualización importante
Nada de esto es obligatorio —el comando ya hace su copia—, pero para un salto de versión mayor merece la pena:
sudo sve status # de dónde parte y cómo está la licencia
sudo sve doctor # que no arrastre ya algún problema
sudo sve backup # una copia propia, además de la automática
Y lea las notas de la versión. Están en el panel, en la página de actualización, en español y en inglés, y describen qué va a notar distinto — no qué se tocó por dentro.
Saltos de varias versiones
Hay saltos que no se pueden dar de una vez. Cuando una versión nueva deja de poder aplicarse encima de una demasiado antigua, su proveedor anuncia desde cuál se puede llegar directamente.
Desde la 1.12.2, sve update comprueba ese suelo antes de descargar nada y se niega
diciendo por cuál versión pasar primero:
esta instalacion corre la 1.8.3 y desde la 1.9.0 en adelante es lo unico que puede
saltar de una vez: actualice primero a la 1.9.0 (`sve update --to 1.9.0`) y repita
No es una formalidad: saltar desde demasiado atrás no da un error limpio, deja la base de datos a medias en una máquina que estaba emitiendo. Las migraciones solo van hacia delante.
Con --to no se comprueba: al indicar una versión concreta está eligiendo el paso usted,
que es justo lo que esto le pediría que hiciera.