Pre-Requisite:

• A Windows machine/VM with the below minimum requirement:

  • 2 vCores (available for FlowVision VM)

  • 8 GB RAM

  • 40 GB HDD

• Download Oracle VM virtual box from the below link

• Install Oracle VM Virtual box

Importing OVA:

• Import the OVA file in Oracle VM virtual box

• Click the start button to power-on the virtual machine

• Log in to the FlowVision VM with default credentials

  • Username: aviz

  • Password: Aviz@123

• Get the IP address of the VM through ip address show

• Access the GUI through the above IP using your favourite browser with http port: 8093

  • https://<VM_IP>:8093/

• Login to the GUI with the default credentials

  • Username: admin

  • Password: admin

Pre-Requisite:

• An ESXi Host with the below minimum requirement available for FlowVision:

  • 2 vCores

  • 4 GB RAM

  • 20 GB HDD

Deploying OVA:

• Log in to the ESXi Host and click on 'Create/Register VM'

• Click on 'Deploy a virtual machine from an OVF or OVA file'

• Name the VM and select the downloaded 'OVA' file

• Choose the 'datastore' where you want to install the VM

• Select the 'VM-Network' to ensure that the VM is reachable

• Review the configuration and click on 'FINISH'

• Wait for the OVA file to upload; Check the status in 'Recent tasks' at the bottom of the screen

• 'Power on' the VM

• Login to the VM with default credentials

  • User: aviz

  • Password: Aviz@123

• Check DHCP assigned IP on the VM with 'ip a'

• Login to the Web-GUI at https://<VM-IP>/ with default credentials

  • User: admin

  • Password: admin

To configure the ports of the connected devices from the FlowVision GUI, click Configuration > Ports.

The Ports page shows the connected devices, the ports of each of those connected devices, and a table displaying the details of the ports, such as, the admin status, link status, speed, ingress VLAN, egress tagging, truncation, mode, and the tranceiver details. Note that, the ports that have their link status as 'UP' are shown in green, whereas the ones with the link ststus as 'DOWN' are shown in red. You can hover the mouse pointer over the devices icon or ports icon for more information on that device or port.

By default, when you select a device in the Devices section, the ports table shows you the details of all the ports of the selected device. If you want to get the details of particular ports, click the port number in the Ports section. You can also edit the properties of ports from the ports table.

The following image shows the ports page with device, ports, and port status details:

Editing Port Properties

To edit the properties of a port,

1. Click the Edit button against the required port in the ports table. The Port Properties window displays.

1. Update the properties as required. The properties you can update are - Description, MTU, Speed, Admin Status, Ingress VLAN, Egress Tagging, Truncate, Mode, Fec , Port Type, Loopback Mode, Auto Neg, LLDP, sFlow and Switch Port Vlan. You can also see other non-changeable fields with more information about the selected port.

2. Click Save Changes

To view and configure rule templates from the FlowVision GUI, click Configuration > Rule Templates.

The Rule Templates page shows the total number of existing rule templates and a table showing the details of each of these rule templates, such as the name of the template, the action performed, the override action and also an option to edit or delete a rule template.

The following image shows the Rule Templates page:

Creating New Rule Templates

To create a new rule template,

1. Click the icon at the top right corner of the Rule Templates page. The Rule Template window displays.
2. Specify values for the following:

   • Name

Editing and Deleting Rule Templates

• To edit an existing rule template, click the icon and make your changes in the Rule Template window.

• To delete a rule template, click the icon.

To view the audit logs from the FlowVision GUI, click System > Audit Logs.

The audit logs table gives you the details of all the actions performed on the connected systems. The details include the action performed, the date, the IP address of the system, the resource used, the username of the operator that performed the action, and the status of the action.

The following image shows the audit logs table:

To create and configure flows from the FlowVision GUI, click Configuration > Flow Manager.

The Flow Manager page shows the number of existing flows and a table showing the flow details, such as device ID, alias, description of the flow, status, the available counters, the action performed, and an option to edit and delete flows.

The following image shows the Flow Manager page:

Creating New Flows

To create a new flow, click the button on the top right corner of the Flow Manager page. The Add Flow page displays.

Specify the Flow Name, Description for the Flow, and select the Action.

Adding Source Ports

To add source ports

1. Click the Network Ports button on the Add Flow page. The Add From Ports window will appear as below
2. Select a device to list all the ports available for that device.

