GreenArrow Email Software Documentation

Adding a Relay Server

To add an (SMTP) relay server to GreenArrow Engine’s configuration, complete the following steps:

  1. Obtain authorization to relay messages from your GreenArrow Engine server to the relay server. This usually involves obtaining a username and password (SMTP AUTH), or authorizing one of GreenArrow Engine’s IP addresses as a relay client. The SMTP AUTH and POP3 Email Users page describes how to create a new SMTP AUTH account on a GreenArrow Engine installation.
  2. Log into the GreenArrow Engine Web Interface.
  3. Navigate to Configure => Virtual MTAs:
    configure-virtual-mtas.png
  4. Click the Add Relay Server button:
    add-relay-server-button.png
  5. In the New Relay Server form, complete the following fields, then click Submit:
    1. Name - The name, or MTAid that you wish to assign this new VirtualMTA.
      1. Must contain only ASCII characters in the range 0x20-0x7e; excluding comma, pound, and at-sign.
      2. Must not have leading nor trailing whitespace.
      3. Must be unique (case-insensitive) across all types of VirtualMTAs (IP Addresses, Relay Servers, and Routing Rules).
      4. Must not also be an integer.
      5. Must be from 1 to 200 characters in length.
    2. IP Address - the IP address to use to connect to the relay server. If you’re using NAT, the IP address to enter is the private IP address, since this is what was assigned to your Linux installation’s networking configuration.
    3. Hostname of the IP Address - the reverse DNS record for the IP address that’s being used to connect to the relay server.
    4. Relay Server - the fully qualified domain name, or IP address of the relay server to connect to. When possible, we recommend using a full qualified domain name which the relay server will retain if it’s migrated to a different IP address at a future date.
    5. Port - the TCP port to connect to. This is usually port 587 or 25.
    6. Use SMTP AUTH - check this box if a username and password is required to log into the relay server.
    7. Username - the username to log into the relay server with, if applicable. This field is hidden unless the Use SMTP AUTH box is checked.
    8. Password - the password to log into the relay server with, if applicable. This field is hidden unless the Use SMTP AUTH box is checked.
    9. Concurrent Connections - the maximum number of concurrent SMTP connections to make to the relay server.
    10. Messages per Hour - the maximum number of messages per hour to send to the relay server.
    11. Redirect mail through another VirtualMTA - unchecked, unless you’d like to redirect mail through another VirtualMTA.
      add-relay-server-form.png
  6. Send a test message using the new Relay Server VirtualMTA. This is ideally done from the application that you normally use to send messages through GreenArrow so that the testing is end-to-end. If you’d like to perform a test on the command line, the following command can be run, replacing relay with the name of the new VirtualMTA, and [email protected] with your email address:

    date | GREENARROW_MTAID=relay /var/hvmail/bin/mailsubj "New VirtualMTA Test - relay" [email protected]
    

  7. Verify that you receive the test message, and examine the messages headers to verify that the correct IP address and HELO value were used to send the message. This data can be found in one of the Received headers. For example:

    Received: from smtp1-1.example.com (1.2.3.4)
    


Copyright © 2012–2019 GreenArrow Email