2. Using the WAPT Console

To install and start the WAPT Console visit the documentation for installing the WAPT Console.

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

Note

The recommended size for using the WAPT console is 1920x1080 and the minimum size is 1280x1024.

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

2.1. Showing the inventory

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

Information displayed in the WAPT 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.

The WAPT Console displaying the WAPT inventory

The WAPT Console displaying the WAPT 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).

2.2. How to perform actions on the hosts?

Host configuration menu list in the WAPT Console

Some actions are not available when selecting multiple hosts.

List of actions available on a selection of hosts in the WAPT Console

Name

Multi-selection

Edit host

Feature not available

Check updates

ok

Apply upgrades

ok

Apply upgrades for applications not currently running

ok

Propose upgrades for applications not currently running

ok

Send a message to users

ok

Run package audits

ok

Add packages to host dependencies

ok

Remove packages from host dependencies

ok

Re-sign host packages

ok

Add package to host conflicts

ok

Remove package from host conflicts

ok

Remove the host

ok

Connect via RDP

Feature not available

Remote Assistance

Feature not available

Mesh remote desktop

ok

Windows Computer management

Feature not available

Update AD Group Policies on hosts

ok

Run CleanMgr on host

Feature not available

Computer management

Feature not available

Local users and groups management

Feature not available

Service management

Feature not available

Power ON with WakeOnLan

ok

Reboot computers

Feature not available

Shutdown computers

Feature not available

Trigger the scan of missing Windows updates

ok

Trigger the download pending Windows updates

ok

Trigger the install of pending Windows updates

ok

Refresh host inventory

ok

Trigger a restart of waptservice

ok

2.3. Send message to selected hosts

With option Send message to users, when you do a right-click on select hosts, you can send a html formatted message to connected users.

You can send html format only, no css nor javascript. It is possible to send images, gifs… anything as long you can encode it with html.

Here is an example of code to send a text and an image. Images and gif have to be in base64 encoded or else you may use the base64image id.

<h1>Hello from Tranquil IT</h1>
  <h2>Discover WAPT Enterprise !</h2>
   <body>
   <img
      id='base64image'
     src="https://www.tranquil.it/wp-content/uploads/388_134.png">
   </body>
  <h2>Thanks.</h2>

When you create your message, you will have a preview on the right.

Send message to connected users from the inventory tab

When you have finished, click on Send, here is how your user will see it.

Result of sent message to connected users from the inventory tab

The first icon above can be customized. Please see how to use a custom icon in your waptmessage.

2.4. Importing WAPT packages from external repositories

Importing a WAPT package consists of:

  • Importing an existing WAPT package from an external repository.

  • Changing its prefix (for example from tis to my-prefix).

  • Re-signing the WAPT package with the Administrator’s or the 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 does she guarantee the ability of the package to comply with your Organization’s internal security policies.

Tranquil IT uses a package build farm to maintain its repository up to date, which is nicknamed LUTI (from the French word “l’outil”). LUTI status is now available publicly at https://luti.tranquil.it.

LUTI monitors when possible the software vendor web site to trigger a package update. It will check the software installer file status on virustotal, and then test the install, uninstall and upgrade of the package. The build results are available in the https://wapt.tranquil.it/wapt-testing repository.

After 5 days, if the virustotal status of the package has not changed, the new package will be uploaded to WAPT main store repository. There is an exception to this rule for web browsers, which are uploaded from wapt-testing to wapt repository after 1/2 an hour.

  • Go to the Private repository tab.

Available WAPT packages displayed in the WAPT Console

Available WAPT packages displayed in the WAPT Console

Every WAPT package version loaded 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.

2.4.1. Importing a WAPT package from an external repository on the Internet

This method allows you to download WAPT packages directly from a WAPT repository that is outside of your Organization.

By default the Tranquil IT repository is configured. To add another repository, check the documentation for configuring external repositories.

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

  • Click on Import package and Import from Internet.

Menu list for importing a WAPT package into the WAPT repository

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 the local WAPT repository

Imported WAPT package in the local WAPT repository

  • There are 2 methods for importing a WAPT package:

    • Right-click ‣ Import in repository;

    Menu list for importing a WAPT package into the WAPT repository
    • Or in the bottom right of the Window Import in repository.

Hint

You can check the package with Virus Total in order to check if the package is not flagged in the Antivirus list.

  • Validate the importation in your local repository. It is possible to change the maturity of a WAPT package before importing the WAPT package into your private repository.

