Skip to content

Install the OpenAEV agent on Windows

This page lists the Windows requirements, the installation modes and how to uninstall the agent. Get the install command from the Install simulation agents page (see OpenAEV agent). "Best effort" support levels are explained in Best effort support.

Operating system & architecture

Architecture Support level
x64 ✅ Supported
ARM64 ✅ Supported
x86 (32-bit) ❌ Not supported
ARM32 ❌ Not supported
Operating system Support level Notes
Windows 10 ✅ Supported
Windows 11 ✅ Supported
Windows Server 2019 ✅ Supported
Windows Server 2022 ✅ Supported
Windows 8 / 8.1 ⚠️ Best effort No guaranteed fixes
Windows Server 2016 ⚠️ Best effort No guaranteed fixes
Windows Server 2012 R2 ⚠️ Best effort No guaranteed fixes
Windows 7 and earlier ❌ Not supported
Windows Server 2008 / 2008 R2 ❌ Not supported

Runtime & tooling

Note

If the installation fails, try using PowerShell 7 or higher.

  • TLS 1.2 or higher must be available
  • The system Path environment variable must include: %SYSTEMROOT%\System32\ and %SYSTEMROOT%\System32\WindowsPowerShell\v1.0\

Privileges & security

Antivirus

  • Antivirus exclusions are mandatory and must apply only to the runtimes directory

Installation mode

[UserSanitized] in the table below means username without special character like "\", "/",...

Installation mode Installation Execution agent and Threat Arsenal Action Verification/Start/Stop agent Folder path AV exclusions
Standard installation (session) Asset with GUI and terminal with standard privileges or admin privileges for the logged-in user Background, only when user is logged in, with the user privilege from the powershell elevation and environment Get-Process openaev-agent \| Where-Object { $_.Path -eq "[FOLDER_PATH]\openaev-agent.exe" }
Get-Process openaev-agent \| Where-Object { $_.Path -eq "[FOLDER_PATH]\openaev-agent.exe" } \| Stop-Process -Force
Start-Process "[FOLDER_PATH]\openaev-agent.exe"		 $HOME\.openaev\OAEVAgent-Session-[UserSanitized]
OR
$HOME\.openaev\OAEVAgent-Session-Administrator-[UserSanitized]		 $HOME\.openaev\OAEVAgent-Session-[UserSanitized]\runtimes
OR
$HOME\.openaev\OAEVAgent-Session-Administrator-[UserSanitized]\runtimes
Advanced installation as User (service) Enable the "Service Logon" policy (see above)
Terminal with admin privileges, replace -User USER -Password PASSWORD in the
PowerShell snippet by the username with domain and password wanted		 Background, as soon as the machine powers on, with the user privilege and environment Get-Service -Name "OAEVAgent-Service-[UserSanitized]"
Start-Service -Name "OAEVAgent-Service-[UserSanitized]"
Stop-Service -Name "OAEVAgent-Service-[UserSanitized]"		 $HOME\.openaev\OAEVAgent-Service-[UserSanitized] $HOME\.openaev\OAEVAgent-Service-[UserSanitized]\runtimes
Advanced installation as System (service) Terminal with admin privileges for the authority system user Background, as soon as the machine powers on, with the SYSTEM privilege and environment Get-Service -Name "OAEVAgentService"
Start-Service -Name "OAEVAgentService"
Stop-Service -Name "OAEVAgentService"		 C:\Program Files (x86)\Filigran\OAEV Agent C:\Program Files (x86)\Filigran\OAEV Agent\runtimes

Uninstall the agent

  1. For a Standard installation (session), stop the agent:

    Get-Process openaev-agent | Where-Object { $_.Path -eq "[FOLDER_PATH]\openaev-agent.exe" } | Stop-Process -Force

  2. Run uninstall.exe from the installation folder (see the Folder path column above) and confirm. It stops and removes the service or the startup task, then deletes the folder. For the service modes, run it as administrator.

  3. For an Advanced installation as User (service), disable the Log on as a service policy for the user if it no longer needs it.

What's next?