Troubleshooting Linux installation

This section describes common Linux installation issues and provides guidance for resolving configuration, installation path, and port assignment problems.

New installation settings are not applied during reinstallation

Issue

When you reinstall with a new port or path using debconf-set-selections, if /var/lib/AVEVA data still exists from a previous installation, the postinst script enters upgrade mode and restores the old configuration from the previous appsettings.json. This completely overrides your new settings.

Solution

To reinstall the package with a different port or installation path, you must remove the previous installation data first.

This occurs because the installer's post-installation script detects upgrade scenarios and preserves the previous configuration to prevent accidental port or path changes. A complete data purge resets this detection, allowing your new debconf-seeded values to take effect

Procedure

1. Stop the running service:

   bash sudo systemctl stop aveva.adapter.config.utility 2>/dev/null || true

2. Remove the package:

   bash sudo apt purge aveva.adapter.config.utility -y sudo apt autoremove -y

3. Remove previous configuration and data directories:

   bash sudo rm -rf /var/lib/AVEVA sudo rm -rf /opt/AVEVA

   Note: This step must be completed. Without this step, the old port and path settings are restored during reinstall.

4. Define your new values:

   bash echo 'aveva.adapter.config.utility aveva.adapter.config.utility/port string 9999'
   sudo debconf-set-selections echo 'aveva.adapter.config.utility aveva.adapter.config.utility/install-dir string /opt/acu'
   sudo debconf-set-selections

5. Complete a fresh install:

   bash sudo apt install -q -y ./AVEVA-Adapter-Configuration-Utility-1.0.0-arm64_.deb < /dev/null