Minor documentation updates

git-svn-id: https://svn.code.sf.net/p/postfixadmin/code/trunk@10 a1433add-5e2c-0410-b055-b7f2511e0802
postfixadmin-2.3
Greg 17 years ago
parent 69254c67f1
commit 8b26d70ae6

@ -0,0 +1,20 @@
---------------------------------------
The different parts of PostfixAdmin
/admin directory scripts are used by superadmins, also known as 'site admins'.
When you log in as a superadmin you'll be running scripts from /admin that
won't bother checking to see if you are allowed to admin for a domain. As
a superadmin you can add and remove domains, mailboxes, aliases, domain admins,
and create more superadmins. A superadmin will be not stopped from doing
anything, so be careful, you can delete your our login account.
login.php sorts out what type of admin you are and sends you to the right place.
The scripts in / are used by domain admins and always check to see if you are
an admin for the domain (or user within a domain) you are attempting to change.
End user scripts only do operations on the currently logged in user.
If the end user options provide more than you want your users to have,
check the user options in config.inc.php, or, even better, edit the
user templates and remove the options.

@ -0,0 +1,36 @@
------------------------------------
Recreating a superadmin account
The database scripts DATABASE_MYSQL.TXT and DATABASE_PGSQL.TXT create a super admin
of admin@domain.tld, password: admin
With that login you can create new superadmins (and you should delete or change the
password of admin@domain.tld). If that user is no longer there or you didn't use
the .TXT files, you could add another manually from the database. Just use the code
from one of the .TXT files. Do this as root on the MySQL machine:
# mysql
Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 8186 to server version: 5.0.27
Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
mysql> use postfix
Reading table information for completion of table and column names
You can turn off this feature to get a quicker startup with -A
Database changed
mysql> INSERT INTO domain_admins (username, domain, active) VALUES ('new@domain.tld','ALL','1');
Query OK, 1 row affected (0.00 sec)
mysql> INSERT INTO admin (username, password, active) VALUES ('new@domain.tld','$1$0fec9189$bgI6ncWrldPOsXnkUBIjl1','1');
Query OK, 1 row affected (0.00 sec)
mysql> exit
Bye
Then you can log in as new@domain.tld, password: admin

@ -56,6 +56,10 @@ Virtual Domains and Users.
In DATABASE_PGSQL.TXT you can find the table structure for PostgreSQL.
Check out the file first to see what you are about to do, then for MySQL do
something like this:
mysql -u root < DATABASE_MYSQL.TXT
4. Configure
------------
@ -63,13 +67,13 @@ Check the config.inc.php file. There you can specify settings that are
relevant to your setup.
Postfix Admin contains 3 views of administration.
There is the Site Admin view, located at http://domain.tld/postfixadmin/admin/.
There is the Site Admin (aka superadmin) view, located at http://domain.tld/postfixadmin/admin/.
There is the Domain Admin view, located at http://domain.tld/postfixadmin/.
And there is the User Admin View, located at http://domain.tld/postfixadmin/users/.
In order to do the initial configuration you have to go to the Site Admin view.
The default password for the Site Admin view of Postfix Admin is admin/admin.
The default user/password for the Site Admin view of Postfix Admin is admin@domain.tld/admin
This is specified in the .htpasswd file in the /admin directory. Make sure
that the location of the .htpasswd file matches your path.
@ -85,3 +89,7 @@ specified to host Postfix Admin.
-------------------
For more information you can go to the Postfix Admin forums.
http://forums.high5.net/index.php?showforum=22
As of March 2007, PostfixAdmin moved to SourceForge. For the
forum posts and source updates, see:
https://sourceforge.net/projects/postfixadmin

Loading…
Cancel
Save