Bug 80267

Summary: Add information on tuning kern.maxvnodes
Product: Documentation Reporter: Brad Davis <so14k>
Component: Books & ArticlesAssignee: jcamou
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description Brad Davis 2005-04-22 23:40:16 UTC
	Add information on tuning kern.maxvnodes.
Comment 1 jcamou freebsd_committer freebsd_triage 2005-04-22 23:49:58 UTC
Responsible Changed
From-To: freebsd-doc->jcamou

Over to me.
Comment 2 Brad Davis 2005-04-23 00:10:38 UTC
Fix a typo and professionalize some wording noticed by jcamou@


--- doc-ori/en_US.ISO8859-1/books/handbook/config/chapter.sgml	Fri Apr 22 11:51:50 2005
+++ doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml	Fri Apr 22 17:08:09 2005
@@ -2228,6 +2228,42 @@
 	</note>
       </sect3>
     </sect2>
+
+    <sect2>
+      <title>Virtual Memory</title>
+
+      <sect3>
+        <title><varname>kern.maxvnodes</varname></title>
+
+        <para>A vnode is the internal representation of a file or
+          directory.  So increasing the number of vnodes available to
+          the operating system cuts down on disk I/O.  Normally this
+          is handled by the operating system and does not need to be
+          changed.  In some cases where disk I/O is a bottleneck and
+          the system is running out of vnodes, this setting will need
+          to be increased.  The amount of inactive and free RAM will
+          need to be taken into account.</para>
+
+        <para>To see the current number of vnodes in use:</para>
+
+        <programlisting>&prompt.root; sysctl vfs.numvnodes
+vfs.numvnodes: 91349</programlisting>
+
+        <para>To see the maximum vnodes:</para>
+
+        <programlisting>&prompt.root; sysctl kern.maxvnodes
+kern.maxvnodes: 100000</programlisting>
+
+        <para>If the current vnode usage is near the maximum, increasing
+          <varname>kern.maxvnodes</varname> by a 1,000 is probably a
+          good idea.  Keep an eye on the number of
+          <varname>vfs.numvnodes</varname>.  If it climbs up to the
+          maximum again, <varname>kern.maxvnodes</varname> will need to
+          be increased further.  A shift in your memory usage as
+          reported by &man.top.1; should be visable.  More memory should
+          be active.</para>
+      </sect3>
+    </sect2>
   </sect1>
 
   <sect1 id="adding-swap-space">
Comment 3 Brad Davis 2005-04-23 23:47:45 UTC
Improve wording, noticed by will@

s/by a 1,000/by a value of 1,000/


--- doc-ori/en_US.ISO8859-1/books/handbook/config/chapter.sgml	Fri Apr 22 11:51:50 2005
+++ doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml	Sat Apr 23 16:45:14 2005
@@ -2228,6 +2228,42 @@
 	</note>
       </sect3>
     </sect2>
+
+    <sect2>
+      <title>Virtual Memory</title>
+
+      <sect3>
+        <title><varname>kern.maxvnodes</varname></title>
+
+        <para>A vnode is the internal representation of a file or
+          directory.  So increasing the number of vnodes available to
+          the operating system cuts down on disk I/O.  Normally this
+          is handled by the operating system and does not need to be
+          changed.  In some cases where disk I/O is a bottleneck and
+          the system is running out of vnodes, this setting will need
+          to be increased.  The amount of inactive and free RAM will
+          need to be taken into account.</para>
+
+        <para>To see the current number of vnodes in use:</para>
+
+        <programlisting>&prompt.root; sysctl vfs.numvnodes
+vfs.numvnodes: 91349</programlisting>
+
+        <para>To see the maximum vnodes:</para>
+
+        <programlisting>&prompt.root; sysctl kern.maxvnodes
+kern.maxvnodes: 100000</programlisting>
+
+        <para>If the current vnode usage is near the maximum, increasing
+          <varname>kern.maxvnodes</varname> by a value of 1,000 is
+          probably a good idea.  Keep an eye on the number of
+          <varname>vfs.numvnodes</varname>.  If it climbs up to the
+          maximum again, <varname>kern.maxvnodes</varname> will need to
+          be increased further.  A shift in your memory usage as
+          reported by &man.top.1; should be visable.  More memory should
+          be active.</para>
+      </sect3>
+    </sect2>
   </sect1>
 
   <sect1 id="adding-swap-space">
Comment 4 Brad Davis 2005-04-23 23:50:27 UTC
Fix a spelling error, also noticed by will@



--- doc-ori/en_US.ISO8859-1/books/handbook/config/chapter.sgml	Fri Apr 22 11:51:50 2005
+++ doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml	Sat Apr 23 16:48:24 2005
@@ -2228,6 +2228,42 @@
 	</note>
       </sect3>
     </sect2>
+
+    <sect2>
+      <title>Virtual Memory</title>
+
+      <sect3>
+        <title><varname>kern.maxvnodes</varname></title>
+
+        <para>A vnode is the internal representation of a file or
+          directory.  So increasing the number of vnodes available to
+          the operating system cuts down on disk I/O.  Normally this
+          is handled by the operating system and does not need to be
+          changed.  In some cases where disk I/O is a bottleneck and
+          the system is running out of vnodes, this setting will need
+          to be increased.  The amount of inactive and free RAM will
+          need to be taken into account.</para>
+
+        <para>To see the current number of vnodes in use:</para>
+
+        <programlisting>&prompt.root; sysctl vfs.numvnodes
+vfs.numvnodes: 91349</programlisting>
+
+        <para>To see the maximum vnodes:</para>
+
+        <programlisting>&prompt.root; sysctl kern.maxvnodes
+kern.maxvnodes: 100000</programlisting>
+
+        <para>If the current vnode usage is near the maximum, increasing
+          <varname>kern.maxvnodes</varname> by a value of 1,000 is
+          probably a good idea.  Keep an eye on the number of
+          <varname>vfs.numvnodes</varname>.  If it climbs up to the
+          maximum again, <varname>kern.maxvnodes</varname> will need to
+          be increased further.  A shift in your memory usage as
+          reported by &man.top.1; should be visible.  More memory should
+          be active.</para>
+      </sect3>
+    </sect2>
   </sect1>
 
   <sect1 id="adding-swap-space">
Comment 5 jcamou freebsd_committer freebsd_triage 2005-04-24 04:16:11 UTC
State Changed
From-To: open->closed

Committed, thanks!