Install the adapter

You can install adapters on either a Windows or Linux operating system. Before installing the adapter, see the respective system requirements to ensure your machine is properly configured to provide optimum adapter operation.

Windows

Complete the following steps to install an adapter on a Windows computer:

1. Download the appropriate Windows distribution file from the AVEVA Customer Portal.

   Note: Customer login credentials are required to access the portal.

2. Run the installer and follow the setup wizard.

   You can change the installation folder or port number during setup. The default port number is 5590.

3. Optional: To verify the installation, use the following curl command with the port number that you specified during installation:

   curl http://localhost:<portnumber>/api/v1/configuration

   If you receive an error, wait a few seconds and try the script again. If the installation was successful, a JSON copy of the default system configuration is returned.

Linux

Before you install the adapter on a Linux operation system, please note that BACnet protocol uses UDP/IP socket communication. As a result, Linux places restrictive limits (212992 bytes) on the size of receive buffers of sockets. This restriction limits the performance of the adapter on Linux.

To check your current buffer settings and avoid performance issues:

4. Check the current UDP/IP receive buffer settings using the following commands:

   $ sysctl net.core.rmem_max

   net.core.rmem_max = 212992

   $ sysctl net.core.rmem_default

   net.core.rmem_default = 212992

   • If the values are higher than 26214400 bytes (25MB), install the adapter.

   • If the values are less than 26214400 bytes (25MB), add the following two lines to the /etc/sysctl.conf file:

     net.core.rmem_max=26214400

     net.core.rmem_default=26214400

5. Save the file, reboot the machine and then proceed with installing the adapter.

To install the adapter on a Linux computer:

Download the Linux distribution file from the AVEVA Customer Portal.

Note: Customer login credentials are required to access the portal.

6. Open a terminal.

7. Run the sudo apt update command to update available packages information.

8. Run the sudo apt install command against the Linux distribution file.

   For example: sudo apt install ./AVEVA-Adapter-for-BACnet-1.2.0.158-x64_.deb

9. Optional: To verify the installation, use the following curl command with the port number that you specified during installation:

   curl http://localhost:<portnumber>/api/v1/configuration

   If you receive an error, wait a few seconds and try the script again. If the installation was successful, a JSON copy of the default system configuration is returned.