1 Roundup FAQ
3 '$Date: 2002-02-14 08:50:14 $'
5 NOTE: This is just a grabbag, most of this should go into documentation.
7 Changing HTML layout
9 Note changes to the files in html take place immediatly without
10 restart, even when running roundup-server.
12 Displaying whole messages not only the summary
14 Modify instance/html/msg.index change::
16 <td><display call="plain('summary')"></td>
18 to::
20 <td><pre><display call="plain('content')"></pre></td>
22 displays the whole message not only the first line and 'pre'
23 prevents the browser from reformatting.
25 Getting the nosy list picker instead of textfield.
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.
30 At the file top set 'border=1' to see cell boundaries, then
31 replace::
33 <td class="form-text"><display call="field('nosy',size=20)"></td>
35 by::
37 <td rowspan=5 class="form-text"><display call="menu('nosy',height=10)"></td>
39 and remove the last cell in the next four rows, either by deleting a cell
40 or by reducing colspan.
42 Want to see the issue id (the number) on the issue item display
44 The number is really a central information and not an internal one.
46 In file INSTANCE/html/issue.item displays the creator, so one could add
47 the number to it.::
49 <td class="form-text"><display call="reldate('creation', pretty=1)">
50 (<display call="plain('creator')">)</td>
52 to see::
54 <td class="form-text"><display call="reldate('creation', pretty=1)">
55 (issue<display call="plain('id')"> by <display call="plain('creator')">)</td>
57 Installation
59 Living without a mailserver.
61 Remove the nosy reactor, means delete the file 'INSTANCE/detectors/nosyreactor.py'.
63 Rights issues (MISSING)
65 Different jobs run under different users.
67 * Standalone roundup-server is started by whome ?
69 * Running cgi under apache.
71 * roundup-mailgw called via .forward from MTA, or running a cron job
72 fetching via pop.
75 Troubleshooting
77 mailgw bouncing
79 messages are bouncing with the following error message.::
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'
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.
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.::
98 cat issue.txt | /usr/local/bin/roundup-mailgw /home/roundup
100 If that doesn't raise any errors, the problem is the permissions of the
101 MTA.