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

feature available

feature not available

feature not available

Les logiciels

Nom du logiciel dans le registre

feature available

feature available

feature available

Version

Version du logiciel dans le registre

feature available

feature available

feature available

Désinstaller la chaîne

Chaîne de désinstallation du logiciel dans le registre

feature available

feature not available

feature not available

Note

  • Sous Windows, ces informations sont collectées par WAPT à partir du registre en deux localisations :

    • Ordinateur\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall

    • Machine\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall

  • 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:\waptdev\tis-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:\waptdev\tis-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

feature available

nompaquet

Nom du paquet

feature available

version

Change la version du packaging dans le fichier control. S’il n’est pas défini, la même version est dupliquée.

feature not available

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.

feature not available

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

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 update-status

La commande wapt-get update-status renvoie :

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

Utilisation des lignes de commande pour l’interaction avec les utilisateurs WAPT Enterprise feature only

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