Installing Ubersmith on cPanel server

This document will guide you through the process of installing
Ubersmith on a server running cPanel.

Ensure that the required PHP4 modules are installed:

* php4-mysql
* php4-gd
* php4-curl
* php4-mcrypt

You may need to recompile Apache and PHP with the required modules.

Optionally install htmldoc, html2text, unrtf and catdoc

htmldoc is required to generate PDF invoices
html2text, unrtf and catdoc are required to extract text from incoming
tickets/attachments


Download the latest ubersmith tarball and extract it, then copy the
contents of the www directory to your web root, eg.

cd ~
wget http://download.ubersmith.com/ubersmith.tar.gz
tar zxvfp ubersmith.tar.gz
cd ubersmith/www
cp -a * .htaccess ~/yourdomain.com/public_html

Please ensure that the .htaccess file is copied correctly from the www
directory to your apache web root.

Copy the config.ini.php and token.xml.php files to the directory above
your web root and allow ubersmith to modify them, eg.

cd ..
cp token.xml.php config.ini.php ~/yourdomain.com
cd ~/yourdomain.com
chgrp nobody token.xml.php config.ini.php


Open http://yourdomain.com/ in your web browser, and you will be see
the Ubersmith setup wizard. Follow the directions in the wizard to
configure your Ubersmith instance.

Once finished, you must remove the setup directory before ubersmith
will run, eg.

rm -r ~/yourdomain.com/public_html/setup