# -*- po -*-
# English translations for Groonga package.
# Copyright (C) 2009-2025 Groonga Project
# This file is distributed under the same license as the Groonga package.
# Automatically generated, 2025.
#
msgid ""
msgstr ""
"Project-Id-Version: Groonga 15.0.2\n"
"Report-Msgid-Bugs-To: \n"
"PO-Revision-Date: 2025-02-21 09:46+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: en\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"

msgid "groonga-httpd"
msgstr "groonga-httpd"

msgid "groonga-httpd has been extracted as `groonga-nginx <https://github.com/groonga/groonga-nginx>`_ since Groonga 13.0.3."
msgstr "groonga-httpd has been extracted as `groonga-nginx <https://github.com/groonga/groonga-nginx>`_ since Groonga 13.0.3."

msgid "Summary"
msgstr "Summary"

msgid "groonga-httpd is a program to communicate with a Groonga server using the HTTP protocol. It functions as same as :doc:`groonga-server-http`. Although :doc:`groonga-server-http` has limited support for HTTP with a minimal built-in HTTP server, groonga-httpd has full support for HTTP with an embedded `nginx <http://nginx.org/>`_. All standards-compliance and features provided by nginx is also available in groonga-httpd."
msgstr "groonga-httpd is a program to communicate with a Groonga server using the HTTP protocol. It functions as same as :doc:`groonga-server-http`. Although :doc:`groonga-server-http` has limited support for HTTP with a minimal built-in HTTP server, groonga-httpd has full support for HTTP with an embedded `nginx <http://nginx.org/>`_. All standards-compliance and features provided by nginx is also available in groonga-httpd."

msgid "groonga-httpd has an Web-based administration tool implemented with HTML and JavaScript. You can access to it from http://hostname:port/."
msgstr "groonga-httpd has an Web-based administration tool implemented with HTML and JavaScript. You can access to it from http://hostname:port/."

msgid "Syntax"
msgstr "Syntax"

msgid "Usage"
msgstr "Usage"

msgid "Set up"
msgstr "Set up"

msgid "First, you'll need to edit the groonga-httpd configuration file to specify a database. Edit /etc/groonga/httpd/groonga-httpd.conf to enable the ``groonga_database`` directive like this::"
msgstr "First, you'll need to edit the groonga-httpd configuration file to specify a database. Edit /etc/groonga/httpd/groonga-httpd.conf to enable the ``groonga_database`` directive like this::"

msgid "Then, run groonga-httpd. Note that the control immediately returns back to the console because groonga-httpd runs as a daemon process by default.::"
msgstr "Then, run groonga-httpd. Note that the control immediately returns back to the console because groonga-httpd runs as a daemon process by default.::"

msgid "Request queries"
msgstr "Request queries"

msgid "To check, request a simple query (:doc:`/reference/commands/status`)."
msgstr "To check, request a simple query (:doc:`/reference/commands/status`)."

msgid "Execution example::"
msgstr "Execution example::"

msgid "Loading data by POST"
msgstr "Loading data by POST"

msgid "You can load data by POST JSON data."
msgstr "You can load data by POST JSON data."

msgid "Here is an example ``curl`` command line that loads two users ``alice`` and ``bob`` to ``Users`` table::"
msgstr "Here is an example ``curl`` command line that loads two users ``alice`` and ``bob`` to ``Users`` table::"

msgid "If you loads users from JSON file, prepare JSON file like this::"
msgstr "If you loads users from JSON file, prepare JSON file like this::"

msgid "Then specify JSON file in ``curl`` command line::"
msgstr "Then specify JSON file in ``curl`` command line::"

msgid "Browse the administration tool"
msgstr "Browse the administration tool"

msgid "Also, you can browse Web-based administration tool at http://localhost:10041/."
msgstr "Also, you can browse Web-based administration tool at http://localhost:10041/."

msgid "Shut down"
msgstr "Shut down"

msgid "Finally, to terminate the running groonga-httpd daemon, run this::"
msgstr "Finally, to terminate the running groonga-httpd daemon, run this::"

