Axigen Reference Manual · AXIGEN® Mail Server User Manual Product version 3.0 Last update on:...

AXIGEN® Mail Server User Manual

Product version 3.0

Last update on: 4/13/2007 3:31:44 PM Document version: 1.0

AXIGEN User Manual

Copyright © 2007 GECAD Technologies S.R.L.

2

Copyright & trademark notices This edition applies to version 3.0 of the licensed program AXIGEN and to all subsequent releases and modifications until otherwise indicated in new editions.

Notices References in this publication to GECAD TECHNOLOGIES S.R.L. products, programs, or services do not imply that GECAD TECHNOLOGIES S.R.L. intends to make these available in all countries in which GECAD TECHNOLOGIES S.R.L. operates. Evaluation and verification of operation in conjunction with other products, except those expressly designated by GECAD TECHNOLOGIES S.R.L., are the user's responsibility. GECAD TECHNOLOGIES S.R.L. may have patents or pending patent applications covering subject matter in this document. Supplying this document does not give you any license to these patents. You can send license inquiries, in writing, to the GECAD TECHNOLOGIES S.R.L. marketing department, [email protected] .

Copyright Acknowledgement (c) GECAD TECHNOLOGIES S.R.L. 2007. All rights reserved.

All rights reserved. This document is copyrighted and all rights are reserved by GECAD TECHNOLOGIES S.R.L. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording, or by any information storage and retrieval system without the permission in writing from GECAD TECHNOLOGIES S.R.L.

The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. GECAD TECHNOLOGIES S.R.L. will not be responsible for any loss, costs or damages incurred due to the use of this documentation.

AXIGENTM Mail Server is a SOFTWARE PRODUCT of GECAD TECHNOLOGIES S.R.L. GECAD TECHNOLOGIES and AXIGENTM are trademarks of GECAD TECHNOLOGIES S.R.L. Other company, product or service names may be trademarks or service marks of others.

GECAD TECHNOLOGIES S.R.L. 10A Dimitrie Pompei Blvd., Connect Business Center, 2nd fl., Bucharest 2, ROMANIA;

phone: +40-21-303-2080; fax: +40-21-303-2081; e-mail: Sales: [email protected]

Technical support: [email protected]: http://www.axigen.com

(c) Copyright GECAD TECHNOLOGIES S.R.L. 2007. All rights reserved.

http://www.axigen.com

mailto:[email protected]:[email protected]:[email protected]://www.axigen.com/

AXIGEN User Manual


3

Table of Contents Introduction.......................................................................................................................................................................9

Purpose of this Document ..................................................................................................................................................9 Structure of this document ..................................................................................................................................................9 Audience and knowledge requirements ..................................................................................................................................9 Related documentation....................................................................................................................................................10

Chapter 1. Mail Server Overview ...........................................................................................................................................11 OS Compatibility............................................................................................................................................................11 Integrated Messaging Solution ...........................................................................................................................................11 High Configurability ........................................................................................................................................................11 Innovative Storage .........................................................................................................................................................11 Advanced Security Tools..................................................................................................................................................11 Automation Options ........................................................................................................................................................12 Clustering Support .........................................................................................................................................................12

Chapter 2. Getting Started with AXIGEN..................................................................................................................................13 2.1. Software and Hardware requirements.............................................................................................................................13 Software requirements ....................................................................................................................................................13 Hardware requirements ...................................................................................................................................................13 Supported platforms .......................................................................................................................................................13 Tested platforms............................................................................................................................................................15 2.2. Installing on Linux.....................................................................................................................................................15 General installation steps .................................................................................................................................................15

Files Provided for Installation ..........................................................................................................................................16 2.2.1. Installing under RHEL, Fedora Core, Mandrake and SuSE (gcc3) ......................................................................................18 2.2.2. Installing under Fedora Core, Mandriva and SuSE (gcc4) ................................................................................................18 2.2.3. Installing under Debian/Ubuntu................................................................................................................................19 2.2.4. Installing under Gentoo .........................................................................................................................................20 2.2.5. Installing under Slackware .....................................................................................................................................20

2.3. Installing on BSD......................................................................................................................................................21 2.3.1. Installing on FreeBSD ...........................................................................................................................................21 2.3.2. Installing on NetBSD ............................................................................................................................................21 2.3.3. Installing on OpenBSD..........................................................................................................................................22

2.4. Installing on Solaris ...................................................................................................................................................22 2.5. Uninstalling under Linux .............................................................................................................................................23

2.5.1. Uninstalling under RHEL, Fedora Core, Mandriva /Mandrake and SuSE (gcc3, gcc4) ..............................................................23 2.5.2. Uninstalling under Debian / Ubuntu...........................................................................................................................23 2.5.3. Uninstalling under Gentoo......................................................................................................................................24 2.5.4. Uninstalling under Slackware ..................................................................................................................................24

