[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