Теперь Manticore Search можно установить одной командой:

curl https://manticoresearch.com | sh

Manticore при этом устанавливается обычным способом — через пакетный менеджер. Скрипт определяет операционную систему и использует APT, YUM/DNF или Homebrew. При необходимости он подключает репозиторий Manticore, устанавливает пакет manticore и запускает службу, если не передать no-start.

Установщик пригодится, когда нужно быстро установить и запустить Manticore Search, не настраивая репозиторий и не устанавливая пакет вручную. Если вы хотите полностью контролировать установку и запуск службы или использовать другой способ развёртывания, обратитесь к инструкциям по ручной установке.

После установки

После успешного завершения работы скрипта Manticore будет установлен через пакетный менеджер. Обновлять и удалять пакет, управлять службой и проводить диагностику можно стандартными системными инструментами.

По умолчанию установщик:

• если репозиторий пакетов ещё не настроен, выбирает стабильный
• устанавливает пакет manticore
• после установки запускает службу Manticore через systemd
• не меняет стандартные порты 9306, 9308 и 9312
• записывает лог установки для диагностики

Проверка службы systemd

Чтобы проверить, запущена ли мантикора, достаточно выполнить SQL-запрос по HTTP:

curl -sS "http://127.0.0.1:9308/sql?mode=raw" -d "SELECT VERSION()"

Или через MySQL-клиент:

mysql -P9306 -h0 -e "SELECT VERSION()"

Если команда вернула номер версии, значит, пакет установлен, а служба запустилась и мантикора отвечает на запросы.

Зачем нужен ещё один способ установки?

Подробные инструкции по установке остаются на странице инсталляции . Они лучше подходят для Docker, Kubernetes и Windows, а также для случаев, когда установка через пакетный менеджер строго регламентирована или политика безопасности запрещает запуск shell-скриптов из интернета.

Однострочный установщик упрощает типовую установку. Вам не нужно заранее выбирать между APT, YUM/DNF и Homebrew: скрипт сам определяет подходящий вариант и выполняет стандартные действия:

• В Debian, Ubuntu и других дистрибутивах на базе Debian скрипт при необходимости подключает APT-репозиторий, обновляет метаданные, устанавливает пакет и запускает службу.
• В RHEL- и Fedora-совместимых дистрибутивах скрипт при необходимости устанавливает служебный RPM-пакет для подключения репозитория, затем пакет Manticore и запускает службу.
• В macOS при установленном Homebrew скрипт устанавливает Manticore и запускает службу с помощью brew services.
• В неподдерживаемых системах скрипт останавливается и выводит ссылку на инструкции по ручной установке.

Такой способ особенно удобен, когда нужно быстро запустить локальный или тестовый сервер Manticore.

Что делает скрипт

Установщик — это shell-скрипт. Перед запуском можно изучить его исходный код: файл installer/bootstrap-standalone.sh находится в репозитории Manticore Search на GitHub.

В поддерживаемых системах скрипт:

• определяет операционную систему и выбирает APT, YUM/DNF или Homebrew
• проверяет архитектуру процессора; поддерживаются x86-64 и ARM64
• в Linux при необходимости устанавливает служебный пакет для подключения репозитория Manticore
• устанавливает пакет manticore
• после установки по умолчанию запускает службу systemd Manticore
• перед запуском службы проверяет, свободны ли стандартные порты, если доступна утилита ss или netstat
• по возможности пишет лог в /var/log/manticore_install.log, иначе — в файл manticore_installer.log во временном каталоге системы

По умолчанию Manticore использует порты 9306, 9308 и 9312. Если Manticore ещё не запущен, скрипт проверяет эти порты с помощью ss или netstat, если одна из утилит доступна. Обнаружив занятый порт, скрипт завершится с ошибкой и не станет менять конфигурацию. Если обе утилиты отсутствуют, предварительная проверка портов не выполняется. В таком случае мантикора затем может не запуститься из-за занятого порта.

Скрипт не меняет порты автоматически: их изменение может потребовать перенастройки клиентов, параметров запуска службы и мониторинга.

Где это работает

Сейчас установщик поддерживает:

• Debian, Ubuntu, Linux Mint и другие дистрибутивы на базе Debian с APT
• RHEL, CentOS, Fedora, Rocky Linux, AlmaLinux и Amazon Linux, а также другие RHEL- и Fedora-совместимые дистрибутивы с YUM или DNF
• macOS при установленном Homebrew
• архитектуры x86-64 и ARM64

В примере выше скрипт загружается с помощью curl. Вместо него можно использовать wget:

wget -O- https://manticoresearch.com | sh

В системе должен быть установлен Bash. Загруженный скрипт сначала запускается интерпретатором /bin/sh: он проверяет наличие Bash, после чего запускает основную часть уже в Bash. В Linux для установки пакетов и управления службой нужны права root или доступ к sudo; при установке через Homebrew команды выполняются от имени текущего пользователя.

Если операционная система или архитектура процессора не поддерживается, установщик останавливается с сообщением об ошибке. Для неподдерживаемой ОС сообщение также содержит ссылку на руководство по ручной установке.

