doc/FAQ.txt

   1 Roundup FAQ
   2
   3   '$Date: 2002-02-14 08:50:14 $'
   4
   5   NOTE: This is just a grabbag, most of this should go into documentation.
   6
   7 Changing HTML layout
   8
   9   Note changes to the files in html take place immediatly without
  10   restart, even when running roundup-server.
  11
  12   Displaying whole messages not only the summary
  13
  14     Modify instance/html/msg.index change::
  15
  16       <td><display call="plain('summary')"></td>
  17
  18     to::
  19
  20       <td><pre><display call="plain('content')"></pre></td>
  21
  22     displays the whole message not only the first line and 'pre'
  23     prevents the browser from reformatting.
  24
  25   Getting the nosy list picker instead of textfield.
  26
  27     In classic template there is plenty of space below the text field.
  28     So one could modify instance/html/issue.item to use it.
  29
  30     At the file top set 'border=1' to see cell boundaries, then
  31     replace::
  32
  33       <td class="form-text"><display call="field('nosy',size=20)"></td>
  34
  35     by::
  36
  37       <td rowspan=5 class="form-text"><display call="menu('nosy',height=10)"></td>
  38
  39     and remove the last cell in the next four rows, either by deleting a cell
  40     or by reducing colspan.
  41
  42   Want to see the issue id (the number) on the issue item display
  43
  44     The number is really a central information and not an internal one.
  45
  46     In file INSTANCE/html/issue.item displays the creator, so one could add
  47     the number to it.::
  48
  49       <td class="form-text"><display call="reldate('creation', pretty=1)">
  50           (<display call="plain('creator')">)</td>
  51
  52     to see::
  53
  54       <td class="form-text"><display call="reldate('creation', pretty=1)">
  55           (issue<display call="plain('id')"> by <display call="plain('creator')">)</td>
  56
  57 Installation
  58
  59   Living without a mailserver.
  60
  61     Remove the nosy reactor, means delete the file 'INSTANCE/detectors/nosyreactor.py'.
  62
  63   Rights issues (MISSING)
  64
  65     Different jobs run under different users.
  66
  67     * Standalone roundup-server is started by whome ?
  68
  69     * Running cgi under apache.
  70
  71     * roundup-mailgw called via .forward from MTA, or running a cron job
  72       fetching via pop.
  73
  74
  75 Troubleshooting
  76
  77   mailgw bouncing
  78
  79     messages are bouncing with the following error message.::
  80
  81       Command died with status 1:
  82       "/usr/local/bin/python /usr/local/bin/roundup-mailgw /home/roundup".
  83       Command output: Traceback (most recent call last):
  84         File "/usr/local/bin/roundup-mailgw", line 178, in ? sys.exit(main(sys.argv))
  85         File "/usr/local/bin/roundup-mailgw", line 153, in main db =
  86           instance.open('admin') AttributeError: '_roundup_instance_1' module
  87           has no attribute 'open'
  88
  89
  90     Happens when roundup-mailgw is called by a user that doesn't have
  91     read/execute permissions to the instance_home directory and sub
  92     directories.
  93
  94     An easy way to test whether it's a permissions problem, or some other mail
  95     server configuration problem is to cat an email-formatted text file
  96     directly to the roundup-mailgw script as the roundup user.::
  97
  98       cat issue.txt | /usr/local/bin/roundup-mailgw /home/roundup
  99
 100     If that doesn't raise any errors, the problem is the permissions of the
 101     MTA.
 102