Manual:Upgrading
From VHCP Support
Upgrading from VHCS 2.4.7.1 to VHCP 0.0.1
HOWTO Update VHCS 2.4.7.1 to VHCP 0.0.1 (English)
This content is included as text file in source package!
General Information
1) Download the newest VHCP release :
wget http://heanet.dl.sourceforge.net/sourceforge/vhcp/vhcp-0.0.1.tar.bz2
2) Turn off the VHCP Daemon:
/etc/init.d/vhcp_daemon stop
3) Make a backup of the current VHCP files of your system:
mv /var/www/vhcp/gui/ /var/www/vhcp/gui_bcp_yyyymmdd mv /var/www/vhcp/engine/ /var/www/vhcp/engine_bcp_yyyymmdd
4) Unpack the downloaded archive :
tar -xjf vhcp-0.0.1.tar.bz2
vhcp.conf Update
1) Change these following lines:
?BuildDate = 03.01.2006
Version = 2.4.7.1
VersionH = 2.4.7.1 Orpheus
VHCP_LICENSE = VHCP® Pro v2.4.7.1
build: 2006-01-03
Orpheus
Postfix master.cf update
1) Edit /etc/postfix/master.cf
and search for the vhcp-arpl line (near the end) replace the flags=D to flags=O The complete line should look like this:
vhcp-arpl unix - n n - - pipe flags=O user=vmail argv=/var/www/vhcp/engine/messager/vhcp-arpl-msgr
Engine Update
1) Copy the new engine files
cp -a /mydir/engine/ /var/www/vhcp/
2) Copy your crypt key from the old /engine_bcp_yyyymmdd/vhcp-db-keys.pl to /engine/vhcp-db-keys.pl
cp /var/www/vhcp/engine_bcp_yyyymmdd/vhcp-db-keys.pl /var/www/vhcp/engine/vhcp-db-keys.pl
3) Copy your crypt key from the old /engine_bcp_yyyymmdd/vhcp-db-keys.pl to /engine/messager/vhcp-db-keys.pl
cp /var/www/vhcp/engine_bcp_yyyymmdd/vhcp-db-keys.pl /var/www/vhcp/engine/messager/vhcp-db-keys.pl
Backup Engine Update
1) Check and maybe change the crontab line for the backup
crontab -e
if line looks like:
/var/www/vhcp/engine/tools/vhcp-backup-all yes &>/var/log/vhcp/vhcp-backup-all-mngr.log
change it too:
/var/www/vhcp/engine/backup/vhcp-backup-all yes &>/var/log/vhcp/vhcp-backup-all-mngr.log
Don't forget to make the same modification to your /etc/vhcp/crontab/working/crontab.conf file !! Mailbox Engine Update
1) because of a bug in the catchall adresses we have to rebuild the /etc/postfix/vhcp/aliases
mv /etc/vhcp/postfix/working/aliases /etc/vhcp/postfix/working/aliases-SAVE cp /mydir/configs/postfix/working/aliases /etc/vhcp/postfix/working/aliases
Delete unneeded engine file
rm /var/www/vhcp/engine/setup/vhcp-cfg-subst
Finish Engine Updates
1) Set correct engine permissions:
/var/www/vhcp/engine/setup/set-engine-permissions.sh
GUI Update
1) Copy the new GUI files
cp -a /mydir/gui/ /var/www/vhcp/
2) Copy your crypt key from the old /gui_bcp_yyyymmdd/include/vhcp-db-keys.php to /gui/include/vhcp-db-keys.php
cp /var/www/vhcp/gui_bcp_yyyymmdd/include/vhcp-db-keys.php /var/www/vhcp/gui/include/vhcp-db-keys.php
3) Set correct gui permissions:
/var/www/vhcp/engine/setup/set-gui-permissions.sh
Database Update
1) Updated languages completely by importing the languages.sql For example with phpmyadmin or over commandline. All languages are changed. Please use languages.sql because it's the only way to update lang_english which is not update-able by language file. languages.sql is located in:
configs/database/languages.sql
2) Delete all wrong added and not shown catchalls for alias domains
DELETE FROM `vhcp`.`mail_users` WHERE `sub_id`='0' AND `mail_type` = 'alias_catchall';
3) Change status for all mail-addresses:
UPDATE `vhcp`.`mail_users` SET `status` = 'change' WHERE `status` = 'ok';
1) Now you should execute the VHCP engine manually, because users/customers may have made system changes during your update operation This could take a moment!
/var/www/vhcp/engine/vhcp-rqst-mngr
2) Now you can start the VHCP daemon
/etc/init.d/vhcp_daemon start
VHCP is now successfully updated !
