docs/source/fabric-install.rst

   1 Troubleshooting Fabric
   2 ======================
   3
   4 This page provides a list of common problems and errors encountered when
   5 installing Ganeti Web Manager with Fabric, and their solutions. If you
   6 are installing manually instead of using Fabric, please see
   7 :doc:`errors`.
   8
   9 If you discover ambiguities or problems with the installation
  10 instructions that aren't addressed in this page, please ask in the
  11 #ganeti-webmgr channel on Freenode! If you're unfamiliar with IRC,
  12 Freenode's `Using the Network <http://freenode.net/using_the_network.shtml>`_
  13 document can help you get started.
  14
  15 Installation
  16 ------------
  17
  18 With Pip
  19 ~~~~~~~~
  20
  21 ::
  22
  23     sudo pip install fabric
  24
  25 On Ubuntu
  26 ~~~~~~~~~
  27
  28 ::
  29
  30     sudo apt-get install python-pip
  31
  32 Errors
  33 ------
  34
  35 Fabfiles
  36 ~~~~~~~~
  37
  38 ::
  39
  40     Fatal error: Couldn't find any fabfiles!
  41
  42 #. Are you in the ganeti\_webmgr directory?
  43 #. Are you running version **0.7**? Check your version in the Changelog.
  44    **0.7** is the first release to come packaged with the fabfile. There
  45    will be a short interval between the publication of these
  46    instructions and the release of **0.7** during which install from
  47    Fabric will not work from the master, which is what Fabric
  48    automatically downloads. If you want to use Fabric before **0.7** is
  49    officially released, you'll need to use the develop version:
  50    ::
  51
  52        cd ganeti_webmgr
  53        git pull origin develop
  54
  55 Can't find settings.py
  56 ~~~~~~~~~~~~~~~~~~~~~~
  57
  58 ::
  59
  60     Error: Can't find the file 'settings.py' in the directory containing './manage.py'. It appears you've customized things.
  61     You'll have to run django-admin.py, passing it your settings module.
  62     (If the file settings.py does indeed exist, it's causing an ImportError somehow.)
  63
  64 Did you remember to **cp setttings.py.dist settings.py** ?
  65
  66 Database Error ("no such table", "no column named *\_*", etc.)
  67 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  68 ::
  69
  70      DatabaseError at /
  71
  72     no such table: django_session
  73
  74 or
  75
  76 ::
  77
  78     table ganeti_web_virtualmachinetemplate has no column named disks
  79
  80 when this error appears in your browser (with testing set to true in
  81 your settings.py), you might be able to fix it by quitting the server
  82 and running **./manage.py syncdb --migrate**
  83
  84 If the error persists, try **diff settings.py.dist settings.py**. Add
  85 any lines from settings.py.dist to settings.py that weren't previously
  86 there.
  87 You could use **cp settings.py.dist settings.py**, but that would
  88 overwrite any custom settings you've added. Then:
  89
  90 ::
  91
  92     ./manage.py reset ganeti_web
  93     ./manage.py syncdb --migrate
  94
  95 This works because reset then syncdb causes the database to be
  96 re-created containing tables that the installed apps listed in
  97 settings.py will need. If the app whose table was missing (such as
  98 tastypie) was not listed in your settings.py, no table would have been
  99 created for it.
 100
 101 DRBD machine creation error
 102 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 103
 104 ::
 105
 106     Primary and Secondary Nodes must not match
 107
 108 This happens when you try to create a machine using drbd disk template
 109 on a cluster with only one node. The template requires both a primary
 110 and a secondary node, and if your cluster doesn't have a second node,
 111 the 'secondary node' selection field cannot be made available. The
 112 solution is to either add another node to your cluster, or select a
 113 different disk template.
 114
 115 Instance Create error
 116 ~~~~~~~~~~~~~~~~~~~~~
 117
 118 ::
 119
 120         Instance Create
 121
 122         The given name (<name of VM you're trying to create>) does not resolve: Name or service not known
 123
 124 Cause of Error: The name you chose for your VM broke the DNS name
 125 resolver
 126 Solution: Click edit at the lower right of the error screen. If you're
 127 sure you gave it the name you want, uncheck the DNS Name Check box and
 128 click create again. Otherwise, change the Instance Name to something
 129 that will resolve better, leave the DNS Name Check box checked, and
 130 click create.
 131
 132 OS Create Script Failed
 133 ~~~~~~~~~~~~~~~~~~~~~~~
 134
 135 ::
 136
 137     OS create script failed (exited with exit code 1)
 138
 139 If you get this error when creating a VM, you should try deleting the VM
 140 and re-creating it with more disk space. A good rule of thumb is to give
 141 Ubuntu at least 2GB.
 142
 143 Instance Rename
 144 ~~~~~~~~~~~~~~~
 145
 146 ::
 147
 148        Instance Rename
 149         Instance 'oldname.gwm.osuosl.org' not known
 150
 151 This error occurs when you had the DNS name check enabled when renaming
 152 the VM.
 153
 154 Instance Startup
 155 ~~~~~~~~~~~~~~~~
 156
 157 ::
 158
 159         Instance Startup
 160         Instance 'breakthis.gwm.osuosl.org' not known
 161
 162 -  Diskless machines cannot start. This error sometimes happens when you
 163    try to.
 164 -  Is the OS successfully installed?
 165
 166 Missing Templates
 167 ~~~~~~~~~~~~~~~~~
 168
 169 Problem: output such as **raise TemplateDoesNotExist(name)
 170 TemplateDoesNotExist:** from either testing or trying to use the site.
 171
 172 Solution: If you've recently updated from the Develop branch (recently
 173 as in 6/28/2011), you'll need to **cp settings.py.dist settings.py**
 174 again. If you had an old settings.py, it will be looking for the
 175 templates in the wrong place. It seeks the templates in a top-level
 176 registration directory, when they're now actually in a sub-directory of
 177 the ganeti\_web\_layout module.
 178
 179 whoosh\_index not writable for current user/group
 180 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 181
 182 Situation: This can happen when running GWM through Apache.
 183 Solution:
 184
 185 ::
 186
 187     chown apache:apache whoosh_index/