Поведение по умолчанию

Без дополнительных параметров поведение зависит от состояния системы. Если Manticore не установлен, скрипт устанавливает пакет и запускает службу. Если установлен — проверяет, доступна ли более новая версия, и при необходимости предлагает обновление. При этом:

• dev и release явно выбирают канал; без них сохраняется уже настроенный канал, а если канал не настроен, выбирается стабильный
• после установки или обновления служба запускается, если не передать no-start
• стандартные порты остаются 9306, 9308 и 9312
• существующие данные не удаляются

Дальнейшее поведение зависит от команды. Перед обновлением скрипт создаёт резервную копию, если такого каталога для установленной версии ещё нет. В Linux туда копируется конфигурация, а каталог данных — только с параметром backup-data; каталоги Homebrew в резервную копию не входят. Команды uninstall и purge не удаляют данные. При новой установке скрипт также предупреждает, если находит searchd, установленный не из пакета Manticore.

Для полного удаления предусмотрена отдельная команда purge-all: она удаляет пакеты, служебный пакет для подключения репозитория, а также каталоги /etc/manticoresearch и /var/lib/manticore, если они существуют. В интерактивном режиме перед удалением этих каталогов нужно ввести DELETE.

Частые команды

Параметры установщика указываются после sh -s:

# Установить Manticore и запустить службу
curl https://manticoresearch.com | sh

# Установить пакет, но не запускать службу
curl https://manticoresearch.com | sh -s no-start

# Обновить Manticore, установленную через пакетный менеджер
curl https://manticoresearch.com | sh -s upgrade

# При обновлении включить каталог данных в резервную копию
curl https://manticoresearch.com | sh -s upgrade backup-data

# Указать каталог для резервных копий перед обновлением
curl https://manticoresearch.com | sh -s upgrade backup-data backup-dir /path/to/backups

# Показать версии, доступные в текущем канале
curl https://manticoresearch.com | sh -s list-versions

# Показать версии из канала разработки
curl https://manticoresearch.com | sh -s dev list-versions

# Установить указанную версию или переключиться на неё, не запуская службу
curl https://manticoresearch.com | sh -s version 25.0.0 no-start

# Показать справку установщика
curl https://manticoresearch.com | sh -s help

Параметр version поддерживается только при установке через пакетные менеджеры Linux. При установке и обновлении через Homebrew используется версия из формулы, поэтому выбрать её с помощью version нельзя.

Параметр dev явно выбирает канал разработки, а release — стабильный канал. В Linux это разные репозитории, в macOS — разные формулы Homebrew. Если канал не указан, скрипт сохраняет текущую настройку, а при её отсутствии выбирает стабильный канал.

CI и неинтерактивное использование

В автоматизированных сценариях можете запустить установщик с silent или yes, чтобы отключить интерактивные запросы:

curl https://manticoresearch.com | sh -s silent no-start

silent и yes — два названия одного неинтерактивного режима. Они не отключают вывод: установщик по-прежнему сообщает о ходе работы и ошибках, но не задаёт вопросов и не использует цвет. Сами по себе эти параметры не запускают обновление. Однако если вместе с ними явно указать канал dev или release, скрипт может без запроса перейти на доступную в этом канале версию даже без upgrade. Чтобы обновить пакет в уже настроенном канале, явно передайте upgrade:

curl https://manticoresearch.com | sh -s upgrade silent

Будьте осторожны с командами удаления в неинтерактивном режиме. В текущей версии установщика при параметре silent подтверждение удаления также не запрашивается, поэтому команда purge-all может удалить конфигурацию и данные без подтверждения.

Варианты деинсталляции

Установщик поддерживает три варианта удаления мантикоры:

# Удалить пакеты, сохранив конфигурацию и данные
curl https://manticoresearch.com | sh -s uninstall

# Также удалить служебный пакет для подключения репозитория
curl https://manticoresearch.com | sh -s purge

# Также удалить каталоги `/etc/manticoresearch` и `/var/lib/manticore`
curl https://manticoresearch.com | sh -s purge-all

Команда purge-all необратимо удаляет /etc/manticoresearch и /var/lib/manticore, если эти каталоги существуют. Не сочетайте её с silent или yes, если только действительно не хотите удалить их без запроса подтверждения:

curl https://manticoresearch.com | sh -s purge-all silent

В macOS команды uninstall и purge действуют одинаково. purge-all удаляет пакет, но не каталоги Homebrew с конфигурацией и данными; при этом он проверяет /etc/manticoresearch и /var/lib/manticore и удаляет их при наличии. Конфигурацию и данные Homebrew при необходимости придётся удалить отдельно.

Если правила безопасности запрещают curl | sh

Если в вашей инфраструктуре запрещено выполнять curl | sh, воспользуйтесь инструкциями по ручной установке через пакетный менеджер . Другой вариант — скачать скрипт, изучить его исходный код и только затем запустить локально.

Инструкции по установке через пакетный менеджер и из отдельных пакетов, а также по развёртыванию в Docker, Kubernetes и Windows см. в руководстве по установке Manticore Search .