bgpblist/INSTALL.md

70 lines
1.5 KiB
Markdown
Raw Normal View History

2024-07-17 17:45:00 +00:00
# Installation
2024-07-17 18:19:31 +00:00
**Prerequisites**
2024-07-17 18:25:36 +00:00
This daemon needs PHP, tested with 5.6, 7.4 and 8.2.
It may work with others or may not ;)
It needs php-cli residing in /usr/bin/php.
Also needs the "pcntl" PHP extension and on Linux the "iproute2" package.
2024-07-17 18:19:31 +00:00
2024-07-17 17:53:00 +00:00
**Quick and fast install**
```
git clone https://git.funil.de/sinuspl/bgpblist /opt/bgpblist
cp /opt/bgpblist/etc/default/config.ini /opt/bgpblist/etc/config.ini
cp /opt/bgpblist/etc/systemd/bgpblacklist.service /etc/systemd/system/bgpblacklist.service
systemctl daemon-reload
systemctl enable bgpblacklist.service
systemctl start bgpblacklist.service
```
**Long install with config**
First, checkout the repository:
2024-07-17 17:49:43 +00:00
```
git clone https://git.funil.de/sinuspl/bgpblist /opt/bgpblist
```
2024-07-17 17:06:56 +00:00
2024-07-17 17:53:00 +00:00
Copy the default config to create your own:
2024-07-17 17:49:43 +00:00
```
cp /opt/bgpblist/etc/default/config.ini /opt/bgpblist/etc/config.ini
```
2024-07-17 17:11:13 +00:00
2024-07-17 17:53:00 +00:00
Edit the config.ini, if you are a customer:
2024-07-17 17:49:43 +00:00
```
vim /opt/bgpblist/etc/config.ini
```
If not, dont't edit, it will use the defaults.
2024-07-17 17:11:13 +00:00
2024-07-17 17:53:00 +00:00
Copy the systemd unit file:
2024-07-17 17:49:43 +00:00
```
cp /opt/bgpblist/etc/systemd/bgpblacklist.service /etc/systemd/system/bgpblacklist.service
```
2024-07-17 17:11:13 +00:00
2024-07-17 17:53:00 +00:00
Reload the systemd:
2024-07-17 17:49:43 +00:00
```
systemctl daemon-reload
```
2024-07-17 17:11:13 +00:00
2024-07-17 17:53:00 +00:00
Enable the unit:
2024-07-17 17:49:43 +00:00
```
systemctl enable bgpblacklist.service
```
2024-07-17 17:11:13 +00:00
2024-07-17 17:53:00 +00:00
Start the daemon:
2024-07-17 17:49:43 +00:00
```
systemctl start bgpblacklist.service
2024-07-17 20:12:59 +00:00
```
**Init and not systemd**
There is also an Init version of the script
```
ln -s /opt/bgpblist/etc/init.d/bgpblacklist /etc/init.d/bgpblacklist
```
Use your system's way to enable that, e.g. with "update-rc.d"