XAMS Install HowTo
Posted: 2003-04-07 15:19
XAMS Installation auf einem Debian 3.0 System (http://www.xams.org)
===========================================================
Diese Anleitung basiert auf der Original Installationsanleitung
für Debian, welche im Paket enthalten ist.
Ich kann nicht dafür garantiere das es so bei allen funktioniert.
Bei mir klappte aber alles ;-)
Und jetzt viel Spaß beim ausprobieren....
1. MySQL Server installieren (falls noch nicht installiert)
-----------------------------------------------------------
-> apt-get install mysql-server libmysqlclient10-dev
(Die Frage: Should MySQL start on boot? mit YES beantworten)
-> mysqladmin -u root password 'xxxx' (Root-Passwort ändern - xxxx durchs neue Root-Passwort ersetzen)
2. EXIM installieren
--------------------
-> dselect
- Select auswählen
- exim suchen und per H (großes H) auf Hold setzen.
- Deselect beenden (großes Q)
-> cd /usr/src
-> wget ftp://ftp.tin.org/pub/mail/exim/exim4/exim-4.14.tar.gz
-> tar xvfz exim-4.14.tar.gz
-> cd exim-4.14
-> cp src/EDITME Local/Makefile
-> mcedit Local/Makefile
Folgende Ã?nderungen durchführen:
Zeile 101 - BIN_DIRECTORY=/usr/local/exim/bin
Zeile 117 - CONFIGURE_FILE=/usr/local/exim/configure
Zeile 135 - EXIM_USER=mail
Zeile 225 - SUPPORT_MAILDIR=yes
Zeile 242 - LOOKUP_CDB=yes
Zeile 246 - LOOKUP_MYSQL=yes
Zeile 280 - LOOKUP_INCLUDE=-I /usr/include/mysql
Zeile 281 - LOOKUP_LIBS=-L/usr/lib -lmysqlclient
Zeile 292 - # EXIM_MONITOR=eximon.bin (Wird normalerweise nicht benötigt)
Zeile 314 - AUTH_PLAINTEXT=yes
Zeile 419 - LOG_FILE_PATH=/var/log/exim/%slog
Zeile 453 - COMPRESS_COMMAND=/bin/gzip
Zeile 461 - ZCAT_COMMAND=/bin/zcat
Zeile 571 - CHOWN_COMMAND=/bin/chown
Zeile 572 - CHGRP_COMMAND=/bin/chgrp
Zeile 755 - PID_FILE_PATH=/var/run/exim/exim.pid
Zeile 788 - SUPPORT_MOVE_FROZEN_MESSAGES=yes
Für TLS Support müssen noch folgende Zeilen angepasst werden
Zeile 352 - SUPPORT_TLS=yes
Zeile 355 - TLS_LIBS=-lssl -lcrypto
Datei speichern und Editor beenden.
Anmerkung: Diese Einstellungen sind aus der Original-Installationsanleitung
übernommen wurden.
-> apt-get install libdb2-dev
-> apt-get install libssl-dev (Wird nur für TLS Support benötigt!!!)
Jetzt müssen wir das Paket kompilieren. Folgende Zeile installiert alle benötigten
Tools um das Paket zu bauen.
-> apt-get install make g++
-> make
-> make install
-> cd /usr/sbin
-> mv exim exim.old
-> ln -s ../local/exim/bin/exim
-> cd /etc/exim
-> mv exim.conf exim.old
-> ln -s ../../usr/local/exim/configure exim.conf
3. Courier
----------
-> apt-get install courier-imap courier-imap-ssl courier-pop courier-pop-ssl
-> /etc/init.d/courier-imap stop
-> /etc/init.d/courier-imap-ssl stop
-> /etc/init.d/courier-pop stop
-> /etc/init.d/courier-pop-ssl stop
-> /etc/init.d/courier-authdaemon stop
-> chmod a-x /etc/init.d/courier-authdaemon
3. XAMS 0.0.12
------------
-> cd /usr/src
-> wget http://easynews.dl.sourceforge.net/sour ... .12.tar.gz
-> wget http://easynews.dl.sourceforge.net/sour ... man.tar.gz
-> tar xvfz xams-0.0.12.tar.gz
-> tar xvfz xams-0.0.12-german.tar.gz
-> apt-get install libdigest-md5-perl libunix-syslog-perl libconfig-inifiles-perl libcdb-file-perl
-> cd xams-0.0.12
-> mysqladmin -u root -p create xams (Jetzt wird das zuvor festgelegte Root-Passwort abgefragt)
-> mysql -u root -p xams < database/mysql/xams-struct.sql
-> mcedit database/mysql/xams.sql
Zeile 6 - Raute entfernen
-> mysql -u root -p xams < database/mysql/xams.sql
(Xams Gruppe und User anlegen)
-> groupadd xams
-> useradd -g xams -d /dev/null -s /bin/false xams
4. Apache
---------
(In dieser Konfiguration wird ein eigener Apache-Process für XAMS
verwendet. Dies entpricht der Empfehlung der Programmierer da es mögliche
Sicherheitslücken vorbeugt)
-> apt-get install apache php4 php4-gd2 php4-mysql php4-xslt
-> cp ./docs/install/debian/files/httpd-xams.conf /etc/apache
-> cp ./docs/install/debian/files/apache-xams /etc/init.d
-> cd /etc/rc0.d
-> ln ../init.d/apache-xams K20apache-xams
-> cp -d K20apache-xams /etc/rc1.d
-> cp -d K20apache-xams /etc/rc6.d
-> cp -d K20apache-xams /etc/rc2.d/S91apache-xams
-> cp -d K20apache-xams /etc/rc3.d/S91apache-xams
-> cp -d K20apache-xams /etc/rc4.d/S91apache-xams
-> cp -d K20apache-xams /etc/rc5.d/S91apache-xams
-> mcedit /etc/php4/apache/php.ini
- Kontrollieren ob folgende Zeilen zu finden sind:
- extension=mysql.so
- extension=gd.so
- extension=xslt.so
und gegebenfalls hinzufügen.
-> /etc/init.d/apache-xams start
5. XAMS (Teil 2) Kopieren des PHP-Interface
-------------------------------------------
-> cp -R gui /var/www/xams
-> chown xams.xams -R /var/www/xams
-> find /var/www/xams -type d -exec chmod 2750 {} ;
-> find /var/www/xams -type f -exec chmod 0640 {} ;
-> chmod 2770 /var/www/xams/cache /var/www/xams/skins/*/img/{buttons,tabs}
-> mkdir -p /etc/xams /etc/xams/autoreply /var/run/xams /usr/local/xams/sbin
-> chown mail.xams /etc/xams
-> chown mail.mail /etc/xams/autoreply
-> chown mail.xams /var/run/xams
-> chgrp mail /var/run/courier/authdaemon
-> cp config/init.d/authdaemon.sh /etc/init.d
-> cp config/xams/xams.conf /etc/xams
-> cp config/exim4/exim-global.conf config/exim4/exim-mysql.conf config/exim4/exim-routers.conf config/exim4/exim-transports.conf /etc/xams
-> touch /etc/xams/localdomains.cdb
-> chown mail.xams /etc/xams/xams.conf
-> chown root.mail /etc/xams/exim-*.conf
-> chmod 640 /etc/xams/*.conf
-> mcedit /etc/xams/xams.conf
- Folge Werte unter [GUI] anpassen:
DBUser = root
DBPass = xxxx (Das vorher für den User Root definierte Passwort)
-> cp scripts/Xmod.pm /usr/lib/perl5/
-> cp scripts/xmu.pl scripts/authdaemon.pl /usr/local/xams/sbin
-> chown mail.xams /usr/local/xams/sbin/xmu.pl
-> chmod 644 /usr/lib/perl5/Xmod.pm
6. EXIM (Teil 2)
---------------
-> cp config/exim4/exim-mdir-mysql.conf /usr/local/exim/configure
-> mcedit /etc/xams/exim-mysql.conf
Konfiguration nach folgendem Schema anpassen:
"hide mysql_servers = localhost/xams/root/xxxx"
^ ^ ^ ^
| | | |- Mysql-Passwort
| | |- Mysql-User
| |- Mysql-Datenbank
|- Mysql-Host
-> mv /etc/init.d/courier-authdaemon /etc/init.d/courier-authdaemon.old
-> ln -s /etc/init.d/authdaemon.sh /etc/init.d/courier-authdaemon
-> /etc/init.d/authdaemon.sh start
-> /etc/init.d/courier-imap start
-> /etc/init.d/courier-imap-ssl start
-> /etc/init.d/courier-pop start
-> /etc/init.d/courier-pop-ssl start
7. PEAR installation
--------------------
(Da die Pear-Version von Debian 3.0 zu alt ist, müssen wir Pear per Hand installieren)
-> apt-get install php4-cgi
-> lynx -source http://go-pear.org | php4
Hier in Kurzform die von mir vorgenommene
Auswahl ;-)
-> ENTER
-> ENTER
-> ENTER
-> Y
-> ENTER
8. BIND Nameserver integration
------------------------------
-> apt-get install bind9
-> touch /etc/bind/xams-zones.conf
-> mkdir /etc/bind/xams-zones
-> mcedit /etc/bind/named.conf
- Am Ende der Datei folgende Zeile einfügen:
include "/etc/bind/xams-zones.conf";
(Leerzeile am Ende nicht vergessen !)
-> rndc reconfig (oder ndc reconfig bei Bind8)
-> cp config/bind/{named,zone}_template /etc/xams
-> /usr/local/xams/sbin/xmu.pl --update-bind
9. CRONJOB
----------
-> mcedit /etc/crontab
Am Ende der Datei folgende Zeile einfügen:
*/5 * * * * root /usr/local/xams/sbin/xmu.pl --update-bind --homedirs
*** --> FERTIG <-- ***
Jetzt ist Xams unter http://IP-DES-RECHNERS:81 zu erreichen.
Einloggen mit Usertyp=Administrator, Login=demo und Passwort=demo
Unter den Einstellungen kann die Sprache jetzt auch auf Deutsch geändert werden,
und unter XAMS-Konten kann der Admin-User (demo) geändert werden.
Gruß
Björn
===========================================================
Diese Anleitung basiert auf der Original Installationsanleitung
für Debian, welche im Paket enthalten ist.
Ich kann nicht dafür garantiere das es so bei allen funktioniert.
Bei mir klappte aber alles ;-)
Und jetzt viel Spaß beim ausprobieren....
1. MySQL Server installieren (falls noch nicht installiert)
-----------------------------------------------------------
-> apt-get install mysql-server libmysqlclient10-dev
(Die Frage: Should MySQL start on boot? mit YES beantworten)
-> mysqladmin -u root password 'xxxx' (Root-Passwort ändern - xxxx durchs neue Root-Passwort ersetzen)
2. EXIM installieren
--------------------
-> dselect
- Select auswählen
- exim suchen und per H (großes H) auf Hold setzen.
- Deselect beenden (großes Q)
-> cd /usr/src
-> wget ftp://ftp.tin.org/pub/mail/exim/exim4/exim-4.14.tar.gz
-> tar xvfz exim-4.14.tar.gz
-> cd exim-4.14
-> cp src/EDITME Local/Makefile
-> mcedit Local/Makefile
Folgende Ã?nderungen durchführen:
Zeile 101 - BIN_DIRECTORY=/usr/local/exim/bin
Zeile 117 - CONFIGURE_FILE=/usr/local/exim/configure
Zeile 135 - EXIM_USER=mail
Zeile 225 - SUPPORT_MAILDIR=yes
Zeile 242 - LOOKUP_CDB=yes
Zeile 246 - LOOKUP_MYSQL=yes
Zeile 280 - LOOKUP_INCLUDE=-I /usr/include/mysql
Zeile 281 - LOOKUP_LIBS=-L/usr/lib -lmysqlclient
Zeile 292 - # EXIM_MONITOR=eximon.bin (Wird normalerweise nicht benötigt)
Zeile 314 - AUTH_PLAINTEXT=yes
Zeile 419 - LOG_FILE_PATH=/var/log/exim/%slog
Zeile 453 - COMPRESS_COMMAND=/bin/gzip
Zeile 461 - ZCAT_COMMAND=/bin/zcat
Zeile 571 - CHOWN_COMMAND=/bin/chown
Zeile 572 - CHGRP_COMMAND=/bin/chgrp
Zeile 755 - PID_FILE_PATH=/var/run/exim/exim.pid
Zeile 788 - SUPPORT_MOVE_FROZEN_MESSAGES=yes
Für TLS Support müssen noch folgende Zeilen angepasst werden
Zeile 352 - SUPPORT_TLS=yes
Zeile 355 - TLS_LIBS=-lssl -lcrypto
Datei speichern und Editor beenden.
Anmerkung: Diese Einstellungen sind aus der Original-Installationsanleitung
übernommen wurden.
-> apt-get install libdb2-dev
-> apt-get install libssl-dev (Wird nur für TLS Support benötigt!!!)
Jetzt müssen wir das Paket kompilieren. Folgende Zeile installiert alle benötigten
Tools um das Paket zu bauen.
-> apt-get install make g++
-> make
-> make install
-> cd /usr/sbin
-> mv exim exim.old
-> ln -s ../local/exim/bin/exim
-> cd /etc/exim
-> mv exim.conf exim.old
-> ln -s ../../usr/local/exim/configure exim.conf
3. Courier
----------
-> apt-get install courier-imap courier-imap-ssl courier-pop courier-pop-ssl
-> /etc/init.d/courier-imap stop
-> /etc/init.d/courier-imap-ssl stop
-> /etc/init.d/courier-pop stop
-> /etc/init.d/courier-pop-ssl stop
-> /etc/init.d/courier-authdaemon stop
-> chmod a-x /etc/init.d/courier-authdaemon
3. XAMS 0.0.12
------------
-> cd /usr/src
-> wget http://easynews.dl.sourceforge.net/sour ... .12.tar.gz
-> wget http://easynews.dl.sourceforge.net/sour ... man.tar.gz
-> tar xvfz xams-0.0.12.tar.gz
-> tar xvfz xams-0.0.12-german.tar.gz
-> apt-get install libdigest-md5-perl libunix-syslog-perl libconfig-inifiles-perl libcdb-file-perl
-> cd xams-0.0.12
-> mysqladmin -u root -p create xams (Jetzt wird das zuvor festgelegte Root-Passwort abgefragt)
-> mysql -u root -p xams < database/mysql/xams-struct.sql
-> mcedit database/mysql/xams.sql
Zeile 6 - Raute entfernen
-> mysql -u root -p xams < database/mysql/xams.sql
(Xams Gruppe und User anlegen)
-> groupadd xams
-> useradd -g xams -d /dev/null -s /bin/false xams
4. Apache
---------
(In dieser Konfiguration wird ein eigener Apache-Process für XAMS
verwendet. Dies entpricht der Empfehlung der Programmierer da es mögliche
Sicherheitslücken vorbeugt)
-> apt-get install apache php4 php4-gd2 php4-mysql php4-xslt
-> cp ./docs/install/debian/files/httpd-xams.conf /etc/apache
-> cp ./docs/install/debian/files/apache-xams /etc/init.d
-> cd /etc/rc0.d
-> ln ../init.d/apache-xams K20apache-xams
-> cp -d K20apache-xams /etc/rc1.d
-> cp -d K20apache-xams /etc/rc6.d
-> cp -d K20apache-xams /etc/rc2.d/S91apache-xams
-> cp -d K20apache-xams /etc/rc3.d/S91apache-xams
-> cp -d K20apache-xams /etc/rc4.d/S91apache-xams
-> cp -d K20apache-xams /etc/rc5.d/S91apache-xams
-> mcedit /etc/php4/apache/php.ini
- Kontrollieren ob folgende Zeilen zu finden sind:
- extension=mysql.so
- extension=gd.so
- extension=xslt.so
und gegebenfalls hinzufügen.
-> /etc/init.d/apache-xams start
5. XAMS (Teil 2) Kopieren des PHP-Interface
-------------------------------------------
-> cp -R gui /var/www/xams
-> chown xams.xams -R /var/www/xams
-> find /var/www/xams -type d -exec chmod 2750 {} ;
-> find /var/www/xams -type f -exec chmod 0640 {} ;
-> chmod 2770 /var/www/xams/cache /var/www/xams/skins/*/img/{buttons,tabs}
-> mkdir -p /etc/xams /etc/xams/autoreply /var/run/xams /usr/local/xams/sbin
-> chown mail.xams /etc/xams
-> chown mail.mail /etc/xams/autoreply
-> chown mail.xams /var/run/xams
-> chgrp mail /var/run/courier/authdaemon
-> cp config/init.d/authdaemon.sh /etc/init.d
-> cp config/xams/xams.conf /etc/xams
-> cp config/exim4/exim-global.conf config/exim4/exim-mysql.conf config/exim4/exim-routers.conf config/exim4/exim-transports.conf /etc/xams
-> touch /etc/xams/localdomains.cdb
-> chown mail.xams /etc/xams/xams.conf
-> chown root.mail /etc/xams/exim-*.conf
-> chmod 640 /etc/xams/*.conf
-> mcedit /etc/xams/xams.conf
- Folge Werte unter [GUI] anpassen:
DBUser = root
DBPass = xxxx (Das vorher für den User Root definierte Passwort)
-> cp scripts/Xmod.pm /usr/lib/perl5/
-> cp scripts/xmu.pl scripts/authdaemon.pl /usr/local/xams/sbin
-> chown mail.xams /usr/local/xams/sbin/xmu.pl
-> chmod 644 /usr/lib/perl5/Xmod.pm
6. EXIM (Teil 2)
---------------
-> cp config/exim4/exim-mdir-mysql.conf /usr/local/exim/configure
-> mcedit /etc/xams/exim-mysql.conf
Konfiguration nach folgendem Schema anpassen:
"hide mysql_servers = localhost/xams/root/xxxx"
^ ^ ^ ^
| | | |- Mysql-Passwort
| | |- Mysql-User
| |- Mysql-Datenbank
|- Mysql-Host
-> mv /etc/init.d/courier-authdaemon /etc/init.d/courier-authdaemon.old
-> ln -s /etc/init.d/authdaemon.sh /etc/init.d/courier-authdaemon
-> /etc/init.d/authdaemon.sh start
-> /etc/init.d/courier-imap start
-> /etc/init.d/courier-imap-ssl start
-> /etc/init.d/courier-pop start
-> /etc/init.d/courier-pop-ssl start
7. PEAR installation
--------------------
(Da die Pear-Version von Debian 3.0 zu alt ist, müssen wir Pear per Hand installieren)
-> apt-get install php4-cgi
-> lynx -source http://go-pear.org | php4
Hier in Kurzform die von mir vorgenommene
Auswahl ;-)
-> ENTER
-> ENTER
-> ENTER
-> Y
-> ENTER
8. BIND Nameserver integration
------------------------------
-> apt-get install bind9
-> touch /etc/bind/xams-zones.conf
-> mkdir /etc/bind/xams-zones
-> mcedit /etc/bind/named.conf
- Am Ende der Datei folgende Zeile einfügen:
include "/etc/bind/xams-zones.conf";
(Leerzeile am Ende nicht vergessen !)
-> rndc reconfig (oder ndc reconfig bei Bind8)
-> cp config/bind/{named,zone}_template /etc/xams
-> /usr/local/xams/sbin/xmu.pl --update-bind
9. CRONJOB
----------
-> mcedit /etc/crontab
Am Ende der Datei folgende Zeile einfügen:
*/5 * * * * root /usr/local/xams/sbin/xmu.pl --update-bind --homedirs
*** --> FERTIG <-- ***
Jetzt ist Xams unter http://IP-DES-RECHNERS:81 zu erreichen.
Einloggen mit Usertyp=Administrator, Login=demo und Passwort=demo
Unter den Einstellungen kann die Sprache jetzt auch auf Deutsch geändert werden,
und unter XAMS-Konten kann der Admin-User (demo) geändert werden.
Gruß
Björn