2.6. Uninstalling under BSD ..............................................................................................................................................25 2.6.1. Uninstalling under FreeBSD ...................................................................................................................................25 2.6.2. Uninstalling under NetBSD.....................................................................................................................................25 2.6.3. Uninstalling under OpenBSD ..................................................................................................................................26

2.7. Uninstalling under Solaris ...........................................................................................................................................26 2.9. Starting / Stopping / Restarting the server ........................................................................................................................27 2.10. Initial Server Configuration.........................................................................................................................................28

2.10.1. Setting the Admin Password .................................................................................................................................28 2.10.2. Enabling and Logging on to the Webadmin Interface ....................................................................................................28 2.10.3. Creating a New Domain .......................................................................................................................................30 2.10.4. Adding an Account to an Existing Domain .................................................................................................................31 2.10.5. Automated Configuration with AXIGEN Configuration Wizard ..........................................................................................32

Chapter 3. Mail Server Architecture........................................................................................................................................40 Services and Modules .....................................................................................................................................................40 Architecture Features......................................................................................................................................................40 Administration Tools .......................................................................................................................................................40 Security ......................................................................................................................................................................40 3.1. Generic Server Configuration .......................................................................................................................................41

3.1.1. Running Services ................................................................................................................................................41 3.1.2. Other Generic Server Parameters ............................................................................................................................41

Primary domain .............................................................................................................................................................41 SSL Random File...........................................................................................................................................................42

3.1.3. DNR Settings .....................................................................................................................................................42 Domain Name Resolver ...................................................................................................................................................42 DNR Attributes..............................................................................................................................................................42 3.2. Services and Modules................................................................................................................................................43

3.2.1. SMTP Incoming ..................................................................................................................................................43 Connection Error Control..................................................................................................................................................44 Connection Thread Control ...............................................................................................................................................44 Log Control ..................................................................................................................................................................44 Authentication...............................................................................................................................................................45 Listener Control.............................................................................................................................................................45

3.2.2. Processing ........................................................................................................................................................46 Local Mail Delivery .........................................................................................................................................................46


AXIGEN User Manual


4

Interactions with Other Modules .........................................................................................................................................46 AXIGEN Queue.............................................................................................................................................................46 Message statuses ..........................................................................................................................................................47 Mail Scheduling.............................................................................................................................................................47 Log Control ..................................................................................................................................................................47

3.2.3. SMTP Outgoing ..................................................................................................................................................49 Routing Policies ............................................................................................................................................................49 Connection Thread Control ...............................................................................................................................................49 Log Control ..................................................................................................................................................................50

3.2.4. POP3 ..............................................................................................................................................................51 Connection Error Control..................................................................................................................................................51 Connection Thread Control ...............................................................................................................................................52 Log Control ..................................................................................................................................................................52 Listener Control.............................................................................................................................................................53 Compatibility with various POP3 Mail Clients..........................................................................................................................53

3.2.5. IMAP ...............................................................................................................................................................54 Authentication...............................................................................................................................................................54 Public folders................................................................................................................................................................55 Internationalized Search ..................................................................................................................................................55 Connection Error Control..................................................................................................................................................55 Connection Thread Control ...............................................................................................................................................55 Log Control ..................................................................................................................................................................56 Listener Control.............................................................................................................................................................56 Compatibility with various IMAP Mail Clients ..........................................................................................................................56

3.2.6. Logging ............................................................................................................................................................57 Log Service Overview .....................................................................................................................................................57 Log types ....................................................................................................................................................................57 AXIGEN Log levels.........................................................................................................................................................58 Logging format..............................................................................................................................................................58 Rules .........................................................................................................................................................................59 Attributes of the Log service ..............................................................................................................................................59

3.2.7. Reporting ..........................................................................................................................................................60 Description of the reporting service .....................................................................................................................................60 Graphics .....................................................................................................................................................................60 Usage ........................................................................................................................................................................61

3.2.8. WebMail ...........................................................................................................................................................62 ...............................................................................................................................................62 A IGEN WebMail FeaturesX

• Complex customization ...........................................................................................................................................62 • Easy to use, secure and user-friendly ..........................................................................................................................62 • Server Side Scripting Language.................................................................................................................................62 • Listeners.............................................................................................................................................................63 • Personal Address Book ...........................................................................................................................................63 • Public Address Book ..............................................................................................................................................63 • Automatically set filters and replies .............................................................................................................................63 • Login Domain Selection...........................................................................................................................................63 • Internationalized search and multiple languages support ...................................................................................................63 • Public folders .......................................................................................................................................................63 • Compose while attach.............................................................................................................................................63 • URL redirect rules and virtual host support ....................................................................................................................64 • HTML mail filtering levels .........................................................................................................................................64 • Connection Thread Control.......................................................................................................................................64 • Log Control..........................................................................................................................................................64 • Webmail Connection and Session Control.....................................................................................................................65 • HTTP Limits for Webmail .........................................................................................................................................65

