doc/FAQ.txt

   1 Roundup FAQ
   2 ===========
   3
   4 :Version: $Revision: 1.8 $
   5
   6 NOTE: This is just a grabbag, most of this should go into documentation.
   7
   8 .. contents::
   9
  10
  11 Changing HTML layout
  12 --------------------
  13
  14 Note changes to the files in html take place immediatly without
  15 restart, even when running roundup-server.
  16
  17 Displaying whole messages not only the summary
  18 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  19
  20 Modify instance/html/msg.index change::
  21
  22    <td><display call="plain('summary')"></td>
  23
  24 to::
  25
  26    <td><pre><display call="plain('content')"></pre></td>
  27
  28 displays the whole message not only the first line and 'pre'
  29 prevents the browser from reformatting.
  30
  31 Getting the nosy list picker instead of textfield
  32 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  33
  34 In classic template there is plenty of space below the text field.
  35 So one could modify instance/html/issue.item to use it.
  36
  37 At the file top set 'border=1' to see cell boundaries, then
  38 replace::
  39
  40   <td class="form-text"><display call="field('nosy',size=20)"></td>
  41
  42 by::
  43
  44   <td rowspan=5 class="form-text"><display call="menu('nosy',height=10)"></td>
  45
  46 and remove the last cell in the next four rows, either by deleting a cell
  47 or by reducing colspan.
  48
  49 Want to see the issue id (the number) on the issue item display
  50 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  51
  52 The number is really a central information and not an internal one.
  53
  54 In file INSTANCE/html/issue.item displays the creator, so one could add
  55 the number to it.::
  56
  57   <td class="form-text"><display call="reldate('creation', pretty=1)">
  58       (<display call="plain('creator')">)</td>
  59
  60 to see::
  61
  62   <td class="form-text"><display call="reldate('creation', pretty=1)">
  63       (issue<display call="plain('id')"> by <display call="plain('creator')">)</td>
  64
  65 Installation
  66 ------------
  67
  68 Living without a mailserver.
  69 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  70
  71 Remove the nosy reactor, means delete the file
  72 'INSTANCE/detectors/nosyreactor.py'.
  73
  74
  75 Rights issues (MISSING)
  76 ~~~~~~~~~~~~~~~~~~~~~~~
  77
  78 Different jobs run under different users.
  79
  80 * Standalone roundup-server is started by whome ?
  81
  82 * Running cgi under apache.
  83
  84 * roundup-mailgw called via .forward from MTA, or running a cron job
  85   fetching via pop.
  86
  87 see Troubleshooting_.
  88
  89
  90 Troubleshooting
  91 ---------------
  92
  93 AttributeError: '_roundup_instance_1' module has no attribute 'open'
  94 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  95
  96 For example submitting issues via roundup-mailgw breaks similar to this::
  97
  98   Command died with status 1:
  99   "/usr/local/bin/python /usr/local/bin/roundup-mailgw /home/roundup".
 100   Command output: Traceback (most recent call last):
 101     File "/usr/local/bin/roundup-mailgw", line 178, in ?
 102        sys.exit(main(sys.argv))
 103     File "/usr/local/bin/roundup-mailgw", line 153, in main
 104       db = instance.open('admin')
 105        AttributeError: '_roundup_instance_1' module has no attribute 'open'
 106
 107 Happens if the user which accesses the instance has no read right
 108 on 'INSTANCE/dbinit.py' or 'pyc'.
 109
 110 If the user has no rights on the 'INSTANCE/db' the mailgw finishes,
 111 but is, of course, unable to add the message. A notification to
 112 the roundup-admin is sent, with a longer trace ending in::
 113
 114   File "/opt/python/lib/python2.2/dbhash.py", line 16, in open
 115     return bsddb.hashopen(file, flag, mode)
 116   error: (13, 'Keine Berechtigung')
 117
 118 Replace 'Keine Berechtigung' by 'Not permitted' or ...
 119
 120 An easy way to test whether it's a permissions problem, or some other mail
 121 server configuration problem is to cat an email-formatted text file
 122 directly to the roundup-mailgw script as the roundup user.::
 123
 124   cat issue.txt | /usr/local/bin/roundup-mailgw /home/roundup
 125
 126 If that doesn't raise any errors, the problem is the permissions of the
 127 MTA.
 128
 129 -----------------
 130
 131 Back to `Table of Contents`_
 132
 133 .. _`Table of Contents`: index.html
 134