These are additional details you can follow while configuring your email settings.

Remove Users from Monitoring Objects

As a site or project administrator, if one or more users are no longer project members, you can remove them from monitoring selected TeamForge objects they once subscribed for monitoring.

However, you cannot remove a user from the monitoring list if the user is monitoring applications such as trackers, documents, tasks, and so on instead of individual TeamForge objects.

By default, this feature is disabled. To enable this feature, set the USER_MONITORING_REMOVE_ENABLED token to true in the site-options.conf file.

  1. Go to the item, from which you want to remove users from monitoring.
  2. Select users to remove from monitoring list.
  3. If you want to remove one or more users from monitoring one of the items, select the item, then click Monitor > Users Monitoring Selected.

    The Users Monitoring This Item window appears.

  4. If you want to remove one or more users from monitoring more than one item, select all the items, then click Monitor > Users Monitoring This Folder.

  5. In the case of team monitoring, click Monitor > Users Monitoring This Team.
  6. In the following window, select one or more check boxes corresponding to the users you want to remove from monitoring.
  7. Click Remove. The Are you sure you want to remove the selected user(s) from monitoring? message appears.
  8. Click OK.

    The selected users are removed from monitoring the selected object. An e-mail notification is sent to all active users that are removed from monitoring selected objects.

Limit the Size of Message Attachments

To avoid overtaxing your mail server or your storage volume, you may want to set a ceiling on the size of the attachments that users can send to a forum via email.

When a user sends an attachment that is larger than the limit, the message is rejected and the user gets an email from the Site Administrator explaining that the attachment exceeded the limit.

  1. Open the site-options.conf file, the master configuration file that controls your TeamForge site.
    vi /opt/collabnet/teamforge/etc/site-options.conf
  2. Set the value of the DISCUSSION_MAX_ATTACHMENT_SIZE token.

    For example, if your users are given to using Microsoft Word documents on the site, you might set DISCUSSION_MAX_ATTACHMENT_SIZE to 10 MB, and increase the value by two or three MB at a time if users need more headroom.

  3. Review the changes, then save the site-options.conf file.

Limit the Size of Document Attachments

When many users store very large documents on your site, you may sometimes notice a slowdown in your site’s performance. You can reduce the impact of such a use pattern by telling TeamForge not to attach documents larger than a certain size.

  1. Open the site-options.conf file, the master configuration file that controls your TeamForge site.
    vi /opt/collabnet/teamforge/etc/site-options.conf
  2. Add the DOCUMENT_MAX_FILE_UPLOAD_SIZE parameter and give it a value equal to the maximum size (in megabytes) of documents to be uploaded.
  3. Review the changes, then save the site-options.conf file.

Relay Emails Through SMTP Gateway with Authentication

You can set up TeamForge to relay emails through an SMTP gateway (such as Amazon AES) that uses authentication. By default, James sends emails directly. However, you may prefer relaying emails through an enterprise relay server. Configuring the JAMES_GATEWAY_* tokens let you do that.

To relay emails through an SMTP gateway:

  1. Set the following site-options.conf tokens.
    vi /opt/collabnet/teamforge/etc/site-options.conf
  2. Save the site-options.conf file.
  3. Provision services.
    teamforge provision

DomainKeys Identified Mail (DKIM)

A DKIM signature is being added to the headers of all outgoing TeamForge emails to authenticate all outbound emails against email spoofing.

DKIM is enabled by default. Once enabled, the DKIM signature is included in all the outgoing TeamForge emails. However, you can disable DKIM using the JAMES_DKIM_VERIFICATION token. In general, you must set up the following four newly added tokens on your TeamForge site (site-options.conf).


For more information, see TeamForge site-options.conf Tokens.

A TeamForge notification email with DKIM signature in its header