Troubleshooting

Tips for troubleshooting issues that you may encounter when installing or running a Linux AxSupervisor:
  • error while loading shared libraries

    This error can happen with any of shared libraries in NiagaraAX: libnre.so, libplatform.so, or libjvm.so. Although these libraries are probably installed on your machine, the shared library loader cannot locate them. This mostly likely means you have not sourced the script '.niagara'.

    As user root, from your installation’s /bin directory, type the following:
    root@<host>:/opt/Niagara/Niagara-3.8.n/bin# . ./.niagara

    Then try whatever command you used to produce this error again (wb, nre, niagarad, station).

  • java.net.BindException

    This error can happen when starting a station. In the Linux OS, ports 1-1024 are “root ports,” meaning only an application running with root privileges may bind to them. Since 'station' is running as the user 'niagarad' (who does not have root privileges), it cannot bind to port 80. If you have not configured your station to start on a port above 1024, you will see this error.

    To fix this error, configure your station to start its WebService bound to port 8080, or another port above 1024.

  • [workbench.auth] Cannot save credentials list

    This error can happen while connecting to the local platform daemon from Workbench. In the Linux OS, an item owned by root:root usually can not be modified by any users other than root itself. If root owns the users directory, or if the permission of the users directory has been modified somehow to something other than 0775, new user credentials cannot be created.

    To fix this error, as user root from your installation’s directory, enter these commands:

    root@<host>:/opt/Niagara/Niagara-3.8.n# chown -R niagarad:niagarad users
    root@<host>:/opt/Niagara/Niagara-3.8.n# chmod 0775 users

    In errors involving not being able to write or create something associated with a file, always try modifying a file, or directory, so that it is owned by niagarad:niagarad, as this is most likely the cause of the error.