ispCP ω (OMEGA) HowTo Install for Debian Lenny, Squeeze
================================================================================
For other Linux distributions please check the other INSTALL files.
================================================================================

Table of Content
================
1) Version Info
2) Requirements
3) Introduction
4) Installation
5) Update
6) Uninstall
7) Credits

================================================================================
1) Version Info
---------------
ispCP ω Version: 	1.0.7
INSTALL Script:		2.8
Maintainer:			Benedikt Heintel
Homepage:			http://www.isp-contol.net
Linux Distros:		Debian Lenny, Squeeze

================================================================================
2) Requirements
---------------
There is no must have for a system using ispCP ω. This is only a recommendation:

Pentium III or K6-4 with 500 MHz
512 MB RAM
100 MB disk space (only for install of ispCP ω)
Debian (or even any other *NIX-Distribution)

All Lenny required packages are listed in ./docs/Debian/debian-packages-lenny
All Squeeze required packages are listed in ./docs/Debian/debian-packages-squeeze

================================================================================
3) Introduction
---------------
ispCP ω delivers a complete hosting automation appliance by offering significant
security, total-cost-of-ownership, and performance advantages over competing
commercial solutions.

With ispCP ω you can configure your server and applications, create user with
domains with a few point-and-click operations that take less than a minute.
There is no limit to the number of resellers, users and domains that can be
created. The core of ispCP ω are 3 easy-to-use, web-based control panels. ispCP
provides graphic user interfaces for the administrators, resellers and users.

================================================================================
4) Installation
---------------
Make sure you are logged in as root and MySQL is running.

1. Untar or unzip the distribution files to a secure directory:
	# cd /usr/local/src
	# tar xjvf ispcp-omega-1.0.7.tar.bz2

2. Change to the newly created directory:
	# cd ./ispcp-omega-1.0.7

3. Install the required packages

   First update your system:
	# aptitude update && aptitude safe-upgrade

   Make sure you have added the non-free into your /etc/apt/sources.list:

   Lenny:
	deb     http://ftp.debian.org/debian/	lenny main contrib non-free
	deb     http://security.debian.org/	lenny/updates main contrib non-free

   Squeeze:
  	deb     http://ftp.debian.org/debian/	squeeze	main contrib non-free
	deb     http://security.debian.org/	squeeze/updates main contrib non-free

   Install all required packages:

	# aptitude install lsb-release
	# aptitude install $(cat ./docs/Debian/debian-packages-`lsb_release -cs`)

	(if you get to the courier screen select 'no' to web directories)
	(if you get to the postfix screen select 'internet site'. 'mail name' should
	be the server's domain. If you've set debian up correctly on install your
	domain should be already shown.)
	(if you get to the proftpd screen, select 'standalone')

4. (optional) Check the ispcp.conf and adapt it to your requirements.

5. Build the Software by using make:
	# make install

6. Copy all the directories into your system. If you have not yet, now is a good
   time to make backups of your server. The following steps do fundamental
   changes to your system configuration.
	# cp -R /tmp/ispcp/* /

7. Change or create MySQL root password, remove anonymous users, disallow root
	login remotely, remove test database (and access to it), reload privilege tables.
	# mysql_secure_installation

8. Now it's time to set up the frontend. Change into the engine directory and
	start the engine setup:
	# cd /var/www/ispcp/engine/setup
	# perl ispcp-setup

9. Install ispCP ω step-by-step

	If you get no error, all went good; if you get one, look at
	http://isp-control.net to solve the problem.

10. Clean the temporary folders:
	# rm -fR /tmp/ispcp/

================================================================================
5) Update
---------
NOTE: ispCP ω can only be updated from post 1.0.0. If you have a
version prior 1.0.0 (final release) installed, update to ispCP ω 1.0.0 first.

Make sure you are logged in as root and MySQL is running.

1. Untar or unzip the distribution files to a secure directory:
	# cd /usr/local/src
	# tar xjvf ispcp-omega-1.0.7.tar.bz2

2. Change to the newly created directory:
	# cd ./ispcp-omega-1.0.7

