# o6h-memory-guard 1.0.7 Primera implementación para SmartOS global zone: daemon C de 64 bits, libkstat, /proc, identidad UUID + generación de zona + PID + instante de creación, configuración separada y servicio SMF. Entrega de código fuente; **no contiene un binario nativo validado en SmartOS**. Véase `VALIDATION.md`. Una instalación nueva arranca en `dry-run` porque la configuración distribuida contiene `ACTION_MODE dry-run`. El manifiesto SMF de producción no fuerza ese modo: la configuración es la única fuente de la política de acción. No se entrega ninguna zona autorizada. Esta revisión no se ha desplegado, no ha activado `armed` y no ha enviado señales reales. ```text Instalación nueva → ACTION_MODE dry-run → SMF no fuerza dry-run Activación real → el operador cambia explícitamente ACTION_MODE armed → reinicia SMF → armed_warmup=60 sigue aplicando ``` ## Documentación de la entrega - `README.md`: instalación, semántica, política, operación y rollback. - `VALIDATION.md`: validación local realizada al construir esta entrega y comprobaciones nativas que en ese momento quedaban pendientes. - `CHECKPOINT.md`: checkpoint operativo posterior, incorporado sin cambios, con la evidencia acumulada de compilación, ejecución y logging de v1.0.2 en SmartOS real, además del estado exacto y los requisitos antes de `armed`. - `INCIDENT_PAGEOUT_DEADMAN_2026_09.md`: cronología del panic real observado con v1.0.2, endurecimiento de v1.0.3 y corrección del ranking global en v1.0.4. - `INCIDENT_PAGEOUT_DEADMAN_AVOIDED_2026_09_21.md`: evidencia de campo de un episodio en el que la acción real liberó memoria antes de un nuevo panic. - `INCIDENT_PAGEOUT_DEADMAN_PANIC32_2026_09_22.md`: análisis del panic32, el stall de 145 s y el rediseño no bloqueante de v1.0.7. - `CHANGELOG.md`: evolución de versiones y revisión documental del paquete. El checkpoint es cronológicamente posterior a `VALIDATION.md`; por ello amplía sus resultados de campo sin cambiar el código ni autorizar el modo `armed`. ## Instalación inicial y activación en dry-run Los comandos siguientes se ejecutan por el operador, como root en la global zone. Requieren `gcc` de 64 bits, cabeceras nativas y GNU make (`gmake`) en PATH. Si no hay herramientas de desarrollo, compilar en una **zona nativa SmartOS** de la misma plataforma (no LX), ejecutar allí `gmake test`, y copiar el binario junto a este árbol al host. No instalar un compilador en un nodo bajo presión. Copiar el archivo distribuido a `/var/tmp/o6h-memory-guard-1.0.7.tar.gz`: ```sh mkdir -p /opt/custom/src cd /opt/custom/src gzip -dc /var/tmp/o6h-memory-guard-1.0.7.tar.gz | tar -xf - cd /opt/custom/src/o6h-memory-guard gmake CC=gcc gmake test CC=gcc file ./o6h-memory-guard ldd ./o6h-memory-guard sh ./install.sh ``` `file` debe identificar un ELF nativo de 64 bits. `ldd` no debe mostrar dependencias ausentes. El instalador sólo copia archivos y valida el manifiesto; no importa ni inicia servicios, y rechaza sobrescribir una instalación existente. Si ya se copió un binario compilado en una zona nativa, omitir `gmake CC=gcc` en la global zone; conservar los resultados de compilación y pruebas. Inventariar UUID y alias fuera del daemon: ```sh vmadm list -o uuid,alias vi /opt/custom/etc/o6h-memory-guard.conf ``` Añadir una línea por zona, con UUID real y alias sin espacios: ```text zone web5 allow zone database protect zone monitoring protect ``` Esos marcadores **no son valores válidos**: sustituirlos, incluidos los signos `< >`. `allow` hace elegible una zona para las simulaciones; no habilita señales mientras el servicio esté en dry-run. `protect`, `observe` o la ausencia de una regla excluyen la zona de toda acción. Sin reglas `allow` el monitor funciona y registra métricas/top de procesos, pero informa `no_authorized_candidate`. ```sh /opt/custom/bin/o6h-memory-guard --check-config --force-dry-run /opt/custom/bin/o6h-memory-guard --probe --force-dry-run svccfg validate /opt/custom/smf/o6h-memory-guard.xml svccfg import /opt/custom/smf/o6h-memory-guard.xml svcadm enable -s svc:/site/o6h-memory-guard:default svcs -xv svc:/site/o6h-memory-guard:default svcprop -p start/exec svc:/site/o6h-memory-guard:default tail -f /opt/custom/var/log/o6h-memory-guard/guard.log ``` Verificar `mode=dry-run` en `event=start`, ausencia de `--force-dry-run` en `start/exec`, `arc_ok=1`, `swap_committed_ok=1`, `swap_physical_used_ok=1`, `anon_pageout_ok=1` y `proc_scan complete=1`. No generar presión artificial en producción. Para comprobar selección y UUID, revisar `candidate`, `zone` y `top_process` durante carga natural; `WOULD_ACTION` sólo aparece si se alcanzan los umbrales y hay candidato autorizado. `--probe` lee una muestra y sale sin locks, logs ni acciones; `--check-config` sólo valida configuración y permisos. Para que se active automáticamente tras un reinicio de SmartOS, después de validar este arranque editar **únicamente** `create_default_instance` a `enabled="true"` en el manifiesto persistente y volver a importarlo: ```sh vi /opt/custom/smf/o6h-memory-guard.xml svccfg validate /opt/custom/smf/o6h-memory-guard.xml svccfg import /opt/custom/smf/o6h-memory-guard.xml ``` Mantener `ACTION_MODE dry-run` durante toda la validación inicial. La ubicación `/opt/custom/smf` se utiliza para servicios personalizados persistentes de SmartOS; no depender exclusivamente del estado habilitado de la instancia en el repositorio del arranque actual. `--force-dry-run` sigue disponible para `--probe`, pruebas y validaciones manuales, pero no pertenece al método SMF. ## Métricas y ventanas Cada segundo se leen `unix:0:system_pages:{freemem,lotsfree,desfree,minfree,nscan, pp_kernel,pageslocked}`, `cpu:*:vm:anonpgout` y `zfs:0:arcstats:size` mediante libkstat. `swapctl(SC_AINFO)` proporciona asignación, reserva y disponibilidad de swap virtual, equivalente a `swap -s`. La métrica inequívoca es `swap_committed_pages = allocated + reserved`, e incluye compromiso anónimo que puede seguir residente en RAM; **no representa pageout ni bytes escritos en el zvol**. La reserva aún no asignada es `ani_resv - (ani_max - ani_free)`. Por separado, `swapctl(SC_LIST)` obtiene las mismas entradas que `swap -l`. `swap_physical_used_bytes` suma `(blocks - free) * 512` de todos los dispositivos; los campos nativos de la API están en páginas y se convierten primero a los bloques de 512 bytes que muestra la utilidad. Esta cifra sí representa ocupación física del swap configurado. Con la validación observada: `swap -s` indicó unos 28,5 GiB comprometidos, mientras `swap -l` indicó sólo 8.093.064 bloques usados, es decir 4.143.648.768 bytes (unos 3,86 GiB). No deben compararse como si fueran la misma magnitud. El log conserva unidades: páginas para VM/compromiso virtual/pageout, bytes para ARC y swap físico, KiB para RSS. `page_bytes` se obtiene de `sysconf`, nunca se presupone 4096. `nscan` es una medida del scanner, no un contador acumulativo; su delta se registra como cambio de la medida y no se interpreta como tasa de pageout. Historias circulares con timestamps monotónicos, deltas 5/15/60 s para libre, kernel, locked, ARC, compromiso/disponibilidad virtual, ocupación física de swap, pageout anónimo y nscan. Los deltas incluyen la edad real (`-100@5.02s`). Se exige una muestra a ±1,25 s de la ventana; si falta, sale `NA`, sin inventar ceros. /proc se recorre cada 5 s en NORMAL y cada 1 s bajo `lotsfree`; RSS y crecimiento de procesos/zonas usan las mismas ventanas. El contrato de cada `event=sample` expone los tres pares inequívocos `swap_committed_ok/swap_committed_pages`, `swap_physical_used_ok/swap_physical_used_bytes` y `anon_pageout_ok/anon_pageout_pages`. Cada muestra va seguida por líneas `event=delta` con esos tres nombres exactos y `d5`, `d15` y `d60`. `swap_used_pages` no es un nombre válido. Se conservan como diagnóstico auxiliar `swap_alloc_pages`, `swap_reserved_pages` y `swap_available_pages`: son los componentes de compromiso virtual de `SC_AINFO`, todos en páginas, y ninguno representa bytes escritos en el dispositivo swap. En los datos originales, `425950 > 130875` páginas y `nscan=0` corresponden a NORMAL. Los valores de 130875/65437/49077 páginas no están codificados como umbrales: se vuelven a leer del kernel. ARC y `pp_kernel` son diagnóstico, nunca una prueba de que un proceso concreto causó la presión. ## Estados y acción | Estado/condición de entrada | Comportamiento predeterminado | | --- | --- | | NORMAL | Sin intervención; muestreo VM de 1 s. | | PRE-PRESSURE | Bajo `lotsfree` durante 1 s monotónico por defecto; refresca candidatos, sin señales. | | PRESSURE | Bajo `lotsfree` durante 2 s, o caída rápida corroborada; no exige que `nscan` haya arrancado. Refresca candidatos cada segundo. | | CRITICAL | Bajo `desfree` con presión corroborada continua durante 2 s; usa caché, sin scan nuevo, y propone TERM. | | EMERGENCY | `free <= minfree`; entrada inmediata. Usa caché y gracia TERM de 1 s. | | Floor | `free <= minfree/2`; KILL directo por defecto (`FLOOR_KILL_DELAY_SECONDS=0`). | | RECOVERY | Desde CRITICAL/EMERGENCY al recuperar `desfree`; NORMAL sólo tras 15 s estables con `free >= lotsfree` y `nscan=0`. | La entrada temprana a PRESSURE depende de persistencia bajo `lotsfree` o caída clara y no espera a que el scanner arranque. `nscan > 0`, caída respecto a la muestra anterior y delta libre negativo siguen corroborando gravedad. Bajo `lotsfree`, el crecimiento simultáneo en 5 s de `swap_physical_used_bytes` y `anon_pageout_pages` corrobora presión. La ocupación física jamás es un trigger único: sin pageout creciente y memoria bajo `lotsfree` no cambia el estado. El compromiso virtual tampoco se interpreta como pageout. Los tiempos son segundos monotónicos transcurridos, no número de filas leídas. Un `sampling_overrun` no borra el tiempo ya observado bajo un umbral: si las muestras llegan en t+1,8 y t+4,2, la segunda puede confirmar PRESSURE aunque no existan filas exactas por segundo. Si después de un retraso la siguiente muestra salta desde encima de `desfree` a `free <= desfree`, entra directamente en CRITICAL; `free <= minfree` siempre entra directamente en EMERGENCY. El `state_transition` registra `reason=threshold_jump` y `skipped_states` cuando se omiten estados intermedios. Sólo una muestra inválida, obsoleta o con reloj monotónico no creciente reinicia la confirmación. La gravedad se retiene hasta recuperar `desfree`; `action_pressure` indica si el estado retenido aún permite una decisión de rescate. Las gracias son configurables: 5 s en CRITICAL, 1 s en EMERGENCY y 0 s al floor por defecto. Una lectura kstat fresca debe seguir bajo `desfree`. Recuperar `desfree` cancela cualquier TERM pendiente y entra en RECOVERY. Se mantiene como máximo una decisión de señal por tick; si una identidad desaparece o reutiliza el PID se prueba el siguiente candidato cacheado sin recorrer `/proc` completo. En NORMAL/PRESSURE/CRITICAL rigen 4 víctimas por episodio y 4 por ventana móvil de 60 s. EMERGENCY puede superar esos límites normales hasta 8 víctimas por episodio; floor tiene un límite absoluto de 12. Cada override se registra como `victim_budget_override=emergency|floor`. TERM+KILL del mismo proceso cuentan como una víctima. Los límites 4/8/12 son configurables pero deben mantener ese orden. El episodio sólo se reinicia al volver a NORMAL. En armed, los primeros 60 s desde el arranque monotónico del daemon inhiben únicamente las señales, también en EMERGENCY, para evitar eludir el límite por minuto mediante reinicios. La detección, el muestreo, los scans permitidos por estado y la reconstrucción del `candidate_cache` continúan durante ese warmup. Cada bloqueo se registra como `event=action_blocked reason=armed_warmup elapsed_seconds=... required_seconds=60`. Los contadores son en memoria; el presupuesto por episodio sí se reinicia al reiniciar el daemon. Revisar esta elección antes de usarlo como mecanismo de rescate. No hay garantía de evitar un panic. ## Atribución y protecciones Cada scan completo recorre todos los procesos elegibles de todas las zonas `allow` y construye un ranking global; no existe una preselección de la mejor zona. La caché interna conserva 16 candidatos y el log muestra sólo los tres primeros para limitar ruido. El score en KiB equivalentes es: ```text total_score = RSS + 4*max(d5,0) + 2*max(d15,0) + max(d60,0) + zone_component ``` `zone_component` incorpora `zone_rss/64` y crecimiento positivo de zona d5/16, d15/32 y d60/64, pero queda limitado a `process_rss/4`. Así una zona enorme aporta contexto sin poder monopolizar el ranking; un proceso estable de 1,3 GiB supera normalmente a uno de 250 MiB, mientras un proceso menor con crecimiento explosivo todavía puede ascender. Se usa el mismo ranking balanceado en todos los estados. La caché fija de 16 entradas permite consumir los budgets 8/12 sin nuevo scan y conserva la ruta CRITICAL/EMERGENCY/FLOOR O(Ncache), con N fijo y pequeño. Empates se resuelven por RSS y después PID. El log expone `rss_component`, `growth5_component`, `growth15_component`, `growth60_component`, `zone_component` y `total_score`. Cada entrada conserva identidad, alias, RSS y d5/d15/d60. **La suma de RSS por zona puede contar memoria compartida varias veces**: es una aproximación de atribución, no memoria física exclusiva ni memoria garantizada que se recuperará al terminar un proceso. El UUID es el nombre de zona devuelto por el kernel, validado como UUID canónico en minúscula (convención SmartOS). Se conserva además `ZONE_ATTR_UNIQID`; se consulta `ZONE_ATTR_INITPID`. Los alias son etiquetas del catálogo del operador, no se obtienen mediante comandos ni se usan para autorizar señales. Un alias renombrado debe actualizarse manualmente. En illumos con nombres de zona que no sean UUID, el muestreo funciona pero esas zonas quedan excluidas de acciones. Protecciones obligatorias: global zone completa; PID 0/1 y proceso propio; padre 0; procesos sin LWPs; init de cada zona; identidades no resueltas o sin generación; zonas sin regla `allow`; RSS menor de 64 MiB por defecto. También se excluyen los nombres `init`, `systemd`, `svc.startd`, `svc.configd`, `sshd`, `zoneadmd`, `vminfod`, `vmadmd`, `qemu`, `qemu-system-x86`, `bhyve` y el guard. Las protecciones se aplican incluso al floor y prevalecen sobre toda autorización. `protect_process` añade nombres exactos `pr_fname` de hasta 15 caracteres, sin comodines ni argumentos; `protect_pid` añade PID global, no PID visto dentro de LX. La config entregada añade PostgreSQL, MySQL/MariaDB, Redis y Zabbix. Las zonas de base de datos/infraestructura deben figurar como `protect`. Los nombres pueden cambiar/truncarse y no constituyen una frontera contra un proceso malicioso: la protección por UUID completo es la más robusta. Antes de actuar se comprueban UUID, generación, PID, inicio, nombre, UID/EUID, init, RSS y reglas. Se abren psinfo/ctl respecto al mismo descriptor de directorio /proc y se envía `PCKILL` al descriptor, no a un número PID mediante `kill(2)`. El inicio de un PID reutilizado invalida el candidato. Cambios de nombre/UID ya visibles también lo invalidan. Queda la carrera inherente de un exec ordinario entre la última lectura de psinfo y la escritura: no se detiene el proceso para eliminarla. No se tocan flags de tracing, no se usa kill-on-close ni señales a grupos. La integración de esta ruta todavía necesita validación nativa de laboratorio. En dry-run nunca se abre `ctl`: se revalida con lecturas, se escribe `WOULD_ACTION=SIGTERM/SIGKILL` y se actualiza sólo el estado simulado. Los presupuestos evitan repetir infinitamente el mismo sacrificio hipotético. En armed no se escribe nada antes de la operación real: se valida, se intenta la señal, se actualizan counters en memoria y sólo entonces se encolan `action_decision`, `action_result` y, si hubo éxito, `signal_sent`. Los errores de escritura de señal consumen presupuesto para evitar reintentos ambiguos. ## Recursos y fallos Almacenamiento fijo para 4096 procesos, 256 zonas, 16 candidatos y una cola de 512 eventos, reservado al arrancar; el tamaño se registra. No hay malloc de la aplicación en la ruta de acción, ni `system`, `popen`, `exec`, `vmadm`, `ps` o `vmstat` en el daemon. libkstat/libc sí pueden reservar memoria internamente al actualizar su cadena. No se promete cero asignaciones ni tiempo real estricto. El recorrido /proc tiene presupuesto cooperativo de 200 ms (hasta 500 ms por configuración) y se ejecuta en un scanner independiente. Un scan incompleto o bloqueado no sustituye la última caché completa ni detiene el muestreo. NORMAL solicita actualización cada 5 s; PRE-PRESSURE/PRESSURE, cada segundo. CRITICAL/EMERGENCY/FLOOR nunca esperan al scanner: recorren como máximo 16 entradas precomputadas y revalidan sólo el proceso elegido. Los 15 s de frescura siguen aplicándose en NORMAL/PRE/PRESSURE. En rescate, una entrada más antigua puede usarse como `stale_cache_revalidated` si PID, inicio, UUID, generación, regla `allow`, nombre y protecciones todavía coinciden. La caché sobrevive a EMERGENCY → RECOVERY → EMERGENCY y sólo un scan completo sano la reemplaza. Muestras obligatorias ausentes/invalidas o demasiado lentas inhiben señales; ARC/swap/pageout opcionales ausentes se marcan con `*_ok=0` y no bloquean por sí solos. Un fallo o stall del log ya no inhibe acciones. El hilo principal encola con `pthread_mutex_trylock`; nunca espera al logger. Si la cola está ocupada o llena, descarta telemetría y acumula `dropped_events`. El worker realiza escritura, rotación y syslog, y genera posteriormente `logging_delivery` o `logging_stall` con latencias por canal. No hay `fsync`; las últimas líneas pueden perderse por drop, alimentación o panic. Es observabilidad best-effort, no un journal de transacciones de señales. No se cambia swap, ARC ni caps de zona. La enumeración física admite hasta 64 dispositivos swap con almacenamiento fijo; si el nodo supera ese límite, `swap_physical_used_ok=0` y esa señal diagnóstica se omite sin autorizar acciones. Un lock fcntl evita dos instancias (incluso una manual y otra SMF); el PID guardado es diagnóstico, nunca se usa para señalizar. Config/locks/logs exigen propietario root, archivo regular de un enlace, destino sin symlink y directorios resueltos sin escritura para grupo/otros. Directorios /opt con symlinks legítimos de root se admiten al resolver su destino. SIGHUP sólo reabre el log; la configuración se recarga reiniciando el servicio. SIGTERM/SIGINT al daemon solicitan salida limpia. ## Logging y mantenimiento ```text /opt/custom/bin/o6h-memory-guard /opt/custom/etc/o6h-memory-guard.conf /opt/custom/smf/o6h-memory-guard.xml /opt/custom/var/run/o6h-memory-guard.lock /opt/custom/var/log/o6h-memory-guard/guard.log /opt/custom/var/log/o6h-memory-guard/guard.log.1 ... guard.log.5 ``` Rotación interna: 10 MiB por archivo y 5 copias, aproximadamente 60 MiB máximos. El volumen de líneas por segundo puede hacer que la retención sea inferior a un día; aumentar LOG_MAX_MIB/LOG_KEEP o recoger logs externamente si se necesita un estudio de varios días. No configurar copytruncate/logadm simultáneamente. Snapshots de todas las zonas y top 20 procesos cada 60 s normal / 5 s en presión. Las muestras de 1 s posteriores a las acciones permiten revisar la recuperación en 1/2/5/10 s, siempre que no haya overruns. No se registran argumentos de procesos. `logs/policy-tests.log` y `logs/runtime-tests.log` proceden de pruebas locales; no son datos del nodo. `logs/example.log` es un ejemplo sintético de formato. Los eventos `state_transition`, `candidate_cache`, `action_decision` y `recovery_check` permiten reconstruir el estado, origen/rank/edad del candidato, resultado del último scan, componentes del score y cualquier override de presupuesto. ### Syslog nativo selectivo `guard.log` sigue siendo el registro detallado principal; bajo saturación puede perder eventos antes que bloquear una señal. Con `SYSLOG_ENABLED yes` se envía además un subconjunto operativo mediante `openlog(3C)`, `syslog(3C)` y `closelog(3C)`, con ident `o6h-memory-guard` y facility configurable `local0`…`local7` (`local5` por defecto). No se invoca `logger`, shell ni un proceso auxiliar. `SYSLOG_ENABLED no` lo desactiva. | Evento/condición | Severidad | | --- | --- | | `start`, `recovery_complete`, transición a NORMAL/RECOVERY | INFO | | transición a PRE-PRESSURE | NOTICE | | transición a PRESSURE, `action_blocked` | WARNING | | transición a CRITICAL, `SIGTERM` | ERR | | transición a EMERGENCY/floor, `SIGKILL`, error interno grave | CRIT | También se envían `state_transition`, `signal_sent`, `action_blocked` e `internal_error`. `signal_sent` se construye **después** de que el backend haya confirmado el envío real e incluye estado, señal, UUID, alias, PID, nombre, RSS y memoria libre; nunca existe en dry-run. `sample`, `delta`, `candidate_cache`, `top_process`, `proc_scan` y `zone` no se duplican en syslog. Un fallo al enviar a syslog se ignora para la decisión: syslog se ejecuta exclusivamente en el worker y no puede preceder ni cambiar el resultado de una señal. Los eventos de acción incluyen `decision_mono`, `kill_attempt_mono`, `kill_return_mono`, `dispatch_latency_ms`, `candidate_validate_latency_ms`, `kill_latency_ms` y `log_enqueue_latency_ms`. El worker mide además `guard_log_write_latency_ms` y `syslog_latency_ms`. Así se distingue un retraso de validación/señal de un stall posterior del canal de observabilidad. Antes de asumir un archivo de destino, inspeccionar la configuración local: ```sh grep -v '^[[:space:]]*#' /etc/syslog.conf ``` Localizar allí el destino de `local5`; el guard no modifica `syslog.conf` ni presupone `/var/adm/messages`. Un reenvío futuro a syslog central o mediante Alloy/Loki puede configurarse fuera del guard, pero esta entrega no lo hace. ## Modelo de activación real (operación futura; no ejecutada en esta entrega) v1.0.7 debe compilarse y observarse primero en SmartOS con `ACTION_MODE dry-run`. El manifiesto ya no contiene una segunda puerta oculta. Cuando exista aprobación operativa explícita, el único cambio de modo es editar la configuración: ```sh vi /opt/custom/etc/o6h-memory-guard.conf # cambiar exactamente: ACTION_MODE dry-run → ACTION_MODE armed /opt/custom/bin/o6h-memory-guard --check-config svcadm restart svc:/site/o6h-memory-guard:default ``` Mantener las reglas UUID `allow` mínimas y verificar antes las protecciones y el laboratorio nativo. Tras el restart, comprobar `event=start mode=armed`; durante los primeros 60 s `armed_warmup` inhibe señales, aunque la detección y la caché siguen activas. No se proporciona un script que arme automáticamente el servicio. Para volver a dry-run, restaurar `ACTION_MODE dry-run`, validar la configuración y reiniciar SMF. No es necesario editar el manifiesto. ## Parada, rollback y actualización Parar el guard sin borrar evidencia: ```sh svcadm disable -s svc:/site/o6h-memory-guard:default svcs -p svc:/site/o6h-memory-guard:default ``` Si se habilitó el arranque persistente, volver a `enabled="false"` e importar el manifiesto para mantenerlo deshabilitado en próximos arranques. Para retirar el servicio conservando los archivos y logs: ```sh mkdir -p /opt/custom/var/backups/o6h-memory-guard mv /opt/custom/smf/o6h-memory-guard.xml /opt/custom/var/backups/o6h-memory-guard/o6h-memory-guard.xml.disabled svccfg delete svc:/site/o6h-memory-guard:default ``` Comprobar antes que el destino de backup no exista y elegir un nombre distinto si ya se utilizó. El manifiesto sale del directorio de importación automática; binario/config/logs permanecen recuperables. No eliminar ni truncar el lock de una instancia viva. Restaurar el manifiesto e importarlo permite reinstalar SMF. Para actualizar: deshabilitar primero, conservar copias del binario, config y manifiesto en un directorio de backup nuevo, reemplazar el binario estando parado y validar los tres archivos. No reemplazar automáticamente la config ni perder las protecciones. Al migrar desde v1.0.2 es obligatorio fusionar explícitamente `PRE_SECONDS=1`, `PRESSURE_SECONDS=2`, las tres nuevas gracias, `MAX_CACHED_CANDIDATE_AGE_SECONDS` y los límites 8/12 del fichero distribuido; conservar 3/10 mantendría la detección lenta anterior. Validar con `--check-config --force-dry-run` antes de reiniciar. El instalador inicial se niega a sobrescribir por ese motivo. La migración desde v1.0.3 a v1.0.4 no añade parámetros de configuración: cambia el algoritmo de ranking y su logging. Comparar el top‑3 global en SmartOS real antes de reemplazar el binario observado. ### Upgrade del manifiesto desde v1.0.4 o anterior Los manifiestos antiguos incluían `--force-dry-run`. Antes de retirarlo, comprobar el modo configurado. Si no se pretende activar señales en ese mismo restart, debe decir literalmente `ACTION_MODE dry-run`: ```sh grep '^ACTION_MODE ' /opt/custom/etc/o6h-memory-guard.conf /opt/custom/bin/o6h-memory-guard --check-config --force-dry-run kstat -p unix:0:system_pages:freemem unix:0:system_pages:lotsfree ``` No hacer un restart innecesario cuando `freemem` esté cerca o por debajo de `lotsfree`: cada arranque reinicia `armed_warmup=60` y, si el modo fuese armed, dejaría las señales inhibidas durante 60 s precisamente cuando podrían ser necesarias. Posponer el cambio hasta que el nodo esté estable. Con memoria estable, conservar el manifiesto anterior y copiar el nuevo: ```sh mkdir -p /opt/custom/var/backups/o6h-memory-guard cp -p /opt/custom/smf/o6h-memory-guard.xml \ /opt/custom/var/backups/o6h-memory-guard/o6h-memory-guard.xml.v1.0.4-forced-dry-run cp /opt/custom/src/o6h-memory-guard/smf/o6h-memory-guard.xml \ /opt/custom/smf/o6h-memory-guard.xml svccfg validate /opt/custom/smf/o6h-memory-guard.xml svccfg import /opt/custom/smf/o6h-memory-guard.xml svcadm restart svc:/site/o6h-memory-guard:default ``` Comprobar tanto la definición importada como el proceso activo: ```sh svccfg export svc:/site/o6h-memory-guard:default | grep -A3 -B2 'o6h-memory-guard --daemon' pgrep -fl o6h-memory-guard ``` Ambas salidas deben quedar sin `--force-dry-run`. Con la configuración distribuida, `event=start` debe seguir mostrando `mode=dry-run`. ### Rollback del manifiesto anterior Primero asegurar `ACTION_MODE dry-run` y comprobar de nuevo que la memoria está holgada respecto a `lotsfree`. Después restaurar la copia y reimportarla: ```sh cp /opt/custom/var/backups/o6h-memory-guard/o6h-memory-guard.xml.v1.0.4-forced-dry-run \ /opt/custom/smf/o6h-memory-guard.xml svccfg validate /opt/custom/smf/o6h-memory-guard.xml svccfg import /opt/custom/smf/o6h-memory-guard.xml svcadm restart svc:/site/o6h-memory-guard:default ``` El rollback vuelve a añadir la puerta forzada del manifiesto antiguo. Registrar qué versión queda instalada para no confundir ese comportamiento con la política de configuración de v1.0.5. ## Referencias revisadas - [SmartOS: servicios personalizados y /opt/custom/smf](https://docs.smartos.org/smf-quick-reference-gz/). - [illumos: libkstat](https://smartos.org/man/3KSTAT/kstat). - [illumos: definiciones nativas de psinfo](https://github.com/illumos/illumos-gate/blob/master/usr/src/uts/common/sys/procfs.h). - [OmniOS/illumos: control /proc y PCKILL](https://man.omnios.org/man5/proc.5). - [illumos: atributos de zona](https://github.com/illumos/illumos-gate/blob/master/usr/src/uts/common/sys/zone.h). - [OmniOS/illumos: resolución del nombre de zona](https://man.omnios.org/man3c/getzoneid). - [illumos: cálculo de swap -s](https://github.com/illumos/illumos-gate/blob/master/usr/src/cmd/swap/swap.c). - [illumos: listado swap -l y conversión a bloques](https://github.com/illumos/illumos-gate/blob/master/usr/src/cmd/swap/swap.c#L350-L474). Las interfaces de atributos de zona dependen de la plataforma: confirmar con la versión exacta de SmartOS. La documentación revisada no sustituye la prueba de compilación/ejecución en ese host.