msgid "Configuration directives"
msgstr "Configuration directives"

msgid "This section describes only important directives. They are groonga-httpd specific directives and performance related directives."
msgstr "This section describes only important directives. They are groonga-httpd specific directives and performance related directives."

msgid "The following directives can be used in the groonga-httpd configuration file. By default, it's located at /etc/groonga/httpd/groonga-httpd.conf."
msgstr "The following directives can be used in the groonga-httpd configuration file. By default, it's located at /etc/groonga/httpd/groonga-httpd.conf."

msgid "Groonga-httpd specific directives"
msgstr "Groonga-httpd specific directives"

msgid "The following directives aren't provided by nginx. They are provided by groonga-httpd to configure groonga-httpd specific configurations."
msgstr "The following directives aren't provided by nginx. They are provided by groonga-httpd to configure groonga-httpd specific configurations."

msgid "``groonga``"
msgstr "``groonga``"

msgid "Syntax::"
msgstr "Syntax::"

msgid "Default"
msgstr "Default"

msgid "``groonga off;``"
msgstr "``groonga off;``"

msgid "Context"
msgstr "Context"

msgid "``location``"
msgstr "``location``"

msgid "Specifies whether Groonga is enabled in the ``location`` block. The default is ``off``. You need to specify ``on`` to enable groonga."
msgstr "Specifies whether Groonga is enabled in the ``location`` block. The default is ``off``. You need to specify ``on`` to enable groonga."

msgid "Examples::"
msgstr "Examples::"

msgid "``groonga_database``"
msgstr "``groonga_database``"

msgid "``groonga_database /usr/local/var/lib/groonga/db/db;``"
msgstr "``groonga_database /usr/local/var/lib/groonga/db/db;``"

msgid "``http``, ``server``, ``location``"
msgstr "``http``, ``server``, ``location``"

msgid "Specifies the path to a Groonga database. This is the required directive."
msgstr "Specifies the path to a Groonga database. This is the required directive."

msgid "``groonga_database_auto_create``"
msgstr "``groonga_database_auto_create``"

msgid "``groonga_database_auto_create on;``"
msgstr "``groonga_database_auto_create on;``"

msgid "Specifies whether Groonga database is created automatically or not. If the value is ``on`` and the Groonga database specified by :ref:`groonga-httpd-groonga-database` doesn't exist, the Groonga database is created automatically. If the Groonga database exists, groonga-httpd does nothing."
msgstr "Specifies whether Groonga database is created automatically or not. If the value is ``on`` and the Groonga database specified by :ref:`groonga-httpd-groonga-database` doesn't exist, the Groonga database is created automatically. If the Groonga database exists, groonga-httpd does nothing."

msgid "If parent directory doesn't exist, parent directory is also created recursively."
msgstr "If parent directory doesn't exist, parent directory is also created recursively."

msgid "The default value is ``on``. Normally, the value doesn't need to be changed."
msgstr "The default value is ``on``. Normally, the value doesn't need to be changed."

msgid "``groonga_base_path``"
msgstr "``groonga_base_path``"

msgid "The same value as ``location`` name."
msgstr "The same value as ``location`` name."

msgid "Specifies the base path in URI. Groonga uses ``/d/command?parameter1=value1&...`` path to run ``command``. The form of path in used in groonga-httpd but groonga-httpd also supports ``/other-prefix/command?parameter1=value1&...`` form. To support the form, groonga-httpd removes the base path from the head of request URI and prepend ``/d/`` to the processed request URI. By the path conversion, users can use custom path prefix and Groonga can always uses ``/d/command?parameter1=value1&...`` form."
msgstr "Specifies the base path in URI. Groonga uses ``/d/command?parameter1=value1&...`` path to run ``command``. The form of path in used in groonga-httpd but groonga-httpd also supports ``/other-prefix/command?parameter1=value1&...`` form. To support the form, groonga-httpd removes the base path from the head of request URI and prepend ``/d/`` to the processed request URI. By the path conversion, users can use custom path prefix and Groonga can always uses ``/d/command?parameter1=value1&...`` form."

