[deepamehta-devel] DeepaMehta installieren aus dem SVN-Repository

[Jörg Richter]

Liebe DeepaMehta-Entwickler,

die aktuelle DeepaMehta Version mit integrierter HSQL Datenbank und 
Gruppenkalender-Funktion kann direkt aus dem Berlios SVN-Repository 
ausgecheckt und gebuildet werden. Beachte: das ist noch keine fertige 
Release. Die nächste DeepaMehta 2.0b8 Release ist für Dezember geplant. 
Die aktuelle SVN-Version sollte aber funktionieren. Das README ist noch 
nicht aktualisiert und zu großen Teilen obsolet. Deshalb gebe ich hier 
ein paar Installationshinweise.


Quick Installation Guide
==================

0) Du brauchst ein Java SDK 1.4 -- Java 5 oder Java 6 funktionieren 
nicht!
1) Auschecken:
		svn checkout svn://svn.berlios.de/deepamehta/trunk deepamehta
2) DB-Verzeichnis anlegen:
		cd deepamehta
		mkdir install/client/db
		mkdir install/client/db/hsqldb-intern
3) Konfigurieren:
		./run.sh config
	Beantworte alle Fragen mit Return
4) Builden:
		./run.sh build
5) Installieren:
		./run.sh install
	Beantworte die Frage mit Return
6) Starten:
		./run.sh dm
	Es erscheint der DeepaMehta-Login-Dialog.
	Gebe "root" ein und drücke 2x Return.
	Der DeepaMehta Desktop erscheint.



Installation Guide
=============

0) Voraussetzungen
1) Auschecken
2) DB-Verzeichnis anlegen
3) Konfigurieren
4) Builden
5) Installieren
6) Deployen der Web-Frontends
7) Starten
8) Beenden
9) Wie geht's weiter?
10) Was bleibt offen?


0) Voraussetzungen

- Java SDK 1.4 -- wird zum Builden benötigt.
ACHTUNG: DeepaMehta kann derzeit nicht mit Java 5 oder Java 6 gebuildet 
werden.
- Java JRE ab 1.4 (Versionen 5 und 6 gehen auch) -- wird zum Starten 
benötigt.
Hinweis: das JRE ist im SDK enthalten.

Optional:
- MySQL (Version 4 oder 5) -- wird nur benötigt, wenn nicht HSQL 
benutzt werden soll.
- Tomcat (ab 4) -- wird nur benötigt, wenn die DeepaMehta 
Beispiel-Webfrontends benutzt werden sollen.

Nicht benötigt:
- HSQL und Ant müssen nicht installiert werden, da DeepaMehta diese 
Software selber mitbringt.


1) Auschecken

	svn checkout svn://svn.berlios.de/deepamehta/trunk deepamehta

Im aktuellen Verzeichnis wird dann das DeepaMehta-Homeverzeichnis 
"deepamehta" angelegt. Du kannst das Homeverzeichnis auch anders nennen 
(letzter Parameter).

Wenn das Auschecken erfolgreich war, wird "Checked out revision 240." 
(o.ä.) angezeigt.


2) DB-Verzeichnis anlegen

Nur wenn die mitgelieferte HSQL-Datenbank benutzt werden soll, müssen 
jetzt 2 Verzeichnisse manuell angelegt werden.

	cd deepamehta
	mkdir install/client/db
	mkdir install/client/db/hsqldb-intern

Hinweis: Daß diese Verzeichnisse manuell angelegt werden müssen, ist 
ein Fehler im derzeitigen DeepaMehta-Installer. Mit der DeepaMehta 
2.0b8 Release wird dieser Schritt entfallen.


3) Konfigurieren

Jetzt wird die DeepaMehta-Installation konfiguriert.

	./run.sh config

Dir werden ein paar Fragen gestellt, wobei die Standard-Antwort, die 
einfach durch Drücken von Return ausgelöst wird, in eckigen Klammern 
angegeben ist.

Als erstes wirst Du gefragt, ob Du auch die DeepaMehta 
Beispiel-Webfrontends benutzen möchtest. Wenn Ja, mußt Du angeben, wo 
das Tomcat Home-Verzeichnis ist.

	[input] Do you want to install web applications? (y, [n])

	[input] Please enter the root directory of your application server. 
[/usr/local/tomcat]

Dann wirst Du gefragt, in welcher Datenbank DeepaMehta seine Daten 
ablegen soll. Wenn die HSQL-Datenbank benutzt werden soll, drücke 
einfach Return.

	[echo] Please select one of the following instance configurations:
	[echo]
	[echo] * derby-intern
	[echo] * hsqldb-intern
	[echo] * mysql4
	[echo] * mysql5
	[echo]
	[input] currently set (default) [hsqldb-intern]

Dann wirst Du nach dem Namen der anzulegenden Datenbank gefragt. Gebe 
den Namen der anzulegenden Datenbank ein, oder drücke einfach Return.

	[input] Please enter the name of your database: [DeepaMehta]

