Using the WAPT console

If you have not done so already, install the WAPT agent on a computer.

The installation of the WAPT agent on computers will register them on the WAPT inventory server.

The hosts will then appear in the WAPT console.

To install the WAPT agent manually on a computer, check the documentation for installing the WAPT agents.

Note

If you have skipped the step for creating the WAPT agent, return to the documentation on building the WAPT agent installer.

On your management computer, hosts are displayed in the WAPT console.

Inventory of hosts registered with WAPT

Inventory of hosts registered with WAPT

Note

If a host does not appear in the console after having installed the WAPT agent, open the Windows command line utility cmd.exe on the host and type wapt-get register.

Performing a global search on all hosts

Showing the inventory

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

Information displayed in the console is not updated in real-time, you have to refresh the display to view new status and information.

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 information that is useful for managing the hosts.

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

How to perform actions on the hosts?

Host configuration menu

Host configuration menu

List of actions available to be performed on the hosts from the WAPT console

Name

Multi-selection

Edit host

no

Check updates

yes

Apply upgrades

yes

Apply upgrades for applications not currently running

yes

Propose upgrades for applications not currently running

yes

Send a message to users

yes

Run package audits

yes

Add packages to host dependencies

yes

Remove packages from host dependencies

yes

Re-sign host packages

yes

Add package to host conflicts

yes

Remove package from host conflicts

yes

Remove the host

yes

Connect via RDP

no

Remote Assistance

no

Mesh remote desktop

yes

Windows Computer management

Update AD Group Policies on hosts

yes

Run CleanMgr on host

no

Computer management

no

Local users and groups management

no

Service management

no

Power ON with WakeOnLan

yes

Reboot computers

no

Shutdown computers

no

Trigger the scan of missing Windows updates

yes

Trigger the download pending Windows updates

yes

Trigger the install of pending Windows updates

yes

Refresh host inventory

yes

Trigger a restart of waptservice

yes

Note

For description of this actions, refer to Detailed actions on the hosts.

Duplicating packages from external repository

Package duplication principles

Duplicating a WAPT package consists of:

  • importing an existing WAPT package from an external repository;

  • changing its prefix (for example from tis to test);

  • resigning the WAPT package with the Administrator’s private key to allow the deployment of the duplicated package on your WAPT equipped hosts;

  • finally, uploading it on the main WAPT repository;

Attention

By importing a package in your repository and signing it, you then become responsible for that package and for what it does. It has been signed with your own private key.

Tranquil IT disclaims any liability if you choose to use WAPT packages retrieved from her repositories. Without a support contract, Tranquil IT does not guarantee the suitability of the package for your own particular use case, nor do they guarantee the ability of the package to comply with your Organization’s internal security policies.

  • go to the Private repository tab;

    Available software displayed in the WAPT console

    Available software displayed in the WAPT console

Every software package version available on the WAPT repository is shown.

If no package has been imported, the list is empty. Only the test-waptupgrade package will be present if the WAPT agent has been generated previously. Visit the documentation on creating a WAPT agent.

Two options are available to import packages:

Import a package from an external repository on the Internet

That first method allows you to download packages directly from a WAPT repository external to your Organization.

To import from a different repository than Tranquil IT, define a new repository address in the WAPT console preferences. For more informations check the documentation on configuring the external repositories;

Note

  • If no repository is set, the repository https://wapt.tranquil.it/wapt will be implicitly set.

  • Starting with WAPT 1.3.12.13, external repository SSL/ TLS certificates are verified by default.

  • click on Import package and Import from Internet;

    Import a package from Internet

    Import a package from Internet

The grid view displays the list of available packages on the remote repository. It is possible to choose the plateform, the OS and the language.

  • to import a package, select a package then Right-click ‣ Import;

Imported WAPT package in your local WAPT repository

Imported WAPT package in your local WAPT repository

  • validate the duplication in your local repository;

    Confirm the duplication of the package

    Confirm the duplication of the package

    Note

    It possible to change the maturity of a WAPT package before importing the package into your private repository.

  • click on Yes to confirm the duplication;

  • the download of the package starts …

    Progress of the package duplication process

    Progress of the package duplication process

  • then, enter your private key password;

    Enter the password for unlocking the private key

    Enter the password for unlocking the private key

The WAPT console confirms that the package has been duplicated in your local WAPT repository.

Confirmation of successful duplication

Confirmation of successful duplication

The package then appears in your local WAPT repository with your Organization’s prefix.

WAPT console displaying the duplicated package

WAPT console displaying the duplicated package

Attention

If the verification of the package signature is enabled, the public certificate of the signer must be located in one of the following folders:

  • C:\Program Files (x86)\wapt\ssl;

  • %appdata%\waptconsole\ssl;

If the certificate is not found in one of these two folders, then the following error will occur and the package will not be imported.

