OmniVista Cirrus 10.6.1 Documentation
OmniVista Cirrus 10.6.1 Documentation
Breadcrumbs

Installing Advisor Edge

An Advisor Edge installation on a supported Linux host is required to use the OmniVista Advisor Edge application. This section consolidates installation details needed to prepare or maintain an Advisor Edge deployment.

Installation Requirements

  • Internet access is required.

  • Minimum host profile: quad-core CPU with AVX support, 8 GB RAM.

  • Storage planning: 50 GB (up to 200 devices), 120 GB (about 1,000 devices), 210 GB (about 2,000 devices).

  • Supported Linux distributions: Ubuntu 22.04 Server Edition, Debian 11, Debian 12, Red Hat Enterprise Linux 9.3.

  • For RHEL installations, stop and disable firewalld before installation.

  • Confirm OmniVista compatibility: OmniVista Cirrus 10.6.1 or later.

  • Ports: UDP/TCP 10514/TCP 6514 (syslog/syslog-TLS), TCP 22 (SSH/SFTP Application to devices or access to Application), TCP 443 (Cloud Services).

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

Component

Default IP Range

Pods

10.42.0.0/16 for IPv4 and IPv6

Services

10.43.0.0/16 for IPv4 and IPv6

CoreDNS

10.43.0.10 for IPv4

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.

Installation Procedure

  1. Download the ale-ovna.deb package from ALE MyPortal under Network Products > Network Management > OmniVista Network Advisor.

  2. Transfer the package to the Linux host through SFTP.

  3. Install the package: sudo dpkg -i ale-ovna.deb.

  4. Start the installation workflow: sudo ale-ovna install.

  5. Complete the installation options prompts:

    • Please select which IP address Network Advisor should use (example: 172.25.159.109)

    • Are you using a proxy? No (default) / Yes

    • Do you want to use the default K3s pod/service subnets? (Pod: 10.42.0.0/16, Service: 10.43.0.0/16) Yes (default) / No, I want to specify

    • Do you want to use syslog over TLS? No (default) / Yes

    • Do you want to use OmniVista Cirrus/Terra as your management platform for Network Advisor? Yes

  6. Select your OmniVista management platform when prompted:

    • Use the arrow keys to navigate: ↓ ↑ → ←

    • Select your OmniVista management platform:

      • OmniVista Cirrus

      • OmniVista Terra

  7. At the end of installation, use the identifiers printed by the installer to declare the instance in OmniVista:

    • APP_UUID (example: 11111111-2222-4333-8444-555555555555)

    • SERIAL_NUMBER (example: ABCDE12345F6789)

  8. Complete the Advisor Edge configuration in OmniVista Cirrus.

Command Reference

  • Add sudo rights for the installation user (Linux host preparation): usermod -aG sudo

  • Verify sudo access for the user session: sudo -v

  • Install package file: sudo dpkg -i ale-ovna.deb

  • Run installation workflow: sudo ale-ovna install

  • Display comprehensive installation status, versions, and configuration: sudo ale-ovna status

  • Display OVNA instance identifiers only (including Application UUID and Serial Number): sudo ale-ovna id

  • Show available Advisor Edge commands: sudo ale-ovna --help

  • Show help for a specific command: sudo ale-ovna [command] --help

  • Run a full installation health and connectivity check: sudo ale-ovna sanitycheck

  • Perform health checks with the global healthcheck flag (connectivity, resources, prerequisites): sudo ale-ovna --healthcheck

  • Collect diagnostic logs and system information into an archive: sudo ale-ovna collect

  • Restart OVNA components to apply changes or recover from errors: sudo ale-ovna rollout

  • Configure OVNA settings and parameters: sudo ale-ovna configure

  • Manage SSL/TLS certificates: sudo ale-ovna configure certs

  • Run software update: sudo ale-ovna update

  • Run update with core package refresh (required for some upgrade paths, such as 1.4 to 1.5): sudo ale-ovna update -c

  • Force download and update of the latest watchdogs: sudo ale-ovna watchdog

  • Display CLI version information without requiring K3s to be running: sudo ale-ovna --version

  • Completely remove OVNA from the system: sudo ale-ovna uninstall

Host Service Commands Used In Installation Prerequisites

  • Stop RHEL firewall service before installation (when applicable): sudo systemctl stop firewalld

  • Disable RHEL firewall service before installation (when applicable): sudo systemctl disable firewalld

  • Stop Microsoft Teams traffic manager service when required by your OmniVista integration context: sudo systemctl stop samba-trafficmanager

  • Disable Microsoft Teams traffic manager service when required by your OmniVista integration context: sudo systemctl disable samba-trafficmanager