2. Updating the WAPT Agent¶

2.1. Updating on Windows¶

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.

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.

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

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.

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¶

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.

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.

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.

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.