docs/README
author rejo
Mon, 13 Aug 2007 22:05:06 +0000
changeset 40 ee5300058c9d
parent 8 47dd15d8bb8c
child 52 aa5bae344805
permissions -rw-r--r--
[feladat @ 87] Bugfix. With user level 5 or 10 and lots of zones without an owner, like slave zones that are inserted by a supermaster, the "list all zones" view was broken (not all zones shown, but "show page" and "show letters" were missing as well). Function zone_count matches zones and domains table, but users with level 5 or 10 are allowed to see zones without an entry in the zones table as well.

What is Poweradmin?
-----------------------------------------------------------------------

Poweradmin is a non-commercial front-end for the PowerDNS nameserver,
see <http://www.powerdns.com>. The goal of Poweradmin is to provide a
friendly management interface to the database backend of PowerDNS
which actually holds the DNS records. At this moment, both the mysql
and pgsql are supported. The interface allows add, modify and deletion
of both forward and reverse zones and has full IPv6 support.

Poweradmin is written by Roeland Nieuwenhuis <trancer@trancer.nl>
and Sjeemz <sjeemz@sjeemz.nl>. It contains patches of Wim Moistry and
Dennis Roos.

Please see CHANGES for a list of changes, CHANGES.pre-1.3.0 for a list
of changes prior to 1.3.0 release, README.i18n for information on the
multi language support, README.sequence for information the "sequence
updater" and the insertion of records and zones using other interfaces
than poweradmin.


Where to get Poweradmin?
-----------------------------------------------------------------------

The Poweradmin website can be found at <http://www.poweradmin.org>.


Requirements
-----------------------------------------------------------------------

- PowerDNS, versions 2.1 through 2.9.19 have been tested, others might
  work as well. See <http://www.powerdns.com>.

- MySQL or PostgreSQL. Both MySQL versions 4 and 5 have been reported
  to work, 5.0.22 has been tested.
  
- A webserver that support PHP 4 or 5. Apache 2.0.55 has been tested.

- PHP. At least version 4.2.1. Version 5.1.2 has been tested. It needs
  the mysql or pgsql extension, as well has PEAR. 

- PEAR::MDB2 (2.4.0 has been tested) and PEAR::MDB2_Driver_mysql
  (1.4.0 has been tested) or PEAR::MDB2_Driver_pgsql.


Installing
-----------------------------------------------------------------------

Upgrading? See section "Upgrading". 

- Install PowerDNS with a mysql or pgsql backend.

- Install MDB2 and MDB2_Driver_mysql (or pgsql equivalent) packages of
  PEAR. You can install PEAR on a Debian-based server by installing
  the package php-pear. Make sure php-cli can access the mysql module
  (uncomment the line "extension=mysql.so" in /etc/php5/cli/php.ini).
  The addional PEAR packages can be installed using the "pear install"
  command (e.g. "pear install MDB2 ; pear install MDB2_Driver_mysql").

- Add a SQL user for poweradmin that is granted SELECT, INSERT,
  DELETE, UPDATE and CREATE actions.

- Untar and gunzip the poweradmin package in your web dir. This will
  create a directory "poweradmin-VERSION", we will refer to this
  directory as "poweradmin/".

- In the 'poweradmin/inc" directory the file "config-me.inc.php".
  Edit this file to suit your environment. Then rename this file to
  config.inc.php to be able to load the site. The website will not
  work properly without a config, so pay attention to your config!

- Next, go to <http://yourserver/poweradmin/install.php>

- Fill in the required information to make an administrator login for
  your PowerAdmin. If all goes well, the user is added, and you can
  log in using that username. Do not forget to remove install.php from
  the webdir!

- Finaly, run <http://yourserver/poweradmin/test_setup.php> to see if
  everything is setup correctly. This test also includes the
  functionality testing of your PowerDNS records (whether you
  have read/write access or not).


Upgrading from 1.2.7-patched
-----------------------------------------------------------------------

If you are upgrading from 1.2.7-patched, there is not much you need to
do. The only thing that is needed is install PEAR packages MDB2 and
MDB2_Driver_mysql (or MDB2_Driver_pgsql). This can be done by running
the commands "pear install MDB2 ; pear install MDB2_Driver_mysql".
Make sure php-cli can access the mysql extension by uncommenting the
line "extension=mysql.so" in /etc/php5/cli/php.ini


User levels explained
-----------------------------------------------------------------------

[x] = yes   [ ] = no

User    Permission to   Permission to  Permission to    Permission to
Level   change own      change other   create domains   add/modify
        domain(s)       domain(s)                       users

 1           [x]             [ ]            [ ]              [ ]
 5           [x]             [x]            [x]              [ ]
 10          [x]             [x]            [x]              [x]