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