ispCP ω (OMEGA) HowTo Install for OpenSuse 11.3
================================================================================
For other Linux distributions please check the other INSTALL files.
================================================================================

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

================================================================================
1) Version Info
---------------
ispCP ω Version:    1.0.7
INSTALL file:       2.4
postinst script:    1.0.6
preinst script:     1.0.1
Maintainer:         Laurent Declercq (Nuxwin) <laurent.declercq@ispcp.net>
Homepage:           http://isp-contol.net
Linux Distros:      openSuse 11.3

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

Penitum III or K6-4 with 500 MHz
512 MB RAM
100 MB disk space (only for install of ispCP ω)

================================================================================
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) SiteWide Mail protection solution
------------------------------------

Since ispCP Omega 1.0.7 rc3, both setup and update scripts are able to configure
a complete sitewide mail protection solution using Amavisd-new, SpamAssassin,
ClamAv and some other services such as razor...

If you want activate this solution, you should edit the ispcp.conf file before
install/update ispCP ω Omega to activate the services that are part of this
solution.

You can also disable the mail protection solution by setting the proper values
to 'no' in the ispcp.conf file (ispcp.old.conf when update), and by running
again the ispCP ω Omega update script.

See the comments in the ispcp.conf file for more information.

WARNING: Implementation of this solution is still experimental. You are warned!

================================================================================
5) Installation
---------------
First, make sure you are logged in as root.

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 repositories:

	# sh ./docs/OpenSuse/repositories.sh add

Note: For all questions, answer "a" (trust always).

4. install the required packages:

	First, update your distribution:
	# zypper dup

	# zypper in $(cat ./docs/OpenSuse/bin-packages)

5. Install the required Perl packages:

	First, update CPAN:
	# cpan CPAN

	# cpan $(cat ./docs/OpenSuse/perl-packages)

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

7. Build the System by using make:

	# make -f Makefile.opensuse install

8. Copy all the directories into your system (you may make backups before):

	# cp -RLv /tmp/ispcp/* /

9. Start MySQL, if it not already running:

	# rcmysql restart

10. 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

11. Maybe empty the folder /etc/skel - otherwise you'll have all the
	files/folders in the home folders:

	# cp -a /etc/skel /etc/skel.bkp
	# rm -r /etc/skel && mkdir /etc/skel

12. Now it's time to set up ispCP. Change into the engine directory and start
	the engine setup:

	# cd /srv/www/ispcp/engine/setup
	# perl ispcp-setup

13. Restore /etc/skel:

	# rm -r /etc/skel && mv /etc/skel.bkp /etc/skel

14. 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.

15. Clean the temporary folders:
	# rm -Rf /tmp/ispcp

================================================================================
6) 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 repositories:

	# sh ./docs/OpenSuse/repositories.sh add

Note: For all questions, answer "a" (trust always).

4. Install the required packages:

	# First, update your distribution:
	# zypper dup

	# zypper in $(cat ./docs/OpenSuse/bin-packages)

5. Install the required Perl packages:

	First, update CPAN:
	# cpan CPAN

	# cpan $(cat ./docs/OpenSuse/perl-packages)

6. Stop the ispcp_deamon and build the System by using make:

	# /etc/init.d/ispcp_daemon stop
	# make -f Makefile.opensuse install

7. Backup files:

	# cp -v /srv/www/ispcp/engine/ispcp-db-keys.pl /tmp/ispcp/srv/www/ispcp/engine/
	# cp -v /srv/www/ispcp/engine/messenger/ispcp-db-keys.pl /tmp/ispcp/srv/www/ispcp/engine/messenger/
	# cp -v /srv/www/ispcp/gui/include/ispcp-db-keys.php /tmp/ispcp/srv/www/ispcp/gui/include/
	# cp -v /srv/www/ispcp/gui/themes/user_logos/* /tmp/ispcp/srv/www/ispcp/gui/themes/user_logos/
	# cp -v /srv/www/ispcp/gui/tools/webmail/data/* /tmp/ispcp/srv/www/ispcp/gui/tools/webmail/data/

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

8. Delete old files to avoid security risks:

	# rm -Rf /srv/www/ispcp/engine/
	# rm -Rf /srv/www/ispcp/gui/{admin,client,include,orderpanel,themes,reseller}/
	# rm -Rf /srv/www/ispcp/gui/tools/{pma/,filemanager/,webmail/,index.php}
	# rm -Rf /srv/www/ispcp/gui/{*.php,favicon.ico,robots.txt}

9. Copy /usr, /var and /srv directories into your system (you may make backups):

	# cp -Rv /tmp/ispcp/usr/* /usr/
	# cp -Rv /tmp/ispcp/var/* /var/
	# cp -Rv /tmp/ispcp/srv/* /srv/

10. Backup ispcp.conf and copy the /etc directory into your system (you may make backups):

	# mv -v /etc/ispcp/ispcp.conf /etc/ispcp/ispcp.old.conf
	# cp -Rv /tmp/ispcp/etc/* /etc/

11. Now it's time to update your installation. Change into the engine directory:

	# cd /srv/www/ispcp/engine/setup

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

13. 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.

14. Clean the temporary folders:
	# rm -Rf /tmp/ispcp/

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

1. Change into the engine directory:

	# cd /srv/www/ispcp/engine/setup

2. Start the uninstall script:

	# perl ispcp-uninstall

3. Clean up your system

================================================================================
8) 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!
