ISPConfig3 devel
view | history | commit | commitdiff
quentusrex
2008-10-31 fd8e2b5317e8c43aa476a57bbf555c444049f536
commit | author | age
4cb0eb 1 Installation
T 2 -----------
3
4 It is recommended to use a clean (fresh) Debian etch install where you just selected "Standard System" as the package selection during setup. Then follow the steps below to setup your server with ISPConfig 3:
5
6 1) Install Postfix, Courier, Saslauthd, MySQL, phpMyAdmin with the following command line (on one line!):
7
8500be 8 apt-get install postfix postfix-mysql postfix-doc mysql-client mysql-server courier-authdaemon courier-authlib-mysql courier-pop courier-pop-ssl courier-imap courier-imap-ssl libsasl2 libsasl2-modules libsasl2-modules-sql sasl2-bin libpam-mysql openssl courier-maildrop getmail4
4cb0eb 9
T 10 Answer the questions from the package manager as follows.
11
12 Create directories for web-based administration ? <-- No
13 General type of configuration? <-- Internet site
14 Mail name? <-- server1.mydomain.tld
15  SSL certificate required <-- Ok
16
17 ...use your own domain name of course ;)
18
5f7eea 19 Edit the file /etc/mysql/my.cnf
d4c9b3 20
T 21 vi /etc/mysql/my.cnf
22
23 and comment out the line
24
25 bind-address          = 127.0.0.1
26
27 then restart mysql
28
29 /etc/init.d/mysql restart
30
31 Set the mysql database password:
32
33 mysqladmin -u root password yourrootsqlpassword
34 mysqladmin -h ispconfig.local -u root password yourrootsqlpassword
35
36
4cb0eb 37 2) Install Amavisd-new, Spamassassin and Clamav (1 line!):
T 38
ba66cd 39 apt-get install amavisd-new spamassassin clamav clamav-daemon zoo unzip bzip2 arj nomarch lzop cabextract apt-listchanges libnet-ldap-perl libauthen-sasl-perl clamav-docs daemon libio-string-perl libio-socket-ssl-perl libnet-ident-perl zip libnet-dns-perl
4cb0eb 40
T 41 3) Install apache, PHP5 and phpmyadmin (1 line!):
42
8065e0 43 apt-get install apache2 apache2.2-common apache2-doc apache2-mpm-prefork apache2-utils libexpat1 ssl-cert libapache2-mod-php5 php5 php5-common php5-gd php5-mysql php5-imap phpmyadmin php5-cli libapache2-mod-fcgid apache2-suexec
4cb0eb 44
T 45 Then run the following to enable the Apache modules:
46
47 a2enmod suexec
48 a2enmod rewrite
30aa08 49 a2enmod ssl
4cb0eb 50
T 51 4) Install pure-ftpd and quota
52
53 apt-get install pure-ftpd-common pure-ftpd-mysql quota quotatool
54
af8f1b 55 Edit the file /etc/default/pure-ftpd-common
T 56
57 vi /etc/default/pure-ftpd-common
58
4fe973 59 and change the start mode from inetd to standalone. 
T 60
3845f1 61 Edit the file /etc/inetd.conf
T 62
63 vi /etc/inetd.conf
4fe973 64
T 65 and comment out the line for the FTP service, so it looks like this:
66
67 # ftp   stream  tcp     nowait  root    /usr/sbin/tcpd /usr/sbin/pure-ftpd-wrapper
68
69 Then execute:
af8f1b 70
T 71 /etc/init.d/openbsd-inetd restart
72
4cb0eb 73
T 74 5) Install mydns
75
777da7 76 apt-get install g++ libc6 gcc gawk make texinfo libmysqlclient15-dev
4cb0eb 77
777da7 78 cd /tmp
T 79 wget http://heanet.dl.sourceforge.net/sourceforge/mydns-ng/mydns-1.2.8.4.tar.gz
80 tar xvfz mydns-1.2.8.4.tar.gz
81 cd mydns-1.2.8
82 ./configure
83 make
84 make install
d4c9b3 85
777da7 86 Now create the start / stop script for mydns:
4cb0eb 87
777da7 88 vi /etc/init.d/mydns
T 89
90 and enter the following lines (between the ----- lines):
91
92 ------------------------------------------------------
93 #! /bin/sh
94 #
95 # mydns         Start the MyDNS server
96 #
97 # Author:       Philipp Kern <phil@philkern.de>.
98 #               Based upon skeleton 1.9.4 by Miquel van Smoorenburg
99 #               <miquels@cistron.nl> and Ian Murdock <imurdock@gnu.ai.mit.edu>.
100 #
101
102 set -e
103
104 PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
105 DAEMON=/usr/local/sbin/mydns
106 NAME=mydns
107 DESC="DNS server"
108
109 SCRIPTNAME=/etc/init.d/$NAME
110
111 # Gracefully exit if the package has been removed.
112 test -x $DAEMON || exit 0
113
114 case "$1" in
115   start)
116         echo -n "Starting $DESC: $NAME"
117         start-stop-daemon --start --quiet \
118                 --exec $DAEMON -- -b
119         echo "."
120         ;;
121   stop)
122         echo -n "Stopping $DESC: $NAME"
123         start-stop-daemon --stop --oknodo --quiet \
124                 --exec $DAEMON
125         echo "."
126         ;;
127   reload|force-reload)
128         echo -n "Reloading $DESC configuration..."
129         start-stop-daemon --stop --signal HUP --quiet \
130                 --exec $DAEMON
131         echo "done."
132         ;;
133   restart)
134         echo -n "Restarting $DESC: $NAME"
135         start-stop-daemon --stop --quiet --oknodo \
136                 --exec $DAEMON
137         sleep 1
138         start-stop-daemon --start --quiet \
139                 --exec $DAEMON -- -b
140         echo "."
141         ;;
142   *)
143         echo "Usage: $SCRIPTNAME {start|stop|restart|reload|force-reload}" >&2
144         exit 1
145         ;;
146 esac
147
148 exit 0
149 ---------------------------------------------------------------------------
150
151 now execute:
152
153 chmod +x /etc/init.d/mydns
154 update-rc.d mydns defaults
4cb0eb 155
T 156 6) Install vlogger and webalizer
157
158 apt-get install vlogger webalizer
159
160
161 7) Install ISPConfig 3
162
163 There are two possile scenarios, but not both:
369a38 164 7.1) Install the latest released version 
4fe973 165 7.2) Install directly from SVN
4cb0eb 166
T 167 apt-get install php5-cli
168
8d7811 169 7.1) Installation of beta 3 from tar.gz
4cb0eb 170
T 171   cd /tmp
369a38 172   wget http://www.ispconfig.org/downloads/ISPConfig-3.0.0.6-beta.tar.gz
T 173   tar xvfz ISPConfig-3.0.0.6-beta.tar.gz
3fac98 174   cd ispconfig3_install/install/
4cb0eb 175
4fe973 176 7.2) Installation from SVN
4cb0eb 177
T 178   apt-get install subversion
179   cd /tmp
180   svn export svn://svn.ispconfig.org/ispconfig3/trunk/
181   cd trunk/install
182
183
4fe973 184 7.1+7.2) Now proceed with the ISPConfig installation.
4cb0eb 185
T 186 Now start the installation process by executing:
187
188 php -q install.php
189
190 The installer will configure all services like postfix, sasl, courier, etc. for you. A manual setup as required for ISPConfig 2 (perfect setup guides) is not nescessary. To login to the ISPConfig controlpanel, open the following URL in your browser (replace the IP to match your settings!):
191
192 http://192.168.0.100:8080/
193
194 the default login is:
195
196 user: admin
197 password: admin
198
199 In case you get a permission denied error from apache, please restart the apache webserver process.
ba66cd 200
3845f1 201 Optional:
T 202
490039 203 Install a webbased Email Client
3845f1 204
T 205 apt-get install squirrelmail
206 ln -s /usr/share/squirrelmail/ /var/www/webmail
207
208 Access squirrelmail:
209
210 http://192.168.0.100/webmail
211
212
213 To configure squirrelmail, run:
214
215 /usr/sbin/squirrelmail-configure
216
ba66cd 217 ----------------------------------------------------------------------------------------------------------
T 218
219 Hints:
220
221 debian 4.0 under openvz:
222
8a6a58 223 VPSID=101
ba66cd 224 for CAP in CHOWN DAC_READ_SEARCH SETGID SETUID NET_BIND_SERVICE NET_ADMIN SYS_CHROOT SYS_NICE CHOWN DAC_READ_SEARCH SETGID SETUID NET_BIND_SERVICE NET_ADMIN SYS_CHROOT SYS_NICE
T 225 do
226   vzctl set $VPSID --capability ${CAP}:on --save
227 done
46bf55 228
T 229 ----------------------------------------------------------------------------------------------------------
230
231 Installing Jailkit:
232
233 apt-get install build-essential autoconf automake1.9 libtool flex bison
234 cd /tmp
235 wget http://olivier.sessink.nl/jailkit/jailkit-2.5.tar.gz
236 tar xvfz jailkit-2.5.tar.gz
237 cd jailkit-2.5
238 ./configure
239 make
240 make install
241 rm -rf jailkit-2.5*