Configuration Wizard on Linux

Installing Axigen

This section describes basic server configurations that you need to do in order to get your server up and running on Linux: setting the admin password, enabling the Web configuration interface, creating a domain and adding accounts. Some of these actions can also be performed automatically using the Axigen Configuration Wizard, also described in this section.

Aiming to enhance, simplify, and render the initial setup automatic, Axigen includes a Configuration Wizard. In a few easy steps, the wizard enables you to instantly set the admin password, configure the primary domain, and set up an interface for the WebAdmin management tool and also for the POP3 and IMAP services. These actions were previously performed partly manually, partly using the WebAdmin interface.

The Axigen Configuration Wizard is provided as part of all Axigen installation packages, available for download on the Axigen website.

Firstly, the wizard needs to be launched by issuing the following command:

 

 

 

  • Configuring the admin password

  1. After launching the Axigen Configuration Wizard, the first step you are prompted to take is to specify the admin password. The password is required and therefore you must type at least one character.

    Use the "Password" field to type your password and the "Validate" field to retype it for validation. 

    To move from one field to another, please use the "Tab" or "Enter" keys. To proceed to the next step, when located on the "Next" button, press the "Enter" key.

     
  2. Configuring your primary domain

    The next stage of running the wizard consists in configuring Axigen’s primary domain. The wizard will automatically detect the machine’s FQDN (Fully Qualified Domain Name) and based on it will propose the domain name as primary. If no domain can be detected, the default "localdomain" will be displayed. You can edit the fields of this tab at any time.

    In the "Primary Domain" field, the wizard will display the automatically detected domain. Use the Domain Location field to edit the default storage path for the primary domain, "/var/opt/axigen/domains". To configure the primary domain password for the account postmaster, use the "Postmaster account password" field. 

    To move from one field to another, please use the "Tab" or "Enter" keys. To proceed to the next step, when located on the "Next" button, press the "Enter" key.

  3. Alias configuration

    When running the wizard, this steps allows you to select the alias you would like to configure for the primary domain defined at the previous step. There are three available options: 

     

    • Redirect all mails for root account to postmaster

    • Add the "localhost" alias to this domain

    • Add the "localhost.localdomain" alias to this domain

  4. Configuring the WebAdmin interface

    This following step performed by the Axigen Configuration Wizard is to select the WebAdmin Interface. The wizard will list all the existing interfaces with their respective IP addresses and ports, enabling you to select a listener for WebAdmin. In the previous versions, the WebAdmin was initially accessed on its default listener: http://127.0.0.1:9000/

     

    Select one of the listed interfaces, then move to the "OK" button (using the "Tab" or "Enter" keys) and then press "Enter" again. If you choose the first option ("all"), all the listed interfaces will be used as listeners for the WebAdmin management tool. If you choose a different interface, you will be prompted to confirm the choice you have made.

  5. Configuring the SMTP interface

    The next step performed by the Axigen Configuration Wizard is to select the SMTP Interface. The wizard will list all the existing interfaces with their respective IP addresses and ports, enabling you to select a listener for SMTP.

    Select one of the listed interfaces, then move to the "OK" button (using the "Tab" or "Enter" keys) and then press "Enter" again. If you choose the first option ("all"), all the listed interfaces will be used as listeners for the SMTP service. If you choose a different interface, you will be prompted to confirm the choice you have made.

  6. Services selection

    The sixth step of the automatic configuration process allows you to select the active services for the Axigen server. For each of the selected services, POP3, IMAP or WebMail, further settings are available within the following steps. If none of the three services is enabled, the wizard will skip directly to step 10 of the configuration.

    To select or deselect one of the listed options, press "Enter".

     
  7. Configuring the POP3 interface

    The next step performed by the Axigen Configuration Wizard is to select the POP3 Interface. The wizard will list all the existing interfaces with their respective IP addresses and ports, enabling you to select a listener for the POP3 service.

    Select one of the listed interfaces, then move to the "OK" button (using the "Tab" or "Enter" keys) and then press "Enter" again. If you choose the first option ("all") all the listed interfaces will be used as listeners for the POP3 service. If you choose a different interface, you will be prompted to confirm the choice you have made.

     
  8. Configuring the IMAP interface

    Step 8 performed by the Axigen Configuration Wizard is to select the IMAP Interface. The wizard will list all the existing interfaces with their respective IP addresses and ports, enabling you to select a listener for the POP3 service.

    Select one of the listed interfaces, then move to the "OK" button (using the "Tab" or "Enter" keys) and then press "Enter" again. If you choose the first option ("all"), all the listed interfaces will be used as listeners for the POP3 service. If you choose a different interface, you will be prompted to confirm the choice you have made.

     
  9. Configuring the WebMail interface

    For the next step, the Axigen Configuration Wizard will allow you to select the WebMail Interface. The wizard will list all the existing interfaces with their respective IP addresses and ports, enabling you to select a listener for the WebMail service.

    Select one of the listed interfaces, then move to the "OK" button (using the "Tab" or "Enter" keys) and then press "Enter" again. If you choose the first option ("all"), all the listed interfaces will be used as listeners for the WebMail service. If you choose a different interface, you will be prompted to confirm the choice you have made.

     
  10. Configuring relay policies

    The Axigen Configuration Wizard will then prompt you to select the networks allowed to relay emails through the Axigen server without prior authentication. To select or deselect one of the listed options press "Enter".

    When one of the available networks is selected, a script configuring a relay policy is automatically created. For details on relay polices, please see the corresponding section of the online documentation.

     
  11. Sendmail Wrapper configuration

    This configuration steps is required if you want command line applications such as mailix to be able to send emails via Axigen. Such applications use the Sendmail Wrapper which needs to be configured to work correctly with Axigen.

     

    The Wizard describes in detail the actions taken when selecting "Yes" at this step.

    The Wizard will initially display a message prompting you to wait for the changes to be applied to your existing configuration and will then respond with a successful operation message.

    After completing these steps, the wizard will display a message summarizing the steps just taken. It will also instruct you to start the Axigen service and then access the WebAdmin interface on the selected IP-port combination.

     

On some distributions, the operating system sets the console display encoding to UTF-8. Thus all the wizard’s messages would be displayed incorrectly. For troubleshooting, please consult this knowledge base article: http://www.axigen.com/kb/show/51