Skip to content

Commit

Permalink
Update License, Installer Version, Supported Linux Distros
Browse files Browse the repository at this point in the history
  • Loading branch information
muffycompo committed Mar 25, 2017
1 parent 6c8b353 commit dc9f32e
Show file tree
Hide file tree
Showing 4 changed files with 28 additions and 33 deletions.
4 changes: 1 addition & 3 deletions LICENSE
Original file line number Diff line number Diff line change
@@ -1,6 +1,4 @@
MIT License (MIT)

Copyright (c) 2016 Mfawa Alfred Onen
Copyright (c) 2017 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:

Expand Down
44 changes: 18 additions & 26 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,19 @@
RADIUSDesk Installer 1.2.0
RADIUSDesk Installer 1.2.1
===========================
## Introduction
RADIUSDesk Installer is an [Ansible](http://www.ansible.com) powered utility that attempts to simplify the process of getting a working installation of [RADIUSDesk](http://www.radiusdesk.com) on a vanilla/minimal installation of RHEL/CentOS 6.x/7.x and Ubuntu 14.x/15.x/16.x servers.
RADIUSDesk Installer is an [Ansible](http://www.ansible.com) powered utility that attempts to simplify the process of getting a working installation of [RADIUSDesk](http://www.radiusdesk.com) on a vanilla/minimal installation of RHEL/CentOS 6.7/7.x and Ubuntu 14.04/15.10/16.04/16.10 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](http://docs.ansible.com/ansible/intro_installation.html#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**
**RHEL/CentOS 6.7/7.x**

`yum install -y python`

**Ubuntu 14.x/15.x/16.x**
**Ubuntu 14.04/15.10/16.04/16.10**

`apt-get install -y python`

Expand All @@ -22,7 +22,7 @@ RADIUSDesk Installer utilizes the latest version of Ansible and for this you mus

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**
**RHEL/CentOS 6.7/7.x**

```
yum install -y epel-release
Expand All @@ -31,7 +31,7 @@ yum install -y ansible

**Note:** To Manually install EPEL repositories, Visit the [EPEL Wiki](https://fedoraproject.org/wiki/EPEL)

**Ubuntu 14.x/15.x/16.x**
**Ubuntu 14.04/15.10/16.04/16.10**

```
apt-add-repository ppa:ansible/ansible
Expand Down Expand Up @@ -59,23 +59,25 @@ SSH into the local/remote managed node/server at least once to ensure it is adde

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).
#### Installing CoovaChilli [Optional]
RADIUSDesk Installer now has support for [CoovaChilli](https://coova.github.io/) installation. By default, CoovaChilli is not installed with RADIUSDesk as it is an optional component but to install CoovaChilli using RADIUSDesk Installer, edit **`roles/radiusdesk/vars/[OS_Family].yml`** where [OS_Family] can be **Debian** or **RedHat** if you are using Ubuntu or RHEL/CentOS repectively. Change `enable_coovachilli_support: no` to `enable_coovachilli_support: yes` and make sure `coovachilii_lan_if` and `coovachilii_wan_if` match your interface names for **LAN** and **WAN** respectively. Once you are done making the changes, go ahead and run the Installer as describe above and you should have CoovaChilli setup for you.

2. Somewhat modularized, so you can always extend RADIUSDesk installer to support your ever growing environments.
#### Note
Ensure you use a [YAML linter](http://www.yamllint.com/) to check your syntax anytime you make any change to the variable file(s).

3. Support for PPTPD **[Optional]**
## Features
1. RADIUSDesk installer is somewhat modularized, so you can always extend RADIUSDesk installer to support your ever growing environments.

4. Support for CoovaChilli Captive portal **[Optional]**
2. Support for CoovaChilli Captive portal **[Optional]**

5. Support for Dynamic Login Pages **[Optional]**
3. 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**
- **RHEL/CentOS 6.7/7.x**
- **Ubuntu 14.04/15.10/16.04/16.10**

## F.A.Q
1. Why do I get an SSL3 handshake error when running RADIUSDesk Installer on Ubuntu 14.x?
Expand All @@ -89,20 +91,10 @@ SSH into the local/remote managed node/server at least once to ensure it is adde
- 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)](http://www.maomuffy.com/introduction-to-radiusdesk-with-rhelcentos-6-x-mini-course/) by [Mfawa Alfred Onen](http://ng.linkedin.com/in/mfawaalfredonen/)
1. [RADIUSDesk Mini Course (Old)](http://www.maomuffy.com/introduction-to-radiusdesk-with-rhelcentos-6-x-mini-course/) by [Mfawa Alfred Onen](http://maomuffy.com)
2. [RADIUSDesk Project](http://www.radiusdesk.com) by [Dirk van der Walt](http://www.linkedin.com/pub/dirk-van-der-walt/11/b64/79a)
3. [RADIUSDesk Installer Videos](http://www.maomuffy.com/radiusdesk-installer-project/)

## 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.
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.
4 changes: 2 additions & 2 deletions rd-installer
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
#!/bin/bash
# Bash Menu Script Example
# Bash Menu Script for RADIUSDesk Installer
clear
echo ""
RD_VERSION="1.2.0"
RD_VERSION="1.2.1"
RD_TITLE="==== RADIUSDesk Installer $RD_VERSION ===="
TITLE_BYTES=${#rd_title}
UNDERLINE_STRING=$(for ((i=1; i<=$TITLE_BYTES; i++));do printf "%s" "=";done;printf "\n")
Expand Down
9 changes: 7 additions & 2 deletions roles/radiusdesk/tasks/main.yml
Original file line number Diff line number Diff line change
@@ -1,8 +1,13 @@
---
- name: Checking for Supported OS
- name: Checking for Supported Ubuntu Release
fail:
msg="{{ ansible_distribution }} {{ ansible_distribution_version }} is not supported by RADIUSDesk Installer"
when: (ansible_distribution != 'Ubuntu' and (ansible_distribution_release != 'vivid' or ansible_distribution_release != 'trusty' or ansible_distribution_release != 'yakkety' or ansible_distribution_release != 'xenial')) or (ansible_os_family == 'RedHat' and ansible_distribution_version < '6.7')
when: ansible_distribution != 'Ubuntu' or ansible_distribution_release != 'vivid' or ansible_distribution_release != 'trusty' or ansible_distribution_release != 'yakkety' or ansible_distribution_release != 'xenial'

- name: Checking for Supported RHEL/CentOS Release
fail:
msg="{{ ansible_distribution }} {{ ansible_distribution_version }} is not supported by RADIUSDesk Installer"
when: ansible_os_family == 'RedHat' or ansible_distribution_version < '6.7'

- name: Adding RadiusDesk Variables (Ubuntu 14+)
include_vars: "{{ ansible_os_family }}.yml"
Expand Down

0 comments on commit dc9f32e

Please sign in to comment.