Skip to content
Browse files

Document --backlog and --disable-keepalive. Fixes gh-2

  • Loading branch information...
1 parent d151386 commit 48060d4b33092fc73a2857e2039789b94d25d3f9 @miyagawa committed Mar 27, 2010
Showing with 20 additions and 0 deletions.
  1. +20 −0 bin/starman
View
20 bin/starman
@@ -70,10 +70,30 @@ processes running. So even if there're no idle workers, Starman won't
spawn off spare processes since that's mostly what you want to do by
fine tuning the memory usage etc. in the production environment.
+=item --backlog
+
+Specifies the number of backlog (listen queue size) of listener sockets. Defaults to 1024.
+
+On production systems, setting a very low value can allow failover on
+frontend proxy (like nginx) to happen more quickly, if you have
+multiple Starman clusters.
+
+If you're doing simple benchmarks and getting connection errors,
+increasing this parameter can help avoid them. You should also
+consider increasing C<net.core.somaxconn>. Note that this is not
+recommended for real production system if you have another cluster to
+failover (see above).
+
=item --max-requests
Number of the requests to process per one worker process. Defaults to 1000.
+=item --disable-keepalive
+
+Disable Keep-alive persistent connections. Useful if you run Starman
+behind a frontend proxy that tries to pool connections more than a
+number of backend workers (i.e. Apache mpm_prefork + mod_proxy).
+
=back
See `plackup -h` for more options.

0 comments on commit 48060d4

Please sign in to comment.
Something went wrong with that request. Please try again.