Ansible role for installing UniFi Controller for Ubiquiti Access Points on RHEL/Centos/Amazon/etc
Go to file
2016-06-14 18:37:15 -07:00
defaults Changing from Ansbile Playbook to Galaxy Role 2016-06-14 13:24:23 -07:00
files Changing from Ansbile Playbook to Galaxy Role 2016-06-14 13:24:23 -07:00
handlers Changing from Ansbile Playbook to Galaxy Role 2016-06-14 13:24:23 -07:00
meta Adding Galaxy support for Amazon and Fedora 2016-06-14 16:34:51 -07:00
tasks Adding SSL cert support 2016-06-14 18:37:15 -07:00
templates Updating to a working state 2016-06-14 16:17:13 -07:00
vars Adding SSL cert support 2016-06-14 18:37:15 -07:00
.gitignore Changing from Ansbile Playbook to Galaxy Role 2016-06-14 13:24:23 -07:00
LICENSE Initial commit 2014-05-27 11:21:46 +10:00
README.md Adding SSL cert support 2016-06-14 18:37:15 -07:00

UniFi Controller for RHEL (yum-based distros)

Ansible Galaxy role for installing UniFi Controller software for Ubiquiti Access Points on RedHat/Centos/Amazon/Fedora and other yum-based distros.

WARNING: This has only been tested on Amazon Linux so far, and may have issues in /etc/yum.repos.d/mongodb-org-3.2.repo for Fedora (probably need to use the /redhat/ mongo repo.) If you install this on any other distro besides Amazon Linux please comment with your experiences.

Forked from https://github.com/fukawi2/unifi-controller-rhel and modified to be an includable role via Galaxy instead of a playbook.

Requirements

  • Ubiquiti's license does not allow redistribution of the software ZIP, so you must manually download the ZIP of the UniFi Controller software from the Ubiquiti website and save it to files/UniFi.unix.zip. The most recent tested version is "UniFi v5.0.6 Zip for DIY Unix/Linux" from 2016-06-01. If you are including this role via Galaxy, you may download this file to your playbook's files directory instead of this role's files directory; you may also download to an arbitrary folder in your playbook and specify the relative path in the variable.
  • You may need the EPEL Repository from Fedora Project enabled for some packages, however Mongo is installed directly from mongo.org so try running without first.

Role Variables

  • unifi_controller_rhel_ntp_server (optional) sets your preferred NTP server for the UniFi APs to use (default: pool.ntp.org)
  • unifi_controller_rhel_ssl_bundle (optional) provides an alternate SSL CA certificate bundle/chain for the Controller to use. (default: none)
  • unifi_controller_rhel_ssl_cert (optional) provides an alternate SSL certificate for the Controller to use. (default: none)
  • unifi_controller_rhel_ssl_key (optional) provides an alternate SSL key for the Controller to use. (default: none)
  • unifi_controller_rhel_unifi_zip_file (optional) sets the filename of the UniFi controller software on the Ansible system, can be a path relative to your playbook like roles/my_other_role/downloads/Unifi.unix.zip (default: UniFi.unix.zip)

Dependencies

n/a

Example Playbook

First, install this role via Galaxy by typing sudo ansible-galaxy install zyphlar.unifi_controller_rhel

Then create and run an Ansible playbook like this:

- hosts: your_unifi_controllers
  become: true
  roles:
    - zyphlar.unifi_controller_rhel

Or, if you want to override some variables:

- hosts: your_unifi_controllers
  become: true
  roles:
    - some_other_role
    - role: zyphlar.unifi_controller_rhel
      unifi_controller_rhel_unifi_zip_file: UniFi.unix.5.0.6.zip

License

BSD

Support

There is none. Tested on CentOS 6 x86_64. Not tested on animals.

Your results may vary. Discontinue use and see a doctor if rash occurs.

Author Information

TODO

Possibly open up ports in iptables if it's enabled by default in some distros:

-A INPUT -m state --state NEW -m tcp -p tcp --dport 8081 -j ACCEPT
-A INPUT -m state --state NEW -m tcp -p tcp --dport 8080 -j ACCEPT
-A INPUT -m state --state NEW -m tcp -p tcp --dport 8443 -j ACCEPT
-A INPUT -m state --state NEW -m tcp -p tcp --dport 8843 -j ACCEPT
-A INPUT -m state --state NEW -m tcp -p tcp --dport 8880 -j ACCEPT
-A INPUT -m state --state NEW -m tcp -p tcp --dport 27117 -j ACCEPT

# service iptables restart