• CentOS 8, RHEL 8, Oracle Linux 8, CentOS Stream 8
• Amazon Linux 2
• CentOS 9, RHEL 9, AlmaLinux 9
• AlmaLinux 10, другие дистрибутивы на базе RHEL 10

Самый простой способ установить Manticore на RedHat/CentOS — использовать наш репозиторий YUM:

Установите репозиторий:

sudo yum install https://repo.manticoresearch.com/manticore-repo.noarch.rpm

Затем установите Manticore Search:

sudo yum install manticore manticore-extra

Если вы обновляетесь до Manticore 6 с более старой версии, рекомендуется сначала удалить старые пакеты, чтобы избежать конфликтов, вызванных обновленной структурой пакетов:

sudo yum remove manticore*

Это не удалит ваши данные и файл конфигурации.

Если вы предпочитаете версии "Nightly" (разработческие), выполните:

sudo yum -y install https://repo.manticoresearch.com/manticore-repo.noarch.rpm && \
sudo yum -y --disablerepo=manticore --enablerepo manticore-dev install manticore

Чтобы скачать отдельные RPM-файлы из репозитория Manticore, следуйте инструкциям на https://manticoresearch.com/install/.

Если вы планируете использовать indexer для создания таблиц из внешних источников, необходимо убедиться, что установлены соответствующие клиентские библиотеки для обеспечения поддержки нужных вам источников индексации. В строке ниже они устанавливаются все сразу; вы можете использовать её как есть или сократить установку, оставив только необходимые библиотеки (для MySQL-источников достаточно только mysql-libs, unixODBC не обязателен).

sudo yum install mysql-libs postgresql-libs expat unixODBC

В CentOS Stream 8 вам может понадобиться выполнить:

dnf install mariadb-connector-c

если при сборке plain-таблицы из MySQL вы получаете ошибку sql_connect: MySQL source wasn't initialized. Wrong name in dlopen?.

Лемматизатор требует Python 3.9+. Убедитесь, что он установлен и сконфигурирован с опцией --enable-shared.

Вот как установить Python 3.9 и украинский лемматизатор в Centos 8:

# install Manticore Search and UK lemmatizer from YUM repository
yum -y install https://repo.manticoresearch.com/manticore-repo.noarch.rpm
yum -y install manticore manticore-lemmatizer-uk
# install packages needed for building Python
yum groupinstall "Development Tools" -y
yum install openssl-devel libffi-devel bzip2-devel wget -y
# download, build and install Python 3.9
cd ~
wget https://www.python.org/ftp/python/3.9.2/Python-3.9.2.tgz
tar xvf Python-3.9.2.tgz
cd Python-3.9*/
./configure --enable-optimizations --enable-shared
make -j8 altinstall
# update linker cache
ldconfig
# install pymorphy2 and UK dictionary
pip3.9 install pymorphy2[fast]
pip3.9 install pymorphy2-dicts-uk

• Debian

  • 11.0 (Bullseye)
  • 12.0 (Bookworm)
  • 13.0 (Trixie)

• Ubuntu

  • 18.04 (Bionic)
  • 20.04 (Focal)
  • 21.04 (Hirsute Hippo)
  • 22.04 (Jammy)
  • 24.04 (Noble)

• Mint

  • 19
  • 20
  • 21

在 Ubuntu/Debian/Mint 上安装 Manticore 最简单的方法是使用我们的 APT 仓库。

安装仓库：

wget https://repo.manticoresearch.com/manticore-repo.noarch.deb
sudo dpkg -i manticore-repo.noarch.deb
sudo apt update

（如果未安装，请安装 wget；如果 apt-key 失败，请安装 gnupg2）。

然后安装 Manticore Search：

sudo apt install manticore

如果您是从旧版本升级到 Manticore 6，建议先删除旧包以避免由于包结构更新导致的冲突：

sudo apt remove manticore*

它不会删除您的数据和配置文件。

如果您更喜欢使用“Nightly”（开发）版本，请执行以下操作：

wget https://repo.manticoresearch.com/manticore-dev-repo.noarch.deb && \
sudo dpkg -i manticore-dev-repo.noarch.deb && \
sudo apt -y update && \
sudo apt -y install manticore

要从 Manticore 仓库下载独立的 DEB 文件，请遵循 https://manticoresearch.com/install/ 上的说明。

