Attention : le support de WAPT 2.1 a pris fin le 10 jangiver 2023.

Merci de mettre à jour sur la version supportée la plus récente

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.

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 prend un argument. Cet argument est le nom paquet ou une liste de noms de paquets avec le préfixe du référentiel.

Indication

Il est possible d’installer plusieurs paquets avec la même commande :

wapt-get install package1 package2

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.

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 uninstall

La commande wapt-get uninstall <nom du paquet> exécute la fonction de désinstallation du paquet si elle existe.

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

L’exécution de la fonction de désinstallation du paquet ne supprime pas le paquet sur l’hôte.

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

wapt-get forget

La commande wapt-get forget <package name> installe l’état du paquet à partir de la base de données locale.

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 paquet ne désinstalle pas le paquet.

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

wapt-get audit

La commande wapt-get audit [<nom du paquet>] exécute la fonction d’audit.

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 paquet>] exécute la fonction d’audit de paquet.

De même, la commande wapt-get audit exécute la fonction d’audit pour tous les paquets installés sur l’hôte.

La commande wapt-get uninstall 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.

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 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 d'archivage de 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-params

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

La commande wapt-get show-log <nom du paquet> renvoie les derniers journaux d’audit stockés dans la base de données sqlite locale de l’agent.

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

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

La commande wapt-get list-upgrade liste les paquets WAPT qui doivent être mis à niveau sur l’hôte.

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)

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:

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 unregister

La commande wapt-get unregister supprime l’inventaire matériel et logiciel de l’ordinateur sur le serveur d’inventaire 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.

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

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

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": [
    "test-notepadplusplus(=8.2-10)"
  ],
  "pending": {
    "install": [],
    "upgrade": [
    "test-notepadplusplus(=8.2-10)"
    ],
    "additional": [],
    "remove": [],
    "immediate_installs": []
  }
}

wapt-get add-licence

La commande wapt-get add-licence ajoute la licence sur le serveur.

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

wapt-get check-licences

La commande wapt-get check-licences affiche les licences enregistrées sur le serveur.

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

wapt-get dnsdebug

La commande wapt-get dnsdebug montre les informations dns locales.

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: []

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.

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.

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-registry renvoie une liste des logiciels installés présents dans le registre.

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

UninstallKey

Désinstaller l’identifiant de clé dans le registre

fonctionnalité disponible

fonctionnalité non disponible

fonctionnalité non disponible

Software

Nom du logiciel dans le registre

fonctionnalité disponible

fonctionnalité disponible

fonctionnalité disponible

Version

Version du logiciel dans le registre

fonctionnalité disponible

fonctionnalité disponible

fonctionnalité disponible

Uninstallstring

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

fonctionnalité disponible

fonctionnalité non disponible

fonctionnalité non disponible

Note

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

    • ComputerHKEY_LOCAL_MACHINESOFTWAREMicrosoftWindowsCurrentVersionUninstall

    • ComputerHKEY_LOCAL_MACHINESOFTWAREWOW6432NodeMicrosoftWindowsCurrentVersionUninstall

  • Sous Linux, ces informations sont collectées par WAPT dans Applications

  • Sous Mac OS, ces informations sont collectées par WAPT dans /var/lib/dpkg/info/

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

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 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 sources tis-firefox ne renvoie rien;

wapt-get make-template

Avertissement

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

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 ne doit être utilisée que si vous ne pouvez pas utiliser la console pour créer un paquet.

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

nommachine

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

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 :

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\documentation_0-wapt
You can build and upload the WAPT package by launching
  C:\Program Files (x86)\wapt\wapt-get.exe build-upload c:\waptdev\documentation_0-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.

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 et le préfixe du paquet, il est défini par le fichier control.

wapt-get sign-package

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

Attention

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

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

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

wapt-get build-upload

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

Indication

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

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

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

wapt-get duplicate

La commande wapt-get duplicate <répertoire ou paquet> <nouveau-nom-paquet> [<nouvelle-version> [<répertoire cible>]] duplique un paquet.

Avertissement

Ne l’utilisez pas pour le paquet hôte.

Utilisez ces arguments :

Arguments

Définition

Requis

dossier ou paquet

Chemin du répertoire du paquet ou du paquet compilé dans .wapt

fonctionnalité disponible

nouveau-nom-paquet

Nom du nouveau paquet