3.2.9. Storage ............................................................................................................................................................66 Filling the Containers ......................................................................................................................................................66 Space saving filling procedure ...........................................................................................................................................67

3.2.10. FTP Backup Service ...........................................................................................................................................68 Connection Error Control..................................................................................................................................................68 Connection Thread Control ...............................................................................................................................................69 Log Control ..................................................................................................................................................................69 Listener Control.............................................................................................................................................................69

3.2.11. RPOP Service ..................................................................................................................................................70 Connection Thread Control ...............................................................................................................................................70 Log Control ..................................................................................................................................................................70 3.3. Connectivity and Threading .........................................................................................................................................71

3.3.1. Listeners...........................................................................................................................................................71 3.3.2. Rules...............................................................................................................................................................72

Allow/Deny Rules...........................................................................................................................................................72 Rule Enforcement Policy ..................................................................................................................................................72

3.3.3. Threads............................................................................................................................................................73 3.4. Clustering Support ....................................................................................................................................................75

3.4.1. LDAP Routing ....................................................................................................................................................75 1. Configuring OpenLDAP for AXIGEN ..............................................................................................................................75 2. Configuring LDAP Connectors in AXIGEN .......................................................................................................................76


AXIGEN User Manual


5

3.4.1.1. Configuring Mapping Parameters ........................................................................................................................76 3.4.1.2. POP3 Proxy Service .......................................................................................................................................78

Connection Error Control..................................................................................................................................................78 Connection Thread Control ...............................................................................................................................................78 Log Control ..................................................................................................................................................................79 Listener Control.............................................................................................................................................................79

3.4.1.3. IMAP Proxy Service ........................................................................................................................................79 Connection Error Control..................................................................................................................................................79 Connection Thread Control ...............................................................................................................................................80 Log Control ..................................................................................................................................................................80 Listener Control.............................................................................................................................................................80

3.4.2. LDAP Authentication ............................................................................................................................................81 4. Mail Server Security .......................................................................................................................................................82

4.1. Authentication and Encryption ......................................................................................................................................84 Secure/Plain Connections and Authentication Methods .............................................................................................................84 SSL parameters ............................................................................................................................................................85 4.2. SPF and DomainKeys................................................................................................................................................86

4.2.1. AXIGEN Signing Module Usage and Configuration ........................................................................................................86 Command line parameters................................................................................................................................................87 DomainKeys Verifier configuration ......................................................................................................................................87 DomainKeys Signer configuration .......................................................................................................................................88 Starting/Stopping/Restarting the Domain Keys Daemons ...........................................................................................................88 4.3. Mail Filtering ...........................................................................................................................................................90 Filter Types ..................................................................................................................................................................90 Active Filters ................................................................................................................................................................91 Filtering Levels..............................................................................................................................................................91

4.3.1. Message Acceptance Policies .................................................................................................................................93 4.3.2. Routing Policies ..................................................................................................................................................94 4.3.3. Antivirus / Antispam Filters .....................................................................................................................................95 4.3.4. Message Rules...................................................................................................................................................97

4.3.4.1. SIEVE Overview and Implementation in AXIGEN .....................................................................................................98 SIEVE Overview ............................................................................................................................................................98 The AXIGEN SIEVE interpreter ..........................................................................................................................................98

Action interaction ........................................................................................................................................................99 Vacation interaction .....................................................................................................................................................99 Spamtest and Virustest Extension .................................................................................................................................. 100 Vacation Extension.................................................................................................................................................... 100 4.3.5. The AXIGEN Filtering Module ............................................................................................................................... 102

4.3.5.1. Filtering Module Implementation in AXIGEN ......................................................................................................... 102 4.3.5.2. Configuring the AXIGEN Filtering Module ............................................................................................................ 103

AXIMilter configuration .................................................................................................................................................. 103 4.3.5.3. AXIGEN Filtering Module Commands................................................................................................................. 104

Command line parameters.............................................................................................................................................. 104 Debian...................................................................................................................................................................... 105 Gentoo ..................................................................................................................................................................... 105 RPM-based distributions ................................................................................................................................................ 105 Slackware.................................................................................................................................................................. 105 Ubuntu ..................................................................................................................................................................... 105

4.3.6. Activating and Prioritising Filters and Rules ............................................................................................................... 106 Filter Priority............................................................................................................................................................... 106 Activation Inheritance.................................................................................................................................................... 106

4.3.7. Language Specifications for Policy Configuration ........................................................................................................ 107 Basic structure ............................................................................................................................................................ 107 SMTP Events ............................................................................................................................................................. 107 Methods.................................................................................................................................................................... 108 Contexts ................................................................................................................................................................... 108 Variables................................................................................................................................................................... 108 Structures.................................................................................................................................................................. 110 Conditions ................................................................................................................................................................. 110 Functions .................................................................................................................................................................. 111

