Changeset 48485 in vbox for trunk/doc

Timestamp:

Sep 16, 2013 11:55:45 AM (12 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

88975

Message:

doc: we stopped using SysV semaphores, remove obsolete documentation and mention the good news in the changelog

Location:

trunk/doc/manual

Files:

• en_US/user_AdvancedTopics.xml (modified) (1 diff)
• user_ChangeLogImpl.xml (modified) (1 diff)

trunk/doc/manual/en_US/user_AdvancedTopics.xml

@@ -1165 +1165 @@
       200 seconds to detect this situation. The VM will fail to power
       up.</para>
-    </sect2>
-  </sect1>
-
-  <sect1>
-    <title>Launching more than 128 VMs on Linux hosts</title>
-
-    <para>Linux hosts have a fixed number of IPC semaphores IDs per process
-    preventing users from starting substantially many VMs. The exact number
-    may vary with each Linux distribution. While trying to launch more VMs you
-    would be shown a "Cannot create IPC semaphore" error. In order to run more
-    VMs, you will need to increase the semaphore ID limit of the VBoxSVC
-    process. Find the current semaphore limits imposed by the kernel by
-    executing as root:<screen>#/sbin/sysctl kernel.sem
-kernel.sem = 250  32000  32  128</screen></para>
-
-    <para>The "kernel.sem" parameter bundles together 4 values, the one we are
-    interested in is called "SEMMNI", the maximum number of semaphore IDs
-    which is 128 in the above example. Increase this semaphore ID limit by
-    executing as root:<screen>echo "kernel.sem = 250 32000 32 2048" &gt;&gt; /etc/sysctl.conf
-/sbin/sysctl -p</screen></para>
-
-    <para>The above commands will add the new limits to the configuration file, thus
-    making the effect persistent across reboots, and will activate the new
-    limits into the currently running kernel.</para>
-  </sect1>
-
-  <sect1>
-    <title>Launching more than 120 VMs on Solaris hosts</title>
-
-    <para>Solaris hosts have a fixed number of IPC semaphores IDs per process
-    preventing users from starting more than 120 VMs. While trying to launch
-    more VMs you would be shown a "Cannot create IPC semaphore" error. In
-    order to run more VMs, you will need to increase the semaphore ID limit of
-    the VBoxSVC process.</para>
-
-    <sect2>
-      <title>Temporary solution while VirtualBox is running</title>
-
-      <para>Execute as root the <computeroutput>prctl</computeroutput> command
-      as shown below for the currently running VBoxSVC process. The process ID
-      of VBoxSVC can be obtained using the <computeroutput>ps</computeroutput>
-      command.</para>
-
-      <screen>prctl -r -n project.max-sem-ids -v 2048 &lt;pid-of-VBoxSVC&gt;</screen>
-
-      <para>This will immediately increase the semaphore limit of the
-      currently running VBoxSVC process and allow you to launch more VMs.
-      However, this change is not persistent and will be lost when VBoxSVC
-      terminates.</para>
-    </sect2>
-
-    <sect2>
-      <title>Persistent solution, requires user to re-login</title>
-
-      <para>If the user running VirtualBox is root, execute the following
-      command:</para>
-
-      <screen>prctl -n project.max-sem-ids -v 2048 -r -i project user.root</screen>
-
-      <para>From this point, starting new processes will have the increased
-      limit of 2048. You may then re-login or close all VMs and restart
-      VBoxSVC. You can check the current VBoxSVC semaphore ID limit using the
-      following command:</para>
-
-      <screen>prctl -n project.max-sem-ids -i process &lt;pid-of-VBoxSVC&gt;</screen>
-
-      <para>If the user running VirtualBox is not root, you must add the
-      property to the user's default project. Create the default project and
-      set the limit by executing as root:</para>
-
-      <screen>projadd -U &lt;username&gt; user.&lt;username&gt;
-projmod -s -K "project.max-sem-ids=(priv,2048,deny)" user.&lt;username&gt;</screen>
-
-      <para>Substitute "&lt;username&gt;" with the name of the user running
-      VirtualBox. Then re-login as this user to be able to run more than 120
-      VMs.</para>
     </sect2>
   </sect1>

trunk/doc/manual/user_ChangeLogImpl.xml

@@ -137 +137 @@
         <para>Main: new event queue implementation which does not use the host's
           native event queue for processing VirtualBox events anymore</para>
+      </listitem>
+
+      <listitem>
+        <para>Main: eliminate the use of SysV semaphores on all host OSes
+           other than Windows, namely Linux, Solaris and Mac OS X, with the
+           consequence that no system reconfiguration is needed to run more
+           than approximately 100 VMs</para>
       </listitem>