Dialog box to prepare and confirm the import of a WAPT package into a WAPT repository

Dialog box to prepare and confirm the import of a WAPT package into a WAPT repository

Hint

You can update all your packages from your repository by checking Newer packages than mine only and Last version only, then use Ctrl+A to select all newer packages that are available on the Tranquil IT store and that you have on your repository in a older version, then click on Import in repository.

You can search WAPT package that are not in your local repository if you check Not in my Repository.

Checkbox to select newer version and last version of a WAPT package from Internet

Checkbox to select newer version and last version of a WAPT package from Internet

  • The download of the WAPT package starts.

Progress of the package import process

Progress of the package import process

  • Then, enter your private key password.

Entering the password for unlocking the private key in the WAPT Console

Entering the password for unlocking the private key in the WAPT Console

The WAPT Console confirms that the WAPT package has been imported into the local WAPT repository.

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

WAPT Console displaying the imported WAPT package

WAPT Console displaying the imported WAPT package

2.4.1.1. Downloading a restricted package version from your repository

Note

  • The WAPT Enterprise thematic store service is currently in “beta” version.

  • The WAPT Enterprise theme store is reserved for customers with a valid WAPT Enterprise license.

  • Packages downloaded from the WAPT Enterprise store can be deployed on all workstations with a WAPT Enterprise license.

  • It is the customer’s responsibility to validate the license of the software he is deploying and to respect the constraints related to this license (depending on the software: paying license, deployment in a given context e.g. educational environment only, etc.)

To meet the needs of its WAPT Enterprise customers, Tranquil IT launched a thematic store program in partnership with its WAPT Enterprise customers in the education and research.

Currently 350 packages have been prepared by Tranquil IT teams and are progressively put online progressively on the wapt store.

To download a package from the thematic store, it is necessary to be identified.

The support of the authentication of the store in the console is supported from the next WAPT 2.4 version. If you are in WAPT 2.3 version, you have to download the package from the website and import it into your WAPT console.

To authenticate yourself on the thematic store, follow the procedure below:

  • Connect to the following url: https://wapt.tranquil.it/store and click on the my account link

    WAPT Store Web interface
  • Click on login.

    WAPT Store Web interface login window
  • The store will redirect you to the Tranquil IT SSO client authentication. If you are logging in for the first time, click on forgot password.

    WAPT Store Web interface SSO login window
  • An email will be sent to you sent to you to initialize your password.

  • After changing your password, click on Reset token and a new token will appear, copy it.

    WAPT Store Web interface reset token
  • In your WAPT Console, go to Tools ‣ External Repositories Settings then select the Tranquil IT store in the repository list, click on Show advanced parameters then add you user (your email address) and your token copied before.

    WAPT Console advanced parameters for credentials

Important

The email address used must be the one provided to Tranquil IT sales or technical service. If your email address is not known to our services, it will not be possible to authenticate you or to reset your password.

If you have a connection problem you can call your technical or commercial contact person at Tranquil IT sales representative.

Once you are connected you can then download the WAPT Enterprise packages.

2.4.1.2. Downloading a newer package version from your repository

If you see in your repository a package version in red and bold, it means a newer version exist on the public store (by default the store is Tranquil IT’s). In the WAPT Packages tab, Version is the version of the package in the local repository; Store Version is the public store version and Software Version is the Luti version when Luti knows the editor software version.

WAPT Console displaying a newer package versions

You have 2 options to upgrade the WAPT package in the local repository:

  • Launch update_package with right-click on the package to be updated then Launch update package. It will execute the update_package defined in the package. If there is no code for updating the software, the command will do nothing. This method has one invonvenient: if the setup.py has been improved, you will not benefit from the improvement. For more, please see the documentation on updating a WAPT package.

  • Click on Update the package from the store. The method will fetch the latest package version from the public repositories (by default Tranquil IT). The benefit of this method is that you will benefit from code improvement in the setup.py. Tjhis is therefore the recommended method. You may want to consult this documentation of how to update a WAPT package from a public repository.

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

It is possible to change the maturity of a WAPT package before loading it into your private repository by choosing DEV, PREPROD or PROD in Default package maturity.

Dialog box to prepare and confirm the import of a WAPT package into a WAPT repository

Dialog box to prepare and confirm the import of a WAPT package into a WAPT repository

