Using the WAPT console (detailed)

Note

Some functionalities detailed here are only available with the Enterprise version of WAPT.

Software inventory as registered in the Windows registry of the host

Software inventory as registered in the Windows registry of the host

How to perform actions of the hosts?

Host configuration menu

Host configuration menu

List of actions available to be performed on the hosts from the WAPT console
Description Multi-selection
Edit the configuration of the host yes
Refresh the list of available packages yes
Offer the user to launch an upgrade yes
Send a message to the selected hosts yes
Audit the packages installed on selected hosts yes
Add one or more packages on selected hosts yes
Remove one or more packages from selected hosts yes
Prevent packages from being installed on hosts yes
Add one or more packages on selected hosts yes
Remove the host and/or the host package yes
Launch TIShelp with a remote host no
Initiate a VNC connection with the remote host no
Connect via Veyon no
Launch a RDP connection on the selected host no
Launch remote user support (msra.exe) no
Manage hosts with compmgmt.msc no
Manage Users and Groups with lusrmgr.msc no
Manage Services with services.msc no
Send a WakeOnLAN special packet to selected hosts yes
Search for applicable Windows updates yes
Download pending Windows updates yes
Trigger the installation of pending Windows updates yes
Add Active Directory groups to the selected machines yes
Trigger an inventory update on selected hosts yes
Restart the WAPT service yes

Searching a host

*Search* function in WAPT

Search function in WAPT

Allow to search for a value in the selected column.

Filters and actions available with Organisational Units

WAPT console showing options applicable to OU

WAPT console showing options applicable to OU

In the Enterprise version, you may filter how hosts are displayed based on the Active Directory OU they belong to.

The checkbox Include hosts in subfolders allows to display hosts in subfolders.

You may also choose to create unit packages by Right clicking on an OU ‣ Create or edit the unit package.

Show the inventory

When the WAPT agents register, they send some informations to the WAPT Server.

Informations displayed in the console are not updated in real-time, you have to refresh the display to view new status and informations.

Click on the Refresh button or press F5 on the keyboard.

WAPT console displaying inventory

WAPT console displaying inventory

The WAPT console lists hosts that are registered with the WAPT Server and some informations that are useful for managing the hosts.

Selecting a host displays its informations in the right panel of the WAPT console (Hardware inventory and Software inventory).

Hardware inventory displays the hardware inventory of the host

Common informations displayed in the Hardware inventory tab are:

  • the name of the host;
  • the description of the host;
  • the operating system running on the host;
  • the IP address of the host;
  • the last WAPT task that was run on the host;
  • the manufacturer of the host;
  • the model of the host;
  • the date of the latest update on the host;
  • the name of the user last or currently connected on host;
Host summary

Host summary

Status of packages in the WAPT console
Description Status
List of installed WAPT packages Status: OK
List of packages waiting to be installed Status: MISSING
List of packages pending updates Status: NEED-UPGRADE
List of packages that have failed to install Status: ERROR

When a package returns a status ERROR, click on it to show the details of the error. Errors are print messages in the setup.py of your packages.

Error detail

Error detail

Acting on packages installed on a host

Possible actions for WAPT packages

Possible actions for WAPT packages

Hint

  • multiple selection of packages is possible;
  • the host must be seen by the WAPT Server when the action is launched;
  • if several hosts are selected, the action will be launched on all selected hosts;
Acting on packages installed on a specific host
Action Description
Install a package installs the selected package on selected hosts
Force a package forces the re-installation of a selected package on selected hosts
Remove a package removes the selected package from the selected hosts
Forget a package tells the selected hosts not to use WAPT for managing the selected package
Audit the package triggers an audit on the selected package

Hardware inventory tab

Informations displayed by default in the Hardware inventory tab are:

  • informations on the host’s hardware components;
  • some informations about the host;
  • some information on the status of WAPT;
Host hardware inventory

Host hardware inventory

