<section id="install-win32">
<title>Installation von OTRS unter Microsoft Windows</title>
<para>
In diesem Dokument wird die Installation von 
<ulink url="http://otrs.org">OTRS</ulink> 
auf  
<emphasis>Microsoft Windows (Win32)</emphasis>
Systemen beschrieben. Der 
<emphasis>Automatic Installer</emphasis> 
wurde unter Microsoft Windows 2000 und XP getestet, sollte aber auch unter Windows NT4 und 2003 
voll funktionsf&auml;hig sein. Achten Sie bitte darauf, dass Ihr Betriebssystem auf dem aktuellsten 
Stand ist, bevor Sie mit der Installation beginnen. Dies k&ouml;nnen Sie unter folgender URL &uuml;berpr&uuml;fen: 
<ulink url="http://windowsupdate.microsoft.com/">http://windowsupdate.microsoft.com/</ulink>
</para>
<para>
Bitte beachten Sie, dass wir mit diesem Installer keine 16-Bit-Windows Versionen (z.B. Windows 98, 98SE, ME) unterst&uuml;tzen.
</para>

<section id="otrs4win32">
<title>otrs4win32 - Der Automatische Installer</title>
<para>
Der automatische Installer von OTRS ist die komfortabelste L&ouml;sung
um alle f&uuml;r OTRS notwendigen Software Komponenten zu installieren. Wir
empfehlen ausdr&uuml;cklich die Verwendung mit einer Neuinstallation Ihres
Systems, das zudem alle wichtigen Systemupdates installiert hat!
</para>

