powerdns-admin/docs/wiki/install/Running-PowerDNS-Admin-on-Centos-7.md
2022-12-08 13:13:05 -04:00

2.9 KiB

NOTE: If you are logged in as User and not root, add "sudo", or get root by sudo -i.

Remove old Python 3.4
If you had it installed because of older instructions

yum remove python34*
yum autoremove

Install required packages

Install needed repositories:

yum install epel-release
yum install https://repo.ius.io/ius-release-el7.rpm https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm

Install Python 3.6 and tools

yum install python3 python3-devel python3-pip
pip3.6 install -U pip
pip install -U virtualenv

Install required packages for building python libraries from requirements.txt file

--> NOTE: I am using MySQL Community server as the database backend.
          So `mysql-community-devel` is required. For MariaDB,
          and PostgreSQL the required package will be different.

If you use MariaDB ( from MariaDB repositories )

yum install gcc MariaDB-devel MariaDB-shared openldap-devel xmlsec1-devel xmlsec1-openssl libtool-ltdl-devel

If you use default Centos mariadb (5.5)

yum install gcc mariadb-devel openldap-devel xmlsec1-devel xmlsec1-openssl libtool-ltdl-devel

Install yarn to build asset files + Nodejs 14

curl -sL https://rpm.nodesource.com/setup_14.x | bash -
curl -sL https://dl.yarnpkg.com/rpm/yarn.repo -o /etc/yum.repos.d/yarn.repo
yum install yarn

Checkout source code and create virtualenv

NOTE: Please adjust /opt/web/powerdns-admin to your local web application directory

git clone https://github.com/PowerDNS-Admin/PowerDNS-Admin.git /opt/web/powerdns-admin
cd /opt/web/powerdns-admin
virtualenv -p python3 flask

Activate your python3 environment and install libraries:

. ./flask/bin/activate
pip install python-dotenv
pip install -r requirements.txt

Running PowerDNS-Admin

NOTE: The default config file is located at ./powerdnsadmin/default_config.py. If you want to load another one, please set the FLASK_CONF environment variable. E.g.

export FLASK_CONF=../configs/development.py

Then create the database schema by running:

export FLASK_APP=powerdnsadmin/__init__.py
flask db upgrade

Also, we should generate asset files:

yarn install --pure-lockfile
flask assets build

Now you can run PowerDNS-Admin by command:

./run.py

Open your web browser and access to http://localhost:9191 to visit PowerDNS-Admin web interface. Register an user. The first user will be in Administrator role.

At the first time you login into the PDA UI, you will be redirected to setting page to configure the PDNS API information.

Note: For production environment, i would recommend you to run PowerDNS-Admin with gunicorn or uwsgi instead of flask's built-in web server, take a look at WIKI page to see how to configure them.