PHP: Use 30s for pm.process_idle_timeout - it is more than enough and prevents too...
[project/barracuda.git] / docs / HINTS.txt
1
2 ### How to customize/override standard rewrites and locations in Nginx
3 #
4 # NOTE: Since BOA-2.0.4 all listed below options are available
5 #       both for Satellite and Master Aegir Instances.
6 #
7 # You can include your custom rewrites/locations configuration
8 # to modify or add some custom settings taking precedence
9 # over other rules in the main Nginx configuration.
10 #
11 # Note that some locations will require using parent literal location
12 # to stop searching for / using other regex based locations.
13 #
14 # To learn more please read: http://wiki.nginx.org/HttpCoreModule#location
15 #
16 # Your custom include file should have filename: nginx_vhost_include.conf
17 # for standard overrides and/or nginx_force_include.conf for high level
18 # overrides. The difference between both options is only the point
19 # where the extra config file is included, thus nginx_force_include.conf
20 # can override more than nginx_vhost_include.conf file.
21 #
22 # Both include points: http://bit.ly/WlOQRy and http://bit.ly/UrfDwu
23 #
24 # Nginx will look for both files in the include directory specified below:
25 #
26 # For Satellite Instances:
27 # /data/disk/EDIT_USER/config/server_master/nginx/post.d/
28 #
29 # For Master Instance:
30 # /var/aegir/config/includes/
31 #
32 # These files will be included if exist and will never be modified
33 # or touched by Aegir Provision backend system.
34 #
35 # Note: your custom rewrite rules will apply to *all* sites
36 # on the same Aegir Satellite Instance, unless you will use
37 # site/domain specific if{} embedded locations, as shown
38 # in the examples below.
39 #
40
41 ###
42 ### Custom rewrites to map legacy content to the Drupal multisite.
43 ###
44 location ~* ^.+\.(?:jpe?g|gif|png|ico|swf|pdf|ttf|html?)$ {
45   access_log off;
46   expires    30d;
47   rewrite    ^/files/(.*)$     /sites/$server_name/files/$1 last;
48   rewrite    ^/images/(.*)$    /sites/$server_name/files/images/$1 last;
49   rewrite    ^/downloads/(.*)$ /sites/$server_name/files/downloads/$1 last;
50   rewrite    ^/download/(.*)$  /sites/$server_name/files/download/$1 last;
51   rewrite    ^/docs/(.*)$      /sites/$server_name/files/docs/$1 last;
52   rewrite    ^/documents/(.*)$ /sites/$server_name/files/documents/$1 last;
53   rewrite    ^/legacy/(.*)$    /sites/$server_name/files/legacy/$1 last;
54   try_files  $uri =404;
55 }
56
57 ###
58 ### Site specific 301 redirect with parent literal location
59 ### to stop searching for (and using) other regex based locations.
60 ###
61 location ^~ /some-literal-path/no-regex-here {
62   location ~* ^/some-path/or-regex-here {
63     if ($host ~* ^(www\.)?(domain\.com)$) {
64       rewrite ^ $scheme://$host/destination/url permanent;
65     }
66     try_files $uri @cache;
67   }
68 }
69
70 ###
71 ### Site specific 301 redirect for various legacy .php URIs with parent literal
72 ### locations to stop searching for (and using) other regex based locations.
73 ###
74 location ^~ /services {
75   location ~* ^/services {
76     if ($host ~* ^(www\.)?(foo\.com)$) {
77       rewrite ^/services/accounting\.php$ $scheme://$host/node/18 permanent;
78       rewrite ^/services/assurance\.php$  $scheme://$host/node/11 permanent;
79       rewrite ^/services/audit\.php$      $scheme://$host/node/11 permanent;
80       rewrite ^/services/taxation\.php$   $scheme://$host/node/92 permanent;
81       rewrite ^/services/wealth\.php$     $scheme://$host/node/15 permanent;
82       rewrite ^/services\.php$            $scheme://$host/node/17 permanent;
83     }
84     try_files $uri @cache;
85   }
86   try_files $uri @cache;
87 }
88 location ^~ /our_team {
89   location ~* ^/our_team {
90     if ($host ~* ^(www\.)?(foo\.com)$) {
91       rewrite ^/our_team\.php$ $scheme://$host/node/10 permanent;
92       rewrite ^/our_team$      $scheme://$host/node/10 permanent;
93     }
94     try_files $uri @cache;
95   }
96   try_files $uri @cache;
97 }
98 location = /about_us.php {
99   if ($host ~* ^(www\.)?(foo\.com)$) {
100     rewrite ^ $scheme://$host/node/19 permanent;
101   }
102   return 403;
103 }