These are generic installation instructions and apply (with minor tweaks) to all supported Linux OS‘s. Be sure to run through the Hardware andconfig pages after the install to configure everything. Default passwords can (will?) be found in default_passwords.

Get a copy of the DVD or CD for the flavour of Linux you want to use. Centos and Fedora Core bittorrent links are available in the Bitorrent downloads section. This is the preferred method of getting the images. The tracker used is the default tracker provided by the vendor for that release of Linux. We do not run a tracker ourselves. (the torrent files are provided as a convenience).

Install the OS. You can use the ‘minimal’ installation option if available. If you want you can install Mysql, Apache (Web Server), Development Tools and Mail server. Don’t do any configuration on these until after you complete the reloaded installer. This is especially true of Mysql. Definately don’t change the default password otheriwse the app databases will not be populated.

Make sure you disable the firewall and SELinux when asked during the install. Enter a root password as well when asked. If you get a package selection dialog either select minimal or unselect everything except the Mysql, apache and Development tools. All other dialogs can be left to the defaults. (the installer will take care of the initial configuration).

Don’t do any yum updates until AFTER the installer has run. During the install it works against the base repositories (i.e. the DVD). For example if you update the kernel then zaptel will fail to install as it looks for the base kernel. Post install modules are available in the updates repository to match the latest kernel. If you find the repositories out of sync with the latest kernel then urgently post or pm me.

The installer has been altered to allow it to run against a yum updated machine.

Download the preinstall.sh script. this script ensures that various things are setup before running the installer.

1. disable selinux if not done during the OS install phase.
2. disable iptables and ip6tables if not done during the OS installation phase.
3. setup and enable samba to autostart. Samba will share /usr/src so that the installation archive can be copied across from a windows machine if neccessary. Samba is reconfigured during the installation secure it (only /tmp is shared).

wget "http://www.trixboxtools.co.uk/data/downloads/preinstall.sh"
chmod +x preinstall.sh
./preinstall.sh

Transfer the installation.tar.gz file to the /usr/src directory

After the installation connect to the server via a SSH based ftp client like Filezilla or Winscp. Connection settings will be something like

  * IPaddress (if using dhcp use ifconfig to determine your IP address)
  * Port = 22
  * server type SFTP using SSH2
  * logontype = normal
  * root user name and password selected during the install

Download the installer<version>.tar.gz file from the downloads section and use the ftp client to transfer the file.

Check the version from the downloads section. Use exactly the name listed there. (thanks florim!)

The preinstall.sh script will have setup samba to share the /usr/src directory. In windows select Start –> Run. Type in the servers IP address preceeded by double back slashes (e.g. \\192.168.0.1 ). An explorer windows will pop up with your root share. (This script will share your root! This is only temporary to help you get the installation files onto the server. The installation script will lock this down to the /tmp directory for security reasons).

To find out your servers ip address use ifconfig to see the status of your network interfaces.

cd /usr/src 
wget "http://www.trixboxtools.co.uk/data/downloads/installation<version>.tar.gz" 
tar xzf installation.tar.gz 

change <version> for the latest version number. See the downloads section for the correct filename.

The installer is started using:

cd /usr/src/installation 
./install.sh 

VPS environments can be quite restricted. If you don’t have 128Mb+ of Ram then you will have issues with some of the non-essential components. The KDE/vncserver component will also have problems as X windows is not usually allowed. These can be easily disabled by editing 2 files.

and for all VPS environments edit:

 /usr/src/installation/install/linux/inst_linux.sh 

Comment out the following lines by placing a # at the beginning:

 ./inst_vncserver.sh 

For memory constrained environments edit:

 /usr/src/installation/install.sh  

Comment out the following lines by placing a # at the beginning.

./inst_java.sh 
./inst_wildfire.sh 
./inst_asterfax.sh 

A console GUI configuration script is also in the works which will give you more control during the installation.