In diesem Dokument wird Tomcat als Beispiel Servletengine und Apache als Beispiel Webserver verwendet.

Transkript

1 JArt Administration Installation Voraussetzungen: 1. Java Rutime Environment Version oder höher 2. Java Servletengine (Tomcat wird empfohlen) (anbindung der Servletengine an Apache oder IIS empfohlen) MB freier RAM (512 MB empfohlen) MB (+ Projektgröße) Festplattenspeicher (100 MB empfohlen) In diesem Dokument wird Tomcat als Beispiel Servletengine und Apache als Beispiel Webserver verwendet. Generell gibt es zwei Installationsvarianten. Installation als shared Application In dieser Variante werden die Klassen des JArt Systems von allen Instanzen gemeinsam genutzt. Diese Variante wird bei Providern oder Betrieben die mehr als eine Instanz des JArt Systems auf einem Server betreiben empfohlen. Der Arbeitspeicherverbrauch wird durch diese Installations-Variante deutlich reduziert. 1. Installation der Libraries: Kopieren Sie die Dateien aus dem Verzeichnis Installation-Shared/lib in das shared lib Verzeichnis der Servletengine (Tomcat: [tomcat directory]/shared/lib). 2. Installation der Klassen: Kopieren Sie die Dateien aus dem Verzeichnis Installation-Shared /classes in das shared classes Verzeichnis der Servletengine (Tomcat: [tomcat directory]/shared/classes). 3. Installation der JArt WebApp Dateien: Kopieren Sie alle Dateien und Ordner aus dem Verzeichnis Installation-Shared /jart in das Basisverzeichnis der gewünschten Web Applikation oder falls keine eigene Web Applikation verwendet wird, den gesamtem Ordner Installation-Shared /jart in das WebApp Verzeichnis der Servletengine.

2 Installation als single Application In dieser Variante werden alle Klassen pro Instanz des JArt Systems extra geladen. 1. Installation der JArt WebApp Dateien: Kopieren Sie alle Dateien und Ordner aus dem Verzeichnis Installation-Single/jart in das Basisverzeichnis der gewünschten Web Applikation oder falls keine eigene Web Applikation verwendet wird, den gesamtem Ordner Installation-Single /jart in das WebApp Verzeichnis der Servletengine. Beispiel Tomcat server.xml In diesem Beispiel gilt /home/jart/webspace als Webroot und /home/jart/webspace/jart als Basisverzeichnis der Webapplikation. <Server debug="0" port="8005" shutdown="shutdown"> <Service name="tomcat-standalone"> <Connector acceptcount="10" classname="org.apache.coyote.tomcat4.coyoteconnector" connectiontimeout="20000" debug="0" enablelookups="true" maxprocessors="75" minprocessors="5" port="8009" protocolhandlerclassname="org.apache.jk.server.jkcoyotehandler" redirectport="8443" useurivalidationhack="false"/> <Engine debug="0" defaulthost="localhost" name="standalone"> <Logger classname="org.apache.catalina.logger.filelogger" prefix="catalina_log." suffix=".txt" timestamp="true"/> <Realm classname="org.apache.catalina.realm.userdatabaserealm" debug="0" resourcename="userdatabase"/> <Host appbase="/home/jart/webspace" autodeploy="true" debug="0" name=" unpackwars="true"> <Context crosscontext="true" debug="0" docbase="jart" path="/jart" reloadable="false"></context> </Host> <Host appbase="/home/jart/production" autodeploy="true" debug="0" name="edit.jart.at" unpackwars="true"> <Alias> <Context crosscontext="true" debug="0" docbase="jart" path="/jart" reloadable="false"></context> </Host> </Engine> </Service> <Service name="tomcat-remote"> <Connector acceptcount="10" classname="org.apache.coyote.tomcat4.coyoteconnector"

