<section id="install-win32">
<title>Install OTRS on Microsoft Windows</title>
<para>This document describes the installation of the <ulink url="http://otrs.org">OTRS</ulink> on systems running <emphasis>Microsoft Windows (Win32)</emphasis>. It has been tested on Windows 2000 and XP and should run on Windows NT4 and 2003, too. Take care to keep your operating system up-to-date prior to installing. Please have a look at <ulink url="http://windowsupdate.microsoft.com/">http://windowsupdate.microsoft.com/</ulink> therefore.</para>
<para>Please note that we do not support 16-Bit-Windows Systems with this installer (e.g. Windows 98, 98SE, ME).</para>
<section id="otrs4win32">
<title>otrs4win32 - The Automatic Installer</title>
<para>We provide an automatic installer for your convenience that will install all of the needed software components for you on a fresh (!) and up-to-date Win32 system and strongly recommend it's use.</para>
<important><para>The contained software versions are: 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>
Download the current release - you may use our <ulink url="http://otrs.org/download">http://otrs.org/download</ulink> as a starting point. 
It's an executable .exe file, it's name follows this conventions: <emphasis>otrs4win32-&lt;OTRS-VERSION&gt;-&lt;STATUS&gt;.exe</emphasis>. You may also want to verify the corresponding md5 sum after download - find it besides the files on the servers. We herefore recommend md5-summer: <ulink url="http://md5summer.org/">http://md5summer.org/</ulink>. Give it a try, it's a fine piece of GPL software.
</para>
</section>

<section id="installation_otrs4win32">
<title>Installation</title>
<para>
Obtain administrative rights on your box by logging in as an administrator or by using "Run as...". Start the installer and follow the instructions. No reboot should be required afterwards.
</para>
<warning>
<title>Installation Issues</title>
<para>
This release is suitable only for OTRS systems that are about to be freshly installed, ie. you are currently not encouraged to upgrade your existing OTRS installation. In fact, the installer does not provide any mechanism to do so - see the subsequent part of this documentation that refers to Upgrading.
</para>
</warning>
</section>

<section id="start_otrs_on_win32">
<title>Start The OTRS System</title>
<para>
Make sure there are no other server applications running on the ports 25 (smtp), 80 (http), 443 (https), 3306 (MySQL). If so, find out, what servers they are and if they are supposed and/or required to run at this time on your machine. Examples were Microsoft's IIS webserver running silently in the background or the correspnding SMTP service. You'll have to shut them down to start OTRS.
</para>
<para>
To start your system's servers now, you may use the provided option on the finishing page of the installer dialogue labeled 'Run otrs4win32'. This does the same as the Start Menu entry 'Start All Servers' in the section "Services" (see below), namely executing the script 'all_startservices.bat' located in the root directory of otrs4win32. By default, all servers needed for OTRS are installed as services.
</para>
<para>
Please  be  so patient to wait a little while until Apache has completed the start up phase - this may last for a few minutes. Per default, the ApacheMonitor is startetd after the installer has run as well as WinMySqlAdmin, a monitor for MySQL - watch their symbols in the taskbar, they change from 'Red' to 'Green' when Apache and MySQL are ready to serve you:
</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 and WinMySqlAdmin both show 'Red' - be patient...
<graphic align="left" fileref="images/apachemonitor_red.png" scale="60"></graphic><graphic align="left" fileref="images/winmysqladmin_yellow.png" scale="60"></graphic>Wait while Apache still shows 'Red' - MySQL might show 'Yellow' for a short time.
<graphic align="left" fileref="images/apachemonitor_red.png" scale="60"></graphic><graphic align="left" fileref="images/winmysqladmin_green.png" scale="60"></graphic>Apache still is not ready - but MySQL is.
<graphic align="left" fileref="images/apachemonitor_green.png" scale="60"></graphic><graphic align="left" fileref="images/winmysqladmin_green.png" scale="60"></graphic> Both are 'Green' now - you're on Go!
</para>
<para>
Please note that both monitor programs are only started automatically after the installation has finished. After a reboot you can start them via the Start Menu.
</para>
<para>
Visit <userinput>http://localhost/otrs/installer.pl</userinput> to complete the Web installer, which will  create and populate the database. Afterwards you're guided to the login page: <userinput>http://localhost/otrs/index.pl</userinput>.
</para>
<para>
The customer frontend is here: <userinput>http://localhost/otrs/customer.pl</userinput>
</para>
<para>
This release  is built upon <ulink url="http://www.apachefriends.org/">Apachefriends</ulink>' XAMPP, and  therefore you benefit from  XAMPP's features, too. Visit <userinput>http://localhost/index.html</userinput> (include the filename!). This  is  XAMPP  and  its components - you'll find OTRS in the left-hand  menu.  Click on it to get to the informational page about OTRS.
</para>
<para>
There are some informational links in the Start Menu, f.e. to phpMyAdmin, WinMySqlAdmin and ApacheMonitor.
</para>
</section>

