.. -*- rst -*-

.. highlightlang:: none

Windows
=======

This section describes how to install groonga on Windows. You can
install groogna by extracting a zip package or running an installer.

We distribute both 32-bit and 64-bit packages but we strongly
recommend a 64-bit package for server. You should use a 32-bit package
just only for tests or development. You will encounter an out of
memory error with a 32-bit package even if you just process medium
size data.

Installer
---------

For 32-bit environment, download x86 executable binary from packages.groonga.org.

You can download such a binary by command line operation.

Start command prompt ``cmd.exe`` and download x86 executable binary by default browser::

  > "c:\\Program Files\\Internet Explorer\\iexplore.exe" http://packages.groonga.org/windows/groonga/groonga-3.0.5-x86.exe

Then run it.


For 64-bit environment, download x64 executable binary from packages.groonga.org.

Start command prompt ``cmd.exe`` and download x64 executable binary by default browser::

  > "c:\\Program Files\\Internet Explorer\\iexplore.exe" http://packages.groonga.org/windows/groonga/groonga-3.0.5-x64.exe

Then run it.

Use command prompt for :doc:`/reference/executables/groonga` installed in start menu.

zip
---

For 32-bit environment, download x86 zip archive from packages.groonga.org.

You can download such a binary by command line operation.

Start command prompt ``cmd.exe`` and download x86 zip archive by default browser::

  > "c:\\Program Files\\Internet Explorer\\iexplore.exe" http://packages.groonga.org/windows/groonga/groonga-3.0.5-x86.zip

Then extract it.

For 64-bit environment, download x64 zip archive from packages.groonga.org.

Start command prompt ``cmd.exe`` and download x64 zip archive by default browser::

  > "c:\\Program Files\\Internet Explorer\\iexplore.exe" http://packages.groonga.org/windows/groonga/groonga-3.0.5-x64.zip

Then extract it.

:doc:`/reference/executables/groonga` is in ``bin`` folder.

Build from source
-----------------

First, you need to install required tools for building groonga on
Windows. Here are required tools:

  * `Microsoft Visual Studio 2010 Express
    <http://www.microsoft.com/japan/msdn/vstudio/express/>`_
  * `CMake <http://www.cmake.org/>`_

Download zipped source from packages.groonga.org.

You can download such a zipped source file by command line operation.

Start ``Visual Studio Command Prompt (2010)`` installed by Microsoft
Visual Studio 2010 Express and download it by default browser::

  > cd c:\Users\%USERNAME%\Downloads
  > "c:\\Program Files\\Internet Explorer\\iexplore.exe" http://packages.groonga.org/source/groonga/groonga-3.0.5.zip

Then extract it.

Move to the groonga's source folder::

  > cd c:\Users\%USERNAME%\Downloads\groonga-3.0.5

Configure by ``cmake``. The following commnad line is for 64-bit
version. To build 32-bit version, use ``-G "Visual Studio 10"``
parameter instead::

  groonga-3.0.5> cmake . -G "Visual Studio 10 Win64" -DCMAKE_INSTALL_PREFIX=C:\groonga

Build::

  groonga-3.0.5> cmake --build . --config Release

Install::

  groonga-3.0.5> cmake --build . --config Release --target Install

After the above steps, :doc:`/reference/executables/groonga` is found in
``c:\groonga\bin\groonga.exe``.