How to Set the Greeting Banners for the Axigen Services

This articles details on how to set specific banners for the SMTP/IMAP/POP3/IMAP Proxy/POP3 Proxy services.

Solution

In Axigen 6.2 new options for the IMAP, POP3, IMAP Proxy and POP3 Proxy services have been added, that allow administrators to set custom banners.

The greeting message for POP3, POP3-Proxy, IMAP and IMAP-Proxy services can now be configured from the WebAdmin & CLI interfaces.

Via Webadmin these settings are available in:

for IMAP go to: - Services tab -> IMAP -> Service Configuration section ->
IMAP Options -> Greeting. The default setting is: "Axigen-%V IMAP4rev1 service is ready".

for POP3 go to: - Services tab -> POP3 -> Service Configuration section ->
POP3 Options -> Greeting. The default setting is: "POP3 server on %D ready %U".

for IMAP Proxy go to: - Clustering tab -> IMAP Proxy ->
Service Configuration section -> IMAP Proxy Options -> Greeting. The default setting is: "Axigen-%V IMAP4rev1 service is ready".

for POP3 Proxy go to: - Clustering tab -> POP3 Proxy -> Service Configuration section -> POP3 Proxy Options -> Greeting. The default setting is: "POP3 server on %D ready %U".

for SMTP go to: - Security & Filtering -> Acceptance & Routing -> Acceptance Basic Settings tab -> Override default SMTP banner

Via CLI, use the following commands for each service:

1) Connect to the CLI using telnet <IP> <port> and the credentials for the Axigen "admin" account. Default values for the CLI listener are Ip: 127.0.0.1 and port: 7000.

telnet 127.0.0.1 7000
<login> user admin
<password> pa$$w0rd
For a list of available commands, type HELP
+OK: Authentication successful
<#>                 
                        

2) Enter the "Server" context using the command: CONFIG SERVER:

<#> config server
+OK: command successful
<server#>


3) Enter the corresponding configuration context for each service using the command: CONFIG <Required_Service>, where the Required_Service parameter can be replaced with IMAP, POP3, IMAP Proxy, POP3 Proxy. In example below we will continue to configure the IMAP banner.

<server-imap#> SET greetingsText Axigen-%V IMAP4rev1 service is ready on %D
+OK: command successful
<server-imap#> commit
committing changes and switching back to previous context.
+OK: command successful
<server#> commit
committing changes and switching back to previous context.
+OK: command successful
<#> save config
+OK: command successful

NOTE: When you enter the new greeting text, you must use the "" character to escape the spaces between the words. This is required so that the CLI can properly interpret the command.

When defining the greeting string, the administrator may use the following placeholders:

  • %H = network hostname of the server machine
  • %D = network hostname.domainname of the server machine (FQDN)
  • %A = listener IP
  • %P = listener port
  • %U = APOP ID in following format number.number@hostname.domain
  • %V = Axigen version
  • %% = %

    Placeholders are case sensitive; letters must be uppercase.

    Any printable ascii characters 0-127 are accepted in the greeting string with the following exceptions:

    • <CR>
    • <LF>

    The maximum configurable size for the greeting is 1023 characters.

    OS: LinuxWindowsFreeBSDNetBSDOpenBSDSolaris
    Distros: WindowsDEB based distros amd64FreeBSD 7.x