This section of the documentation covers the daily use of WAPT.

All WAPT functionalities are explained in detail for the Administrators, the Users and the Package Deployers.

Managing the WAPT Agent on Windows

Deploying the WAPT Agent on Windows

Note

To install WAPT on a Windows client, the minimal requirements are:

  • 512Mo Ram;

  • 1 CPU;

  • 300Mo Drive space (without package cache).

Attention

If you install the WAPT Agent on Windows Server 2012r2, it needs these features need to be activated before installing the WAPT Agent:

Two methods are available to deploy the waptagent.exe.

  • The first method is manual and the procedure MUST be applied on each host.

  • The second one is automated and relies on a GPO.

Note

The waptagent.exe installer is available at WAPT serveur web home page. The direct download link is for example: https://srvwapt.mydomain.lan/wapt/waptagent.exe.

Warning

If you do not sign the waptagent.exe installer with a commercial Code Signing certificate or a Code Signing certificate issued by the Certificate Authority of your Organization after having generated it, web browsers will show a warning message when downloading the installer.

To remove the warning message, you MUST sign the .exe with a Code Signing certificate that can be verified by a CA bundle stored in the host’s certificate store.

Manually

Attention

Manually installing the WAPT Agent requires Local Administrator rights on the computer.

Manually installing the WAPT Agent using a Domain Admin account WILL NOT WORK.

Hint

When to deploy the WAPT Agent manually?

Manual deployment method is efficient in these cases:

  • Testing WAPT.

  • Using WAPT in an organization with a small number of computers.

  • If you do not have a means of mass deployment.

  • Download the WAPT Agent from your WAPT Server then launch the installer.

The WAPT Server interface in a web browser

The WAPT Server interface in a web browser

  • Choose the language for the WAPT installer.

Choosing the language for deploying the WAPT installer
  • Click on OK to go on to the next step.

Accepting the WAPT license terms
  • Accept the licence terms and click on Next to go to next step.

  • Choose additional configuration tasks (leave the default if not sure).

Choosing the installer options for deploying the WAPT Agent

Choosing the installer options for deploying the WAPT Agent

Avialable options

Settings

Description

Default value

Install WAPT service

Adds the WAPT service on the computer.

Checked

Launch notification icon upon session opening

Launches the WAPT Agent in the System tray on startup.

Not checked

Disable hiberboot, and increase shutdown GPO timeout (recommended)

Disables Windows fast startup for stability, increases the timout for the WAPT Exit utility.

Checked

Use a random UUID to identify the computer instead of BIOS

Solves possible BIOS UUID bugs.

Not checked

  • Choose the WAPT repository and the WAPT Server and click on Next to go to next step.

Choosing the WAPT repository and the WAPT Server

Choosing the WAPT repository and the WAPT Server

  • Install the WAPT Agent by clicking on Install.

Dialog box showing the summary of the installation options
  • Wait for the installation of the WAPT Agent to finish, then click on Finish to exit.

Dialog box showing the WAPT installation in progress

The installation of the WAPT Agent is finished. The registration of the host with the WAPT Server is done automatically.

Installation Wizard has finished

To manage your Organization’s WAPT clients, visit the documentation on using the WAPT Console.

Automatically

Important

Technical pre-requisites

Advanced network and system administration knowledge is required to achieve this procedure. A properly configured network will ensure its success.

Hint

When to deploy the WAPT Agent automatically?

The following method is useful in these cases:

  • A large organization with many computers.

  • A Samba Active Directory or Microsoft Active Directory for which you have enough administration privileges.

  • The security and the traceability of actions are important to you or to your Organization.

With the WAPT Deployment utility

waptagent.exe is an InnoSetup installer, it can be executed with these silent argument:

waptagent.exe /VERYSILENT
  • Additional arguments are available for the WAPT Deployment utility.

Description of available options for deploying the WAPT Agent silently

Options

Description

/dnsdomain = mydomain.lan

Domain in wapt-get.ini filled in during installation.

