4.2.1   GroupServer Site

You will need to change all the configuration for your initial site — except for the port, which will probably stay the same as the default.

host

The domain name used by your new GroupServer instance. It must be the same as what you picked a host name earlier (see Pick a Host Name).

port

The port that your new GroupServer instance will run on. By default it is 8080, which is the same as the zope_port. To run on any other port you will need to set up a web proxy.

admin_email

When GroupServer is installed, an example site and group are created. So you can use the administration functions you must log in as an administrator. This is the email address of that administrator. Posts to the example group will be sent to the administrator at this address. In addition, this email address will be used to log into the new site.

admin_password

The password of the administrator of the new GroupServer site. The password will be used to log in, and can be changed after the site has been created.

user_email

The email address of the normal user that is created along with the new GroupServer site. The normal user is a member of the same group as the administrator, but the user has no permission to alter the site. Posts to the example group will be sent to the user at this address. In addition, this email address will be used to log in to the new site. The email address for the normal user must be different to the email address for the administrator.

user_password

The password for the normal user of the new GroupServer site. The password will be used to log in, and can be changed after the site has been created.

support_email

The email address where support messages are sent, and were email notifications are send from. For testing this can be set to your own email address.

smtp_host

The SMTP host that will be used to send notifications from GroupServer. It defaults to localhost, assuming you will be running a local SMTP server.

4.2.2   Zope

Your site will run on the Zope system. This system must also be configured. The default values for zope_host and zope_port are probably correct. However, for security we recommend you change the name and password of the Zope administrator.

zope_host

The host that will run Zope. It defaults to the local machine.

zope_port

The IP port that Zope will listen to. It defaults to 8080. Zope will have to run as root to use port 80, and this is discouraged.

zope_admin

The name of the user who will administer Zope.

zope_password

The password for the Zope administrator. It can (and should) be changed after GroupServer has been set up. (However, if you change the password after installation you will also have to change the scripts that Postfix uses to communicate with GroupServer, as they store the password too, see Set up Scripts; we realise that the passwords should not be stored in the scripts.)

4.2.3   Database Storage

GroupServer stores most of its data in PostgreSQL. Two passwords need to be set by you to protect this data.

pgsql_password

The password required to attach to the PostgreSQL database. The install system will create a PostgreSQL database, and protect it with this pgsql_password.

relstorage_password

The RelStorage system will store data in a PostgreSQL database for Zope. This data is protected by the relstorage_password.

4.4.1   Running Zope as a Daemon

It may be more convenient to run Zope in the background, as a daemon. To run Zope as a daemon run the following command:

$ ./bin/instance start

To stop the daemon run:

$ ./bin/instance start

5.1.1   Copy the Configuration Files

• Copy the files postfix_config/groupserver.* from the GroupServer installation directory to the Postfix configuration directory /etc/postfix.

• Change the ownership of the files to the Postfix user and group. For Ubuntu this would be:

  # chown nobody.nogroup /etc/postfix/groupserver.*
  

  If you are on a system other than Ubuntu, running the following will display the user-name of the Postfix user:

  $ /usr/sbin/postconf | grep default_privs | cut -f3 -d" "
  

• Modify the host

5.1.2   Change main.cf

• Edit /etc/postfix/main.cf.

• Find the alias_maps parameter.

• Add the following on a line below the existing value of alias_maps:

  hash:/etc/postfix/groupserver.aliases
  

• Find the virtual_alias_maps parameter.

• Add the following on a line below the existing value of virtual_alias_maps

  hash:/etc/postfix/groupserver.virtual
  

• Find the mydestination parameter.

• If the hostname specified as virtual in the /etc/postfix/groupserver.virtual is listed as a destination, it will need to be removed from mydestination as it cannot be specified in both places.

• Add the following to the bottom, unless it is previously defined:

  smtpd_authorized_verp_clients = 127.0.0.1
  

5.1.3   Update Postfix

To load the new configuration into Postfix run the following commands:

# postalias /etc/postfix/groupserver.aliases
# postmap /etc/postfix/groupserver.virtual
# postfix reload