[Kea-users] New Project: Kea Quick Config

Wed Aug 2 15:15:48 UTC 2023

Hi Eric,

Sending reply via the mailing list in case others would have similar questions. Hope that is OK. 

To Clarify: Configuration of Kea is the plan for Stork (in fact some preliminary work to configure subnets will be coming in 1.12 which should be released soon - 1.11 introduced configuration of host reservations). This project is NOT a replacement for Stork, nor is it anywhere close to the current functionality of Stork. It has no monitoring or configuration control features. It only can create a simplistic Kea configuration that must be hand copied and installed on the Kea server. Also, it is not an official ISC project and so would not replace any official ISC projects or their planned functionality.

Thank you,

Darren Ankney

----- Original Message -----
From: "Eric Graham" <eric.graham at vantagepnt.com>
To: "Darren Ankney" <dankney at isc.org>
Sent: Wednesday, August 2, 2023 11:04:25 AM
Subject: Re: New Project: Kea Quick Config

Darren, 

I've been under the impression that the Stork project will be updated for this type of functionality. Is that the case? 

Regardless, I'll be taking a look. 

Thank you, 

Eric Graham 
DevOps Specialist 
Direct: 605.990.1859 
[ mailto:eric.graham at vantagepnt.com | Eric.Graham at vantagepnt.com ] 

From: Kea-users <kea-users-bounces at lists.isc.org> on behalf of Darren Ankney <dankney at isc.org> 
Sent: Wednesday, August 2, 2023 9:12 AM 
To: kea-users <kea-users at lists.isc.org> 
Subject: [Kea-users] New Project: Kea Quick Config 
CAUTION: This email originated outside the organization. Do not click any links or attachments unless you have verified the sender. 

Hi all, 

I have created a PHP/javascript based GUI Kea configuration maker which I've called "Kea Quick Config"! 

What does it do? It allows you to use a series of web forms to set parameters. At the end of these "steps", a Kea configuration is generated. You can copy this configuration and use it on your Kea machine. 

What do I need to run it? It can easily be run with only php installed locally. For example, on MacOS: 
1. use Homebrew ( [ https://brew.sh/ | https://brew.sh ] ) to `brew install php` (as php is no longer included in the recent releases of MacOS). 
2. clone the repository locally `git clone [ https://gitlab.isc.org/isc-projects/kea-quick-config.git%60 | 
https://gitlab.isc.org/isc-projects/kea-quick-config.git` ] 
3. cd into `cd kea-quick-config/src/public_html/` 
4. then execute: `php -S localhost:8000` and the software will be available at: [ http://localhost:8000/ | 
http://localhost:8000 ] 

Installation should be even easier in Linux. For example, Debian 11 steps: 
1. Install php `sudo apt install php-cli` (the php package would install apache2 as well when all that is needed is php so we use php-cli here). 
2. clone the repository `git clone [ https://gitlab.isc.org/isc-projects/kea-quick-config.git%60 | 
https://gitlab.isc.org/isc-projects/kea-quick-config.git` ] 
3. enter the directory `cd kea-quick-config/src/public_html/` 
4. execute `php -S localhost:8000` and the software will be available at: [ http://localhost:8000/ | 
http://localhost:8000 ] 

Installation under windows would be similar but you would first need to obtain git ( [ https://git-scm.com/ | https://git-scm.com ] ) and php ( [ https://www.php.net/ | https://www.php.net ] ) 

You CAN run this against an external IP address on your local machine to make it available to other machinery (e.g. `php -S 192.0.2.128:8000`), but this method using "php -S" is not meant for that type of use and may contain security bugs. If you want to host an instance of the site for others to use, an installation of php using apache or similar web software should be considered. 

Where do I find it? It can be found here: [ https://gitlab.isc.org/isc-projects/kea-quick-config | 
https://gitlab.isc.org/isc-projects/kea-quick-config ] Comments are welcome! Functionality is a bit basic at the moment. Reservations and classes are completely absent as well as most options. DHCPv6 is also not yet supported. 

What about support? Please note that this is not an official ISC project and I am not a professional software developer. This should be considered experimental and unsupported. That being said, do feel free to make a gitlab.isc.org account and open an issue in this project if you find a problem or missing feature. There are some open issues there already so do have a look that it isn't already covered. Feel free to indicate your interest with a comment or thumbs up if you find a previously opened issue. Also, you can post to this kea-users list and I'll try to help you as best I can if you are having trouble. 

Hopefully, this helps someone get started with Kea! I'll continue working on it if there is interest. 

Thank you, 

Darren Ankney 
-- 
ISC funds the development of this software with paid support subscriptions. Contact us at [ https://www.isc.org/contact/ | https://www.isc.org/contact/ ] for more information. 

To unsubscribe visit [ https://lists.isc.org/mailman/listinfo/kea-users | https://lists.isc.org/mailman/listinfo/kea-users ] . 

Kea-users mailing list 
Kea-users at lists.isc.org 
[ https://lists.isc.org/mailman/listinfo/kea-users | https://lists.isc.org/mailman/listinfo/kea-users ] 