.. Reminder for header structure:
	Parts (H1)			    : #################### with overline
	Chapters (H2)		    : ******************** with overline
	Sections (H3)		    : ====================
	Subsections (H4)	  : --------------------
	Subsubsections (H5) : ^^^^^^^^^^^^^^^^^^^^
	Paragraphs (H6)		  : """""""""""""""""""""

.. meta::
  :description: Using WAPT with the Command Line
  :keywords: command line, WAPT, CLI, documentation

.. _wapt_cli:

################################
Using WAPT with the Command Line
################################

The WAPT agent provides a command line interface utility :program:`wapt-get`.

.. figure:: wapt-resources/command_line_interface.png
  :align: center
  :scale: 50%
  :alt: The Windows Command Line utility

  The Windows Command Line utility

.. note::

  * By default, command-line actions in WAPT are executed with the rights
    of the user who launched the :program:`cmd.exe`.

  * If the :term:`User` is not a :term:`Local Administrator` or if
    the :program:`cmd.exe` has not been launched with :term:`Local Administrator`
    privileges, the command will be passed on to the :program:`waptservice`.

  * For security reasons, some actions will require a login and a password.

  * Only :term:`Local Administrators` and members of the *waptselfservice*
    Active Directory security group are allowed.

  * To force using the WAPT service as a :term:`Local Administrator`,
    simply add *-S* after :command:`wapt-get.exe`.

.. toctree::
  :maxdepth: 3

.. _wapt_cli_common_commands:

*************************************************************
Using the more common functions in WAPT with the command line
*************************************************************

wapt-get update
===============

The :command:`update` command allow to update the list of available packages.

The local WAPT agent will download :file:`Packages` file from the private
repository and compare it to its local database.

* If new updates are available, the WAPT agent switches the packages
  status to **TO-UPGRADE**.

* If new software have been added on the repository, they become
  downloadable by the WAPT agent.

.. note::

  The :command:`update` command does not download packages, it only updates
  the local database of packages.

The command :code:`wapt-get update` returns:

.. code-block:: bash

  Update package list
  Total packages: 751
  Added packages:

  Removed packages:

  Upgradable packages:
  upgrade
  additional
  install
  remove
  Repositories URL:
  https://srvwapt.mydomain.lan/wapt
  https://srvwapt.mydomain.lan/wapt-host

wapt-get upgrade
================

The command :command:`wapt-get upgrade` allows to launch the installation
of packages waiting to be upgraded or waiting to be installed.

The local WAPT agent downloads if necessary WAPT packages in its local
cache then installs them.

.. hint::

  It's strongly advised to launch a :command:`wapt-get update` command before
  launching a :command:`wapt-get upgrade` command;

  Without previously launching a :command:`update`,
  the WAPT agent will install nothing;

The command :code:`wapt-get upgrade` returns:

.. code-block:: bash

  Installing tis-mumble
  Shutting down Mumble
  installing Mumble 1.2.8
  Installing w7demo.domain.lan

  === install packages ===
  w7demo.domain.lan (=3) | w7demo.domain.lan (3)

  === additional packages ===
  tis-mumble                     | tis-mumble (1.2.8-1)

.. _wapt_get_search:

wapt-get search
===============

The :command:`search` command allows to search for one or more package
in the repositories.

The search command takes one argument to be looked up in package name
and description.

The command :code:`wapt-get search "Firefox"` returns:

.. list-table::
  :header-rows: 1
  :widths: 25, 25, 15, 35

  * - Package name
    - Version
    - Plateform
    - Description
  * - tis-firefox
    - 50.0.2-73
    - all
    - Mozilla Firefox Web Browser in French
  * - tis-firefox-en
    - 50.0.1-58
    - all
    - Mozilla Firefox Web Browser in English
  * - tis-firefox-esr
    - 45.6.0-4
    - all
    - Mozilla Firefox Web Browser ESR
  * - tis-flashplayer
    - 24.0.0.186-1
    - all
    - Adobe Flashplayer for Firefox

wapt-get install
================

The :command:`install` command launches the installation of a package.

The command takes on argument. That argument is the package
name with the repository prefix.

To install Mozilla Firefox, the command is
:code:`wapt-get install <prefix>-firefox`.

.. note::

  If the package has not been downloaded to cache, :command:`install`
  will first download the package to cache, then it will install it.

.. attention::

  Installing a WAPT package with :command:`install` does not add the package
  as a dependency to the host.

  The package is installed on the machine, but if the computer is re-imaged,
  the package will not be reinstalled automatically.

The command :code:`wapt-get install tis-firefox` returns:

.. code-block:: bash

  installing WAPT packages tis-firefox
  Installing tis-firefox.local/wapt/tis-firefox_50.0.2-73_all.wapt: 44796043 / 44796043 (100%) (33651 KB/s)
  Firefox Setup 50.0.2.exe successfully installed.
  Disabling auto update
  Disabling profile migration from ie
  Override User UI

  === install packages ===
  tis-firefox                    | tis-firefox (50.0.2-73)

wapt-get remove
===============

The :command:`remove <package name>` command removes a package.

The command takes on argument. That argument is the package name with the
repository prefix.

To remove Mozilla Firefox, the command is
:command:`wapt-get remove <prefix>-firefox`.

.. attention::

  Removing a WAPT package with :command:`remove` does not remove
  the package dependency on the host.

  **The package will effectively be uninstalled from the machine,
  but it will automatically be reinstalled on the next :command:`upgrade`.**

  To completely remove a package from a host, do a :command:`remove`
  for the targeted package, then edit the host configuration via the WAPT
  console to remove the package dependency on the host.

The command :code:`wapt-get remove tis-firefox` returns:

.. code-block:: bash

  Removing tis-firefox ...

  === Removed packages ===
    tis-firefox

wapt-get clean
==============

The :command:`clean` command removes packages from the
:file:`C:\\Program Files (x86)\\wapt\\cache` folder.

The :command:`clean` command is launched after each upgrade to save disk space.

The command :code:`wapt-get clean` returns:

.. code-block:: bash

  Removed files:
  C:\Program Files (x86)\wapt\cache\tis-mumble_1.2.8-1_all.wapt
  C:\Program Files (x86)\\wapt\cache\tis-vlc_2.2.4-2_all.wapt

.. _wapt_cli_special_commands:

*************************************
Using special Command Lines with WAPT
*************************************

wapt-get register
=================

The :command:`wapt-get register <description>` command reports the computer
hardware and software inventory to the WAPT inventory server.

.. hint::

  You can pass a description as an argument to the :command:`register`,
  that description will be displayed in the WAPT console in the column
  :guilabel:`description`.

  You may benefit from WAPT to improve your IT management by affecting
  a username or a computer serial as descriptions for your hosts.

The command :command:`wapt-get register "John Doe PC` returns nothing.

wapt-get download
=================

The :command:`wapt-get download <package name>` command downloads
the WAPT package to the local cache located at
:file:`C:\\Program Files\\wapt\\cache`.

The command :command:`wapt-get download tis-7zip` returns:

.. code-block:: bash

  Downloading packages tis-7zip (=16.4-8)

  Downloaded packages:
    C:\Program Files (x86)\wapt\cache\tis-7zip_16.4-8_all_all.wapt

wapt-get download-upgrade
=========================

The :command:`wapt-get download-upgrade` command downloads packages
to be upgraded to the local WAPT cache :file:`C:\\Program Files (x86)\\wapt\\cache`.

The command :command:`wapt-get download-upgrade` returns:

.. code-block:: bash

  === downloaded packages ===
  C:\Program Files (x86)\wapt\cache\tis-firebird_2.5.5.26952-1_all.wapt

wapt-get show
=============

The :command:`wapt-get show <package name>` command displays informations
stored in the :file:`Packages` index file.

If several versions of a package are available on the repository, every version
of the package will be displayed.

The command :command:`wapt-get show tis-firebird` returns:

.. code-block:: bash

  Display package control data for tis-firebird

  package           : tis-firebird
  version           : 2.5.5.26952-1
  architecture      : all
  section           : base
  priority          : optional
  maintainer        : Hubert TOUVET
  description       : Firebird database SQL superserver with admin tools (Firebird Project)
  filename          : tis-firebird_2.5.5.26952-1_all.wapt
  size              : 7012970
  repo_url          : https://srvwapt.mydomain.lan/wapt
  md5sum            : 6f6d70630674f5d58a5259b1e6752221
  repo              : global

wapt-get list
=============

The :command:`wapt-get list` command lists WAPT packages that are installed
on the computer.

The command :command:`wapt-get list` returns:

.. list-table::
  :header-rows: 1
  :widths: 20 20 20 20 20

  * - package
    - version
    - install status
    - install_date
    - description
  * - tis-7zip
    - 16.4-8
    - OK
    - 2016-12-01T17:43
    - 7-zip compression and archiving software for x86 and x64
  * - tis-brackets
    - 1.8-1
    - OK
    - 2016-12-01T17:44
    - Brackets is a lightweight
  * - tis-ccleaner
    - 5.23.5808-0
    - OK
    - 2016-12-01T18:55
    - the right choice utility to quickly clean up, repair and optimize Windows
  * - tis-rsat-win7x64
    - 2
    - OK
    - 2016-12-02T10:46
    - package for MS RSAT Remote server admin windows6.1-kb958830-x64
      pour Win7 SP1
  * - tis-rsat-x64
    - 1
    - OK
    - 2016-12-02T10:51
    - package for MS RSAT Remote server admin windows6.1-kb958830-x64
      pour Win7 SP1
  * - tis-dotnetfx4.6
    - 4.6.2-1
    - OK
    - 2016-12-09T16:05
    - dot net FX 4.6.2 Framework CLient. Replaces 4/4.5/4.5.1/4.5.2/4.6/4.6.1

wapt-get upgradedb
==================

The :command:`wapt-get upgradedb` command upgrades the local WAPT database schema
if necessary.

The command :command:`wapt-get upgradedb` returns:

.. code-block:: bash

  WARNING upgrade db aborted: current structure version 20161109 is newer or equal to requested structure version 20161109
  No database upgrade required, current 20161109, required 20161109

wapt-get setup-tasks - wapt-get enable-tasks - wapt-get disable-tasks
=====================================================================

The :command:`wapt-get setup-tasks` command adds :command:`update`
and :command:`upgrade` scheduled tasks to local host.

.. hint::

  This function is useful when it is desirable not to use the WAPT service,
  otherwise :program:`waptservice` will take care of it.

To make it work, the following arguments must be configured
in :file:`wapt-get.ini`:

* *waptupdate_task_maxruntime*;

* *waptupgrade_task_maxruntime*;

* *waptupdate_task_period*;

* *waptupgrade_task_period*;

Then:

* The :command:`wapt-get enable-tasks` command will enable scheduled tasks.

* The  :command:`wapt-get disable-tasks` command will disable scheduled tasks.

wapt-get add-upgrade-shutdown - wapt-get remove-upgrade-shutdown
================================================================

* The :command:`wapt-get add-upgrade-shutdown` command
  adds a :program:`waptexit` local security policy object,
  enabling the execution of :program:`waptexit` at system shutdown.

* The :command:`wapt-get remove-upgrade-shutdown` command
  removes the :program:`waptexit` local security policy object,
  disabling the execution of :program:`waptexit` during system shutdown.

wapt-get inventory
==================

The :command:`wapt-get inventory` command displays all local inventory
information in JSON format.

The command :command:`wapt-get inventory` returns:

.. code-block:: ini

  {
    "wapt": {
      "setuphelpers-version": "1.3.8",
      "waptserver": {
        "dnsdomain": "mydomain.lan",
        "proxies": {
          "http": null,
          "https": null
        },
        "server_url": "https://srvwapt.mydomain.lan"
  },
  ...

wapt-get update-status
======================

The command :command:`wapt-get update-status` resends local status to the WAPT
inventory server.

.. note::

  If a hardware component has changed on the computer,
  :command:`update-status` would not report that information back to the WAPT
  inventory server.

  To do so, the command to be used is :command:`inventory`.

The command :command:`wapt-get update-status` returns:

.. code-block:: bash

  Inventory correctly sent to server https://srvwapt.mydomain.lan.

wapt-get setlocalpassword
=========================

The :command:`wapt-get setlocalpassword` command allows to define
a local password for WAPT package installations.

The command :command:`wapt-get setlocalpassword` returns:

.. code-block:: bash

  Local password:
  Confirm password:
  Local auth password set successfully

wapt-get reset-uuid
===================

The :command:`wapt-get reset-uuid` command retrieves the host :term:`UUID`
from BIOS and resends it to the WAPT inventory server.

The command :command:`wapt-get reset-uuid` returns:

.. code-block:: bash

  New UUID: B0F23D44-86CB-CEFE-A8D6-FB8E3343FE7F

wapt-get generate-uuid
======================

The :command:`wapt-get generate-uuid` command creates a new host :term:`UUID`
and resends it to the WAPT inventory server.

.. hint::

  Some batches of computers have their BIOS with identical :term:`UUID`.
  It is a BIOS manufacturer setting problem because no two :term:`UUID`
  should be the same.

  The command :command:`generate-uuid` exist to solve that problem.

The command :command:`wapt-get generate-uuid` returns:

.. code-block:: bash

  New UUID: 6640f174-de90-4b00-86f7-d7834ceb45bc

wapt-get get-server-certificate
===============================

The :command:`wapt-get get-server-certificate` command downloads the SSL
certificate from the WAPT Server to use HTTPS to communicate
with the WAPT Server.

The downloaded certificate is stored in
:file:`C:\\Program Files(x86)\\wapt\ssl\\server`.

The command :command:`wapt-get get-server-certificate` returns:

.. code-block:: bash

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

wapt-get enable-check-certificate
=================================

The :command:`wapt-get enable-check-certificate` command downloads the SSL
certificate from the WAPT Server and enables secured communication
with the server.

The command :command:`wapt-get enable-check-certificate` returns:

.. code-block:: bash

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

wapt-get session-setup
======================

The :command:`wapt-get session-setup` command launches user level customizations
of installed WAPT packages.

.. hint::

  The :command:`session-setup` instruction sets are defined in WAPT package's
  :file:`setup.py` file.

  Every instruction set is stored in a SQLite local database.

  The command :command:`session-setup` is launched at every startup,
  the user environment customization script is executed only once per user
  per package version.

.. note::

  The argument *ALL* will launch :command:`session-setup` for all installed WAPT
  packages.

The command :command:`wapt-get session-setup ALL` returns:

.. code-block:: bash

  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-rsat-x64 ... No session-setup. Done
  Configuring tis-dotnetfx4.6 ... No session-setup. Done
  Configuring tis-rsat-win7x64 ... No session-setup. Done
  Configuring tis-mumble ... No session-setup. Done
  Configuring tis-paint.net ... No session-setup. Done
  Configuring wsagauvrit.domain.lan ... No session-setup. Done

.. _wapt_cli_create_package:

**********************************************
Using the Command Line to create WAPT packages
**********************************************

wapt-get make-template
======================

The :command:`wapt-get make-template <msi or exe file> <package name>`
command allows to create a package template from a MSI or an EXE installer.

You will find the complete procedure for :ref:`creating WAPT packages
<creating_WAPT_packages>`.

.. hint::

  * If you have previously installed *tis-waptdev* package on your development
    computer, :program:`PyScripter` editor will launch automatically
    and open the package in development mode.

The command :code:`wapt-get make-template C:\\Users\\User\\Downloads\\tightvnc-2.8.5-gpl-setup-64bit.msi tis-tightvnc`
returns:

.. code-block:: bash

  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

wapt-get make-host-template
===========================

The :command:`wapt-get make-host-template <host FQDN>` command creates an empty
WAPT host package from a template.

The command :code:`wapt-get make-host-template host01.mydomain.lan` returns:

.. code-block:: bash

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

The :command:`wapt-get make-group-template <name of group>` command creates
an empty WAPT group package from a template.

The command :code:`wapt-get make-group-template accounting` returns:

.. code-block:: bash

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

wapt-get list-registry
======================

The :command:`wapt-get list-registry <keyword>` command lookups a keyword
in software installed by WAPT on the computer.

The output of :command:`list-registry` is a table listing *uninstall keys*
for each software corresponding to the search term.

The command :code:`wapt-get list-registry firefox` returns:

.. code-block:: bash

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

The :command:`wapt-get sources <package name>` command downloads sources
from a source code management platform like Git or SVN.

The command :code:`wapt-get sources tis-firefox` returns nothing;

.. _build_package:

wapt-get build-package
======================

The :command:`wapt-get build-package <path to the package>` command builds
a WAPT package and signs it with the private key of the :term:`Administrator`.

.. note::

  The path to the private key, the default prefix and the default development
  path must be properly set in the :file:`wapt-get.ini` file.

The command :code:`wapt-get sources tis-firefox` returns:

.. code-block:: bash

  Building  C:\waptdev\tis-tightvnc-wapt

  Package tis-tightvnc (=2.8.5.0-0) content:
   setup.py
   tightvnc-2.8.5-gpl-setup-64bit.msi
   WAPT\control
   WAPT\wapt.psproj
  ...done. Package filename C:\waptdev\tis-tightvnc_2.8.5.0-0_all.wapt
  Signing C:\waptdev\tis-tightvnc_2.8.5.0-0_all.wapt

  7-Zip [64] 16.04: Copyright (c) 1999-2016 Igor Pavlov: 2016-10-04

  Open archive: C:\waptdev\tis-tightvnc_2.8.5.0-0_all.wapt
  --
  Path = C:\waptdev\tis-tightvnc_2.8.5.0-0_all.wapt
  Type = zip
  Physical Size = 1756459

  Updating archive: C:\waptdev\tis-tightvnc_2.8.5.0-0_all.wapt

  Items to compress: 0

  Files read from disk: 0
  Archive size: 1755509 bytes (1715 KiB)
  Everything is Ok
  Package C:\waptdev\tis-tightvnc_2.8.5.0-0_all.wapt signed: signature:
  mOQINvKGfmcW4nu05aVc8MJqMtXdPv5I0qo5zCfMkIWvEeYYDDfnZLakPkXiqptiqcNbCdY8vOPs
  qFMqwSMYUyKJ8d3DHEk8kdlIldkLsiAejkdsoiZDKlEFVCJgdKI13x4FcPfoZNw5DFPzmCZKbgkU
  pWvGbGFwUx/3d9zcliciN82F0FveC6C0mqoh5A==

  You can upload to repository with
    C:\Program Files (x86)\wapt\wapt-get.exe upload-package "C:\waptdev\tis-tightvnc_2.8.5.0-0_all.wapt"

wapt-get sign-package
=====================

The :command:`wapt-get sign-package <path to the package>` command signs
a package with the private key of the :term:`Administrator`.

.. attention::

  :command:`sign-package` does not rename the WAPT package with the chosen
  prefix of the :term:`Organization`.

The command :code:`wapt-get sign-package C:\\waptdev\\smp-7zip_16.4.0.0-1_all.wapt`
returns:

.. code-block:: bash

  Signing C:\waptdev\smp-7zip_16.4.0.0-1_all.wapt

  7-Zip [64] 16.04: Copyright (c) 1999-2016 Igor Pavlov: 2016-10-04

  Open archive: C:\waptdev\smp-7zip_16.4.0.0-1_all.wapt
  --
  Path = C:\waptdev\smp-7zip_16.4.0.0-1_all.wapt
  Type = zip
  Physical Size = 2857855

  Updating archive: C:\waptdev\smp-7zip_16.4.0.0-1_all.wapt

  Items to compress: 0

  Files read from disk: 0
  Archive size: 2856021 bytes (2790 KiB)
  Everything is Ok
  Package C:\waptdev\smp-7zip_16.4.0.0-1_all.wapt signed: signature:
  lAxMJBKlnZLFQG81Rwb80+cB6XHcNjazmVJI7+PLLcPfFkFVC5wojyMPVMKhUrjrSlWomj85L8CY
  gZv/FsVspUij45TcikukbF8Rr+jy6saHskg42XINqZWCnP28k4bkIREdzYIkuKDABfr15gt3ecuN
  E21ZU/SI8BtXOX/80w9hpbP6ivCzTaYZZk18dhLDzV04xM9QwPSZ2mjQspbVklpm2NL4F6gb5b9D
  EwMjus74/MNc6BZeKtMcFcE3Ft18ROAJeF5hLws24jjCv6Gjjus+zlGlepWK0M2p7rIdvmC1BWB/
  Y6e1mQpSoisAvhOpATFPqNJca/QTMANKiTD3OA==

.. _wapt_cli_build_upload:

wapt-get build-upload
=====================

The :command:`wapt-get build-upload <path to the package>` command builds
and uploads a WAPT package onto the main WAPT repository.

.. hint::

  By passing the *-i* argument to :command:`build-upload`, the WAPT packaging
  version number is incremented before upload, so to avoid having to modify
  manually the :file:`control` file.

The command :code:`wapt-get -i build-upload C:\\waptdev\\tis-tightvnc-wapt`
returns:

.. code-block:: bash

  Building  C:\waptdev\tis-tightvnc-wapt
  Package tis-tightvnc (=2.8.5.0-1) content:
   setup.py
   tightvnc-2.8.5-gpl-setup-64bit.msi
   WAPT\control
   WAPT\wapt.psproj
  ...done. Package filename C:\waptdev\tis-tightvnc_2.8.5.0-1_all.wapt
  Signing C:\waptdev\tis-tightvnc_2.8.5.0-1_all.wapt

  7-Zip [64] 16.04: Copyright (c) 1999-2016 Igor Pavlov: 2016-10-04

  Open archive: C:\waptdev\tis-tightvnc_2.8.5.0-1_all.wapt
  --
  Path = C:\waptdev\tis-tightvnc_2.8.5.0-1_all.wapt
  Type = zip
  Physical Size = 1756458

  Updating archive: C:\waptdev\tis-tightvnc_2.8.5.0-1_all.wapt

  Items to compress: 0

  Files read from disk: 0
  Archive size: 1755509 bytes (1715 KiB)
  Everything is Ok
  Package C:\waptdev\tis-tightvnc_2.8.5.0-1_all.wapt signed: signature:
  FVn2yx77TwUHaDauSPHxJZiPAyMQe4PqLF5n6wY9YPAwY4ijHe6NgDFrexXf8ZYbHAiNa5b8V/Qj
  wTVHiqpbXnZotiVIGrJDhgbaLwZ9CK6pfWiflC4126nx6PMF3T1i6w0R0NOE2wJpOSRYESk7lDUz
  9CPfzJCLcOXwh0F5eZc96wbkDkSbpn1f+x5tOlvyy/FW2m8RbZQhJcO21j9gGX7It0QNecaOxXgz
  qkZZKBDNASOBYAF22M1+zHb59DWQ63Q8yMj5t5szEUTkGtQNG6vZz3gb9Yraq361BIGaBDYUM31j
  ZgpaHvP0vdK3c1x1mhyhC7q6eZ/UCW5tETTCiA==

  Uploading files...
  WAPT Server user :admin
  WAPT Server password:
  Status: OK, tis-tightvnc_2.8.5.0-1_all.wapt uploaded, 1 packages analysed

wapt-get duplicate
==================

The :command:`wapt-get duplicate <package source> <package new_duplicate>`
command duplicates a package downloaded from the repository
and opens it as a :program:`PyScripter` project.

The command :code:`wapt-get duplicate tis-firefox tis-firefox-custom` returns:

.. code-block:: bash

  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

wapt-get edit
=============

The :command:`wapt-get edit <package name>` command downloads
and edits a WAPT package.

The command :code:`wapt-get edit tis-firefox` returns:

.. code-block:: bash

  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\tis-firefox-wapt

wapt-get edit-host
==================

The :command:`wapt-get edit-host <host FQDN>` command edits a WAPT *host*
package.

wapt-get upload-package
=======================

The :command:`wapt-get upload-package <path to the package>` command uploads
a package onto the main WAPT repository.

The command :code:`wapt-get upload-package C:\\waptdev\\tis-tightvnc_2.8.5.0-1_all.wapt`
returns:

.. code-block:: bash

  WAPT Server user :admin
  WAPT Server password:
  tis-tightvnc_2.8.5.0-1_all.wapt uploaded, 1 packages analyzed
  result: OK

wapt-get update-packages
========================

The :command:`wapt-get update-packages <path to folder>` command scans
a local repository and creates the :file:`Packages` index file.

The command :code:`wapt-get update-packages D:\\Data\\WAPT` returns:

.. code-block:: bash

  Packages filename: D:\waptdev\Packages
  Processed packages:
    D:\Data\WAPT\groupe_base.wapt
    D:\Data\WAPT\tis-firefox_50.1.5.0-0_all.wapt
    D:\Data\WAPT\tis-tightvnc_2.8.5.0-1_all.wapt
    D:\Data\WAPT\tis-7zip_16.4.0.0-1_all.wapt
    D:\Data\WAPT\tis-mumble_3.14-3_all.wapt
    D:\Data\WAPT\tis-noforcereboot_1.0-1_all.wapt
  Skipped packages:

.. _re_sign_package_cmd:

Re-signing packages on the server using a command line
------------------------------------------------------

.. danger::

  Before using this method, ensure that your WAPT Server is safe
  and not under the control of an unauthorized third party entity.

* Copy your :mimetype:`.crt` and :mimetype:`.pem` to :file:`/tmp/`
  on the WAPT Server using :program:`Winscp` or an equivalent tool.

* It is then possible to re-sign all the packages at once on the WAPT Server
  with the following commands.

.. code-block:: bash

  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/

.. hint::

	Use this method if re-signing from the WAPT console method does not complete successfully.

.. attention::

  Remove your :mimetype:`.crt` and :mimetype:`.pem` from :file:`/tmp/`
  on the WAPT Server.