fonctionnalité disponible

nouvelle-version

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

fonctionnalité non disponible

répertoire cible

Chemin vers le répertoire cible du paquet dupliqué. S’il n’est pas défini, utilise le même que celui du paquet source.

fonctionnalité non disponible

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

Using config file: C:\Users\documentation\AppData\Local\waptconsole\waptconsole.ini
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 paquet.

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

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 update-package-sources <chemin vers le paquet> exécute la fonction 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

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 Fonctionnalité WAPT Enterprise uniquement

wapt-get waptwua-scan

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

wapt-get waptwua-download

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

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

wapt-get waptwua-install

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

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

waptwua-status

Le wapt-get waptwua-status renvoie le statut de la dernière mise à jour.

La commande wapt-get waptwua-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 Fonctionnalité WAPT Enterprise uniquement

wapt-get propose-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 propose-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 create-keycert

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 Fonctionnalité WAPT Enterprise uniquement

Si le certificat / la paire de clés sera autorisé(e) à signer des paquets logiciels

0

--CA Fonctionnalité WAPT Enterprise uniquement

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

1 pour un certificat non-CA

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

/

--Country

Nom du pays du titulaire du certificat à enregistrer dans le certificat.

/

--Locality

Nom de la ville du titulaire du certificat à inscrire dans le certificat.

/

--Organization

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 de personal_certificate_path dans waptconsole.ini

-EnrollNewCert

Copie le certificat dans waptssl

/

-SetAsDefaultPersonalCert

Le chemin du certificat est assigné à personal_certificate_path dans waptconsole.ini

/

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 C:UsersAdministratorAppDataLocalwaptconsolewaptconsole.ini, vous devez placer le certificat CA au même endroit.

Sinon cette erreur apparait :

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

Le wapt-get build-waptagent [</ConfigFilename>] compile et télécharge un paquet 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, utilise la configuration waptconsole.ini.

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\test-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 dépôts

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

Indication

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

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

La commande wapt-get scan-packages C:waptwaptserverrepositorywapt 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-scanpackages

Indication

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

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

La commande wapt-scanpackages /var/www/wapt/ 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 des lignes de commande avec des options

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’utilise pas le service http pour les mises à jour/mises à niveau

-S | --service

Demander un utilisateur pour Waptservice

-u | --update-packages

Exécuter wapt-get update avant la ligne de commande

-f | --force

Forcer 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

Cacher la console pendant l’exécution de la ligne de commande

-F FILTER_ON_HOST_CAP | --use-host-caps=FILTER_ON_HOST_CAP

Filtrer les paquets en fonction des capacités actuelles de l’hôte (0/1)

-i | --inc-release

Augmentation du numéro de version lors de la construction du paquet

-a UPDATE_SERVER_STATUS | --update-server-status=UPDATE_SERVER_STATUS

Envoyer le statut mis à jour de l’hôte (soft, paquets, 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 paquet et la date de modification du fichier. Uniquement pour wapt-get sign-package

-s SECTION_FILTER | --sections=SECTION_FILTER

Add a filter section to wapt-get search. Section it’s type of package

-o REDIRECT_OUTPUT | --output=REDIRECT_OUTPUT

Redirige les sorties vers un fichier donné .ini

-j | -json

Switch la sortie json pour les scripts

-e ENCODING | --encoding=ENCODING

Changer l’encodage des caractères pour la sortie

-x EXCLUDES | --excludes=EXCLUDES

Liste séparée par des virgules des fichiers ou des répertoires à exclure pour build-package

-k PERSONAL_CERTIFICATE_PATH | --certificate=PERSONAL_CERTIFICATE_PATH

Chemin vers le certificat PEM X509 pour signer les paquets. Les paquets sont non 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 la forme d’un tableau JSon pour vérifier la permission 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

Type de résumé de message pour wapt-get sign-package

-n | --newest-only

Renvoie uniquement la version la plus récente des paquets lors de l’utilisation de wapt-get search

--locales=LOCALES

Remplacer le filtre local des paquets pour wapt-get search

--maturity=MATURITY

Définir/modifier la maturité du paquet lors de la construction du paquet

--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 paquets vers le serveur

--wapt-server-passwd=WAPT_SERVER_PASSWD

Définit le mot de passe pour télécharger des paquets 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 pas lancer l’ide lors de l’édition d’un paquet