)]}'
{"doc/source/admin/apache-httpd.rst":[{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"645c3d2e7b2f1eb8a8e3e91333eea071434ff37d","unresolved":false,"context_lines":[{"line_number":7,"context_line":"deploy this there are several patterns. This doc shows two common ways of"},{"line_number":8,"context_line":"deploying Glance with Apache HTTPD."},{"line_number":9,"context_line":""},{"line_number":10,"context_line":"uwsgi"},{"line_number":11,"context_line":"-----"},{"line_number":12,"context_line":""},{"line_number":13,"context_line":"This is the current recommended way to deploy Glance with Apache HTTP and it is"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3f4b6375_a25a27f0","line":10,"range":{"start_line":10,"start_character":0,"end_line":10,"end_character":5},"updated":"2017-10-20 14:37:56.000000000","message":"I was look at the project docs, and they always refer to the software as \"the uWSGI server\" (even though it follows the usual python naming convention in PIP as \u0027uwsgi\u0027).  I\u0027d suggest replacing \u0027uwsgi\u0027 with \u0027the uWSGI server\u0027 in the section title and in the text in this section.","commit_id":"a0db221bc809d7c7fbe92c8b0d3d569a6c332818"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"645c3d2e7b2f1eb8a8e3e91333eea071434ff37d","unresolved":false,"context_lines":[{"line_number":48,"context_line":"    VirtualHost it will mean Apache is buffering the incoming request to local"},{"line_number":49,"context_line":"    disk before sending it to glance. (with the same caveats as with"},{"line_number":50,"context_line":"    :ref:`mod_proxy_uwsgi`)"},{"line_number":51,"context_line":""},{"line_number":52,"context_line":""},{"line_number":53,"context_line":"Now we need to configure and start the uwsgi service. Copy the"},{"line_number":54,"context_line":"`httpd/glance-api-uwsgi.ini` file to `/etc/glance`. Update the file to match"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3f4b6375_02e21b30","line":51,"updated":"2017-10-20 14:37:56.000000000","message":"I had trouble understanding this the first time.  Maybe something like this:\n\nYou need to be careful about what other proxies are contained in the same VirtualHost as your uWSGI setup.  If any of them use the configuration setting ``SetEnv proxy-sendcl 1``, then Apache HTTPD will buffer the incoming request to local disk before sending it to Glance.  This can affect the size of images that can be uploaded, and exposes the uWSGI setup to the same caveats noted below for :ref:`mod_proxy_uwsgi`.","commit_id":"a0db221bc809d7c7fbe92c8b0d3d569a6c332818"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"06c981f802a249c8f420ba01d3f77f4e5b2d963c","unresolved":false,"context_lines":[{"line_number":43,"context_line":""},{"line_number":44,"context_line":".. NOTE::"},{"line_number":45,"context_line":""},{"line_number":46,"context_line":"    Be careful when setting up other proxies on HTTPD using"},{"line_number":47,"context_line":"    ``SetEnv proxy-sendcl 1``. If this is set for any config in the same"},{"line_number":48,"context_line":"    VirtualHost it will mean Apache is buffering the incoming request to local"},{"line_number":49,"context_line":"    disk before sending it to glance. (with the same caveats as with"},{"line_number":50,"context_line":"    :ref:`mod_proxy_uwsgi`)"},{"line_number":51,"context_line":""},{"line_number":52,"context_line":""},{"line_number":53,"context_line":"Now we need to configure and start the uWSGi service. Copy the"}],"source_content_type":"text/x-rst","patch_set":5,"id":"3f4b6375_27f7cd8d","line":50,"range":{"start_line":46,"start_character":4,"end_line":50,"end_character":27},"updated":"2017-10-26 20:04:09.000000000","message":"I\u0027m still unclear about this warning.  Looking at the mod_proxy_uwsgi section, having \u0027proxy-sendcl 1\u0027 is the workaround that allows mod_proxy_uwsgi to  work.  I\u0027m not clear on (A) why the buffering is a problem or (B) what the caveats are.  I made a suggestion on PS2, but while my suggestion maybe addresses (A), it didn\u0027t really address (B).","commit_id":"1ae2acbe771acc03eb9313960121914ac8948fec"},{"author":{"_account_id":5196,"name":"Matthew Treinish","email":"mtreinish@kortar.org","username":"treinish"},"change_message_id":"ebdba6b3c19a7b99bcd02a0f77061b81fe8c28e2","unresolved":false,"context_lines":[{"line_number":43,"context_line":""},{"line_number":44,"context_line":".. NOTE::"},{"line_number":45,"context_line":""},{"line_number":46,"context_line":"    Be careful when setting up other proxies on HTTPD using"},{"line_number":47,"context_line":"    ``SetEnv proxy-sendcl 1``. If this is set for any config in the same"},{"line_number":48,"context_line":"    VirtualHost it will mean Apache is buffering the incoming request to local"},{"line_number":49,"context_line":"    disk before sending it to glance. (with the same caveats as with"},{"line_number":50,"context_line":"    :ref:`mod_proxy_uwsgi`)"},{"line_number":51,"context_line":""},{"line_number":52,"context_line":""},{"line_number":53,"context_line":"Now we need to configure and start the uWSGi service. Copy the"}],"source_content_type":"text/x-rst","patch_set":5,"id":"3f4b6375_fd6144d4","line":50,"range":{"start_line":46,"start_character":4,"end_line":50,"end_character":27},"in_reply_to":"3f4b6375_27f7cd8d","updated":"2017-10-26 21:07:58.000000000","message":"Oh sorry I forgot to adjust this based on your comments on the earlier rev. It slipped my mind with the other more mechanical changes that needed to be done.\n\nThis note is basically a lesson learned thing from bug 1703856, saying don\u0027t make the same mistake I did configuring apache.\n\nThe buffering is a problem because if you upload a large image it take a long time and requires enough space in /tmp (or the TMPDIR set for apache) You\u0027ll have to bump timeouts and it\u0027s hard to find a sane value. This is what other people were trying to do on bug 1703856 before we fixed the chunked decoding in glance and correctly configured apache. Having a multiple minute socket timeout is not a good situation to be in. There is tuning of the timeout and dealing with slow transfer speeds is really the only caveat.\n\nAnyway, I\u0027ll try to respin this in a bit.","commit_id":"1ae2acbe771acc03eb9313960121914ac8948fec"},{"author":{"_account_id":5196,"name":"Matthew Treinish","email":"mtreinish@kortar.org","username":"treinish"},"change_message_id":"70bdeac8d3220c73c61cecc105d727db31acbc7f","unresolved":false,"context_lines":[{"line_number":43,"context_line":""},{"line_number":44,"context_line":".. NOTE::"},{"line_number":45,"context_line":""},{"line_number":46,"context_line":"    Be careful when setting up other proxies on HTTPD using"},{"line_number":47,"context_line":"    ``SetEnv proxy-sendcl 1``. If this is set for any config in the same"},{"line_number":48,"context_line":"    VirtualHost it will mean Apache is buffering the incoming request to local"},{"line_number":49,"context_line":"    disk before sending it to glance. (with the same caveats as with"},{"line_number":50,"context_line":"    :ref:`mod_proxy_uwsgi`)"},{"line_number":51,"context_line":""},{"line_number":52,"context_line":""},{"line_number":53,"context_line":"Now we need to configure and start the uWSGi service. Copy the"}],"source_content_type":"text/x-rst","patch_set":5,"id":"3f4b6375_98df6c39","line":50,"range":{"start_line":46,"start_character":4,"end_line":50,"end_character":27},"in_reply_to":"3f4b6375_937b46bd","updated":"2017-11-02 00:38:46.000000000","message":"Done","commit_id":"1ae2acbe771acc03eb9313960121914ac8948fec"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"cbf40d03bb2367f7b792737383873c6519503d82","unresolved":false,"context_lines":[{"line_number":43,"context_line":""},{"line_number":44,"context_line":".. NOTE::"},{"line_number":45,"context_line":""},{"line_number":46,"context_line":"    Be careful when setting up other proxies on HTTPD using"},{"line_number":47,"context_line":"    ``SetEnv proxy-sendcl 1``. If this is set for any config in the same"},{"line_number":48,"context_line":"    VirtualHost it will mean Apache is buffering the incoming request to local"},{"line_number":49,"context_line":"    disk before sending it to glance. (with the same caveats as with"},{"line_number":50,"context_line":"    :ref:`mod_proxy_uwsgi`)"},{"line_number":51,"context_line":""},{"line_number":52,"context_line":""},{"line_number":53,"context_line":"Now we need to configure and start the uWSGi service. Copy the"}],"source_content_type":"text/x-rst","patch_set":5,"id":"3f4b6375_937b46bd","line":50,"range":{"start_line":46,"start_character":4,"end_line":50,"end_character":27},"in_reply_to":"3f4b6375_fd6144d4","updated":"2017-10-27 19:11:22.000000000","message":"OK, I understand now.  I\u0027d suggest changing this note to say something like:\n\n\u003e You need to be careful about what other proxies are contained in the same VirtualHost as your uWSGI setup.  If any of them use the configuration setting ``SetEnv proxy-sendcl 1``, then Apache HTTPD will buffer the incoming request to local disk before sending it to Glance.  This isn\u0027t needed when running under the uWSGI server, and in fact, causes problems of its own.  It *is* required when running under mod_proxy_uwsgi, which is one reason why we recommend using the uWSGI server over mod_proxy_uwsgi.  For more details, see the section on :ref:`mod_proxy_uwsgi` below.\n\nAnd then add what you said in your reply above about running out of space, having to adjust timeouts, etc., to the mod_proxy_uwsgi section.  I think that will make all of this extremely clear.","commit_id":"1ae2acbe771acc03eb9313960121914ac8948fec"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"9cd68be2f83639530cb656103d2af62c423eb15c","unresolved":false,"context_lines":[{"line_number":47,"context_line":"    on Apache HTTPD using. If any are using ``SetEnv proxy-sendcl 1`` then"},{"line_number":48,"context_line":"    Apache HTTPD will buffer the incoming request to local disk before sending"},{"line_number":49,"context_line":"    it to glance. This will likely cause problems when running in this"},{"line_number":50,"context_line":"    configuration and is not necessary. (it is necessary if using"},{"line_number":51,"context_line":"    mod_proxy_uwsgi) For more details, see the section on"},{"line_number":52,"context_line":"    :ref:`mod_proxy_uwsgi` below."},{"line_number":53,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"3f4b6375_aecb02a3","line":50,"range":{"start_line":50,"start_character":41,"end_line":50,"end_character":42},"updated":"2017-11-02 02:11:30.000000000","message":"need capital \u0027I\u0027 here","commit_id":"570f6c98e7473c71e6ccbe85a144c90e12a3b73e"},{"author":{"_account_id":5196,"name":"Matthew Treinish","email":"mtreinish@kortar.org","username":"treinish"},"change_message_id":"0f9c554a7eb9c197c293089d4d9bd86efe913da0","unresolved":false,"context_lines":[{"line_number":47,"context_line":"    on Apache HTTPD using. If any are using ``SetEnv proxy-sendcl 1`` then"},{"line_number":48,"context_line":"    Apache HTTPD will buffer the incoming request to local disk before sending"},{"line_number":49,"context_line":"    it to glance. This will likely cause problems when running in this"},{"line_number":50,"context_line":"    configuration and is not necessary. (it is necessary if using"},{"line_number":51,"context_line":"    mod_proxy_uwsgi) For more details, see the section on"},{"line_number":52,"context_line":"    :ref:`mod_proxy_uwsgi` below."},{"line_number":53,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"3f4b6375_3a8f49ce","line":50,"range":{"start_line":50,"start_character":41,"end_line":50,"end_character":42},"in_reply_to":"3f4b6375_aecb02a3","updated":"2017-11-02 05:19:45.000000000","message":"Done","commit_id":"570f6c98e7473c71e6ccbe85a144c90e12a3b73e"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"9cd68be2f83639530cb656103d2af62c423eb15c","unresolved":false,"context_lines":[{"line_number":48,"context_line":"    Apache HTTPD will buffer the incoming request to local disk before sending"},{"line_number":49,"context_line":"    it to glance. This will likely cause problems when running in this"},{"line_number":50,"context_line":"    configuration and is not necessary. (it is necessary if using"},{"line_number":51,"context_line":"    mod_proxy_uwsgi) For more details, see the section on"},{"line_number":52,"context_line":"    :ref:`mod_proxy_uwsgi` below."},{"line_number":53,"context_line":""},{"line_number":54,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"3f4b6375_4e45ae14","line":51,"range":{"start_line":51,"start_character":19,"end_line":51,"end_character":20},"updated":"2017-11-02 02:11:30.000000000","message":"need a period before the parenthesis\n\nYou could add a \"however\" to the sentence to heighten the contrast, but that\u0027s up to you.","commit_id":"570f6c98e7473c71e6ccbe85a144c90e12a3b73e"},{"author":{"_account_id":5196,"name":"Matthew Treinish","email":"mtreinish@kortar.org","username":"treinish"},"change_message_id":"0f9c554a7eb9c197c293089d4d9bd86efe913da0","unresolved":false,"context_lines":[{"line_number":48,"context_line":"    Apache HTTPD will buffer the incoming request to local disk before sending"},{"line_number":49,"context_line":"    it to glance. This will likely cause problems when running in this"},{"line_number":50,"context_line":"    configuration and is not necessary. (it is necessary if using"},{"line_number":51,"context_line":"    mod_proxy_uwsgi) For more details, see the section on"},{"line_number":52,"context_line":"    :ref:`mod_proxy_uwsgi` below."},{"line_number":53,"context_line":""},{"line_number":54,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"3f4b6375_5a8685bb","line":51,"range":{"start_line":51,"start_character":19,"end_line":51,"end_character":20},"in_reply_to":"3f4b6375_4e45ae14","updated":"2017-11-02 05:19:45.000000000","message":"Done","commit_id":"570f6c98e7473c71e6ccbe85a144c90e12a3b73e"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"9cd68be2f83639530cb656103d2af62c423eb15c","unresolved":false,"context_lines":[{"line_number":104,"context_line":"store all the disk files. The other aspect to consider is that this buffering"},{"line_number":105,"context_line":"can take some time to write the images to disk. To prevent random failures"},{"line_number":106,"context_line":"you\u0027ll likely have to increase timeout values in the uWSGI configuration file"},{"line_number":107,"context_line":"to ensure uWSGI will wait long enough for this to happen. (often to multiple"},{"line_number":108,"context_line":"minutes)"},{"line_number":109,"context_line":""},{"line_number":110,"context_line":"mod_wsgi"},{"line_number":111,"context_line":"--------"}],"source_content_type":"text/x-rst","patch_set":6,"id":"3f4b6375_ae0e62e2","line":108,"range":{"start_line":107,"start_character":58,"end_line":108,"end_character":8},"updated":"2017-11-02 02:11:30.000000000","message":"These parentheses need to contain a sentence, maybe something like:\n\n(In our experience, the timeout values need to be increased to multiple minutes.)","commit_id":"570f6c98e7473c71e6ccbe85a144c90e12a3b73e"},{"author":{"_account_id":5196,"name":"Matthew Treinish","email":"mtreinish@kortar.org","username":"treinish"},"change_message_id":"0f9c554a7eb9c197c293089d4d9bd86efe913da0","unresolved":false,"context_lines":[{"line_number":104,"context_line":"store all the disk files. The other aspect to consider is that this buffering"},{"line_number":105,"context_line":"can take some time to write the images to disk. To prevent random failures"},{"line_number":106,"context_line":"you\u0027ll likely have to increase timeout values in the uWSGI configuration file"},{"line_number":107,"context_line":"to ensure uWSGI will wait long enough for this to happen. (often to multiple"},{"line_number":108,"context_line":"minutes)"},{"line_number":109,"context_line":""},{"line_number":110,"context_line":"mod_wsgi"},{"line_number":111,"context_line":"--------"}],"source_content_type":"text/x-rst","patch_set":6,"id":"3f4b6375_3aa8691e","line":108,"range":{"start_line":107,"start_character":58,"end_line":108,"end_character":8},"in_reply_to":"3f4b6375_ae0e62e2","updated":"2017-11-02 05:19:45.000000000","message":"Done","commit_id":"570f6c98e7473c71e6ccbe85a144c90e12a3b73e"}]}