[master] 8c857ed Merge virtualised into a new platform specific notes section. Add transparent hugepages info from ticket 1054.

Lasse Karstensen lkarsten at varnish-cache.org
Thu Nov 22 15:05:38 CET 2012


commit 8c857ed88cbacc7630f8103de2cd7b65d37e7e57
Author: Lasse Karstensen <lasse at varnish-software.com>
Date:   Thu Nov 22 15:05:34 2012 +0100

    Merge virtualised into a new platform specific notes section. Add transparent hugepages info from ticket 1054.

diff --git a/doc/sphinx/installation/index.rst b/doc/sphinx/installation/index.rst
index 916ecde..15b61eb 100644
--- a/doc/sphinx/installation/index.rst
+++ b/doc/sphinx/installation/index.rst
@@ -16,5 +16,6 @@ move traffic.
 	help.rst
 	bugs.rst
 	upgrade.rst
+	platformnotes.rst
 
 
diff --git a/doc/sphinx/installation/platformnotes.rst b/doc/sphinx/installation/platformnotes.rst
new file mode 100644
index 0000000..4f76f9e
--- /dev/null
+++ b/doc/sphinx/installation/platformnotes.rst
@@ -0,0 +1,37 @@
+
+Platform specific notes
+------------------------
+
+Transparent hugepages on Redhat Linux 6
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+On RHEL6 Transparent Hugepage kernel support is enabled by default.
+This is known to cause sporadic crashes of Varnish.
+
+It is recommended to disable transparent hugepages on affected systems::
+
+    $ echo "never" > /sys/kernel/mm/redhat_transparent_hugepage/enabled
+
+On Debian/Ubuntu systems running 3.2 kernels the default value is "madvise" and does not need to changed.
+
+
+OpenVZ
+~~~~~~
+
+It is possible, but not recommended for high performance, to run
+Varnish on virtualised hardware. Reduced disk and network -performance
+will reduce the performance a bit so make sure your system has good IO
+performance.
+
+If you are running on 64bit OpenVZ (or Parallels VPS), you must reduce
+the maximum stack size before starting Varnish.
+
+The default allocates to much memory per thread, which will make varnish fail
+as soon as the number of threads (traffic) increases.
+
+Reduce the maximum stack size by running::
+
+    ulimit -s 256
+
+in the Varnish startup script.
+
diff --git a/doc/sphinx/users-guide/index.rst b/doc/sphinx/users-guide/index.rst
index f3f4a2c..bfedbae 100644
--- a/doc/sphinx/users-guide/index.rst
+++ b/doc/sphinx/users-guide/index.rst
@@ -36,7 +36,6 @@ separate topic.
 	purging
 	compression
 	esi
-	virtualized
 	websockets
 	devicedetection
         handling_misbehaving_servers
diff --git a/doc/sphinx/users-guide/virtualized.rst b/doc/sphinx/users-guide/virtualized.rst
deleted file mode 100644
index 5fc59b6..0000000
--- a/doc/sphinx/users-guide/virtualized.rst
+++ /dev/null
@@ -1,25 +0,0 @@
-
-XXX: What is this doing here?
-
-Running Varnish in a virtualized environment
---------------------------------------------
-
-It is possible, but not recommended for high performance, to run
-Varnish on virtualized hardware. Reduced disk- and network performance
-will reduce the performance a bit so make sure your system has good IO
-performance.
-
-OpenVZ
-~~~~~~
-
-If you are running on 64bit OpenVZ (or Parallels VPS), you must reduce
-the maximum stack size before starting Varnish. The default allocates
-to much memory per thread, which will make varnish fail as soon as the
-number of threads (==traffic) increases.
-
-Reduce the maximum stack size by running::
-
-    ulimit -s 256
-
-in the startup script.
-



More information about the varnish-commit mailing list