<section id="how_to_stop_the_servers_otrs4win32">
<title>How To Stop The Servers (if ever...)</title>
<para>If you installed the servers as system services, you may use the system's service control area to stop them, although you don't need to, because they will be terminated at shutdown time properly. Additionally, they need not be shut down if you actually do not work in OTRS, but should be kept running to let the maintenance scripts perform their actions at their given times.</para>
<para>Regarding the Standalone versions of the servers: For Apache, you may simply close it's control window. To safely shut down MySQL, use it's Start Menu entry or issue the script <userinput>mysql_stop.bat</userinput>. Shut down Mercury via it's <userinput>file</userinput> menu or the keyboard shortcut <userinput>Alt-F4</userinput> when the Mercury window has the focus. Stop the CRONw service via the Start Menu or by issuing <userinput>net stop cron</userinput>.</para>
</section>

<section id="uninstallation_otrs4win32">
<title>Uninstallation Instructions</title>
<para>If you ever want to remove otrs4win32 from your box, simply stop all of the servers, uninstall all of their eventually installed services and delete the directory holding the application. For all this we provide an uninstaller, found in the installation directory. You may perform some of the required steps manually via the Start Menu, if you want to.</para>
<para>The uninstall process will guide you through what will be uninstalled. No Reboot should be required.</para>
<para>Additionally, it provides some means to actually <emphasis>RE</emphasis>install some aspects of the software. This were the service, the Start menu entries and the  entries in Windows' Registry.</para>
</section>

</section>

<section id="upgrading_otrs4win32">
<title>Upgrading</title>
<para>
These instructions are for people upgrading their otrs4win32 installation from 1.1.3 or prior to 1.2.0:
</para>

<itemizedlist>
<listitem>
<para>Stop Apache and MySQL (see "Administration" in the OTRS Start Menu)
</para>
</listitem>
<listitem>
<para>Backup everything (database, Kernel/Config.pm, Kernel/Config/GenericAgent.pm, var/*)</para>
</listitem>
<listitem>
<para>Make sure that you have backed up everything ,-)</para>
</listitem>
<listitem>
<para>If possible try this install on a separate machine</para>
</listitem>
<listitem>
<para>Install the new release into the same location.
  <itemizedlist>
  <listitem>
  <para>
  Please note: the OTRS themes between 1.1 and 1.2 are _not_ compatible (don't use the old theme)!
  </para>
  </listitem>
  </itemizedlist>
</para>
</listitem>
<listitem>
<para>Restart Apache and MySQL (see the Start Menu for help).
</para>
</listitem>
<listitem>
<para>
Update the database changes via phpMyAdmin: <emphasis>http://localhost/phpmyadmin</emphasis>.
  <itemizedlist>
  <listitem>
  <para>
  Choose the 'otrs' database via the dropdown menu on the left.
  </para>
  </listitem>
  <listitem>
  <para>
  Click the tab 'SQL' on the right.
  </para>
  </listitem>
  <listitem>
  <para>
  Click 'Browse' and choose the file <emphasis>C:\otrs\otrs\scripts\DBUpdate-to-1.2.mysql.sql</emphasis>
  </para>
  </listitem>
  <listitem>
  <para>
  Click OK.
  </para>
  </listitem>
  </itemizedlist>
</para>
</listitem>
<listitem>
<para>Alternatively, you may execute the following via the command line:
<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>
  Do not worry about the error messages, you can update all previous 
  version with this script and in the most cases your database has 
  already the most changes!
</para>
</listitem>
<listitem>
<para>
Please be so kind to post any bugs on <ulink url="http://bugs.otrs.org/">http://bugs.otrs.org/</ulink>
</para>
</listitem>

</itemizedlist>
</section>
