Step-By-Step Tutorial:VHCP Setup

From VHCP Support

Jump to: navigation, search

VHCP Setup

Apt Repository


Login as a root to your new system. Edit /etc/apt/sources.list and add following line there (vi is a text-editor):

 deb http://debian.vhcp.org/sarge unstable main

Update apt-get

 apt-get update


Preparing system

Install mysql-server and mysql-client and insert mysql root password

 apt-get install mysql-server mysql-client

mysqladmin -u root password 'NewPasswordGoesHere(apostrophes reqd)'


Installation

Notice! These setup screenshots are taken from VHCS 2.4.6.2 installation, they could match with VHCP 0.0.1 also.

And now we can install VHCP system:

 apt-get install vhcp*

Setup asks some questions about Postfix / courier, you can select defaults to proceed to VHCP installation:

Image:Vhcssetup1.jpg


Select a hostname for your VHCP system:

Image:Vhcssetup2.jpg


Insert your IP-address:

Image:Vhcssetup3.jpg


Insert your mail address where you want VHCP logs to be sent:

Image:Vhcssetup4.jpg


Select Automatic way to database configuration:

Image:Vhcssetup5.jpg


Select if you want to drop database on purge (that means when uninstalling vhcp, database gets removed too):

Image:Vhcssetup6.jpg


Selecting vhcp database username (you can use the default one):

Image:Vhcssetup7.jpg


Selecting vftp database username (you can use the default one here too):

Image:Vhcssetup8.jpg


Select password for vftp user (you can leave this empty, random password will be generated):

Image:Vhcssetup9.jpg


Insert your secondary DNS address:

Image:Vhcssetup10.jpg


Enter your SASL domain:

Image:Vhcssetup11.jpg


Enter the username for VHCP admin account:

Image:Vhcssetup12.jpg


Enter the password for VHCP admin account (if you have problems here, leave this empty now.. default password will be "vhcp-admin" then):

Image:Vhcssetup13.jpg


System starts to configure packages now. When installation asks about overwriting old configs, select Yes.

Installation is now finished!

You can login to your new VHCP system from http://<yourdomain.tld>/webadmin/. Login as a user admin and password vhcp-admin.

Notice! Remember to change admin password to something else!


Reconfiguring / Uninstalling

If you want to do reconfiguring to VHCP system, just type:

 dpkg-reconfigure vhcp

VHCP can be uninstalled with:

 apt-get remove vhcp

If you want to delete all files related to VHCP, type:

 dpkg --purge vhcp
Personal tools