Manticore 包依赖于 zlib 和 ssl 库，其他内容不是必需的。但是，如果您计划使用 indexer 从外部存储创建表，您需要安装适当的客户端库。要找出 indexer 需要的具体库，请运行它并查看输出顶部的内容：

$ sudo -u manticore indexer
Manticore 3.5.4 13f8d08d@201211 release
Copyright (c) 2001-2016, Andrew Aksyonoff
Copyright (c) 2008-2016, Sphinx Technologies Inc (http://sphinxsearch.com)
Copyright (c) 2017-2020, Manticore Software LTD (https://manticoresearch.com)
Built by gcc/clang v 5.4.0,
Built on Linux runner-0277ea0f-project-3858465-concurrent-0 4.19.78-coreos #1 SMP Mon Oct 14 22:56:39 -00 2019 x86_64 x86_64 x86_64 GNU/Linux
Configured by CMake with these definitions: -DCMAKE_BUILD_TYPE=RelWithDebInfo -DDISTR_BUILD=xenial -DUSE_SSL=ON -DDL_UNIXODBC=1 -DUNIXODBC_LIB=libodbc.so.2 -DDL_EXPAT=1 -DEXPAT_LIB=libexpat.so.1 -DUSE_LIBICONV=1 -DDL_MYSQL=1 -DMYSQL_LIB=libmysqlclient.so.20 -DDL_PGSQL=1 -DPGSQL_LIB=libpq.so.5 -DLOCALDATADIR=/var/data -DFULL_SHARE_DIR=/usr/share/manticore -DUSE_ICU=1 -DUSE_BISON=ON -DUSE_FLEX=ON -DUSE_SYSLOG=1 -DWITH_EXPAT=1 -DWITH_ICONV=ON -DWITH_MYSQL=1 -DWITH_ODBC=ON -DWITH_POSTGRESQL=1 -DWITH_RE2=1 -DWITH_STEMMER=1 -DWITH_ZLIB=ON -DGALERA_SOVERSION=31 -DSYSCONFDIR=/etc/manticoresearch

这里可以看到 libodbc.so.2、libexpat.so.1、libmysqlclient.so.20 和 libpq.so.5 的提及。

以下是不同 Debian/Ubuntu 版本的所有客户端库列表的参考表：

Distr	MySQL	PostgreSQL	XMLpipe	UnixODBC
Ubuntu Trusty	libmysqlclient.so.18	libpq.so.5	libexpat.so.1	libodbc.so.1
Ubuntu Bionic	libmysqlclient.so.20	libpq.so.5	libexpat.so.1	libodbc.so.2
Ubuntu Focal	libmysqlclient.so.21	libpq.so.5	libexpat.so.1	libodbc.so.2
Ubuntu Hirsute	libmysqlclient.so.21	libpq.so.5	libexpat.so.1	libodbc.so.2
Ubuntu Jammy	libmysqlclient.so.21	libpq.so.5	libexpat.so.1	libodbc.so.2
Debian Jessie	libmysqlclient.so.18	libpq.so.5	libexpat.so.1	libodbc.so.2
Debian Buster	libmariadb.so.3	libpq.so.5	libexpat.so.1	libodbc.so.2
Debian Bullseye	libmariadb.so.3	libpq.so.5	libexpat.so.1	libodbc.so.2
Debian Bookworm	libmariadb.so.3	libpq.so.5	libexpat.so.1	libodbc.so.2

要查找提供这些库的包，您可以使用例如 apt-file：

apt-file find libmysqlclient.so.20
libmysqlclient20: /usr/lib/x86_64-linux-gnu/libmysqlclient.so.20
libmysqlclient20: /usr/lib/x86_64-linux-gnu/libmysqlclient.so.20.2.0
libmysqlclient20: /usr/lib/x86_64-linux-gnu/libmysqlclient.so.20.3.6

请注意，您只需要为将要使用的存储类型安装库。因此，如果您计划仅从 MySQL 构建表，可能只需安装 MySQL 库（在上述情况下为 libmysqlclient20）。

最后，安装所需的包：

sudo apt-get install libmysqlclient20 libodbc1 libpq5 libexpat1

如果您根本不会使用 indexer 工具，则不需要查找和安装任何库。

要启用 CJK 分词支持，官方包中包含嵌入式 ICU 库的二进制文件，并包含 ICU 数据文件。它们与系统上可能可用的任何 ICU 运行时库无关，且无法升级。

词形还原器需要 Python 3.9+。确保您已安装并使用 --enable-shared 进行配置。

以下是 Debian 和 Ubuntu 上安装 Python 3.9 和乌克兰语词形还原器的方法：

# install Manticore Search and UK lemmatizer from APT repository
cd ~
wget https://repo.manticoresearch.com/manticore-repo.noarch.deb
sudo dpkg -i manticore-repo.noarch.deb
sudo apt -y update
sudo apt -y install manticore manticore-lemmatizer-uk
# install packages needed for building Python
sudo apt -y update
sudo apt -y install wget build-essential libreadline-dev libncursesw5-dev libssl-dev libsqlite3-dev tk-dev libgdbm-dev libc6-dev libbz2-dev libffi-dev zlib1g-dev
# download, build and install Python 3.9
cd ~
wget https://www.python.org/ftp/python/3.9.4/Python-3.9.4.tgz
tar xzf Python-3.9.4.tgz
cd Python-3.9.4
./configure --enable-optimizations --enable-shared
sudo make -j8 altinstall
# update linker cache
sudo ldconfig
# install pymorphy2 and UK dictionary
sudo LD_LIBRARY_PATH=~/Python-3.9.4 pip3.9 install pymorphy2[fast]
sudo LD_LIBRARY_PATH=~/Python-3.9.4 pip3.9 install pymorphy2-dicts-uk

brew install manticoresoftware/tap/manticoresearch manticoresoftware/tap/manticore-extra

将 Manticore 作为 brew 服务启动：

brew services start manticoresearch

Manticore 的默认配置文件位于以下路径之一：/usr/local/etc/manticoresearch/manticore.conf 或 /opt/homebrew/etc/manticoresearch/manticore.conf。

如果您计划使用 indexer 从 MySQL、PostgreSQL 或其他数据库等数据源获取数据，使用 ODBC 时可能需要额外的库，例如 mysql@5.7、libpq 和 unixodbc。

如果您更喜欢 "Nightly"（开发）版本，请执行：

brew tap manticoresoftware/tap-dev
brew install manticoresoftware/tap-dev/manticore-dev
brew services start manticore-dev

Manticore 可以通过多种方式安装在 Windows 上。我们推荐使用 WSL（Windows Subsystem for Linux），因为它支持复制且不需要 Docker。以下是推荐和替代的方法。

要在 Windows 上安装 Manticore Search，您首先需要启用 Windows 子系统 Linux。WSL2 允许您在 Windows 上原生运行 Linux 二进制文件。要使用此方法，您需要运行 Windows 10 版本 2004 及更高版本或 Windows 11。

请参考微软官方指南获取安装 WSL2 的逐步说明。

要通过 WSL2 在 Windows 上安装 Manticore，请参考Debian 和 Ubuntu 安装部分。

注意：通过 WSL2 安装 Manticore 是推荐的方法，因为它相比使用本地 Windows 软件包提供更好的兼容性。

或者，您也可以作为本地 Windows 二进制文件安装 Manticore，这种方式需要为 Manticore Buddy 使用 Docker，步骤如下：

1. 安装 Docker Desktop 并启动它。
2. 下载 Manticore Search 安装程序（可在安装页面找到链接）并运行。按照安装说明操作。
3. 选择安装目录。
4. 选择要安装的组件。我们建议全部安装。
5. Manticore 附带预配置的 RT 模式 manticore.conf 文件，无需额外配置。

注意：本地 Windows 二进制文件不支持复制。

要将 Manticore Search 服务器安装为 Windows 服务，请运行：

\path\to\searchd.exe --install --config \path\to\config --servicename Manticore

确保使用配置文件的完整路径，否则 searchd.exe 在作为服务启动时将无法找到它。

安装完成后，可以通过 Microsoft Management Console 的服务管理器启动该服务。

服务启动后，您可以通过 MySQL 命令行界面访问 Manticore：

mysql -P9306 -h127.0.0.1

请注意，在本手册的大多数示例中，我们使用 -h0 连接到本地主机，但在 Windows 上，您必须显式使用 localhost 或 127.0.0.1。