/wapt_server = https://srvwapt.mydomain.lan

URL of the WAPT Server in wapt-get.ini filled in during installation.

/repo_url = https://repo1.mydomain.lan/wapt

URL of the WAPT repository in wapt-get.ini filled in during installation.

/StartPackages = basic-group

Group of WAPT packages to install by default.

:code:/verify_cert = ``True or relative path ssl\server\srvwapt.mydomain.lan.crt.

Value of verify_cert entered during installation.

/CopyServersTrustedCA = path to a bundle to copy to ssl\server

Certificate bundle for https connections (to be defined by verify_cert).

/CopypackagesTrustedCA = path to a certificate bundle to copy into ssl

Certificate bundle for verifying package signatures.

Hint

The .iss file for the InnoSetup installer is available in C:\Program Files (x86)\wapt\waptsetup\waptsetup.iss.

You may choose to adapt it to your specific needs. Once modified, you will just have to recreate a waptagent.

To learn more about the options available with InnoSetup, visit this documentation

The WAPT Deployment utility is a small binary that:

  • Checks the version of the WAPT Agent.

  • Downloads via https the waptagent.exe installer.

  • Launches the silent installer with arguments (checked options defined during the compilation of the WAPT Agent).

/VERYSILENT /MERGETASKS= ""useWaptServer""
  • Updates the WAPT Server with the WAPT Agent status (WAPT version, package status).

Warning

The WAPT Deployment utility MUST be started as Local Administrator, that is why a GPO is a good method to deploy the WAPT Agent.

Download waptdeploy.exe from your WAPT Server homepage.

The WAPT Server interface in a web browser

The WAPT Server interface in a web browser

With a GPO

  • Create a new group strategy on the Active Directory server (Microsoft Active Directory or Samba-AD).

  • Add a new strategy with Computer configuration ‣ Policies ‣ Windows Settings ‣ Scripts ‣ Startup ‣ Properties ‣ Add.

Creating a group strategy to deploy the WAPT Agent

Creating a group strategy to deploy the WAPT Agent

  • Click on Browse to select the waptdeploy.exe.

Finding the WAPT Deployment utility file on your computer

Finding the WAPT Deployment utility file on your computer

  • Copy waptdeploy.exe in the destination folder.

Selecting the the WAPT Deployment utility script

Selecting the the WAPT Deployment utility script

  • Click on Open to import the waptdeploy.exe.

Selecting the the WAPT Deployment utility script

Selecting the the WAPT Deployment utility script

  • Click on Open to confirm the importation of the the WAPT Deployment utility binary.

Hint

It is necessary to provide the checksum of the waptagent.exe as an argument to the the WAPT Deployment utility GPO. This will prevent the remote host from executing an erroneous / corrupted waptagent binary.

--hash=checksum WaptAgent --minversion=1.2.3 --wait=15 --waptsetupurl=http://srvwapt.mydomain.lan/wapt/waptagent.exe

Parameters and waptagent.exe checksum to use for the the WAPT Deployment utility GPO are available on the WAPT Server by visiting https://srvwapt.mydomain.lan.

Web console of the WAPT Server

Web console of the WAPT Server

  • Copy the required parameters into the GPO.

Adding the the WAPT Deployment utility script to the startup GPO

Adding the the WAPT Deployment utility script to the startup GPO

  • Click on OK to go on to the next step.

The WAPT Deployment utility GPO to be deployed on next startup

The WAPT Deployment utility GPO to be deployed on next startup

  • Click on OK to go on to the next step.

  • Apply resulting GPO strategy to the Organization’s Computers OU.

Note

We recommend adding waptdeploy.exe to the startup and shutdown scripts on the GPO.

Hint

More arguments are available for the WAPT Deployment utility

Description of available options for the WAPT Deployment utility

Options

Description

--force

Forces the installation of waptagent.exe even if alread installed.

--hash = <sha256hash>

Check that the downloaded waptagent.exe setup sha256 hash matches the hash.

