Using the WAPT console

To install and start the wapt console check this page.

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.

Add package for the host

If you want to add package directly to the computer, you have to edit the host package.

To do so, you have 3 ways :

  • double click on the host

  • Right click on the host then Edit host

  • select a host and use the Edit host button

Once edited, you just have to drag and drop wanted package(s) and confirm

Add package on host

Save do the same thing as update, Save and apply do the same thing as update & upgrade.

Check updates for the host

Check updates for the host

This button will execute 2 actions :

  1. give current state of the host to the server

  2. server displays if the host must get updates

Every configuration modification require a Check updates.

Apply updates for the host

Apply updates for the host

This button allows to apply waiting updates on the host.

Warning

Use with caution, it will force close the softwares that are currently in use.

You can use instead Apply upgrade for not running applications to prevent any loss of work

WAPT Enterprise feature only

Performing 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

Has errors

Search only for hosts for which a task has not finished correctly

Needs updating

Search only for hosts needing upgrades

Connected only

Search only for connected hosts

Only authorized computers

Search only for hosts authorized by certificate of current console user

WAPT Group

Filter hosts based on their membership / dependency to a WAPT group package

AD Site

Filter hosts based on their membership / dependency to a Site on Active Directory

AD Group

Filter hosts based on their membership / dependency to a Active Directory group

Hint

Filters work with regular expression.

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).

More détail here.

How to perform actions on the hosts?

Host configuration menu

Host configuration menu

Some actions are note present in multi selection, cf :

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.

Importing packages from external repository

Package importation principles

Importing 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 or Code signing private key to allow the deployment of the imported 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 its 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.

By default the tranquil’IT repository is present, to add another repository check parameters for configuring the external repositories;

Note

By default, the SSL/ TLS certificates to external repository are verified.

  • click on Import package and Import from Internet:

Imported WAPT package

Note

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

Imported WAPT package in your local WAPT repository
  • To import 2 possible choices :

    • Right-click ‣ Import in repository;

    Imported WAPT package
    • or in the bottom right of the Window Import in repository:

    Imported WAPT package
  • validate the importation in your local repository;

Confirm the import of the package

Confirm the importation of the package

Note

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

  • the download of the package starts …

Progress of the package importation process

Progress of the package importation 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 imported in your local WAPT repository.

Confirmation of successful importation

Confirmation of successful importation

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

WAPT console displaying the imported package

WAPT console displaying the imported package

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

It is possible to change maturity before importing package on repository.

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

It is possible to edit a package downloaded from an external repository before importing it in your main WAPT repository.

  • Pour cela 2 choix disponible :

    • Right-click ‣ Download and Edit;

    Download and Edit
    • ou en bas à droite de la fenêtre Download and Edit:

Download and Edit

PyScripter, if installed, opens the WAPT package.

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

Importing packages from local file

Importing a WAPT package from a file

You can import a .wapt file .

  • 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 imported 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 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.

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.

Changing the maturity of a WAPT package

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

Filtering on other attributes

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

Doing a search based on a WAPT package

In the repositorie, 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.

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

Once the maturity chosen a windows pop up:

Changing the maturity of a WAPT package

Many choices are available :

Label

Description

Increment the package version

Incrémente la version du paquet (après le -)

Delete old packages after successful process

Supprimer l’ancien paquet après le changement de maturité

Change package maturity

Permet de choisir quel sera la nouvelle maturité du paquet

New packages prefix

Permet de changer le préfixe du paquet

Note

you can stop the process py pressing the Abort process button.

Once finished it display the ok result

Hint

You can change the maturity of multiple packages at once

Warning

The maturiy change will change the hash of the package

If the package is used in a GPO, like waptupgrade, you’ll have to change the ash in your GPO

Creating a group package

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

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

  • Change the name in Package name;

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

Hint

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

Forbid a package

Forbid a package

Removing a WAPT package

Remove a package

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

Hint

You can select multiple packages at once to delete them

Editing a WAPT package

Editing a 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.

If PyScripter is installed, it will automaticaly open the project.

Once edited you can upload from the wapt console.

Deploying WAPT packages from the WAPT console

you can deploy packages using multiple methods.

With WAPT OU WAPT Enterprise feature only

cf Create or Edit Organizational Unit package and add packages to the dependency cf on host

With WAPT profil package WAPT Enterprise feature only

Usage cf détaillée dans la partie avancée de l’utilisation de la console.

With Group

cf creating a group package to create a group.

You can deploy a group like you would deploy any type of package.