5. PEERCACHE by WAPT

5.1. Introduction

Peercache is a WAPT feature that allows client workstations to share WAPT packages and Windows updates within the same subnet. This reduces the load on the WAPT server and speeds up downloads for clients.

Peercache offers several significant advantages, but it also has some drawbacks to consider.

Advantages

Disadvantages

Bandwidth reduction: Packages are downloaded once from the server and shared among client workstations.

Additional open ports: Peercache requires opening UDP and TCP ports 8099, which can pose security problems if the network is not properly configured.

Faster downloads: Clients can download packages from other local workstations, which is generally faster than from the central WAPT server.

Configuration complexity: Setting up and configuring peercache can be complex and requires a good understanding of your network.

Reduced server load: The WAPT server is less solicited, improving its overall performance.

5.2. How Peercache Works


5.2.1. Basic Principle

Peercache allows client workstations to share WAPT packages and Windows updates. Here are the main steps of how it works:

Enabling Peercache: On each client workstation, peercache is enabled by having the line peercache_enable=1 in the wapt-get.ini file.

Package Retention: Packages installed on the machine are Packages installed on the machine are retained in the agent’s cache directory (C:\Program Files (x86)\wapt\private\cache). This directory contains .cache files with a checksum (md5) specific to each package.

Broadcasting Information: A port (8099) is opened to broadcast information about the packages that the machine has in its peercache.

Package Download: When a client workstation needs a package, it sends a request to its neighbors to see if any of them have the package. The default broadcast delay is 0.2 seconds. If a neighbor has the package, it downloads it from that neighbor. Otherwise, it downloads it from the WAPT server. By default, if several neighbors have the package, the client workstation will select the one with the best bandwidth.


5.2.2. Example of Operation

  • First Workstation: The first workstation retrieves the vlc package from the WAPT server and keeps it in its non-persistent cache.

  • Second Workstation: The second workstation needs the vlc package. It consults the WAPT server’s index file to get information about the package. Then, it sends a request to its neighbors and waits 0.2 seconds to see if a neighbor has the package.

  • Download: If a neighbor has the package, the second workstation downloads it from that neighbor. Otherwise, it downloads it from the WAPT server.

5.3. Setting Up Peercache

To enable peercache, there are two ways to do it: either through a configuration package or by enabling it by default on all agents.


5.3.1. Via the Agent Build:

Add peercache to all agents during the creation of the agent following a WAPT upgrade (Tools → Build WAPT Agent → Enable peercache on agent).

build agent with peercache

Build agent with peercache

Note

Enabling peercache via the agent will open port 8099 for incoming UDP and TCP traffic.


5.3.2. Via the Configuration Package:

Add peercache via a configuration package (Packages inventory → Make package template from setup file → Host agent dynamic configuration → global → Use peercache).

configuration package to enable peercache

Configuration package to enable peercache

Note

To allow peercache to function via a configuration package, it is necessary to open UDP and TCP ports 8099.

Firewall configuration is specific to each tool used in your company.


This will add the following configuration to the client workstation’s wapt-get.ini file:

[global]
peercache_enable=1

5.4. Verifying Peercache Operation

To verify that peercache is working, here is a simple method.

Prerequisites:

  • Have two workstations available on the same subnet.

  • Create a new empty WAPT package.

  • Have peercache enabled on the workstations.

Setup:

  1. Create a new empty WAPT package.

  2. Install the package on the first workstation. In the logs, you should see → downloading tis-test_peercache → (using Default).

    Using Default indicates that the package was retrieved using the default mode, which means it was downloaded from the WAPT server.

Download completed for tis-message-user(=1-6). 13.94Kb/s https://srvwapt.jarnaud.tranquil.it/wapt/tis-message-user_1-6_PROD.wapt 951f584dfca4d264ed8e3d8d9c34a1de (using Default) Debug steps:["wgsUrlFile","wgsFileName","wgsHead","wgsFromScratch","wgsNewStream","wgsAlternateBroadcast","wgsAlternateGet","wgsAlternateSuccess","wgsAlternateCopiedInCache","wgsLastMod","wgsAlternateRename"]

  1. Once the package is successfully installed on the first workstation, the package file in .cache format should appear in the agent’s directory under “C:\Program Files (x86)\waptprivate\cache\temp”.

  2. Add the package as a dependency on the second machine and install it.

  3. In the task log in the WAPT console, you should see the following: downloading tis-test_peercache → (using Peercache).

    Using Peercache means that the package was successfully retrieved via peercache.

Download completed for tis-message-user(=1-6). 13.94Kb/s https://srvwapt.jarnaud.tranquil.it/wapt/tis-message-user_1-6_PROD.wapt 951f584dfca4d264ed8e3d8d9c34a1de (using Peercache) Debug steps:["wgsUrlFile","wgsFileName","wgsHead","wgsFromScratch","wgsNewStream","wgsAlternateBroadcast","wgsAlternateGet","wgsAlternateSuccess","wgsAlternateCopiedInCache","wgsLastMod","wgsAlternateRename"]