Qmailadmin

Contents

About

Qmailadmin is a web-interface interface for managing a Vpopmail-enabled qmail system.
You can delegate control over specific domains to end-users, so that they may manage creation of accounts, changing of passwords,
etc, within limitations set down by the system administrator.

Troubleshooting

Keep in mind when troubleshooting Qmailadmin, or vQadmin, or any other program that
works on top of vpopmail, that sometimes these errors are actually a result of a problem
with the vpopmail configuration, or it's backend authentication systems, rather than
the interface using vpopmail.

Specific errors

Error. Domain example.com was not found in the assign file

This error occurs for a number of reasons. Generally it falls into two categories.
Resource limitations, and permissions problems. This error is actually generated
by the vpopmail library, and not by Qmailadmin, which can make determining the cause
of this error for the end-user slightly more difficult.

First, be sure SELinux is not enabled. Since Qmailadmin requires SetUID properties
to execute, SELinux may quietly deny this to Qmailadmin at execution time. A quick
test for this, is to run the command

# setenforce 0

If that fixes your problem, edit /etc/selinux/config and modify the SELINUX configuration
to read

SELINUX=disabled

If SELinux was enabled, and this did not fix the problem, reboot your mail server and
see if that disables SELinux. If you're still having problems, there may yet be other
permissions problems. Check the following permissions:

If all else fails, it may be a resource issue. If you're using MySQL as a backend, be sure
Qmailadmin is able to contact the MySQL server. Be sure you have enough available resources
for Qmailadmin to open the cdb file.