3. Select the ports you need to add as source ports.

To add source ports as Vxlan Tunnel for Vxlan Decapsulation

To configure a VXLAN tunnel as a source port for VXLAN Decap:

1. Set the Flow Type to VXLAN Decap as shown below.

1. Click Network Ports button on the Add Flow page.

   1. The Add From Ports window will appear.

1. Select a device to list the available Vxlan tunnel for that device.

2. Choose the VXLAN tunnel you want to add as a source port.

3. Click Add to add the tunnel to the list of source ports.

Adding Rules

To add rules,

1. Click the Rules button on the Add Flow page. The Add Rule window displays with GTP disable.

The Add Rule window displays with GTP enable.

1. Specify values for the following, in the Rule tab:

   • Rule ID - specify a name for the new rule.

   • Description - enter a description of the new rule to show its purpose.

The added rules are displayed in the table below the Rules button on the Flow Manager page.

Adding Destination Ports

To add destination ports,

1. Click the Tool Ports button on the Add Flow page.

   1. The Add To Ports window displays.
2. Select a device to list all the ports available for that device.

To add destination ports as Vxlan Tunnel

To configure a VXLAN tunnel as a destination port:

1. Set the Flow Type to VXLAN Encap.

1. Click Tool Ports button on the Add Flow page.

   1. The Add To Ports window will appear.

1. Select a device to list the available Vxlan tunnel for that device.

2. Choose the VXLAN tunnel you want to add as a destination port.

3. Click Add to include the selected tunnel in the destination ports list.

After adding the source ports, destination ports, and rules, click Create Flow on the Add Flow page. This action creates a new flow.

Editing and Deleting the existing Flow

To edit an existing flow, click the icon and make your changes in the flow page. Once the modification is done, click the update button

To delete the existing flow, click the icon.

The Help page takes you to the REST API documentation. To get to the REST API from the FlowVision GUI, click Help > REST API.

This action takes you to the Swagger UI page with the FlowVision REST API.

To perform backup and restore from the FlowVision GUI, click System > Backup/Restore.

The Backups page shows the available backup files of the system. The details include the backup filename, the date of backup creation, the status of the backup and the option to delete a specific backup file.

The following image shows the Backups page:

Creating a New Backup

To create a new backup, click the Create Backup drop-down menu and select Create Backup.This action creates a new backup file and its status is displayed in the Backups table.

You can also have the option to selectively backup the database or the FlowVision system. To perform this selective backup,

1. Click Create Backup > Create Backup (Advanced). The New Backup window displays.

2. Select the backup you want to create. The available options are - Backup DB and Backup FlowVision. This is a multi-select option where you can choose either or both.

3. Click Backup to create the selected backup.

Upgrading FlowVision

You can upgrade the FlowVision system if required. To upgrade,

1. Click Upgrade System on the top right corner of the Backups page. The Upgrade System window displays.

2. Select the Upgrade FlowVision checkbox.

3. Click Upgrade to upgrade the system.

Deleting a Backup

To delete a specific backup file, click the icon against the corresponding backup file in the Backups table. Confirm the delete action in the Confirm Delete prompt.

Introduction

This guide provides you with information on how to use the FlowVision graphical user interface to manage devices.

The FlowVision GUI has the following menu options at the top level:

The following image shows the home page of the Aviz FlowVision GUI:

To manage users from the FlowVision GUI, click System > User Management.

The User Management page shows the details of all the users of the system and their user previleges and roles. From the User Management page, you can add new users, edit user roles and permissions, de-activate a user, and delete a user.

The following image shows the User Management page:

Adding a New User

To add a new user,

1. Click the ADD button on the header of the user management table at the top. The New User window displays.

2. Specify the Email address, Username, Password, and Role of the new user in their respective fields. The Role drop-down field has two options - Admin and Viewer. The Admin role has full access and the Viewer role has read-only access.

Editing Existing Users

To edit an existing user,

1. Click the Edit button against the user in the User Management table. The Edit User window displays.

2. Edit the required details in the Email, Username, Password, and Role fields.

3. Click Update User to update the user details.

De-Activating or Deleting Users

In the User Management table,

• Click the De-Activate button to deactivate a user.

• Click the Delete button to delete a user.

The Dashboard is the default home page of the FlowVision GUI. To return to the dashboard view from any other page, click System > Dashboard.

