• Запуск сервера
  • Параметры для работы базы данных
  • Internationalisation
  • Встроенный HTTP-сервер
  • Ведение логов
• Scaffolding
• Файл конфигурации

Оригинал на GitHub

Запуск сервера

-d <database>, --database <database>

База данных, используемая при установке или обновлении модулей.

-i <modules>, --init <modules>

Список модулей, разделенных через запятую, для установки перед запуском сервера (требуется параметр -d).

-u <modules>, --update <modules>

Список модулей, подлежащих обновлению до запуска сервера (требуется параметр -d).

--addons-path <directories>

Список каталогов, разделенных запятыми, в которых хранятся модули. Эти каталоги сканируются для поиска в них модулей.

--workers <count>

Если count не равно 0 (по умолчанию), то включается многопроцессорная обработка и устанавливается указанное количество HTTP обработчиков (которые обрабатывают HTTP и RPC-запросы).

Примечание

Режим многопроцессорности доступен только в Unix-системах

Ряд вариантов позволяет ограничить и переработать работников:

--limit-request <limit>

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

По умолчанию - 8196.

--limit-memory-soft <limit>

Максимально допустимая виртуальная память на одного обработчика. Если предел превышен, обработчик будет убит и перезапущен в конце текущего запроса.

Defaults to 2048MiB.

--limit-memory-hard <limit>

Жесткий лимит на виртуальную память, любой обработчик, превысивший лимит, будет немедленно убит, не дожидаясь завершения текущей обработки запроса.

Defaults to 2560MiB.

--limit-time-cpu <limit>

Предотвращает использование обработчиком больше, чем <limit> секунд процессорного времени для каждого запроса. Если предел превышен, обработчик будет убит.

По умолчанию 60.

--limit-time-real <limit>

Препятствует тому, чтобы обработчик работал с запросом дольше <limit> секунд. Если предел превышен, обработчик будет убит.

Отличается от --limit-time-cpu тем, что это предел "wall time", включая, например, SQL-запросы.

По умолчанию 120.

--max-cron-threads <count>

Количество работников, занятых заданиями в cron. По умолчанию 2. Рабочие - это потоки в многопоточном режиме и процессы в режиме мультиобработки.

В режиме мультиобработки это в дополнение к рабочим процессам HTTP.

-c <config>, --config <config>

Предоставляет альтернативный файл конфигурации

-s, --save

Сохраняет конфигурацию сервера в текущий файл конфигурации ($HOME/.odoorc по умолчанию и может быть переопределена с помощью -c)

--proxy-mode

