install manual
authorHeiko Schlittermann (JUMPER) <hs@schlittermann.de>
Fri, 02 Sep 2011 23:19:34 +0200
changeset 35 de0e8f8d3ce0
parent 34 49b04b564ccc
child 36 d444e27e2aaf
install manual
debian/README.Debian
debian/README.source
debian/control
--- 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