2.4.1.4. Editing a package before importing it

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

  • To do this, 2 choices are available:

    • Right-click ‣ Download and Edit;

    Menu list for importing a WAPT package into the WAPT repository
    • or by clicking Download and Edit on the bottom right of the window;

PyScripter, if installed, will open the control and setup.py files of the WAPT package.

For more information, visit the documentation on creating WAPT packages from scratch.

2.4.2. Importing WAPT packages from a local file

You can import a .wapt file from any storage.

  • Click on Import package and then Import from file.

Menu list for importing a WAPT package into the WAPT repository
  • Select the file to import.

Selecting the file to import
  • Click on the Open button to import the file.

The WAPT Console confirms that the package has been imported in the local WAPT repository.

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

WAPT Console displaying the imported WAPT package

WAPT Console displaying the imported WAPT package

Note

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

When uploading a new WAPT package to the private repository, the changing of the prefix and the re-signing of the WAPT package are transparent and automatic.

2.5. Managing WAPT packages hosted in the repository

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

Changing the maturity of a WAPT package
Listing of items in the window

Label

Description

The Type name or description search bar

Allows to search by WAPT package name or description.

The Last version only checkbox

Allows to display all version of WAPT packages in the WAPT Console.

The Filter packages dropdown menu

Allows to filter WAPT packages by type (all, base, group, profile, selfservice, unit, waptwua).

The Show hosts

Displays the hosts on which the selected WAPT package is installed.

The Architecture x86 checkbox

Allows to filter on hosts having a x86 based processor architecture.

The Architecture x64 checkbox

Allows to filters on hosts having a x64 based processor architecture.

The OS all checkbox

Allows to filter hosts based on any OS.

The OS Windows checkbox

Allows to filter hosts based on the Windows OS.

The OS macOS checkbox

Allows to filter hosts based on the macOS OS.

The OS Linux checkbox

Allows to filter hosts based on the Linux OS.

The Locale en checkbox

Allows to filter hosts localized in English.

The Locale fr checkbox

Allows to filter hosts localized in French.

The Locale de checkbox

Allows to filter hosts localized in German.

The Locale it checkbox

Allows to filter hosts localized in Italian.

The Locale es checkbox

Allows to filter hosts localized in Spanish.

The Maturity dropdown list

Allows to filter on the maturity level configured on the hosts.

2.5.1. Doing a search based on a WAPT package

In the 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 host (e.g. package version, package status, audit status, installation date, architecture).

Filtering hosts based on a WAPT package

Filtering hosts based on a WAPT package

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

2.5.2. Showing package dependencies

In the Repository tab, select the WAPT package and then click on Show Depending Packages. It will show whether the WAPT package has a dependency.

Right-click on selected package to see if some other software is a dependency

Right-click on selected package to see if some other software is a dependency

In this example, the unit package Computers has demo-vlc in its dependencies.

Example of a package of which the selected package has a dependency

Example of a package of which the selected package has a dependency

2.5.3. Showing dependencies graph

In the repository, select the WAPT package and then click on Show Dependencies graph to see all dependencies and sub-dependencies.

Right-clicking on a package to see its dependency graph

Right-clicking on a package to see its dependency graph

In this example, we can see all dependencies and sub-dependencies of demo-waptdev package.

Exemple of a package with its graph dependencies

Exemple of a package with its graph dependencies

Hint

You can do the same thing with a host in Inventory tab.

Right-clicking on a host to see its dependency graph

In this example, we can see all dependencies and sub-dependencies of the selected host.

Exemple of a host with its graph dependencies

Exemple of a host with its graph dependencies

2.5.4. Updating the package from the Tranquil IT repository

When you want to upgrade one or several WAPT Packages with the Update the package from the store option, here is how it works. First, select on or several package you want to upgrade.

WAPT Console displaying a newer package version

WAPT Console displaying a newer package version

Then a window with the selected packages will open, you can click on Update the package from the store. After that, it will fetch the new version from the Tranquil IT repository with our code improvement. You will see the same dialog box when you import from internet.

WAPT Console update_package windows displaying a newer package version

WAPT Console update_package windows displaying a newer package version

2.5.5. Updating WAPT package in the local repository

Hint

Tranquil IT recommands you to upgrade your WAPT Packages initially downloaded from our store with this method : Updating the package from the Tranquil IT repository

