Table of Contents

2. Getting Started with AXIGEN

2.1. Software and Hardware requirements

2.2. Installing on Linux

2.2.1. Installing under RHEL, Fedora Core, Mandrake and SUSE (gcc3)

2.2.2. Installing under Fedora Core, Mandriva and SUSE (gcc4)

2.2.3. Installing under Debian 3.1

2.2.4. Installing under Debian 4.0 and Ubuntu

2.2.5. Installing under Gentoo

2.2.6. Installing under Slackware

2.3. Installing on BSD

2.3.1. Installing on FreeBSD

2.3.2. Installing on NetBSD

2.3.3. Installing on OpenBSD 4.1

2.3.4. Installing on OpenBSD

2.4. Installing on Solaris i386 and Sparc

2.5. Installing on MS Windows

2.6. Uninstalling under Linux

2.6.1. Uninstalling under RHEL, Fedora Core, Mandriva /Mandrake and SUSE (gcc3, gcc4)

2.6.2. Uninstalling under Debian / Ubuntu

2.6.3. Uninstalling under Gentoo

2.6.4. Uninstalling under Slackware

2.7. Uninstalling under BSD

2.7.1. Uninstalling under FreeBSD

2.7.2. Uninstalling under NetBSD

2.7.3. Uninstalling under OpenBSD

2.8. Uninstalling under Solaris

2.9. Uninstalling on MS Windows

2.10. Starting / Stopping / Restarting the Server

2.11. Initial Server Configuration

2.11.1. Automated Configuration with the AXIGEN Configuration Wizard for Linux, BSD and Solaris

2.11.2. Automated Configuration with the AXIGEN Configuration Wizard for MS Windows

2.11.3. Manually Setting the Admin Password

2.11.4. Manually Configuring WebAdmin Services

2.11.5. Creating a New Domain

2.11.6. Adding an Account to an Existing Domain

2.2. Installing on Linux

The following section describes the general installation steps for AXIGEN on RedHat and SUSE distributions. For instructions related to a specific Linux distribution, please refer to the Install file included in the installation kit or read the sections corresponding to the respective Linux distribution.

General installation steps

Here are the general steps to be taken in order to install AXIGEN.
  • Configure axigen.cfg, as explained in the Configuring AXIGEN using axigen.cfg file section in order to adjust axigen.cfg file to your specific environment.
  • Start the AXIGEN server (Read the Starting/Stopping/Restarting AXIGEN section for information on how to start AXIGEN).
  • Create domains/accounts for your AXIGEN installation (more information can be found in the User and Domain Configuration section.
  • Reconfigure axigen.cfg (if needed).
  • Reload AXIGEN server. This way the changes committed in the main axigen.cfg file can take effect (changes to domains and accounts are made on the fly). Read the Starting/Stopping/Restarting AXIGEN section for information on how to reload AXIGEN.
  • After the installation, no daemons or related application are started.

Files Provided for Installation

The installation kit consists of the following files:
  • INSTALL
  • UNINSTALL
  • README
  • Distribution-specific package file(s).
The following table shows the files and directories provided in the installation kit required for AXIGEN to run correctly:

Directory/File Description
/etc/init.d/
/etc/init.d/axigen

This is the initscript for AXIGEN. The script will start the daemon for the Gentoo, Debian, RedHat and SUSE distributions.
/etc/rc.d/rc3.d/S80axigen
/etc/rc.d/rc4.d/S80axigen
/etc/rc.d/rc5.d/S80axigen
Symbolic links to the above mentioned initscript file, needed to start the daemon in the respective run levels (only for RedHat and SUSE distributions).
/etc/rc.d/rc.axigen This is the initscript for AXIGEN in the Slackware distribution.
/etc/conf.d/axigen This is the configuration file used by the AXIGEN initscript in the Gentoo distribution
/etc/opt/
/etc/opt/axigen/
/etc/opt/axigen/axigen.cfg
This is the main configuration file for AXIGEN.
/opt/axigen/
/opt/axigen/bin/
/opt/axigen/bin/axigen
This is the AXIGEN daemon.
/opt/axigen/bin/mqview This is the executable to be used for viewing the status of the queued messages. Please refer to the Command Line Parameters section for instructions on using this tool.
/opt/axigen/share/
/opt/axigen/share/doc/
/opt/axigen/share/doc/README
Document containing the release notes for this version of AXIGEN.
/opt/axigen/share/doc/INSTALL Document containing the installation instructions for AXIGEN
/opt/axigen/share/doc/UNINSTALL Document containing the instructions for uninstalling AXIGEN.
/opt/axigen/share/doc/LICENSE Document containing the license for AXIGEN.
/opt/axigen/share/examples/
/opt/axigen/share/examples/axigen.cfg
/opt/axigen/share/examples/domain.cfg
/opt/axigen/share/examples/account.cfg
Sample configuration files, containing the default values for AXIGEN parameters, as presented in this User Manual.
/var/opt/
/var/opt/axigen/
/var/opt/axigen/Webmail/
Default directory used for storing files pertaining to AXIGEN WebMail module.

See subsections of current page for more details:

Installing under RHEL, Fedora Core, Mandrake and SUSE (gcc3)
Installing under Fedora Core, Mandriva and SUSE (gcc4)
Installing under Debian 3.1
Installing under Debian 4.0 and Ubuntu
Installing under Gentoo
Installing under Slackware