Utiliser WAPT en ligne de commande¶

L’agent WAPT fournit un utilitaire d’interface de ligne de commande wapt-get.

L'invite de commande Windows — L’invite de commande Windows¶

Note

Par défaut, les actions en ligne de commande dans WAPT sont exécutées avec les droits de l’utilisateur qui a lancé le cmd.exe.
Si le cmd.exe n’a pas été lancé avec les privilèges de Local Administrator, la commande sera transmise au waptservice.
Par sécurité, certaines actions demandent un identifiant et un mot de passe.
Seuls les Administrateurs Locaux et les membres du groupe de sécurité Active Directory waptselfservice sont autorisés.
Pour forcer l’utilisation du service WAPT en tant qu”Administrateur Local, ajouter simplement -S après wapt-get.exe.

Note

Toutes les commandes qui prennent un nom de package en paramètre peuvent également prendre le package_uuid unique du package en paramètre (wapt-get install, wapt-get forget, etc.) L’utilisation d’un GUID permet de spécifier un packaging unique sans ambiguïté sur son architecture ou sa version. Le package_uuid est listé dans la sortie de wapt-get list et wapt-get search. Par exemple :

Utilisation des fonctions les plus courantes dans WAPT via ligne de commande¶

wapt-get install¶

La commande wapt-get install <package name> lance l’installation d’un paquet.

La commande wapt-get install tis-firefox renvoie :

Note

Si le paquet n’a pas été téléchargé dans le cache, install va d’abord télécharger le paquet dans le cache, puis l’installer.

Attention

L’installation d’un paquet WAPT avec install n’ajoute pas le paquet comme dépendance à l’hôte.

Le paquet est installé sur la machine, mais si l’ordinateur est réimagé, le paquet ne sera pas réinstallé automatiquement.

