RADIUSDesk Installer 1.2.0

Introduction

RADIUSDesk Installer is an Ansible powered utility that attempts to simplify the process of getting a working installation of RADIUSDesk on a vanilla/minimal installation of RHEL/CentOS 6.x/7.x and Ubuntu 14.x/15.x/16.x servers.

Prerequisite

1] Install Python

As of the time of this writing, Python 3 is not supported by Ansible so please take note. Managed Node Requirements

To Install Python which should come by default in most Linux distributions, you can use your package manager:

RHEL/CentOS 6.x/7.x

yum install -y python

Ubuntu 14.x/15.x/16.x

apt-get install -y python

2] Install Ansible 1.9+

RADIUSDesk Installer utilizes the latest version of Ansible and for this you must ensure you have at least Ansible 1.9 and above for the Installer to work as intended.

To Install Ansible, use your package manager and if your distribution comes with an older version of Ansible check the following steps to install the latest Ansible package:

RHEL/CentOS 6.x/7.x

yum install -y epel-release
yum install -y ansible

Note: To Manually install EPEL repositories, Visit the EPEL Wiki

Ubuntu 14.x/15.x/16.x

apt-add-repository ppa:ansible/ansible
apt-get update
apt-get install -y ansible

3] Add Managed Node(s) to SSH Known Hosts list of the Conrol Node

SSH into the local/remote managed node/server at least once to ensure it is added to the control node/server SSH known_host file.

ssh root@localhost or ssh root@192.168.23.101

Using RADIUSDesk Installer

Clone the Installer from GitHub

git clone https://github.com/muffycompo/radiusdesk-installer

Note: If you don't have git installed, make sure you do so before cloning the Installer. Use your package manager to install git; yum install -y git on RHEL/CentOS or apt-get install -y git on Ubuntu.

Run the Installer

1. By default, the installer will setup RADIUSDesk on the server you are currently running the installer from i.e. localhost. To change that and use a remote server (on your network or in the cloud), edit the servers file in the installer's directory; cd radiusdesk-installer; vi servers. You can create a new host group as per Ansible's guide or modify the sample groups in the servers file. If you have modified the servers file and created a new group, also remember to edit the rd-installer-ansible.yml and ensure the hosts uses your newly created server group from the previous step.

2. RADIUSDesk Installer requires root privileges to ensure it installs packages and configure your servers properly. Login as the root user or a user with sudo privileges. Run the installer and select I or 1 to start provisioning your server with RADIUSDesk. cd radiusdesk-installer; ./rd-installer

3. Grab yourself a Cup of Coffee as the installer provisions your server with RADIUSDesk and reboot the server to ensure everything is persistent on reboot [Optional].

Features

1. RADIUSDesk installer is Customizable (Edit roles/radiusdesk/vars/Debian.yml or roles/radiusdesk/vars/RedHat.yml depending on your Operating System family like Debian, RedHat etc). Note: ensure you use a YAML linter to check your syntax anytime you make any change to the variable file(s).

2. Somewhat modularized, so you can always extend RADIUSDesk installer to support your ever growing environments.

3. Support for PPTPD [Optional]

4. Support for CoovaChilli Captive portal [Optional]

5. Support for Dynamic Login Pages [Optional]

Compatibility

1. RADIUSDesk Installer is Compatible with Ansible 1.9+

2. RADIUSDesk Installer has been tested on the following Linux Distros:

   • RHEL/CentOS 6.x/7.x
   • Ubuntu 14.x/15.x/16.x

F.A.Q

1. Why do I get an SSL3 handshake error when running RADIUSDesk Installer on Ubuntu 14.x?
   • Ubuntu 14.x comes with python 2.7.6 and will need to be upgraded to 2.7.9+ as follows:

   sudo apt-add-repository ppa:fkrull/deadsnakes-python2.7
   sudo apt-get update
   sudo apt-get upgrade
   

2. Why does RADIUSDesk Installer fail to start MySQL and FreeRADIUS on CentOS by showing a connection error?
   • Usually, this is caused by having SELinux enabled or iptables running the default rules. Make sure SELinux is set to Permissive (setenforce 0) or disabled (vi /etc/sysconfig/selinux)

Resources

1. RADIUSDesk Mini Course (Old) by Mfawa Alfred Onen
2. RADIUSDesk Project by Dirk van der Walt
3. RADIUSDesk Installer Videos

Contributions

1. Anyone is welcome to contribute by sending a pull request with your desired feature tested and implemented.
2. If you have tested the installer in a Linux Distribution that is not in the compatibility list, kindly send an email to muffycompoqm[at]gmail[dot]com.

Copyright and License

Copyright (c) 2016 Mfawa Alfred Onen

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.