From 8076975a7f12703d84d37d4be10ea680204040bf Mon Sep 17 00:00:00 2001 From: Philip Häusler Date: Sun, 18 Dec 2011 14:19:42 +0100 Subject: #19 README rewrite, sql-install-file --- README | 198 ++++++----------------------------------------------------------- 1 file changed, 18 insertions(+), 180 deletions(-) (limited to 'README') diff --git a/README b/README index 2ade9a5b..ddeafc79 100644 --- a/README +++ b/README @@ -1,185 +1,23 @@ += Installation eines frischen Engelsystems = -DIRS: ------ -./DB - Standart DB File -./www - daten fuer http verbindung -./www-ssl - daten fuer https verbindung +Mindestvorrausetzungen (bzw. getestet unter): + * PHP 5.3.3-7+squeeze3 with Suhosin-Patch (cgi-fcgi) + * mysqld Ver 5.1.49-3 for debian-linux-gnu on x86_64 ((Debian)) + * Webserver mit PHP-Anbindung, z.B. lighttpd, nginx oder Apache -Anfordeungen: -------------- - PHP 5.xx - mysql >=4.0 +Vorgehen: + * Auschecken der Dateien vom master unter https://vcs.wybt.net/engelsystem/git/ + * Der Webserver muss Schreibrechte auf das Verzeichnis import bekommen, für alle anderen Dateien reichen Leserechte. + * Der Webserver muss auf public als http-root zeigen. + * Empfehlung: Dirlisting sollte deaktiviert sein. + * Es muss eine MySQL-Datenbank angelegt werden und ein User existieren, der alle Rechte auf dieser Datenbank besitzt. + * Es muss die db/install.sql importiert/ausgeführt werden. + * Es müssen die Default-Configs von install/default-conf/*.php nach config/ kopiert werden. + * Die kopierten Configs in config/ müssen an die Installation angepasst werden, Erklärungen dazu gibt es in der jeweiligen Config-Datei. + * Engelsystem im Browser aufrufen, Anmeldung mit admin:admin vornehmen und Admin-Passwort ändern. -Systemconfig: -------------- -../includes/config.php - algemeien einstellungen -../includes/config_db.php - einstellungen der DB - Achtung: DB user braucht folgende Rechte: SELECT, CREATE, INSERT, ALTER, UPDATE, INDEX, DELETE, DROP - -php.ini: --------- -add: - allow_url_fopen = On ## deprecated, ought be removed - date.timezone = Europe/Berlin -Engelsystem Setup-Guide - -1. Installation des Grundsystems: -Ich gehe in der Doku von Debian Etch mit Apache2, mysql5 und php4 aus. - -1.1. Installieren der benoetigten Programme: - apt-get install vim apache2 mysql-common mysql-server php5-mysql \ - libapache2-mod-php5 subversion openssl ssl-cert - -1.2. Configuration von apache2: -Erstellen von http und https http-root: - mkdir /var/www/http/ - mkdir /var/www/https/ -Erstellen der SSL-Certifikate: - mkdir /etc/apache2/ssl/ - openssl req $@ -new -x509 -days 365 -nodes -out \ - /etc/apache2/ssl/apache.pem -keyout /etc/apache2/apache.pem - -Ausgabe: - Generating a 1024 bit RSA private key - writing new private key to ?/etc/apache2/ssl/apache.pem? - ... - Country Name (2 letter code) [AU]: DE - State or Province Name (full name) [Some-State]: B - Locality Name (eg, city): Berlin - Organization Name (eg, company) [Internet Widgits Pty Ltd]: CCC e.V. - Organizational Unit Name (eg, section): Angels - Common Name (eg, YOUR name): $server_url - Email Address: $admin_mail -Dann: - chmod 600 /etc/apache2/ssl/apache.pem - -Apache2 Configs: - /etc/apache2/sites-available/default: - -NameVirtualHost *:80 - - ServerAdmin webmaster@localhost - - DocumentRoot /var/www/http/ - - Options FollowSymLinks - AllowOverride None - - - Options Indexes FollowSymLinks MultiViews - AllowOverride None - Order allow,deny - allow from all - # This directive allows us to have apache2's default start page - # in /apache2-default/, but still have / go to the right place - #RedirectMatch ^/$ /apache2-default/ - - - ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/ - - AllowOverride None - Options ExecCGI -MultiViews +SymLinksIfOwnerMatch - Order allow,deny - Allow from all - - - ErrorLog /var/log/apache2/error.log - - # Possible values include: debug, info, notice, warn, error, crit, - # alert, emerg. - LogLevel warn - - CustomLog /var/log/apache2/access.log combined - ServerSignature On - - Alias /doc/ "/usr/share/doc/" - - Options Indexes MultiViews FollowSymLinks - AllowOverride None - Order deny,allow - Deny from all - Allow from 127.0.0.0/255.0.0.0 ::1/128 - - - - - /etc/apache2/sites-available/https: - - - # SSL (START) - SSLEngine on - SSLCertificateFile /etc/apache2/ssl/apache.pem - SSLCertificateKeyFile /etc/apache2/apache.pem - - # SSL (ENDE) - ServerAdmin ichdasich@jabber.ccc.de - - #kann auch einfach eine IP sein - ServerName localhost - DocumentRoot /var/www/https - - Order Deny,Allow - Allow from all - # Zeige keine Verzeichnisse an - Options -Indexes - AddDefaultCharset ISO-8859-1 - - - - /etc/apache2/ports.conf: - -Listen 80 -Listen 443 - -Dann: - a2enmod ssl - a2ensite https - /etc/init.d/apache2 restart - -1.3. MySQL configurieren: -MySQL-Passwort fuer root setzen: - mysql -u root mysql - UPDATE user SET Password=PASSWORD('neues_passwort') WHERE user='root'; - mysql> FLUSH PRIVILEGES; - mysql -u root -p - mysql> CREATE DATABASE tabel; - -2. Engelsystem besorgen und installieren: - -2.1. Auschecken aus dem SVN: - cd /root/ - svn co svn://svn.cccv.de/engel-system - -2.2. Kopieren der Dateien ins http/s-root: - cp /root/engel-system/www/* /var/www/http/ - cp /root/engel-system/www-ssl/* /var/www/https/ - cp /root/engel-system/default-conf/www-ssl/inc/ /var/www/https/ - -2.3. Bearbeiten der Configurationsdatein: - vim /var/www/https/inc/config_db.php - -> Daten entsprechend anpassen - vim /var/www/https/inc/config.php - $url: url des servers - $ENGEL_ROOT = "/"; -2.4. Einfuegen der Datenbanken: - mysql tabel -u root -ppassword < ChangeLog.sql - mysql tabel -u root -ppassword < Himmel.sql - mysql tabel -u root -ppassword < Messages.sql - mysql tabel -u root -ppassword < Sprache.sql - mysql tabel -u root -ppassword < User.sql - mysql tabel -u root -ppassword < UserCVS.sql - mysql tabel -u root -ppassword < UserPicture.sql - -3. Das Engelsystem an sich: - -3.1. User und Passwoerter: -Das System sollte nun funktionieren. Einloggen kann man sich mit 'admin:admin' -(aendern nicht vergessen ;-)). Es sollte sich dir dann die Adminoberflaeche des -Systems zeigen. +Das Engelsystem ist jetzt einsatzbereit. +Fehler bitte an bugs@engelsystem.de melden. +Trac: https://vcs.wybt.net/engelsystem/trac/ -- cgit v1.2.3-70-g09d2