Update README with nginx and php5-fpm conf
authorMichał Sochoń <kaszpir@gmail.com>
Mon, 31 Mar 2014 18:13:03 +0000 (20:13 +0200)
committerDenis Ovsienko <infrastation@yandex.ru>
Tue, 1 Apr 2014 06:28:38 +0000 (10:28 +0400)
I've been using Debian 7 and nginx + php5-fpm since December 2013 and
haven't noticed any issues.

The only thing that has noticeable impact is php scipt caching on nginx
side, but then admin makes it on purpose. By default this feature is not
enabled, but I've decided to add some info about it.

Added extra info for server_name variable for nginx, apparently this
surfaced after update from 0.20.6 to 0.20.7.

README

diff --git a/README b/README
index f309088..5711c31 100644 (file)
--- a/README
+++ b/README
@@ -11,9 +11,9 @@ look for the respective links at project's web-site (racktables.org).
 *** I. SERVER ***
 
 RackTables requires a MySQL server version 5.x built with InnoDB and
-Unicode support and configured appropriately. It also requires an Apache
-httpd with PHP 5 module and several PHP extensions. Below is a list of
-known-good distributions with respective setup notes.
+Unicode support and configured appropriately. By default RackTables is 
+developed on Apache httpd with PHP 5 module and several PHP extensions.
+Below is a list of known-good distributions with respective setup notes.
 
 *** Fedora 8-16
 * MySQL: yum install mysql-server mysql
@@ -28,6 +28,19 @@ section of "/etc/my.cnf" file and restart mysqld.
 * To enable Unicode, add "character-set-server=utf8" line to "[mysqld]"
 section of "/etc/mysql/my.cnf" file and restart mysqld.
 
+*** Debian 7 with nginx
+* MySQL: aptitude install mysql-server-5.1
+* nginx: aptitude install nginx php5-fpm
+* Remember to adjust server_name in server {} section, otherwise your logout link
+* will point to localhost (and thus fail).
+* Notice, that fpm.sock is advised, keep the rest on default configuration, or
+* tweak to your needs. You may need to set fastcgi_read_timeout 600; if you use
+* some external addons like fping, which may take some time in certain situations.
+* Please note that setting aggresive caching for php scripts may result in stale
+* content - so maximum of 60 seconds is advised, but by default it is not enabled.
+* To enable Unicode, add "character-set-server=utf8" line to "[mysqld]"
+section of "/etc/mysql/my.cnf" file and restart mysqld.
+
 *** ALTLinux 4.0
 * MySQL: apt-get install MySQL-server
 * Apache/PHP: apt-get install apache2-httpd-prefork php5-gd2 \