About installing the Linux N4Supervisor

Once you have obtained the Linux N4Supervisor image, via CD or download, you will initially have a file on your machine named similar to Vykon_N4_Supervisor_for_Linux_x64-4.2.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_x64-n.n.#.zip (For example, Vykon_N4_Supervisor_for_Linux_x64-4.2.36.12.zip).

The command expands the image and produces the directory hierarchy:

dist folder
docs folder
install-data folder
javaodc folder
modules folder
overlay folder
install.sh shell script
INSTALL.txt installation instructions
README.txt README document
install_common.sh Tar archive

Please review the README.txt and INSTALL.txt 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 since 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 appears in capital letters, that is YES or NO instead of yes or no. Press Enter to accept the default, or type “y” or “n”.

Some of the more complicated questions include:

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

If you answer YES to this question, any user you provide will be added to the new group 'niagara', 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 the 'niagarad' software and Niagara 4, but it can only be controlled as 'root'.

If you want to add users later, use the command: usermod -G -a niagara UserNameYouWantToAdd

 NOTE: There are also Linux bash scripts that you can run to add and remove users: add_n4_user.sh and remove_n4_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 the Linux AXSupervisor’s !/install contents topic for description of the bash scripts. 

 NOTE: As a security precaution, only the user "niagara" may start and stop the niagarad process. The file "/etc/sudoers" can be modified to grant all users in the group "niagara" permission to start and stop the niagarad process. 

Should the installer make the necessary modifications to "/etc/sudoers"? [yes/NO]:

This is a convenience. If you choose yes, then the /etc/sudoers entry required to allow members of the group 'niagara' to execute '/usr/bin/niagaradctl' as the user 'niagara' 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. 
 NOTE: After installation is complete, you must log off of the Linux operating system and then log on again. Only then will the shortcut to launch Workbench work. 

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

bin folder
cleanDist folder
conversion folder
defaults folder
docs folder
etc folder
install folder
jre folder
lib folder
logs folder
modules folder
security folder
sw folder
uninstall folder