Linux installation

You can install the AVEVA™ Adapter Configuration Utility on a Linux device by using a terminal window or by performing a silent install.

Install on a Linux device using a terminal window

1. Open a terminal window and change the working directory to the location of the distribution file.

2. Run the apt install command for the distribution file appropriate to your operating system and processor.

   Debian 13 or later (Intel/AMD 64-bit processors)

   sudo apt install ./AVEVA-Adapter-Configuration-Utility-1.0.0-x64_.deb

   Debian 13 or later (Ubuntu ARM64 Server)

   sudo apt install ./AVEVA-Adapter-Configuration-Utility-1.0.0-arm64_.deb

   A validation check for prerequisites is performed.

3. (Optional) Change the port number and press Enter. The default port is 5800.

   Note: If you specify an invalid value for the port, the install proceeds with the default value of 5800.

Silent Install with Custom Port and Installation Directory

To install silently with custom port and path, use Debian's debconf-set-selections system to pre-seed your desired values before running apt install:

4. Define the custom port ahead of time (for example, 9999).

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

5. Specify your custom installation directory, for example: /opt/acu:

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

6. Install silently

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

Note: Do not create a silent.ini file - the installer does not read from it. Use debconf-set-selections exclusively.

See Troubleshooting to review additional issues with installing the ACU using Linux.

Custom installation directory structure

When you specify a custom installation directory using debconf-set-selections, the application files are installed to the specified location and a compatibility symlink is created in the default installation directory.

The package creates the following structure:

• Actual files are installed to your custom path.

• Symlink is created at the default location

• Systemd service is updated to reference your custom path directly

For example, if the installation directory is /opt/acu/:

/opt/acu

├── adapter.config.utility

├── appsettings.json

├── libraries

└── ...

/opt/AVEVA/aveva.adapter.config.utility -> /opt/acu

The symlink allows existing tools and scripts that reference the default installation location to continue working without modification. You can reference either path in scripts, both work identically.