ISPConfig3 devel
view | history | commit | commitdiff
redray
2008-12-15 a65f93478f2c0756c2096d429433040060be8635
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
ede53c 6 1) Install Postfix, Courier, Saslauthd, MySQL, phpMyAdmin, ntpdate, rkhunter with the following command line (on one line!):
4cb0eb 7
ede53c 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 ntp ntpdate rkhunter
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
6627a9 167 7.1) Installation of last version from tar.gz
4cb0eb 168
T 169   cd /tmp
369a38 170   wget http://www.ispconfig.org/downloads/ISPConfig-3.0.0.6-beta.tar.gz
6627a9 171   tar xvfz ISPConfig-3.0.0.7-beta.tar.gz
3fac98 172   cd ispconfig3_install/install/
4cb0eb 173
4fe973 174 7.2) Installation from SVN
4cb0eb 175
T 176   apt-get install subversion
177   cd /tmp
178   svn export svn://svn.ispconfig.org/ispconfig3/trunk/
179   cd trunk/install
180
181
4fe973 182 7.1+7.2) Now proceed with the ISPConfig installation.
4cb0eb 183
T 184 Now start the installation process by executing:
185
186 php -q install.php
187
188 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!):
189
190 http://192.168.0.100:8080/
191
192 the default login is:
193
194 user: admin
195 password: admin
196
197 In case you get a permission denied error from apache, please restart the apache webserver process.
ba66cd 198
3845f1 199 Optional:
T 200
490039 201 Install a webbased Email Client
3845f1 202
T 203 apt-get install squirrelmail
204 ln -s /usr/share/squirrelmail/ /var/www/webmail
205
206 Access squirrelmail:
207
208 http://192.168.0.100/webmail
209
210
211 To configure squirrelmail, run:
212
213 /usr/sbin/squirrelmail-configure
214
ba66cd 215 ----------------------------------------------------------------------------------------------------------
T 216
217 Hints:
218
219 debian 4.0 under openvz:
220
8a6a58 221 VPSID=101
ba66cd 222 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 223 do
224   vzctl set $VPSID --capability ${CAP}:on --save
225 done
46bf55 226
T 227 ----------------------------------------------------------------------------------------------------------
228
229 Installing Jailkit:
230
231 apt-get install build-essential autoconf automake1.9 libtool flex bison
232 cd /tmp
233 wget http://olivier.sessink.nl/jailkit/jailkit-2.5.tar.gz
234 tar xvfz jailkit-2.5.tar.gz
235 cd jailkit-2.5
236 ./configure
237 make
238 make install
239 rm -rf jailkit-2.5*