Added HACKING file with memory readings.

1 files changed, 58 insertions, 0 deletions

diff --git a/HACKING b/HACKING
new file mode 100644
index 0000000..6348da4
--- /dev/null
+++ b/HACKING
@@ -0,0 +1,58 @@
+Memory Consumption
+==================
+
+What follows are readings taken from the staging server about memory consumption
+for RhodeCode, RabbitMQ and Apache, and overall system memory.
+
+The readings have been performed using the following tools and commands:
+
+    pmap -d $process_pid
+    sync && echo 3 > /proc/sys/vm/drop_caches
+
+In case of swap space, the previous command could be run also as:
+
+    swapoff -a && sync && echo 3 > /proc/sys/vm/drop_caches && swapon -a
+
+Keep in mind that there needs to be sufficient memory to allow swap space to be
+moved there.
+
+Tools like top, htop or ps are not precise enough to get a clear picture of real
+Linux memory consumptions.
+
+The readings have been performed in 3 different moments, with normal website
+operation, and with CI jobs cloning repositories from the server.
+
+RhodeCode
+---------
+
+mapped: 1742036K    writeable/private: 1090156K    shared: 124980K
+mapped: 2758760K    writeable/private: 1090216K    shared: 1141648K
+mapped: 3307952K    writeable/private: 1121856K    shared: 1611184K
+
+RabbitMQ
+--------
+
+mapped: 2135512K    writeable/private: 84448K    shared: 0K
+mapped: 2135512K    writeable/private: 84448K    shared: 0K
+mapped: 2135512K    writeable/private: 84448K    shared: 0K
+
+Apache
+------
+
+mapped: 81692K    writeable/private: 3036K    shared: 788K
+mapped: 81692K    writeable/private: 3036K    shared: 788K
+mapped: 81692K    writeable/private: 3036K    shared: 788K
+
+System Memory
+-------------
+
+             total       used       free     shared    buffers     cached
+Mem:      15339668    1340244   13999424          0        848      27136
+-/+ buffers/cache:    1312260   14027408
+
+Mem:      15339668    1340356   13999312          0        704      27204
+-/+ buffers/cache:    1312448   14027220
+
+Mem:      15339668    1372744   13966924          0        164      27932
+-/+ buffers/cache:    1344648   13995020
+