msgid "Nomally, this directive isn't needed. It is needed for per command configuration."
msgstr "Nomally, this directive isn't needed. It is needed for per command configuration."

msgid "Here is an example configuration to add authorization to :doc:`/reference/commands/shutdown` command::"
msgstr "Here is an example configuration to add authorization to :doc:`/reference/commands/shutdown` command::"

msgid "``groonga_log_path``"
msgstr "``groonga_log_path``"

msgid "``/var/log/groonga/httpd/groonga.log``"
msgstr "``/var/log/groonga/httpd/groonga.log``"

msgid "Specifies Groonga log path in the ``http``, ``server`` or ``location`` block. The default is ``/var/log/groonga/httpd/groonga.log``. You can disable logging to specify ``off``."
msgstr "Specifies Groonga log path in the ``http``, ``server`` or ``location`` block. The default is ``/var/log/groonga/httpd/groonga.log``. You can disable logging to specify ``off``."

msgid "``groonga_log_level``"
msgstr "``groonga_log_level``"

msgid "``notice``"
msgstr "``notice``"

msgid "Specifies Groonga log level in the ``http``, ``server`` or ``location`` block. The default is ``notice``. You can disable logging by specifying ``none`` as log level."
msgstr "Specifies Groonga log level in the ``http``, ``server`` or ``location`` block. The default is ``notice``. You can disable logging by specifying ``none`` as log level."

msgid "``groonga_query_log_path``"
msgstr "``groonga_query_log_path``"

msgid "``/var/log/groonga/httpd/groonga-query.log``"
msgstr "``/var/log/groonga/httpd/groonga-query.log``"

msgid "Specifies Groonga's query log path in the ``http``, ``server`` or ``location`` block. The default is ``/var/log/groonga/httpd/groonga-query.log``.  You can disable logging to specify ``off``."
msgstr "Specifies Groonga's query log path in the ``http``, ``server`` or ``location`` block. The default is ``/var/log/groonga/httpd/groonga-query.log``.  You can disable logging to specify ``off``."

msgid "Query log is useful for the following cases:"
msgstr "Query log is useful for the following cases:"

msgid "Detecting slow query."
msgstr "Detecting slow query."

msgid "Debugging."
msgstr "Debugging."

msgid "You can analyze your query log by `groonga-query-log package <https://github.com/groonga/groonga-query-log>`_. The package provides useful tools."
msgstr "You can analyze your query log by `groonga-query-log package <https://github.com/groonga/groonga-query-log>`_. The package provides useful tools."

msgid "For example, there is a tool that analyzing your query log. It can detect slow queries from your query log. There is a tool that replaying same queries in your query log. It can test the new Groonga before updating production environment."
msgstr "For example, there is a tool that analyzing your query log. It can detect slow queries from your query log. There is a tool that replaying same queries in your query log. It can test the new Groonga before updating production environment."

msgid "Performance related directives"
msgstr "Performance related directives"

msgid "The following directives are related to the performance of groonga-httpd."
msgstr "The following directives are related to the performance of groonga-httpd."

msgid "``worker_processes``"
msgstr "``worker_processes``"

msgid "For optimum performance, set this to be equal to the number of CPUs or cores. In many cases, Groonga queries may be CPU-intensive work, so to fully utilize multi-CPU/core systems, it's essential to set this accordingly."
msgstr "For optimum performance, set this to be equal to the number of CPUs or cores. In many cases, Groonga queries may be CPU-intensive work, so to fully utilize multi-CPU/core systems, it's essential to set this accordingly."

msgid "This isn't a groonga-httpd specific directive, but an nginx's one. For details, see http://wiki.nginx.org/CoreModule#worker_processes."
msgstr "This isn't a groonga-httpd specific directive, but an nginx's one. For details, see http://wiki.nginx.org/CoreModule#worker_processes."

msgid "By default, this is set to 1. It is nginx's default."
msgstr "By default, this is set to 1. It is nginx's default."

msgid "``groonga_cache_limit``"
msgstr "``groonga_cache_limit``"

msgid "``groonga_cache_limit 100;``"
msgstr "``groonga_cache_limit 100;``"

