docs/README
author rejo
Tue, 10 Jul 2007 21:24:06 +0000
changeset 37 b785e54690ce
parent 8 47dd15d8bb8c
child 52 aa5bae344805
permissions -rw-r--r--
[feladat @ 84] Bugfix. The function zone_count() now also counts zones an owner has only partial access to, not just those zones the owner has full access to. This fixes just the count, the zones a user has partial access to are not (yet!) shown in the "list zones" page. Bugfix. In the zone listing the "edit" button is now show for users with access level 1. Untill now they were presented an overview of the zones they could change, but there was no link for them to actually edit the zone. Bugfix. Some of the buttons in the "edit zone" interface that are of no use to a user with access level 1 have been hidden. Bugfix. Make sure a user with access level 1 with only partial access to a zone cannot add new records to that zone. Only the zone owner should be able to add new record. Bugfix. If a user with access level 1 edits a record in a zone he has only partial access to, an error was shown because of call to a non- existing function in the PEAR:MDB2. This bug was most likely introduced while migrating from PEAR:DB to PEAR:MDB2. Bugfix. A user with access level 1 was able to delete all records of a zone he has only partial access to. Some additional checks have been added. Bugfix. If a user with accees level 1 has partial access to one or more zones starting with a certain character, but did not own at least one entire zone starting with the same character, the character wasn't clickable in the "list zone" page. Interface. If no record or zone id is given for delete_record.php or delete_domain.php, don't just die but echo a nice message. The i18n files have not yet been updated to reflect this change. Interface. If no master IP is given in delete_supermaster.php, don't just die but echo a nice message. The i18n files have not yet been updated to reflect this change. [All fixes by Peter Beernink.]

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]