Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mafredri/vyatta-dhcp-global-option
Add support for configuring dhclient global options on UniFi Security Gateway
https://github.com/mafredri/vyatta-dhcp-global-option
dhclient dhcp security-gateway ubiquiti unifi usg vyatta
Last synced: 8 days ago
JSON representation
Add support for configuring dhclient global options on UniFi Security Gateway
- Host: GitHub
- URL: https://github.com/mafredri/vyatta-dhcp-global-option
- Owner: mafredri
- License: mit
- Created: 2020-05-12T18:07:55.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2020-05-13T19:48:13.000Z (over 4 years ago)
- Last Synced: 2024-10-27T05:47:52.396Z (about 2 months ago)
- Topics: dhclient, dhcp, security-gateway, ubiquiti, unifi, usg, vyatta
- Language: Perl
- Homepage:
- Size: 24.4 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# vyatta-dhcp-global-option
This package adds support for configuring global options for dhclient on UniFi Security Gateway.
## Improvements
- Write configured `global-option`s to e.g. `/var/run/dhclient_eth0.conf`
- Re-generate dhclient config on configuration changes
## Installation
Download the latest release from [Releases](https://github.com/mafredri/vyatta-dhcp-global-option/releases).
```
curl -sSL -o /tmp/dhcp-global-option-0.0.2-1.deb https://github.com/mafredri/vyatta-dhcp-global-option/releases/download/v0.0.2/dhcp-global-option-0.0.2-1.deb
sudo dpkg -i /tmp/dhcp-global-option-0.0.2-1.deb
```
### Automatic restore after firmare upgrade
The UniFi Security Gateway runs a script (`etc/init.d/ubnt-rcS`) after firmware upgrades, it looks for `.deb` packages in `/config/data/firstboot/install-packages` and if there are any, installs them. We can utilize this folder to make sure the package remains installed.
```
mkdir -p /config/data/firstboot/install-packages
mv /tmp/dhcp-global-option-0.0.2-1.deb /config/data/firstboot/install-packages
```
## Example use cases
This package can be used to request custom dhcp option from the dhcp server (e.g. your ISP).
### Enable option-6rd request
Can be configured either via terminal or `config.gateway.json`. Only the latter will persist after firmware upgrades and possibly restarts.
#### Configure via terminal
```
configure
set interfaces ethernet eth0 dhcp-options global-option "option option-6rd code 212 = { integer 8, integer 8, unsigned integer 16, unsigned integer 16, unsigned integer 16, unsigned integer 16, unsigned integer 16, unsigned integer 16, unsigned integer 16, unsigned integer 16, array of ip-address };"
set interfaces ethernet eth0 dhcp-options client-option "also request option-6rd;"
commit
save
```
#### Configure via `config.gateway.json`
```json
{
"interfaces": {
"ethernet": {
"eth0": {
"dhcp-options": {
"global-option": [
"option option-6rd code 212 = { integer 8, integer 8, unsigned integer 16, unsigned integer 16, unsigned integer 16, unsigned integer 16, unsigned integer 16, unsigned integer 16, unsigned integer 16, unsigned integer 16, array of ip-address };"
],
"client-option": [
"also request option-6rd;",
"retry 60;"
]
}
}
},
}
}
```