add comments about shared buffer and db work mem

diff --git a/samples/data.yml b/samples/data.yml
index cef5c78ed645d214bde0cb619f33d7f504b02e0d..29888c9a5bb518609f2a58b1cdea56f49365f183 100644 (file)
--- a/samples/data.yml
+++ b/samples/data.yml
@@ -14,9 +14,17 @@ expose:
 
 params:
   db_default_text_search_config: "pg_catalog.english"
-  ## Set db_shared_buffers to 1/3 of the memory you wish to allocate to postgres
-  ## on 1GB install set to 128MB on a 4GB instance you may raise to 1GB
+
+  ## Set db_shared_buffers to a max of 25% of the total memory.
+  ##
+  ## On 1GB installs set to 128MB (to leave room for other processes)
+  ## on a 4GB instance you may raise to 1GB
   #db_shared_buffers: "256MB"
+  #
+  ## Set higher on large instances it defaults to 10MB, for a 3GB install 40MB is a good default
+  ## this improves sorting performance, but adds memory usage per-connection
+  #db_work_mem: "40MB"
+  #
 
 env:
   # ensure locale exists in container, you may need to install it

diff --git a/samples/standalone.yml b/samples/standalone.yml
index 9c372b3c0c2c2286e9f4a6671f605e4cc0788867..cac5c7399f627796814eb6f116d156ed1bce38a1 100644 (file)
--- a/samples/standalone.yml
+++ b/samples/standalone.yml
@@ -27,10 +27,17 @@ expose:
 
 params:
   db_default_text_search_config: "pg_catalog.english"
-  ## Set db_shared_buffers to 1/3 of the memory you wish to allocate to postgres
-  ## on 1GB install set to 128MB on a 4GB instance you may raise to 1GB
+
+  ## Set db_shared_buffers to a max of 25% of the total memory.
+  ##
+  ## On 1GB installs set to 128MB (to leave room for other processes)
+  ## on a 4GB instance you may raise to 1GB
   #db_shared_buffers: "256MB"
   #
+  ## Set higher on large instances it defaults to 10MB, for a 3GB install 40MB is a good default
+  ## this improves sorting performance, but adds memory usage per-connection
+  #db_work_mem: "40MB"
+  #
   ## Which Git revision should this container use? (default: tests-passed)
   #version: tests-passed