Hide navigation sidebar
Hide table of contents sidebar
Skip to content
Quickstart Official documentation Setuphelpers Changelog FAQ
Back to top
View this page
Toggle table of contents sidebar

# 2. Updating the WAPT Agent

## 2.1. Updating on Windows

Warning

Recommendations regarding the test environment

The recommended method to correctly test your Wapt Agent packages is to use representative sample of hosts in your inventory. So the more heterogeneous your installed base of hosts, the larger your sample should be.

This method consists of testing the installation of the Wapt Agent on as many platforms and configurations as possible, so to improve its reliability, before the Wapt Agent is transferred to production repositories.

To explain how package maturities work, you can refer to this video for a detailed overview.

For each WAPT Server’s upgrade, you will have to upgrade the WAPT Agents.

To do so, you have to generate the WAPT Agent and deploy it.

After an update, when you launch WAPT Console, you must rebuild the new agent for your new version of WAPT.

Go to the url of your waptserver and download the `WAPTSetup`.

Or download https://srvwapt.domain.lan/wapt/waptagent/waptsetup.exe, the only way in CSPN mode.

Url of your waptserver

Then, install the WAPTSetup of your workstation.

When is done, launch the console. You will see the new version of WAPT in the bottom of the authentification window.

Wapt console authentification

After the console has been opened, you will see a window for create the new agent. Press `Yes`.

Wapt Agent version check

The next window must be carefully reviewed, as it defines the baseline configuration for all your WAPT agents on Windows. Ensure that the embedded certificates and desired parameters for your entire infrastructure are correctly configured before proceeding.

wapt console renew waptagent

Note

It is recommended to start with a basic configuration for the agent and use configuration packages to define specific behaviors for different machines (distinguishing between workstation and server updates, etc.).

You have now updated your WAPT agent for Windows.

Ensure that the waptupgrade package is available on the machines or assigned to an Organizational Unit (OU) that includes them.

### 2.1.1. Manually

You can do that manually by following this documentation on installing the WAPT Agent.

### 2.1.2. Via waptupgrade

While you generate the WAPT Agent, package named `waptupgrade` is created.

This package is a standard WAPT package designed to upgrade the WAPT Agents on remote hosts.

Hint

For now, `waptupgrade` only works for Windows. Waptupgrade does not upgrade the WAPT Agent if the WAPT Server version and the WAPT Agent version are the same.

Upgrading the WAPT Agents using the `waptupgrade` package is a two step process:

- First the package copies the `waptsetup.exe` file on the client computer and creates a scheduled task that will run waptsetup.exe with predefined installation flags two minutes after the creation of the scheduled task. At that point the package itself is installed and the inventory on the WAPT Server shows the package installation as OK, with the correct version installed, but the inventory will still show the old version as the WAPT Agent is not yet updated.

- After two minutes, the scheduled task starts and runs waptsetup.exe with a predefined configuration created in the WAPT Console. This new method keeps the waptsetup.exe signed by Tranquil IT, but the WAPT Agent configuration will come from the WAPT Server. waptsetup.exe shutdowns the local WAPT service, upgrades WAPT locally, and then restarts the WAPT service. The scheduled task is then automatically removed and the WAPT Agent starts sending back its inventory to the WAPT Server. From then on, the inventory on the WAPT Server will show the new version of the WAPT Agent.

## 2.2. Updating on Linux and macOS

Warning

Recommendations regarding the test environment

The recommended method to correctly test your Wapt Agent packages is to use representative sample of hosts in your inventory. So the more heterogeneous your installed base of hosts, the larger your sample should be.

This method consists of testing the installation of the Wapt Agent on as many platforms and configurations as possible, so to improve its reliability, before the Wapt Agent is transferred to production repositories.

To explain how package maturities work, you can refer to this video for a detailed overview.

For each WAPT Server’s upgrade, you will have to upgrade the WAPT Agents.

To do so, you have to generate the WAPT Agent and deploy it.

After an update, when you launch WAPT Console, you must rebuild the new agent for your new version of WAPT.

Go to the url of your waptserver and download the `WAPTSetup`.

Url of your waptserver

Then, install the WAPTSetup of your workstation.

When is done, launch the console. You will see the new version of WAPT in the bottom of the authentification window.

Wapt console authentification

### 2.2.1. Manually on the workstation

You can install manually the Linux / macOS Agent by following this documentation on installing the WAPT Agent.

### 2.2.2. Automatically with the WAPT Console

Before proceeding, ensure that the WAPT Console has an active internet connection to perform this action.

You need to click on Tools, then Get and upload Agents installers to server.

In this window, you will see various OS types and architectures. Select the one that meets your requirements.

Update Linux and Mac Agent

Finally click on `Build_upload_waptupgrade`

Ensure that the waptupgrade package is available on the machines or assigned to an Organizational Unit (OU) that includes them.