|
52
|
1 |
What is PowerAdmin? |
|
8
|
2 |
----------------------------------------------------------------------- |
|
1
|
3 |
|
|
52
|
4 |
The project's purpose is to create and maintain a friendly web-based DNS |
|
|
5 |
administration tool for the PowerDNS DNS server. The most recent version |
|
|
6 |
has full support for all zone types, support for supermasters, multi- |
|
|
7 |
language support and more. |
|
1
|
8 |
|
|
52
|
9 |
See <https://code.krikkit.nl/trac/poweradmin/wiki/Features> for a list |
|
|
10 |
of features. |
|
1
|
11 |
|
|
52
|
12 |
The original PowerAdmin code was written by Trancer and Sjeemz. This |
|
|
13 |
version ("a complete(r) PowerAdmin) is an adaption by Rejo Zenger. Many |
|
|
14 |
people have contributed to the current code. For a list of contributors, |
|
|
15 |
please see <https://code.krikkit.nl/trac/poweradmin/wiki/Credits>. |
|
1
|
16 |
|
|
|
17 |
|
|
52
|
18 |
Where to get PowerAdmin? |
|
8
|
19 |
----------------------------------------------------------------------- |
|
1
|
20 |
|
|
52
|
21 |
At <https://code.krikkit.nl/trac/poweradmin> you can download the most |
|
|
22 |
recent version. |
|
1
|
23 |
|
|
|
24 |
|
|
8
|
25 |
Requirements |
|
|
26 |
----------------------------------------------------------------------- |
|
1
|
27 |
|
|
8
|
28 |
- PowerDNS, versions 2.1 through 2.9.19 have been tested, others might |
|
|
29 |
work as well. See <http://www.powerdns.com>. |
|
1
|
30 |
|
|
8
|
31 |
- MySQL or PostgreSQL. Both MySQL versions 4 and 5 have been reported |
|
|
32 |
to work, 5.0.22 has been tested. |
|
|
33 |
|
|
|
34 |
- A webserver that support PHP 4 or 5. Apache 2.0.55 has been tested. |
|
1
|
35 |
|
|
8
|
36 |
- PHP. At least version 4.2.1. Version 5.1.2 has been tested. It needs |
|
|
37 |
the mysql or pgsql extension, as well has PEAR. |
|
1
|
38 |
|
|
8
|
39 |
- PEAR::MDB2 (2.4.0 has been tested) and PEAR::MDB2_Driver_mysql |
|
|
40 |
(1.4.0 has been tested) or PEAR::MDB2_Driver_pgsql. |
|
1
|
41 |
|
|
|
42 |
|
|
8
|
43 |
Installing |
|
|
44 |
----------------------------------------------------------------------- |
|
1
|
45 |
|
|
8
|
46 |
Upgrading? See section "Upgrading". |
|
|
47 |
|
|
|
48 |
- Install PowerDNS with a mysql or pgsql backend. |
|
1
|
49 |
|
|
8
|
50 |
- Install MDB2 and MDB2_Driver_mysql (or pgsql equivalent) packages of |
|
|
51 |
PEAR. You can install PEAR on a Debian-based server by installing |
|
|
52 |
the package php-pear. Make sure php-cli can access the mysql module |
|
|
53 |
(uncomment the line "extension=mysql.so" in /etc/php5/cli/php.ini). |
|
52
|
54 |
The additional PEAR packages can be installed using the "pear |
|
|
55 |
install" command. |
|
1
|
56 |
|
|
8
|
57 |
- Add a SQL user for poweradmin that is granted SELECT, INSERT, |
|
|
58 |
DELETE, UPDATE and CREATE actions. |
|
1
|
59 |
|
|
8
|
60 |
- Untar and gunzip the poweradmin package in your web dir. This will |
|
|
61 |
create a directory "poweradmin-VERSION", we will refer to this |
|
|
62 |
directory as "poweradmin/". |
|
1
|
63 |
|
|
8
|
64 |
- In the 'poweradmin/inc" directory the file "config-me.inc.php". |
|
|
65 |
Edit this file to suit your environment. Then rename this file to |
|
|
66 |
config.inc.php to be able to load the site. The website will not |
|
|
67 |
work properly without a config, so pay attention to your config! |
|
1
|
68 |
|
|
8
|
69 |
- Next, go to <http://yourserver/poweradmin/install.php> |
|
1
|
70 |
|
|
8
|
71 |
- Fill in the required information to make an administrator login for |
|
|
72 |
your PowerAdmin. If all goes well, the user is added, and you can |
|
|
73 |
log in using that username. Do not forget to remove install.php from |
|
|
74 |
the webdir! |
|
1
|
75 |
|
|
8
|
76 |
- Finaly, run <http://yourserver/poweradmin/test_setup.php> to see if |
|
|
77 |
everything is setup correctly. This test also includes the |
|
|
78 |
functionality testing of your PowerDNS records (whether you |
|
|
79 |
have read/write access or not). |
|
1
|
80 |
|
|
|
81 |
|
|
8
|
82 |
Upgrading from 1.2.7-patched |
|
|
83 |
----------------------------------------------------------------------- |
|
1
|
84 |
|
|
8
|
85 |
If you are upgrading from 1.2.7-patched, there is not much you need to |
|
|
86 |
do. The only thing that is needed is install PEAR packages MDB2 and |
|
|
87 |
MDB2_Driver_mysql (or MDB2_Driver_pgsql). This can be done by running |
|
|
88 |
the commands "pear install MDB2 ; pear install MDB2_Driver_mysql". |
|
|
89 |
Make sure php-cli can access the mysql extension by uncommenting the |
|
|
90 |
line "extension=mysql.so" in /etc/php5/cli/php.ini |
|
1
|
91 |
|
|
|
92 |
|
|
8
|
93 |
User levels explained |
|
|
94 |
----------------------------------------------------------------------- |
|
1
|
95 |
|
|
8
|
96 |
[x] = yes [ ] = no |
|
1
|
97 |
|
|
8
|
98 |
User Permission to Permission to Permission to Permission to |
|
|
99 |
Level change own change other create domains add/modify |
|
|
100 |
domain(s) domain(s) users |
|
1
|
101 |
|
|
8
|
102 |
1 [x] [ ] [ ] [ ] |
|
|
103 |
5 [x] [x] [x] [ ] |
|
|
104 |
10 [x] [x] [x] [x] |
|
1
|
105 |
|
|
|
106 |
|