The Dashboard shows you the following data:

APB Fabric Information

This pie chart shows you the device information based on HwSKU and the device OS. You can hover the mouse pointer over the charts to display a tooltip with more relevant information.

The following image shows the APB fabric information charts:

Platform Health

The platform health table shows you the CPU usage, memory availability, and link status for each connected devices. From this data you can infer the overall health of the platform.

The following image shows the platform health table:

Link Information

The link information table shows you the total number of ports from all the connected devices, the number of ports that are enabled with admin privileges, and the number of ports that are connected at any given moment.

The following image shows the link information table:

Top 5 Ports by Traffic

The top 5 ports by traffic shows you the top 5 ports across all connected devices sorted on the basis of their traffic rate. The table shows you the device, port number, the number of In Ucast packets, the number of Out Ucast packets, the number of In Discards, and the number of Out Discards.

The following image shows the top 5 ports by traffic table:

Top 5 Devices by Flow

The top 5 devices by Flow shows you the top 5 devices sorted on the basis of the number of flows they have. The table shows the device IP, the number of flows, and the number of rules.

The following image shows the top 5 devices by flow table:

Top 5 Flows by Traffic

The top 5 flows by traffic shows you the top 5 flows across all connected devices sorted on the basis of their traffic rate. The table shows you the device IP, flow alias, and the count.

The following image shows the top 5 flows by traffic table:

Docker Statistics

The docker statistics table shows you the docker statistics across all connected devices along with the CPU and memory usage for each device.

The following image shows the docker statistics:

Syslog Statistics

The syslog statistics table shows you the system log statistics of all connected devices. The table shows the number of messages in the info, debug, error, notice, and warning categories for each device.

The following image shows the syslog statistics:

To manage connected devices from the FlowVision GUI, click System > Devices.

The Devices screen shows all the connected devices and their connection status. The devices that are online are shown with a green status and the devices that are offline are shown in a red status. You can click the icon to reboot an online device. To delete a device, click the icon.

The following image shows the Devices page:

Adding New Devices

To add a new device,

1. Click the icon at the top right corner of the Devices page. The Add New Device window displays.

2. Specify the values for IP Address, Username, and Password in their respective fields.

3. Click Save to apply your changes and add the device. Click Discard

The configuration menu helps you perform the following:

• Configuring Ports

• Configuring Port Groups

To manage connected topologies from the FlowVision GUI, click System > Topology.

The topology screen shows all the connected devices. The devices that are online are shown in green and the devices that are offline are shown in red. Hover the mouse pointer over the device icons to get more information, such as, the IP address, RAM, CPU, SSD, and so on.

The following image shows the topology of devices in the FlowVision GUI:

Configuring Device Properties in the Topology

You can change the device properties, refresh a device, or delete a device by accessing the Device Control window from the topology page.

1. Click the device icon in the topology screen. The Device Controls window displays.

2. Click the icon at the bottom of the Device Controls window. The Device Properties window displays.

3. Drag the sliders to the desired point to configure the threshold values for CPU, RAM, and SSD.

Other than changing the device properties, you can also reboot a device or delete it from the Device Controls window:

• Click the icon to reboot the device.

• Click the icon to delete a device.

You can group ports from a device together and create port groups. To get to the port groups page from the FlowVision GUI, click Configuration > Port Groups.

The Port Groups page shows you the connected devices and a table that shows the port groups from each device, the port group ID, the name of the ports that are part of the port group and an option to delete any existing port group.

The following image shows the Port Groups page:

Creating Port Groups

To create a new port group,

1. Click the icon at the top right corner of the port groups page. The Port Group window displays.
2. Select the device where you want to create the port group.

3. Click the required ports to add them to the port group. The added ports are displayed in the Select ports to create Groups

To view the flow statistics of the connected devices from the FlowVision GUI, click Statistics > Flow.

The Flow statistics page shows you the connected devices, the available rule IDs for each devices, the flow alias, and counters.

The following image shows the Flow statistics page:

The Statistics menu helps you perform the following:

To view the port statistics of the connected devices from the FlowVision GUI, click Statistics > Port.

The Ports statistics page shows you the connected devices, the available ports on each device, and the counter, traffic rate, and error statistics of the ports. By default, when you select a device the statistics for all the ports in the device are displayed. If you want to get the statistics of a particular port, select the port from the list of ports.

