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 main contrib non-free
deb http://repos.zend.com/zend-server/deb server non-free
::::8<-----

You need to get the keys of the above repositories:

    wget http://repos.zend.com/zend.key -O- | apt-key add -
    wget https://ssl.schlittermann.de/apt.key -O- | apt-key add -

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, …)
NOTE: this does not update the application_installation.ini, please
run dpkg-reconfigure littlebird-tc-core instead! (Will be fixed soon)
    
    # 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 chosen 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 <hs@schlittermann.de>  Tue, 30 Aug 2011 11:28:39 +0200
