Instalar OneAgent Windows en modo silencioso en Windows Server

OneAgent Windows: instalación silenciosa en Windows Server con PowerShell, conectada a Dynatrace Managed, con parámetros explícitos y verificaciones.
Installer OneAgent sur Windows Server en mode silencieux

En un parque de Windows Server, la instalación interactiva de OneAgent muestra enseguida sus límites. Pulsar «Siguiente» en tres servidores de pruebas todavía pasa; repetir la misma operación en doscientos servidores IIS, controladores .NET y hosts de servicios de Windows, sin errores de host group ni olvidos de proxy, es una ilusión. Hace falta un despliegue silencioso de OneAgent Windows, parametrizado y controlable desde tus herramientas habituales: GPO, SCCM/MECM, Ansible WinRM o un simple script de PowerShell.

Con Dynatrace Managed, lo que está en juego es doble. Por un lado, el agente debe llegar a un clúster alojado en tu propia infraestructura, con tus certificados internos, tus proxies de salida y, a veces, ActiveGates dedicados por zona. Por otro, la cuota de licencia es un presupuesto fijo que gestionas tú mismo en la Cluster Management Console (consulta entornos y cuotas de licencia): un despliegue Full-Stack sin control en servidores que no lo necesitan se paga de inmediato.

Esta guía detalla una instalación silenciosa de OneAgent en Windows Server conectada a un entorno Managed, desde la descarga del instalador hasta la verificación, pasando por los parámetros esenciales y los ajustes posteriores a la instalación.

Qué cambia en Windows

El principio es el mismo que en OneAgent en Linux: un instalador propio de tu entorno, parámetros de línea de comandos para fijar el modo de monitorización, el host group y la network zone, y después la herramienta oneagentctl para modificar la configuración. Aun así, algunas diferencias prácticas merecen atención:

  • El instalador es un ejecutable (.exe) que encapsula un paquete MSI. Acepta un modo silencioso y los mismos parámetros --set-… que en Linux.
  • El agente se ejecuta como un servicio de Windows; la sesión de instalación debe tener derechos de administrador local.
  • Las aplicaciones IIS, .NET y los servicios de Windows que ya estén en marcha deben reiniciarse para quedar instrumentados en Full-Stack.
  • Los antivirus y los EDR pueden bloquear o ralentizar la inyección: prevé las exclusiones recomendadas por tu equipo de seguridad, de acuerdo con la documentación.

Requisitos previos para OneAgent Windows

  • Una versión de Windows Server compatible con tu versión de OneAgent (consulta la matriz de compatibilidad).
  • Una cuenta de administrador local y Windows PowerShell (los ejemplos siguientes se han escrito para la versión 5.1).
  • Un token de API del entorno con el permiso de descarga de instaladores.
  • El identificador del entorno, presente en la URL https://{votre-domaine}/e/{id-environnement}.
  • El valor deseado para el host group y la network zone.
  • Unos 775 MB para la instalación en %PROGRAMFILES%\dynatrace\oneagent y cerca de 11,5 GB en total, contando logs, volcados, persistencia y actualizaciones (en %PROGRAMDATA%\dynatrace\oneagent).
  • Si el certificado del clúster lo emite una PKI interna, la autoridad raíz debe estar en el almacén de certificados del equipo.

Tutorial paso a paso

Paso 1 — Probar la conectividad

En una consola de PowerShell como administrador:

$headers = @{ Authorization = "Api-Token {token}" }
Invoke-WebRequest -UseBasicParsing `
  -Uri "https://{votre-domaine}/e/{id-environnement}/api/v1/time" `
  -Headers $headers | Select-Object StatusCode

# Si la zone passe par un Environment ActiveGate
Test-NetConnection -ComputerName {activegate-host} -Port 9999

La llamada a /api/v1/time exige el scope DataExport: con un token limitado a la descarga, un error 401 o 403 ya demuestra que la red y TLS funcionan, y un 200 valida además el token. Si aparece un error de certificado, casi siempre falta la autoridad raíz interna.

Paso 2 — Descargar el instalador

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
$out = "C:\Temp\Dynatrace-OneAgent-Windows.exe"
New-Item -ItemType Directory -Force -Path C:\Temp | Out-Null

Invoke-WebRequest -UseBasicParsing `
  -Uri "https://{votre-domaine}/e/{id-environnement}/api/v1/deployment/installer/agent/windows/default/latest" `
  -Headers $headers -OutFile $out

Get-Item $out | Select-Object Name, Length

El ejecutable incorpora el identificador del entorno y el token de conexión del agente. Guárdalo en un recurso compartido cuyo acceso esté restringido a las cuentas de despliegue.

Paso 3 — Verificar la firma

Get-AuthenticodeSignature $out | Format-List Status, SignerCertificate

El estado esperado es Valid. Cualquier otro estado debe bloquear el despliegue hasta que se analice.

Paso 4 — Lanzar la instalación silenciosa

