4 <possible notes regarding this package - if none, delete this file>

     4 BEFORE INSTALLATION

     5 ===================

     6 

     7 Just start with a normal Debian stable installation. (We tested the

     8 packages on a minimal installation, no X, no MC, just about the

     9 essential packages. Everything else will be pulled automatically.)

    10 If you want to see German dialogs during installation, you should

    11 activate the German language environment.

    12 

    13 Before installing the trustcenter packages, you need to add the

    14 following lines to your sources list or install the following snippet as

    15 "/etc/apt/sources.list.d/littlebird.list":

    16 

    17 ::::8<-----

    18 // file: /etc/apt/sources.list.d/littlebird.list

    19 deb http://apt.net.schlittermann.de/debian-ius squeeze non-free

    20 deb http://repos.zend.com/zend-server/deb server non-free

    21 ::::8<-----

    22 

    23 Then update the package information:

    24 

    25     # aptitude update

    26 

    27 (Probably you did already if you're reading this file from an installed

    28 package ☺)

    29 

    30 * MySQL *

    31 

    32 The Trustcenter application needs access to some MySQL database. This

    33 database does not need to run on the same host (therefore our packages

    34 do not depend on the mysql-server). The trustcenter install process will

    35 ask you for the ADMIN user and ADMIN password to access the database

    36 server. We need this to install the database schema, create the

    37 trustcenter user, and define some functions.

    38 

    39 You need the AMIN user and ADMIN password to access the MySQL server.

    40 If you do not have any MySQL server, please install:

    41 

    42     # aptitude install mysql-server

    43 

    44 PACKAGES

    45 ========

    46 

    47 littlebird consists of the following packages:

    48 

    49     littlebird-tc	    - virtual package to ease installation

    50     littlebird-tc-common    - needed by all the other packages

    51     littlebird-tc-core	    - the trustcenter web application

    52     littlebird-tc-sql	    - sql scripts for database initialization

    53 

    54 

    55 Once you know the ADMIN credentials to access your MySQL server, you

    56 might:

    57 

    58     # aptitude install littlebird-tc

    59 

    60 This will install all necessary packages, including the zend* packages.

    61 The littlebird-tc-sql is only pulled as recommended package, it depends

    62 on the configuration of your package manager, if it will be installed.

    63 

    64 If you need to preseed the database and the package is not installed

    65 already, you may want to

    66 

    67     # aptitude install littlebird-tc-sql

    68 

    69 (But normally it gets installed automagically.)

    70 

    71 

    72 CONFIGURATION and RE-CONFIGURATION

    73 ==================================

    74 

    75 We did our best to ask the proper questions. Please do your best to give

    76 the proper answers. If you want to reconfigure your littlebird

    77 trustcenter, you might run "dpkg-reconfigure":

    78 

    79 For initialization of the database:

    80 

    81     # dpkg-reconfigure littlebird-tc-sql

    82 

    83 For database connection information (db name, db host, db user, …)

    84     

    85     # dpkg-reconfigure littlebird-tc-common

    86 

    87 For webserver setup (servername, serverport, SSL-Certificates, …)

    88 

    89     # dpkg-reconfigure littlebird-tc-core

    90 

    91 INSTALLED and NOW?

    92 ==================

    93 

    94 Take your browser and enter the servername you have choosen during

    95 package configuration. If you didn't provide the SSL certificate, the

    96 server will use a self signed cert, your browser will complain, it's up

    97 to you to accept it anyway.

    98 

    99 For further interaction with the trustcenter application you need a

   100 client certificate. Please ask Little Bird for this certificate and

   101 import it into your browser.

   102