2.1. Windows — Mroonga vmrn_version documentation

Skip to main content
`Ctrl`+`K`

# 2.1. Windows

This section describes how to install Mroonga on Windows. You can install Mroogna by extracting a zip package.

Mroonga binary for Windows is provided with MariaDB binary because some changes are needed for building Mroonga for Windows.

## 2.1.1. Install

### 2.1.1.1. Download and extract the zip file

Download zip file and extract it. You need to choose a zip for your environment:

- MariaDB with Mroonga-16.01

### 2.1.1.2. Run `mariadb-install-db.exe`

Run `bin\mariadb-install-db.exe` to initialize the database. `mariadb-install-db.exe` is included in the zip file.

    > bin\mariadb-install-db.exe --datadir=C:\EXAMPLE\data --service=MariaDB --password=PASSWORD

- `--datadir=C:\EXAMPLE\data`

  - Data directory of the new database

- `--service=MariaDB`

  - Name of the Windows service

  - Specify if you want to register MariaDB as a Windows service

- `--password=PASSWORD`

  - Password of the root user

### 2.1.1.3. Start MariaDB server command

Just start MariaDB server by following command.

    > bin\mariadbd.exe --defaults-file=.\MY-PREFERRED-INI.ini --console

If MariaDB is registered as a Windows service, it will be started by the Windows service.

### 2.1.1.4. Install Mroonga to MariaDB

Next connect to MariaDB by following command.

    > bin\mariadb.exe
    MariaDB [(none)]>

After connecting, execute `share\mroonga\install.sql` to install Mroonga. `share\mroonga\install.sql` is included in the zip file and should be specified with an appropriate path.

    MariaDB [(none)]> SOURCE C:PATHTO\share\mroonga\install.sql;
    Query OK, 0 rows affected (0.064 sec)

    Query OK, 0 rows affected, 1 warning (0.000 sec)

    Query OK, 0 rows affected (0.002 sec)

    Query OK, 0 rows affected, 1 warning (0.000 sec)

    Query OK, 0 rows affected (0.001 sec)

    Query OK, 0 rows affected, 1 warning (0.000 sec)

    Query OK, 0 rows affected (0.001 sec)

    Query OK, 0 rows affected, 1 warning (0.000 sec)

    Query OK, 0 rows affected (0.000 sec)

    Query OK, 0 rows affected, 1 warning (0.000 sec)

    Query OK, 0 rows affected (0.001 sec)

    Query OK, 0 rows affected, 1 warning (0.000 sec)

    Query OK, 0 rows affected (0.000 sec)

    Query OK, 0 rows affected, 1 warning (0.000 sec)

    Query OK, 0 rows affected (0.000 sec)

    Query OK, 0 rows affected, 1 warning (0.000 sec)

    Query OK, 0 rows affected (0.001 sec)

    Query OK, 0 rows affected, 1 warning (0.000 sec)

    Query OK, 0 rows affected (0.000 sec)

    MariaDB [(none)]> SHOW ENGINES;
    +--------------------+---------+------------------------------------------------------------+--------------+------+------------+
    | Engine             | Support | Comment                                                    | Transactions | XA   | Savepoints |
    +--------------------+---------+------------------------------------------------------------+--------------+------+------------+
    | CSV                | YES     | CSV storage engine                                         | NO           | NO   | NO         |
    | PERFORMANCE_SCHEMA | YES     | Performance Schema                                         | NO           | NO   | NO         |
    | MEMORY             | YES     | Hash based, stored in memory, useful for temporary tables  | NO           | NO   | NO         |
    | MyISAM             | YES     | MyISAM storage engine                                      | NO           | NO   | NO         |
    | MRG_MyISAM         | YES     | Collection of identical MyISAM tables                      | NO           | NO   | NO         |
    | InnoDB             | DEFAULT | Supports transactions, row-level locking, and foreign keys | YES          | YES  | YES        |
    | Mroonga            | YES     | CJK-ready fulltext search, column store                    | NO           | NO   | NO         |
    | Aria               | YES     | Crash-safe tables with MyISAM heritage                     | NO           | NO   | NO         |
    +--------------------+---------+------------------------------------------------------------+--------------+------+------------+
    8 rows in set (0.00 sec)

## 2.1.2. Build from source with MariaDB

You need to use Mroonga bundled MariaDB source provided by the Mroonga project.

You can find it in https://packages.groonga.org/source/mroonga/. Mroonga bundled MariaDB source has `mariadb-${MARIADB_VERSION}-with-mroonga-${MROONGA_VERSION}.zip` file name.

You can build the source code with the standard MariaDB build process.

You need to register Mroonga after building MariaDB. Use SQL at `${MARIADB_BUILD_DIR}\storage\mroonga\data\install.sql` to register Mroonga.