4.3.7.1. SMTP Functionalities..................................................................................................................................... 111 onConnect ................................................................................................................................................................. 111 onEhlo...................................................................................................................................................................... 112 onMailFrom................................................................................................................................................................ 118 onRcptTo .................................................................................................................................................................. 123 onDataReceived.......................................................................................................................................................... 129 onRelay .................................................................................................................................................................... 132 onDeliveryFailure......................................................................................................................................................... 136 onTemporaryDeliveryFailure ........................................................................................................................................... 138

4.3.7.2. Examples of Policies ..................................................................................................................................... 141 event onRelay............................................................................................................................................................. 142

5. User and Domain Configuration ....................................................................................................................................... 144 5.1. Domains .............................................................................................................................................................. 144 5.2. User Accounts ....................................................................................................................................................... 146 5.3. Forwarders ........................................................................................................................................................... 147


AXIGEN User Manual


6

5.4. Lists ................................................................................................................................................................... 148 Administration of the Mail List .......................................................................................................................................... 148 Templates explained..................................................................................................................................................... 149 5.5. Public Folders ....................................................................................................................................................... 150 Configuring Public Folders.............................................................................................................................................. 150 Associating Folder Recipients to Public Folders .................................................................................................................... 151

6. Working with the WebMail Module in AXIGEN ...................................................................................................................... 153 6.1. Accessing the WebMail Interface................................................................................................................................. 154 Connecting to AXIGEN WebMail ...................................................................................................................................... 154 6.2. WebMail Features and Configuration............................................................................................................................ 155 WebMail Account Settings .............................................................................................................................................. 160

6.2.1. Configuring Personal Data ................................................................................................................................... 161 6.2.2. Adding Contacts in Webmail ................................................................................................................................. 162 6.2.3. WebMail Data Settings........................................................................................................................................ 164 6.2.4. Mail Filtering in WebMail...................................................................................................................................... 166

6.2.4.1. WebMail Filters Overview ............................................................................................................................... 167 Supported Headers/Operators/Values ................................................................................................................................ 168 Action Data ................................................................................................................................................................ 168 Filter Container ........................................................................................................................................................... 169 Examples .................................................................................................................................................................. 169

6.2.5. Configuring WebMail RPOP Connections ................................................................................................................. 173 6.2.6. WebMail Account Information................................................................................................................................ 175

7. Administration Tools Overview......................................................................................................................................... 176 8. Configuring AXIGEN using WebAdmin............................................................................................................................... 177

WebAdmin Overview .................................................................................................................................................... 177 WebAdmin Features ..................................................................................................................................................... 177

Connection Thread Control .......................................................................................................................................... 177 Log Control ............................................................................................................................................................. 178 WebAdmin Connection and Session Control ..................................................................................................................... 178 HTTP Limits for WebAdmin .......................................................................................................................................... 178 Secure WebAdmin Connections .................................................................................................................................... 178

Working with WebAdmin ................................................................................................................................................ 178 Updating/Committing Changes in WebAdmin .................................................................................................................... 179 Confirmation / Error Messages ...................................................................................................................................... 180 Displaying full details for a parameter / all parameters on a page ............................................................................................. 180 Resetting to default values ........................................................................................................................................... 181

8.1. Server tab ............................................................................................................................................................ 182 8.1.1. Global Settings ................................................................................................................................................. 182 8.1.2. User Maps ...................................................................................................................................................... 184 8.1.3. Filter Configuration ............................................................................................................................................ 186

8.1.3.1. Configuring Message Rules............................................................................................................................. 186 8.1.3.2. Configuring Antivirus/Antispam Filters ................................................................................................................ 187 8.1.3.3. Configuring Active Filters ................................................................................................................................ 189

8.1.4. SMTP Filters.................................................................................................................................................... 192 8.2. DNR tab .............................................................................................................................................................. 194

8.2.1. General Settings ............................................................................................................................................... 194 8.2.2. Nameservers settings ......................................................................................................................................... 196 8.2.3. DNR Log Control Parameters................................................................................................................................ 198

8.3. Processing tab....................................................................................................................................................... 199 8.3.1. Managing Mail Scheduling ................................................................................................................................... 199 8.3.2. Managing the Queue .......................................................................................................................................... 201 8.3.3. Specifying Threads for Local Delivery ...................................................................................................................... 202 8.3.4. Configuring Mailbox Related Parameters .................................................................................................................. 203 8.3.5. Configuring Log Control Parameters ....................................................................................................................... 204

8.4. SMTP-In Tab ........................................................................................................................................................ 205 8.4.1. Configuring SMTP-In Connection Error Control Parameters ........................................................................................... 205

Specifying a Maximum Number of Errors for SMTP Incoming Connections.................................................................................... 205 Specifying a max. number of authentication errors for SMTP Incoming connections ......................................................................... 205

