8. FAQ - Other Issues

8.1. How to move my repository to another partition

For any reason, you may to need move the repository to another partition.

Your repository contains 3 folders which can be quite large:

  • wapt;

  • wapt-host;

  • waptwua.

8.1.1. Linux

On Linux, create a mount point on fstab.

For this example, the second partition is named part2.

part2 is an ext4 formated partition.

8.1.1.1. Debian and derivatives

  • Create a temporary folder.

mkdir /mnt/tmp

  • Create a temporary mount point.

mount /dev/part2 /mnt/tmp

  • Move the folders.

mv /var/www /mnt/tmp

  • Unmont the partition.

umount /dev/part2

  • Edit the fstab file.

vi /etc/fstab

  • Add the following line to the fstab file.

# <file system> <mount point> <type>  <options> <dump>  <pass>
/dev/part2      /var/www      ext4    defaults  0       0

  • Mount the partition.

mount -a

Indication

If there is no error, the partition is mounted.

  • You can check by running.

df -h

#Result
Filesystem     1K-blocks     Used Available Use% Mounted on
dev/part2       15G          944M       14G   7% /var/www

  • Remove the temporary folder.

rm -rf mnt/tmp

8.1.1.2. RedHat and derivatives

  • Create a temporary folder for copying the folders.

mkdir /mnt/tmp

  • Create a temporary mount point.

mount /dev/part2 /mnt/tmp

  • Move the folders.

mv /var/www/html /mnt/tmp

  • Unmont the partition.

umount /dev/part2

  • Edit the fstab file.

vi /etc/fstab

  • Add the following line to the fstab file.

# <file system> <mount point> <type>  <options> <dump>  <pass>
/dev/part2      /var/www/html      ext4    defaults  0       0

  • Mount the partition.

mount -a

Indication

If there is no error, the partition is mounted.

  • You can check by running.

df -h

#Result
Filesystem     1K-blocks     Used Available Use% Mounted on
dev/part2       15G          944M       14G   7% /var/www

  • Remove the temporary folder.

rm -rf mnt/tmp

8.1.2. Windows

On Windows, the best method is to backup and restore the WAPT Server on the new partition.

Note

It is possible to install the WAPT Server on another partition than C:.

8.2. Using a network drive to store and deliver WAPT packages

The standard way WAPT works is with a secure web server delivering WAPT packages to the WAPT Clients.

Tranquil IT advises against using a network drive for delivering WAPT packages for several reasons:

  • A web server is extremely easy to setup, secure, maintain, backup and monitor.

  • To work correctly, a WAPT package needs to be self-contained. Indeed, we do not know if the network will be available at the time of the installation launch (for example if we have a waptexit that starts when the workstation is shutting down on a network with 802.1x user authentication, there will no longer be a network available at the time of installation). The self-contained nature of WAPT makes it more deterministic than other deployment solutions.

  • Network congestion may result from downloading large packages on large fleets of devices because you have less control over bandwidth rates or you may not be able to finish a partial download.

  • This method breaks or at least weakens the security framework of WAPT.

  • This method does not allow you to expose your repositories to Internet for your traveling personnel.

Attention

Even though WAPT can work independently of the transport mode, Tranquil IT will not officially support using a network drive to store and deliver WAPT packages.

8.3. Using the register() function in your audit scripts

The register() function forces the sending to the WAPT Server of the WAPT Agent’s hardware and software inventory.

This function is very taxing on the WAPT Server’s performance because it forces the WAPT Server to parse a relatively large JSON BLOB and to inject the result into the PostgreSQL database.

The function is by default triggered manually or when a new WAPT package upgrade is applied.

When you use the register() function in a WAPT audit script, it will run every time the audit script is triggered so it will load the WAPT Server with no apparent benefit.

Therefore, we do not recommend the use of the :code:`register()` function in audit scripts.

8.4. EWaptBadControl: “utf8” codec can not decode byte

If you get this message, it may mean that you have not set up correctly your development environment. Visit this section of the documentation on setting up UTF-8 (no BOM).

8.5. I have a lot more hosts in the WAPT Console than I have host packages on my Server?

Following a remark from Philippe LEMAIRE from the Lycée Français Alexandre Yersin in Hanoï, if you use the Enterprise version of WAPT and you make heavy use of the unit packages or profile packages, you may realize that you will have many more hosts in your WAPT Console than host packages on you WAPT sSrver. This is normal.

In fact, WAPT unit and profile packages are not explicitly assigned to the host (i.e. as dependencies in the host package) but are implicitly taken into account by the WAPT Agent dependency engine during the WAPT upgrade.

So one might have no host package on the WAPT Server if only unit packages are used for managing a fleet of devices.

8.6. I have removed the dependency but the package is still installed on my computer

If a package is installed on a workstation, removing a dependency will not uninstall the package itself. To uninstall a package from multiple workstations, you must explicitly uninstall it.

To do so, right-click on the package in the Overview tab of the WAPT console and select Uninstall.

If you need to uninstall the package from multiple workstations, you can mark it as a conflict. To do this, right-click on the Organizational Unit, go to the Conflict tab, and add the package to be uninstalled.