In vCenter select the new Virtual Machine (VM), power it on and then launch the Remote Console.

    1. Login into the Remote Console as user “vcf” using password “changeme”. The UNUM Insight Analytics Flow setup script is named “UNUM_setup.sh” and is in the default folder of user “vcf”.
    2. Run the setup script: ./UNUM_setup.sh



UNUM Setup Script


Installation Setup Options


After the setup script launches the UNUM: Installation Setup menu is displayed along with the UNUM version number and Machine ID.


Configure UNUM IP

You may now configure the Host IP by selecting Option 1. Follow the on-screen instructions for entering the Host IP address.


Note:  Before you can configure or edit UNUM IP Addresses, you must first stop UNUM using Option 4.



UNUM Options Menu

UNUM Configure UNUM IP Menu


UNUM - Configure Host IP


Note: Please review the following usage information regarding the Ethernet adapters used by UNUM:

Eth0:

used for management, GUI (user interaction) and data collection via Netvisor REST. This interface uses DHCP by default.

Eth1:


used for internal system communication. Single UNUM VM instances REQUIRES an IP address for eth1 to be set before normal operation will begin. WARNING! If you change the IP address of eth1, in a cluster configuration, normal operation is disrupted. Please contact Pluribus Networks Technical Support if you need or want to change the eth1 address in a cluster configuration.

Eth2:

<Optional> used to connect a Seed Switch or Fabric on a separate network other than the web interface.

UNUM Ethernet Adapters Usage Table



Configure Docker0 IP

UNUM uses a default docker IP address of 172.17.251.1/24 for internal communication. In the majority of deployments, there is no need to change this address.

However, if you use the default range as the UNUM management network there could be network conflicts within your network.

Therefore, you have the ability to modify the docker0 interface IP address using Option 2 - Configure docker0 IP.


UNUM - Configure Docker0 & VCFnet Bridge IP

Select Option 2 - Configure docker0 IP.

Enter the desired IP address range and mask.

Enter the sudo password.

UNUM updates the docker0 IP address, stopping and restarting services.

UNUM - Configure Docker0 IP


Press any key to continue.

If required, view the new docker0 IP address using ifconfig from a command prompt.

UNUM - New Docker0 IP Address



Note: The docker0 IP address has to be a specific host IP address and mask.



Configure VCFnet Network

UNUM uses a default VCFnet IP address of 172.18.251.1/24 for internal communication.

However, if you use the default range as the UNUM management network there could be network conflicts within your network.

Therefore, you have the ability to modify the VCFnet interface IP address using Option 3 - Configure vcfnet network.

UNUM - Configure VCFnet Network IP

Select Option 3 - Configure vcfnet Network.

Enter the desired IP address range and mask.

Enter the sudo password.

UNUM updates the vcfnet IP address, stopping and restarting services.

UNUM - Configure VCFnet Network IP


UNUM - New vcfnet IP Address

Press any key to continue.

If required, view the new vcfnet IP address using ifconfig from a command prompt.


Note: The vcfnet IP address has to be a specific network IP address and mask.



If no further configuration changes are required, use Option 3 to restart UNUM otherwise proceed to the next step.

After the Host IP address and other network settings are configured You set the Date, Time and Time Zone selecting Option 2.

Configure Date / Time

A new screen is launched and using the available Options you set Date and Time or adjust the Time Zone by selecting Option 1 and Option 2.


Note: Stop UNUM to update Date, Time and Time Zone. If UNUM is running, select Option 4 from the Installation Setup menu before attempting to change or configure Date, Time or Time Zone. After making your changes, restart UNUM using Option 3 from the Installation Setup menu.



To perform an NTP Status Check use Option 3.

Option 0 returns you to the main menu.


UNUM Date & Time

UNUM Select Date & Time

UNUM Select Time Zone


As described above press any key to continue and select the desired geographical area.

UNUM Select Geographical Area


UNUM Select City or Region


After selecting the desired city of region Click <Ok> to return to the previous screen and select Option 0 to return to the main screen.