8.4.2. Configuring SMTP-In Connection Thread Control Parameters......................................................................................... 206 8.4.3. Configuring SMTP-In Log Control Parameters............................................................................................................ 207 8.4.4. Setting Further General Parameters........................................................................................................................ 208 8.4.5. Configuring Mapping Data.................................................................................................................................... 210

8.5. SMTP-Out tab ....................................................................................................................................................... 211 8.6. POP3 tab ............................................................................................................................................................. 213

8.6.1. Configuring POP3 Connection Error Control Parameters ............................................................................................... 213 8.6.2. Configuring POP3 Connection Thread Control Parameters ............................................................................................ 214 8.6.3. Configuring POP3 Log Control Parameters ............................................................................................................... 215 8.6.4. POP3 Encryption and Authentication Parameters........................................................................................................ 216 8.6.5. Configuring POP3 User dB Connector Parameters ...................................................................................................... 218

8.7. IMAP tab.............................................................................................................................................................. 219 8.7.1. Configuring IMAP Connection Error Control Parameters ............................................................................................... 219 8.7.2. Configuring IMAP Connection Thread Control Parameters ............................................................................................. 220 8.7.3. Configuring IMAP Log Control Parameters ................................................................................................................ 221 8.7.4. Configuring IMAP Encryption and Authentication Parameters ......................................................................................... 222 8.7.5. Configuring IMAP User dB Connector Parameters....................................................................................................... 224


AXIGEN User Manual


7

8.8. WebMail tab.......................................................................................................................................................... 225 8.8.1. WebMail Connection Thread Control ....................................................................................................................... 226 8.8.2. WebMail Log Control .......................................................................................................................................... 227 8.8.3. WebMail Connection and Session Control ................................................................................................................ 228 8.8.4. HTTP Limits for WebMail ..................................................................................................................................... 229 8.8.5. Setting Further General Parameters........................................................................................................................ 231 8.8.6. URL Redirects for WebMail .................................................................................................................................. 232 8.8.7. Hostname Resolver for Webmail ............................................................................................................................ 234 8.8.8. WebMail User dB Connector Parameters.................................................................................................................. 235

8.9. WebAdmin tab....................................................................................................................................................... 236 8.9.1. WebAdmin Connection Thread Control .................................................................................................................... 236 8.9.2. WebAdmin Log Control ....................................................................................................................................... 237 8.9.3. Specifying the HSP Path ..................................................................................................................................... 238 8.9.4. WebAdmin Connection and Session Control.............................................................................................................. 239 8.9.5. HTTP Limits for WebAdmin .................................................................................................................................. 240 8.9.6. URL Redirects for WebAdmin ............................................................................................................................... 242

8.10. CLI Tab.............................................................................................................................................................. 244 8.10.1. Configuring CLI Connection Error Control Parameters ................................................................................................ 244 8.10.2. Configuring CLI Connection Thread Control Parameters.............................................................................................. 246 8.10.3. Configuring CLI Log Control Parameters................................................................................................................. 247

8.11. Log tab .............................................................................................................................................................. 248 8.11.1. General Log Service Parameters .......................................................................................................................... 248 8.11.2. Adding and Editing Log Rules.............................................................................................................................. 250 8.11.3. Log Files Page................................................................................................................................................ 253

8.12. FTP Backup Tab................................................................................................................................................... 254 8.12.1. Configuring FTP Backup Connection Error Control Parameters ..................................................................................... 254 8.12.2. Configuring FTP Backup Connection Thread Control Parameters ................................................................................... 255 8.12.3. Configuring FTP Backup Log Control Parameters...................................................................................................... 256

8.13. RPOP Tab .......................................................................................................................................................... 257 8.14. UserDb Tab ........................................................................................................................................................ 259

8.14.1. UserDb Thread Control...................................................................................................................................... 259 8.14.2. Configuring UserDb Log Control Parameters............................................................................................................ 260 8.14.3. LDAP Connectors ............................................................................................................................................ 261

8.15. POP3 Proxy Tab................................................................................................................................................... 264 8.15.1. Configuring General POP3 Proxy Parameters .......................................................................................................... 264

POP3 Proxy Connection Error Control Parameters ................................................................................................................ 264 POP3 Proxy Connection Thread Control Parameters .............................................................................................................. 265 POP3 Proxy Log Control Parameters ................................................................................................................................. 265 POP3 Proxy User dB Connector Parameters........................................................................................................................ 266 Other POP3 Proxy General Parameters.............................................................................................................................. 266

8.15.2. Configuring POP3 Proxy Mapping Data .................................................................................................................. 268 8.15.3. Configuring POP3 Proxy Connection Data Parameters ............................................................................................... 269

8.16. IMAP Proxy Tab ................................................................................................................................................... 271 8.16.1. Configuring General IMAP Proxy Parameters ........................................................................................................... 271

