--- 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
---------------------
-<possible notes regarding this package - if none, delete this file>
+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 <hs@schlittermann.de> Tue, 30 Aug 2011 11:28:39 +0200
--- a/debian/README.source Fri Sep 02 16:17:56 2011 +0200
+++ b/debian/README.source Fri Sep 02 23:19:34 2011 +0200
@@ -1,8 +1,7 @@
littlebird for Debian
---------------------
-1. obtain the source littlebird*.tar.gz from
- schlittermann@92.51.155.210
+1. obtain the source littlebird*.tar.gz from scp://92.51.155.210/*.tar.gz
2. rename the archive to littlebird-YYYYMMDDNN.orig.tar.gz
(NN is some per day increment)
--- a/debian/control Fri Sep 02 16:17:56 2011 +0200
+++ b/debian/control Fri Sep 02 23:19:34 2011 +0200
@@ -1,19 +1,11 @@
Source: littlebird
-Section: unknown
+Section: non-free/misc
Priority: extra
Maintainer: Heiko Schlittermann <hs@schlittermann.de>
Build-Depends: debhelper (>= 7.0.50~), po-debconf
Standards-Version: 3.8.4
-Homepage: <insert the upstream URL, if relevant>
-#Vcs-Git: git://git.debian.org/collab-maint/littlebird.git
-#Vcs-Browser: http://git.debian.org/?p=collab-maint/littlebird.git;a=summary
-
-#Package: littlebird-tc
-#Architecture: all
-#Depends: littlebird-tc-core
-#Description: the littlebird trust center
-#Replaces: littlebird (<< ${source:Version})
-#Breaks: littlebird (<< ${source:Version})
+Homepage: http://little-bird.de/
+Vcs-Browser: https://ssl.schlittermann.de/hg/littlebird/packaging/deb
Package: littlebird-tc-common
Architecture: all