About installing the Linux AxSupervisor

Once you have obtained the Linux AxSupervisor image, via CD or download, you will initially have a file on your machine named similar to Vykon_AX_Supervisor_for_Linux_x86-3.8.n.zip.

You can expand this file to examine its contents. To do that, change to the parent directory and enter the following command:
root@<host>:/home/<user># unzip <vendor>_<release version>
_Supervisor_for_Linux_x86-n.n.#.zip
(For example, Vykon_AX_Supervisor_for_Linux_x86-3.8.108.zip).

The command expands the image and produces the directory hierarchy:

dist

folder

docs

folder

install-data

folder

lexicon

folder

modules

folder

overlay

folder

install.sh

shell script

INSTALL

installation instructions

README

README document

setup-linux-x86.tgz

Tar archive

 

NOTE: If attempting to install the 32-bit Linux AxSupervisor on a 64-bit system, please take steps to install the necessary compatibility libraries prior to installing this software. For Red Hat Enterprise Linux 5 and 6/CentOS platforms these libraries are:
  • glibc.i686
  • libstdc++.i686:
  • compat-libstdc++-296.i686
  • compat-libstdc++-33.i686
  • zlib.i686
  • redhat-lsb.i686
If you experience further problems once these libraries are installed, use the "export LD_DEBUG=libs" command to determine which additional libraries may be required for your distribution.
 

Please review the README and INSTALL files. When you are ready to begin the installation process, type the following at the command prompt:

root@<host>:/home/<user># sudo bash install.sh
 

NOTE: You must type "sudo bash install.sh" in order to run the installer because elevated permissions are required to perform some operations during the installation,
 

This script steps you through the installation process by asking a series of yes/no questions, where the default choice (press ENTER) appears in capital letters, that is YES or NO instead of yes or no.

 

NOTE: When entering an answer, be sure to type the whole word, "yes" or "no," instead of just "y" or "n".
 

Some of the more complicated questions include:

Would you like to configure which users can use NiagaraAX [YES/no]:

If you answer YES to this question, any user you provide will be added to the new group 'niagarad', have permissions to start/stop/query the platform service, and have Desktop and Menu Icons installed to their home directory. If you choose not to configure any users, you'll still be able to run 'niagarad' and NiagaraAX, but it can only be controlled as 'root'.

If you want to add users later, use the command:

usermod -G -a niagarad 
UserNameYouWantToAdd
 

NOTE: There are also Linux bash scripts that you can run to add and remove users: add_ax_user.sh and remove_ax_user.sh. These are found in /opt/Niagara/Niagara-<version>/install. These scripts need to be executed with elevated permissions using sudo. For more details, see Linux AxSupervisor !/install contents for description of the bash scripts.
 

Should NiagaraAX users be allowed to accomplish certain root privileged tasks? 
This is limited to setting system time, date, timezone, reboot, TCP/IP and NTP settings [yes/NO]:

This is a very important question, as is it only asked once, and can not be re-configured after the installation completes (unless you uninstall, then install again). If you answer yes to this question, then a setuid binary called 'ndsupport' will be installed in ${NIAGARA_HOME}/bin.

Through this binary the wb, station or niagara daemon will obtain root privileges and perform the desired operation. If you choose not to install this executable, or if you delete it for some reason after you have installed it, then you will not be able to set or execute any of the listed operations through 'niagarad', 'wb', or 'station'.

Should NiagaraAX add necessary "/etc/sudoers" information for the group niagarad? [yes/NO]:

This is a convenience. If you choose yes, then the /etc/sudoers entry required to allow members of the group 'niagarad' to execute '/usr/bin/niagaradctl' as the user 'niagarad' is automatically generated and added to the file ‘/etc/sudoers’. If you choose no, then the necessary entry will still be generated and logged, you will just need to manually modify the ‘/etc/sudoers’ file through vim or visudo.

The remainder of the questions asked by the installer should not require explanation. The installer will ask you to review your choices and then it copies files. If the installer fails at any step, please send an email to Tridium support that specifies your Linux distribution, version, and the install.log file.

 

CAUTION: Important information is included at the end of the installation script. Please take the time to read this information and complete any additional steps it may ask you to do.
 

Once you have installed NiagaraAX, the default installation directory is /opt/Niagara/Niagara-3.8.n/. Note, that you can select a different directory during installation. The following contents are in the installation directory:

bin

folder

certificates

folder

docs

folder

install

folder

install-data

folder

jre

folder

lexicon

folder

lib

folder

modules

folder

security

folder

stations

folder

sw

folder

uninstall

folder

workbench

folder

install.log

application.log