Erstinstallation von kibeo

Nach dem Download der Programmpakete sind CGI-Skripte in das entsprechende Server-Verzeichnis zu kopieren, sowie Verzeichnisse für Konfiguration, Layout und Daten anzulegen. Die Verzeichnisse werden automatisch oder manuell in Beziehung gesetzt.

Zur Installation benötigte Dateien

• cgi-bin.zip
• config.zip
• layout.zip

Voraussetzungen auf Ihrem Server

• Linux: Apache Web-Server, Perl
• Windows: IIS oder Apache, Perl
• Linux/Windows: Perl-Module
  - Digest::SHA1
  - File::Basename
  - IO::File
  - CGI::Carp
  - Archive::Zip
  - Log::Log4perl
  - LWP::UserAgent
  - Fcntl
  - File::Copy
  - File::Path
  - Digest::MD5
  - POSIX
  - base
  - Text::ParseWords
  - Carp
  

Erstellen der Verzeichnisse und Entpacken der Dateien

• In das CGI-Verzeichnis des Servers (z.B. "cgi-bin") sind die Dateien aus cgi-bin.zip zu entpacken.
• Die Perl-Skripte sind für WWW-Benutzer ausführbar zu machen, d.h. für *.pl und *.pm ist das x-Bit zu setzen (chmod 755).
• Nun kann ein CGI- und Perl-Modul-Test mit Hilfe von perltest.cgi durchgeführt werden:
  z.B. http://servername/cgi-bin/perltest.cgi
  Dieser Test prüft, ob alle erforderlichen Perl-Module auf dem Server installiert sind und macht auf eventuell erforderliche Perl-Modulinstallationen aufmerksam.

Config-Verzeichnis

• Es ist ein Verzeichnis namens "config" anzulegen: /basis/config ("basis" ist z.B. "/var/www").
• Die Dateien aus config.zip sind in dieses Verzeichnis entpacken.
• Diese Dateien sind für WWW-Benutzer schreibbar zu machen.

Daten-Verzeichnis

• Es ist ein Verzeichnis namens "daten" anzulegen: /basis/daten ("basis" ist z.B. "/var/www").
• Das Datenverzeichnis ist für WWW-Benutzer schreibbar zu machen.

HTML-Verzeichnis

• Das Verzeichnis /basis/html ("basis" ist z.B. "/var/www") sollte nun schon vorhanden und für WWW-Benutzer schreibbar sein.
• Das Verzeichnis /basis/html/_layout ist anzulegen. In diesem Verzeichnis werden die benutzen Stylesheets (boersenav.css und boersetext.css) sowie das Icon für die Hilfefunktion abgelegt.
• Die Dateien aus layout.zip sind in dieses Verzeichnis zu entpacken.
• Die Dateien sind für WWW-Benutzer lesbar zu machen.

Automatische oder manuelle Installation

Um die Verzeichnisse miteinander in Bezug zu setzen, kann nun automatisch oder manuell (durch Editieren der Datei ConfigLocal.pm) weitergearbeitet werden.

Bei der automatischen Installation werden die Verzeichnisse von dem zuerst gestarteten Skript (z.B. der Administrator-Maske admin.pl) gesucht und in der Datei ConfigLocal.pm hinterlegt. Die automatische Installation ist empfehlenwert,

• wenn kibeo als Hauptanwendung im Root-Verzeichnis des Webservers installiert werden soll,
• wenn mehrere Instanzen auf einem Web-Server mit nur einem cgi-bin-Verzeichnis laufen sollen.

Bei der manuellen Installation muss man mehr konfigurieren, hat dafür aber mehr Kontrolle beim Anlegen der Verzeichnisse.  Diese Variante ist empfehlenwert, wenn man die Web-Server-Verzeichnisse nicht beinflussen kann, evtl. bei Installation auf einem Standard-Web-Hosting-System.

Automatische Installation

Zur automatischen Installation muss eventuell die Apache-Konfiguration angepasst werden.

• basis ist z.B. /var/www.
• CGI-Skripte laufen in /basis/cgi-bin (dieses Verzeichnis ist evtl. vom Web-Hoster vorgegeben).
• Das Config-Verzeichnis ist /basis/config.
• Die Daten liegen in /basis/daten.
• Die statischen html-Dateien liegen unter /basis/html oder /basis/htdocs (auch dieses Verzeichnis ist evtl. vom Web-Hoster vorgegeben).

Der Aufruf von z.B. /basis/cgi-bin/admin.pl erkennt die Verzeichnisstruktur und editiert die Datei ConfigLocal.pm entsprechend.

Manuelle Konfiguration mit ConfigLocal.pm

• Die CGI-Skripte sind installiert in /var/www/kita-boerse/cgi-bin
• "basis" soll sein: /var/www/kita-boerse/cgi-bin.
• Das Konfigurationsverzeichnis ist /basis/config.
• Die Daten liegen in /basis/daten
• Die statischen html-Dateien liegen in /var/www/kita-boerse.

In diesem Fall ist in /var/www/kita-boerse/cgi-bin/ConfigLocal.pm folgender Eintrag zu machen:

• $LocalBasis='/var/www/kita-boerse/cgi-bin'

LocalBasis definiert, wo die Verzeichniss config und daten liegen. In diesem Beispiel werden die Pfade im CGI-Verzeichniss abgelegt, damit die Daten nicht durch den Web-Server direkt ausgeliefert werden können (sondern nur die generierten statischen Seiten bzw. nur durch cgi-Skripte).

Desweiteren sollte in ConfigLocal.pm der Pfad für den Dateimanager angegeben, bzw. eingeschränkt werden, damit der Administrator im Dateimanager den richtigen Pfad sieht:

• $BasisDateimanager='/var/www/kita-boerse';

Um zu definieren, dass die CGI-Programme ausgeführt werden, kann im Verzeichnis /var/www/kita-boerse/cgi-bin z.B. folgende .htaccess angelegt werden:

• Options +ExecCGI
• SetHandler cgi-script

Start der Administratormaske und Setzen des Administator-Passwortes

Die Administrationsmaske von kibeo kann nun aufgerufen werden mit

• http://servername/cgi-bin/admin.pl
  Benutzername: 'admin'
  Passwort: '' <noch keines vergeben>
  

Unter dem Navigationspunkt "Konfiguration", Schaltfläche "Bearbeiten" ist

• das Admin-Passwort zu setzen und
• "Passwort-Prüfung" auf "SHA1" zu setzen, da sonst prinzipiell keine Passwort-Prüfung stattfindet.
  

Konfiguration von kibeo

kibeo wird in einer Form ausgeliefert, die sich zunächst an der Darstellung von Kitas unter www.kita-bayern.de (z.B. www.kita-bayern.de/n/mikro) orientiert. Sie können diese dann natürlich optisch und inhaltlich ändern.

Weitere Fragen

Wenn Sie Fragen haben, wenden Sie sich bitte per E-Mail an kibeo @ iska-nuernberg.de.

Aktualisiert am 30.05.2008 - Startseite           ▲ nach oben