diff -r 49b04b564ccc -r de0e8f8d3ce0 debian/README.Debian --- a/debian/README.Debian Fri Sep 02 16:17:56 2011 +0200 +++ b/debian/README.Debian Fri Sep 02 23:19:34 2011 +0200 @@ -1,6 +1,104 @@ littlebird for Debian --------------------- - +BEFORE INSTALLATION +=================== + +Just start with a normal Debian stable installation. (We tested the +packages on a minimal installation, no X, no MC, just about the +essential packages. Everything else will be pulled automatically.) +If you want to see German dialogs during installation, you should +activate the German language environment. + +Before installing the trustcenter packages, you need to add the +following lines to your sources list or install the following snippet as +"/etc/apt/sources.list.d/littlebird.list": + +::::8<----- +// file: /etc/apt/sources.list.d/littlebird.list +deb http://apt.net.schlittermann.de/debian-ius squeeze non-free +deb http://repos.zend.com/zend-server/deb server non-free +::::8<----- + +Then update the package information: + + # aptitude update + +(Probably you did already if you're reading this file from an installed +package ☺) + +* MySQL * + +The Trustcenter application needs access to some MySQL database. This +database does not need to run on the same host (therefore our packages +do not depend on the mysql-server). The trustcenter install process will +ask you for the ADMIN user and ADMIN password to access the database +server. We need this to install the database schema, create the +trustcenter user, and define some functions. + +You need the AMIN user and ADMIN password to access the MySQL server. +If you do not have any MySQL server, please install: + + # aptitude install mysql-server + +PACKAGES +======== + +littlebird consists of the following packages: + + littlebird-tc - virtual package to ease installation + littlebird-tc-common - needed by all the other packages + littlebird-tc-core - the trustcenter web application + littlebird-tc-sql - sql scripts for database initialization + + +Once you know the ADMIN credentials to access your MySQL server, you +might: + + # aptitude install littlebird-tc + +This will install all necessary packages, including the zend* packages. +The littlebird-tc-sql is only pulled as recommended package, it depends +on the configuration of your package manager, if it will be installed. + +If you need to preseed the database and the package is not installed +already, you may want to + + # aptitude install littlebird-tc-sql + +(But normally it gets installed automagically.) + + +CONFIGURATION and RE-CONFIGURATION +================================== + +We did our best to ask the proper questions. Please do your best to give +the proper answers. If you want to reconfigure your littlebird +trustcenter, you might run "dpkg-reconfigure": + +For initialization of the database: + + # dpkg-reconfigure littlebird-tc-sql + +For database connection information (db name, db host, db user, …) + + # dpkg-reconfigure littlebird-tc-common + +For webserver setup (servername, serverport, SSL-Certificates, …) + + # dpkg-reconfigure littlebird-tc-core + +INSTALLED and NOW? +================== + +Take your browser and enter the servername you have choosen during +package configuration. If you didn't provide the SSL certificate, the +server will use a self signed cert, your browser will complain, it's up +to you to accept it anyway. + +For further interaction with the trustcenter application you need a +client certificate. Please ask Little Bird for this certificate and +import it into your browser. + -- Heiko Schlittermann Tue, 30 Aug 2011 11:28:39 +0200