--help

Displays the options

--minversion = <version>

Install waptagent.exe if installed version is less than minversion.

--tasks = autorunTray,installService,installredist2008,autoUpgradePolicy

If given, it passes the arguments to the /TASKS options of the waptagent installer (default installService, installredist2008, autoUpgradePolicy).

--repo_url = <repo_url>

Location of the repository to get waptagent.exe (default <repo_url>/wapt)

--setupargs = <setupargs>

Adds arguments to the command line of waptagent.exe.

--wait = <minutes>

Defines the delay for running and pending tasks to complete if waptservice is running before installing.

--waptsetupurl = <waptsetupurl>

Explicit location to download setup executable. It can be a local path (default <repo_url>/waptagent.exe).


With a scheduled task

You may also choose to launch the WAPT Deployment utility using a scheduled task that has been set by GPO.

Hint

This method is particularly effective for deploying WAPT on workstations when the network is neither available on starting up or shutting down.

The method consists of using a GPO to copy locally waptdeploy.exe and waptagent.exe and create a scheduled task for installing.

  • Copy waptdeploy.exe and waptagent.exe in the netlogon share of your Active Directory Server (\mydomain.lan\netlogon\waptagent.exe).

  • Create a new group strategy on the Active Directory server (Microsoft Active Directory or Samba-AD).

  • Add a new strategy with Computer configuration ‣ Preferences ‣ Windows Settings ‣ Files.

  • Create a new file and copy the WAPT Deployment utility.

Selecting a new file to include in the GPO
  • Set parameters.

Description of options for copy

Options

Value

Action dropdown menu list

Replace

Source file(s) field

\mydomain.lan\netlogon\waptdeploy.exe

Destination File field

C:\Temp\waptdeploy.exe

Suppress errors on individual file actions checkbox

not checked

Read-only checkbox

not checked

Hidden checkbox

not checked

Archive checkbox

checked

WAPT Agent installation progress

WAPT Agent installation progress

  • Create a new GPO and copy the waptagent.exe file.

Selecting a new file to include in the GPO
  • Set parameters.

Description of options for copy

Options

Value

Action dropdown menu list

Replace

Source file(s) field

\mydomain.lan\netlogon\waptagent.exe

Destination File field

C:\Temp\waptagent.exe

Suppress errors on individual file actions checkbox

not checked

Read-only checkbox

not checked

Hidden checkbox

not checked

Archive checkbox

checked

Preparing the WAPT update GPO

Preparing the WAPT update GPO

  • Then go to the Scheduled Task menu with Computer configuration ‣ Preferences ‣ Control Panel Settings ‣ Scheduled Tasks.

  • Create a new Scheduled Task with Right-click ‣ New ‣ Scheduled Task (At least Windows 7).

Create the scheduled task for the WAPT Deployment utility Properties window in RSAT

Create the scheduled task for the WAPT Deployment utility Properties window in RSAT

General tab in the Properties window in RSAT

General tab in the Properties window in RSAT

  • Set Action to Replace.

  • For When running the task, use the following user account paste S-1-5-18 (system account). You can visit for more information.

  • Check Run whether user is logged on or not.

  • Check Run with highest privileges, then go on to the Triggers tab.

Trigger tab in the Properties window in RSAT

Trigger tab in the Properties window in RSAT

  • Create a new trigger.

  • Check Daily, select today’s date.

  • Check Repeat Task every and select 1 hour and for a duration of select 1 day.

  • Check Stop task if it runs longer than and select 2 hours.

  • Check that Enabled is checked, and then go to the Actions tab.

Actions tab in the Properties window in RSAT

Actions tab in the Properties window in RSAT

  • Create a new action Start a program for waptdeploy.exe.

Actions tab in the Properties window in RSAT

Actions tab in the Properties window in RSAT

Description of options to copy

Options

Value

Action

Start a program

Program / script

C:\Temp\waptagent.exe

Add arguments (optional)

