Last modified: 27 Dec 2007
WARNING: This documentation covers Parallels H-Sphere versions up to 3.1. For the latest up-to-date Parallels H-Sphere documentation, please proceed to the
official Parallels site.
Since 2.4.3 Patch 4, H-Sphere provides the possibility to switch between the default cdb VPopMail authentication type to
the authentication via MySQL.
H-Sphere uses the authswitch vpopmail script for switching between authentication modes:
Usage: /hsphere/local/config/mail/scripts/authswitch [ -h ] -t cdb|mysql
For example, to switch from cdb to mysql authentication mode, run:
/hsphere/local/config/mail/scripts/authswitch -t mysql
The script performs the following changes:
- It changes vpopmail-related binaries to the binaries providing new type of authorization.
After the hsphere-mail-service update, 2 variants of binaries would appear in the vpopmail and qmail bin directories:
main_binary.cdb for cdb authorization type and main_binary.mysql for MySQL authorization type.
The authswitch creates main binaries as hard links to corresponding .cdb or .mysql binaries
for the selected authorization mode.
- It converts authorization files into new format.
Switching to another authentication mode is a very responsible step! Do it with special care, after you have made
a well-weighed decision.