E-Democracy Pages Wiki

Search Wiki

 

Tools

 

Difference between revisions of "Configuring Group Server"

From E-Democracy.org

(Added page on configuring Group Server)
 
(Trying to move into a subcategory)
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
 +
=gsconfig.ini Overview=
 +
 
The [https://source.iopen.net/groupserver/gs.config/summary gs.config package], along with the file etc/gsconfig.ini or parts/instance/etc/gsconfig.ini, provide the mechanism for configuring the GroupServer parts of GroupServer (as opposed to Zope parts.)
 
The [https://source.iopen.net/groupserver/gs.config/summary gs.config package], along with the file etc/gsconfig.ini or parts/instance/etc/gsconfig.ini, provide the mechanism for configuring the GroupServer parts of GroupServer (as opposed to Zope parts.)
  
Line 14: Line 16:
 
* webservice - See the Configuration File section of [https://source.iopen.net/groupserver/gs.group.messages.add.smtp2gs/summary#configuration-file gs.group.messages.add.smtp2gs/EGG-INFO/PKG-INFO]
 
* webservice - See the Configuration File section of [https://source.iopen.net/groupserver/gs.group.messages.add.smtp2gs/summary#configuration-file gs.group.messages.add.smtp2gs/EGG-INFO/PKG-INFO]
  
[[Category:GroupServer Development Reference]]
+
= Configuring Email for Development =
 +
 
 +
For development, it is useful to configure Group Server to use a local folder for its mailqueue and to not pass emails off to Postfix. By doing so, a developer can quickly see the complete email that the platform has generated, and doesn't have to worry about spamming actual users while developing.
 +
 
 +
To do this:
 +
 
 +
# Create the directory "mailqueue" in the root of your GroupServer installation
 +
# In the mailqueue directory, create the following directories: "new", "cur", and "old"
 +
# In gsconfig.ini, creating the following smtp section and include it in your active instance:
 +
    [smtp-dev]
 +
    queuepath=mailqueue
 +
    processorthread=False.
 +
 
 +
 
 +
Now emails that Group Server generates and attempts to pass on to Postfix will end up in mailqueue/new/.
 +
 
 +
Not that the mailqueue folder used here can be different than the maildir set is Postfix's configuration file. That’s OK, as the goal here is not to actually send the email, but to place it in a convenient location.
 +
 
 +
[[Category:Technology:GroupServer Development Reference]]

Latest revision as of 17:03, 18 February 2013

gsconfig.ini Overview

The gs.config package, along with the file etc/gsconfig.ini or parts/instance/etc/gsconfig.ini, provide the mechanism for configuring the GroupServer parts of GroupServer (as opposed to Zope parts.)

Significant documentation on the syntax of gsconfig.ini can be found locally in the egg documentation of gs.config or online.

There are four components that can be configured: database; smtp; cache; and webservice (documentation refers to ‘tokenauth’, this seems to have been replaced by ‘webservice’). Each component can have one or more specific configuration sections, loosely based on the instance or environment for which they are intended. I.e., there can be database-live; smtp-test; smtp-live; cache-dev; etc...

[config-<my_instance>] sections list which component configurations will be used for the instance represented by <my_instance>.

More specific documentation on configuration is available for some components:

Configuring Email for Development

For development, it is useful to configure Group Server to use a local folder for its mailqueue and to not pass emails off to Postfix. By doing so, a developer can quickly see the complete email that the platform has generated, and doesn't have to worry about spamming actual users while developing.

To do this:

  1. Create the directory "mailqueue" in the root of your GroupServer installation
  2. In the mailqueue directory, create the following directories: "new", "cur", and "old"
  3. In gsconfig.ini, creating the following smtp section and include it in your active instance:
   [smtp-dev]
   queuepath=mailqueue
   processorthread=False. 


Now emails that Group Server generates and attempts to pass on to Postfix will end up in mailqueue/new/.

Not that the mailqueue folder used here can be different than the maildir set is Postfix's configuration file. That’s OK, as the goal here is not to actually send the email, but to place it in a convenient location.

 

Home - Mobile - Forums - Wiki - Blog - About - Help - Contact - People - Donate - Rules - Archives