UBNTMOD is a tool(Shell Script) that allows you to configure a vast amount of settings on Ubiquiti AirMax equipment from the Linux command line. The script can be used for helping automate task like reboots and firmware updates, and\/or be used to change settings like device name, ssid, enable or disable NTP, and Syslog. For a complete list of functions look at the UBNTMOD HELP section.<\/p>\n\n\n\n
The script has been tested and any known bugs should be listed at the bottom of this page, but use at your own risk. This is a bash script so feel free to download, review, copy, add, tweak, and remove all or parts of the code.<\/p>\n\n\n\n
Install Prerequisites<\/strong><\/p>\n\n\n\n The only requirements outside of a Bash shell is having sshpass installed.<\/p>\n\n\n\n Download the script here<\/a> or with wget<\/p>\n\n\n\n Make executable<\/p>\n\n\n\n Run script<\/p>\n\n\n\n Basic syntax is<\/p>\n\n\n\n Example : Print firmware version<\/p>\n\n\n\n A note about saving changes<\/p>\n\n\n\n If you make a change to a device like change the name, you’ll need to save and apply the changes to the radio. Do this by using the -Z option, it writes the changes and reboots the device so the changes take effect.<\/p>\n\n\n\n Tip : You can string a bunch of options together and then save them all at once,<\/p>\n\n\n\n Example : Change device name, username, and enable NTP.<\/p>\n\n\n\n A note about usernames and passwords<\/p>\n\n\n\n In the script there are two variables “un” and “pw” which specify the username and password to use when connecting to the radios. By default these are ubnt and ubnt. you can change these in the script so the script uses some other default username and password, or you can specify the username and password with the “-y” option.<\/p>\n\n\n\n So in our first example, if the username and password are different then ubnt we use the -y option<\/p>\n\n\n\n All other needed information should be in the help part of the script, accessible with the -h argument.<\/p>\n\n\n\n Reboot<\/p>\n\n\n\n Wireless Scan<\/p>\n\n\n\n Discovery<\/p>\n\n\n\n Upgrade<\/p>\n\n\n\n Backup Configuration<\/p>\n\n\n\n Restore Configuration<\/p>\n\n\n\n Change SNMP settings<\/p>\n\n\n\n Change Device name<\/p>\n\n\n\n Check if radio can resolve DNS<\/p>\n\n\n\n Softrestart <\/strong><\/p>\n\n\n\n The following options have been tested and work with the softrestart option<\/em><\/p>\n\n\n\n Want a specific example or new features? Leave a comment!<\/p>\n\n\n\n Future Changes Latest Changes<\/strong><\/p>\n\n\n\n ### Version 1.0.8 (9\/3\/2022) ### Version 1.0.7 ### Version 1.0.6 (5\/24\/2019) ### Version 1.0.5 Changes (8\/9\/2019) ### Version 1.0.4 Changes (5\/24\/2019) ### Version 1.0.3 Changes (9\/5\/2018) ### Version 1.0.2 Changes (10\/31\/2018) ### Version 1.0.1 Changes (10\/31\/2018) <\/p>\n","protected":false},"excerpt":{"rendered":" UBNTMOD is a tool(Shell Script) that allows you to configure a vast amount of settings on Ubiquiti AirMax equipment from the Linux command line. The script can be used for helping automate task like reboots and firmware updates, and\/or be … Continue reading sudo apt install sshpass<\/pre>\n\n\n\n
Download script<\/h1>\n\n\n\n
wget http:\/\/incredigeek.com\/home\/downloads\/ubntmod\/ubntmod.sh<\/pre>\n\n\n\n
chmod +x .\/ubntmod.sh<\/pre>\n\n\n\n
.\/ubntmod.sh -h<\/pre>\n\n\n\n
<\/h1>\n\n\n\n
Running script and basic usage<\/h1>\n\n\n\n
.\/ubntmod.sh -i {device ip} -o otheroptions<\/pre>\n\n\n\nuser:~$ .\/ubntmod.sh -i 192.168.1.20 -U info\ninfo\nPrinting firmware version\nfirmwareVersion=XM.ar7240.v6.0.3.30600.170329.1831\nuser:~$<\/pre>\n\n\n\n
.\/ubntmod.sh -i 192.168.1.20 -N \"New Device\" -Z<\/pre>\n\n\n\n
.\/ubntmod.sh -i 192.168.1.20 -N \"New Device\" -u admin -n enable -Z<\/pre>\n\n\n\n
.\/ubntmod.sh -i 192.168.1.20 -U info -y 'admin,password123'<\/pre>\n\n\n\n
<\/h1>\n\n\n\n
UBNTMOD HELP<\/h1>\n\n\n\n
.\/ubntmod.sh -h<\/pre>\n\n\n\n
\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\\\\\n\\\\ UBNTMOD tool 1.0.8 \\\\\n \\\\\/___\/___\/___\/___\/___\/\/\n\nHelp and Usage\n\nUsage: .\/ubntmod.sh -i TargetIP {OPTIONS}\nExample: Add SSH Key to 192.168.1.20\n.\/ubntmod.sh -i 192.168.1.20 -K id_rsa.pub -Z\n\nDevice to operate against\n-i IPADDRESS, IP Address of the device.\n\nOption usage\n-a remove, Removes AirControl provisioning. Works on AC1 and AC2\n-D enable\/disable, Enable or Disable DNS proxy\n-e , See if radio resolves DNS. SSH's to the radio and pings a domain name to see if it can resolve\n-N Device Name, Change name of the device.\n-n enable\/disable, Enable or Disable NTP server\n-K SSH Key, Specifies to path to the Public SSH Key file i.e. id_rsa.pub\n-l enable\/disable, Enable or Disable Syslog. Specify ip address if you want to enable remote syslog\necho \"-p 'password', Change password for device. You can use the -z option to save.\"\n-P PSK key, Change wireless passkey\n-r KEYTODEL, Replace KEYTODEL with key1(to delete the first SSH Key), key2(to delete the second Key), or allkeys(to delete all current SSH Keys on the device)\n-S SSID, Change SSID. Spaces are not supported in SSID field yet.\n-s \"community;contact;location\" Enable and set SNMP\n-t enable\/disable, Enable or Disable Traffic Shaping on device, note: you cannot set the speed limits from this program.\n-c fromText, The c and C Options are for making custom changes to the \/tmp\/system.cfg file, put the text you want to change after the -c option\n-C toText, The C and c Options are for making custom changes to the \/tmp\/system.cfg file, put the text you want the -c text to be changed to after the -C option. See below example\n-w Channel Width, Set Channel Width i.e.(-w 10) for 10mhz\n-u username, Change default username for the device\n-U firmware, Upgrade device firmware, can print current firmware version the option argument is version, info, or status\n\nDevice Operations\n-B, Backs up configuration of device. Script automatically names and time stamps the backup\n-b BACUPNAME, Restores a backup configuration from the specified file\n-I, Prints info about device\n-d, Run Discovery on device\n-R, Reboot Device.\n-A, Reboot devices connected to AP, then reboot the AP. Needs jq installed. You can reboot multiple AP's by putting the IP's in an ap.lst file (one ip per line).\n-w Channel Width, Changes channel width to whatever is specified, just the number no need to add mhz to the end, supported channel widths are 5,8,10,20,40 mhz\n-W, WIFI Scan, runs a scan, same thing as site survey\n-X COMMAND, Run a custom Command on device, like \"ls\", \"grep ssid \/tmp\/system.cfg\" Make sure to put the command in \"\"\n-y \\'username,password\\', Specify username and password to use in script\n-Y, Update ubntmod script with the latest available\n-z, Saves changes without a reboot by executing \/usr\/etc\/rc.d\/rc.softrestart save\n-Z, Saves changes made and reboots device to apply changes\n\n\n\nc and C Example\n\nbasic usage:\n.\/ubntmod.sh -i IPADDRESS -c linetochange -C changetoline\n.\/ubntmod.sh -i 192.168.1.20 -c snmp.status=enabled -C snmp.status=disable\nThe above line changes the \"snmp.status=enabled\" to \"snmp.status=disabled\"\n\nFind more help and tutorials at http:\/\/incredigeek.com\/home\/UBNTMOD<\/pre>\n\n\n\n <\/h1>\n\n\n\n
<\/h1>\n\n\n\n
Examples<\/h1>\n\n\n\n
.\/ubntmod.sh -i 192.168.1.20 -R<\/pre>\n\n\n\n
.\/ubntmod.sh -i 192.168.1.20 -W<\/pre>\n\n\n\n
user:~$ .\/ubntmod.sh -i 192.168.1.20 -d\nHardware Address IP address Name\n00:27:A8:BB:2A:CD 192.168.1.20 NanoStation M2 'UBNT'\n00:27:A8:AB:32:4A 192.168.1.1 NanoStation M2 'AP'\nTotal: 2 devices.\nuser:~$<\/pre>\n\n\n\n
user:~$ .\/ubntmod.sh -i 192.168.1.20 -U XM.v6.0.1.23382.160317.1806.bin<\/pre>\n\n\n\n
user:~$ .\/ubntmod.sh -i 192.168.1.20 -B AccessPoint\nbacking up configuration file for 192.168.1.1 Saving to AccessPoint.cfg\nuser:~$<\/pre>\n\n\n\n
.\/ubntmod.sh -i 192.168.1.20 -b AccessPoint.cfg<\/pre>\n\n\n\n
.\/ubntmod.sh -i 192.168.1.20 -s \"public,netwatch@incredigeek.com,office\" -z<\/pre>\n\n\n\n
.\/ubntmod.sh -i 192.168.1.20 -N \"device name\" -Z<\/pre>\n\n\n\n
.\/ubntmod.sh -i 192.168.1.20 -e<\/pre>\n\n\n\n
<\/strong>UNMS support for adding, disabling etc
Send changes to Slack or Teams channel
Support for multiple usernames and passwords
<\/strong>Support for soft restart, or where device doesn’t have to reboot to apply a change<\/del> (implemented and testing)
support for testing a change before applying?
<\/strong><\/p>\n\n\n\n
Added -A option to reboot devices connected to an access point. The jq utility needs to be installed. You can reboot multiple AP’s by putting the IP’s in an ap.lst file.
This release makes using ubntmod.sh much easier. It can now cycle through an infinite number of usernames\/passwords.
Refactored the username password section.
By default, ubntmod.sh will try reading from ubntmod.conf for usernames and passwords.
Added function to create ubntmod.conf file if username\/password is not specified and no config file exist.<\/p>\n\n\n\n
Added ssh-rsa in the HostKeyAlgorithms as recent versions of SSH do not support it by default<\/p>\n\n\n\n
Enabled Remote syslog<\/p>\n\n\n\n
Added -z softrestart option to save changes without rebooting. May not work on all changes.<\/p>\n\n\n\n
Added Password loop option to specify two different passwords
Changed the SNMP deliminating character from , to ;<\/p>\n\n\n\n
Added support for testing if DNS resolves on device, -e option<\/p>\n\n\n\n
Added AirControl provisioning removal, -a option<\/p>\n\n\n\n
# SNMP, changed help info to be correct
# Backups, changed to automatically backup with device name and time stamp. There is a bug where if ubntmod.sh can’t access a radio to do a backup, it’ll create a empty file with the time stamp.<\/p>\n\n\n\n