3. Install the required packages

   First update your system:
	# aptitude update && aptitude safe-upgrade

   Make sure you have added the non-free into your /etc/apt/sources.list:

   Lenny:
	deb     http://ftp.debian.org/debian/	lenny main contrib non-free
	deb     http://security.debian.org/	lenny/updates main contrib non-free

   Squeeze:
  	deb     http://ftp.debian.org/debian/	squeeze	main contrib non-free
	deb     http://security.debian.org/	squeeze/updates main contrib non-free

   Install all required packages:

	# aptitude install lsb-release
	# aptitude install $(cat ./docs/Debian/debian-packages-`lsb_release -cs`)

	(if you get to the courier screen select 'no' to web directories)
	(if you get to the postfix screen select 'internet site' and then type 'root'
	for mail. If you've set debian up correctly on install your domain should be
	already on screen. Select 'no' to force sync updates.)
	(if you get to the proftpd screen, select 'standalone')
	(if you get to the rootkithunter screen, select two time 'yes')

4. Stop the ispcp_deamon and build the Software by using make:
	# /etc/init.d/ispcp_daemon stop
	# make install

5. Backup files
	# cp -v /var/www/ispcp/engine/ispcp-db-keys.pl /tmp/ispcp/var/www/ispcp/engine/
	# cp -v /var/www/ispcp/engine/messenger/ispcp-db-keys.pl /tmp/ispcp/var/www/ispcp/engine/messenger/
	# cp -v /var/www/ispcp/gui/include/ispcp-db-keys.php /tmp/ispcp/var/www/ispcp/gui/include/
	# cp -v /var/www/ispcp/gui/themes/user_logos/* /tmp/ispcp/var/www/ispcp/gui/themes/user_logos/
	# cp -TRv /var/www/ispcp/gui/domain_default_page /tmp/ispcp/var/www/ispcp/gui/domain_default_page
	# cp -v /var/www/ispcp/gui/tools/webmail/data/* /tmp/ispcp/var/www/ispcp/gui/tools/webmail/data/

	For ispCP Omega prior version 1.0.7 RC2
	# cp -v /var/www/ispcp/gui/tools/pma/config.inc.php /tmp/ispcp/etc/ispcp/pma/working/

6. Delete old files to avoid security risks:
	# rm -Rf /var/www/ispcp/engine/
	# rm -Rf /var/www/ispcp/gui/{admin,client,include,orderpanel,themes,reseller}/
	# rm -Rf /var/www/ispcp/gui/tools/{pma/,filemanager/,webmail/,index.php}
	# rm -Rf /var/www/ispcp/gui/{*.php,favicon.ico,robots.txt}

7. Copy /usr and /var directories into your system (you may make backups)
	# cp -R /tmp/ispcp/usr/* /usr/
	# cp -R /tmp/ispcp/var/* /var/

8. Backup ispcp.conf and copy the /etc directory into your system (you may make
   backups):
	# mv /etc/ispcp/ispcp.conf /etc/ispcp/ispcp.old.conf
	# cp -R /tmp/ispcp/etc/* /etc/

9. Now it's time to update your installation. Change into the engine directory:
	# cd /var/www/ispcp/engine/setup

10. Start the engine update:
	# perl ispcp-update

11. Update ispCP ω step-by-step

	If you get no error, all went good; if you get one, look at
	http://isp-control.net to solve the problem.

12. Clean the temporary folders:
	# rm -fR /tmp/ispcp/

================================================================================
6) Uninstall
------------
Make sure you are logged in as root and MySQL is running.

1. Change into the engine directory:
	# cd /var/www/ispcp/engine/setup

2. Start the uninstall script:
	# perl ispcp-uninstall

3. Clean up your system

================================================================================
7) Credits
----------

ispCP ω is a project of ispCP | isp Control Panel.
ispCP, ispCP ω, isp Control Panel, the ispCP logo and the ω Logo are trademarks
of the ispCP | isp Control Panel Project Team.

Please visit our site under http://isp-control.net for further information on
ispCP ω, ispCP and other themes.

We hope you enjoy using ispCP ω. If you like it, help us, to make it better. We
would be glad on any help provided!