A Filter box allows to search for hosts.

Hint

Filters work with regular expression.

To add a column in the grid, drag and drop a hardware property from the Hardware inventory grid to the main grid.

Example: in hosts, drag and drop physical_memory in the left panel, and the column physical_memory appears in the main grid.

Adding a criteria to the main grid of the WAPT console

Adding a criteria to the main grid of the WAPT console

Software inventory tab

Common informations displayed in the Sofware inventory tab are:

  • maker
  • software name
  • software version;
  • installation date;
  • uninstall key;
  • uninstall string;
Software inventory as registered in the Windows registry of the host

Software inventory as registered in the Windows registry of the host

Windows update tab

Informations displayed in the Hardware inventory tab are:

  • Windows update agent version;

  • date of the last Windows update scan;

  • duration of the last scan;

  • WAPTWUA status;

  • date of the last version of wsusscn2.cab processed by WAPT;

  • status of WAPTWUA Enabled (True/ False);

    The grid then lists Windows cab files that have been installed or that are pending installation.

Informations displayed in the Windows Updates tab are:

  • Status;
  • Product;
  • Update ID;
  • Kbids;
  • Published on;
  • installation on;
  • Severity on;
  • Classification;
  • Title;
  • Download size;
Inventory of Windows Updates

Inventory of Windows Updates

Task tab

Informations displayed by default in the Tasks tab are:

  • pending tasks;
Details of pending tasks on the host

Details of pending tasks on the host

  • completed tasks;
Details of completed tasks

Details of completed tasks

  • tasks in error;
Details of tasks in error

Details of tasks in error

Perform a global search on all hosts

Performing global searches on all the criteria presented above is possible.

Choose the filters to check or uncheck.

Advanced search functionalities in the WAPT console

Advanced search functionalities in the WAPT console

Choice of filters
Possible options Description
Host Host section in the Hardware inventory tab when a host is selected
Hardware DMI section in the Hardware inventory tab when a host is selected
Software Software inventory section when a host is selected
Package List of packages installed on the selected hosts
Have errors Search only for hosts for which a tasks has not finished correctly
Needing upgrades Search only for hosts needing upgrades
Group selection Filter hosts based on their membership/ dependency to a group package

Hint

Filters work with regular expression.

Do a search based on a WAPT package

In the Private repository, select the package and then click on Show Hosts.

The grid will display the hosts on which the package is installed. Note that the filter is only active on the Package attribute of the selected package.

The different columns display information about the packages installed on the machine (e.g. package version, package status, audit status, installation date, architecture).

Filter by package

Filter by package

You can also add the columns Log install and Last Audit Output to display at a glance the installation and audit logs.

Creating a group package

Group packages allows to create a package containing other packages to be affected as a dependency to a host.

To create a group of packages, go to the Bundles tab:

Package group grid

Package group grid

  • click on New bundle;
  • give a name to the group package;

Hint

If you name a group package with the same name as an Active Directory security group (Microsoft or Samba-AD), member of the Active Directory group can be automatically affected to the WAPT group package.

  • fill in the description, add packages to the group package by dragging and dropping them or by Right-clicking on the package name, and adding to the bundle;
Creating a group package

Creating a group package

  • click on Save to save the bundle;

Hint

To uninstall a package, it is possible to add banned packages to a bundle.

Forbid a package

Forbid a package

In the Software Repository tab, the list of packages currently available in the WAPT repository appears. By default, the console will only show the latest version of packages.

To display all package versions, untick Last version only. To delete a package from the repository, Right-click ‣ Remove from repository.

Remove a package

Remove a package

To edit a package, Right-click ‣ Edit package, the package will be downloaded locally in the base package development directory set in console settings.

Make changes to the package as wanted, rebuild the package and upload it back to the repository. Once your package has uploaded, refresh the package list using the Refresh package list button or by pressing F5 on your keyboard.

A search bar is also available to filter packages.

