ANNOUNCEMENT:
Today we are somewhat proud to present to you
the long awaited first public beta release of the
OTRS for Windows32 Installer: otrs4win32
Download the ~40Megs package from any of or download servers,
for example use our mirror at gwdg.de:
ftp://ftp.gwdg.de/pub/misc/otrs/misc/win32/otrs4win32-1.1.3-01-beta3.exe
ftp://ftp.gwdg.de/pub/misc/otrs/misc/win32/otrs4win32-1.1.3-01-beta3.md5
and follow the install instructions below, which will in the end
require about 150 MB on your hard drive. Read below - it's worth it!
Please be so kind to direct all questions, answers and bug reports to
this mailing list.
Find below the INSTALL document, which is included, too. You may also
visit http://doc.otrs.org/cvs/html/install-win32.html
With highest regards,
Robert Kehl
_________________________________________________________
Install OTRS on Win32
This document describes the installation of the OTRS on
systems running Win32. It has been tested it on Windows 2000,
it should run on Windows NT4, XP and 2003, too. Take care to
keep your operating system up-to-date prior to installing.
Please have a look at http://windowsupdate.microsoft.com/
before you install OTRS.
Please note that we do not support 16-Bit-Windows Systems with
this installer (e.g. Windows 98, 98SE, ME).
_________________________________________________________
otrs4win32 - The Automatic Installer
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.
Important
The contained software versions are: OTRS 1.1.3-01, CRONw
1.4b, Apache 2.0.47, MySQL 4.0.14, PHP 4.3.3 & PEAR, Perl
5.8.0, mod_php 4.3.3, mod_perl 1.99_10, mod_ssl 2.0.47,
openssl 0.9.7b, PHPMyAdmin 2.5.1, Webalizer 2.01-10, Mercury
MailTransport System v3.32, JpGraph 1.12.1, FileZilla FTP
Server 0.8.5.
_________________________________________________________
Download & Installation
Download the current release It's an executable .exe file,
it's name follows this conventions:
otrs4win32-<OTRS-VERSION>-<STATUS>.exe. You may want to verify
the corresponding md5 sum after download. We herefore
recommend md5-summer: http://md5summer.org/. Give it a try,
it's a fine piece of GPL software.
Obtain administrative rights on your box by logging in as an
administrator or by using "Run as...". Start the installer.
The first step the software will take is verifying its own
integrity. Depending on the speed of your machine, you will
probably not see this, but it's there:
[otrs4win32-verifying.png]
There's no interactivity required by you in this step.
Following you may choose the desired language. Please note
that this does not affect your OTRS installation later on, but
only sets the language used throughout the installer. Yes, we
are thinking of connecting both settings. Please note
additionally it might be we didn't already translate your
language. In that case, the installer will default to english.
Feel free to contact us if you'd like to contribute a
translation to your language.
[otrs4win32-language.png]
Please be patient now for a little while, while the installer
is unpacking its contents. Remember, the resulting
installation will roughly be about fourth times the
installer's size, so it might take a while for the next screen
to appear.
It will open in full-screen mode. We omitted the coloured
background in this documentation, only the dialogue windows
are shown.
Feel yourself welcomed:
[otrs4win32-welcome.png]
Read the applicable license and agree to it's terms.
[otrs4win32-license.png]
We now come to the most important page of the installer. Here
you choose what we later want to be installed.
[otrs4win32-components.png]
We provide four installation types, which you choose from the
drop-down field at the top:
* Full (recommended!): The name says it: this installs all
of the delivered software and it is our recommendation. We
mainly support this one, ie. you are strongly encouraged
to choose it.
* Minimum: Choosing this will only install those components
that are absolutely required to get the basic OTRS system
going, omitting all the gimmicks this bundle additionally
provides. If in a customized installation (see below) you
omit one of them, OTRS won't work. So it's best to start
from here with customization, if ever.
* None: This option is quite dangerous to use. It allows you
to re-run the external configuration script. Use this only
if you experience difficulties and as a last resort. Have
a complete backup of the OTRS' installation directory at
your hands.
Additionally to the above options, you may choose your own set
of components, allowing you to customize the installation as
you like. The drop-down field will change "Customized" then,
and you can reset your selection by choosing one of the above
types again. When creating your own, customized installation,
you notice that some components always have to be installed to
get anything going - their checkmarks are greyed out.
Warning
Please do not expect everything working fine if you did not
choose "Full" installation. This will esp. apply to the
provided html-pages outside OTRS.
It's time to wisely choose the top-level installation
directory. All files of otrs4win32 are kept under this one
(see the FAQ for more info on this if you feel this is an
issue). The below screenshot, showing a part of a particular
Start Menu, will most likely look different on your box.
[otrs4win32-location.png]
Warning
We strongly recommend locating the directory directly in the
root of any drive, as shown above. We do not recommend
choosing a drive letter higher than E:, although you may try.
We simply didn't test it, so please provide a success story if
you managed to install on M: or O: or wherever else.
If you'd like to have some links in your Windows' Start Menu
to manage the installation, you may choose the right one here.
[otrs4win32-startmenu.png]
We again strongly recommend creating these entries. They do no
harm and prevent you from having to fiddle with the start/stop
and administrative skripts from otrs4win32's various
subdirectories.
This is an example screen of otrs4win32 performing the actual
install.
[otrs4win32-installing.png]
Click on 'Show Details' to watch the output of the installer:
[otrs4win32-installing_details.png]
The system now configures itself to the current location using
an external routine - sorry for that, it will be changed in
later releases of otrs4win32. A (usually dark colored) window
will pop up - please be patient and wait for the process to
finish. Watch the script's output and press a key at it's end.
Configure Apache HTTPD in C:\otrs\apache\conf\httpd.conf ... DONE!
Configure Apache SSL in C:\otrs\apache\conf\ssl.conf ... DONE!
Configure Apache MOD_DAV in C:\otrs\apache\conf\moddav.conf ... DONE
!
Configure PHP for MOD_PHP in C:\otrs\apache\bin\php.ini ... DONE!
Configure PHP for CGI in C:\otrs\php\php.ini ... DONE!
Configure MySQL DEFAULT in C:\otrs\mysql\bin\my.cnf ... DONE!
Configure MySQL NT in C:\otrs\mysql\bin\my.nt-cnf ... DONE!
Configure FileZilla FTP Server in C:\otrs\FileZillaFTP\FileZilla Serv
er.xml ... DONE!
Configure Mercury Mail Server in C:\otrs\MercuryMail\MERCURY.INI ...
DONE!
Configure Perl PPM in C:\otrs\perl\site\lib\ppm.xml ... DONE!
Configure Webalizer in C:\otrs\webalizer\webalizer.conf ... DONE!
Configure all other (cgi, .htaccess, ...) DONE!
Configure OTRS' Config.pm in C:\otrs\otrs\Kernel\Config.pm ... DONE!
Configure OTRS' Apache2 Include in C:\otrs\otrs\scripts\apache2-httpd
.include.conf ... DONE!
Configure OTRS' Apache2 Perl Startup in C:\otrs\otrs\scripts\apache2-
perl-startup.pl ... DONE!
Configure CRONw batch files ... Done!
Press a key to continue...
Once the external configuration routine is finished, you will
be returned to the installer's screen. After some finishing
steps it should look similar to this:
[otrs4win32-complete.png]
After clicking 'Next', you'll see:
[otrs4win32-finished.png]
No reboot should be required. Please read on before clicking
'Finish'!
Warning Installation and Upgrade Issues
NO system service are installed till now. Please refer to the
FAQ on important, additional information regarding this issue.
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.
_________________________________________________________
Start The OTRS System
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.
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
in the section "Standalone Servers" (see below), namely
executing the script 'all_start.bat' located in the root
directory of otrs4win32. Do not worry about the script
complaining about the CRONw service not being found, if you
didn't install it till now - it's harmless.
Please read the ouput of the scripts and do not close the
(usually dark colored) windows appearing, simply minimize them
- these are your servers... Please be so patient to wait a
little while until Apache has been completely starting up, and
then visit http://localhost/. 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. The link at the bottom
points to http://localhost/otrs/cgi-bin/index.pl. Click it -
there you go! You can reach the resulting page, which is OTRS'
Login Page directly by clicking the coresponding link in OTRS'
Start Menu.
To let Apache, Mercury, MySQL and CRONw start automatically at
boot time, you may decide to use the provided administrational
Start Menu entries and/or their corresponding scripts to
install them as system services, but you don't have to do it
now.
_________________________________________________________
How To Stop The Servers (if ever...)
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 mysql_stop.bat. Shut down Mercury via it's file menu or
the keyboard shortcut Alt-F4 when the Mercury window has the
focus. Stop the CRONw service via the Start Menu or by issuing
net stop cron.
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.
_________________________________________________________
Uninstallation Instructions
If you ever want to remove otrs4win32 from your box, simply
stop all of the servers, uninstall all of their eventually
installed services and finally use the provided uninstaller
binary found in the otrs4win32 root directory. You may perform
all of these steps via the Start Menu.
The uninstall process will delete any registry entry that was
created by otrs4win32 (if any), delete OTRS' Start Menu and
finally erase the whole installation directory - that was it.
No Reboot should be required.
_________________________________________________________
--
((otrs.de)) :: OTRS GmbH :: Norsk-Data-Str. 1 :: 61352 Bad Homburg
http://www.otrs.de/ :: Tel. +49 (0)6172 4832388
_______________________________________________
OTRS mailing list: dev - Webpage: http://otrs.org/
Archive: http://lists.otrs.org/pipermail/dev
To unsubscribe: http://lists.otrs.org/cgi-bin/listinfo/dev
