ispCP ω (OMEGA) HowTo Install for FreeBSD
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.0
INSTALL Script : 4.0
Maintainer :
Homepage : http://www.isp-contol.net
Distros : FreeBSD
================================================================================
2) Requirements
---------------
There is no must have for a system using ispCP ω. This is on
Pentium III or K6-4 with 500 MHz
512 MB RAM
100 MB disk space (on
Debian (or even any other *NIX-Distribution)
All FreeBSD required packages are listed in docs/FreeBSD/freebsd-packages
================================================================================
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
and Name Server rndc.key has been setup.
1. Untar or unzip the distribution files to a secure directory:
# cd /root
# tar xjvf ispcp-omega-1.0.0.tar.bz2
2. Change to the newly created directory:
# cd ./ispcp-omega-1.0.0
3. Install the required modules
# cd /usr/ports/ports-mgmt/portmaster
# make install clean
# rehash
# portmaster $(cat ./docs/FreeBSD/freebsd-packages)
Apache22 Options
x threads option
x mysql option
x suexec ( Recomended )
+ mod_cband for bandwitdh management
o mod_php WARNING: security risk for hosting
+ mod_fastcgi ( choice for improving security )
+ mod_fcgid ( choice for improving security )
+ mod_proxy for awstats
Proftpd Options
x IPV6 IP v6 support ( but disable by ispCP )
x mysql Database module
x quota quota module
x ratio ratio module
x ctrls control module
- delay Not Available in ports ?
- ctrls_admin Not Available in ports ?
courier-imap Options
x userdb For use with userdb ( ispCP default )
x mysql For use with mysql
courier-authlib Options
x userdb
x mysql
Perl Options
+ Compress-Zlib
+ Crypt-Blowfish
+ Crypt-CBC
+ Crypt-DES
+ Crypt-PasswdMD5
+ Crypt-SSLeay
+ DBD-mysql
+ DBI
+ Digest-HMAC
+ Digest-SHA1
+ HTML-Parser
+ HTML-Tagset
+ HTTP-GHTTP
+ IO-stringy
+ MIME-tools
+ Mail-Tools
+ Net-DNS
+ Net-Daemon
+ Net-IP
+ Net-LibIDN
+ PlRPC
+ URI
+ libwww
+ Term-ReadPassword
PHP5 Options
x apache
x CLI
x CGI
x suhosin
+ fastcgi
PHP5-Extensions Options
x pcre
x bz2
x ctype
x curl
x dbx
x domxml
x filepro
x gd
x imap
x mcrypt
x mhash
x mysql
x pear
x shmop
x xmlrpc
x xslt
x session
x php5-pdo_mysql
4. Configure the system.
# cpan upgrade
# cpan DBI DBD::mysql MIME::Entity MIME::Parser Crypt::CBC Crypt::Blowfish Crypt::PasswdMD5 Term::ReadPassword
Edit /etc/rc.conf and add
sendmail_enable="NONE"
postfix_enable="YES"
proftpd_enable="YES"
policyd_weight_enable="YES"
mysql_enable="YES"
apache22_enable="YES"
courier_authdaemond_enable="YES"
courier_imap_imapd_enable="YES"
courier_imap_imapd_ssl_enable="NO"
courier_imap_pop3d_enable="YES"
courier_imap_pop3d_ssl_enable="NO"
4. (optional) Check the ispcp.conf and adapt it to your requirements.
5. Build the System by using make:
# make -f Makefile.fbsd install
6. Copy all the directories into your system (you may make backups)
# cp -Rv /tmp/ispcp/* /
7. Now it's time to set up the frontend. Change into the engine directory:
# cd /usr/local/www/apache22/ispcp/engine/setup
8. Configure the MySQL Server and set the MySQL password, if not set:
# /usr/local/bin/mysql_install_db
# chown -R mysql /var/db/mysql/
# /usr/local/etc/rc.d/mysql-server start
# mysqladmin -u root password YOUR_PASSWORD
9. Start the engine setup:
# perl ispcp-setup
10. Install ispCP ω step-by-step
If you get no error, all went good; if you get on
http://isp-control.net to solve the problem.
11. Clean the temporary folders:
# rm -fR /tmp/ispcp
12. Load Apache modules
Edit /usr/local/etc/apache22/httpd.conf and add for FCGId
LoadModule fcgid_module libexec/apache22/mod_fcgid.so
Include etc/apache22/extra/fcgid_ispcp.conf
or for FastCGI
LoadModule fcgid_module libexec/apache22/mod_fastcgi.so
Include etc/apache22/extra/fastcgi_ispcp.conf
WARNING:
DEFAULT setting is using mod_php not fastcgi or mod_fcgid !!
The configuration is customised for use with apache 2.2.x version
using suexec module enable.
UNDER JAIL:
dont forget to modified postfix, prepared for chroot system
for mod_fcgid, at master /etc/rc.conf, set jail_sysvipc_allow to YES
================================================================================
5) Update
---------
Make sure you are logged in as root and MySQL is running.
1. If you upgrade from VHCS 2.4.7.1 or VHCS OMEGA 2.4.8 you must first install
ISPCP as described in INSTALL sections. Please note that ispCP Omega comes
with a new webmail client. Please make sure that your customers can still
access the address book data. You can ensure this either by making the old
webmail client accessable or by using this script:
http://www.isp-control.net/ispcp/ticket/1614.
2. Untar or unzip the distribution files to a secure directory:
# cd /root
# tar xjvf ispcp-omega-1.0.0.tar.bz2
3. Change to the newly created directory:
# cd ./ispcp-omega-1.0.0
4. Install the required modules
see: ./docs/FreeBSD/freebsd-packages
5. (optional) Check the ispcp.conf and adapt it to your requirements.
6. Stop the ispcp_deamon and build the System by using make:
# /etc/init.d/ispcp_daemon stop
# make -f Makefile.fbsd install
7. Save files
# cp -v /usr/local/www/ispcp/engine/ispcp-db-keys.pl /tmp/ispcp/usr/local/www/ispcp/engine/
# cp -v /usr/local/www/ispcp/engine/messager/ispcp-db-keys.pl /tmp/ispcp/usr/local/www/ispcp/engine/messager/
# cp -v /usr/local/www/ispcp/gui/include/ispcp-db-keys.php /tmp/ispcp/usr/local/www/ispcp/gui/include/
# cp -v /var/www/ispcp/gui/themes/user_logos/* /tmp/ispcp/var/www/ispcp/gui/themes/user_logos/
If updating from RC3 or higher:
# cp -v /usr/local/www/ispcp/gui/tools/pma/config.inc.php /tmp/ispcp/usr/local/www/ispcp/gui/tools/pma/
8. Delete old files to avoid security risks:
# rm -fR /var/www/ispcp/gui/admin/
# rm -fR /var/www/ispcp/gui/client/
# rm -fR /var/www/ispcp/gui/include/
# rm -fR /var/www/ispcp/gui/orderpanel/
# rm -fR /var/www/ispcp/gui/themes/
# rm -fR /var/www/ispcp/gui/reseller/
# rm -fR /var/www/ispcp/gui/*.php
9. Copy /usr and /var directories into your system (you may make backups)
# cp -Rv /tmp/ispcp/usr/* /usr/
# cp -Rv /tmp/ispcp/var/* /var/
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 /var/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 on
http://isp-control.net to solve the problem.
14. 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 ur 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!