When you want to upgrade one or several WAPT Packages with the Launch update package option, here is how it works. First, select one or several packages you want to upgrade.

WAPT Console displaying a newer package versions

Then a window with the selected packages will open, you can click on Launch update_package on selected packages. After that, if you did not check Upload directly, you will have to click on Upload selected packages in order to sign, build and upload the package to the WAPT Server.

WAPT Console update_package windows displaying a newer package version

WAPT Console update_package windows displaying a newer package version

2.5.6. Changing the maturity of a WAPT package after having imported it

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

Changing the maturity of a WAPT package
Window for changing the maturity of a WAPT package

Window for changing the maturity of a WAPT package

Options for changing the maturity of WAPT packages

Label

Description

The Increment the package version checkbox

Increments the packaging version (version number after -).

The Delete old packages after successful process checkbox

Delete the old WAPT package after having changed the maturity.

The Change package maturity dropdown list

Configure the new maturity of the WAPT package.

The New packages prefix field

Configure a new prefix for the WAPT package. Prefix is case sensitive, we recommand to use lower case.

You can stop the process by pressing the Abort process button.

You can confirm the process by pressing the Change the package maturity button.

Once finished, the status switches to ok.

Warning

You can change the maturity of a selection of WAPT packages at once

Changing the maturity of the WAPT package will change the hash of the file.

If the package is used in a GPO, like waptupgrade, the hash in the GPO will need to be changed.

2.5.7. Creating a group package

WAPT group packages allow to create a WAPT package containing other WAPT packages as dependencies.

To create a bundle of WAPT packages, go to the WAPT Packages tab in the WAPT console, then click on the Make package template from setup file button and finally choose the Group menu item.

Package group grid
  • Change the name in the Package name field.

  • Fill in the description.

  • Add WAPT packages to the group package by dragging and dropping them or by Right-clicking on the WAPT package name and adding it to the bundle.

Creating a group package

Creating a group package

  • Click on the Save button to save the bundle.

Hint

To uninstall a package, it is possible to add the package as a forbidden package to a group package. The forbidden WAPT package, if installed, will be removed before other WAPT packages are installed.

Adding a forbidden package to a *group* package

Adding a forbidden package to a group package

2.5.8. Removing a WAPT package

Remove a package

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

You can select multiple WAPT packages to delete at once.

Removing the package this way will only delete this package and not anterior versions. To do so, you will have to uncheck Last version only and select all packages version to delete. You can use the option Select obsolete packages to help you then Remove from repository to go faster.

If you remove a package used by at least one host, you will have an alert window. If you check Apply to the following it will remove the dependencies on all other concerned hosts.

Window alerting that a package is used by at least one host when attempting to delete a package from the local repository

Window alerting that a package is used by at least one host when attempting to delete a package from the local repository

2.5.9. Editing a WAPT package

Editing a WAPT package

To edit a WAPT package, do a Right-click ‣ Edit package.

The WAPT package will be downloaded locally in the base package development folder, set in the WAPT Console settings.

If PyScripter is installed, PyScripter will automatically open the control and setup.py files.

Once edited you can upload the WAPT package using the WAPT Console.

2.5.10. Deploying WAPT packages from the WAPT Console

You can deploy WAPT packages on hosts using multiple methods:

2.6. Adding a WAPT package to a host

If you want to add WAPT packages directly on the host, you have to edit the host package.

To do so, there are 3 methods:

  1. Double-click on the host.

  2. Right-click on the host then Edit host.

  3. Select a host and use the Edit host button.

Then, you just have to drag and drop wanted package(s) and confirm.

Method for adding a WAPT package onto a host

Method for adding a WAPT package onto a host

Pressing Save does the same thing as doing an update.

Pressing Save and apply does the same thing as an update immediatelly followed by an upgrade.

2.7. Adding or removing a WAPT package to several hosts

If you want to add or remove WAPT packages directly on several hosts, select the hosts then on one of them Richt-click ‣ Edit mulitple hosts packages. You can add conflicting packages and remove conflicting packages from here too.

A new window will open, check the wanted package then click on OK.

Method for adding or removing a WAPT package onto several host

Method for adding or removing a WAPT package onto several host

After that, do an update immediately followed by an upgrade on the hosts.

2.8. Checking available updates for a host

Checking available updates for a host

This button will execute 2 actions:

  1. give current state of the host to the WAPT Server

  2. the WAPT Server displays whether the host MUST get updates

