×

UNMS - Mobile App

Overview

Readers will learn how to add and manage EdgeMAX and airMAX devices using the UNMS Mobile app.

NOTES & REQUIREMENTS:

Table of Contents

  1. Supported Devices
  2. Adding and Configuring an EdgeMAX Device
  3. Adding and Configuring an airMAX Device
  4. airMAX Firmware Upgrade
  5. airMAX Site Survey
  6. airMAX Alignment
  7. airMAX Speedtest
  8. Connecting to a UNMS (Cloud) Controller
  9. Related Articles

Supported Devices

Back to Top

The Ubiquiti Network Management System (UNMS) allows you to configure, upgrade and monitor several different Ubiquiti device platforms:

  • airMAX
  • airCube
  • airFiber
  • EdgeMAX
  • UFiber

The UNMS Mobile app, available in the Apple App Store and on Google Play, is used to discover and access Ubiquiti devices on the local network. This is a very powerful tool that you can use to add devices to the UNMS Controller (Cloud or self-hosted), or individually manage them. 

The exact steps on how to connect to the device and which credentials (username / password) to use will differ between the various Ubiquiti devices. For the most up to date information, we recommended downloading your device's Quick Start Guide (QSG) from our Download section.

The WiFiman Mobile App, WiFiman Desktop and the Ubiquiti Device Discovery Tool can also be used to discover Ubiquiti devices.

edgerouter.png   Adding and Configuring an EdgeMAX Device

Back to Top

topology.png

Adding an EdgeMAX device (EdgeRouter-4) to an existing network in order to manage it with the UNMS Mobile app.

Before starting, please check the appropriate Quick Start Guide (QSG) of the device from the EdgeMAX Download section for the installation steps.

On EdgeRouter devices, starting from the v1.10.6 and v2.0.0 firmware releases, the DHCP client feature is enabled by default on the eth1 interface. If you are connecting the device to an existing network, then it is recommended to connect the EdgeRouter using the eth1 interface for initial configuration. EdgeSwitch devices (ES, ES-X and ES-XP) will try to obtain a DHCP assigned address by default on any interface.

NOTE:Use the WiFiman Mobile App to run a subnet scan to find all devices on the local network. 

Below is an example of discovering and logging into an ER-4 using UNMS Mobile and the WiFiman Mobile App:

wifiman-edgemax.png discover-edgemax.png logging-in-edgemax.gif
Running a WiFiman subnet scan. Discovery after connecting to the local Wi-Fi. Logging in to the device.
NOTE:See the Adding a New Device on the Mobile App article if you are experiencing trouble discovering your device. 

After logging in, the UNMS Mobile app can be used to configure various options on the EdgeRouter, such as:

  • Ethernet Interfaces
  • VLAN and PPPoE Interfaces
  • System Settings
  • DHCP Server
  • Backup
  • Firmware upgrade
  • Reboot
  • Factory Reset

You can also add the device to a self-hosted or UNMS Cloud controller if you have previously connected to a UNMS controller using the app Controllers settings. See the Connecting to a UNMS (Cloud) Controller section below for more information on how to connect the UNMS Mobile app to a UNMS controller.

interfaces-edgemax.png options-edgemax.png vlan-pppoe-edgemax.png
Interfaces settings. Options menu in the top-left corner. Add VLAN or PPPoE interface.

To change the UNMS controller settings on the EdgeRouter, either tap on the UNMS Status section or open the options menu and navigate to the System > UNMS Connection settings.

The UNMS app pushes the UNMS connection key to the device. This key will include the hostname/IP address of the UNMS server that is defined in the Settings > UNMS > Server Settings > UNMS Hostname/IP section on the UNMS controller.

system-edgemax.png unms-edgemax.png status-edgemax.gif
System settings. UNMS Connection settings. UNMS connection status.

nanobeam.png   Adding and Configuring an airMAX Device

Back to Top

With UNMS Mobile users can perform the same system configuration and monitoring as they would on the Web UI (with the one exception of advanced mode in network configuration). There are some features that are included in UNMS Mobile, which are not found in the Web UI. For example:

  • Credentials memory UNMS Mobile remembers connection credentials, such as IP addresses, usernames and passwords.
  • Automatic IP detection If the user changes the device's IP address, UNMS Mobile can automatically detect the new IP address and re-connect to it without user intervention.
  • Continuous site survey UNMS Mobile runs a site survey in a loop and shows current and best signal for every discovered network. A technician could move the antenna around, adjusting it, for a few minutes and then very easily check what was discovered and what strength of signal was achieved.

With UNMS Mobile a user can do any number of things. Some basic scenarios of activities that can be achieved through the app include:

  • Install a new CPE or AP with the U-Installer. The new U-Installer is a portable AP with an internal battery and single ethernet port with 24V PoE, all this enabling a user to connect any airMAX device to the U-Installer port and start an installation without the need of cabling.
  • Realign an existing CPE using UNMS Mobile's antenna alignment feature.
  • Check connected stations.
  • Measure connection speeds.
  • Discover existing devices on connected network.

Before starting, please check the appropriate Quick Start Guide (QSG) of the device from the airMAX Download section for the installation steps.

