Installation

This section describes the basic requirements, dependencies, and steps to install the OmniVista Network Advisor application.

• System Requirements

• Application Installation

• Package Installation Procedure

• Updating the Previous Installed Package

• Configure OmniVista Network Advisor

System Requirements

The following are the suggested minimum requirements for installing and running the OmniVista Network Advisor application.

• Internet access is mandatory.

• Processor: Quad-core. The CPU must support Advanced Vector Extensions (AVX).

• RAM: 8 GB

• HDD: Up to 200 devices, 50 GB (To allow for storage of syslog messages)

  • For 1,000 devices, 120GB storage is recommended

  • For 2,000 devices, 210GB storage is recommended

• Linux OS:

  • Ubuntu 22.04 Server Edition

  • Debian 11, Debian 12

  • Red Hat Enterprise Linux 9.3

• For installation on RHEL, ensure that firewalld is turned off.

-> sudo systemctl stop firewalld

-> sudo systemctl disable firewalld

• The minimum requirements for OmniVista Network Advisor support on OmniVista are OmniVista 2500 4.8R2/ OmniVista Cirrus 4.8.2 and above.

• When using OmniVista with Microsoft Teams notification system, ensure that smba.trafficmanager is turned off.

-> sudo systemctl stop samba-trafficmanager

-> sudo systemctl disable samba-trafficmanager

• Ports: TCP 80/443 (HTTP/S for WebUI), UDP/TCP 10514/TCP 6514 (syslog/syslog-TLS), TCP 22 (SSH/SFTP Application to devices or access to Application), TCP 443 (Setup Installation and Cloud Services)

By default, Kubernetes uses the following IP address ranges for its various components:

Please ensure that these address ranges do not conflict with any existing networks or services in your environment, as this may cause connectivity issues with your Kubernetes cluster.

Note: If upgrading from OmniVista Network Advisor 1.2 or 1.3 please refer to Appendix C - Migration to OmniVista Network Advisor 1.4 Version prior to installing OmniVista Network Advisor 1.3.

Application Installation

The application can be downloaded from the following location:

• From ALE MyPortal -> Network Products -> Network Management -> OmniVista Network Advisor

Configure User Management for Linux Host

Under root account type the following (user account requirements may differ based on installed platform):

$ usermod -aG sudo <username>

Check that the user has sudo rights by logging in to the user session and typing sudo -v.

Package Installation Procedure

Step 1: Transfer the Application Archive

Use SFTP to transfer the application archive (ale-ovna.deb) to the Linux host.

Step 2: Extract the Package

Run the following commands to extract the package:

$ sudo dpkg -i ale-ovna.deb

Step 3: Install the Package

Run the following commands to install the package:

sudo ale-ovna install

For example:

During the installation, follow the prompts to configure IP addresses, proxy settings, and TLS for syslog support, if desired. For detailed guidance, refer to Appendix A.

You can use the command sudo ale-ovna --help to view help on OmniVista Network Advisor commands. For Example:

Updating the Previous Installed Package

To update the package, use the following commands:

-> sudo ale-ovna update

For example:

• The command will first check if a .deb has to be updated.

  • `if yes, the new .Deb is downloaded after which command will exit saying that a new .Deb has been installed and invite the user to relaunch "ale-ovna update" to update the software using the last ale-ovna

  • if no , software update is performed normally.

Good Practices for Upgrading Preview and Production Environments

• Back Up Before Upgrade: Always create a snapshot of the VM or back up OVNA before upgrading. This ensures you can restore the system if needed.

• Upgrade Preview First: Test new updates in the PREVIEW environment before applying them to PROD. This allows you to identify any potential issues in a controlled setting.

• Version Compatibility: Only upgrade from PREVIEW to PROD if the PROD version is newer than the PREVIEW version. Ensure compatibility to prevent unexpected issues.

• No Downgrade Option: Downgrading is unsupported. If a rollback is required, uninstall and reinstall OVNA, then restore from a backup.

Following these practices can help ensure smooth and reliable upgrades in both PREVIEW and PROD environments.

Configure OmniVista Network Advisor

After the installation is complete, configure OmniVista Network Advisor as needed.