Welcome to XPanel 1.1.7!
TABLE OF CONTENTS
1. About the Script
2. System Requirements
3. Installation
4. Support
5. File attributes
1. About the Script
------------------------------------------------------------------------------
XPanel is a community product that allows webmasters to provide individual
websites (name.yourdomain.com) for their users in a secure, administered
environment. It allows you to automatically accept user signups or approve
each user from admin area.
For the full list of features, and details, please visit:
http://www.xpanel.com/features.html
2. System Requirements
------------------------------------------------------------------------------
XPanel is 100% perl, and will run on Linux platforms only.
System requirements are:
- Dedicated server, with at least two IP address.
- A MySQL database server.
- Apache web server with 'mod_vhost_alias' and 'mod_rewrite' enabled.
- PureFTPd or ProFTPd with SQL module installed.
- For installation requires access via SSH as root user.
The best supported OS is RedHat Linux
3. Installation
------------------------------------------------------------------------------
To install, please follow the following steps:
download and install this module
http://search.cpan.org/~tjmather/Geo-IP-PurePerl-1.12/
wget http://search.cpan.org/CPAN/authors/id/T/TJ/TJMATHER/Geo-IP-PurePerl-1.12.tar.gz
for redhat linux also may install this:
ftp.redhat.com/pub/redhat/linux/9/en/os/i386/RedHat/RPMS/mc-4.6.0-4.i386.rpm
rpm -i mc-4.6.0-4.i386.rpm
3.1. Upload to server xpanel_117.tar.gz (e.g. /home/temp/)
3.2. Unarchive the xpanel_117.tar.gz, by typing from shell:
tar -zxvf xpanel_117.tar.gz
3.3. Copy xpanel directory from /home/temp/xpanel_117/ to /usr/local/xpanel
use:
cd /home/temp/xpanel_117/
cp -R xpanel /usr/local/
3.4. Copy cgi-bin directory from /home/temp/xpanel_117/ to your cgi-bin
e.g.
cp -R cgi-bin /var/www/
cp -R images /var/www/html/images
3.5. Create a MySQL database using XPanel.mysql file by typing from shell:
mysql -p Crontab Configuration for XPanel <--------------------------------#
# run every 5 min.
3,8,13,18,23,28,33,38,43,48,53,58 * * * * /usr/local/xpanel/create.sh 1> /dev/null 2> /dev/null
# run every 10 min.
0,10,20,30,40,50 * * * * /usr/local/xpanel/delete.sh 1> /dev/null 2> /dev/null
# run 2 minutes after midnight, every day
2 0 * * * /usr/local/xpanel/bandwidth_delete.sh 1> /dev/null 2> /dev/null
# run 5 minutes after midnight, every day
5 0 * * * /usr/local/xpanel/expiry.sh 1> /dev/null 2> /dev/null
# run 6 minutes after midnight, every day
6 0 * * * /usr/local/xpanel/named.pl 1> /dev/null 2> /dev/null
# run 7 minutes after midnight, every day
7 0 * * * /etc/init.d/named reload 1> /dev/null 2> /dev/null
# run 9 minutes after midnight, on the first day of every month
9 0 1 * * /usr/local/xpanel/reset_ht.pl 1> /dev/null 2> /dev/null
# run at the end of the day, every day
59 23 * * * /usr/local/xpanel/xpanel_db_backup.sh 1> /dev/null 2> /dev/null
#----------> End Crontab Configuration for XPanel <----------------------------#
and save it.
* FreeBSD require special configuration
exemple:
59 23 * * * root /usr/local/xpanel/xpanel_db_backup.sh 1> /dev/null 2> /dev/null
3.8. Edit Apache httpd.conf file
!!! The first VirtualHost section is used for requests without a known server name.
Must be first VirtualHost in your httpd.conf
You should have only one virtual host with this IP 123.45.67.89 in httpd.conf and in proftpd.conf
add to /etc/http/conf/httpd.conf this:
Include /usr/local/xpanel/Conf/xp_httpd.conf
and edit IP address from xp_httpd.conf
3.9. Install PureFTPd
for RedHat you should have installed PureFTPd with this configuration:
./configure --prefix=/usr --sysconfdir=/etc --with-mysql --with-cookie --with-throttling --with-ratios --with-quotas --with-uploadscript --with-peruserlimits --with-altlog --with-standalone --with-extauth --without-nonalnum --without-unicode
make
make install
if you run cPanel
copy 'pure-ftpd' file from examples folder to /etc/init.d/
and restart it using this command line:
/etc/init.d/pure-ftpd restart
else
add to /etc/rc.d/rc.local this line to start pure-ftpd
/usr/local/xpanel/rc.pureftpd
3.10. Edit your DNS record, add wildcard *
yourdomain.com. IN A 123.45.67.88
www.yourdomain.com. IN CNAME yourdomain.com.
ftp.yourdomain.com. IN A 123.45.67.88
free.yourdomain.com. IN A 123.45.67.89
*.yourdomain.com. IN CNAME free.yourdomain.com.
http://www.zoneedit.com offers DNS free of charge to anyone who asks.
3.11. Change Admin PassWord
set chmod 666 /usr/local/xpanel/.htpasswd
your default username/password are demo/demo
to change go to: www.yourdom.com/cgi-bin/xpanel_admin/xpanel_admin.cgi?passwd
4. Support
------------------------------------------------------------------------------
If you run into any problems, please visit our online support forum at:
http://forum.xpanel.com
Cheers,
XPanel Software, Inc.
5. File attributes
------------------------------------------------------------------------------
You should find the following files in the archive and they
should have the following permissions:
- In '/usr/local/xpanel/'--------------------
auth (777) drwxrwxrwx
backups (644) -rw-r--r--
create (777) drwxrwxrwx
delete (777) drwxrwxrwx
insert (777) drwxrwxrwx
categoryX.tmpl (644) -rw-r--r--
categoryX.cgi (755) -rwxr-xr-x
templates (777) drwxrwxrwx
categoryX (777) drwxrwxrwx
approved.tmpl (644) -rw-r--r--
... (644) -rw-r--r--
.htpasswd (666) -rw-rw-rw-
bandwidth.pl (755) -rwxr-xr-x
bandwidth_delete.pl (744) -rwxr--r--
bandwidth_delete.sh (744) -rwxr--r--
Conf/Config.pm (644) -rwxr-xr-x
create.sh (744) -rwxr--r--
create_home.pl (744) -rwxr--r--
create_user.pl (755) -rwxr-xr-x
delete.sh (744) -rwxr--r--
delete_user.pl (744) -rwxr--r--
dns.pl (755) -rwxr-xr-x
expire.pl (744) -rwxr--r--
expire.sh (744) -rwxr--r--
mysql.pl (755) -rwxr-xr-x
named.pl (744) -rwxr--r--
reset_ht.pl (744) -rwxr--r--
uploadscript.pl (744) -rwxr--r--
uploadscript.sh (744) -rwxr--r--
xpanel.log (644) -rw-r--r--
xpanel_db_backup.sh (744) -rwxr--r--
- In your '/cgi-bin/' ----------------------
confirm.cgi (755) -rwxr-xr-x
final.cgi (755) -rwxr-xr-x
amanager.cgi (755) -rwxr-xr-x
fmanager.cgi (755) -rwxr-xr-x
paypal_notify.cgi (755) -rwxr-xr-x
paypal_return.cgi (755) -rwxr-xr-x
register.cgi (755) -rwxr-xr-x
xregister.cgi (755) -rwxr-xr-x
- In your '/cgi-bin/secure_directory' ------
xpanel_admin.cgi (755) -rwxr-xr-x
.htaccess (644) -rw-r--r--
- In your WebSite /images/ -----------------
/calendar/
____________________________________________
LICENSE
README
XPanel.mysql
All .pl .cgi .sh .pm files must be edited in ASCII mode!
Don't forget to keep XPanel.css in ../templates/headerX.tmpl files!!!
End.