The following image shows the port statistics page:

You can get the statistics for Counters, Traffic Rate, and Errors, each shown in a different tab.

Counters Statistics

The counter statistics show the counter for received bytes, received packets, transmitted bytes, and transmitted packets for each port.

The following image shows the counter statistics table:

Traffic Rate Statistics

The traffic rate statistics show the rate of transmission and reception in bytes for each port.

The following image shows the traffic rate statistics table:

Errors Statistics

The error statistics show the In Errors, Out Errors, In Discards, and Out Discards of each port.

The following image shows the error statistics table:

The Tunnel Configuration section in FlowVision allows users to view, create, and manage VXLAN tunnels through a graphical interface.

Accessing Tunnel Configuration

To view and configure Vxlan tunnel:

1. Navigate to Configuration > Tunnel.

2. The Tunnel Information page displays:

   • Existing VXLAN tunnels.

   • A table with tunnel details, including:

The following image shows the Tunnel Information page:

Creating New Tunnel

To create a new tunnel,

1. Click the icon at the top right corner of the Tunnel page.

2. The Tunnel Template window displays.
3. Specify values for the following:

Deleting the existing tunnel

• To delete a tunnel, click the icon next to the tunnel entry.

Accessing VLAN Configuration

To configure VLANs from the FlowVision GUI:

1. Navigate to Configuration > VLAN Configuration.

2. The Vlan Configuration page will display:

   • The total number of existing VLANs.

   • A table with VLAN details, including Device IP, Interface Type, Ip Address/ Mask ,Any Cast Gateway / mask and options to Delete VLANs.

3. The following image shows the VLAN Configuration page:

Creating New VLANs

To add a new Vlan,

1. Click the icon at the top right corner of the Vlan Configuration page..

2. Enter a VLAN ID within the supported range (4010–4060).

1. Once created, the new VLAN will be listed under the VLAN Information section.

Creating an SVI Interface

To assign an IP address to the newly created VLAN:

1. Click the second icon in Interface Configuration section.

2. Select Interface Type: VLAN from the dropdown menu.

3. Choose the VLAN ID, assign the IP address, and click Save.

1. The newly created SVI (Switched Virtual Interface) will appear in the Interface VLAN Information table as show on below

Deleting the existing Vlan

To delete the existing Vlan , click the icon.

To access the system and device information, click System > General.

System Information

The system information table shows you the product name, version information, and technical support information for the system.

The following image shows you the system information tab:

Devices Information

The devices information table shows detailed information and properties of each connected device. For each device, the table shows the IP address, the MAC address, the platform on which the device is running, the HWSKU information, the SONiC version of the device, the PBNOS version, and the device uptime in days, hours, and minutes.

Editing Device Properties

You can edit device properties from the Devices Information table:

1. Click the Edit button corresponding to the required device on the Devices Information table. The Device Properties window displays.

2. Change the required device property value in the editable fields. Currently, you can edit the Hostname, ZTP Status, and GTP value.

3. Click Save Changes to apply your changes.

Click the Reboot Device button, if you want to reboot the device.

To view the system log from the FlowVision GUI, click System > Syslog.

The Syslog page shows the system logs of all the devices that are online. You can click the device icon for each of the online devices to get the system log for that particular device. The system log shows the device IP, component, severity level, time stamp, and the severity level message with more specific information.

The following image shows the system log table of a device:

You can change the severity level of the messages displayed in the syslog table using the Severity Level drop-down menu. The available options are Debug, Info, Notice, Warning, Err, Critical, Alert, and Emergency. This is a multi-select menu where you can select multiple severity levels to be displayed.

To configure SNMP traps using the FlowVision GUI, navigate to Configuration > SNMP Traps.

The SNMP Traps configuration page lists connected devices and their respective configured SNMP Traps. You can select individual devices and define SNMP traps.

The following image shows the SNMP Trap page with the switches and configured SNMP Traps:

Configure SNMP Traps

To create an SNMP Trap,

1. Start by clicking on the button

2. Select the switch to configure the SNMP Trap

3. Configure the SNMP trap Server-ID, Version, Destination IP, Destination Port and community string

To delete the existing SNMP Trap, click the icon.

The FlowVision Controller can be installed using the following methods:

The System menu lets you perform the following actions:

• Viewing the Dashboard

• Accessing the General System and Device Information