1 History

• 2006-12-30 phm makes http://a2e.de/cgi-bin/aktiv run, removes an old bug that prevented people from giving themselves their desired user names upon registry
• 2006-12-30 phm removes dependency on special Perl version, stores former ffii local [file:/home/mwasmeier/perllibbeta/share/perl] libraries at local [file:/foldi/ul/src/mwasperllib.tbz] just in case
• 2006-12-28 phm creates this directory.

2 Files

• aktiv.pl
• Aktiv2Knecht.pm: interface from aktiv to Knecht.pm, designed to minimize influence of any changes of Knecht.pm
• Knecht.pm: common query services needed by various applications, including web, but especially mail. Mail queries used to be answered by knecht at ffii org, as documented at http://old.ffii.org/assoc/knecht/.
• knechttest.pl: testsuite for the Knecht.pm library. requires commandline arguments, see Makefile ‘test’ target for an example
• A2E::db: database querying module: an additional layer of abstraction on top of DBI, to hide access data and simplify queries provided that the tables conform to certain constraints; to be published soon.
  • PostgreSQL: contains authentication data files for various databases, encrypted and ready to be installed for use by the A2E::db module
• dependencies in the local file system: greatly reduced if ‘rdbonly’ switch is on
  • [file:/var/www/]: knecht base directory, needed as argument to ‘newdir’, even when ‘rdbonly’ is on
  • [file:/var/www/www/verein/verbdefs.txt]: database structure definitions
  • [file:/var/www/www/verein/perm.txt]: permissions
  • [file:/var/www/www/verein/cmima]: member directories, now largely defunct, needed for
    • mail processing functionality (which still does not work on rdb alone)
    • admin password file (which should also be replaced by info taken from the db ‘pass’ table)
• CPAN Dependencies: HTML::Template, HTML::FillInForm, Data::FormValidator, Mail::Sendmail, Log::Agent
• Makefile: contains some rules for the local installations on a2e.de machines

# - i2p_perl: private files related to this work

3 To Do

• remove base directory concept, reduce everything to ‘rdbonly’ mode, clean out remaining file dependencies, except perhaps for perm.txt and verbdefs.txt, which should then be moved out of the base directory to something like /etc/knecht/.
• write an installation script, INSTALL and README file, create a tar.gz package
• possibly even move the verbdefs.txt part into the A2E::db module
• make packages more consistently object-oriented and modular, possibly replace some parts by more modern modules
• move parts of aktiv.pl into external perl packages, create testsuite scripts for these
• make ‘knechttest’ usable without commandline parameters
• allow users to change their mail addresses (implies partial reiteration of initial registration procedure with session-id etc)