Позволяет использовать заголовки X-Forwarded-* через поддержку прокси Werkzeug (Werkzeug's proxy support.)

Предупреждение

Режим прокси не должен быть включен , если используется внешний обратный прокси-сервер (например nginx)

--test-enable

Запускает тесты после установки модулей

--dev <feature,feature,...,feature>

• all: все перечисленные ниже функции активированы

• xml: читать шаблон qweb из XML-файла напрямую вместо базы данных. После того, как шаблон был изменен в базе данных, он не будет считан из файла xml до следующего обновления / инициализации.

• reload: перезапустить сервер при обновлении файла python (возможно, не будет обнаружен в зависимости от используемого текстового редактора)

• qweb: перерыв в оценке шаблона qweb, когда узел содержит t-debug='debugger'

• (i)p(u)db: запуск выбранного отладчика python в коде при возникновении непредвиденной ошибки перед входом в систему и возвратом ошибки.

Параметры для работы базы данных

-r <user>, --db_user <user>

Имя пользователя базы данных, используемое для подключения к PostgreSQL.

-w <password>, --db_password <password>

Пароль пользователя базы данных, если используется password authentication.

--db_host <hostname>

Адрес сервера базы данных

• localhost в Windows

• UNIX сокет для других систем

--db_port <port>

Порт, который прослушивает база данных, по умолчанию 5432

--db-filter <filter>

Скрывает базы данных, имена которые не соответствуют <filter>. Фильтр является "регулярным выражением", с дополнениями, которые:

• %h заменяется на полное имя хоста, к которому сделан запрос. (при запросе на www.site.ru - отобразиться только база данных с именем "www.site.ru")

• %d заменяется на имя первого субдомена, к которому сделан запрос, за исключением www (домен odoo.com и www.odoo.com оба соответствуют базе данных odoo, например при обращении к subdomain.site.ru будет показана база с именем subdomain).

  Эти операции являются чувствительными к регистру. Добавлена опция (?i) чтобы найти все базы данных (так домен odoo.com при использовании (?i)%d соотствует базе данных Odoo).

--db-template <template>

При создании новых баз данных на экране управления базами данных указанная база будет использована в качестве шаблона (template database). По умолчанию используется шаблон template1.

Internationalisation

Use these options to translate Odoo to another language. See i18n section of the user manual. Option '-d' is mandatory. Option '-l' is mandatory in case of importation

--load-language <languages>

specifies the languages (separated by commas) for the translations you want to be loaded

-l, --language <language>

specify the language of the translation file. Use it with --i18n-export or --i18n-import

--i18n-export <filename>

export all sentences to be translated to a CSV file, a PO file or a TGZ archive and exit.

--i18n-import <filename>

import a CSV or a PO file with translations and exit. The '-l' option is required.

--i18n-overwrite

overwrites existing translation terms on updating a module or importing a CSV or a PO file.

--modules

specify modules to export. Use in combination with --i18n-export

Встроенный HTTP-сервер

--no-xmlrpc

Не запускать обработчиков HTTP или long-polling запросов (при этом остается возможным запустить обработчики в cron)

Предупреждение

Не действует, если используется параметр --test-enable ,так как для тестов требуется доступный HTTP-сервер

--xmlrpc-interface <interface>

TCP/IP-адрес, который слушает HTTP-сервер, по умолчанию равен 0.0.0.0 (все адреса)

--xmlrpc-port <port>

Порт, который слушает HTTP-сервер, по умолчанию равен 8069.

--longpolling-port <port>

TCP-порт для long-polling соединений в многопроцессорном или gevent-режиме, по умолчанию 8072. Не используется в режиме по умолчанию.

Ведение логов

По умолчанию Odoo отображает все протоколирование уровня [UNKNOWN NODE title_reference], за исключением регистрации рабочего процесса (только` [UNKNOWN NODE title_reference]), а вывод журнала отправляется в` [UNKNOWN NODE title_reference]. Доступны различные опции для перенаправления ведения журнала в другие пункты назначения и для настройки объема выходных данных протоколирования

--logfile <file>

отправляет поток логов в указанный файл, а не в stdout. В Unix-системах файл может управляться внешними программами управления логов и автоматически будет вновь открыт при замене

--logrotate

включает ротацию логов ежедневно, хранит логи за последние 30 дней. Частота ротации и количество резервных копий не настраивается.

--syslog

отправляет логи в журнал системных событий: syslog на Unix-системах и Event Log на Windows.

Не настраивается

--log-db <dbname>

пишет логи в модели данных ir.logging (таблица ir_logging) текущей базы данных. База данных может иметь имя "current" PostgreSQL, или a PostgreSQL URI для, например, сбора логов в одной базе из нескольких установок Odoo.

--log-handler <handler-spec>

LOGGER:LEVEL, включает LOGGER в предоставленном LEVEL, например odoo.models:DEBUG включит все журналируемые сообщения DEBUG уровня в моделях.

• Двоеточие : обязательно

• Поток логов может быть пропущен при настройки обработчика root (по умолчанию)

• Если уровень не указан, то по умолчанию устанавливается INFO

Данный параметр может быть повторен для настройки нескольких потоков логов, например:

$ odoo-bin --log-handler :DEBUG --log-handler werkzeug:CRITICAL --log-handler odoo.fields:WARNING

--log-request

Включить ведение журнала DEBUG для запросов RPC, эквивалентно --log-handler=odoo.http.rpc.request:DEBUG

--log-response

Включить ведение журнала DEBUG для ответов RPC, эквивалентно --log-handler=odoo.http.rpc.response:DEBUG

--log-web

Позволяет DEBUG протоколировать HTTP-запросы и ответы, эквивалентно --log-handler=odoo.http:DEBUG

--log-sql

Позволяет DEBUG протоколировать запросы SQL, эквивалентно --log-handler=odoo.sql_db:DEBUG

--log-level <level>

Ярлык для более простого задания предопределенных уровней для определенных регистраторов. "Существующие" уровни (critical, error, warn, debug) устанавливаются на odoo и werkzeug регистраторы (кроме debug, который установлен только для odoo).

Odoo также предоставляет отладочные псевдоуровни, которые применяются к различным наборам потоков логов:

debug_sql

Устанавливает уровень debug для потока логов SQL

Эквивалентен параметру --log-sql

debug_rpc

Устанавливает odoo и HTTP-запросы для debug

Эквивалентен параметру --log-level debug --log-request

debug_rpc_answer

Устанавливает odoo и HTTP-запросы и ответы для debug

Эквивалентен параметру --log-level debug --log-request --log-response

Примечание

В случае конфликта между --log-level и --log-handler используется последний

Scaffolding

Scaffolding - это автоматизированное создание каркасной структуры для упрощения первоначальной настройки (создание новых модулей, в случае с Odoo). Хотя это и не является необходимым, он позволяет избежать утомительной настройки базовых структур и поиска того, что входит в необходимые требования.

Создание каркаса осуществляется командой odoo-bin scaffold.

-t <template>

каталог шаблона, файлы пропускаются через jinja2, затем копируются в каталог destination (каталог назначения)

name

Имя создаваемого модуля. Может быть "собрано" по определенному вами алгоритму (например: имя каталога модуля, имена моделей данных, ...)

destination

Каталог, в котором создается новый модуль, по умолчанию используется текущий каталог

Файл конфигурации

Большинство параметров командной строки также можно указать через файл конфигурации. В большинстве случаев они используют похожие имена без префикса - и с заменой других - на _. Например --db-template заменяется на db_template.

Некоторые параметры не соответствуют шаблону, описанному выше:

• --db-filter становится dbfilter

• --no-xmlrpc соответствует xmlrpc boolean

• (Все параметры, начинающиеся с --log-, за исключением --log-handler и --log-db) добавляются в содержимое log_handler

• --smtp записывается как smtp_server

• --database записывается как db_name

• --debug записывается как debug_mode (boolean)

• --i18n-import и --i18n-export не доступны в файле конфигурации

Конфигурационный файл по умолчанию $HOME/.odoorc, который может быть переопределен с помощью --config. Указание --save сохранит текущее состояние конфигурации обратно в этот файл.