Parallels H-Sphere Documentation System Administrator Guide


Switching Between cdb and mysql VPopMail Authentication

(H-Sphere 2.4.3 Patch 4 and up)

Related Docs:   H-Sphere Mail

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.

CAUTION: Switching to another authentication mode is a very responsible step! Do it with special care, after you have made a well-weighed decision.

Related Docs:   H-Sphere Mail

© Copyright 2018. Parallels Holdings. All rights reserved.