8
+ − 1
What is Poweradmin ?
+ − 2
-----------------------------------------------------------------------
1
+ − 3
8
+ − 4
Poweradmin is a non - commercial front - end for the PowerDNS nameserver ,
+ − 5
see < http : // www . powerdns . com > . The goal of Poweradmin is to provide a
+ − 6
friendly management interface to the database backend of PowerDNS
+ − 7
which actually holds the DNS records . At this moment , both the mysql
+ − 8
and pgsql are supported . The interface allows add , modify and deletion
+ − 9
of both forward and reverse zones and has full IPv6 support .
1
+ − 10
8
+ − 11
Poweradmin is written by Roeland Nieuwenhuis < trancer @trancer . nl >
+ − 12
and Sjeemz < sjeemz @sjeemz . nl > . It contains patches of Wim Moistry and
+ − 13
Dennis Roos .
1
+ − 14
8
+ − 15
Please see CHANGES for a list of changes , CHANGES . pre - 1.3.0 for a list
+ − 16
of changes prior to 1.3.0 release , README . i18n for information on the
+ − 17
multi language support , README . sequence for information the "sequence
+ − 18
updater" and the insertion of records and zones using other interfaces
+ − 19
than poweradmin .
1
+ − 20
+ − 21
8
+ − 22
Where to get Poweradmin ?
+ − 23
-----------------------------------------------------------------------
1
+ − 24
8
+ − 25
The Poweradmin website can be found at < http : // www . poweradmin . org > .
1
+ − 26
+ − 27
8
+ − 28
Requirements
+ − 29
-----------------------------------------------------------------------
1
+ − 30
8
+ − 31
- PowerDNS , versions 2.1 through 2.9.19 have been tested , others might
+ − 32
work as well . See < http : // www . powerdns . com > .
1
+ − 33
8
+ − 34
- MySQL or PostgreSQL . Both MySQL versions 4 and 5 have been reported
+ − 35
to work , 5.0.22 has been tested .
+ − 36
+ − 37
- A webserver that support PHP 4 or 5. Apache 2.0.55 has been tested .
1
+ − 38
8
+ − 39
- PHP . At least version 4.2.1 . Version 5.1.2 has been tested . It needs
+ − 40
the mysql or pgsql extension , as well has PEAR .
1
+ − 41
8
+ − 42
- PEAR : : MDB2 ( 2.4.0 has been tested ) and PEAR : : MDB2_Driver_mysql
+ − 43
( 1.4.0 has been tested ) or PEAR : : MDB2_Driver_pgsql .
1
+ − 44
+ − 45
8
+ − 46
Installing
+ − 47
-----------------------------------------------------------------------
1
+ − 48
8
+ − 49
Upgrading ? See section "Upgrading" .
+ − 50
+ − 51
- Install PowerDNS with a mysql or pgsql backend .
1
+ − 52
8
+ − 53
- Install MDB2 and MDB2_Driver_mysql ( or pgsql equivalent ) packages of
+ − 54
PEAR . You can install PEAR on a Debian - based server by installing
+ − 55
the package php - pear . Make sure php - cli can access the mysql module
+ − 56
( uncomment the line "extension=mysql.so" in / etc / php5 / cli / php . ini ).
+ − 57
The addional PEAR packages can be installed using the "pear install"
+ − 58
command ( e . g . "pear install MDB2 ; pear install MDB2_Driver_mysql" ).
1
+ − 59
8
+ − 60
- Add a SQL user for poweradmin that is granted SELECT , INSERT ,
+ − 61
DELETE , UPDATE and CREATE actions .
1
+ − 62
8
+ − 63
- Untar and gunzip the poweradmin package in your web dir . This will
+ − 64
create a directory "poweradmin-VERSION" , we will refer to this
+ − 65
directory as "poweradmin/" .
1
+ − 66
8
+ − 67
- In the ' poweradmin / inc " directory the file " config - me . inc . php ".
+ − 68
Edit this file to suit your environment. Then rename this file to
+ − 69
config.inc.php to be able to load the site. The website will not
+ − 70
work properly without a config, so pay attention to your config!
1
+ − 71
8
+ − 72
- Next, go to <http://yourserver/poweradmin/install.php>
1
+ − 73
8
+ − 74
- Fill in the required information to make an administrator login for
+ − 75
your PowerAdmin. If all goes well, the user is added, and you can
+ − 76
log in using that username. Do not forget to remove install.php from
+ − 77
the webdir!
1
+ − 78
8
+ − 79
- Finaly, run <http://yourserver/poweradmin/test_setup.php> to see if
+ − 80
everything is setup correctly. This test also includes the
+ − 81
functionality testing of your PowerDNS records (whether you
+ − 82
have read/write access or not).
1
+ − 83
+ − 84
8
+ − 85
Upgrading from 1.2.7-patched
+ − 86
-----------------------------------------------------------------------
1
+ − 87
8
+ − 88
If you are upgrading from 1.2.7-patched, there is not much you need to
+ − 89
do. The only thing that is needed is install PEAR packages MDB2 and
+ − 90
MDB2_Driver_mysql (or MDB2_Driver_pgsql). This can be done by running
+ − 91
the commands " pear install MDB2 ; pear install MDB2_Driver_mysql ".
+ − 92
Make sure php-cli can access the mysql extension by uncommenting the
+ − 93
line " extension = mysql . so " in / etc / php5 / cli / php . ini
1
+ − 94
+ − 95
8
+ − 96
User levels explained
+ − 97
-----------------------------------------------------------------------
1
+ − 98
8
+ − 99
[ x ] = yes [ ] = no
1
+ − 100
8
+ − 101
User Permission to Permission to Permission to Permission to
+ − 102
Level change own change other create domains add / modify
+ − 103
domain ( s ) domain ( s ) users
1
+ − 104
8
+ − 105
1 [ x ] [ ] [ ] [ ]
+ − 106
5 [ x ] [ x ] [ x ] [ ]
+ − 107
10 [ x ] [ x ] [ x ] [ x ]
1
+ − 108
+ − 109