IMAP Proxy Connection Error Control Parameters ................................................................................................................. 271 IMAP Proxy Connection Thread Control Parameters .............................................................................................................. 272 IMAP Proxy Log Control Parameters ................................................................................................................................. 272 IMAP Proxy User dB Connector Parameters ........................................................................................................................ 273 Other IMAP Proxy General Parameters .............................................................................................................................. 273

8.16.2. Configuring IMAP Proxy Mapping Data................................................................................................................... 275 8.16.3. Configuring IMAP Proxy Connection Data Parameters ................................................................................................ 276

8.17. Domains tab........................................................................................................................................................ 278 8.17.1. General Domain Configuration............................................................................................................................. 280 8.17.2. Domain Migration Data ...................................................................................................................................... 282 8.17.3. Domain Public Folders Configuration ..................................................................................................................... 284

8.17.3.1. General Public Folders Configuration................................................................................................................ 284 8.17.3.2. Public Folder Quota Configuration ................................................................................................................... 285 8.17.3.3. Public Folder Mbox Configuration .................................................................................................................... 286

8.17.4. Domain SPE Page ........................................................................................................................................... 288 8.17.5. Domain Filter Configuration................................................................................................................................. 290 8.17.6. Domain Info Page ............................................................................................................................................ 291

8.18. Accounts tab ....................................................................................................................................................... 292 8.18.1. General Account Configuration ............................................................................................................................ 293 8.18.2. Account WebMail Data ...................................................................................................................................... 296 8.18.3. Account Quota Parameters................................................................................................................................. 300 8.18.4. Account Limits ................................................................................................................................................ 302 8.18.5. Account Mboxes Page....................................................................................................................................... 306 8.18.6. Account Filter Configuration ................................................................................................................................ 308 8.18.7. Account Info ................................................................................................................................................... 309

8.19. Lists tab ............................................................................................................................................................. 310 8.19.1. General List Configuration .................................................................................................................................. 311 8.19.2. Advanced List Settings ...................................................................................................................................... 314 8.19.3. Adding New List Users ...................................................................................................................................... 317 8.19.4. List WebMail Data............................................................................................................................................ 318 8.19.5. List Quota Parameters....................................................................................................................................... 321


AXIGEN User Manual


8

8.19.6. List Limits ...................................................................................................................................................... 323 8.19.7. Lists Mboxes .................................................................................................................................................. 327 8.19.8. List Filter Configuration...................................................................................................................................... 329 8.19.9. Lists Info ....................................................................................................................................................... 330

8.20. Forwarders Tab.................................................................................................................................................... 331 8.20.1. Forwarders General Parameters .......................................................................................................................... 332 8.20.2. Forwarders Filter Configuration ............................................................................................................................ 334 8.20.3. Forwarders Info Tab ......................................................................................................................................... 335

8.21. Folder Recipients.................................................................................................................................................. 336 8.21.1. General Folder Recipients Parameters ................................................................................................................... 338 8.21.2. Folder Recipients Filter Configuration .................................................................................................................... 339 8.21.3. Folder Recipients Info ....................................................................................................................................... 340

8.22. Queue Tab.......................................................................................................................................................... 341 8.23. Reporting tab....................................................................................................................................................... 343

8.23.1. General Reporting Parameters ............................................................................................................................ 344 8.23.2. Reporting Template Configuration......................................................................................................................... 346 8.23.3. Reporting Database Configuration ........................................................................................................................ 348 8.23.4. Reporting Graphics Configuration ......................................................................................................................... 351

8.24. Graphics Tab....................................................................................................................................................... 353 8.25. Commands tab..................................................................................................................................................... 354 8.26. Adding and Editing TCP Listeners.............................................................................................................................. 355 General Tab Parameters................................................................................................................................................ 356

Connection parameters............................................................................................................................................... 356 8.26.1. Adding and Editing TCP Listener Rules .................................................................................................................. 359 Connection parameters............................................................................................................................................... 360

Deny Rules ................................................................................................................................................................ 361 8.26.2. SSL Parameters for Listeners .............................................................................................................................. 364 8.26.3. Example of Listener Configuration ........................................................................................................................ 367

Limiting the Number of Allowed Connections for a Given Listener............................................................................................... 370 Limiting the Number of Accepted Connections for a Specific IP Address....................................................................................... 370 Limiting the Inactivity for a Given Listener............................................................................................................................ 371 8.27. Adding and Editing UDP Listeners ............................................................................................................................. 372

9. Configuring AXIGEN using CLI ........................................................................................................................................ 374 Service Description ...................................................................................................................................................... 374 9.1. Special Contexts .................................................................................................................................................... 376 Login Context ............................................................................................................................................................. 376 Initial Context.............................................................................................................................................................. 376 Reporting Context ........................................................................................................................................................ 376 Server Context ............................................................................................................................................................ 377 Commands Context ...................................................................................................................................................... 377 Commands-Server Context............................................................................................................................................. 378 Commands-Storage Context ........................................................................................................................................... 378 Migration Context......................................................................................................................................................... 378 9.2. Common commands ............................................................................................................................................... 380 9.3. Connecting to CLI................................................................................................................................................... 381 9.4. Troubleshoot the CLI Connection ................................................................................................................................ 382 9.5. Context Specific Commands ...................................................................................................................................... 383

