Skip to content

Commit ce9af41

Browse files
author
Bob Grabar
committed
DOCS-693 migrate Troubleshooting page
1 parent 22b3053 commit ce9af41

File tree

1 file changed

+45
-0
lines changed

1 file changed

+45
-0
lines changed

source/faq/fundamentals.txt

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -222,3 +222,48 @@ operating systems are strongly recommended.
222222
32-bit builds disable :term:`journaling <journal>` by default
223223
because journaling further limits the maximum amount of data that
224224
the database can store.
225+
226+
.. todo Create a Troubleshooting page for these next two faqs on
227+
shutdowns and keepalive
228+
229+
The ``mongod`` process has disappeared from the logs. Where can I find information?
230+
-----------------------------------------------------------------------------------
231+
232+
If :program:`mongod` shuts down unexpectedly on a UNIX or UNIX-based
233+
platform, and if :program:`mongod` fails to log a shutdown or error
234+
message, then check the global logs in the ``/var/log/messages``
235+
directory. Check for messages pertaining to MongoDB by running the
236+
following commands:
237+
238+
.. code-block:: sh
239+
240+
sudo grep mongod /var/log/messages
241+
sudo grep score /var/log/messages
242+
243+
Does TCP "keepalive" time affect sharded clusters and replica sets?
244+
-------------------------------------------------------------------
245+
246+
If you are experiencing unexplainable socket errors between members of a
247+
sharded cluster or replica set, check the ``tcp_keepalive_time`` value.
248+
The default Linux ``tcp_keepalive_time`` value is ``7200`` seconds (2
249+
hours). For MongoDB, change this to ``300`` seconds (five minutes).
250+
251+
To check your ``tcp_keepalive_time`` value, issue the following command:
252+
253+
.. code-block:: sh
254+
255+
cat /proc/sys/net/ipv4/tcp_keepalive_time
256+
257+
To change the ``tcp_keepalive_time`` value, issue the following command:
258+
259+
.. code-block:: sh
260+
261+
echo 300 > /proc/sys/net/ipv4/tcp_keepalive_time
262+
263+
The new ``tcp_keepalive_time`` value takes effect without requiring you
264+
to restart not need to restart the :program:`mongod` or
265+
:program:`mongos` servers.
266+
267+
You must alter the ``tcp_keepalive_time`` value on all machines hosting
268+
MongoDB processes. This includes all machines hosting :program:`mongos`
269+
or :program:`mongod` servers.

0 commit comments

Comments
 (0)