====== HowTo Install for OpenSuse ====== ====== 1. Version Info ====== ===== Version Info ===== ^ispCP Version |1.0.6 | ^INSTALL Script|2.1 | ^postinst Script|1.3 | ^Maintainer |Laurent Declercq (Nuxwin) | ^Linux Distros |OpenSuse 11.1 & 11.2 | ^Last Update |04.08.2010 | \\ **ONLY openSUSE VERSIONS 11.1 and 11.2 ARE CURRENTLY SUPPORTED.** \\ **SUPPORT FOR THESE VERSIONS WILL END WITH ispCP ω 1.0.7.** \\ **ONLY openSUSE 11.3 WILL BE SUPPORTED with ispCP ω 1.0.7.** ====== 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 ω) \\ All OpenSuSE 11.1 required packages are listed in ./docs/OpenSuse/opensuse111-packages \\ All OpenSuSE 11.2 required packages are listed in ./docs/OpenSuse/opensuse112-packages \\ Your Server has to be configured to use a resolvable fully qualified domain name. [[howto:hostname|Here]] can you find hoster specific information how to do so. ====== 3. Specific Note ====== For OpenSuse, the "apache2-mod_cband" package has been removed because it is not available. If you want to use, you must compile it yourself. \\ \\ Postfix note: Currently, Postfix does not run in a chroot jail. \\ \\ For ispCP 1.0.6 , we recommend to use OpenSuSE 11.1 due to several issues related to PHP5.3 \\ ====== 4. Installation ====== First, make sure you are logged in as root. \\ ===== 4.1 Untar or unzip the distribution files to a secure directory: ===== # cd /usr/local/src # tar xjvf ispcp-omega-1.0.6.tar.bz2 \\ ===== 4.2 Change to the newly created directory: ===== # cd ./ispcp-omega-1.0.6 \\ ===== 4.3 Install the required repositories: ===== **OpenSuse 11.1 (Recommended for ispCP 1.0.3):** # sh ./docs/OpenSuse/opensuse111-repositories add \\ **OpenSuse 11.2** : # sh ./docs/OpenSuse/opensuse112-repositories add **Note:** For all questions, answer "a" (trust always). \\ ===== 4.4 Install the required packages: ===== **OpenSuse 11.1 (Recommended for ispCP 1.0.6):** # zypper in $(cat ./docs/OpenSuse/opensuse111-packages) \\ **OpenSuse 11.2:** # zypper in $(cat ./docs/OpenSuse/opensuse112-packages) \\ ===== 4.5 Install the required perl packages: ===== **First, update CPAN:** # cpan CPAN \\ **For OpenSuse 11.1 (Recommended for ispCP 1.0.6):** # cpan $(cat ./docs/OpenSuse/opensuse111-perl-packages) \\ **For OpenSuse 11.2:** # cpan $(cat ./docs/OpenSuse/opensuse112-perl-packages) \\ **Note:** every question which is asked in the first run of cpan should be ok to confirm ===== 4.6 (optional) Check ispcp.conf ===== Check the: ./configs/opensuse/ispcp.conf and adapt it to your requirements. \\ ===== 4.7 Build the System by using make: ===== # make -f Makefile.opensuse install \\ ===== 4.8 Copy all the directories into your system (you may make backups before) ===== # cp -RLv /tmp/ispcp/* / \\ ===== 4.9 Start MySQL, if not running: ===== # rcmysql restart \\ ===== 4.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 \\ ===== 4.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 \\ ===== 4.12 Now it's time to set up the frontend. Change into the engine directory and start the engine setup: ===== # cd /srv/www/ispcp/engine/setup # perl ispcp-setup \\ ===== 4.13 Restore /etc/skel ===== # rm -r /etc/skel && mv /etc/skel.bkp /etc/skel \\ ===== 4.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. \\ ===== 4.15 Clean the temporary folders: ===== # rm -fR /tmp/ispcp