3 connectiontimeout="20000" debug="0" enablelookups="true" maxprocessors="75" minprocessors="5" port="8010" protocolhandlerclassname="org.apache.jk.server.jkcoyotehandler" redirectport="8443" useurivalidationhack="false"/> <Engine debug="0" defaulthost="localhost" name="standalone"> <Logger classname="org.apache.catalina.logger.filelogger" prefix="remote_log." suffix=".txt" timestamp="true"/> <Realm classname="org.apache.catalina.realm.userdatabaserealm" debug="0" resourcename="userdatabase"/> <!--<Host appbase="/home/jart/production" autodeploy="true" debug="0" name="localhost" unpackwars="true"> <Context crosscontext="true" debug="0" docbase="jart" path="/jart" reloadable="false"></context> </Host>--> </Engine> </Service> </Server> Verwendete Servlets und Filter 1. jartfilter (class: jart.jartfilter) Hauptfilter des JArt Systems, wird auf alle *.jart Dateien im Applikationsverzeichnis angewandt. 2. blobedit (class: jart.blobedit) Wird nur im editier Modus aufgerufen. Falls der Server generell gegen Schreibzugriffe blockiert werden soll, sollte dieses Servlet deaktiviert werden. 3. JArt web.xml: <web-app> <filter> <filter-name>jartfilter</filter-name> <filter-class>jart.jartfilter</filter-class> <init-param> <param-name>config-file</param-name> <param-value>/web-inf/jart-config.xml</param-value> </init-param> </filter> <filter-mapping> <filter-name>jartfilter</filter-name> <url-pattern>*.jart</url-pattern> </filter-mapping> <servlet> <servlet-name>blobedit</servlet-name>

4 <servlet-class>jart.blobedit</servlet-class> </servlet> <servlet-mapping> <servlet-name>blobedit</servlet-name> <url-pattern>/ed</url-pattern> </servlet-mapping> </web-app> JArt Konfiguration (jart-config.xml) Die jart-config.xml Datei finden Sie im WEB-INF Verzeichnis der JArt Webapplikation. Sie beinhaltet die JArt interne Konfiguration und Klassenbindung. Die Konfiguration wird beim Start der Webapplikation eingelesen, daher werden Änderungen in der Datei erst beim Neustart der Webapplikation aktiv. Folgende Nodes werden in der Konfiguration verwendet: config: Basis Node der Konfiguration property Applikationsweite globale Variablen des JArt Systems.. o name Name der Variable o value Zugeteilter Wert der Variable namespace-handler Bestimmt den Namespace für die jart Logik Nodes die über class als Kinder dieses Nodes festgelegt sind. o namespace-handler URI des zu verwendenden Namespace class Legt fest mit welcher Klasse ein bestimmter JArt Logik Node abgearbeitet wird. o node-name Name des Nodes o class Aufzurufende Klasse process-handler Legt einen Eintrag in der internen Prozesskette fest. Hier kann bestimmt werden welche Prozesse und Ausgabenmodi bei unterschiedlichen Verzweigungen in der Webapplikation erlaubt sind.

5 Die Prozesskette startet immer mit dem process-handler mit dem name Attribut startup. o name Name des process-handler o class Aufzurufende Klasse o call Name des process-handler welcher standardmäßig als nächstes in der Prozesskette aufgerufen werden soll. Dieser Wert kann über den Node on-variable überlagert werden. on-variable Legt eine Variablen bedingte Abzweigung in der Prozesskette fest. o name Name der Variablen o with-value Der auslösende Wert der Variablen o parameter-set Der Auslöser ist jeder Wert der Variablen ungleich Leer o call Name des process-handler welcher in der Prozesskette aufgerufen werden soll. Folgende properties sollten bei Bedarf angepasst werden: self-reference http url der Webapplikation für den Selbst und Timer Zugriff. smtpserver standard SMTP Server für den Mail Versandt smtpuser Der Benutzer unter dem sich der Mail Versandt beim Mailserver anmeldet smtppassword Passwort des oben angegebenen Mail Users system- Absender Adresse für System s Weiter properties timer-call Serverabsolute Url für den zu verwendenden JArt Timer Prozess user-file Serverabsoluter Pfad zur Verwaltungsdatei der JArt internen Benutzerverwaltung. menu-file (nur aus backward compatibility Gründen vorhanden) escape-sequenz Charakter Batch für den SAX Parser