See the next point

Start in (optional)

empty

Hint

It is necessary to provide the checksum of the waptagent.exe as argument to the WAPT Deployment utility. This will prevent the remote host from executing an erroneous / corrupted waptagent binary.

--hash=checksum WaptAgent --minversion=1.2.3 --wait=15 --waptsetupurl=http://srvwapt.mydomain.lan/wapt/waptagent.exe

Parameters and the waptagent.exe checksum to use for the the WAPT Deployment utility GPO are available on the WAPT Server by visiting https://srvwapt.mydomain.lan.

Web console of the WAPT Server

Web console of the WAPT Server

  • Copy the required parameters and change waptsetupurl to C:\Temp\waptagent.exe.

    --hash=checksum WaptAgent --minversion=1.2.3 --wait=15 --waptsetupurl=C:\Temp\waptagent.exe
    
Description of available options for the WAPT Deployment utility

Options

Description

--force

Installs waptagent.exe even if not needed

--hash = <sha256hash>

Checks that the downloaded waptagent.exe setup sha256 hash matches the hash.

--help

Displays the options.

--minversion = 1.2.3

Installs waptagent.exe if installed version is less than minversion.

--tasks = autorunTray,installService,installredist2008,autoUpgradePolicy

If given, passes this arguments to the /TASKS options of the waptagent installer. Default = installService, installredist2008, autoUpgradePolicy

--repo_url = https://srvwapt.mydomain.lan/wapt

Defines the location of the repository to get the waptagent.exe.

--setupargs = <options>

Adds arguments to the command line of waptagent.exe.

--wait = <minutes>

Defines the maximum allowed time for running and pending tasks to complete if the WAPT service is running before installing.

--waptsetupurl = https://srvwapt.mydomain.lan/wapt/waptagent.exe

Defines an explicit location to download setup executable. This can be a local path (default=:file:<repo_url>/waptagent.exe).

  • Go on to the Settings tab.

    Settings tab in the Properties window in RSAT

    Settings tab in the Properties window in RSAT

  • In the Settings tab, only check Run task as soon as possible after a scheduled start is missed.

Hint

To verify that the GPO is working, you can run the gpupdate /force command and verify that the scheduled task is present on the computer by launching Task Scheduler as a Local Administrator.

Updating the WAPT Agent on Windows

For each WAPT Server’s upgrade, you will have to upgrade the WAPT Agents.

To do so, you have to generate the WAPT Agent and deploy it.

Manually

You can do that manually by following this documentation on installing the WAPT Agent.

Hint

It is the only upgrade solution available for now for macOS and Linux.

Via waptupgrade

While you generate the WAPT Agent, package named waptupgrade is created.

This package is a standard WAPT package designed to upgrade the WAPT Agents on remote hosts.

Hint

For now, waptupgrade only works for Windows. Waptupgrade does not upgrade the WAPT Agent if the WAPT Server version and the WAPT Agent version are the same.

Upgrading the WAPT Agents using the waptupgrade package is a two step process:

  • First the package copies the waptsetup.exe file on the client computer and creates a scheduled task that will run waptsetup.exe with predefined installation flags two minutes after the creation of the scheduled task. At that point the package itself is installed and the inventory on the WAPT Server shows the package installation as OK, with the correct version installed, but the inventory will still show the old version as the WAPT Agent is not yet updated.

  • After two minutes, the scheduled task starts and runs waptsetup.exe with a predefined configuration created in the WAPT Console. This new method keeps the waptsetup.exe signed by Tranquil IT, but the WAPT Agent configuration will come from the WAPT Server. waptsetup.exe shutdowns the local WAPT service, upgrades WAPT locally, and then restarts the WAPT service. The scheduled task is then automatically removed and the WAPT Agent starts sending back its inventory to the WAPT Server. From then on, the inventory on the WAPT Server will show the new version of the WAPT Agent.

It is recommanded to install waptupgrade on all hosts for the WAPT Agents to update automatically.