UNUM Time and Date Completed


The date, time and time zone settings are updated.


You press any key to continue and a full summary of the date, time and time zone entries are displayed along with additional information pertaining to daylight savings time.


UNUM Date, Time, Time Zone and DST Settings Summary



To perform an NTP status check select Option 3.


If UNUM is running and before attempting any configuration changes you must stop the services by selecting Option 4.

The Installation Setup screen displays the list of stopping services.

UNUM - Stop Services


If you have VMs configured as clusters for UNUM, the installation prompts you to stop the services on other VMs.

You must use the right SSH username and password, and this information should be the same for all nodes in the cluster.

UNUM - Prompt to Stop Other VM Services


Start UNUM

Once UNUM is completely configured you must start the services by selecting Option 3.

The Installation Setup screen displays the list of starting services.

UNUM - Start Services



If you have stopped services on other VMs for UNUM, the Installation Setup wizard prompts you to start the services on other VMs.



Start Other VM Services

After all services are started point your browser to http://<your VM ip>/ to display the UNUM interface.


In the event of a server / VM reload, re-run the ‘UNUM_setup.sh’ script again first stopping services and then re-starting the services using Option 4 and Option 3.


UNUM Upgrade

You upgrade your UNUM software  using Option 5.


Save the specific version zipped file to /srv/docker/offline_images directory.


 After acknowledging Yes to continue you are prompted to enter the upgrade image file name. Follow the on-screen instructions to complete the software upgrade.


Note: There is no rollback or undo procedure. You must re-install a previous version using Option 5.




Upgrade UNUM


Option 6: Tech Support which, if selected, archives all logs, configuration and system statistics, to the directory, /tmp. 


This is useful if you are experiencing problems with UNUM and must contact Pluribus Networks Technical Support Team.




Option 6 - Tech Support

Option 7: Status, allows you to check the status of many of the running processes in UNUM.



Option 7 - Status Check

Option 8: Advanced Settings, provides you access to additional tools: Backup Configuration, Restore Configuration and Delete a Backup as well as setting extended logging features within UNUM for troubleshooting purposes.



Note: The Backup and Restore functionality is for Configuration Settings only. Analytical Data is not backed up.



Backup Configuration


Select Option 1 to backup your configuration.



Option 1 - Advanced Settings Backup Configuration


Restore Configuration


Select Option 2 to restore your configuration.


Select the desired backup file from the list of Available Backups and follow the on-screen instructions.


Note: UNUM will be restarted during the process.




Option 2 - Advanced Settings Restore Configuration



Option 2 - Advanced Settings Restore Process

Delete a Backup


To delete a configuration backup select Option 3 and follow the on-screen instructions.



Option 3 - Advanced Settings Delete Backup


Enable | Disable Debug Mode


To enable or disable the Debug Mode select Option 4.


When enabling or disabling extended logging follow the on-screen instruction to Stop and Start UNUM services.


Option 8 - Enable / Disable Debug Mode


Option 8 - Debug Mode Enabled


Note: The restart dialog includes the warning debug services are enabled.



Disable Debug


Select Option 4 to disable the Debug mode and follow the on-screen instruction to Stop and Start UNUM services.



Option 8 - Debug Mode Disable



Option 8 - Debug Mode Disable Restart


Note:  When Debug mode is disabled the restart dialog does not contain any reference to Debug mode.


Option 9: Configure SNMP Community String, provides a method to enter SNMP community strings.

The default community string is "vcfc".

When you add community strings via the UNUM SNMP Community dashboard you must enter the same string information here to receive SNMP Community information from a switch.

Option 9 - SNMP Community String Setup

Select Option 1 to display existing SNMP community strings.

Option 1 - Display SNMP Community Strings

Select Option 2 to add a new community string. Enter the name for the SNMP community string and press Enter.

Option 2 - Add SNMP Community Strings

Option 2 - New SNMP Community String

Select Option 3 to delete a community string entry and select the requisite number from the displayed  list of community strings.

Option 3 - Delete SNMP Community String Entry