changeset 2069:fc3ba2e76974

Documented size of keys_zone for commercial version (trac #1286).
author Yaroslav Zhuravlev <yar@nginx.com>
date Thu, 26 Oct 2017 15:50:00 +0300
parents 3d9e7993c201
children f6b65868fae3
files xml/en/docs/http/ngx_http_fastcgi_module.xml xml/en/docs/http/ngx_http_proxy_module.xml xml/en/docs/http/ngx_http_scgi_module.xml xml/en/docs/http/ngx_http_uwsgi_module.xml xml/ru/docs/http/ngx_http_fastcgi_module.xml xml/ru/docs/http/ngx_http_proxy_module.xml xml/ru/docs/http/ngx_http_scgi_module.xml xml/ru/docs/http/ngx_http_uwsgi_module.xml
diffstat 8 files changed, 84 insertions(+), 8 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_fastcgi_module.xml
+++ b/xml/en/docs/http/ngx_http_fastcgi_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_fastcgi_module"
         link="/en/docs/http/ngx_http_fastcgi_module.html"
         lang="en"
-        rev="47">
+        rev="48">
 
 <section id="summary">
 
@@ -438,6 +438,15 @@ In addition, all active keys and informa
 in a shared memory zone, whose <value>name</value> and <value>size</value>
 are configured by the <literal>keys_zone</literal> parameter.
 One megabyte zone can store about 8 thousand keys.
+<note>
+As part of
+<commercial_version>commercial subscription</commercial_version>,
+the shared memory zone also stores extended
+cache <link doc="ngx_http_api_module.xml" id="http_caches_">information</link>,
+thus, it is required to specify a larger zone size for the same number of keys.
+For example,
+one megabyte zone can store about 4 thousand keys.
+</note>
 </para>
 
 <para>
--- a/xml/en/docs/http/ngx_http_proxy_module.xml
+++ b/xml/en/docs/http/ngx_http_proxy_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_proxy_module"
         link="/en/docs/http/ngx_http_proxy_module.html"
         lang="en"
-        rev="62">
+        rev="63">
 
 <section id="summary">
 
@@ -454,6 +454,15 @@ In addition, all active keys and informa
 in a shared memory zone, whose <value>name</value> and <value>size</value>
 are configured by the <literal>keys_zone</literal> parameter.
 One megabyte zone can store about 8 thousand keys.
+<note>
+As part of
+<commercial_version>commercial subscription</commercial_version>,
+the shared memory zone also stores extended
+cache <link doc="ngx_http_api_module.xml" id="http_caches_">information</link>,
+thus, it is required to specify a larger zone size for the same number of keys.
+For example,
+one megabyte zone can store about 4 thousand keys.
+</note>
 </para>
 
 <para>
--- a/xml/en/docs/http/ngx_http_scgi_module.xml
+++ b/xml/en/docs/http/ngx_http_scgi_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_scgi_module"
         link="/en/docs/http/ngx_http_scgi_module.html"
         lang="en"
-        rev="36">
+        rev="37">
 
 <section id="summary">
 
@@ -429,6 +429,15 @@ In addition, all active keys and informa
 in a shared memory zone, whose <value>name</value> and <value>size</value>
 are configured by the <literal>keys_zone</literal> parameter.
 One megabyte zone can store about 8 thousand keys.
+<note>
+As part of
+<commercial_version>commercial subscription</commercial_version>,
+the shared memory zone also stores extended
+cache <link doc="ngx_http_api_module.xml" id="http_caches_">information</link>,
+thus, it is required to specify a larger zone size for the same number of keys.
+For example,
+one megabyte zone can store about 4 thousand keys.
+</note>
 </para>
 
 <para>
--- a/xml/en/docs/http/ngx_http_uwsgi_module.xml
+++ b/xml/en/docs/http/ngx_http_uwsgi_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_uwsgi_module"
         link="/en/docs/http/ngx_http_uwsgi_module.html"
         lang="en"
-        rev="40">
+        rev="41">
 
 <section id="summary">
 
@@ -429,6 +429,15 @@ In addition, all active keys and informa
 in a shared memory zone, whose <value>name</value> and <value>size</value>
 are configured by the <literal>keys_zone</literal> parameter.
 One megabyte zone can store about 8 thousand keys.
+<note>
+As part of
+<commercial_version>commercial subscription</commercial_version>,
+the shared memory zone also stores extended
+cache <link doc="ngx_http_api_module.xml" id="http_caches_">information</link>,
+thus, it is required to specify a larger zone size for the same number of keys.
+For example,
+one megabyte zone can store about 4 thousand keys.
+</note>
 </para>
 
 <para>
--- a/xml/ru/docs/http/ngx_http_fastcgi_module.xml
+++ b/xml/ru/docs/http/ngx_http_fastcgi_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_fastcgi_module"
         link="/ru/docs/http/ngx_http_fastcgi_module.html"
         lang="ru"
-        rev="47">
+        rev="48">
 
 <section id="summary">
 
@@ -437,6 +437,16 @@ fastcgi_cache_path /data/nginx/cache lev
 разделяемой памяти, <value>имя</value> и <value>размер</value> которой
 задаются параметром <literal>keys_zone</literal>.
 Зоны размером в 1 мегабайт достаточно для хранения около 8 тысяч ключей.
+<note>
+Как часть
+<commercial_version>коммерческой подписки</commercial_version>
+в зоне разделяемой памяти также хранится расширенная
+<link doc="ngx_http_api_module.xml" id="http_caches_">информация</link> о кэше,
+поэтому для хранения аналогичного количества ключей необходимо указывать
+больший размер зоны.
+Например
+зоны размером в 1 мегабайт достаточно для хранения около 4 тысяч ключей.
+</note>
 </para>
 
 <para>
--- a/xml/ru/docs/http/ngx_http_proxy_module.xml
+++ b/xml/ru/docs/http/ngx_http_proxy_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_proxy_module"
         link="/ru/docs/http/ngx_http_proxy_module.html"
         lang="ru"
-        rev="62">
+        rev="63">
 
 <section id="summary">
 
@@ -454,6 +454,16 @@ proxy_cache_path /data/nginx/cache level
 разделяемой памяти, <value>имя</value> и <value>размер</value> которой
 задаются параметром <literal>keys_zone</literal>.
 Зоны размером в 1 мегабайт достаточно для хранения около 8 тысяч ключей.
+<note>
+Как часть
+<commercial_version>коммерческой подписки</commercial_version>
+в зоне разделяемой памяти также хранится расширенная
+<link doc="ngx_http_api_module.xml" id="http_caches_">информация</link> о кэше,
+поэтому для хранения аналогичного количества ключей необходимо указывать
+больший размер зоны.
+Например
+зоны размером в 1 мегабайт достаточно для хранения около 4 тысяч ключей.
+</note>
 </para>
 
 <para>
--- a/xml/ru/docs/http/ngx_http_scgi_module.xml
+++ b/xml/ru/docs/http/ngx_http_scgi_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_scgi_module"
         link="/ru/docs/http/ngx_http_scgi_module.html"
         lang="ru"
-        rev="36">
+        rev="37">
 
 <section id="summary">
 
@@ -428,6 +428,16 @@ scgi_cache_path /data/nginx/cache levels
 разделяемой памяти, <value>имя</value> и <value>размер</value> которой
 задаются параметром <literal>keys_zone</literal>.
 Зоны размером в 1 мегабайт достаточно для хранения около 8 тысяч ключей.
+<note>
+Как часть
+<commercial_version>коммерческой подписки</commercial_version>
+в зоне разделяемой памяти также хранится расширенная
+<link doc="ngx_http_api_module.xml" id="http_caches_">информация</link> о кэше,
+поэтому для хранения аналогичного количества ключей необходимо указывать
+больший размер зоны.
+Например
+зоны размером в 1 мегабайт достаточно для хранения около 4 тысяч ключей.
+</note>
 </para>
 
 <para>
--- a/xml/ru/docs/http/ngx_http_uwsgi_module.xml
+++ b/xml/ru/docs/http/ngx_http_uwsgi_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_uwsgi_module"
         link="/ru/docs/http/ngx_http_uwsgi_module.html"
         lang="ru"
-        rev="40">
+        rev="41">
 
 <section id="summary">
 
@@ -427,6 +427,16 @@ uwsgi_cache_path /data/nginx/cache level
 разделяемой памяти, <value>имя</value> и <value>размер</value> которой
 задаются параметром <literal>keys_zone</literal>.
 Зоны размером в 1 мегабайт достаточно для хранения около 8 тысяч ключей.
+<note>
+Как часть
+<commercial_version>коммерческой подписки</commercial_version>
+в зоне разделяемой памяти также хранится расширенная
+<link doc="ngx_http_api_module.xml" id="http_caches_">информация</link> о кэше,
+поэтому для хранения аналогичного количества ключей необходимо указывать
+больший размер зоны.
+Например
+зоны размером в 1 мегабайт достаточно для хранения около 4 тысяч ключей.
+</note>
 </para>
 
 <para>