10. Configuring AXIGEN using the Configuration File ................................................................................................................ 402 10.1. Working with axigen.cfg .......................................................................................................................................... 403 Restrictions ................................................................................................................................................................ 403 Definitions ................................................................................................................................................................. 403 Structure of the axigen.cfg file.......................................................................................................................................... 403 10.2. Contents of the account.cfg File ................................................................................................................................ 406 10.3. Contents of the domain.cfg file .................................................................................................................................. 407 Example of a Possible Domain Configuration ....................................................................................................................... 407

11. Command Line Parameters for AXIGEN ........................................................................................................................... 409 Display version............................................................................................................................................................ 409 Run in foreground ........................................................................................................................................................ 409 Crash control .............................................................................................................................................................. 409 Process ID................................................................................................................................................................. 409 Path to configuration file................................................................................................................................................. 409 Using mqview tool to view status for messages in the queue..................................................................................................... 409 POP3 Authentication..................................................................................................................................................... 410 POP3 ....................................................................................................................................................................... 411 POP3 and IMAP Specifications ........................................................................................................................................ 411 SMTP specifications ..................................................................................................................................................... 411 SMTP service extensions ............................................................................................................................................... 411 IMAP specifications ...................................................................................................................................................... 411 Implementation Recommendations ................................................................................................................................... 411 HTTP specifications: ..................................................................................................................................................... 411 DNS specifications ....................................................................................................................................................... 411 Sieve extensions implemented in AXIGEN .......................................................................................................................... 412 Generic RFCs............................................................................................................................................................. 412


AXIGEN User Manual


9

Introduction Purpose of this Document Congratulations on your decision to choose AXIGEN Mail Server as your messaging solution. This document serves as User Guide for AXIGEN Mail Server version 2.0 and subsequent versions until specified otherwise. Full information about AXIGEN product versions and licensing options can be found on the AXIGEN website.

For an overview of AXIGEN Mail Server architecture and functionalities, see Chapter 3. Mail Server Architecture.

Intended as reference guide for system administrators, this manual includes full documentation on mail server architecture, functionalities and configuration options.

Structure of this document This document is divided in 12 main Chapters as follows:

• Chapter 1 - Brief overview of main AXIGEN features (commercial and technical differentiators)

• Chapter 2 –Server startup instructions (requirements / install / uninstall / initial configuration)

• Chapters 3 through 6 – Descriptions of architecture (modules/services), security functions and user management. These chapters provide general information about the server capabilities and functionalities. They also include direct references to configuration instructions for each feature/set of parameters in Chapter 8.

• Chapter 7 – Brief overview of all existing AXIGEN configuration tools

• Chapter 8 – WebAdmin (Web configuration interface) Adminstration Guide. This chapter provides detailed configuration instructions for all functionalities mentioned in Chapters 3-5. It also maps Configuration options provided by WebAdmin to configuration parameters present in the axigen.cfg file, the AXIGEN text-editable configuration file.

• Chapters 9 through 10 – Descriptions of the alternate configuration tools: Command Line Interface, Configuration file (axigen.cfg).

• Chapter 11 – List of command line parameters allowing you to perform different basic administration tasks

Audience and knowledge requirements The intended audience for this User Manual is represented by administrators of the mail servers in companies where the version 2.0 of the product AXIGEN Mail Server is installed and evaluated.

In order to build, extract and acquire the correct information from this manual, a regular audience should have:

• A detailed knowledge of general mail server abilities and functions

• Knowledge of network protocols


http://www.axigen.com/

AXIGEN User Manual


10

Related documentation Additional information regarding AXIGEN can be found in the following sources:

• AXIGEN HSP manual - Contains detailed instructions on HSP – AXIGEN proprietary server-side scripting language information. This provides administrators with expansion capabilities for the AXIGEN Webadmin / Webmail modules.

• AXIGEN Online documentation – an online version of this user manual

• AXIGEN Quick Installation and Configuration guide – everything you need to get your server up and running

• AXIGEN Knowledgebase – articles containing specific instructions in response to Support queries and troubleshooting procedures


http://www.axigen.com/usr/files/hsp_manual_v2.1.pdfhttp://www.axigen.com/docs/20/http://www.axigen.com/usr/files/axigen_quick_install.pdfhttp://www.axigen.com/knowledgebase/

AXIGEN User Manual


11

Chapter 1. Mail Server Overview AXIGEN Mail Server is a fully self developed solution, truly innovative in several respects, particularly scalable and configurable. This messaging solution offers the entire range of mail services -SMTP, POP3, IMAP, Webmail - includes List server, Logging, Reporting and FTP Backup modules and provides various, flexible administration options (including a central Web administration interface - Web Admin).

