How can we help?

How to install the Auvik collector using the Windows service

Follow

In addition to Auvik’s OVA and bash script install options, Auvik can also run as a native service on a Microsoft desktop running Windows 7 or higher, or any server running Windows Server 2008 or higher.

  1. Register for a trial.
  2. Add a new client.
  3. Have a supported Microsoft Windows system ready:

Host Operating Systems

The system where you want to install the Auvik collector should have at least one CPU, 2GB of RAM, and 1GB of available disk space. You also need to be running:

Windows 7 or higher 

Windows Server 2008 or higher

  1. Sign into your Auvik account and access a new client to download the Windows service executable. *

* The file is around 9MB so it should only take a few seconds to download. Don’t delete this file when you’re done with the Auvik installation because you’ll need it if you ever want to remove the service.

How to install the Windows service

Installing the Windows service adds two new services (Control Panel > Administrative Tools > Services) and an entry to the registry. The new services are set to automatically start, so you don’t need to worry about starting or stopping the services yourself.

Be aware that the Windows service will bind to ports 21 and 69. We recommend you install the service on a system that doesn’t already have services bound to these ports.

If you install the service on a system with multiple network cards, all cards will be used. There’s currently no way to specify which card (IP address) should be used for the Window service. For one of the network cards, if it’s a subnet that shouldn't be scanned, mark it as Don't Scan or Delete the subnet from Discovery > Manage Networks. If it’s a subnet that should be scanned and it wasn't discovered, Add the subnet from Discovery > Manage Networks.

Although you should never need to update the registry, it can be found in one of two locations:

  • 32-bit machines: HKEY_LOCAL_MACHINE\Software\Auvik\Agent\1.0
  • 64-bit machines: HKEY_LOCAL_MACHINE\Software\WOW6432Node\Auvik\Agent\1.0

To execute the script, you’ll need:

  • An email address and password for a user associated with the Auvik account
  • A domain prefix (e.g., sample.my.auvik.com) for the client where the collector is being installed
  1. From the start menu, search for Command Prompt (cmd).
  2. Right-click and select Run as administrator.
  3. From the command prompt window, change the directory to where the executable was downloaded. For example: cd Downloads or cd ..\..\Users\nanook\Downloads
  4. Copy and paste the following command into the command prompt window:
    AuvikService -install -dir c:\auvik -tenant https://DOMAINPREFIX.my.auvik.com

Usability tip: Enable the Command Prompt’s Quick Edit mode to easily make substitutions. If you want the service and logs to be on a different drive, change c:\ to your drive letter of choice.

Note: You can include -user EMAIL -password PASSWORD in the command if you’d prefer not to enter them separately. Otherwise, you’ll be asked to enter your Auvik email address and password in a later step.

Be sure to edit the following parameters within the command:

DOMAINPREFIX should be the Auvik domain prefix (e.g., sample is the prefix for https://sample.my.auvik.com/agents/installer) for the client where the collector is being installed.

  1. When requested, enter your Auvik email address and password. The email address must be for a user who has authorization on the Auvik domain the service is being installed for.

The output from the installation should appear something like this:

C:\Users\nanook\Downloads>AuvikService -install -dir c:\auvik -tenant https://nanook.my.auvik.com
Please enter your Auvik login email address: nanook@auvik.com
Please enter your Auvik password:
Provisioning service from https://nanook.my.auvik.com...success!
Installing c:\auvik\AuvikAgentService.exe
AuvikAgent is installed.
Starting AuvikAgent.
Installing c:\auvik\AuvikWatchdogService.exe
AuvikWatchdog is installed.
Starting AuvikWatchdog.

How to uninstall the Windows service

Uninstalling the Windows service requires you to:

  • Instruct the AuvikService to uninstall and terminate itself.
  • Delete the appropriate registry key on the machine.
  • Delete the Auvik service installation folder.

We urge caution when deleting anything from the Windows registry.

  1. From the start menu, search for Command Prompt (cmd).
  2. Right-click and select Run as administrator.
  3. From the command prompt window, change the directory to where the executable was downloaded. For example: cd Downloads or cd ..\..\Users\nanook\Downloads
  4. Run the following command: AuvikService -remove

The output for removing the service should appear something like this:

C:\Users\nanook\Downloads>AuvikService -remove
Stopping AuvikAgent.
AuvikAgent is stopped.
Stopping AuvikWatchdog.
AuvikWatchdog is stopped.
  1. From the command prompt, enter regedit.
  2. From the registry editor, find the Auvik folder.
32-bit machines: HKEY_LOCAL_MACHINE\Software\Auvik\Agent\1.0 
64-bit machines: HKEY_LOCAL_MACHINE\Software\WOW6432Node\Auvik\Agent\1.0
  1. Right-click the Auvik folder and select Delete.
  2. Click Yes to confirm the registry key should be deleted.
  3. Close the registry editor.
  4. Close the command prompt.
  5. Open Windows Explorer and browse to the location the service was installed. E.g., the c:\ drive
  6. Right-click the Auvik folder and select Delete.
Have more questions? Submit a request

Comments

Powered by Zendesk