msgid "Specifies Groonga's limit of query cache in the ``http``, ``server`` or ``location`` block. The default value is 100. You can disable query cache to specify 0 to ``groonga_cache_limit`` explicitly."
msgstr "Specifies Groonga's limit of query cache in the ``http``, ``server`` or ``location`` block. The default value is 100. You can disable query cache to specify 0 to ``groonga_cache_limit`` explicitly."

msgid "``groonga_cache_base_path``"
msgstr "``groonga_cache_base_path``"

msgid "``groonga_cache_base_path off;``"
msgstr "``groonga_cache_base_path off;``"

msgid "Specifies the base path of query cache in the ``http``, ``server`` or ``location`` block."
msgstr "Specifies the base path of query cache in the ``http``, ``server`` or ``location`` block."

msgid "It's recommended that you specify this configuration when you use multi-workers configuration."
msgstr "It's recommended that you specify this configuration when you use multi-workers configuration."

msgid "If the base path is specified, you can use persistent cache instead of on memory cache. If you use persistent cache, workers share query cache. It's efficient for multi-workers configuration because the same response is cached only once in multiple workers."
msgstr "If the base path is specified, you can use persistent cache instead of on memory cache. If you use persistent cache, workers share query cache. It's efficient for multi-workers configuration because the same response is cached only once in multiple workers."

msgid "There is one more merit for persistent cache. You don't need to warm up cache after groonga-httpd is restarted. Persistent cache isn't cleared when groonga-httpd is down. groonga-httpd can use existing persistent cache again."
msgstr "There is one more merit for persistent cache. You don't need to warm up cache after groonga-httpd is restarted. Persistent cache isn't cleared when groonga-httpd is down. groonga-httpd can use existing persistent cache again."

msgid "The default value is ``off``. It means that persistent cache is disabled. On memory cache is used. On memory cache is independent in each worker. It's not efficient for multi-workers configuration because two or more workers may keeps the same response separately."
msgstr "The default value is ``off``. It means that persistent cache is disabled. On memory cache is used. On memory cache is independent in each worker. It's not efficient for multi-workers configuration because two or more workers may keeps the same response separately."

msgid "Persistent cache is a bit slower than on memory cache. Normally, the difference has little influence on performance."
msgstr "Persistent cache is a bit slower than on memory cache. Normally, the difference has little influence on performance."

msgid "You must specify the base path on memory file system. If you specify the base path on disk, your cache will be slow. It's not make sense."
msgstr "You must specify the base path on memory file system. If you specify the base path on disk, your cache will be slow. It's not make sense."

msgid "``proxy_cache``"
msgstr "``proxy_cache``"

msgid "In short, you can use nginx's reverse proxy and cache mechanism instead of Groonga's built-in query cache feature."
msgstr "In short, you can use nginx's reverse proxy and cache mechanism instead of Groonga's built-in query cache feature."

msgid "Query cache"
msgstr "Query cache"

msgid "Groonga has query cache feature for :doc:`/reference/commands/select` command. The feature improves performance in many cases."
msgstr "Groonga has query cache feature for :doc:`/reference/commands/select` command. The feature improves performance in many cases."

msgid "Query cache feature works well on groonga-httpd except you use :doc:`/reference/commands/cache_limit` command on 2 or more workers. Normally, :doc:`/reference/commands/cache_limit` command isn't used. So there is no problem on many cases."
msgstr "Query cache feature works well on groonga-httpd except you use :doc:`/reference/commands/cache_limit` command on 2 or more workers. Normally, :doc:`/reference/commands/cache_limit` command isn't used. So there is no problem on many cases."

msgid "Here is a description about a problem of using :doc:`/reference/commands/cache_limit` command on 2 or more workers."
msgstr "Here is a description about a problem of using :doc:`/reference/commands/cache_limit` command on 2 or more workers."

msgid "Groonga's query cache is available in the same process. It means that workers can't share the cache. If you don't change cache size, it isn't a big problem. If you want to change cache size by :doc:`/reference/commands/cache_limit` command, there is a problem."
msgstr "Groonga's query cache is available in the same process. It means that workers can't share the cache. If you don't change cache size, it isn't a big problem. If you want to change cache size by :doc:`/reference/commands/cache_limit` command, there is a problem."