Dann wirst Du gefragt, welche der mitgelieferten Beispiel-Anwendungen 
Du installieren möchtest. Die Entscheidung steht Dir frei. Auch ohne 
Beispielanwendungen ist DeepaMehta nutzbar.

	[input] Shall the example kompetenzstern be processed? ([y], n)
	[input] Shall the example messageboard be processed? ([y], n)
	[input] Shall the example ldap be processed? ([y], n)
	[input] Shall the example movies be processed? ([y], n)

Sofern Du das "movies" Beispiel installieren möchtest, wirst Du jetzt 
nach der Art der Datenquelle gefragt, die für das movies-Beispiel 
angelegt werden soll.

	[echo] Please select one of the following instance configurations:
	[echo]
	[echo] * derby-intern
	[echo] * hsqldb-intern
	[echo] * mysql4
	[echo] * mysql5
	[echo] * xml
	[echo]
	[input] currently set (default) [hsqldb-intern]

Sofern Du "hsqldb-intern" ausgewählt hast, wirst Du jetzt nach dem 
Namen der anzulegenden Beispiel-Film-Datenbank gefragt.

	[input] Please enter the name of your database: [Movies]

Weitere Beispiel-Anwendungen werden angeboten:

	[input] Shall the example dm-browser be processed? (y, [n])
	[input] Shall the example dm-search be processed? (y, [n])	[input] 
Shall the example dm-topicmapviewer be processed? (y, [n])
	[input] Shall the example dm-web be processed? (y, [n])
	[input] Shall the example knoppixforum be processed? (y, [n])
	[input] Shall the example musicforum be processed? (y, [n])

Wenn die Konfiguration erfolgreich beendet wurde, wird "BUILD 
SUCCESSFUL" angezeigt.


4) Builden

Zum Builden von DeepaMehta und der zuvor ausgewählten 
Beispiel-Anwendungen gebe folgendes Kommando ein:

	./run.sh build

Wenn das Builden erfolgreich beendet wurde, wird "BUILD SUCCESSFUL" 
angezeigt.


5) Installieren

Zum Anlegen der initialen DeepaMehta-Datenbank gebe folgendes Kommando 
ein:

	./run.sh install

Dir werden nochmal die konfigurierten Datenbank-Angaben gezeigt. Sobald 
Du Return drückst wird die DeepaMehta-Datenbank angelegt und mit den 
initialen Inhalten gefüllt.

	[echo] --- DeepaMehta Installation ---
	[echo] You are about to create a database 'DeepaMehta' and an
	[echo] user 'sa' (password '') with corresponding grants.
	...
	[input] Continue?  ([y], n)

Sofern Du beim Konfigurieren die Movies-Beispielanwendung ausgewählt 
hast, und "hsqldb-intern" als Datenquelle gewählt hast, wird jetzt die 
Movies-Beispiel-Datenbank angelegt.

	[echo] --- DeepaMehta Installation ---
	[echo] You are about to create a database 'Movies' and an
	[echo] user 'sa' (password '') with corresponding grants.
	...
	[input] Continue?  ([y], n)

Wenn die Datenbanken erfolgreich angelegt wurden, wird "BUILD 
SUCCESSFUL" angezeigt.


6) Deployen der Web-Frontends

Wenn Du beim Konfigurieren gesagt hast, daß Du die DeepaMehta 
Beispiel-Webfrontends benutzen möchtest, gebe zum Deployen folgendes 
Kommando ein:

	./run.sh deploy


7) Starten

Die monolithische DeepaMehta-Anwendung wird mit folgendem Kommando 
gestartet:

	./run.sh dm

Es erscheint der DeepaMehta-Login-Dialog. Gebe "root" ein und drücke 2x 
Return (initial hat der DeepaMehta-root-User kein Passwort). Der 
DeepaMehta Desktop erscheint.


8) Beenden

Zum Beenden der DeepaMehta-Sitzung drücke das Schließen-Feld des 
DeepaMehta-Fensters.


9) Wie geht's weiter?

Ein paar Bedienhinweise für den Anfang findest Du in unserem Wiki:
https://www.mindworxs.de/zwiki/ErsteSchritte

Den Beginn eines Users Guides gibt es hier:
www.deepamehta.de/docs/usersguide.html

Für Deine Fragen benutze möglichst das Forum auf der DeepaMehta Website 
oder abboniere die deepamehta-users Mailingliste. Im Forum befinden 
sich bereits wichtige Hinweise zur Bedienung. Forum und Mailinglisten 
sind auf der Website unter "Community" zu erreichen.


10) Was bleibt offen?

Soweit die Kurzanleitung zur Inbetriebnahme der aktuellen 
DeepaMehta-Version aus dem Berlios SVN-Repository. Viele Themen sind 
hier nicht erklärt. Dazu gehören:
- DeepaMehta Client/Server Szenario
- Das Client-Applet
- Zweck und Funktionalität der mitgelieferten Beispiel-Anwendungen
- DeepaMehta Beispiel-Wenfrontends unter Tomcat
- Einrichten weiterer DeepaMehta Instanzen
- Vorhandene DeepaMehta Installation updaten
- DeepaMehta deinstallieren