Devices such as the NBE-5AC-Gen2 broadcast a management SSID for 15 minutes after power-on. Connect your phone to this SSID (or another wireless network that the airMAX device is connected to) in order to discover and manage the device.

NOTE:Use the WiFiman Mobile App to discover nearby SSIDs and their signal levels.

Below is an example of discovering an airMAX device such as the NBE-5AC-Gen2 using UNMS Mobile and the WiFiman Mobile App:

wifiman-airmax.png discover-airmax.png logging-in-airmax.gif
Verifying the nearby SSIDs with WiFiman. Discovery after connecting to the SSID. Logging in to the device.
NOTE:See the Adding a New Device on the Mobile App article if you are experiencing trouble discovering your device. 

After logging in, the UNMS Mobile app can be used to configure various options on the airMAX device, such as:

  • Wireless and Wired Network Configuration
  • Management Network Settings
  • System Settings
  • Services
  • Antenna Alignment
  • Speedtest
  • Reboot
  • Factory Reset
  • Firmware Upgrade
  • Ping and Traceroute
  • Device Discovery
  • Site Survey
  • Backup

You can also add the device to a self-hosted or UNMS Cloud controller if you have previously connected to a UNMS controller using the app Controllers settings. See the Connecting to a UNMS (Cloud) Controller section below for more information on how to connect the UNMS Mobile app to a UNMS controller.

To change the UNMS controller settings on the airMAX device, tap on the UNMS Status bar at the top of the screen.

The UNMS app pushes the UNMS connection key to the device. This key will include the hostname/IP address of the UNMS server that is defined in the Settings > UNMS > Server Settings > UNMS Hostname/IP section on the UNMS controller.

home-airmax.png options-airmax.png network-airmax.png
Home screen. Configuration menu in the top-right corner. Management Network options.

 Some of the more common airMAX installation steps are explained in greater detail below.

nanobeam.png   airMAX Firmware Upgrade

Back to Top

Follow the steps below to upgrade the firmware of an airMAX device using the UNMS Mobile app.

NOTE:It is possible to use the app to download and store firmware releases.

1. After logging into the device, open the options menu in the top-right corner and select Firmware Upgrade.

2. Verify the current firmware version.

3. If you have previously downloaded the firmware through the UNMS app, it will show up here.

4. If the firmware has not been downloaded yet, log out of the device and open the Tools tab. 

5. Select Firmware and look for the firmware release that you want to install.

6. Verify if the firmware release is applicable to your device and download it.

7. Afterwards, log back into the device and navigate to the Firmware Upgrade section to update the firmware.

options-airmax.png firmware1.png firmware2.png
firmware3.png firmware4.png firmware5.png
firmware6.png firmware7.png firmware8.png

nanobeam.png   airMAX Site Survey

Back to Top

Follow the steps below to run a Site Survey on an airMAX device using the UNMS Mobile app.

1. After logging into the device, open the options menu in the top-right corner and select Site Survey.

2. The app will automatically start scanning for nearby wireless networks.

3. Choose the SSID that you want to connect to from the Wireless configuration section.

options-airmax.png survey-airmax.png wireless-airmax.png
Home screen. Running the site survey. Wireless network configuration.

nanobeam.png   airMAX Alignment

Back to Top

Follow the steps below to (re)align an airMAX device using the UNMS Mobile app.

1. After logging into the device, open the options menu in the top-right corner and select Antenna Alignment.

2. The app will automatically start disabling the signal strength.

3. You can swipe to the secondary pane to view the local and remote signal process.

NOTE:There is an audio signal alignment option top-right corner. When enabled, the app will start generating a tone with a frequency related to signal strength. You can use this feature to align the airMAX device without having to look at the screen.
options-airmax.png alignment1.png alignment2.png
Home screen. First pane. Secondary pane.

nanobeam.png   airMAX Speedtest

Back to Top

Follow the steps below to run a speedtest from an airMAX device using the UNMS Mobile app.

1. After logging into the device, open the options menu in the top-right corner and select Speedtest.

2. You can manually add a speedtest target if the remote connection does not show up.

3. Add the IP address information and credentials of the remote device and start the test.

options-airmax.png speedtest1.png speedtest2.png
Home screen. Adding a speedtest target. Running the speedtest.

ubiquiti_logo.png  Connecting to a UNMS (Cloud) Controller

Back to Top

The UNMS Mobile app can also be used to connect to an existing self-hosted or UNMS Cloud controller. Besides managing UNMS itself, you can also easily adopt devices after adding the controller.

1. Navigate to the controllers tab and select I already have a Controller.

2. Add the IP address or hostname of the UNMS (Cloud) controller.

3. Select Yes if presented with an untrusted SSL security warning.

4. Enter your credentials and sign in.

NOTE:The tabs (Devices, Controllers, Tools) at the bottom of the screen will be expanded and look different after adding the controller.
controller1.png controller2.png controller3.png
Controllers tab. Adding the hostname or IP address. Entering the credentials.

Related Articles

Back to Top

UNMS - Adding a New Device on the Mobile App

UniFi - Getting Started with the UniFi Mobile App

Was this article helpful?
17 out of 29 found this helpful
Can't find what you're looking for?
Visit our worldwide community of Ubiquiti experts for more answers
Visit the Ubiquiti Community