Site Local UI Usage

Objective

This guide provides instructions on how to access graphical user interface local to a Volterra CE site. The local UI is used to perform certain configuration and management functions locally from the site. The local UI is also used to obtain status related to the Volterra site.

The various functions you can perform using the site local UI are:

  • Initial configuration for site provisioning
  • Network configuration for wired, wireless, and mobile carrier/LTE networks
  • Site status monitoring
  • Site services monitoring
  • Factory reset
  • Collection of debug information

Using the instructions provided in this guide you can access site local UI and perform configuration functions.

Note: The site local UI is more useful in case of private cloud data centres or Volterra hardware where activities such as post installation configurations are required.


Prerequisites

Note: In case you do not have an account, see Create a Volterra Account.

  • Any of the following types of sites:

    • A Volterra IGW device - Ships with software pre-installed.
    • VMware virtual machine - See Create VMware Site for installation instructions.
    • KVM/Libvirt virtual machine - See Create KVM/Libvirt Site for installation instructions.
  • A site token.

    Note: In case you do not have a site token, see Create Site Token for instructions.


Site Local UI Operation

The site local UI operation includes initial configuration, provisioning configuration, and other advanced functions such as monitoring, factory reset, or debug collection.

Perform Initial Configuration

In case of Volterra site on private cloud or IGW devices, it is required to perform initial configuration for site provisioning after software installation. This can be performed either from the CLI or the local UI. This example covers initial configuration using the site local UI.

Note: For information on configuration using CLI, see the Site Management guides.

Perform the following steps:

Step 1: Power on your device and obtain the device IP address.
  • In case of VMware or KVM, boot up your virtual machine after installing software. In case of Volterra IGW, connect to the power source and switch on the device.
  • In case of VMware or KVM, find the IP address from the utilities such as vSphere client or the virsh tool. In case of IGW, use tools such as network scanner to find the IP address after connecting to the LAN.

Note: You can also obtain IP address from the IGW device display after connecting the WAN port to your local LAN.

Step 2: Log into the local UI and change initial password.
  • Open a browser window and enter https://<device-ip-address>:65500. This loads authentication popup window.
  • Enter admin and Volterra123 in the Username and Password fields respectively. Click Sign in.
  • The site local UI loads asking to change the password. Enter the current password. Enter new password and enter the same in the confirmation field. Click change password.

change pwd
Figure: Initial Authentication Setup

  • Refresh the browser to sign in with your new password. The local UI dashboard gets displayed
Step 3: Perform initial configuration for site provisioning.
  • The Status field in the dashboard shows Configuration. Click Configure now to load the device configuration window.

config now
Figure: Dashboard View With Configure Status

  • Configure the fields as per the following guidelines:

    • Token - This is your site token and mandatory for provisioning.
    • Cluster name - Enter a cluster name and this is mandatory for provisioning. However, you can also set this during registration.
    • Hostname - optional.
    • Certified Hardware - This is populated by a default value but you can change it from the drop-down list.
    • Primary Outside NIC - This is populated by default to eth0 but you can change it from the drop-down list.
    • Latitude - Optional.
    • Longitude - Optional.

initial config
Figure: Initial Configuration for Site Provisioning

  • Click Save configuration. Refresh the browser and the status gets updated to Approval indicating that the site registration is pending for approval.

status approval
Figure: Site Waiting for Registration Approval

Step 4: Perform registration.
  • Log into VoltConsole and navigate to Manage -> Site Management in the configuration menu of system namespace. Click Registrations in the options. The Pending Registrations tab loads by default.
  • Check that a registration request is displayed for your site. Click ✅ to approve the registration. Enter the required fields in the registration acceptance form as applicable and click Accept.

Note: The approval may take few seconds.

  • Go back to site local UI and refresh the browser and the status reflects Provisioning. Wait for few minutes and refresh again and status now shows Provisioned.

provisioned
Figure: Site Provisioned


Monitor Site From Local UI

The local UI loads site dashboard view by default. The site dashboard shows site status and detailed system information such as CPU, memory, hardware information , etc. Perform the following steps to monitor your site.

Step 1: Monitor site services.

Click Services on the left menu to load the service status page. The status Ready indicates that the site services are ready for operation.

services
Figure: Site Service Monitoring

Note: Click Refresh button to obtain the latest status.

Step 2: Monitor DHCP lease.

Click DHCP leases on the left menu to check the DHCP lease information. In this example, the eth3 is the inside interface providing DHCP services to the network to which this interface is associated.

dhcp
Figure: DHCP Leases Monitoring

Step 3: Monitor site status.

Click Status on the left menu to obtain detailed site status in JSON format.

status json
Figure: Detailed Site Status


Perform Additional Functions

You can perform additional functions such as wireless network configuration, factory reset, collecting debug information, etc. Perform the following steps to carry out additional functions.

Step 1: Configure wireless network access.
Step 1.1: Configure WiFi settings.
  • Click WiFi Settings on the left menu and wait for the wireless network scanning completion.

wifi
Figure: WiFi Settings

  • Click on Network SSID field and select a network as per your choice. Click on Security field to select the security type and enter the security information according to the security selection. Click Apply Changes to save the wifi settings.

Note: Click Scan for networks anytime to scan again and refresh the network list. Click Reset form to reset the settings.

Step 1.2: Configure LTE settings.

Configuring LTE settings requires you to insert mobile carrier LTE SIM into the IGW device. Also, obtain the APN, username, and password from your LTE service provider.

  • Click LTE settings on the left menu to load the LTE settings form.
  • Enter your access point name in the APN field.
  • Enter username and password in the User and Password fields respectively.
  • Enter your connection PIN in the PIN field.

lte
Figure: LTE Settings

  • Click Apply Changes to save the LTE settings.

Note: Click Reset form to reset the settings.

Step 2: Change password.

Click Change password option to change the admin password.

Step 3: Execute CLI commands and obtain results.

Click Tools option and select an option from the displayed list of Select tool field. Associated command gets executed and result is returned.

tools
Figure: Site Local UI Tools

Step 4: Perform factory rest.
  • Click Factory reset option to reset the node to the factory settings. The site status in the dashboard shows Resetting. This process may take several minutes.
  • After this, it is required to perform initial configuration. Refresh the browser and perform the instructions listed in the Perform Initial Configuration chapter.

Note: You can also perform factory reset from the VoltConsole. See Perform Factory Reset for more information.

Step 5: Collect debug information.
  • Click Debug info option to load the debug info window. Click Collect Debug info and wait for the debug collection to complete.

debug 1
Figure: Site Debug Information

  • Click Browse debug info files to display the debug information files collected.

debug 2
Figure: Browse Debug Information Files