Installationsanleitung

Konfiguration - Globale Einstellungen

Zunächst müssen globale Einstellungen definiert werden, die das Verhalten der Standalone Version beeinflussen. Zu diesen globalen Einstellungen gehören Angaben, wie z. B. mit welcher Absender-Email-Adresse die E-Mails versehen sein sollen, die vom System verschickt werden oder auch mit welchem Benutzer und Passwort die Anmeldung an dem Mail-Server möglich sein wird.

Die einzelnen Konfigurationseinstellungen sind in folgendem Code aufgeführt. Hier müssen Sie die Textstellen, an denen die "XXXXXXXXX" stehen, mit dem für Sie gültigen Wert überschreiben. Die Beschreibung direkt oberhalb jeder betroffenen Zeile zeigt an, welcher Konfigurationswert hier eingetragen werden soll.

Anschließend wird dieser Text dann in eine Konfigurationsdatei von Tomcat (web.xml) an einer bestimmten Stelle eingefügt.

Im Einzelnen gehen Sie bitte wie folgt vor (bei Fragen klicken Sie hier):

Schritt 1

In dem folgenden Eingabefeld ersetzen Sie bitte die "XXXXXXXXX" mit den passenden Werten. In den Zeilen über dem jeweiligen "XXXXXXXXX" ist beschrieben, um welchen Konfigurationsparameter es sich handelt und welcher Inhalt einzutragen ist:

<context-param>
  <description>
    Ihr Firmenname (wird auf allen Seiten in der Kopfzeile angezeigt)
  </description>
  <param-value>XXXXXXXXXXXXXXXXXX</param-value>
  <param-name>standalone.company.name</param-name>
</context-param>

<context-param>
  <description>
    Webadresse, unter der die Applikation von den Mitarbeitern 
    aufgerufen werden kann (meist der Computername im Netzwerk),
    Technische Notation, also mit fuehrendem http:// oder https:// und 
    abschliessendem "/", beispielsweise http://computer123/
    Wenn Sie die Applikation unter einem Unterverzeichnis laufen
    lassen moechten, beispielsweise weil bereits eine Anwendung im
    Root-Verzeichnis betrieben wird, tragen Sie dieses bitte mit
    ein, beispielsweise http://computer123/urlaub/
  </description>
  <param-value>XXXXXXXXXXXXXXXXXX</param-value>
  <param-name>standalone.mail.defaultInput.URL_TECHNICAL</param-name>
</context-param>

<context-param>
  <description>
    Email-Adresse, die beim Versand von eMails durch das System 
    (z.B. eMails zum Urlaubsantrag, usw.) als Absender-Email-Adresse 
    verwendet werden soll
  </description>
  <param-value>XXXXXXXXXXXXXXXXXX</param-value>
  <param-name>standalone.email.globalEmail</param-name>
</context-param>

<context-param>
	<description>
	    Mit dem folgenden Parameter koennen Sie festlegen, welcher
		Datenbank Benutzernamen verwendet werden soll.
	</description>
	<param-name>standalone.db.UserName</param-name>
	<param-value>XXXXXXXXXXXXX</param-value>
</context-param>

<context-param>
	<description>
	    Mit dem folgenden Parameter koennen Sie festlegen, welches
		Datenbank Passwort verwendet werden soll.
	</description>
	<param-name>standalone.db.UserPwd</param-name>
	<param-value>XXXXXXXXXXXXX</param-value>
</context-param>

<context-param>
  <description>
    SMTP Pfad fuer den MailServer 
    (Beispiel: smtp.mailserver.meinefirma.com)
  </description>
  <param-value>XXXXXXXXXXXXXXXXXX</param-value>
  <param-name>standalone.mailServer</param-name>
</context-param>
<context-param>
  <description>
    Benutzername, der fuer die Anmeldung am 
    eMail-Server verwendet werden soll
  </description>
  <param-value>XXXXXXXXXXXXXXXXXX</param-value>
  <param-name>standalone.mailUser</param-name>
</context-param>
<context-param>
  <description>
  Passwort, das fuer die Anmeldung am eMail-Server 
  verwendet werden soll
  </description>
  <param-value>XXXXXXXXXXXXXXXXXX</param-value>
  <param-name>standalone.mailPwd</param-name>
</context-param>

<context-param>
	<description>
	    Tragen Sie hier ein Verzeichnis ein, in dem die Dokumente und Dateien abgelegt werden sollen,
		die in der digitalen Personalakte hochgeladen werden koennen.
		Beachten Sie: 
		   - Es muss ein Verzeichnis angegeben werden, auf das Tomcat volle Lese- und  Schreibrechte hat.
		   - Sie sollten eine automatische Datensicherung dieses Verzeichnisses sicherstellen.
		   - Dieses Verzeichnis darf nachtraeglich nicht geaendert werden, da ansonsten in der Personalakte die Dokumente nicht mehr gefunden werden
		   
		Tragen Sie die Verzeichnistrenner mit einem Slash ein, nicht mit einem Backslash, beispielsweise wie folgt:
		
		Beispiel fuer Linux: /var/data/timebutler/personalakte
		
		Beispiel fuer Windows: C:/daten/timebutler/personalakte
	</description>
	<param-name>standalone.dpadocs.rootdir</param-name>
	<param-value>XXXXXXXXXXXXXXXXXX</param-value>
</context-param>

<context-param>
	<description>
	    Den folgenden Parameter koennen Sie eintragen, wenn Sie den 
		Zugriff auf die Standalone-Adminoberflaeche mit einem Passwort
		sichern moechten.
	</description>
	<param-name>standalone.standaloneadmin.pwd</param-name>
	<param-value>XXXXXXXXXXXXXXXXXX</param-value>
</context-param>

Schritt 2

Auf dem Zielrechner haben Sie zuvor Apache Tomcat installiert. Im Installationspfad von Apache Tomcat finden Sie ein Verzeichnis conf und darin eine Datei web.xml. Erstellen Sie zunächst eine Kopie der web.xml, damit Sie notfalls Änderungen wieder rückgängig machen können.

Öffnen Sie nun die Datei web.xml mit einem beliebigen Texteditor.

Schritt 3

Kopieren Sie nun den gesamten Inhalt der Eingabebox oben auf dieser Webseite (also die Eingabebox, in der Sie eben die Konfigurationsparameter geändert haben) und fügen ihn in der web.xml an der richtigen Stelle ein, und zwar an die Stelle direkt oberhalb der folgenden Zeile mit der "Introduction-Überschrift" (in der web.xml ganz oben zu finden, ca. Zeile 6):

Als Ergebnis sollte der Anfang der web.xml also beispielhaft wie folgt aussehen:





<?xml version="1.0" encoding="ISO-8859-1"?>

<web-app xmlns="http://java.sun.com/xml/ns/j2ee"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
 version="2.4">



<!-- timebutler.de, ehemals urlaub-verwalten.com, Standalone Konfiguration START -->

<context-param>

  <description>

    E-Mail-Adresse, die beim Versand von E-Mails durch das System 

    (z.B. E-Mails zum Urlaubsantrag, usw.) als Absender-E-Mail-Adresse 

    verwendet werden soll

  </description>

  <param-value>meinEingetragenerWert</param-value>

  <param-name>standalone.email.globalEmail</param-name>

</context-param>


[usw...]



<!-- timebutler.de, ehemals urlaub-verwalten.com ,Standalone Konfiguration ENDE -->




<!-- ====================== Introduction ============================ -->



[usw...]

Schritt 4

Speichern Sie nun die web.xml. Sie können den Editor, mit dem Sie die Datei geöffnet hatten, nun wieder schließen.

Weiter