Hint

With the “section” drop-down menu, you can choose to create a profile package rather than a group package

Cleaning the local cache from the WAPT console

When importing a package from Internet, the WAPT console downloads the package in %appdata%localwaptconsolecache .

To clean the cache and free up disk space, click on Tools ‣ Clean local cache.

Cleaning up the local cache

Cleaning up the local cache

Changing the password of the WAPT Server

To change the WAPT Server password, click on Tools ‣ Update password, fill in the old password and a new one.

Making changes to the WAPT console preferences

To make changes to console settings, go to Tools ‣ Preferences.

Configuration options for the WAPT console

Configuration options for the WAPT console

  • Basic tab for basic options;
Configuration options for the WAPT console

Configuration options for the WAPT console

Arguments Description Example
WAPT Server IP address URL of the WAPT Server srvwapt.mydomain.lan
URL of the main WAPT repository URL of the main WAPT repository (only if Specify manually is checked) http://srvwapt.mydomain.lan/wapt/
URL of the WAPT Server URL of the WAPT Server (only if Specify manually is checked) https://srvwapt.mydomain.lan/
Verifying the HTTPS certificate Indicates whether the HTTPS certificate must be verified yes
Path to the bundle of certificates Path to the bundle of certificates that will allow certificates to be verified Visit the documentation on activating HTTPS verification
Prefix to use when creating packages. Ex: tis or demo Prefix that is given to packages during replication. prefix
Path to the Administrator’s personal certificate Path to the certificate associated with the private key used to sign packages C:privatemykey.crt

Hint

The button Get the server certificate downloads the WAPT Server HTTPS certificate to WAPTsslserveur and tells the WAPT console to verify HTTPS connections using that bundle of certificates. The method is called Certificate pinning. Before downloding the HTTPS certificate, you must be sure that you are connecting with the right server.

  • Advanced tab for advanced options;
Configuration options for the WAPT console

Configuration options for the WAPT console

:header-rows: 1
Arguments Description Example
Path to waptdev folder Indicates the path to the directory for storing packages being developed C:waptdev
HTTP proxy to use Indicates a proxy server to be used by the WAPT console when accessing the WAPT repository or the WAPT Server http://srvproxy.mydomain.local:8080
Activating the proxy Activate proxy settings for connecting to the WAPT repository or the WAPT Server False

To make changes to console settings, go to Tools ‣ Preferences.

:header-rows: 1
Arguments Description Example
Maximum number of hosts to be displayed in the console Indicates the maximum number of hosts to be displayed in the WAPT console, so to optimize the behavior of the console. 2000
Langage Selects the langage for the WAPT console English
Showing debug informations in the WAPT console Shows debug informations in the WAPT console True
Allow third-party tools in the contextual menus of the hosts TODO True
Activate administration functionalities TODO True
Hide unavailable options TODO True

Generating a new public certificate

New in version 1.3.12.13.

Generating a new public certificate allows to actualize an existing public certificate without having to regenerate a public key/ certificate pair.

For that purpose, go to Tools ‣ Generate a new certificate

Generate a self-signed certificate

Generate a self-signed certificate

The private key is recovered from current settings, change the Common Name and regenerate a new certificate.

The old certificate will be invalidated.

New public certificate has been created

New public certificate has been created

Add plugins in Console

New in version 1.7.

Add in the menu of the machines additional actions

For that purpose, go to Tools ‣ preference ‣ plugins Tab

Todo

add CAPTURE

Generate a self-signed certificate

Click add to add plugins, then edit the corespondente columns

:header-rows: 1
Column Description
Name Name that will appear in the menu
Executable Path of the executable that will be executed after the click
Arguments Arguments passed to the executable. Some variables can be used like {ip}, {uuid} or {computer_fqdn}

Plugins will then appear in the menu :

Todo

add CAPTURE

Generate a self-signed certificate

Generate a self-signed certificate