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

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 Organizational 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

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;

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

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:\private\mykey.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

Adding plugins in the Console

New in version 1.7.

To add plugins, go to Tools ‣ preference ‣ plugins Tab.

Create a plugin

Click Add to add plugins, then edit the corresponding 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 :

Insert "Explorer" as a plugin with IP variables