Documentation - Online

Start the installer

Point your browser to: 

http://your.server.com/<path>/installer/ 

 

 

Login

The default password for the installer is “tupainstall”.

 

 

Step 1 - About

Short descriptions of all the steps of the installer, and legend of the different headers. 

 

 

Step 2 - Change password

For security reasons you should change the password (of course). 

Because the installer password is transfered in plain text, you should also uncomment line 28 (die function) in “installer/index.php” after you finished the installation.

 

 

Step 3 - Check requirements

The installer checks all needed extensions, php settings, directories and files TUPA needs to work. 

All points of extensions, php.ini settings and files have to be OK (green hook).

 

The directories part is a little bit special: 

skins/    Don't has to be writable in RC1 (used for integrated skin manager in later versions)

lang/    Don't has to be writable in RC1 (used for integrated language manager in later versions)

stats/    Has to be writable (Generated statistic graphs are stored there)

stats/db/    Has to be writable by the user which executes the crontab script

    (normally root because it also needs accsess to “pdns_control” to update RRD database)

 

 

Step 4 - Database settings

Insert your database settings and click “Set new config”. 

Choose the database from drop-down list and save again. 

If there is an error check you settings 

 

 

Step 5 - Update database

The needed changes are already preselected. To remove or drop  fields (from other PDNS administration tools) you have to check the statements manually. Go to the bottom of the page and click “Write to database”.

Important: 

If you want to migrate you existing "PowerDNS Administration"- or "PowerAdmin"- installation, don't select the "remove" and "drop" checkboxes before you have migrated your installation!

 

 

Step 6 - Data import/migration (optional)

If you made a fresh PDNS installation without any domains you can skip this step. 

At the moment you can import existing PDNS domains (assigned to admin user), or migrate all data (domains, users and templates) from an existing administration tool. Supported tools are: 

1. PowerAdmin (Tested version: 1.2.7)

2. Power DNS Administration (Tested version: 0.4)

 

To migrate from Bind zone files you have to convert and import them into your pdns database first. There is a program called zone2sql which is part of the PDNS package to convert Bind zone files to SQL statements. ( http://downloads.powerdns.com/documentation/html/migration.html )

After you imported the generated sql file into you database you can use the "Raw PowerDNS"-option in the select box to make them visible in TUPA. 

 

After a successful migration you should update your database again (Step 5) and remove/drop all fields. After that you should only see a “Table and field definitions are OK.” 

Don't forget to uncomment the die function described in Step 2. 

 

Step 7 - Create admin user

On a fresh installation you have to add an admin user to access the TUPA interface. If you have migrated from an existing installation it should be the same user as you used in your old tool (Admin always has id 1 in database table “users”) 

 

 

Step 8 - Logout (Installation finished)

If everything went fine you finished your base TUPA installation. Congratulations! 

 

 

 

- /

7 / 18