Installation und Deployment des 
iX Pizza Online Services (Teil 3)

Inhalt

1. Installation	
2. Deployment 
3. InstantDB Datenbank

------------------------------

1. Installation

Der Pizza Online Store ist so konzipiert, 
dass er in einem beliebigen Pfad installiert 
werden kann. Sämtliche Einstellungen werden
dabei mit Hilfe der folgender Umgebungsvariablen 
vorgenommen:

JAVA_HOME : Root Verzeichnis des JDKs. Wird u.a. 
	    als Basisverzeichnis zum Auffinden des
            Java-Comilers und Jar-Tools verwendet.

	    Beispiel: Das JDK 1.2.2 befindet sich im 
                      Verzeichnis D:\jdk\jdk1.2.2
                      
                      JAVA_HOME = D:\jdk\jdk1.2.2	

JSPTUT:	    Root Verzeichnis des JSP Tutorials Teil 3.
            Hierbei handelt es sich um jenes Verzeichnis
	    in welchem das jspTutorial Zip-File entpackt 
            wurde. 

	    Beispiel: jspTutorial_III.zip wurde in 
	              C:\tutorials\ix\jspTutorial_III
                      enpackt.

		      JSPTUT = C:\tutorials\ix\jspTutorial_III
		 	


------------------------------

2. Deployment

Im Verzeichniss %JSPTUT%/develop befindet sich ein Script namens
deployit mit dessen Hilfe - bei korrekt gesetzten Umgebungsvariablen -
das komplette Projekt compiliert und in Form eines JAR Files deployed
wird.

Die eigentliche Web-Applikation findet sich nach dem Ausführen des oben 
genannten Scripts in %JSPTUT%/develop/sources/jspTutorial-app, wobei die 
JSP Seiten unter %JSPTUT%/develop/sources/jspTutorial-app/jspTutorial und die 
Klassen (als jar) unter %JSPTUT%/develop/sources/jspTutorial-app/WEB-INF/lib
zu finden sind.

Um die Web-Applikation unter TomCat bekannt zu machen sollte sich folgender
Eintrag in der Datei Konfigurationsdatei server.xml finden

	<!-- ix JSP Tutorial -->
        <Context path="/jspTutorial" docBase="C:/tutorials/ix/jspTutorial_III/develop/sources/jspTutorial-app" debug="0" reloadable="true" > 
        </Context>
      
wobei in diesem Beispiel davon ausgegangen wird, dass das Tutorial im Verzeichnis
C:/tutorials/ix/jspTutorial_III/ installiert wurde.

Zur Installation von TomCat selbst sollte die zugehörige Dokumentation
oder das iX jspTutorial Teil (ix 07/2000) gelesen werden.


------------------------------

3. Instant DB 

Das Tutorial wird mit einer vorkonfiguierten 100% pure Java
DB zur Verfügung gestellt. Beidieser DB handelt es sich um 
eine Free DB namens InstantDB (siehe Artikel) die sich im
Verzeichnis

%JSPTUT%/develop/sources/jspTutorial-app/WEB-INF/config/idb 

befindet. 

Soll die DB neu initialiesiert werden, muss lediglich das
Script dbinstall aufgerufen werden. Auch dieses Script basiert wieder 
auf den oben angegebenen Umgebungsvariablen.

Falls jemand Lust auf mehr Zutaten oder andere Pizzen verspürt, so
können diese in den TXT Files 

- pizza

und

- ingredient 

im selben Verzeichnis eingetragen werden. Die dort hinterlegten 
Informationen werden dann bei der nächsten DB Installation 
berückichtigt.

------------------------------

4. XML Mail Order

In letzter Minute haben wir uns doch noch entschlossen den 
ServletContext für die Parameter des MailHelper zu nutzen.
in der %JSPTUT%/develop/sources/jspTutorial-app/WEB-INF/web.xml

Bitte tragen Sie Ihren Pizzabäckerempfänger und Mail Server Adresse ein:
	

<webapp>
	...
	<context-param>
		<param-name>USE_EMAIL</param-name>
		<param-value>true</param-value>
		<description>Mail order used</description>
	</context-param>
	<context-param>
		<param-name>MAIL_DEBUG</param-name>
		<param-value>true</param-value>
		<description>Mail debug on</description>
	</context-param>
	<context-param>
		<param-name>MAIL_RECIPIENT</param-name>
		<param-value>pizzabaecker@localhost</param-value>
		<description>Mail recipient</description>
	</context-param>
	<context-param>
		<param-name>MAIL_SMTP_HOST</param-name>
		<param-value>localhost</param-value>
		<description>Mail smtp SERVER</description>
	</context-param>
	...
</webapp>

Wenn die Einträge fehlen, werden die Konstanten aus de.ix.jspTutorial.constants.MailConstants
genutzt.


Viel Spaß 

Peter Roßbach (pr@webapp.de)
Lars Röwekamp (lars.roewekamp@openKnowledge.de)