<important>
<para>
Folgende Versionen der Software-Komponenten werden installiert: 
OTRS 1.2.3 
(<ulink url="http://otrs.org/">http://otrs.org/</ulink>),
CRONw 1.4.1b 
(<ulink url="http://cronw.sourceforge.net/">http://cronw.sourceforge.net/</ulink>),
Apache 2.0.47 
(<ulink url="http://httpd.apache.org/docs-2.0/">http://httpd.apache.org/docs-2.0/</ulink>),
MySQL 4.0.14 
(<ulink url="http://www.mysql.com/products/mysql/">http://www.mysql.com/products/mysql/</ulink>),
PHP 4.3.3 
(<ulink url="http://www.php.net/">http://www.php.net/</ulink>),
PEAR 
(<ulink url="http://pear.php.net/">http://pear.php.net/</ulink>),
Perl 5.8.0 
(<ulink url="http://www.perl.org/">http://www.perl.org/</ulink>),
mod_php 4.3.3 
(<ulink url="http://www.php.net/manual/en/install.apache2.php">http://www.php.net/manual/en/install.apache2.php</ulink>),
mod_perl 1.99_10 
(<ulink url="http://perl.apache.org/">http://perl.apache.org/</ulink>),
mod_ssl 2.0.47 
(<ulink url="http://www.modssl.org/">http://www.modssl.org/</ulink>),
openssl 0.9.7b 
(<ulink url="???">http://www.openssl.org/</ulink>),
PHPMyAdmin 2.5.1 
(<ulink url="http://www.phpmyadmin.net/">http://www.phpmyadmin.net/</ulink>),
Webalizer 2.01-10 
(<ulink url="http://www.mrunix.net/webalizer/">http://www.mrunix.net/webalizer/</ulink>),
Mercury MailTransport System v3.32 
(<ulink url="http://www.pmail.com/overviews/ovw_mercury.htm">http://www.pmail.com/overviews/ovw_mercury.htm</ulink>),
JpGraph 1.12.1 
(<ulink url="http://www.aditus.nu/jpgraph/">http://www.aditus.nu/jpgraph/</ulink>),
FileZilla FTP Server 0.8.5 
(<ulink url="http://filezilla.sourceforge.net/">http://filezilla.sourceforge.net/</ulink>).
</para>
</important>

<section id="download_otrs4win32">
<title>Download</title>
<para>
Die aktuelle Version des OTRS Installers k&ouml;nnen sie unter <ulink
url="http://otrs.org/download">http://otrs.org/download</ulink>
downloaden. Der Name der ausf&uuml;hrbaren Datei mit der Endung .exe folgt
hierbei der folgenden Konvention:
<emphasis>otrs4win32-&#60;OTRS-VERSION&#62;-&#60;STATUS&#62;.exe.</emphasis>
</para>
<para>
Wenn Sie die Authentizit&auml;t der Datei best&auml;tigen m&ouml;chten, so laden
Sie einfach noch die zugeh&ouml;rige md5-Datei herunter .
Mit Hilfe des md5-summer (<ulink url="http://md5summer.org/">http://md5summer.org/</ulink>)
k&ouml;nnen Sie dann die Echtheit best&auml;tigen!
</para>
</section>

<section id="installation_otrs4win32">
<title>Installation</title>
<para>
Beachten Sie bitte, dass Sie Administratorrechte auf dem Computer
ben&ouml;tigen, auf dem OTRS installiert werden soll. Hierzu melden Sie sich
bitte als Administrator an oder f&uuml;hren den Installer unter
Verwendung des &#34;Ausf&uuml;hren als...&#34; Kommandos als Administrator aus. Starten Sie bitte den Installer und folgen Sie 
den Anweisungen.
</para>
<warning>
<title>Installation auf aktuelles System</title>
<para>
Der Installer ist gedacht f&uuml;r frisch zu installierende OTRS Systeme, d.h. Sie sind nicht dazu aufgerufen, ein bestehendes OTRS zu aktualisieren. Tats&auml;chlich bietet der Installer momentan keine M&ouml;glichkeit, dies zu tun - bitte schauen Sie in den nachfolgenden Teil der Dokumentation, der sich mit dem Aktualisieren besch&auml;ftigt.
</para>
</warning>
</section>

<section id="start_otrs_on_win32">
<title>Das OTRS System starten</title>
<para>
Stellen Sie sicher, dass keine anderen Serveranwendungen auf den Ports 25 (smtp), 80 (http), 443 (https), 3306 (MySQL) laufen. Wenn doch, finden Sie heraus, was f&uuml;r Server das sind und ob sie zu dieser Zeit auf der Maschine &uuml;berhaupt laufen sollen. Beispiele sind Microsoft's IIS Webserver, der unbemerkt im Hintergrund mitl&auml;uft oder der dazugeh&ouml;rige SMTP Dienst. Schliessen Sie derartige Anwendungen, bevor Sie fortfahren.
</para>
<para>
Um die Server des Systems nach der Installation direkt zu starten, nutzen Sie die entsprechende Option auf der letzten Seite des Installers oder Eintr&auml;ge im Start Men&uuml;.
</para>
<para>
Warten Sie nach dem Ende des Installers ein wenig, bis Apache seine Startphase vollendet hat - dies kann einige Minuten dauern. Standardm&auml;ßig wird der ApacheMonitor nach der Installation gestartet, wie auch WinMySqlAdmin, ein Monitor f&uuml;r MySQL - beobachten Sie sie unten rechts in der TaskBar. Ihre Symbole wechseln auf 'Gr&uuml;n', wenn sie Anfragen entgegennehmen k&ouml;nnen:
</para>
<para>
<graphic align="left" fileref="images/apachemonitor_red.png" scale="60"></graphic><graphic align="left" fileref="images/winmysqladmin_red.png" scale="60"></graphic> ApacheMonitor und WinMySqlAdmin zeigen beide 'Rot' - haben Sie Geduld...
<graphic align="left" fileref="images/apachemonitor_red.png" scale="60"></graphic><graphic align="left" fileref="images/winmysqladmin_yellow.png" scale="60"></graphic>Warten Sie, w&auml;hrend Apache noch 'Rot' zeigt - MySQL zeigt evtl. f&uuml;r eine kurze Zeit 'Gelb' an.
<graphic align="left" fileref="images/apachemonitor_red.png" scale="60"></graphic><graphic align="left" fileref="images/winmysqladmin_green.png" scale="60"></graphic>Apache ist noch nicht bereit - MySQL jedoch schon.
<graphic align="left" fileref="images/apachemonitor_green.png" scale="60"></graphic><graphic align="left" fileref="images/winmysqladmin_green.png" scale="60"></graphic>Beide sind nun 'Gr&uuml;n' - fertig!
</para>
<para>
Bitte beachten Sie, dass beide Hilfsprogramme nur nach der Installation automatisch gestartet werden. Nach einem Reboot k&ouml;nnen Sie sie &uuml;ber das Start Men&uuml; starten.
</para>
<para>
Besuchen Sie <userinput>http://localhost/otrs/installer.pl</userinput>, um den Web-Installer durchzuf&uuml;hren, der die Datenbank erstellen und mit den Anfangswerten f&uuml;llen wird. Hernach werden Sie auf die Login-Seite geleitet: <userinput>http://localhost/otrs/index.pl</userinput>.
</para>
<para>
Die Oberfl&auml;che f&uuml;r Ihre Kunden ist hier:
<userinput>http://localhost/otrs/customer.pl</userinput>
</para>
<para>
Dieses Softwarepaket baut auf <ulink url="http://www.apachefriends.org/">Apachefriends</ulink>' XAMPP auf, daher profitieren Sie auch von XAMPP's M&ouml;glichkeiten. Besuchen Sie 
<userinput>http://localhost/index.html</userinput> (inkl. dem Dateinamen!). 
Dies ist XAMPP mit seinen Komponenten - Sie finden OTRS im Men&uuml; zur Linken - hierdurch gelangen Sie zu einer Info-Seite &uuml;ber Ihr OTRS.
</para>
<para>
Es gibt auch noch eine Handvoll informativer Links im Start Men&uuml;, z.B. zu phpMyAdmin, WinMySqlAdmin und dem ApacheMonitor.
</para>
</section>

<section id="how_to_stop_the_servers_otrs4win32">
<title>Die Server stoppen</title>
<para>
Wenn Sie die Server als Systemdienste installiert haben (das ist Standard), k&ouml;nnen Sie das Start Men&uuml; oder die Diensteverwaltung von Windows nutzen, um sie zu stoppen. Dies m&uuml;ssen Sie aber nicht, weil bei einem Herunterfahren des Systems die Server automatisch und korrekt beendet werden. Sie sollten auch gar nicht heruntergefahren werden, um dem OTRS System es zu erm&ouml;glichen, Wartungsarbeiten im Hintergrund durchzuf&uuml;hren.
</para>
<para>
Die Standalone Versionen der Server betreffend, schliessen Sie einfach das Kontrollfenster von Apache, und starten Sie f&uuml;r MySQL <userinput>mysql_stop.bat</userinput>. Schliessen Sie Mercury &uuml;ber sein <userinput>File</userinput> Men&uuml; oder die tastenkombination <userinput>Alt-F4</userinput>, wenn das Mercury-fenster den Fokus hat. Stoppen Sie den CRONw Dienst &uuml;ber das Start Men&uuml; oder &uuml;ber den Befehl <userinput>net stop cron</userinput>.
</para>
</section>

<section id="uninstallation_otrs4win32">
<title>OTRS deinstallieren (wenn &uuml;berhaupt)</title>
<para>
F&uuml;r den Fall, dass Sie otrs4win32 von Ihrem Computer entfernen
wollen, beenden Sie einfach alle Server und f&uuml;hren sie das Wartungsprogramm aus, das sie im
Startmen&uuml;eintrag unter "Administration" finden. All diese Schritte sind
&uuml;ber das Startmen&uuml; m&ouml;glich.
</para>
<para>
Im Zuge des Deinstallationsprozesses werden s&auml;mtliche Eintr&auml;ge,
die im Zusammenhang mit OTRS entstanden sind, aus der Registrierung
entfernt. Zudem werden die Dateien im Installationsverzeichnis und die
Verkn&uuml;pfungen im Startmen&uuml; gel&ouml;scht. Ein Neustart 
sollte nicht erforderlich sein!
</para>
<para>Zus&auml;tzlich k&ouml;nnen Sie &uuml;ber das Wartungsprogramm einige Teile de Systems <emphasis>RE</emphasis>installieren. Dies sind die Dienste, die Eintr&auml;ge im Start Men&uuml; und in Windows' Registrierung.
</para>
</section>

</section>

<section id="upgrading_otrs4win32">
<title>Aktualisieren (Upgrading)</title>
<para>
Folgen Sie diesen Schritten, um eine existierende otrs4win32 Installation von 1.1.3 oder fr&uuml;her auf 1.2.0 zu aktualisieren:
</para>

<itemizedlist>
<listitem>
<para>Stoppen Sie Apache und MySQL (&uuml;ber die "Administration" im Start Menu)
</para>
</listitem>
<listitem>
<para>Sichern Sie alles (Datenbank, Kernel/Config.pm, Kernel/Config/GenericAgent.pm, var/*) </para>
</listitem>
<listitem>
<para>Haben Sie alles gesichert? ,-) </para>
</listitem>
<listitem>
<para>Wenn m&ouml;glich, versuchen Sie zun&auml;chst, die Installation auf einer separaten Maschine durchzuf&uuml;hren.</para>
</listitem>
<listitem>
<para>Installieren Sie die .exe an denselben Ort.
  <itemizedlist>
  <listitem>
  <para>
  Aufgemerkt: Die OTRS Motive (Themes) der 1.2 sind _nicht_ kompatibel mit kleineren Versionen - gar nicht erst versuchen!
  </para>
  </listitem>
  </itemizedlist>
</para>
</listitem>
<listitem>
<para>Starten Sie Apache und MySQL neu (auch &uuml;ber das Start Menu m&ouml;glich).
</para>
</listitem>
<listitem>
<para>
Aktualisieren Sie die Datenbank via phpMyAdmin: <emphasis>http://localhost/phpmyadmin</emphasis>.
  <itemizedlist>
  <listitem>
  <para>
  W&auml;hlen Sie die 'otrs' Datenbank &uuml;ber das Dropdown Men&uuml; zur Linken.
  </para>
  </listitem>
  <listitem>
  <para>
  Klicken Sie dann auf den 'SQL' Seitenreiter zur Rechten.
  </para>
  </listitem>
  <listitem>
  <para>
  Klicken Sie auf 'Durchsuchen' und w&auml;hlen Sie die Datei <emphasis>C:\otrs\otrs\scripts\DBUpdate-to-1.2.mysql.sql</emphasis>
  </para>
  </listitem>
  <listitem>
  <para>
  Klicken Sie auf OK.
  </para>
  </listitem>
  </itemizedlist>
</para>
</listitem>
<listitem>
<para>Als Alternative k&ouml;nnen Sie auch dies auf einer Kommandozeile ausf&uuml;hren:
<screen>
    <prompt>C:\> </prompt><userinput>cd /d C:\otrs</userinput>
    <prompt>C:\otrs\> </prompt><userinput>mysql\bin\mysql.exe -f -u root otrs < otrs\scripts\DBUpdate-to-1.2.mysql.sql</userinput>
</screen>
  Achten Sie nicht so sehr auf die Fehlermeldungen, sie k&ouml;nnen jede Datenbankversion mit diesem Skript aktualisieren, und oft hat die Datenbank schon manche notwendigen &Auml;nderungen inne.
</para>
</listitem>
<listitem>
<para>
Bitte berichten Sie Fehler auf <ulink url="http://bugs.otrs.org/">http://bugs.otrs.org/</ulink>
</para>
</listitem>

</itemizedlist>
</section>
