Update README with nginx and php5-fpm conf
authorMichał Sochoń <kaszpir@gmail.com>
Mon, 31 Mar 2014 18:13:03 +0000 (20:13 +0200)
committerAlexey Andriyanov <alan@al-an.info>
Sun, 20 Apr 2014 09:21:02 +0000 (13:21 +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 f30908893b9db0be42a4353689dba6ade759e7e9..5711c31e20b1386d590f501cbca6696c9bf4d505 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
 *** 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
 
 *** 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.
 
 * 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 \
 *** ALTLinux 4.0
 * MySQL: apt-get install MySQL-server
 * Apache/PHP: apt-get install apache2-httpd-prefork php5-gd2 \