The general server configuration file currently used by AXIGEN Mail Server is located by default in /var/opt/axigen/run/axigen.cfg (Linux/Solaris) or /var/axigen/run/axigen.cfg (*BSD). A sample configuration file can also be found in the /opt/axigen/share/examples directory.

The axigen.cfg file includes the complete specifications for AXIGEN configuration. Besides containing configuration data specific for AXIGEN modules, axigen.cfg is also used for specifying the primary domain for AXIGEN server (primaryDomain).

Using axigen.cfg, you have access to all AXIGEN Mail Server configuration parameters. Using a text editor, you can manually edit the parameter values and modify the server configuration. The configuration file also contains information on default and possible values and a short explanation for each parameter:

The same options are available when using WebAdmin, except that changes to the configuration are made through the Web GUI. Detailed information on how to configure each parameter and information on its functions are given in the Configuring AXIGEN using WebAdmin subsections.

Restrictions

When working with axigen.cfg file, you need to follow the restrictions listed below:

• maximum attribute name length: 64
• maximum attribute value length: 128 (expressed as string in configuration file). Each STRING value is limited to this length, 255
  

Note: Each time you modify the main configuration file, a reload signal must be sent to AXIGEN, in order to load the new configuration settings.

Definitions

When working with axigen.cfg file, the following terms should be used with the meanings specified below:

• UINT: an unsigned integer.
• STRING: a case insensitive string, possibly quoted using double quotes.
• CS_STRING: a case sensitive string, possibly quoted using double quotes.
• IP: an IPv4 address in decimal numbers-and-dots format, i.e.: 127.0.0.1
• IP_SET: a set for IPv4 addresses specified in one of the following modes:

1. IP interval 10.0.0.1-10.0.0.20
2. IP address/IP mask 10.0.0.1/255.0.0.0
3. IP address/IP mask size 10.0.0.1/8

• IP_PORT: an IPv4 address in decimal numbers-and-dots format followed by a ":" char and a decimal port number, i.e.: 127.0.0.1:25
• CHOICE: a single STRING from a specified set of STRINGs, i.e.: "yes" from ("yes" "no") set
• CHOICE-SET: a subset of STRINGs from the specified set of STRINGs; the subset must be specified between round parentheses ()

Structure of the axigen.cfg file

In axigen.cfg, all objects and attributes are commented using a hash character (#) Also, any block inside /* ... */ is treated as comment. Default values, restrictions and examples for each attribute as provided as comments.

The file is structured based on main configuration objects (server, main services).
The attributes corresponding to one object are enclosed in curly brackets {}.
The values of an attribute are enclosed in parentheses ().
When several objects are grouped in a object set, they are also enclosed in parentheses ().
Levels of subordination are indicated by indentation (upper levels will be left-aligned).

For instance, this is how the beginning of the section for the SMTP-In service looks in the text file. All you have to do is manually edit the values of the parameters, as instructed in the # lines.

# SMTP service
# TYPE: SMTP-OUTGOING-SERVICE OBJECT
smtpOutgoing = {

    # maximum number of threads handling remote SMTP delivery
    # TYPE: UINT
    # MIN-MAX: 1-128
    # DEFAULT: 20
    maxConnThreads = 20

    # minimum number of threads handling remote SMTP delivery
    # TYPE: UINT
    # MIN-MAX: 1-128
    # DEFAULT: 2
    minConnThreads = 2

    # service's logging level
    # TYPE: UINT
    # MIN-MAX: 0-31
    # DEFAULT: 15
    logLevel = 15

    # service's logging type
    # TYPE: CHOICE internal | system | remote
    # DEFAULT: internal
    logType = internal

    # service's remote logging host (used only if logType=remote)
    # TYPE: IP_PORT
    # VALIDITY: only host IP addresses
    # DEFAULT: 127.0.0.1:2000
    logHost = 127.0.0.1:2000

    # list of rules to be applied by the relay module when connecting to a relay         server
    # There is always defined a 'catch all' client rule with the following attributes:
    # priority = 1001
    # patternIn = "*"
    # patternOut = "*"
    # authUser = ""
    # authPass = ""
    # maxConnections = 5
    # smtpPort = 25
    # smtpIp = 0.0.0.0 (use client MX)
    # requestAuth = no
    # allowStartTLS = yes
    # secureConnAuthTypes = ( all )
    # plainConnAuthTypes = ( all )
        clients = (
        {
            # priority for this rule, 1 is highest
            # TYPE: REQUIRED UINT
            # MIN-MAX: 1-1000 (1001 is reserved for catch all clients)
            # DEFAULT: N/A
            priority = 500