6 app-jart-user-config Serverabsolute Url für die zu verwendende Benutzerverwaltung app-jart-user-index-settings Serverabsolute Url für die zu verwendende Index Erweiterung app-jart-package-helper Serverabsolute Url für den zu verwendenden Programmier Wizzard Folgende Prozessketteneinträge werden verwendet: startup Liest die aufgerufene.jart Datei als DOM ein. output-xml Gibt das aktuelle Dokument als XML auf dem Server Response Stream aus. jart-process Führt den JArt Logik Prozess für die eingelesene.jart Datei aus und erstellt das Ausgabe DOM. transform Führt den XSL Transform Prozess für das Ausgabe DOM aus und schreibt das Ergebnis in den Server Response Stream. transform-to-document Führt den XSL Transform Prozess für das Ausgabe DOM aus und schreibt das Ergebnis in die angegebene Datei. format-output-document Formatiert das Ausgabedokument. jart-config.xml <config> <!-- start custom settings --> <property name="self-reference" value=" <property name="smtpserver" value="smtp.sil.at"></property> <property name="smtpuser" value="u005433"></property> <property name="smtppassword" value="pause21"></property> <property name="system- " <!-- end custom settings --> <property name="timer-call" value="/tools/timer/timer.jart"></property> <property name="user-file" value="/web-inf/jart-users.xml"></property> <property name="menu-file" value="/web-inf/jart-menus.xml"></property> <property name="escape-sequenz" value=" "></property> <property name="app-jart-user-config" value="/projects/jart-user-config/mainindex.jart?rel=default"></property> <property name="app-jart-user-index-settings" value="/projects/jart-user-config/mainindex.jart?rel=index-config"></property> <property name="app-jart-package-helper" value="/projects/jart-helpers/mainindex.jart?rel=package-helper"></property> <namespace-handler namespace-uri="jartv01"> <class node-name="math" class="jart.handlers.basic.jartmath"></class> <class node-name="date" class="jart.handlers.data.jartdate"></class>

7 <class node-name="svg" class="jart.handlers.image.jartsvg"></class> <class node-name="pdf" class="jart.handlers.image.jartpdf"></class> <class node-name="image" class="jart.handlers.image.jartimage"></class> <class node-name="push" class="jart.handlers.basic.jartpush"></class> <class node-name="transform" class="jart.handlers.basic.xsltransform"></class> <class node-name="rename" class="jart.handlers.basic.rename"></class> <class node-name="namespace" class="jart.handlers.basic.jartnamespace"></class> <class node-name="xml" class="jart.handlers.basic.xml"></class> <class node-name="comment" class="jart.handlers.basic.comment"></class> <class node-name="session-data" class="jart.handlers.basic.sessiondata"></class> <class node-name="session" class="jart.handlers.basic.session"></class> <class node-name="move-node" class="jart.handlers.basic.movenode"></class> <class node-name="plain" class="jart.handlers.basic.plain"></class> <class node-name="text" class="jart.handlers.basic.jarttext"></class> <class node-name="variable" class="jart.handlers.basic.variable"></class> <class node-name="attribute" class="jart.handlers.basic.jartattribute"></class> <class node-name="delete-node" class="jart.handlers.basic.deletenode"></class> <class node-name="element" class="jart.handlers.basic.jartelement"></class> <class node-name="sysinfo" class="jart.handlers.control.jartcacheinfo"></class> <class node-name="cache" class="jart.handlers.control.cache"></class> <class node-name="while" class="jart.handlers.control.while"></class> <class node-name="redirect" class="jart.handlers.control.redirect"></class> <class node-name="debug" class="jart.handlers.control.debugmessage"></class> <class node-name="block" class="jart.handlers.control.block"></class> <class node-name="call" class="jart.handlers.control.call"></class> <class node-name="choose" class="jart.handlers.control.choose"></class> <class node-name="for" class="jart.handlers.control.for"></class> <class node-name="foreach" class="jart.handlers.control.foreach"></class> <class node-name="if" class="jart.handlers.control.if"></class> <class node-name="include" class="jart.handlers.control.include"></class> <class node-name="otherwise" class="jart.handlers.control.otherwise"></class> <class node-name="when" class="jart.handlers.control.when"></class> <class node-name="with-node" class="jart.handlers.control.with"></class> <class node-name="zip" class="jart.handlers.data.jartzip"></class> <class node-name="send-mail" class="jart.handlers.data.jartsendmail"></class> <class node-name="all-http-header" class="jart.handlers.data.allhttpheader"></class> <class node-name="cookie" class="jart.handlers.data.jartcookie"></class> <class node-name="jdbc" class="jart.handlers.data.jartjdbc"></class> <class node-name="db-all-columns" class="jart.handlers.data.jartjdbcallfields"></class> <class node-name="db-all-tables" class="jart.handlers.data.jartjdbcalltables"></class> <class node-name="db-execute" class="jart.handlers.data.jartjdbcexecute"></class> <class node-name="db-select" class="jart.handlers.data.jartjdbcselect"></class> <class node-name="save-node" class="jart.handlers.data.savenode"></class> <class node-name="get-xml" class="jart.handlers.data.getxml"></class> <class node-name="file" class="jart.handlers.data.jartfile"></class> <class node-name="add-header" class="jart.handlers.control.jarthttpheader"></class> <class node-name="fx-send" class="jart.handlers.data.fxserversend"></class> </namespace-handler> <process-handler name="startup" class="jart.processhandlers.createjdomdocumentfromrequest" call="jart-process"> <on-variable name="datamode" with-value="plain" call="output-xml"></on-variable>

