4. 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¶
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 d’un Administrateur Local, 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
Chaque commande qui prend un nom de paquet comme paramètre peut également prendre le package_uuid unique du paquet comme paramètre (wapt-get install, wapt-get forget, etc.). L’utilisation d’un GUID permet de spécifier un paquet 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 :
4.1. Utilisation des fonctions les plus courantes dans WAPT via ligne de commande¶
4.1.1. wapt-get install¶
La commande wapt-get install <package name> lance l’installation d’un paquet.
Pour installer Mozilla Firefox, la commande est wapt-get install tis-firefox.
Il est possible d’installer plusieurs paquets à la fois :
wapt-get install package1 package2
Si le paquet n’a pas été téléchargé dans le cache, wapt-get install téléchargera d’abord le paquet dans le cache, puis l’Agent WAPT installera le paquet.
Attention
Installer un paquet WAPT avec wapt-get install n’ajoute pas le paquet comme dépendance à la machine.
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)
4.1.2. 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 disponibles pour le téléchargement par 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
4.1.3. wapt-get upgrade¶
La commande wapt-get upgrade lance l’installation des paquets WAPT en attente de mise à niveau ou en attente d’installation.
L’agent WAPT local télécharge d’abord ses paquets WAPT dans le cache local, puis l’agent WAPT les installe.
Indication
Il est recommandé de lancer la commande wapt-get update avant de lancer une commande wapt-get upgrade.
Sans le lancement préalable d’un update, l’agent WAPT n’installera rien.
La commande :code :wapt-get upgrade renvoie :
Installing tis-mumble
Shutting down Mumble
installing Mumble 1.2.3
=== install packages ===
tis-mumble
4.1.4. wapt-get remove¶
La commande wapt-get remove <nom du paquet> supprime les paquets WAPT listés de la machine.
La commande prend un argument. Cet argument est le nom paquet ou une liste de noms de paquets avec le préfixe du dépôt.
Pour supprimer Mozilla Firefox, la commande est wapt-get remove <prefix>-firefox.
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 à jour
Pour supprimer complètement un paquet d’un hôte, faites un wapt-get 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
4.1.5. wapt-get uninstall¶
La commande wapt-get uninstall [<nom du paquet>] désinstalle les paquets listés de la machine si une fonction def uninstall() existe dans les fichiers setup.py des paquets listés.
La commande prend un argument. Cet argument est le nom paquet ou une liste de noms de paquets avec le préfixe du dépôt.
Attention
Exécuter la fonction de désinstallation du paquet ne supprime pas le paquet en cache sur la machine.
La commande wapt-get uninstall tis-adwcleaner renvoie :
Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
Uninstalling tis-adwcleaner ...
None
Uninstallation done
4.1.6. wapt-get forget¶
La commande wapt-get forget <nom du paquet> supprime le paquet de la base de données locale afin que le cycle de vie du logiciel ou de la configuration ne soit plus géré par WAPT.
La commande prend un argument. Cet argument est le nom paquet ou une liste de noms de paquets avec le préfixe du dépôt.
Attention
Oublier le paquet WAPT ne désinstalle pas le logiciel ni la configuration associée au paquet WAPT.
La commande wapt-get forget tis-adwcleaner renvoie :
Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
=== Packages removed from status ===
tis-adwcleaner
4.1.7. wapt-get audit¶
La commande wapt-get audit [<nom du paquet>] exécute la fonction d’audit pour les paquets listés si une fonction def audit() existe dans les fichiers setup.py des paquets listés.
La commande prend un argument. Cet argument est le nom paquet ou une liste de noms de paquets avec le préfixe du dépôt.
De même, la commande wapt-get audit ALL exécute la fonction d’audit pour tous les paquets installés sur la machine.
La commande wapt-get audit 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
4.1.8. 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 WAPT sont disponibles sur le dépôt WAPT, 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
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>]
Si ce message apparaît, c’est que le certificat n’est pas fiable.
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"
4.1.9. wapt-get show-params¶
La commande wapt-get show-params <nom du paquet> renvoie une liste de paramètres qui seraient transmis à 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 dépôt.
La commande wapt-get show-params tis-7zip renvoie :
Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
tis-7zip : {True, 'documentation': True}
4.1.10. wapt-get show-log¶
La commande wapt-get show-log <nom du paquet> renvoie les derniers journaux d’audit déposés dans la base de données sqlite locale de l’Agent WAPT.
La commande prend un argument. Cet argument est le nom paquet ou une liste de noms de paquets avec le préfixe du dépôt.
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
4.1.11. 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 WAPT disponibles pour la machine qui exécute la commande, selon la locale, le système d’exploitation, l’architecture ou la maturité de l’hôte.
Si une autre langue, 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 de type mot-clé.
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
Valeur |
Statut |
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) |
Langue 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é.
Ipour installé.
4.1.12. wapt-get download¶
La commande wapt-get download <nom du paquet> télécharge le paquet WAPT dans le cache local.
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
4.1.13. wapt-get download-upgrade¶
La commande wapt-get download-upgrade télécharge les paquets à mettre à niveau dans le cache WAPT local.
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
4.1.14. 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 |
4.1.15. wapt-get list-upgrade¶
La commande wapt-get list-upgrade liste les paquets WAPT qui doivent être mis à niveau sur la machine.
La commande wapt-get list-upgrade renvoie :
Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
=== upgrade packages ===
tis-notepadplusplus(=8.2-10)
4.1.16. wapt-get -S tasks¶
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 -S tasks renvoie :
About to speak to waptservice...
Running task 14: Uninstall of tis-vlc (task #14), status:
4.2. Utilisation de lignes de commande spéciales avec WAPT¶
4.2.1. wapt-get restart-waptservice¶
La wapt-get restart-waptservice redémarre le waptservice sous Windows, Linux et macOS.
4.2.2. wapt-get add-config-from-url¶
La commande wapt-get add-config-from-url <filelink> <sha256hashfile> récupère un fichier de configuration dynamique json depuis l’url spécifiée et place le fichier dans le répertoire conf.d sous le dossier d’installation de wapt.
Le paramètre <sha256hashfile> est facultatif.
C:\Users\administrator>wapt-get add-config-from-url https://srvwapt.mydomain.lan/wapt/conf.d/default_config_55863a6b54a47255097b6403731b36de716fc7ee9ec824bffad36d5fdc49b6b5.json
New config installed as C:\Program Files (x86)\wapt\conf.d\default.json
4.2.3. wapt-get add-config-from-file¶
La commande wapt-get add-config-from-file <filepath> ajoute un fichier de configuration dynamique json dans le répertoire conf.d sous le dossier d’installation de wapt.
Le chemin d’accès au fichier de configuration dynamique json est défini par <filepath>.
4.2.4. wapt-get add-config-from-base64¶
La commande wapt-get add-config-from-file <base64 file> ajoute un fichier de configuration dynamique json dans le répertoire conf.d sous le dossier d’installation de wapt.
Le chemin d’accès au fichier de configuration dynamique json est défini par <fichier bbase64>.
4.2.5. wapt-get remove-config¶
La commande wapt-get remove-config <config-name> supprime les fichiers de configuration dynamique json spécifiés du dossier conf.d sous le dossier d’installation de wapt.
4.2.6. wapt-get list-config¶
La commande wapt-get list-config liste les fichiers de configuration dynamique json installés qui sont présents dans le dossier conf.d sous le dossier d’installation de wapt.
C:\Users\administrator>wapt-get list-config
Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
config files are located in C:\Program Files (x86)\wapt\conf.d
* config_base
4.2.7. wapt-get list-available-config¶
La commande wapt-get list-available-config liste tous les fichiers de configuration dynamique json disponibles sur le Serveur WAPT et indique la commande pour les installer.
Lister les configurations disponibles nécessite que l’utilisateur soit authentifié.
C:\Users\administrator>wapt-get list-available-config
Server: https://srvwapt.mydomain.lan
Server UUID: 32464dd6-c261-11e8-87be-cee799b43a00
Server CABundle: 0
Waptserver https://srvwapt.mydomain.lan Admin User () :admin
Waptserver Password: *************
default_config : wapt-get add-config-from-url https://srvwapt.mydomain.lan/wapt/conf.d/default_config_55863a6b54a47255097b6403731b36de716fc7ee9ec824bffad36d5fdc49b6b5.json
Server: https://srvwapt.mydomain.lan
Repo: https://srvwapt.mydomain.lan/wapt
default : wapt-get add-config-from-url https://srvwapt.mydomain.lan/wapt/conf.d/default_91ab2cd1901b5e36214224229c3461e49e65f7b065ea6b0eb16bd83c7fcdda57.json
Server: https://srvwapt.mydomain.lan
Repo: https://srvwapt.mydomain.lan/wapt
mac_config : wapt-get add-config-from-url https://srvwapt.mydomain.lan/wapt/conf.d/mac_config_2720657c276cbc0ee14734e68fbd0fadc4dea3171625406e10cd9828631e5c72.json
Server: https://srvwapt.mydomain.lan
Repo: https://srvwapt.mydomain.lan/wapt
4.2.8. wapt-get clean¶
La commande wapt-get clean supprime les paquets du dossier cache.
La commande est lancée après chaque wapt-get upgrade 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
4.2.9. 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
4.2.10. wapt-get add-upgrade-shutdown - wapt-get remove-upgrade-shutdown¶
Ces 2 commandes modifient le C:\Windows\System32\GroupPolicy\Machine\Scripts\scripts.ini sur les appareils Windows.
La commande
wapt-get add-upgrade-shutdownajoute 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-shutdownsupprime 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]
4.2.11. wapt-get register¶
La commande wapt-get register <description> envoie l’inventaire du matériel et des logiciels de l’ordinateur au Serveur WAPT.
Le paramètre <description> est facultatif.
Indication
Une description peut être passée comme argument à la commande wapt-get register, la description sera affichée dans la console WAPT dans la colonne description.
Vous pouvez bénéficier de WAPT pour améliorer votre gestion informatique en affectant une étiquette d’inventaire comme description pour vos machines par exemple.
Note
Si la machine est déjà enregistrée, le réenregistrement de la machine à l’aide d’une description met à jour les informations enregistrées.
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.
4.2.12. wapt-get unregister¶
La commande wapt-get unregister supprime l’inventaire matériel et logiciel de la machine du Serveur WAPT.
La commande wapt-get unregister 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.
4.2.13. wapt-get inventory¶
La commande wapt-get inventory affiche les informations d’inventaire de la machine 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"
],
...
4.2.14. wapt-get update-status¶
La commande wapt-get update-status envoie l’état actuel de la machine au Serveur 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 wapt-get 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}
4.2.15. wapt-get setlocalpassword¶
La commande wapt-get setlocalpassword permet de définir un mot de passe local pour l’installation des paquets WAPT.
La commande wapt-get setlocalpassword renvoie :
Local password:
Confirm password:
Local auth password set successfully
4.2.16. wapt-get reset-uuid¶
La commande wapt-get reset-uuid récupère le UUID de la machine à partir du BIOS et l’envoie au Serveur 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
4.2.17. wapt-get generate-uuid¶
La commande wapt-get generate-uuid génère un UUID aléatoire pour la machine et le renvoie au Serveur WAPT.
La wapt-get generate-uuid est utile s’il existe des bugs de BIOS avec certaines machines de la flotte.
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 commencent par RND-.
4.2.18. wapt-get get-server-certificate¶
La commande wapt-get get-server-certificate télécharge le certificat SSL du Serveur WAPT afin que l’Agent WAPT puisse établir une connexion HTTPS sécurisée avec le Serveur WAPT.
Le certificat téléchargé est déposé dans <wapt>\ssl\server.
La commande wapt-get get-server-certificate renvoie :
Server certificate written to C:\Program Files (x86)\wapt\ssl\server\srvwapt.mydomain.lan.crt
4.2.19. 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.
La commande wapt-get enable-check-certificate est utilisée 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
4.2.20. wapt-get check-upgrades¶
La commande wapt-get check-upgrades indique l’état de la mise à jour / mise à niveau la plus récente pour la machine.
La commande wapt-get check-upgrades 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": []
}
}
4.2.21. wapt-get add-licence¶
La commande wapt-get add-licence ajoute une licence WAPT sur le Serveur WAPT.
La commande wapt-get add-licence 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
4.2.22. wapt-get check-licences¶
La commande wapt-get check-licences montre les licences enregistrées sur le Serveur WAPT.
La commande wapt-get check-licences 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
4.2.23. wapt-get dnsdebug¶
La commande wapt-get dnsdebug affiche les données de configuration réseau de la machine, notamment les données locales DNS liées à WAPT.
La commande wapt-get dnsdebug renvoie :
DNS Server : dns.mydomain.lan
DNS Domain : mydomain.lan
Main repo url: https://srvwapt.mydomain.lan/wapt
wapt SRV: []
waptserver SRV: []
CNAME: []
4.3. Utilisation de la ligne de commande pour la configuration de la session utilisateur¶
4.3.1. 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.
La commande wapt-get session-setup exécute la fonction def session_setup() définie dans le fichier setup.py du paquet WAPT si la fonction existe.
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
4.4. Utilisation de la ligne de commande pour créer des paquets WAPT¶
4.4.1. 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 insensible à la casse pour rechercher le mot-clé spécifié.
Les informations retournées sont :
Information |
Définition |
Disponible sur Windows |
Disponible sur Linux |
Disponible sur macOS |
|---|---|---|---|---|
|
Recherche l’identifiant de la clé de désinstallation dans la ruche du registre. |
|
|
|
|
Recherche le nom du logiciel dans la ruche du registre. |
|
|
|
|
Recherche la version du logiciel dans la ruche du registre. |
|
|
|
|
Recherche la chaîne de désinstallation du logiciel dans la base de registre. |
|
|
|
Note
Sous Windows, WAPT effectue des recherches dans deux emplacements du registre :
ComputerHKEY_LOCAL_MACHINESOFTWAREMicrosoftWindowsCurrentVersionUninstall.ComputerHKEY_LOCAL_MACHINESOFTWAREWOW6432NodeMicrosoftWindowsCurrentVersionUninstall.
Sous Linux, WAPT effectue des recherches en utilisant
Applications.Sur macOS, WAPT recherche dans
/var/lib/dpkg/info/.
La sortie de wapt-get list-registry est un tableau listant les clés de désinstallation pour chaque logiciel correspondant au terme recherché.
La commande wapt-get list-registry firefox renvoie (sous Windows) :
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"
4.4.2. wapt-get sources¶
La commande wapt-get sources <nom du paquet> télécharge les sources depuis un dépôt de gestion du code source comme Git ou SVN.
La commande wapt-get sources tis-firefox ne renvoie rien ;
4.4.3. 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 <installer-path> [<packagename> [<source directoryname>]] permet de créer un modèle de paquet à partir d’un installateur msi ou exe.
La commande wapt-get make-template 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.
4.4.4. wapt-get make-host-template¶
Avertissement
Cette méthode est principalement destinée aux scripts, en général les paquets de la machine sont créés automatiquement 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.
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
4.4.5. wapt-get make-group-template¶
Avertissement
Cette méthode ne doit être utilisée que si vous ne pouvez pas utiliser la Console WAPT pour créer un paquet.
La commande wapt-get make-group-template <nom du groupe> crée un paquet WAPT group 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
4.4.6. wapt-get build-package¶
La commande wapt-get build-package <chemin vers le répertoire package> construit un paquet WAPT et le signe avec la clé privée de l”Administrateur.
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 build-package 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 : 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 du paquet, ni son préfixe, ces valeurs sont définies par le fichier control.
4.4.7. wapt-get sign-package¶
La commande wapt-get sign-package <chemin vers le paquet> signe un paquet avec la clé privée de l”Administrateur.
Attention
wapt-get sign-package ne renomme pas le paquet WAPT avec le préfixe de l”Organization.
La commande wapt-get sign-package C:\waptdev\smp-7zip_16.4.0.0-1_all.wap 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='
4.4.8. 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 à wapt-get build-upload, le numéro de version du paquet WAPT est incrémenté avant que le paquet ne soit téléchargé, afin d’éviter de devoir modifier manuellement le fichier :control.
La commande wapt-get -i build-upload C:\waptdev\tis-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 : 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
4.4.9. wapt-get duplicate¶
La commande wapt-get duplicate <source_package> <duplicated_package> duplique un paquet téléchargé depuis le dépôt et l’ouvre en tant que projet en utilisant l”IDE qui a été spécifié dans la configuration de la Console WAPT.
Avertissement
N’utilisez pas cette commande pour dupliquer un paquet host.
Argument |
Définition |
Requis |
|---|---|---|
<directory> ou <source_package> |
Définit le chemin de répertoire vers le paquet WAPT ou le nom d’un paquet spécifique ayant une extension de fichier .wapt. |
|
<duplicated_package> |
Définit le nom du nouveau paquet. |
|
<duplicated_package_version> |
Change la version du paquet dans le fichier |
|
<duplicated_package_target_directory> |
Définit le chemin d’accès au répertoire cible du paquet dupliqué. Si le répertoire cible n’est pas défini, le paquet dupliqué sera déposé dans le même répertoire que le paquet 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
4.4.10. wapt-get edit¶
Avertissement
Cette méthode ne doit être utilisée que si vous ne pouvez pas utiliser la Console WAPT pour créer un paquet.
La commande wapt-get edit <nom du paquet> télécharge et ouvre le paquet dans un IDE pour le modifier.
La commande prend un argument. Cet argument est le nom paquet ou une liste de noms de paquets avec le préfixe du dépôt.
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.
Vous pouvez éditer un paquet local en allant dans le dossier du paquet puis en tapant wapt-get edit ..
Une autre méthode, vous pouvez éditer un paquet local à partir de son nom de répertoire ou du nom du paquet wapt, exemple wapt-get edit tis-vlc.wapt.
4.4.11. wapt-get edit-host¶
Avertissement
Cette méthode ne doit être utilisée que si vous ne pouvez pas utiliser la Console WAPT pour créer un paquet.
La commande wapt-get edit-host <host FQDN> édite un paquet WAPT host.
La commande wapt-get edit-host RND-0279A1F4-BBBE-43AE-A591-F82652E0104B 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
4.4.12. wapt-get update-package-sources¶
La commande wapt-get update-package-sources <chemin vers le paquet> met à jour la fonction def update_package() dans le fichier :setup.py.
La commande wapt-get update-package-sources 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
4.5. Utilisation des lignes de commande pour la gestion de WaptWUA 
¶
4.5.1. wapt-get waptwua-scan¶
La wapt-get waptwua-scan analyse l’état des mises à jour de Windows par rapport aux règles actuelles et renvoie le résultat au Serveur WAPT.
La commande wapt-get waptwua-scan 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
4.5.2. wapt-get waptwua-download¶
La commande wapt-get waptwua-download analyse l’état de l’agent de mise à jour Windows par rapport aux règles actuelles, puis télécharge les kb manquants et enfin envoie le résultat au Serveur WAPT.
La commande wapt-get waptwua-download 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
4.5.3. wapt-get waptwua-install¶
La commande wapt-get waptwua-install installe les mises à jour Windows en attente sur la machine.
La commande wapt-get waptwua-install 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
4.5.4. wapt-get waptwua-status¶
La commande wapt-get waptwua-status renvoie l’état le plus récent de Windows Update pour la machine.
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
4.6. Utiliser la ligne de commande pour interagir avec les utilisateurs ¶
4.6.1. wapt-get propose-upgrade¶
La commande wapt-get propose-upgrade propose aux utilisateurs connectés de lancer les mises à jour en attente.
La commande wapt-get propose-upgrade renvoie :
Using config file: C:\Program Files (x86)\wapt\wapt-get.ini
{'result': 1, 'summary': 'waptexit launched for 1 sessions'}
4.7. Utilisation des lignes de commande pour la configuration initiale¶
4.7.1. wapt-get create-keycert¶
La commande wapt-get create-keycert [<options>] crée une paire de clés RSA et un certificat X509.
Option |
Description |
Valeur par défaut |
|---|---|---|
|
Affiche le nom du certificat. |
/ |
|
Affiche le nom du certificat, encodé en base64 (si accents, espaces etc…). |
/ |
|
Définit si la paire certificat / clé sera autorisée à signer des paquets logiciels. |
|
|
Définit si le certificat / la paire de clés peut être utilisé(e) pour signer d’autres certificats (c’est-à-dire pour être autorisé(e) à se comporter comme une autorité de certification principale ou intermédiaire). |
|
|
Définit une propriété (usage) du certificat. |
|
|
Définit le mot de passe pour déverrouiller la clé si |
Mot de passe généré aléatoirement |
|
Définit le mot de passe pour déverrouiller la clé, encodé en base64 (si accents, espaces etc…). |
Mot de passe généré aléatoirement |
|
Définit la clé privée comme n’étant pas protégée par un mot de passe si |
Vide |
|
Force l’écrasement du certificat existant. |
/ |
|
Définit le nom du pays du titulaire du certificat à enregistrer dans le certificat. |
/ |
|
Définit le nom de la ville du titulaire du certificat à enregistrer dans le certificat. |
/ |
|
Définit le nom de l’organisation du titulaire du certificat à enregistrer dans le certificat. |
/ |
|
Définit le nom de l’unité d’organisation (service) du titulaire du certificat à enregistrer dans le certificat. |
/ |
|
Définit l’adresse e-mail du titulaire du certificat à enregistrer dans le certificat. |
/ |
|
Définit le chemin vers la clé privée ( |
Paramètre |
|
Définit le chemin vers le certificat public ( |
Paramètre |
|
Définit le mot de passe pour déverrouiller la clé d’une Autorité de Certification. |
/ |
|
Définit la clé de l’Autorité de Certification comme n’étant pas protégée par un mot de passe. |
/ |
|
Définit le dossier dans lequel la clé privée et le certificat public seront déposés. |
Répertoire |
|
Copie le certificat dans |
/ |
|
Définit le |
/ |
La commande wapt-get create-keycert 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 waptconsole.ini, alors 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.
4.7.2. wapt-get build-waptagent¶
La wapt-get build-waptagent [</ConfigFilename>] compile et télécharge un paquet waptagent.exe et un waptupgrade.exe en utilisant le paramètre /ConfigFilename pour spécifier le contenu du fichier de configuration wapt-get.ini des Agents WAPT.
Note
Par défaut, la commande utilise les éléments de configuration du fichier waptconsole.ini de la console WAPT.
La commande wapt-get build-waptagent 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:
4.8. Utilisation de lignes de commande spéciales avec WAPT¶
Option |
Définition |
|---|---|
|
Affiche le numéro de version de WAPT et quitte. |
|
Affiche ce message d’aide et quitte. |
|
Définit le chemin d’un autre fichier comme |
|
Définit le niveau des fichiers journaux en suivant cette liste : debug, warning, info, error, critical (défaut : warning). |
|
Indique de ne pas utiliser le service http pour update / upgrade. |
|
Demande un utilisateur du Waptservice. |
|
Exécute wapt-get update avant la commande spécifiée. |
|
Force la commande. |
|
Configure les paramètres comme un objet JSon. |
|
Remplace l’URL du dépôt WAPT principal tel que défini dans le fichier |
|
Masque la Console WAPT pendant l’exécution de la commande. |
|
Filtre les paquets en fonction des capacités actuelles de la machine (0/1). |
|
Incrémente le numéro de version de la version lors de la construction d’un paquet WAPT. |
|
Envoie le statut mis à jour de la machine (soft, paquets, etc.) au Serveur WAPT après l’action. |
|
Conserve la date de signature du paquet actuel, et la date de modification du fichier. A utiliser uniquement avec wapt-get sign-package. |
|
Ajoute un filtre section à wapt-get search. La section est le type de paquet. |
|
Redirige la sortie vers un fichier .ini dont le chemin est défini par |
|
Bascule sur une sortie formatée en json dans le but de réaliser des scripts d’automatisation. |
|
Change l’encodage des caractères pour la sortie. |
|
Définit une liste de fichiers ou de répertoires séparés par des virgules à exclure lors de la construction d’un paquet. |
|
Définit le chemin vers le certificat PEM X509 pour signer les paquets WAPT. Les paquets ne sont pas signés si le paramètre n’est pas fourni. |
|
Définit le chemin d’accès au fichier contenant le mot de passe de la clé privée. |
|
Définit un utilisateur interactif. |
|
Définit les groupes de l’utilisateur final comme un tableau formaté en json pour la vérification des autorisations d’installation. |
|
Définit la durée maximale d’exécution en minutes du processus wapt-get avant d’être tué par tout wapt-get ultérieur (défaut : 60 minutes). |
|
Remplace la locale pour l’installation des paquets WAPT, exemple : fr (défaut : en). |
|
Définit le type de résumé de message pour wapt-get sign-package. |
|
Renvoie uniquement la version la plus récente des paquets WAPT lorsque vous utilisez wapt-get search. |
|
Remplace le filtre local des paquets lorsque vous utilisez wapt-get search. |
|
Définit / modifie la maturité du paquet lors de la construction d’un paquet WAPT. |
|
Épingle le certificat du serveur lors de l’enregistrement de l’Agent WAPT. |
|
Définit l’url du Serveur WAPT lorsque le paramètre |
|
Définit l’url du dépôt WAPT lorsque le paramètre |
|
Définit l’utilisateur autorisé à télécharger des paquets vers le Serveur WAPT. |
|
Définit le mot de passe de l’utilisateur autorisé à télécharger des paquets vers le Serveur WAPT. |
|
Enregistre les étapes dans le journal des événements de Windows. |
|
Force l’utilisation de GUI Helper même si elle n’est pas en mode développement. |
|
Indique à WAPT de ne pas lancer l”IDE lors de l’édition d’un paquet WAPT. |