The following operating systems are supported by Enswitch:

  • Debian GNU/Linux 5.0 or newer: No issues. This is the distribution Enswitch development machines run.
  • Ubuntu 8 or newer: Please ensure that exim or another MTA is installed.
  • Fedora Core 8 or newer: No issues.
  • CentOS 5 or newer: No issues.
  • Redhat Enterprise Linux 5 or newer: Requires Redhat subscription.

When installing machines, please note the following:

  • If possible, please configure the disks as RAID1 for reliability. If the machine has 4 disks, please use 2 as RAID1 for the root filesystem, and 2 as RAID1 for a separate filesystem for the database or NFS files. Database filesystems should be mounted on /var/lib/mysql, and NFS filesystems on /var/lib/enswitch.
  • Please use a fresh Linux installation.
  • Please install the minimum set of packages to get the machines on the internet, plus:
    • SSH daemon so we can connect in remotely.
    • The kernel source for the kernel running.
    • A mail transport agent (MTA). Sendmail is reported to work best out of the box, but Exim and Postfix can also be used. Please test that each machine can send emails to internet addresses, and that the headers on the emails are correct.
  • Hostnames must be lower-case only, match the machines' DNS entries, and be unique within the Enswitch cluster.
  • Please do not create an "enswitch" user; the Enswitch installer expects to create this user for daemons to run as.
  • Do not install Asterisk, OpenSIPS, OpenSER, SER, MySQL or Apache. The Enswitch installation process will install fresh versions. If these are already installed, we will ask you to wipe the machine and re-install Linux.
  • If your Linux distribution automatically installs any extra daemons such as X windows or network servers, please disable them. This improves both performance and security.
  • Please use static (not DHCP) IP addresses only.
  • Please disable ACPI in the BIOS settings or grub menu.
  • Please put the machines directly on the internet, not behind a firewall, even if the firewall claims to support VoIP. Please have the public IP addresses configured on the servers themselves rather than on a machine in front of them. We configure iptables based firewalling on each machine as a standard part of the installation.