La commande wapt-get install tis-firefox renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
installing WAPT packages tis-firefox
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 14121562 / 54313787 (26%) (24624 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 33131357 / 54313787 (61%) (29414 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 50511741 / 54313787 (93%) (30412 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 54313787 / 54313787 (100%) (30360 KB/s)
Installing tis-firefox(=94.0.1-106)
Installing: Firefox_Setup_94.0.1.exe
Waiting for key key Mozilla Firefox 94.0.1 (x64 en-US) to appear in Windows registry
Delete C:\Program Files (x86)\wapt\cache\tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt

Results:

=== install packages ===
  tis-firefox [x64_en_PROD]     | tis-firefox (94.0.1-106)                   | tis-firefox (50.0.2-73)

wapt-get update¶

La commande wapt-get update permet de mettre à jour la liste des paquets disponibles.

L’agent WAPT local téléchargera le fichier Packages du dépôt privé et le comparera à sa base de données locale.

Si de nouvelles mises à jour sont disponibles, l’agent WAPT fait passer le statut des paquets à TO-UPGRADE.
Si de nouveaux logiciels ont été ajoutés sur le dépôt, ils deviennent téléchargeables pas l’agent WAPT.

Note

La commande wapt-get update ne télécharge pas les paquets, elle met seulement à jour la base de données locale des paquets.

La commande wapt-get update renvoie:

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Update package list from https://srvwapt.mydomain.lan/wapt, https://srvwapt.mydomain.lan/wapt-host
Total packages : 8
Added packages :

Removed packages :

Discarded packages count : 6
Pending operations :
  install:
  upgrade:
  additional:
  remove:
  immediate_installs:
Repositories URL :
  https://srvwapt.mydomain.lan/wapt
  https://srvwapt.mydomain.lan/wapt-host

wapt-get upgrade¶

La commande wapt-get upgrade permet de lancer l’installation des paquets en attente de mise à jour ou en attente d’installation.

L’agent WAPT local télécharge si nécessaire les paquets WAPT dans son cache local puis les installe.

Indication

Il est recommandé de lancer la commande wapt-get update avant de lancer une commande wapt-get upgrade ;

Sans lancement préalable d’un update, l’agent WAPT n’installera rien;

La commande wapt-get upgrade renvoie:

Installing tis-mumble
Shutting down Mumble
installing Mumble 1.2.3

=== install packages ===
tis-mumble

wapt-get remove¶

La commande wapt-get remove <nom du paquet> supprime un paquet.

La commande prend un argument. Cet argument est le nom paquet ou une liste de noms de paquets avec le préfixe du référentiel.

La commande wapt-get remove tis-firefox renvoie :

Attention

La suppression d’un paquet WAPT avec remove ne supprime pas la dépendance du paquet sur l’hôte.

Le paquet sera effectivement désinstallé de la machine, mais il sera automatiquement réinstallé lors de la prochaine mise à niveau

Pour supprimer complètement un paquet d’un hôte, faites un remove pour le paquet ciblé, puis modifiez la configuration de l’hôte via la console WAPT pour supprimer la dépendance du paquet sur l’hôte.

La commande wapt-get remove tis-firefox renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Removing tis-firefox ...

Waiting for the removal of key key Mozilla Firefox 94.0.1 (x64 en-US) from Windows registry
=== Removed packages ===
  tis-firefox

wapt-get install¶

La commande wapt-get install <package name> lance l’installation d’un paquet.

La commande prend un argument. Cet argument est le nom paquet ou une liste de noms de paquets avec le préfixe du référentiel.

Attention

La suppression d’un paquet WAPT avec remove ne supprime pas la dépendance du paquet sur l’hôte.

La commande wapt-get install tis-firefox renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
 Uninstalling tis-adwcleaner ...
 None
 Uninstallation done

wapt-get edit¶

La commande wapt-get edit <nom du paquet> télécharge et édite un paquet WAPT depuis le dépôt du serveur.

La commande prend un argument. Cet argument est le nom paquet ou une liste de noms de paquets avec le préfixe du référentiel.

Attention

Oublier le packaging ne désinstalle pas le packaging.

La commande wapt-get clean renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini

=== Packages removed from status ===
  tis-adwcleaner

wapt-get edit¶

La commande wapt-get edit <nom du paquet> télécharge et édite un paquet WAPT depuis le dépôt du serveur.

La commande prend un argument. Cet argument est le nom paquet ou une liste de noms de paquets avec le préfixe du référentiel.

Si l’argument est défini, la commande wapt-get audit [<nom du package>] exécute la fonction d’audit du packaging.

La commande wapt-get list liste les paquets WAPT qui sont installés sur l’ordinateur.

La commande wapt-get install tis-firefox renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Auditing tis-firefox ...
Auditing tis-firefox
OK: Uninstall Key Mozilla Firefox 94.0.1 (x64 en-US) in Windows Registry.
tis-firefox -> OK

wapt-get show¶

La commande wapt-get show <nom du paquet> affiche les informations stockées dans le fichier d’index Packages.

Si plusieurs versions d’un paquet sont disponibles sur le référentiel, chaque version du paquet sera affichée.

La commande wapt-get show tis-7zip renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Display package control data for tis-7zip

package           : tis-7zip
version           : 19.00-25
architecture      : x64
section           : base
priority          : optional
name              : 7-Zip
categories        : Utilities
maintainer        : WAPT Team,Tranquil IT,Jimmy PELÉ
description       : 7-Zip is a free and open-source file archiver with a high compression ratio
depends           :
conflicts         :
maturity          : PROD
locale            : all
target_os         : windows
min_wapt_version  : 1.7
sources           : https://www.7-zip.org/download.html
installed_size    :
impacted_process  : 7zFM,7z,7zG
description_fr    : 7-Zip est un logiciel gratuit et open source pour archiver des fichiers avec un taux de compression élevé
description_pl    :
description_de    : 7-Zip ist ein Datenkompressionsprogramm mit einer hohen Kompressionsrate
description_es    : 7-Zip es un archivador de ficheros con una alta relación de compresión
description_pt    : O 7-Zip é um compactador de arquivos com alta taxa de compressão
description_it    :
description_nl    :
description_ru    : 7-Zip свободный файловый архиватор с высокой степенью сжатия данных
audit_schedule    :
editor            : Igor Pavlov
keywords          : 7zip,7,zip,7-zip,file,archiver,high,compression,ratio
licence           : LGPL
homepage          : https://www.7-zip.org/
package_uuid      : dc66ccd1-d987-482e-b792-04e89a3803f7
valid_from        :
valid_until       :
forced_install_on :
changelog         : https://www.7-zip.org/history.txt
min_os_version    : 5.0
max_os_version    :
icon_sha256sum    : eddc038d3625902b6ddeaabd13dd91529e8d457ffbd0c554f96d343ae243a67a
signer            : documentation
signer_fingerprint: 3f2c0a02231a36eafa1f67905f5c083e4b66cb59942f69cbd231d778a1a25b3d
signature         : QzhPeZFrRbjcGzfqRpoWsDP9Plaz6BBVlL3adq/MRM19D61+Aez/JiA8skriCgwSErJXbxOPfxusVqqIpEtyoqh/RlRcnmgCQqk2Fig4gmxpz0rHKokukPQlRk+HdC/uByxSjfp9oXuB3PVG2PZAFifjVBtjEX2QmV+OY6NdMI9dtkxCsn1Xotn2qhu2bwbJWQ0s51rD9emWuQR7l/8WXl+HoquuRho4aCeAOYd6Nta9ktVSR2FM6OO5ZeUOg4fsnMg+hwp2MlDOmBHX37aJm3hLYkGP2xWjpL9YDDxI7ruRXSHyT7YmbILrS0h1m3PTOiV8jy1hTLDgKVeptPWVgA==
signature_date    : 2021-11-19T16:15:42.019196
signed_attributes : package,version,architecture,section,priority,name,categories,maintainer,description,depends,conflicts,maturity,locale,target_os,min_wapt_version,sources,installed_size,impacted_process,description_fr,description_pl,description_de,description_es,description_pt,description_it,description_nl,description_ru,audit_schedule,editor,keywords,licence,homepage,package_uuid,valid_from,valid_until,forced_install_on,changelog,min_os_version,max_os_version,icon_sha256sum,signer,signer_fingerprint,signature_date,signed_attributes
filename          : tis-7zip_19.00-25_x64_windows_0f4137ed1502b5045d6083aa258b5c42_5.0_PROD_a10c57d7848cf7b145d6cd64bf4d5389.wapt
size              : 1704227
md5sum            : a10c57d7848cf7b145d6cd64bf4d5389

OK Package control signature checked properly by certificate documentation (fingerprint: 3f2c0a02231a36eafa1f67905f5c083e4b66cb59942f69cbd231d778a1a25b3d )

Note

Il est possible qu’un message d’avertissement soit affiché avec cette commande, par exemple :

WARNING: control data signature can not be validated with certificates [<SSLCertificate cn='documentation' fingerprint=3f2c0a  issuer='documentation' validity=2021-11-19 - 2031-11-17 Code-Signing=True CA=True>]

Ceci est normal si votre certificat n’est pas fiable. Seul le fichier control est disponible pour wapt-get show et non pour tous les paquets.

Si vous voulez vérifier le paquet correctement, téléchargez-le dans le cache et exécutez la commande wapt-get show sur le paquet local.

Par exemple :

wapt-get download tis-7zip
wapt-get show "C:\Program Files (x86)\wapt\cache\tis-7zip_19.00-25_x64_windows_0f4137ed1502b5045d6083aa258b5c42_5.0_PROD_a10c57d7848cf7b145d6cd64bf4d5389.wapt"

wapt-get show¶

La commande wapt-get show-params <nom du paquet> renvoie des listes de paramètres qui seraient passés à la commande wapt-get install <nom du paquet> --params=PARAMS.

La commande prend un argument. Cet argument est le nom paquet ou une liste de noms de paquets avec le préfixe du référentiel.

La commande wapt-get show tis-7zip renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
tis-7zip : {True, 'documentation': True}

wapt-get show¶

La commande wapt-get show <nom du paquet> affiche les informations stockées dans le fichier d’index Packages.

La commande prend un argument. Cet argument est le nom paquet ou une liste de noms de paquets avec le préfixe du référentiel.

La commande wapt-get show tis-7zip renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Package: tis-7zip (21.06-34) PROD
-------------------
Status: OK

Installation log:
-------------------
Installing: 7z2106-x64.msi
Waiting for key key {23170F69-40C1-2702-2106-000001000000} to appear in Windows registry


Installation Parameters:
-------------------
{}

Last audit:
-------------------
Status: OK
Date: 2022-01-06T10:32:38.698272

Output:
Auditing tis-7zip
OK: Uninstall Key {23170F69-40C1-2702-2106-000001000000} in Windows Registry.


Next audit on: 2022-01-06T10:32:38.698272

wapt-get search¶

La commande wapt-get search permet de rechercher un ou plusieurs paquets dans les dépôts.

Avertissement

Cette commande renvoie uniquement les paquets disponibles pour l’hôte qui exécute la commande.

Si une autre localisation, os, architecture ou maturité est présente dans le dépôt, elle n’est pas listée.

La commande de recherche prend un argument pour être recherchée dans le nom et la description du paquet.

La commande wapt-get search "Firefox" renvoie (par exemple) :

  status     package            version    target_os       architecture maturity locale description                                                                      repo
---------- ------------------ ---------- --------------- ---- ----- --- -------------------------------------------------------------------------------- ----------
-          tis-firefox        94.0.2-106 windows         x64  PROD  fr  Mozilla Firefox est un navigateur web gratuit et open source                     wapt
I          tis-config-firefox 68.3-6     windows         all  PROD      Configuration for Mozilla Firefox - The package will not have any effect if an*  wapt
I          tis-firefox-esr    91.3.0-105 windows         x64  PROD  fr  Mozilla Firefox Extended Support Release (ESR) est une version officielle de*    wapt

Value	status	package	version	target_os	architecture	maturity	locale	description	repo
Description	État de l’installation des paquets	Nom du paquet	Version du paquet	OS cible (si défini)	Architecture du CPU (si définie)	Maturité du paquet (si défini)	Locale du paquet (si défini)	Description du paquet	Dossier du paquet sur le serveur

Note

La valeur de status définit l’état de l’installation comme suit

- pour non installé

I pour installé

wapt-get download¶

La commande wapt-get download <nom du paquet> télécharge le paquet WAPT dans le cache local situé dans C:\Program Files\wapt\cache.

La commande wapt-get download tis-7zip renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Downloading packages tis-7zip(=19.00-25)
https://srvwapt.mydomain.lan/wapt/tis-7zip_19.00-25_x64_windows_0f4137ed1502b5045d6083aa258b5c42_5.0_PROD_a10c57d7848cf7b145d6cd64bf4d5389.wapt : 1704227 / 1704227 (100%) (11804 KB/s)

Downloaded packages:
  C:\Program Files (x86)\wapt\cache\tis-7zip_19.00-25_x64_windows_0f4137ed1502b5045d6083aa258b5c42_5.0_PROD_a10c57d7848cf7b145d6cd64bf4d5389.wapt

wapt-get download-upgrade¶

La commande wapt-get download-upgrade télécharge les paquets à mettre à niveau dans le cache WAPT local C:\Program Files (x86)\wapt\cache.

La commande wapt-get download-upgrade renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 18466658 / 54313787 (34%) (32089 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 36390179 / 54313787 (67%) (32693 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 52684289 / 54313787 (97%) (31564 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 54313787 / 54313787 (100%) (30747 KB/s)

=== downloaded packages ===
  C:\Program Files (x86)\wapt\cache\B8D346E7-DDDB-0013-5A8A-425CF3B6199E.wapt
  C:\Program Files (x86)\wapt\cache\tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt

wapt-get list¶

La commande wapt-get list liste les paquets WAPT qui sont installés sur l’ordinateur.

La commande wapt-get list renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
package                              version    install_status install_date     description                                                                      package_uuid
------------------------------------ ---------- ---------- ---------------- -------------------------------------------------------------------------------- ------------------------------------
tis-7zip                            21.06-34   OK         2021-12-10T14:57 7-Zip is a free and open-source file archiver with a high compression ratio      717a30cc-0d44-42d1-9538-0f2f298d8603
tis-firefox                         94.0.1-106 OK         2021-12-10T14:58 Mozilla Firefox is a free and open-source web browser                            5a91f54a-3e27-44cf-a2b6-6b84012aa3a2

package	version	install status	install_date	description	package_uuid
Nom du paquet	Version du paquet	Installation status	Date et heure de l’installation	Description du paquet	UUID unique du paquet

wapt-get upgrade¶

La commande wapt-get list liste les paquets WAPT qui sont installés sur l’ordinateur.

La commande wapt-get upgrade renvoie:

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini

=== upgrade packages ===
tis-notepadplusplus(=8.2-10)

wapt-get list¶

La commande wapt-get -S tasks vérifie si certaines tâches sont en cours d’exécution ou en attente dans la file d’attente.

La commande wapt-get list renvoie :

About to speak to waptservice...
Running task 14: Uninstall of tis-vlc (task #14), status:

Utilisation de lignes de commande spéciales avec WAPT¶

wapt-get clean¶

La commande wapt-get clean supprime les paquets du dossier C:\Program Files (x86)\wapt\cache.

La commande wapt-get clean est lancée après chaque mise à niveau pour économiser de l’espace disque.

La commande wapt-get clean renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Removed files:
C:\Program Files (x86)\wapt\cache\tis-mumble_1.2.3-1_all.wapt
C:\Program Files (x86)\\wapt\cache\tis-vlc_1.2.3-2_all.wapt

wapt-get upgradedb¶

La commande wapt-get upgradedb met à jour le schéma de la base de données WAPT locale si nécessaire.

La commande wapt-get upgradedb renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
WARNING upgrade db aborted: current structure version 20210420 is newer or equal to requested structure version 20210420
No database upgrade required, current 20210420, required 20210420

wapt-get add-upgrade-shutdown - wapt-get remove-upgrade-shutdown¶

Ces 2 commandes modifient ce fichier : C:WindowsSystem32GroupPolicyMachineScriptsscripts.ini.

La commande wapt-get add-upgrade-shutdown ajoute un objet de stratégie de sécurité locale waptexit, permettant l’exécution de waptexit à l’arrêt du système.

La commande wapt-get add-upgrade-shutdown renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
0

Le scripts.ini contient :

[Shutdown]
0CmdLine = C:\Program Files (x86)\wapt\waptexit.exe
0Parameters =

La commande wapt-get remove-upgrade-shutdown supprime l’objet de politique de sécurité locale waptexit, désactivant l’exécution de waptexit pendant l’arrêt du système.

La commande wapt-get add-upgrade-shutdown renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
0

Le scripts.ini contient :

[Shutdown]

wapt-get register¶

La commande wapt-get register [<description>] rapporte l’inventaire matériel et logiciel de l’ordinateur au serveur d’inventaire WAPT.

Indication

Vous pouvez passer une description comme argument à la commande register, cette description sera affichée dans la console WAPT dans la colonne description.

Vous pouvez profiter de WAPT pour améliorer votre gestion informatique en affectant un nom d’utilisateur ou un numéro de série d’ordinateur comme descriptions pour vos hôtes.

Note

Si l’hôte est déjà enregistré, la nouvelle exécution avec une description met à jour les informations enregistrées.

Il n’est pas nécessaire de définir une description pour enregistrer l’hôte avec la ligne de commande.

La commande wapt-get register "John Doe PC" renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Registering host against server: https://srvwapt.mydomain.lan
Host correctly registered against server https://srvwapt.mydomain.lan.wapt-get inventory

wapt-get register¶

La commande wapt-get register [<description>] rapporte l’inventaire matériel et logiciel de l’ordinateur au serveur d’inventaire WAPT.

La commande wapt-get list renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Unregistering host from server: https://srvwapt.mydomain.lan
Please get login for api/v3/hosts_delete:admin
Password:
Host correctly unregistered against server https://srvwapt.mydomain.lan.

wapt-get inventory¶

La commande wapt-get inventory affiche toutes les informations relatives à l’inventaire local au format JSON.

La commande wapt-get inventory renvoie (en partie) :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
{
  "host_info": {
    "description": "John Doe PC",
    "system_manufacturer": "Xen",
    "system_productname": "HVM domU",
    "computer_name": "Documentation",
    "computer_fqdn": "Documentation.srvwapt.mydomain.lan",
    "dnsdomain": "mydomain.lan",
    "workgroup_name": "Documentation",
    "domain_name": null,
    "domain_controller": null,
    "domain_controller_address": null,
    "domain_info_source": "history",
    "networking": [
    {
      "iface": "{085AB96368A-05A3B96-43EC-B773-0C0BB96794D9}",
      "mac": "a2:1d:6e:fc:8d:e6",
      "addr": [
      {
        "addr": "192.168.0.1",
        "netmask": "255.255.255.0",
        "broadcast": "192.168.0.255",
        "connected": true
      },
      {
        "addr": "fe80::2437:567f:79c8:f964",
        "netmask": "ffff:ffff:ffff:ffff::/64",
        "broadcast": "fe80::ffff:ffff:ffff:ffff%3",
        "connected": true
      }
      ]
    }
    ],
    "gateways": [
    "192.168.0.254"
    ],
    "dns_servers": [
    "192.168.0.11"
    ],
    "connected_ips": [
    "192.168.0.1",
    "fe80::2437:567f:79c8:f964"
    ],
    "mac": [
    "a2:fc:1d:6e:8d:e6"
    ],
...

wapt-get update-status¶

La commande wapt-get update-status renvoie le statut local au serveur d’inventaire WAPT.

Note

Si un composant matériel a été modifié sur l’ordinateur, le update-status ne renvoie pas cette information au serveur d’inventaire WAPT.

Pour ce faire, la commande à utiliser est inventory.

La commande wapt-get update-status renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Updated host status correctly sent to the WAPT Server https://srvwapt.mydomain.lan. {'success': True, 'msg': 'update_host', 'result': {'uuid': 'B8D346E7-DDDB-0013-5A8A-425CF3B6199E', 'computer_fqdn': 'documentation.mydomain.lan', 'status_hashes': {'dmi': '124b8bcef5b690afea7cf8001351a22132885123', 'wmi': 'ae5dbb5627b7b3a5a31d5914a9dbf48b85b133da', 'host_info': 'e737a82da15fbe9cae88ba9b4a9662a73657d959', 'audit_data': None, 'wapt_status': 'bcb76ad07cf1b6f814082ec5a58c4fee0364a640', 'audit_status': 'c34adb535c711b59d4408f00f77b7392687d7e56', 'host_metrics': '9fc68bd98c82e0e9bece0ce3afaeeb63a3ed1db1', 'waptwua_status': '4f9dcf0af339ce28d7354283fd4e6bdaf17b85c8', 'waptwua_updates': 'c5cf38908fc549f499ade5b17ce221ff0ced377f', 'wuauserv_status': '7c30215c3c34566e5b0c69c9e1dbfe3e6117b837', 'host_capabilities': 'c31286122a213f3bb313531541582bb2ba1d0a81', 'installed_packages': '3279f3bf4d5ed5086b198fa94a6a6f422f519ab3', 'last_update_status': '347c5a8c01e182f1e03e5c9d0fe07dd87ab79153', 'installed_softwares': 'd582a6f7325af35eae17cb7ecdca59ef0d137dda', 'authorized_certificates': '2974f9535f813fc454b735193c31828b132a6ba0', 'waptwua_updates_localstatus': 'c5cf38908fc549f499ade5b17ce221ff0ced377f'}, 'server_uuid': '82295c4d-4944-11ec-bac6-a25b5d7da3d5'}, 'request_time': 0.046843767166137695}

wapt-get setlocalpassword¶

La commande wapt-get setlocalpassword permet de définir un mot de passe local pour les installations de paquets WAPT.

La commande wapt-get setlocalpassword renvoie :

Local password:
Confirm password:
Local auth password set successfully

wapt-get reset-uuid¶

La commande wapt-get reset-uuid récupère l’hôte UUID du BIOS et le renvoie au serveur d’inventaire WAPT.

La commande wapt-get reset-uuid renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
New UUID: B0F23D44-86CB-CEFE-A8D6-FB8E3343FE7F

wapt-get generate-uuid¶

La commande wapt-get generate-uuid crée un nouvel hôte UUID et le renvoie au serveur d’inventaire WAPT.

À utiliser si vous avez un bios UUID bug.

La commande wapt-get generate-uuid renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
New UUID: RND-0279A1F4-BBBE-43AE-A591-F82652E0104B

Note

Tous les UUID générés aléatoirement mettent un RND- devant.

wapt-get get-server-certificate¶

La commande wapt-get get-server-certificate télécharge le certificat SSL du serveur WAPT pour utiliser HTTPS pour communiquer avec le serveur WAPT.

Le certificat téléchargé est stocké dans C:\Program Files(x86)\wapt\server`.

La commande wapt-get get-server-certificate renvoie :

Server certificate written to C:\Program Files (x86)\wapt\ssl\server\srvwapt.mydomain.lan.crt

wapt-get enable-check-certificate¶

La commande wapt-get enable-check-certificate télécharge le certificat SSL du serveur WAPT et active la communication sécurisée avec le serveur.

Il est utilisé pour activer la vérification du certificat SSL / TLS

La commande wapt-get enable-check-certificate renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Server certificate : C:\Program Files (x86)\wapt\ssl\server\template-auto.test.lan.crt
Certificate CN: template-auto.test.lan
Pining certificate C:\Program Files (x86)\wapt\ssl\server\template-auto.test.lan.crt

wapt-get upgrade¶

La commande wapt-get check-upgrades montre l’état des dernières mises à jour/mises à niveau sur l’hôte.

La commande wapt-get upgrade renvoie:

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
{
  "running_tasks": [],
  "errors": [],
  "date": "2022-01-06T14:09:26.554391",
  "upgrades": [
    "tis-notepadplusplus(=8.2-10)"
  ],
  "pending": {
    "install": [],
    "upgrade": [
    "tis-notepadplusplus(=8.2-10)"
    ],
    "additional": [],
    "remove": [],
    "immediate_installs": []
  }
}

wapt-get duplicate¶

La commande wapt-get list liste les paquets WAPT qui sont installés sur l’ordinateur.

La commande wapt-get clean renvoie :

Using config file C:\Program Files (x86)\wapt\wapt-get.ini
Server: https://srvwapt.mydomain.lan
Server UUID: 82295c4d-4944-11ec-bac6-a25b5d7da3d5
Server CABundle: 0

{"licence_nr":"6f011e23-cb70-40a4-b340-0d18ae1e2f02","product":"WAPT Enterprise","features":["full"],"licenced_to":"documentation","domain":"","contact_email":"documentation@tranquil.it","count":"10","valid_from":"2021-06-14T00:00:0","valid_until":"2022-01-12T00:00:0","renewal_url":null,"signed_attributes":["licence_nr","product","features","licenced_to","domain","contact_email","count","valid_from","valid_until","renewal_url","signed_attributes","signer","signature_date","signer_certificate","server_uuid"],"signer":"","signature_date":"2022-01-13T16:38:56","signer_certificate":"-----BEGIN CERTIFICATE-----\nMIIEIjCCAwqgAwIBAgIUIOMdx8FmRdmCNTHxOfKecSp/cAAwDQYJKoZIhvcNAQEL\nBQAwgZcxCzAJBgNVBAYTAkZSMSIwIAYDVQQHDBlTYWludCBTZWJhc3RpZW4gc3Vy\nIExvaXJlMRwwGgYDVQQKDBNUcmFucXVpbCBJVCBTeXN0ZW1zMSAwHgYDVQQDDBdy\nZWxpY2VuY2luZy50cmFucXVpbC5pdDEkMCIGCSqGSIb3DQEJARYVdGVjaG5pcXVl\nQHRyYW5xdWlsLml0MB4XDTIxMDYwODE0MTQ0MVoXDTMxMDYwNjE0MTQ0MVowgZcx\nCzAJBgNVBAYpk6dZrIrw9Kb5hee+1EgqEbudCBTZWJhc3RpZW4gc3VyIExvaXJl\nMRwwGgYDVQQKDBNUcmFucXVpbCBJVCBTeXN0ZW1zMSAwHgYDVQQDDBdyZWxpY2Vu\nY2luZy50cmFucXVpbC5pdDEkMCIGCSqGSIb3DQEJARYVdGVjaG5pcXVlQHRyYW5x\ndWlsLml0MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAzT43W8OhWXAe\nhDB+IWwQm9IGGdR0VY/klKcSheo/8jGlNziyH6BANhjFKYNX9UtQ+ghzv6BGfSTH\nyua1aXEQM89sSKFOoJztoD1L9FZtuWQb/vfLWkisP8fRPvH4B/tYG+5nchGa6+6r\nqGSGSpWcnj6CovgQR01ATUuHN3NV1N7q48hBT/ZT9R5U3sEi+hNK4eRIeZ220Pzm\nDoNGkVKlEiczgXuM77ezYp8UWvpk6dZrIrw9Kb5hee+1EgqEbgVmdARoaOPGTK8h\n8VW+milWsl4TEY19kxXWvva+M6wX00ipJ2LxEiu5+dlOok9E8i405UTNE7oSVYsF\n90/6S3C4twIDAQABo2QwYjAPBgNVHRMBAf8EBTADAQH/MCAGA1UdJQEB/wQWMBQG\nCCsGAQUFBwMDBggrBgEFBQcDAjAdBgNVHQ4EFgQUpRT6Co2uoWZMCwP7FKiF73+j\nfAEwDgYDVR0PAQH/BAQDAgHWMA0GCSqGSIb3DQEBCwUAA4IBAQAdXX5IkpuH/Gek\nPPHC4KvE/6GsU0kqLI1w5ML5pbF1zyCCL0nm4f8w2JJIJ2Ycdb4QVD27kJqgZcH1\nniYQ3RCIh6aasS8qpCOf90KkpvKMJiyk/ra7I6NSgPut4ErkoxUWocgF6SNFEjwB\naqUZY//Hkoqk2dXqdujLVGJfBpX95ZJ9PmFNLfsyUsvu1WcFMb0En0EUO74Mq4M3\nKo2S86G9pEDKooaN5Vq19biReOwQYpX1YlSLtrxFx8AM87auQgaD8EWSdA1q2ycN\n8ZnmXGxAhDv8hmE2Fv0x0t3hzYXxxcv1ZjYWRHlMUl/buWQQ35u9MFkjh7YZlTlM\nb9wjtN+W\n-----END CERTIFICATE-----\n","signature":"J7DZ+mja7zGghYFCDKh8WIxzzdhKPeoNswWjnKZziT+ddpoRdg45kZz4E8PxMIUzhTI8WIxzzdhKPeoNswrICpQ8t5kepzovZpoONwjgOQ5PoCAgDOE3NV+larFrMdkAjCpx4tV86n5gyXHJnlnH1OXCpKUBiIiP/de18bEgSSlgjXgE/wr2ZfclsRsRRfsRbGSterRKQcthNDrFlf8RjH5cpDnDvMJ+qJtTsqxA13/WT2NS2uNWZI93si/9mowWY8MdT/PZjosciCqijbq4oa+/FrPsALhUOtcGE9JylwknszUD5Ayfh+9sNLLxsG6eT0JlnNgf4nx9mXAu4GBg==","server_uuid":"82295c4d-4944-11ec-bac6-a25b5d7da3d5"}
Login to server api/v3/licences
Waptserver https://srvwapt.mydomain.lan Admin User () :admin
Waptserver Password: ************
Licence properly activated on server

wapt-get clean¶

La commande wapt-get list liste les paquets WAPT qui sont installés sur l’ordinateur.

La commande wapt-get clean renvoie :

Using config file C:\Program Files (x86)\wapt\wapt-get.ini
Server: https://srvwapt.mydomain.lan
Server UUID: 36bf01bc-c8f5-11eb-bf04-36127be97253
Server CABundle: 0

Total licences count: 10
Licenced to: documentation

Valid Nr:b7b6e537-3cb7-4d9a-3cb7-2448020e2e51 Count:10 From:2022-01-13T00:00:0 Expire:2023-01-12T23:59:0 Server:36bf01bc-c8f5-11eb-bf04-36127be97253 Licencee:documentation

wapt-get download¶

La commande wapt-get inventory affiche toutes les informations relatives à l’inventaire local au format JSON.

La commande wapt-get list renvoie :

DNS Server : dns.mydomain.lan
DNS Domain : mydomain.lan
Main repo url: https://srvwapt.mydomain.lan/wapt
wapt SRV: []
waptserver SRV: []
CNAME: []

Utilisation de la ligne de commande pour la configuration de la session utilisateur¶

wapt-get session-setup¶

La commande wapt-get session-setup <nom du paquet> [<ALL>] lance les personnalisations de niveau utilisateur des paquets WAPT installés.

Elle est définie dans la fonction session-setup du fichier setup.py.

Note

L’argument ALL lancera session-setup pour tous les paquets WAPT installés.

La commande wapt-get session-setup ALL renvoie :

Configuring tis-7zip ... No session-setup. Done
Configuring tis-ccleaner ... Already installed. Done
Configuring tis-vlc ... No session-setup. Done
Configuring mdl-tightvnc ... No session-setup. Done
Configuring tis-brackets ... No session-setup. Done
Configuring mdl-firefox-esr ... No session-setup. Done
Configuring tis-paint.net ... No session-setup. Done

Utilisation de la ligne de commande pour créer des paquets WAPT¶

wapt-get list-registry¶

La commande wapt-get list liste les paquets WAPT qui sont installés sur l’ordinateur.

La commande peut prendre un argument, non sensible à la casse, pour rechercher un mot spécifique : wapt-get list-registry <keyword>.

Les informations retournées sont :

Information	Définition	Disponible sur Windows	Disponible sur Linux	Disponible sur Mac OS
Désinstaller la clé	Désinstaller l’identifiant de clé dans le registre
Les logiciels	Nom du logiciel dans le registre
Version	Version du logiciel dans le registre
Désinstaller la chaîne	Chaîne de désinstallation du logiciel dans le registre

Note

Sous Windows, ces informations sont collectées par WAPT à partir du registre en deux localisations :
- OrdinateurHKEY_LOCAL_MACHINESOFTWAREMicrosoftWindowsCurrentVersionUninstall
- MachineHKEY_LOCAL_MACHINESOFTWAREWOW6432NodeMicrosoftWindowsCurrentVersionUninstall
Sous Linux, ces informations sont collectées par WAPT dans Applications
Sous Mac OS, ces informations sont collectées par WAPT dans /var/lib/dpkg/info/

La commande wapt-get list-registry firefox renvoie (sous Windows) :

La sortie de wapt-get list-registry est un tableau listant les clés de désinstallation pour chaque logiciel correspondant au terme recherché.

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
UninstallKey                           Software                               Version             Uninstallstring
---------------------------------------------------------------------------------------------------------------------------------------------------------
Mozilla Firefox 45.5.0 ESR (x64 fr)    Mozilla Firefox 45.5.0 ESR (x64 fr)    45.5.0              "C:\Program Files\Mozilla Firefox\uninstall\helper.exe"

wapt-get sources¶

La commande wapt-get sources <nom du paquet> télécharge les sources depuis une plateforme de gestion du code source comme Git ou SVN.

La commande wapt-get sources tis-firefox ne renvoie rien;

wapt-get make-template¶

Avertissement

Cette méthode est dépréciée, utilisez plutôt la console WAPT pour créer un modèle de packaging.

La commande wapt-get make-template <chemin-installateur> [<nompaquet> [<nom-dossier source>]] permet de créer un modèle de paquet à partir d’un binaire.

Utilisez ces arguments :

Arguments	Définition	Valeur par défaut
chemin de l’installateur	Chemin d’installation du binaire	Pas de valeur par défaut, c’est nécessaire
nompaquet	Nom du paquet	S’il n’est pas défini, le nom du paquet est créé comme ceci `prefix-binaire-nom_paquet-version-wapt`
nom du répertoire source	Répertoire pour enregistrer les fichiers sources	Si elle n’est pas définie, c’est la valeur de `default_sources_root` dans `waptconsole.ini`

La commande C:\Users\User\Downloads\tightvnc.msi tis-tightvnc` renvoie :

Using config file: C:\Users\Documentation\AppData\Local\waptconsole\waptconsole.ini
Template created. You can build the WAPT package by launching
  C:\Program Files (x86)\wapt\wapt-get.exe build-package C:\waptdev\tis-tightvnc-wapt
You can build and upload the WAPT package by launching
  C:\Program Files (x86)\wapt\wapt-get.exe build-upload C:\waptdev\tis-tightvnc-wapt

Indication

Si vous avez préalablement installé le paquet tis-waptdev sur votre ordinateur de développement, l’éditeur PyScripter se lancera automatiquement et ouvrira le paquet en mode développement.

wapt-get make-host-template¶

Avertissement

Cette méthode est principalement destinée aux scripts, en général le packaging de l’hôte est automatiquement créé avec la console WAPT.

La commande wapt-get make-host-template <nommachine> [[<paquet>,<paquet>,...] [répertoire]] crée un paquetage hôte WAPT vide à partir d’un modèle.

Utilisez ces arguments :

Arguments	Définition	Valeur par défaut
nom d’hôte	Nom de la machine utilisée pour le nom du paquet	Si aucun n’est donné, utiliser le FQDN
package	Liste des paquets nécessaires sur l’hôte.	S’il n’est pas défini, aucun paquet n’est ajouté comme dépendance
répertoire	Répertoire pour enregistrer les fichiers sources	S’il n’est pas défini, c’est `C:\waptdev`

La commande wapt-get make-host-template host01.mydomain.lan renvoie :

Using config file: C:\Users\Documentation\AppData\Local\waptconsole\waptconsole.ini
Template created. You can build the WAPT package by launching
  C:\Program Files (x86)\wapt\wapt-get.exe build-package C:\waptdev\host01.mydomain.lan-wapt
You can build and upload the WAPT package by launching
  C:\Program Files (x86)\wapt\wapt-get.exe build-upload C:\waptdev\host01.mydomain.lan-wapt

wapt-get make-group-template¶

Avertissement

Cette méthode ne doit être utilisée que si vous ne pouvez pas utiliser la console pour créer un packaging.

La commande wapt-get make-group-template <nom du groupe> crée un paquet de groupe WAPT vide à partir d’un modèle.

La commande wapt-get make-group-template documentation renvoie :

Template created. You can build the WAPT package by launching
  C:\Program Files (x86)\wapt\wapt-get.exe build-package C:\waptdev\accounting-wapt
You can build and upload the WAPT package by launching
  C:\Program Files (x86)\wapt\wapt-get.exe build-upload C:\waptdev\accounting-wapt

wapt-get build-package¶

La commande wapt-get build-package <chemin vers le répertoire package> construit un package WAPT et le signe avec la clé privée associée au personal_certificate_path défini dans le waptconsole.ini.

Note

Le chemin vers la clé privée, le préfixe par défaut et le chemin de développement par défaut Doivent être correctement définis dans le fichier wapt-get.ini.

La commande wapt-get upload-package C:waptdev is-tightvnc.wapt renvoie :

Using config file: C:\Users\documentation\AppData\Local\waptconsole\waptconsole.ini
Building packages 1 packages
Personal certificate is documentation
Please type the password to decrypt the private key C:\Users\documentation\private\documentation.pem
Password:
Private key is <SSLPrivateKey 'C:\\Users\\documentation\\private\\documentation.pem'>
Personal certificate is SSLCertificate cn=documentation
Private key is <SSLPrivateKey 'C:\\Users\\documentation\\private\\documentation.pem'>
Building  c:\waptdev\tis-dropbox
Signing c:\waptdev\tis-dropbox with key <SSLPrivateKey 'C:\\Users\\documentation\\private\\documentation.pem'> and certificate documentation (C:\Users\documentation\private\documentation.crt)
Package c:\waptdev\tis-dropbox signed : signature : BN7j6lwloY...Iu9QVulA=
...done building. Package filename c:\waptdev\tis-dropbox_104.4.175-7_windows_0f4137ed1502b5045d6083aa258b5c42_5.1_PROD.wapt
1 packages successfully built
0 packages failed

You can upload to repository with
  C:\Program Files (x86)\wapt\wapt-get.exe upload-package "c:\waptdev\tis-dropbox_104.4.175-7_windows_0f4137ed1502b5045d6083aa258b5c42_5.1_PROD.wapt"

Avertissement

Le nom du répertoire ne définit pas le nom et le préfixe du packaging, il est défini par le fichier control.

wapt-get sign-package¶

La commande wapt-get sign-package <chemin vers le paquet> signe un paquet avec la clé privée associée à personal_certificate_path définie dans le waptconsole.ini.

Attention

sign-package ne renomme pas le paquet WAPT avec le préfixe choisi de l”Organisation.

La commande wapt-get sign-package c:waptdevtis-dropbox renvoie :

Using config file: C:\Users\documentation\AppData\Local\waptconsole\waptconsole.ini
Signing packages c:\waptdev\tis-dropbox
Personal certificate is SSLCertificate cn=documentation
Please type the password to decrypt the private key C:\Users\documentation\private\documentation.pem
Password:
Private key is <SSLPrivateKey 'C:\\Users\\documentation\\private\\documentation.pem'>
Signing c:\waptdev\tis-dropbox
  OK: Package c:\waptdev\tis-dropbox signed : signature : b'nJYfYswDWi'...b'v790D7uA='

wapt-get build-upload¶

La commande wapt-get build-upload <chemin vers le paquet> construit et télécharge un paquet WAPT sur le dépôt WAPT principal.

Indication

En passant l’argument -i à build-upload, le numéro de version du packaging WAPT est incrémenté avant le téléchargement, afin d’éviter de devoir modifier manuellement le fichier control.

La commande wapt-get -i build-upload c:waptdevtis-dropbox renvoie :

Using config file: C:\Users\documentation\AppData\Local\waptconsole\waptconsole.ini
Building packages 1 packages
Personal certificate is documentation
Please type the password to decrypt the private key C:\Users\documentation\private\documentation.pem
Password:
Private key is <SSLPrivateKey 'C:\\Users\\documentation\\private\\documentation.pem'>
Personal certificate is SSLCertificate cn=documentation
Private key is <SSLPrivateKey 'C:\\Users\\documentation\\private\\documentation.pem'>
Building  c:\waptdev\tis-dropbox
Signing c:\waptdev\tis-dropbox with key <SSLPrivateKey 'C:\\Users\\documentation\\private\\documentation.pem'> and certificate documentation (C:\Users\documentation\private\documentation.crt)
Package c:\waptdev\tis-dropbox signed : signature : s9FOLFQvYw...c9T3Hv1A=
...done building. Package filename c:\waptdev\tis-dropbox_104.4.175-7_windows_0f4137ed1502b5045d6083aa258b5c42_5.1_PROD.wapt
1 packages successfully built
0 packages failed
Building and uploading packages to https://srvwapt.mydomain.lan
Please get login for https://srvwapt.mydomain.lan/api/v3/upload_xxx:admin
Password:
c:\waptdev\tis-dropbox_104.4.175-7_windows_0f4137ed1502b5045d6083aa258b5c42_5.1_PROD.wapt[================================] 126459984/126459984 - 00:00:40
Package uploaded successfully: 1 Packages uploaded, 0 errors

wapt-get duplicate¶

La commande wapt-get duplicate <package source> <package new_duplicate> duplique un package téléchargé depuis le référentiel et l’ouvre en tant que projet PyScripter.

Avertissement

N’utilisez pas cette commande pour dupliquer un packaging d’hôte.

Utilisez ces arguments :

Arguments	Définition	Requis
Version du paquet	Chemin du répertoire du packaging ou du package compilé dans `.wapt`
nompaquet	Nom du paquet
version	Change la version du packaging dans le fichier `control`. S’il n’est pas défini, la même version est dupliquée.
répertoire	Chemin vers le répertoire cible du packaging dupliqué. S’il n’est pas défini, utilisez le même que celui du packaging source.

La commande wapt-get duplicate tis-firefox tis-firefox-custom renvoie :

Package duplicated. You can build the new WAPT package by launching
  C:\Program Files (x86)\wapt\wapt-get.exe build-package C:\waptdev\tis-firefox-custom-wapt
You can build and upload the new WAPT package by launching
  C:\Program Files (x86)\wapt\wapt-get.exe build-upload C:\waptdev\tis-firefox-custom-wapt

Indication

Si vous avez préalablement installé le paquet tis-waptdev sur votre ordinateur de développement, l’éditeur PyScripter se lancera automatiquement et ouvrira le paquet en mode développement.

wapt-get edit¶

Avertissement

Cette méthode ne doit être utilisée que si vous ne pouvez pas utiliser la console pour créer un packaging.

La commande wapt-get edit <nom du paquet> télécharge et édite un paquet WAPT depuis le dépôt du serveur.

La commande prend un argument. Cet argument est le nom paquet ou une liste de noms de paquets avec le préfixe du référentiel.

La commande wapt-get edit tis-firefox renvoie :

Using config file: C:\Users\documentation\AppData\Local\waptconsole\waptconsole.ini
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 1629411 / 54313787 (3%) (2686 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 8147055 / 54313787 (15%) (5679 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 15207836 / 54313787 (28%) (7367 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 19552932 / 54313787 (36%) (7249 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 24984302 / 54313787 (46%) (7471 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 29329398 / 54313787 (54%) (7143 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 33674494 / 54313787 (62%) (6951 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 40735275 / 54313787 (75%) (7534 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 45623508 / 54313787 (84%) (7326 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 53227426 / 54313787 (98%) (7603 KB/s)
https://srvwapt.mydomain.lan/wapt/tis-firefox_94.0.1-106_x64_windows_0f4137ed1502b5045d6083aa258b5c42_6.1_PROD_en_f5335369ad5805e8dbc1f8ae99b2258e.wapt : 54313787 / 54313787 (100%) (7663 KB/s)
Package edited. You can build and upload the new WAPT package by launching

Indication

Si vous avez préalablement installé le paquet tis-waptdev sur votre ordinateur de développement, l’éditeur PyScripter se lancera automatiquement et ouvrira le paquet en mode développement.

wapt-get edit-host¶

Avertissement

Cette méthode ne doit être utilisée que si vous ne pouvez pas utiliser la console pour créer un packaging.

La commande wapt-get edit-host <host FQDN> édite un paquet WAPT host.

La commande wapt-get edit tis-firefox renvoie :

Using config file: C:\Users\documentation\AppData\Local\waptconsole\waptconsole.ini
Package edited. You can build and upload the new WAPT package by launching
C:\Program Files (x86)\wapt\wapt-get.exe -i build-upload c:\waptdev\RND-0279A1F4-BBBE-43AE-A591-F82652E0104B_0-wapt

Indication

Si vous avez préalablement installé le paquet tis-waptdev sur votre ordinateur de développement, l’éditeur PyScripter se lancera automatiquement et ouvrira le paquet en mode développement.

wapt-get update-package-sources¶

La commande wapt-get upload-package <chemin vers le paquet> télécharge un paquet sur le dépôt principal de WAPT.

La commande wapt-get remove tis-firefox renvoie :

Using config file: C:\Users\documentation\AppData\Local\waptconsole\waptconsole.ini
Latis Mozilla Firefox version is: 95.0.2
Download URL is: https://download-installer.cdn.mozilla.net/pub/firefox/releases/95.0.2/win64/en-US/Firefox%20Setup%2095.0.2.exe
Downloading: Firefox_Setup_95.0.2.exe
Firefox_Setup_95.0.2.exe[================================] 54810424/54810424 - 00:00:07
Software version updated (from: 94.0.1 to: 95.0.2)
Packages updated :
c:\waptdev\tis-firefox_0-wapt

Indication

Si vous avez préalablement installé le paquet tis-waptdev sur votre ordinateur de développement, l’éditeur PyScripter se lancera automatiquement et ouvrira le paquet en mode développement.

Utilisation des lignes de commande pour la gestion de WaptWUA ¶

wapt-get clean¶

Le wapt-get waptwua-scan analyse l’état de Windows par rapport aux règles actuelles et envoie le résultat au serveur.

La commande wapt-get clean renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Ensure wuauserv Auto Update option is disabled
Scanning with windows updates rules:
{
"direct_download": false,
"default_allow": false,
"filter": "Type='Software' or Type='Driver'",
"download_scheduling": "7d",
"install_scheduling": null,
"install_delay": null,
"postboot_delay": "10m"
}
Downloading wsusscn2.cab file from https://srvwapt.mydomain.lan/waptwua/wsusscn2.cab
wsusscn2.cab[================================] 1024297844/1024297844 - 00:02:04
Windows updates rules have been changed
Looking for updates with filter: Type='Software' or Type='Driver'
  Connecting to local update searcher using offline wsusscn2 file...
  Offline Update searcher ready...
Waiting for WUA search to complete
Done searching
WUA Search completed !
Updates scan done.
Writing status in local wapt DB
Status: OK
(0, 0, 0)
None
re-enabling wuauserv previous state: 0

wapt-get download¶

La commande wapt-get waptwua-download analyse l’état de Windows par rapport aux règles actuelles, télécharge les kb manquants et envoie le résultat au serveur.

La commande wapt-get download-upgrade renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Ensure wuauserv Auto Update option is disabled
Downloading wsusscn2.cab file from https://srvwapt.mydomain.lan/waptwua/wsusscn2.cab
wsusscn2.cab[================================] 1024297844/1024297844 - 00:00:26
Start of install for all pending Windows updates
Scanning with params:
{
"direct_download": false,
"default_allow": false,
"filter": "Type='Software' or Type='Driver'",
"download_scheduling": "7d",
"install_scheduling": null,
"install_delay": null,
"postboot_delay": "10m"
}
Scanning with windows updates rules:
{
"direct_download": false,
"default_allow": false,
"filter": "Type='Software' or Type='Driver'",
"download_scheduling": null,
"install_scheduling": null,
"install_delay": null,
"postboot_delay": "10m"
}
Bypassing scan, no change since last successful scan
Writing status in local wapt DB
Status: OK
{'downloaded': [], 'missing': []}
None
re-enabling wuauserv previous state: 0

wapt-get install¶

Le wapt-get waptwua-install installe les mises à jour en attente.

La commande wapt-get list renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Ensure wuauserv Auto Update option is disabled
Downloading wsusscn2.cab file from https://srvwapt.mydomain.lan/waptwua/wsusscn2.cab
wsusscn2.cab[================================] 1024297844/1024297844 - 00:00:26
Start of install for all pending Windows updates
Scanning with params:
{
"direct_download": false,
"default_allow": false,
"filter": "Type='Software' or Type='Driver'",
"download_scheduling": "7d",
"install_scheduling": null,
"install_delay": null,
"postboot_delay": "10m"
}
Scanning with windows updates rules:
{
"allowed_products": null,
"allowed_classifications": null,
"allowed_severities": null,
"allowed_updates": null,
"forbidden_updates": null,
"allowed_kbs": null,
"forbidden_kbs": null,
"default_allow": false
}
Looking for updates with filter: Type='Software' or Type='Driver'
  Connecting to local update searcher using offline wsusscn2 file...
  Offline Update searcher ready...
Waiting for WUA search to complete
Done searching
WUA Search completed !
Updates scan done.
Installed 07609d43-d518-4e77-856e-d1b316d1b8a8 : MSXML 6.0 RTM Security Update  (925673)
Installed bb49cc19-8847-4986-aa93-5e905421e55a : Security Update for Microsoft Visual C++ 2005 Service Pack 1 Redistributable Package (KB2538242)
Installed 729a0dcb-df9e-4d02-b603-ed1aee074428 : Security Update for Microsoft Visual C++ 2008 Service Pack 1 Redistributable Package (KB2538243)
Installed 719584bc-2208-4bc9-a650-d3d6347eb32e : Security Update for Microsoft Visual C++ 2010 Service Pack 1 Redistributable Package (KB2565063)
Installed a8761130-35b6-41ce-8b67-2d35bb2d0846 : 2021-02 Cumulative Update for .NET Framework 3.5 and 4.8 for Windows 10, version 20H2 for x64 (KB4601050)
Installed 30f75e5d-2c46-42be-aef6-97ae730452be : 2021-07 Cumulative Update for Windows 10 Version 20H2 for x64-based Systems (KB5004945)
Installed 6e88be6e-d470-4e7e-9f36-01479049aadb : 2021-08 Servicing Stack Update for Windows 10 Version 20H2 for x64-based Systems (KB5005260)
Installed a15155a4-1299-41ff-9a39-28a33ce7cadd : 2021-12 .NET Core 3.1.22 Security Update for x64 Client (KB5009193)
Installed 38db0ad6-27f8-4bf9-ab2a-cffc4d7bc390 : Windows Malicious Software Removal Tool x64 - v5.96 (KB890830)
Scanning with windows updates rules:
{
"direct_download": false,
"default_allow": false,
"filter": "Type='Software' or Type='Driver'",
"download_scheduling": "7d",
"install_scheduling": null,
"install_delay": null,
"postboot_delay": "10m"
}
Windows updates rules have been changed
Writing status in local wapt DB
Status: OK
[]
None
re-enabling wuauserv previous state: 2

wapt-get waptwua-status¶

La commande wapt-get update-status renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
{'enabled': None,
'last_error': 'OperationalError: cannot rollback - no transaction is active',
'last_install_batch': [],
'last_install_date': None,
'last_install_reboot_required': None,
'last_install_result': None,
'last_scan_date': '2022-01-07T10:20:50.213644',
'last_scan_duration': 1490.500022649765,
'missing_downloads': [],
'rules_packages': [],
'status': 'SCANNING',
'wsusscn2cab_date': '2021-12-14T04:06:46'}
None

wapt-get restart-waptservice¶

The wapt-get restart-waptservice restart waptservice on Windows, Linux and MacOS.

Utilisation des lignes de commande pour l’interaction avec les utilisateurs ¶

wapt-get upgrade¶

La commande wapt-get propose-upgrade lance une proposition de mise à niveau en lançant waptexit dans les sessions ouvertes.

La commande wapt-get upgrade renvoie:

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
{'result': 1, 'summary': 'waptexit launched for 1 sessions'}

Utilisation des lignes de commande pour la configuration initiale¶

wapt-get register¶

La commande wapt-get create-keycert [<options>] crée une paire de clés RSA et un certificat X509.

Liste des options disponibles¶
Option	Description	Valeur par défaut
`--CommonName`	Nom d’affichage du certificat	/
`--CommonName64`	Nom d’affichage du certificat, encodé en base64 (si accents, espaces etc.)	/
`--CodeSigning` \|enterprise_feature\|\|	Si le certificat / la paire de clés sera autorisé(e) à signer des paquets de logiciels	`0`
`--CA` \|enterprise_feature\|\|	Si ce certificat / paire de clés peut être utilisé pour signer d’autres certificats (Autorité de certification principale ou intermédiaire)	`0`
`--ClientAuth`	Correspond à une propriété (utilisation) du certificat	`-` pour non installé
`--PrivateKeyPassword`	Mot de passe pour déverrouiller la clé si `--NoPrivateKeyPassword` n’est pas utilisé	Mot de passe généré aléatoirement
`--PrivateKeyPassword64` si `--PrivateKeyPassword` n’est pas utilisé	Mot de passe pour déverrouiller la clé, codé en base64 (si accents, espaces etc.)	Mot de passe généré aléatoirement
`--NoPrivateKeyPassword`	Si la clé privée n’est pas chiffrée si `--PrivateKeyPassword` ou `--PrivateKeyPassword64` ne sont pas utilisés	Vide
`-F`	Forcer l’écrasement du certificat existant	/
`--Pays`	Nom du pays du titulaire du certificat à enregistrer dans le certificat.	/
`--Localité`	Nom de la ville du titulaire du certificat à inscrire dans le certificat.	/
`--Organisation`	Nom de l’organisation du titulaire du certificat à enregistrer dans le certificat.	/
`--OrgUnit`	Nom de l’unité d’organisation (service) du titulaire du certificat à enregistrer dans le certificat.	/
`--Email`	Adresse e-mail du détenteur du certificat à enregistrer dans le certificat	/
`--CAKeyFilename`	Chemin vers la clé (`.pem`) d’une autorité de certification	Paramètre `default_ca_key_path` dans `waptconsole.ini`
`--CACertFilename`	Chemin vers le certificat (`.crt`) d’une autorité de certification	Paramètre `default_ca_cert_path` dans `waptconsole.ini`
`--CAKeyPassword`	Mot de passe pour déverrouiller la clé de l’Autorité de Certification	/
`-NoCAKeyPassword`	Si la clé de l’autorité de certification n’est pas chiffrée	/
`--BaseDir`	Dossier où la clé privée et le certificat public seront stockés.	Répertoire `personal_certificate_path` dans `waptconsole.ini`
`-EnrollNewCert`	Copiez le certificat dans `waptssl`	/
`-SetAsDefaultPersonalCert`	Le chemin du certificat est attribué à `personal_certificate_path` dans `waptconsole.ini`	/

La commande wapt-get clean renvoie :

Using config file C:\Users\Administrator\AppData\Local\waptconsole\waptconsole.ini
BaseDir: C:\private\
Common name of certificate to create: documentation
Private Key Filename: C:\private\documentation.pem
Certificate Filename: C:\private\documentation.crt
New private key password: QR.-DVp6MPGW

Avertissement

Si default_ca_key_path et default_ca_cert_path sont définis dans C:UsersAdministratorAppDataLocalwaptconsolewaptconsole.ini, vous devez placer le certificat CA au même endroit.

Sinon, cette erreur apparaît :

wapt-get create-keycert
Using config file C:\Users\tisadmin\AppData\Local\waptconsole\waptconsole.ini
BaseDir: C:\Users\tisadmin\private\
Common name of certificate to create: CRT
Exception at 00483595: Exception:
CA Certificate C:\Program Files (x86)\wapt\ssl does not exist.

wapt-get build-package¶

Le wapt-get build-waptagent [</ConfigFilename>] compile et télécharge un package waptagent.exe et waptupgrade.exe en utilisant le paramètre /ConfigFilename du fichier ini. Pour le fichier ini, utilisez la syntaxe wapt-get.ini.

Note

Par défaut, utilisez la configuration waptconsole.ini.

La commande wapt-get update renvoie:

Building customized waptagent.exe installer
......................................................................................
Built C:\Users\documentation\AppData\Local\Temp\wapt20220107T12203700000.tmp\waptupgrade\waptagent.exe
Private key Password for C:\Users\documentation\private\documentation.crt : ********
Building waptupgrade package
Waptserver https://srvwapt.mydomain.lan Admin User () :admin
Waptserver Password: ************
Uploading customized waptagent.exe installer
Uploading C:\Users\documentation\AppData\Local\Temp\wapt20220107T12203700000.tmp\waptupgrade\waptagent.exe to waptserver https://srvwapt.mydomain.lan
OK
Uploading C:\Users\documentation\AppData\Local\Temp\wapt20220107T12203700000.tmp\tis-waptupgrade_2.1.2.10605-0_all_PROD_all.wapt to waptserver https://srvwapt.mydomain.lan
OK : 1 Packages uploaded, 0 errors. Errors:

Utilisation des lignes de commande pour la gestion des référentiels¶

wapt-get upload-package¶

La commande wapt-get upload-package <chemin vers le paquet> télécharge un paquet sur le dépôt principal de WAPT.

La commande wapt-get upload-package C:waptdev is-tightvnc.wapt renvoie :

Using config file: C:\Users\documentation\AppData\Local\waptconsole\waptconsole.ini
Uploading packages to https://srvwapt.mydomain.lan
Please get login for https://srvwapt.mydomain.lan/api/v3/upload_xxx:admin
Password:
c:\waptdev\tis-tightvnc.wapt[================================] 54316019/54316019 - 00:00:17
OK : 1 Packages uploaded, 0 errors

wapt-get sign-package¶

Indication

Cette commande ne concerne que les dépôts Windows

La commande wapt-get scan-packages <directory> reconstruit un fichier Packages pour le dépôt de packages http.

La commande wapt-get update-status renvoie :

Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Packages filename: C:\wapt\waptserver\repository\wapt
Processed packages:
  C:\wapt\waptserver\repository\wapt\tis-firefox.wapt
  C:\wapt\waptserver\repository\wapt\tis-tightvnc.wapt
  C:\wapt\waptserver\repository\wapt\tis-7zip.wapt
Skipped packages:

wapt-get sign-package¶

Indication

Cette commande est seulement pour les dépôts Linux

La commande wapt-scanpackages <directory> reconstruit un fichier Packages pour le dépôt de packages http.

La commande wapt-get sources tis-firefox ne renvoie rien;

Re-signature des paquets sur le serveur à l’aide d’une ligne de commande¶

Indication

Ces commandes ne sont disponibles que sur les serveurs Linux

Danger

Avant d’utiliser cette méthode, assurez-vous que votre serveur WAPT est sûr et n’est pas sous le contrôle d’une entité tierce non autorisée.

Copiez vos .crt et .pem dans /tmp/ sur le serveur WAPT en utilisant Winscp ou un outil équivalent.
Il est alors possible de re-signer tous les paquets en une seule fois sur le serveur WAPT avec les commandes suivantes.

wapt-signpackages -d /var/www/wapt-host -c /tmp/wapt_pub_key.crt -k /tmp/wapt_priv_key.pem -s
wapt-signpackages -d /var/www/wapt -c /tmp/wapt_pub_key.crt -k /tmp/wapt_priv_key.pem -s
wapt-scanpackages /var/www/wapt/

Avertissement

Si l’erreur Access violation apparaît, c’est que le paquet est trop gros.

Éditez le paquet et suivez cette procédure.

Indication

Utilisez cette méthode si la resignature à partir de la méthode de la console WAPT n’aboutit pas.

Attention

Supprimez vos fichiers .crt et .pem de /tmp/ sur le serveur WAPT.

Utilisation de lignes de commande spéciales avec WAPT¶

Option	Définition
`--version`	Afficher le numéro de version du programme et quitter
`-h` \| `--help`	Afficher le message d’aide et quitter
`-c CONFIG` \| `--config=CONFIG`	Chemin vers un autre fichier comme `wapt-get.ini` ou `waptconsole.ini`. Remplace le fichier normalement utilisé par la ligne de commande.
`-l LOGLEVEL` \| `--loglevel=LOGLEVEL`	Niveau des fichiers journaux suivant cette liste : “debug”, “warning”, “info”, “error”, “critical” (par défaut : warning)
`-D` \| `--direct`	N’utilisez pas le service http pour les mises à jour/mises à niveau
`-S` \| `--services`	Demander un utilisateur de Waptservice
`-u` \| `--update-packages`	Exécuter `wapt-get update` avant la ligne de commande
`-f` \| `--force`	Forcez la ligne de commande
`-p PARAMS` \| `--params=PARAMS`	Configurer les paramètres comme un objet JSon
`-r WAPT_URL` \| `-repo WAPT_URL` \| `--repository=WAPT_URL`	Remplace l’URL du dépôt principal de wapt à partir du fichier `wapt-get.ini` ou `waptconsole.ini`
`-y` \| `--hide`	Utilisation des fonctions les plus courantes dans WAPT via ligne de commande
`-F FILTRE_ON_HOST_CAP` \| `--use-host-caps=FILTRE_ON_HOST_CAP`	Filtrer les packages en fonction des capacités actuelles de l’hôte (0/1)
`-i` \| `--inc-release`	Augmenter le numéro de version lors de la construction du packaging
`-a UPDATE_SERVER_STATUS` \| `--update-server-status=UPDATE_SERVER_STATUS`	Envoyer l’état mis à jour de l’hôte (soft, packages, etc…) au serveur après action. `UPDATE_SERVER_STATUS` prend une valeur de 0 ou 1)
`keep-signature-date`	Conserve la date de signature du packaging actuel, et le temps de changement de fichier. Uniquement pour `wapt-get sign-package`
`-s SECTION_FILTER` \| `--sections=SECTION_FILTER`	Ajout d’un filtre sectionà la recherche `wapt-get`. Section c’est type de packaging
`-o REDIRECT_OUTPUT` \| `--output=REDIRECT_OUTPUT`	Rediriger les sorties vers un fichier donné `.ini`
`-j` \| `-json`	Passage à la sortie json pour les scripts
`-e ENCODING` \| `--encoding=ENCODING`	Changer l’encodage des caractères pour la sortie
`-x EXCLUDES` \| `--excludes=EXCLUDES`	Liste de fichiers ou de répertoires séparés par des virgules à exclure pour build-package
`-k PERSONAL_CERTIFICATE_PATH` \| `--certificate=PERSONAL_CERTIFICATE_PATH`	Chemin vers le certificat PEM X509 pour signer les packages. Les packages ne sont pas signés s’ils ne sont pas fournis
`-w PRIVATE_KEY_PASSWD` \| `--private-key-passwd=PRIVATE_KEY_PASSWD`	Chemin d’accès au fichier contenant le mot de passe de la clé privée
`-U USER` \| `--user=USER`	Pour définir un utilisateur interactif
`-g USERGROUPS` \| `--usergroups=USERGROUPS`	Groupes de l’utilisateur final sous forme de tableau JSon pour vérifier les autorisations d’installation
`-t MAX_TTL` \| `--maxttl=MAX_TTL`	durée axiale d’exécution en minutes du processus wapt-get avant d’être tué par un wapt-get ultérieur (par défaut : 60 minutes)
`-L LANGUAGE` \| `--language=LANGUAGE`	Langue prioritaire pour l’installation, exemple : fr (par défaut : en)
`-m MD` \| `--message-digest=MD`	Message digest type pour `wapt-get sign-package`
`-n` \| `--newest-only`	Renvoyer uniquement la version la plus récente des packages lors de l’utilisation de la recherche `wapt-get`
`--locales=LOCALES`	Remplace le filtre local des packages pour la recherche `wapt-get`
`--maturité=MATURITÉ`	Définir/modifier la maturité du packaging lors de la création du packaging
`--pin-server-cert`	Lors de l’enregistrement, épinglez le certificat du serveur.
`--wapt-server-url=SET_WAPTSERVER_URL`	Lorsque le paramètre `wapt_server` n’est pas défini, défini dans `wapt-get.ini`.
`--wapt-repo-url=SET_WAPTREPO_URL`	Lorsque le paramètre `repo_url` n’est pas défini, défini dans `wapt-get.ini`.
`--wapt-server-user=WAPT_SERVER_USER`	Définit l’utilisateur chargé de télécharger les packages vers le serveur
`--wapt-server-passwd=WAPT_SERVER_PASSWD`	Définit le mot de passe pour télécharger les packages vers le serveur
`--log-to-windows-events`	Consigner les étapes dans le journal des événements de Windows
`--use-gui`	Force l’utilisation de GUI Helper même si elle n’est pas en mode dev
`--no-ide`	Ne lancez pas d’idéal lors de l’édition d’un packaging