- A Windows machine on which to install the agent.
- .NET framework version 4.5.2 or higher
- PowerShell (Windows Management Framework) version 3 or higher
- Outbound HTTPS access to the UpGuard website.
Agent installations are ideal for environments where WinRM is not available or for endpoints such as desktops or laptops.
Downloading and Installing
- In the UpGuard website navigate to Discover and then Add Nodes via the top navigation bar.
- Type windows in the search bar to highlight all supported Windows types and click on the version of Windows you plan to register, then select to use the agent.
- First, click the Download Agent button to download the latest Windows Agent Installer.
- Run the Windows Agent Installer on the Windows device you wish to register with UpGuard and this will begin the installation and registration process.
- When prompted to enter your API Key, copy the API key from the website into the installation wizard.
- On the same screen, modify the Target URL to match the appliance you are logging in from. For example, if you are logged into an appliance from https://me.upguard.com, then this is your Target URL.
- Review “Configuration Directory” option to decide where to install the agent and configuration files.
- Click next to install the agent and register the node with the UpGuard website.
- Once the installation has completed, return to the UpGuard website and click Scan Node to have your node scanned for the first time.
The Windows agent is designed to be installed via an automated process such as a script. To see the command line arguments available, run:
For most UpGuard instances, you should be able to run an unattended install with:
UpGuard-vX.Y.Z.exe --mode unattended --target_url https://you.upguard.com --api_key <api key from step 5 above>
If you have a particularly slow network connection between your connection manager and your appliance, you can
increase the timeout on all connections during the registration process by using the
which defaults to the value of
30 representing 30 seconds. For example, here we are increasing the network
timeout to 120 seconds (2 minutes).
UpGuard-vX.Y.Z.exe --mode unattended --reg_timout=120 --target_url https://you.upguard.com --api_key ...
You can update the UpGuard agent by installing a new version right over the top of an existing install.
- Visit our downloads page to obtain the latest installer.
- New versions of the UpGuard agent can then be installed in-place.
The UpGuard agent can be uninstalled either through “Add/Remove Programs” or via the
“UpGuard Uninstaller” link located in the install directory. By default this is
Changing the Default Test Timeout
By default UpGuard will timeout any tasks which run for longer than 45 seconds. This is usually sufficient but in some cases you may want to override this value.
- Locate your
upguard.ymlfile. The default location for this is
- Update the
test_timeoutvalue to the desired value in seconds. Scan timeouts related to the scanning of Windows 2008 hotfixes and hardware often requires a value around 300 - 500 seconds.
Changing the default test timeout value only applies to the timeout of scan sections and does not affect the timeouts of node connectivity checks.