Unifi UAP Device Re adoption

0
(0)

Ubiquiti UAP device adoption with UniFi network application and SSH terminal

Device adoption is the process of connecting a UniFi device to a UniFi application in order to be managed by it.

This article explains how device adoption works, how to adopt devices to the UniFi Network application, and how to troubleshoot any issues that may arise.

The UniFi Network application scans and displays all devices that are unmanaged or managed by UniFi Controller. A UniFi device that is not managed by any application will show a static white LED. This means that the device is available for discovery and adoption.

If the adoption process fails and the device is no longer possible to adopt because the UniFi Controller reject it, for example after a failed provisioning, the first step to do is to remove the device that is no longer connected from the UniFi Controller by clicking on the Forget button.

UniFi Device Disconnected click Forget

Manual set-inform via SSH

Now connect over SSH to the device, for example using PuTTY terminal or with Linux use SSH to the UAP Access Point.

SSH Terminal open to UniFi UAP with PuTTY
Open SSH Terminal to UniFi UAP with PuTTY

If the UAP status Server Reject is displayed, then you can reset the UAP, using the following command-line from the SSH terminal.

During the reset, the UAP will reboot, after about 2 minutes the device is reachable again, possibly now with a different IP address.

The device is now in the status – Pending Adoption (static white LED), the device can now adopt by the UniFi controller application.

Unifi UAP Pending Adoption Status

Now open an SSH terminal again and execute the command-lines, the command set-inform must be executed several times. After reset the login is ubnt/ubnt or root/ubnt. The UniFi-Controller is running on Server 192.168.2.17, but it can also by an UniFi Cloud-Key.

After about 2 minutes, the device is ready for adoption, in the UniFi Controller application click Adopt. After another 2 minutes, the device is adopted and has been provisioned. The device status LED now lights up blue permanently.

Advanced adoption troubleshooting

If the device doesn’t appear for adoption and the steps above didn’t help, try the following steps:

If the device status LED not lights up, check whether the device is powered. Check the PoE and Ethernet cables. If the device is powered and the LED lights up, it may be managed by another UniFi network application.

If the device status LED is permanently blue, it means that the device has either already been adopted from a UniFi network application and is no longer able to connect, or that the device is managed by another UniFi network application that prevents the device from being detected.

A reset can be triggered on the UniFi device next to the RJ-45 LAN port, use a pen or a curved paper clip to press and hold the reset button for at least 5 seconds, the device status LED starts flashing.

Add additional IP address on Windows

If the device has assigned the IP address 192.168.1.20 and not one from DHCP, it means that the device has been rejected by the UniFi Controller and the provisioning no longer works. In order to be able to reach the device via the SSH terminal, a second IP address must be assigned to the client computer. To do this, proceed as follows under Windows, by pressing the keys, Windows logo + R for Run.

Enter ncpa.cpl and click OK

Enter ncpa.cpl and click OK

The Control Panel Network Connections is opened; right-click on Properties above the active network adapter.

Control Panel Ethernet Properties

Mark the line Internetprotocol Version 4 (TCP/IPv4) and click on Properties.

Add alternate IP-Address

Enter an IP address in the Alternate Configuration tap, e.g. 192.168.1.2 and the subnet mask 255.255.255.0. Confirm the entry by clicking OK to activate the alternate IP address.

Add second IP address on Linux

Under Linux, a second IP address can be temporarily assigned to the network interface as root.

With modern Linux distributions like Debian 10 (buster) or CentOS 7 and newer, it is this command line.

macOS use ifconfig to add second IP-Address to interface en0.

The device can now be checked with ping and connected to 192.168.1.20 via SSH terminal.

Linux has SSH built in and can be used directly from shell. After the SSH connection to the device has been established, the procedure described above is carried out.

If a UniFi AP is not accepted after several attempts using Adopt, assign an alternate IP address to the host on which the UniFi controller is running, for example. 192.168.1.100. The UAP that does not get an IP from the DHCP can be reached by the UniFi controller in order to be able to initiate provisioning, cause the UAP can be reached by the controller via the IP address 192.168.1.20, that after execute restore-default. After the successful provisioning, the UAP is back in the original subnet.

unifi advanced adopt

It is also possible to use the ADVANCED ADOPT option with click to the + on UAP they appers status MANAGED BY OTHER.

How useful was this post?

Click on a star to rate it!

Average rating 0 / 5. Vote count: 0

No votes so far! Be the first to rate this post.

We are sorry that this post was not useful for you!

Let us improve this post!

Tell us how we can improve this post?

Leave a Reply

Your email address will not be published. Required fields are marked *