msgid "There is no portable ways to change cache size for all workers."
msgstr "There is no portable ways to change cache size for all workers."

msgid "For example, there are 3 workers::"
msgstr "For example, there are 3 workers::"

msgid "The client requests :doc:`/reference/commands/cache_limit` command and the worker 1 receives it::"
msgstr "The client requests :doc:`/reference/commands/cache_limit` command and the worker 1 receives it::"

msgid "The client requests :doc:`/reference/commands/cache_limit` command again and the worker 1 receives it again::"
msgstr "The client requests :doc:`/reference/commands/cache_limit` command again and the worker 1 receives it again::"

msgid "In this case, the worker 2 and the worker 3 aren't received any requests. So they don't change cache size."
msgstr "In this case, the worker 2 and the worker 3 aren't received any requests. So they don't change cache size."

msgid "You can't choose a worker. So you can't change cache sizes of all workers by :doc:`/reference/commands/cache_limit` command."
msgstr "You can't choose a worker. So you can't change cache sizes of all workers by :doc:`/reference/commands/cache_limit` command."

msgid "Reverse proxy and cache"
msgstr "Reverse proxy and cache"

msgid "You can use nginx's reverse proxy and cache feature for query cache::"
msgstr "You can use nginx's reverse proxy and cache feature for query cache::"

msgid "You can use the same cache configuration for all workers but you can't change cache configuration dynamically by HTTP."
msgstr "You can use the same cache configuration for all workers but you can't change cache configuration dynamically by HTTP."

msgid "Here is a sample configuration::"
msgstr "Here is a sample configuration::"

msgid "See the following nginx documentations for parameter details:"
msgstr "See the following nginx documentations for parameter details:"

msgid "http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_path"
msgstr "http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_path"

msgid "http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_valid"
msgstr "http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_valid"

msgid "http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache"
msgstr "http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache"

msgid "http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_pass"
msgstr "http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_pass"

msgid "Note that you need to remove cache files created by nginx by hand after you load new data to Groonga. For the above sample configuration, run the following command to remove cache files::"
msgstr "Note that you need to remove cache files created by nginx by hand after you load new data to Groonga. For the above sample configuration, run the following command to remove cache files::"

msgid "If you use Groonga's query cache feature, you don't need to expire cache by hand. It is done automatically."
msgstr "If you use Groonga's query cache feature, you don't need to expire cache by hand. It is done automatically."

msgid "nginx log related directives"
msgstr "nginx log related directives"

msgid "``access_log``"
msgstr "``access_log``"

msgid "We can output nginx's log by the ``access_log`` directive. The following example is the default nginx's log settings::"
msgstr "We can output nginx's log by the ``access_log`` directive. The following example is the default nginx's log settings::"

msgid "We can specify log format by ``log_format`` directive. For the details of available items of the log, see `Module ngx_http_log_module <http://nginx.org/en/docs/http/ngx_http_log_module.html>`_."
msgstr "We can specify log format by ``log_format`` directive. For the details of available items of the log, see `Module ngx_http_log_module <http://nginx.org/en/docs/http/ngx_http_log_module.html>`_."

msgid "nginx's access log is outputted when a requests is processed. If we want to output the request processing time, we need to set configuration as below::"
msgstr "nginx's access log is outputted when a requests is processed. If we want to output the request processing time, we need to set configuration as below::"

msgid "Available nginx modules"
msgstr "Available nginx modules"

msgid "All standard HTTP modules are available. HttpRewriteModule is disabled when you don't have PCRE (Perl Compatible Regular Expressions). For the list of standard HTTP modules, see `nginx documentation <http://nginx.org/en/docs/>`_."
msgstr "All standard HTTP modules are available. HttpRewriteModule is disabled when you don't have PCRE (Perl Compatible Regular Expressions). For the list of standard HTTP modules, see `nginx documentation <http://nginx.org/en/docs/>`_."