Every configuration modification require a Check updates.

2.9. Applying updates on a host

Menu option for applying updates on selected host(s)

This button allows to apply pending updates on the selected host(s).

Warning

Use with caution, it will force close the software titles that the users are currently running.

One can use instead Apply upgrade for not running applications to prevent the users losing their unsaved work.

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

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.

Packages

Lists WAPT packages installed on the selected hosts.

Has errors

Searches only for hosts for which a task has not finished correctly.

Needs updating

Searches only for hosts needing upgrades.

Connected only

Searches only for connected hosts

Only authorized computers

Searches only for hosts authorized by certificate of current WAPT Console user.

WAPT Group

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

AD Site

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

AD Group

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

OS

Filters hosts based on their Operating Sytem.

Hint

Filters work with regular expression.

2.11. Creating a configuration package

WAPT configuration packages allow to create several WAPT configurations without having to create several WAPT Agents.

To create a configuration package, go to the WAPT Packages tab in the WAPT console, then click on the Make package template from setup file button and finally choose the Host agent dynamic configuration menu item.

Package group grid

Package group grid

A new window will open in order to create your new configuration package.

Package group grid

Change the name in the Package name field. Now there are several things that can be done.

2.11.1. The configuration toolbar

The Advanced Editing option will switch the simplified view into a complete list of options. Please see this section for advanced waptagent options.

Advanced WAPT package configuration form

Advanced WAPT package configuration form

You can use a filter to search the name of an attribute.

  • The Create new Repository will allow you to create a new WAPT repository if you have another repository than yours. If you do so, a new tab named by your repository will appear in the config package.

    New tab for repository appearing
  • The Add certificate button will open a new window that will allow to select a certificate. The certificate will be included in the bundle of certificates authorized to perform actions on hosts.

    Adding a certificate in a WAPT configuration package

    Adding a certificate in a WAPT configuration package

    You can remove the certificate with Right-click ‣ Remove Certificate.

    Removing a certificate in a WAPT configuration package

    Removing a certificate in a WAPT configuration package

  • The Load Json button will import a json file which can be a configuration file.

    Loading a json file from a file or from the WAPT server

    Loading a json file from a file or from the WAPT server

    If you choose to download a json configuration file from the WAPT Server, you can choose amongst existing configurations.

    Selecting a json file from the WAPT server

    Selecting a json file from the WAPT server

  • The Official documentation button will open a link to the Tranquil IT documentation with all wapt-get.ini options.

2.11.2. The configuration tabs

By default, there are 3 tabs: global, waptwua and repo-sync.

  • The global tab will have the same options when you create a WAPT Agent. The right pane summarizes the options that will be set.

    Global tab for configuring a WAPT package

    Global tab for configuring a WAPT package

  • The waptwua tab will help you choose the options to use with WAPT Windows Updates.

    Tab for enabling a remote host to use WAPT Windows Updates

    Tab for enabling a remote host to use WAPT Windows Updates

  • The repo-sync tab will help configure the remote host to become a remote repository.

Tab for configuring a WAPT package to make a WAPT Agent become a remote repository

Tab for configuring a WAPT package to make a WAPT Agent become a remote repository

2.11.3. Removing a configuration section

To delete an option or an entire section, use Right-click ‣ Delete selected property.

Deleting a property, an option or a section

Deleting a property, an option or a section

2.11.4. Saving the configuration package and applying the new configuration to a remote host

Click on the Save button to save the new configuration bundle. The configuration file will be uploaded onto the WAPT Server in .json file format. Select the hosts and apply the configuration package like any WAPT package.

On the host, the configuration package will be located in the conf.d WAPT installation directory in a json format which can look like this:

Example of a configuration file done by a WAPT configuration package

Example of a configuration file done by a WAPT configuration package

2.12. Removing the WAPT agent from the WAPT Console

If you want to delete a WAPT Agent from the console, right-click on the target agent then click-right and select Remove Host (see above). You will have the possiblity to check And delete host configuration (Package), if you do so, it will delete the targeted host pakage and delete all information about the selected computer.

Window confirming host suppression from the WAPT Console

Note

Deleting a host from the WAPT Console does not uninstall the WAPT Agent from the computer. Please refer to this documentation to uninstall the WAPT Agent. If the WAPT Agent is not properly removed, the computer will register again with the WAPT Server.