tbrehm
2008-09-30 8065e06cb37b27d0736b74e0e8ab646499a630b7
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
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
76 apt-get install mydns-mysql
77
a4262c 78 What is the hostname of the machine on which the database will run? -> localhost
T 79 What is the database name for the MyDNS database? -> mydns
d4c9b3 80 Would you like to set up the database and tables automatically? -> yes
T 81 What is the username of the MySQL administrator? -> root
82 Enter the MySQL administrator password -> yourrootsqlpassword
83 Confirm this password -> yourrootsqlpassword
84 What is the MyDNS username? -> mydns
85 What is the MyDNS user password? -> mydnspassword
86
4cb0eb 87 The mydns installer is a bit tricky, you will have to select to create a new database for mydns and use a existing mysql user, e.g. the mysql root user. This database is only to fullfill the requirements for the debian pacakge during installation and will not be used by ISPConfig later. ISPConfig will automatically change the mydns configuration files to use the ISPConfig database.
T 88
89
90 6) Install vlogger and webalizer
91
92 apt-get install vlogger webalizer
93
94
95 7) Install ISPConfig 3
96
97 There are two possile scenarios, but not both:
369a38 98 7.1) Install the latest released version 
4fe973 99 7.2) Install directly from SVN
4cb0eb 100
T 101 apt-get install php5-cli
102
8d7811 103 7.1) Installation of beta 3 from tar.gz
4cb0eb 104
T 105   cd /tmp
369a38 106   wget http://www.ispconfig.org/downloads/ISPConfig-3.0.0.6-beta.tar.gz
T 107   tar xvfz ISPConfig-3.0.0.6-beta.tar.gz
3fac98 108   cd ispconfig3_install/install/
4cb0eb 109
4fe973 110 7.2) Installation from SVN
4cb0eb 111
T 112   apt-get install subversion
113   cd /tmp
114   svn export svn://svn.ispconfig.org/ispconfig3/trunk/
115   cd trunk/install
116
117
4fe973 118 7.1+7.2) Now proceed with the ISPConfig installation.
4cb0eb 119
T 120 Now start the installation process by executing:
121
122 php -q install.php
123
124 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!):
125
126 http://192.168.0.100:8080/
127
128 the default login is:
129
130 user: admin
131 password: admin
132
133 In case you get a permission denied error from apache, please restart the apache webserver process.
ba66cd 134
3845f1 135 Optional:
T 136
490039 137 Install a webbased Email Client
3845f1 138
T 139 apt-get install squirrelmail
140 ln -s /usr/share/squirrelmail/ /var/www/webmail
141
142 Access squirrelmail:
143
144 http://192.168.0.100/webmail
145
146
147 To configure squirrelmail, run:
148
149 /usr/sbin/squirrelmail-configure
150
ba66cd 151 ----------------------------------------------------------------------------------------------------------
T 152
153 Hints:
154
155 debian 4.0 under openvz:
156
8a6a58 157 VPSID=101
ba66cd 158 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 159 do
160   vzctl set $VPSID --capability ${CAP}:on --save
161 done
46bf55 162
T 163 ----------------------------------------------------------------------------------------------------------
164
165 Installing Jailkit:
166
167 apt-get install build-essential autoconf automake1.9 libtool flex bison
168 cd /tmp
169 wget http://olivier.sessink.nl/jailkit/jailkit-2.5.tar.gz
170 tar xvfz jailkit-2.5.tar.gz
171 cd jailkit-2.5
172 ./configure
173 make
174 make install
175 rm -rf jailkit-2.5*