docs/source/errors.rst

   1 Errors & Troubleshooting
   2 ========================
   3
   4 The main Ganeti install page assumes significant background knowledge,
   5 especially regarding troubleshooting. This page provides guidance about
   6 common errors that occur during the installation process. This page is
   7 structured to supplement the :doc:`manual-install` guide.
   8
   9 For help with problems related to installing Ganeti Web Manager with
  10 Fabric, please see :doc:`fabric-install`.
  11
  12 If you discover ambiguities or problems with the installation
  13 instructions that aren't addressed in this page, please ask in the
  14 #ganeti-webmgr channel on Freenode! If you're unfamiliar with IRC,
  15 Freenode's `Using the Network <http://freenode.net/using_the_network.shtml>`_
  16 page can help you get started.
  17
  18 Get The Code
  19 ------------
  20
  21 Step 3 -- mkdir ganeti\_webmgr\_lib
  22 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  23
  24 If you skip this step, you will be unable to copy and paste the commands
  25 from later sections, because they will refer to a location that doesn't
  26 exist. If you realize later that you forgot to create this directory, it
  27 will still be possible to complete the installation and run the server
  28 without problems. You will have to change any commands that include
  29 **ganeti\_webmgr\_lib** to reflect the actual location of
  30 **object\_permissions** and **object\_log** if you clone them into your
  31 home directory, though.
  32
  33 Step 5 -- Creating Symbolic Links
  34 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  35
  36 After following the install instructions, you should check that the
  37 symlinks worked correctly. Here's an example where object\_log didn't
  38 link correctly (object\_permissions shows how a valid symlink looks):
  39
  40 .. figure:: /_static/broken_vs_working_symlinks.png
  41    :align: center
  42    :alt: Picture of one broken and one working symlink in bash
  43
  44    Picture of one broken and one working symlink in bash
  45
  46 To fix it, figure out where the django\_object\_log directory is -- you
  47 might have accidentally put it in your home folder instead of
  48 **ganeti\_object\_lib**. Now cd back into **ganeti\_webmgr** to remove
  49 the broken link and replace it with a good one:
  50
  51 ::
  52
  53     rm object_log
  54     ln -s ../django_object_log/object_log .
  55
  56 The django\_object\_log/object\_log part of the ln command should be the
  57 path from your home directory to the location of object\_log.
  58
  59 Optional (for the web-based VNC console)
  60 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  61
  62 ::
  63
  64     fatal: The remote end hung up unexpectedly
  65
  66 The remote end hangs up when it gets an input telling it to return a
  67 file that isn't there. Check everything for typos and try again.
  68
  69 Configuration
  70 -------------
  71
  72 Step 3 -- **syncdb**
  73 ~~~~~~~~~~~~~~~~~~~~
  74
  75 ::
  76
  77     Error: No module named object_log
  78     Error: No module named object_permissions
  79
  80 Either of these errors means that a symlink is broken. Step 5 under Get
  81 The Code, above, explains how to fix this.
  82
  83 401 Unauthorized: No permission -- see authorization schemes
  84 ------------------------------------------------------------
  85
  86 This error occurs when your cluster is not :doc:`usage/clusters`, or the user
  87 credentials are incorrect.