8 </process-handler> <process-handler name="output-xml" class="jart.processhandlers.outputxml"></processhandler> <process-handler name="jart-process" class="jart.processhandlers.jartprocess" call="output-xml"> <on-variable name="datamode" with-value="xml" call="output-xml"></on-variable> <on-variable name="xslfile" parameter-set="true" call="transform"> <on-variable name="format-output" with-value="true" call="transform-todocument"></on-variable> </on-variable> </process-handler> <process-handler name="transform" class="jart.processhandlers.transformtooutput" xslfile="xslfile"></process-handler> <process-handler name="transform-to-document" class="jart.processhandlers.transformtodocument" call="format-output-document" xslfile="xslfile"></process-handler> <process-handler name="format-output-document" class="jart.processhandlers.formatoutputdocument" newlines="format-outputnewlines=true" normalize="format-output-normalize=true" indent="format-outputindent"></process-handler> </config> Fehlerausgabe und Fehlerhandling Generell werden alle Fehler JArt intern abgefangen. Die einzige Ausnahme bilden Systemkritische Fehler, die Erfahrungsmäßig nur bei Fehlerhafter Installation auftreten und dem Application Log der Servletengine übergeben. Interne Fehler werden, sofern sie nicht vom JArt Logik Code abgefangen werden, in die JArt interne Log Datei geschrieben. JArt System und CMS Log Die JArt Log Dateien befinden sich unter (Webapplication Root)/jart-cms/logs und werden unter yyyy-mm/yyyy-mm-dd.txt abgelegt wobei für jeden Tag ein Logfile angelegt wird. Es werden nur CMS, Entwicklungsevents und Fehler in diesen Dateien protokolliert. Für eine Standard Webstatistik muss ein Logfile am Webserver, oder der Servletengine eingerichtet werden. Logfile Format: Tabulator und Zeilenumbruch getrennte Textdatei. Spalten:

9 DATE Datum des eintrages IP IP-Adresse des Bearbeitenden TYP Art des Eintrages o LOG Standard Log Eintrag (Anmeldung im System, Abmeldung ect.) o IDX Inhalts Index Bearbeitung (Reservierung, Freigabe, Publizierung eines Kapitels, ect.) o CED Inhaltsbearbeitung eines Kapitels. o DES Programmierung über den Designer o XED Code Bearbeitung über den XML Editor o ERR Nicht abgefangener Fehler USER Benutzername des ausführenden Benutzers FILE Uhrsprungs oder Ziel Datei DESCRIPTION Erklärung des Ereignisses (optional)