Add info about geomirror troubleshooting

diff --git a/sphinx/vm.rst b/sphinx/vm.rst
index db4008a1b1f62d6a3211d2418dcce7f6584fe2c3..126eba2d9389b74340d291ea425143e3182f9ae9 100644 (file)
--- a/sphinx/vm.rst
+++ b/sphinx/vm.rst
@@ -180,9 +180,33 @@ virtual machine.
           frameborder="0"></iframe>
 
 
+.. _chap_vm_troubleshooting:
+
 Troubleshooting
 ~~~~~~~~~~~~~~~
 
+Updating the VM or installing new packages doesn't work.
+
+  The VM uses as service that tries to figure out the best/closest package
+  repository for you. In some network environments this service might not work
+  well, or not at all. To check if this is a problem, you can modify the
+  respective configuration by hand. Edit ``/etc/apt/sources.list`` (you need to
+  use ``sudo`` for that) and replace the package repository URL with a mirror
+  close to you. A comprehensive list of mirrors is available at:
+  http://www.debian.org/mirror/list
+
+  Pick one and replace all ``geomirror.debian.net`` URLs with the new mirror
+  URL. For example, in Canada you might want to change::
+
+    deb http://i386-geomirror.debian.net/debian squeeze main non-free contrib
+
+  to::
+
+    deb http://ftp.ca.debian.org/debian/ squeeze main non-free contrib
+
+  Only modify lines that refer to ``geomirror`` (all of them), but do **not**
+  modify entries for ``security.debian.org``.
+
 I cannot hear sounds played in the virtual machine.
 
   By default the sound is muted. To enable playback launch the mixer applet by

diff --git a/sphinx/vm_welcome.rst b/sphinx/vm_welcome.rst
index dd0803a7e67bfb3bd28856d80eac3083a6c7913b..d3a3276dfec4daa225dbe4ad5e4ce67a1d927150 100644 (file)
--- a/sphinx/vm_welcome.rst
+++ b/sphinx/vm_welcome.rst
@@ -10,5 +10,5 @@ interesting:
 * :ref:`NeuroDebian news <news>`
 * :ref:`User support <support>`
 * :ref:`Virtual machine tutorial video <chap_vm>`
-* :ref:`Known issues <chap_vm>`
+* :ref:`Known issues and troubleshooting <chap_vm_troubleshooting>`