$installArgs = @(
  "--set-monitoring-mode=fullstack",
  "--set-host-group={application}_{environnement}",
  "--set-network-zone={zone-reseau}",
  "--set-app-log-content-access=true",
  "--quiet"
)
$p = Start-Process -FilePath $out -ArgumentList $installArgs -Wait -PassThru
"Code retour : $($p.ExitCode)"

Un código de retorno 0 indica que la instalación ha tenido éxito. Para un servidor que solo se monitoriza a nivel de infraestructura, usa --set-monitoring-mode=infra-only. Si hace falta un proxy: --set-proxy={proxy-host}:{port}. El directorio de instalación por defecto se puede cambiar con el parámetro MSI INSTALL_PATH="D:\dynatrace", que acepta el ejecutable pero no la interfaz gráfica del instalador.

Paso 5 — Comprobar el servicio y los logs

Get-Service | Where-Object { $_.DisplayName -like "*Dynatrace*" } |
  Select-Object Name, DisplayName, Status, StartType

Get-ChildItem "C:\ProgramData\dynatrace\oneagent\log" -Recurse |
  Sort-Object LastWriteTime -Descending | Select-Object -First 10 FullName

El servicio debe estar en estado Running y con inicio automático. Los registros del agente se encuentran por defecto en %PROGRAMDATA%\dynatrace\oneagent\log.

Paso 6 — Reiniciar las aplicaciones instrumentadas

iisreset /restart
# ou, pour un service applicatif précis
Restart-Service -Name {nom-du-service}

Coordina este reinicio con los equipos de aplicaciones: sin él, los procesos existentes siguen siendo visibles pero no se trazan.

Paso 7 — Ajustar con oneagentctl

$ctl = "C:\Program Files\dynatrace\oneagent\agent\tools\oneagentctl.exe"
& $ctl --get-host-group
& $ctl --get-network-zone
& $ctl --set-host-group={nouveau-groupe} --restart-service

Estos comandos deben ejecutarse como administrador. Igual que en Linux, cambiar de host group afecta a las reglas y alertas asociadas.

Desplegar a gran escala

Herramienta Enfoque recomendado Punto de atención
SCCM / MECM Aplicación con línea de comandos silenciosa y detección sobre el servicio No incluir nunca el token en claro en la consola
GPO (script de inicio) Script de PowerShell idempotente que lee el instalador desde un recurso compartido Derechos de lectura del recurso compartido para las cuentas de equipo
Ansible (WinRM) win_get_url y después win_command con los parámetros Variables de grupo para host group y zona

En todos los casos, comprueba primero que el servicio existe antes de volver a lanzar el instalador, para evitar reinstalaciones innecesarias en cada ciclo.

Buenas prácticas

  • Valida la cadena de certificados del clúster en un servidor piloto antes de cualquier despliegue masivo.
  • Trabaja con un token dedicado a la descarga, con el alcance mínimo, guardado en una caja fuerte de secretos.
  • Estandariza los host groups y las network zones en tus variables de despliegue, nunca a mano.
  • Coordina de antemano las exclusiones de antivirus/EDR con el equipo de seguridad.
  • Planifica los reinicios de IIS y de servicios dentro de una ventana de cambios.
  • Vigila el consumo de unidades de host en la CMC después de cada oleada de despliegue.

Preguntas frecuentes

¿Cómo sé si la instalación silenciosa ha funcionado?

El código de retorno debe ser 0 y, después, el servicio de Dynatrace debe estar en estado Running con inicio automático. Si falla, consulta los logs en %PROGRAMDATA%\dynatrace\oneagent\log.

¿Por qué falla la llamada a la API con un error de certificado?

Casi siempre porque falta, en el almacén de certificados del equipo, la autoridad raíz de la PKI interna que firmó el certificado del clúster.

¿Hay que reiniciar IIS después de la instalación?

Sí, para Full-Stack: sin reinicio, las aplicaciones IIS, .NET y los servicios ya iniciados siguen siendo visibles pero no se trazan. Planifícalo dentro de una ventana de cambios.

Conclusión

La instalación silenciosa de OneAgent en Windows Server cabe en una línea de comandos, pero en un contexto Managed solo es fiable si el entorno está preparado: certificados internos conocidos, ActiveGates y network zones en su sitio, convenciones de nomenclatura compartidas y token protegido. Con un script de PowerShell idempotente y algunas verificaciones sistemáticas, conviertes una operación manual arriesgada en un despliegue reproducible y auditable.

span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de Dynatrace LLC. Comprueba siempre los valores (puertos, versiones, tamaños) en la documentación oficial correspondiente a tu versión.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
Déployer OneAgent sur Linux dans un environnement Managed

Desplegar OneAgent Linux en un entorno Managed

Next Post
Kubernetes et OpenShift : connecter Dynatrace Operator à un cluster Managed

Dynatrace Operator Kubernetes y OpenShift: conectarse a un clúster Managed

Related Posts