Linux AxSupervisor installation example

Following the inital software setup of the Dell workstation (see previous section Initial Dell workstation setup example), the following steps were taken to perform a “fresh install” of the “AX Supervisor for Linux”, build 3.4.42. These steps were recorded on September 30, 2008:

Downloaded the zipped image of build 3.4.n (3.4.42 as of September 30, 2008), saving it to the main desktop.
Created a folder on the main desktop named “builds”, with a subfolder named “3.4.42”.
Double clicked on the zip archive from the desktop to launch the extraction utility. Specified the “3.4.42” subfolder as the destination for extraction.
Following extraction, the “3.4.42” folder should contain the standard directory hierarchy for NiagaraAX.
Launched a new terminal session. The default prompt is the “tridium” user created during the original Red Hat installation.
Changed to the root user using the “su” command. Entered “niagara” when prompted for the password. The prompt switches to root.
Changed to the "3.4.42" directory created in Step 3 using command:
```
cd /home/tridium/Desktop/builds/3.4.42
```
Ran the install.sh script by issuing command
```
bash install.sh
```
Pressed Enter when prompted to continue by the script. Pressed “Q” to skip viewing the license agreement.
Typed “yes” followed by ENTER to accept the license agreement.
Pressed ENTER to accept the default absolute path for Niagara AX 3.4.42.
Pressed ENTER again to accept the prompt to create the directory, since it did not exist.
Pressed ENTER to accept the prompt to configure a new user.
Entered “tridium” as the username string when prompted by ENTER.
Typed “no” followed by ENTER to skip adding another user.
Typed “yes” followed by ENTER when prompted about whether users should be allowed to accomplish root privileged tasks.
Typed “yes” followed by ENTER when prompted to add niagarad to the /etc/sudoers file.
Typed “yes” for the prompts to install GNOME desktop and menu shortcuts.
Pressed ENTER when prompted to install lexicon files.
Pressed ENTER when prompted to install documentation.
Pressed ENTER when prompted to install as installation tool.
Verified the installation settings summary displayed, and pressed ENTER to accept and continue.
A warning message prompting the configured user to logout and log back in to workstation is displayed in blue.
At this stage of the installation, you must either:
- Close the terminal session, and log out and log back in, or
- Reboot the workstation
Prior to launching NiagaraAX (from the console or from desktop shortcuts). Otherwise, you will likely have permission denial errors.
Verified the creation of desktop and menu shortcuts.
Exited the console.
Logged out of the workstation and logged back in (using credentials tridium/niagara).
The niagara daemon does not start up automatically when a user logs out and back in. It does however start up automatically when the workstation is rebooted. To start niagarad without rebooting:
- Double-click the Niagara AX 3.4.xx Console icon to launch the NiagaraAX console.
- Type “niagaradctl status” for the current status of the niagara daemon.
  
  It should say “niagarad is stopped”.
- Type “niagaradctl start”
  
  The daemon starts up with an OK status.
- Now if you type “niagaradctl status”, it should say “niagarad (pid xxxx) is running...”
Workbench can now be launched in a number of ways:
- From either of the Workbench icons on the desktop, or from the Applications Menu (the suggested way).
- Running “wb” from the console.
Testing confirmed that all methods successfully launched Workbench, and could successfully open a connection to the local platform.