GUI Node Installation
Overall Installation Steps
The high-level steps for installing and configuring the N2VS administrative GUI are:
- Determine the server(s) that will supply the GUI logical component, bearing in mind the supported operating systems and minimum server requirements.
- Ensure the installation pre-requisites are met.
- Install the GUI package.
- Perform any required post-installation steps.
- Update the administrative GUI configuration as desired.
- Apply the recommended Apache security configuration.
Installation Pre-requisites
OS-specific Setup
Refer to the specific Red Hat or Debian instructions for any pre-requisites as required.
Apache 2
Apache 2 must be installed prior to installing the N2VS GUI package. The package to install will depend on your OS type:
| RHEL 8 / 9 | Other RPM-based Systems | DEB-based Systems |
|---|---|---|
sudo dnf install httpd |
sudo yum install httpd |
sudo apt-get install apache2 |
The N2VS GUI package expects that the relevant Apache 2 configuration directory exists. Again, this varies depending on your OS type:
| RPM-based Systems | DEB-based Systems |
|---|---|
/etc/httpd |
/etc/apache2 |
Finally, the apachectl program must exist (it is installed as part of the Apache 2 package) and Apache must be
running.
Installation Steps
Follow the appropriate installation steps depending on your installation sources.
From N-Squared Repository
Execute the instructions specific to your operating system:
| RHEL 8 / 9 | Other RPM-based Systems | DEB-based Systems |
|---|---|---|
sudo dnf install n2vs-gui |
sudo yum install n2vs-gui |
sudo apt-get install n2vs-gui |
As Manual Installation
Transfer the provided package file to the target node, then follow the instructions specific to your operating system.
Execute (adjusting as appropriate for package location and version details) the following:
| RPM-based Systems | DEB-based Systems |
|---|---|
sudo rpm -Uvh /path/to/n2vs-gui-M.m.p-b.noarch.rpm |
sudo dpkg -i /path/to/n2vs-gui_M.m.p-b_all.deb |
Post-Installation Steps
Default Application
After installation, there is no default behaviour for Apache to automatically navigate to the N2VS GUI when a site root request is received.
To set the N2VS GUI as the default application, edit the appropriate file for your OS type:
| RPM-based Systems | DEB-based Systems |
|---|---|
/etc/httpd/conf.d/n2vs-gui.conf |
/etc/apache2/conf-available/n2vs-gui.conf |
Add the following line to the top of the file:
RedirectMatch ^/$ /n2vs
Restart Apache to apply the change:
systemctl enable httpd
apachectl restart
Firewall
The firewall (if any) on the GUI node must be updated to allow:
- Inbound user requests on the listening Apache port(s).
The exact commands to do this will depend both on the firewall on your platform and also which port(s) are in use. For
example, to allow the default Apache ports when using firewalld, the commands might be:
firewall-cmd --zone=public --add-port=80/tcp --permanent
firewall-cmd --zone=public --add-port=443/tcp --permanent
service firewalld restart