Error while validating the signature of the external repository

Error while validating the signature of the external repository

Changing the maturity of a WAPT package before importing it into the repository

Starting with WAPT 2.0, it is possible to change maturity before importing package on repository.

To achieve this, choose option Default package maturity and choose your maturity.

Choosing the maturity of the WAPT package before import

Choosing the maturity of the WAPT package before import

Editing a package before importing it

Starting with WAPT 1.3.12.13, it is now possible to edit a package downloaded from an external repository before importing it in your main WAPT repository.

To achieve this, choose instead the second option Download and Edit to import the package from an external WAPT repository.

Process for importing and editing a package

Process for importing and editing a package

PyScripter, if installed, opens the WAPT package.

Please refer to the documentation on creating WAPT packages from scratch.

Importing a WAPT package from a file

That second method allows you to import a .wapt file from any medium.

  • click on Import package and then Import from file;

    Import from a file

    Import from a file

  • select the file to import;

    Selecting the file to import

    Selecting the file to import

  • click on Open to import the file;

The WAPT console confirms that the package has been duplicated in your local WAPT repository.

File imported successfully

File imported successfully

The package then appears in your local WAPT repository with your Organization’s prefix.

Imported WAPT package showing in your local WAPT repository

Imported WAPT package showing in your local WAPT repository

Note

It is not possible to change the maturity before importing here.

Changing maturity of a WAPT package after import on a repository

When a package is imported on a WAPT repository it is possible to change the maturity by rigth-clicking on the WAPT package. Choose your maturity on Change packages maturity menu.

Changing the maturity of a WAPT package

Changing the maturity of a WAPT package

Changing the prefix and re-signing a WAPT package

When importing, the changing of the prefix and the re-signing of the WAPT package are transparent and automatic.

Once the package is ready, the WAPT package is uploaded onto the main WAPT repository.

Creating a group package

Group packages allows you 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 WAPT Packages tab, then click on Make package template from setup file and finally choose Group;

Package group grid

Package group grid

  • click on New bundle;

  • 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 it to the bundle;

Creating a group package

Creating a group package

  • click on Save to save the bundle;

Indication

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

Forbid a package

Forbid a package

Managing packages on repository

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

A search bar is also available to filter packages. It is possible to specify a filter.

Displaying all packages

To display all package versions, untick Last version only.

Filtering on package type

To display a specific package type, use Filter packages:

Types of packages are:

  • all;

  • base;

  • group;

  • profile;

  • selfservice;

  • unit;

  • waptwua;

Filtering on WAPT package type

Filtering on WAPT package type

Others filters

Other available filters are:

  • architecture:

    • x86;

    • x64;

  • OS:

    • all;

    • Windows;

    • macOS;

    • Linux;

  • locale:

    • en;

    • fr;

    • de;

    • it;

    • es;

  • maturity (for default):

    • PROD;

    • PREPROD;

    • DEV;

Filtering on other attributes

Filtering on other attributes

Doing a search based on a WAPT package

In the Softwares 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.

Removing a WAPT package

To delete a package from the repository, Right-click ‣ Remove from repository.

Remove a package

Remove a package

Editing a WAPT package

To edit a package, Right-click ‣ Edit package, the package will be downloaded locally in the base package development directory set in the 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 packages list button or by pressing F5 on your keyboard.

Deploying WAPT packages from the WAPT console

On agent

With Group

=> Using profile bundles in WAPT

With WAPT OU

Create or Edit Organizational Unit package

  • edit the host onto which you want to deploy a WAPT package;

    Note

    Selecting multiple hosts using common shortcut keys Control-A or Shift-Arrow is possible.

    Selecting the host to configure

    Selecting the host to configure

  • A window opens, on the right side appears the list of packages available on the local WAPT repository, and on the left side it shows the list of packages currently assigned to the host.

  • drag and drop packages from the right pane to the left pane;

    Drag and drop the package on the host or the selection of hosts

    Drag and drop the package on the host or the selection of hosts

  • clicking on Save and Apply to hosts will launch the installation of the package(s) immediately on the selected host(s) that are connected to the WAPT Server;

  • clicking on Save will save the current configuration. Upgrading of the packages will occur during the WAPT agents” next update cycle;

    Saving and applying configuration on selected host(s)

    Saving and applying configuration on selected host(s)

    Update process launched

    Update process launched

To launch the installation of WAPT packages, click successively on Update available packages then Apply updates.

Applying updates

Applying updates

The installation of the WAPT package(s) is launched on the selected host(s) connected to the WAPT Server.

Acting on packages installed on a host

Possible actions for WAPT packages

Possible actions for WAPT packages

Indication

  • 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;

Available parameters for the [option] section of waptserver.ini

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 WAPT Enterprise feature only

triggers an audit on the selected package