diff --git a/_docs/sysadmin/installation/version_notes/v26.10.01.md b/_docs/sysadmin/installation/version_notes/v26.10.01.md new file mode 100644 index 00000000..35968769 --- /dev/null +++ b/_docs/sysadmin/installation/version_notes/v26.10.01.md @@ -0,0 +1,54 @@ +--- +title: v26.10.01 > Apache and nginx configuration +category: System Administrator > Installation Version Notes +--- + +Release [v26.10.01](https://github.com/Submitty/Submitty/releases/v26.10.01) +changes the Apache and nginx configuration that Submitty ships. +The installer does not update existing configuration files, +so make these edits by hand. + + +### Apache: turn off FastCGI connection reuse + +In `/etc/apache2/sites-available/submitty.conf`, change +`enablereuse=on` to `enablereuse=off`: + +```apache + + +``` + +Then restart Apache: + +```sh +sudo systemctl restart apache2 +``` + +Use restart, not reload. A reload waits for requests that are already +stuck, so it won't free PHP-FPM workers that are already held. + +With reuse on, idle connections can hold every PHP-FPM worker, and +bursts of requests hang. Examples are office hours queue updates and +git pushes near a deadline. +See [#13475](https://github.com/Submitty/Submitty/pull/13475). + + +### nginx: forward only the websocket cookie + +In the `location /ws` block of `/etc/nginx/sites-available/submitty.conf`, +add this line after `proxy_set_header Host $host;`: + +```nginx +proxy_set_header Cookie "submitty_websocket_token=$cookie_submitty_websocket_token"; +``` + +Then reload nginx: + +```sh +sudo systemctl reload nginx +``` + +This stops cookies that other sites set on the same domain from pushing +the websocket handshake past the websocket server's 4096-byte limit. +See [#13393](https://github.com/Submitty/Submitty/pull/13393). diff --git a/navtreedata.js b/navtreedata.js index b9ca7bc7..e106e618 100644 --- a/navtreedata.js +++ b/navtreedata.js @@ -158,6 +158,7 @@ var NAVTREE = [ "Ansible Server Installation", "/sysadmin/installation/ansible", null ], [ "Version Notes", "/sysadmin/installation/version_notes/index", [ [ "Overview", "/sysadmin/installation/version_notes/index", null], + [ "v26.10.01", "/sysadmin/installation/version_notes/v26.10.01", null ], [ "v26.02.01", "/sysadmin/installation/version_notes/v26.02.01", null ], [ "v25.07.01", "/sysadmin/installation/version_notes/v25.07.01", null ], [ "v23.12.02", "/sysadmin/installation/version_notes/v23.12.02", null ],