OS Compatibility

It is currently available for several Linux distributions, FreeBSD, OpenBSD, NetBSD and Solaris, but development roadmap includes versions for Windows, Mac OS and other operating systems. AXIGEN uses MPA (Multi Platform Architecture), a proprietary cutting-edge technology that allows porting the AXIGEN server on multiple platforms while keeping the same set of features. This makes it possible to adapting the product to any demanded platform, while guaranteeing stability, and makes it easier for users to switch to a different platform, whenever their requirements change.

Integrated Messaging Solution

AXIGEN is an integrated service server, being able to successfully replace a solution based on several Open Source solutions. It is also modular, as it can run with any number of services inhibited. For instance, if you only want to run the SMTP service, AXIGEN can run with all other services inhibited by allocating all processing threads to SMTP. Thus, AXIGEN can accommodate any usage scenario - main mail server, backup server, mail relay server.

High Configurability

Built with administration needs in mind, AXIGEN provides System Administrators with unmatched configuration possibilities for each and every module and feature. For each and every AXIGEN module and feature, you can fine tune connection control, client management and make advanced settings for every domain and account you are managing. An example of advanced service configuration options in AXIGEN would be Webmail account and domain settings: mailbox quota, attachment size limit, mail size limit, session idle & activity timeout, maximum number of messages sent per hour by one account, HTML filtering level for HTML email messages, etc.

Innovative Storage

AXIGEN Mail Storage uses a proprietary technology which optimizes space and mail flow. This innovative storage architecture, doubled by a similar queue architecture, with index based access reduces I/O operations and disk access. Messages are stored in container files, a proprietary format that supports an effective space-saving filling procedure, allowing system administrator to specify the locations and number of directories/files allowed for message storage.

Advanced Security Tools

In terms of security, an extensive security tool set is implemented, which is also highly configurable. System Administrators can flexibly use the filtering rules available at server, domain and user level, by specifying what filters to use, the order of applicable filters and the actions to be taken according to the results of the scanning process. Filtering in AXIGEN includes Antivirus/Antispam, Antispoofing (SPF authentication rules) Domain Keys and custom SIEVE scripts. AXIGEN integrates at present connectors for Open source Antispam and Antivirus applications (SpamAssassin and ClamAV) but


AXIGEN User Manual


12

thanks to its script interface for external connectors, it can integrate with virtually any AS/AV application requested by users.

Automation Options

AXIGEN addresses automation requirements of System Administrators by providing them with an alternative configuration interface - CLI (Command Line Interface). Apart from providing an alternate method of performing basic configuration tasks, CLI automates repetitive tasks, which can be really time-consuming when performed manually. Automatic domain data migration is also available in Webadmin, where you can easily set migration related parameters.

Clustering Support

Starting with version 3.0., AXIGEN allows system administrators to route SMTP, POP and IMAP connections to different machines running our messaging solutions. This new feature is based the integration of AXIGEN with OpenLDAP and it makes use of the SMTP In, POP3 Proxy and IMAP Proxy services. These are some of the distinctive AXIGEN features - to read more about them, their configuration procedures, and many more facilities and configuration options provided by AXIGEN, browse through this online documentation.


AXIGEN User Manual


13

Chapter 2. Getting Started with AXIGEN This section gets you started with AXIGEN Mail Server, by outlining the software and hardware requirements your system needs to fulfill before you can install AXIGEN, the install and uninstall procedure for all available Linux distributions, BSD and Solaris platforms and initial configuration steps needed for the initial server run.

2.1. Software and Hardware requirements

Software requirements

AXIGEN has the following minimal software requirements:

• Linux OS, kernel 2.4/2.6 • glibc version 2.2.93 or later • libstdc++ version 3.2 or later

For BSD platforms requirements are as follows:

• FreeBSD 5.4 • NetBSD 3.0 • OpenBSD 3.8 or OpenBSD 3.9

For Solaris requirements are as follows:

• Solaris 10

For all platforms:

• Internet Explorer 6 or later/ Firefox 2.0

Hardware requirements

AXIGEN has the following minimal hardware requirements:

• Processor: x86, minimum frequency 300 MHz • RAM: 128 MB. • Available space on HDD: 20 MB free space for installation purposes and default configuration

files. The actual space AXIGEN will take on your hard disk depends on the number of accounts, domains and mailboxes and the size of messages stored on the mail server.

Supported platforms

Linux (32-bit) RedHat Enterprise

• Redhat Enterprise Linux 4 • Redhat Enterprise Linux 3

Fedora


Date post:	05-Feb-2021
Category:	Documents
Upload:	others
View:	8 times
Download:	0 times

Axigen Reference Manual · AXIGEN® Mail Server User Manual Product version 3.0 Last update on:...

Documents