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:

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.