|
|
@@ -12,29 +12,30 @@ searchd [OPTIONS]
|
|
|
## Параметры командной строки searchd
|
|
|
|
|
|
|
|
|
-Параметры, доступные для `searchd` во всех операционных системах:
|
|
|
+Доступные для `searchd` во всех операционных системах параметры:
|
|
|
|
|
|
-* `--help` (сокращенно `-h`) выводит список всех параметров, которые можно использовать в вашей конкретной сборке `searchd`.
|
|
|
-* `--version` (сокращенно `-v`) показывает информацию о версии Manticore Search.
|
|
|
-* `--config <file>` (сокращенно `-c <file>`) указывает `searchd` использовать указанный файл в качестве конфигурации.
|
|
|
+* `--help` (сокращённо `-h`) выводит список всех параметров, которые могут быть использованы в вашей конкретной сборке `searchd`.
|
|
|
+* `--version` (сокращённо `-v`) показывает информацию о версии Manticore Search.
|
|
|
+* `--quiet` (сокращённо `-q`) подавляет вывод при запуске, кроме ошибок (баннер и сообщения о предварительном кэшировании).
|
|
|
+* `--config <file>` (сокращённо `-c <file>`) указывает `searchd` использовать указанный файл в качестве конфигурации.
|
|
|
* `--stop` используется для асинхронной остановки `searchd`, используя данные PID-файла, указанного в конфигурационном файле Manticore. Поэтому вам также может потребоваться указать `searchd`, какой конфигурационный файл использовать, с помощью опции `--config`. Пример:
|
|
|
|
|
|
```bash
|
|
|
$ searchd --config /etc/manticoresearch/manticore.conf --stop
|
|
|
```
|
|
|
|
|
|
-* `--stopwait` используется для синхронной остановки `searchd`. `--stop` по сути сообщает работающему экземпляру о выходе (отправляя ему SIGTERM) и затем немедленно возвращает управление. `--stopwait` также попытается дождаться, пока работающий экземпляр `searchd` фактически завершит процесс остановки (например, сохранит все ожидающие изменения атрибутов) и завершит работу. Пример:
|
|
|
+* `--stopwait` используется для синхронной остановки `searchd`. `--stop` по сути говорит запущенному экземпляру завершиться (отправляя ему SIGTERM) и затем немедленно возвращает управление. `--stopwait` также попытается дождаться, пока запущенный экземпляр `searchd` фактически завершит процесс остановки (например, сохранит все ожидающие изменения атрибутов) и завершится. Пример:
|
|
|
|
|
|
```bash
|
|
|
$ searchd --config /etc/manticoresearch/manticore.conf --stopwait
|
|
|
```
|
|
|
- Возможные коды завершения:
|
|
|
+ Возможные коды завершения следующие:
|
|
|
* 0 при успехе
|
|
|
- * 1 если не удалось подключиться к работающему серверу searchd
|
|
|
+ * 1 если не удалось подключиться к запущенному серверу searchd
|
|
|
* 2 если сервер сообщил об ошибке во время остановки
|
|
|
- * 3 если сервер аварийно завершил работу во время остановки
|
|
|
+ * 3 если сервер аварийно завершился во время остановки
|
|
|
|
|
|
-* Команда `--status` используется для запроса статуса работающего экземпляра `searchd`, используя данные подключения из (опционально) предоставленного конфигурационного файла. Она попытается подключиться к работающему экземпляру, используя первый найденный UNIX-сокет или TCP-порт из конфигурационного файла. При успехе она запросит ряд значений статуса и счетчиков производительности и выведет их. Вы также можете использовать команду [SHOW STATUS](../Node_info_and_management/Node_status.md#SHOW-STATUS) для доступа к тем же самым счетчикам через SQL-протокол. Примеры:
|
|
|
+* Команда `--status` используется для запроса статуса запущенного экземпляра `searchd`, используя данные подключения из (опционально) предоставленного конфигурационного файла. Она попытается подключиться к запущенному экземпляру, используя первый найденный UNIX-сокет или TCP-порт из конфигурационного файла. В случае успеха она запросит ряд значений статуса и счётчиков производительности и выведет их. Вы также можете использовать команду [SHOW STATUS](../Node_info_and_management/Node_status.md#SHOW-STATUS) для доступа к тем же самым счётчикам через SQL-протокол. Примеры:
|
|
|
|
|
|
```bash
|
|
|
$ searchd --status
|
|
|
@@ -47,27 +48,27 @@ searchd [OPTIONS]
|
|
|
$ searchd --console --pidfile
|
|
|
```
|
|
|
|
|
|
-* `--console` используется для принудительного перевода `searchd` в консольный режим. Обычно Manticore работает как обычное серверное приложение и записывает информацию в файлы журналов (как указано в конфигурационном файле). Однако при отладке проблем в конфигурации или самом сервере, или при попытке диагностировать трудноуловимые проблемы, может быть проще заставить его выводить информацию напрямую в консоль/командную строку, из которой он был вызван. Работа в консольном режиме также означает, что процесс не будет разветвляться (поэтому поиски выполняются последовательно) и журналы не будут записываться. (Следует отметить, что консольный режим не является предполагаемым методом для запуска `searchd`.) Вы можете вызвать его так:
|
|
|
+* `--console` используется для принудительного перевода `searchd` в консольный режим. Обычно Manticore работает как обычное серверное приложение и записывает информацию в файлы журналов (как указано в конфигурационном файле). Однако при отладке проблем в конфигурации или самом сервере, или при попытке диагностировать трудноуловимые проблемы, может быть проще заставить его выводить информацию напрямую в консоль/командную строку, из которой он был вызван. Запуск в консольном режиме также означает, что процесс не будет разветвляться (поэтому поиски выполняются последовательно) и журналы не будут записываться. (Следует отметить, что консольный режим не является предназначенным методом для запуска `searchd`.) Вы можете вызвать его так:
|
|
|
|
|
|
```bash
|
|
|
$ searchd --config /etc/manticoresearch/manticore.conf --console
|
|
|
```
|
|
|
|
|
|
-* Опции `--logdebug`, `--logreplication`, `--logdebugv` и `--logdebugvv` включают дополнительный отладочный вывод в журнале сервера. Они различаются по уровню детализации журналирования. Это отладочные опции, и их обычно не следует включать, так как они могут сильно засорить журнал. Их можно временно использовать по запросу для помощи в сложных сессиях отладки.
|
|
|
+* Опции `--logdebug`, `--logreplication`, `--logdebugv` и `--logdebugvv` включают дополнительный отладочный вывод в журнал сервера. Они различаются по уровню детализации журналирования. Это отладочные опции, и их обычно не следует включать, так как они могут сильно засорить журнал. Их можно временно использовать по запросу для помощи в сложных сессиях отладки.
|
|
|
|
|
|
-* `--iostats` используется вместе с опциями журналирования (`query_log` должен быть активирован в `manticore.conf`) для предоставления более детальной информации по каждому запросу о операциях ввода/вывода, выполненных в ходе этого запроса, с небольшим падением производительности и немного большими журналами. Статистика IO не включает информацию об операциях IO для атрибутов, так как они загружаются с помощью mmap. Чтобы включить ее, вы можете запустить `searchd` следующим образом:
|
|
|
+* `--iostats` используется вместе с опциями журналирования (`query_log` должен быть активирован в `manticore.conf`) для предоставления более подробной информации по каждому запросу о операциях ввода/вывода, выполненных в ходе этого запроса, с небольшим снижением производительности и немного большими журналами. Статистика IO не включает информацию об операциях IO для атрибутов, так как они загружаются с помощью mmap. Чтобы включить её, вы можете запустить `searchd` следующим образом:
|
|
|
|
|
|
```bash
|
|
|
$ searchd --config /etc/manticoresearch/manticore.conf --iostats
|
|
|
```
|
|
|
|
|
|
-* `--cpustats` используется для предоставления отчета о фактическом времени ЦП (в дополнение к реальному времени) как в файле журнала запросов (для каждого заданного запроса), так и в отчете о статусе (агрегированном). Это зависит от системного вызова Linux `clock_gettime()` или переходит к менее точному вызову на определенных системах. Вы можете запустить `searchd` так:
|
|
|
+* `--cpustats` используется для предоставления отчёта о фактическом времени процессора (в дополнение к реальному времени) как в файле журнала запросов (для каждого заданного запроса), так и в отчёте о статусе (агрегированном). Это зависит от системного вызова Linux `clock_gettime()` или переходит к менее точному вызову на определённых системах. Вы можете запустить `searchd` так:
|
|
|
|
|
|
```bash
|
|
|
$ searchd --config /etc/manticoresearch/manticore.conf --cpustats
|
|
|
```
|
|
|
|
|
|
-* `--port portnumber` (сокращенно `-p`) используется для указания порта, который Manticore должен прослушивать для принятия запросов по бинарному протоколу, обычно для целей отладки. Обычно по умолчанию это 9312, но иногда вам нужно запустить его на другом порту. Указание его в командной строке переопределит все, указанное в конфигурационном файле. Допустимый диапазон от 0 до 65535, но порты с номерами 1024 и ниже обычно требуют привилегированной учетной записи для запуска.
|
|
|
+* `--port portnumber` (сокращённо `-p`) используется для указания порта, который Manticore должен прослушивать для принятия запросов по бинарному протоколу, обычно для целей отладки. Обычно по умолчанию это 9312, но иногда вам нужно запустить его на другом порту. Указание его в командной строке переопределит всё, указанное в конфигурационном файле. Допустимый диапазон — от 0 до 65535, но порты с номерами 1024 и ниже обычно требуют привилегированной учётной записи для запуска.
|
|
|
|
|
|
Пример использования:
|
|
|
|
|
|
@@ -75,11 +76,11 @@ searchd [OPTIONS]
|
|
|
$ searchd --port 9313
|
|
|
```
|
|
|
|
|
|
-* `--listen ( address ":" port | port | path ) [ ":" protocol ]` (или сокращенно `-l`) Работает как `--port`, но позволяет указать не только порт, но и полный путь, IP-адрес и порт, или путь к Unix-доменному сокету, который будет прослушивать `searchd`. Другими словами, вы можете указать либо IP-адрес (или имя хоста) и номер порта, либо просто номер порта, либо путь к Unix-сокету. Если вы укажете номер порта, но не адрес, searchd будет прослушивать все сетевые интерфейсы. Unix-путь идентифицируется начальным слэшем. В качестве последнего параметра вы также можете указать обработчик протокола (слушатель), который будет использоваться для соединений на этом сокете. Поддерживаемые значения протокола: 'sphinx' и 'mysql' (протокол MySQL, используемый с версии 4.1).
|
|
|
+* `--listen ( address ":" port | port | path ) [ ":" protocol ]` (или сокращённо `-l`) Работает как `--port`, но позволяет указать не только порт, но и полный путь, IP-адрес и порт, или путь к Unix-доменному сокету, который будет прослушивать `searchd`. Другими словами, вы можете указать либо IP-адрес (или имя хоста) и номер порта, либо просто номер порта, либо путь к Unix-сокету. Если вы укажете номер порта, но не адрес, searchd будет прослушивать все сетевые интерфейсы. Unix-путь идентифицируется начальным слэшем. В качестве последнего параметра вы также можете указать обработчик протокола (слушатель), который будет использоваться для соединений на этом сокете. Поддерживаемые значения протокола: 'sphinx' и 'mysql' (протокол MySQL, используемый с версии 4.1).
|
|
|
|
|
|
-* `--force-preread` запрещает серверу обслуживать любые входящие соединения до завершения предварительного чтения файлов таблиц. По умолчанию при запуске сервер принимает соединения, пока файлы таблиц лениво загружаются в память. Эта опция расширяет поведение и заставляет сервер ждать, пока файлы не будут загружены.
|
|
|
+* `--force-preread` запрещает серверу обслуживать любые входящие соединения до завершения предварительного чтения файлов таблиц. По умолчанию при запуске сервер принимает соединения, пока файлы таблиц лениво загружаются в память. Эта опция расширяет поведение и заставляет его ждать, пока файлы не будут загружены.
|
|
|
|
|
|
-* `--index (--table) <table>` (или сокращенно `-i (-t) <table>`) заставляет этот экземпляр `searchd` обслуживать только указанную таблицу. Как и `--port` выше, это обычно для целей отладки; более долгосрочные изменения обычно вносятся в сам конфигурационный файл.
|
|
|
+* `--index (--table) <table>` (или сокращённо `-i (-t) <table>`) заставляет этот экземпляр `searchd` обслуживать только указанную таблицу. Как и `--port` выше, это обычно для целей отладки; более долгосрочные изменения обычно следует вносить в сам конфигурационный файл.
|
|
|
|
|
|
* `--strip-path` удаляет пути из всех имен файлов, на которые ссылается таблица (стоп-слова, формы слов, исключения и т.д.). Это полезно для использования таблиц, созданных на другой машине с возможными отличиями в расположении путей.
|
|
|
|
|
|
@@ -173,12 +174,11 @@ Manticore использует [plugin_dir](../Server_settings/Common.md#plugin_
|
|
|
|
|
|
`searchd` поддерживает несколько сигналов:
|
|
|
|
|
|
-* `SIGTERM` - Инициирует корректное завершение работы. Новые запросы не будут обрабатываться, но запросы, которые уже начали выполняться, не будут прерваны принудительно.
|
|
|
-* `SIGHUP` - Инициирует ротацию таблиц. В зависимости от значения параметра [seamless_rotate](../Server_settings/Searchd.md#seamless_rotate), новые запросы могут быть на короткое время приостановлены; клиенты получат временные ошибки.
|
|
|
-* `SIGUSR1` - Принудительно перестраивает файлы журнала searchd и журнала запросов, что позволяет выполнить ротацию журналов.
|
|
|
+* `SIGTERM` - Инициирует корректное завершение работы. Новые запросы не будут обрабатываться, но уже начатые запросы не будут принудительно прерваны.
|
|
|
+* `SIGHUP` - Инициирует ротацию таблиц. В зависимости от значения настройки [seamless_rotate](../Server_settings/Searchd.md#seamless_rotate), новые запросы могут быть ненадолго приостановлены; клиенты будут получать временные ошибки.
|
|
|
+* `SIGUSR1` - Принудительно переоткрывает файлы журнала searchd и журнала запросов, что позволяет выполнить ротацию файлов журналов.
|
|
|
|
|
|
## Переменные окружения
|
|
|
|
|
|
-* `MANTICORE_TRACK_DAEMON_SHUTDOWN=1` включает подробное логирование во время завершения работы searchd. Это полезно в случае проблем с завершением работы, например, когда Manticore слишком долго завершает работу или зависает в процессе завершения.
|
|
|
+* `MANTICORE_TRACK_DAEMON_SHUTDOWN=1` включает подробное логирование во время завершения работы searchd. Это полезно в случае некоторых проблем с завершением работы, например, когда Manticore слишком долго завершает работу или зависает в процессе завершения.
|
|
|
<!-- proofread -->
|
|
|
-
|