Here are some brief installation notes. The installation was only tested on a freshly installed Ubuntu 8.04 system, we welcome any comments about success on other systems. Note that for doing most of the following you need to be root.
Installing Xuheki is not (yet?) for the faint of heart. Although we provide an install script, it might not work well on distributions other than Debian/Ubuntu, but problems should be easy to fix manually.
Make sure you have the main requirements installed already.
Perl modules
Xuheki requires a bunch of Perl modules. Our install script will fetch them automatically from CPAN, but if you want to install some of them from your preferred Linux distribution repositories, now it's the time to do so.
Note that in my install test (on Ubuntu 8.04/PPC) some of these modules failed to install cleanly from CPAN and needed manual hacking. If you're running Debian or Ubuntu I recommend you to run the following commands before install.pl:
apt-get install libapache2-request-perl apt-get install libio-socket-ssl-perl apt-get install libdatetime-format-mail-perl apt-get install libregexp-common-email-address-perl apt-get install libpoe-perl
This will clear some of the dependencies. To install additional modules from CPAN you will most certainly need a C and C++ compiler. You can install them this way:
apt-get install gcc g++
Now you should be ready to run install.pl
Running the install script
tar zxf Xuheki-0.1.tar.gz cd Xuheki-0.1 perl install.pl
The script will first try to install the missing modules. For doing this it will use CPAN. If it's the first time you run CPAN, it will ask you a series of questions for configuration. Most of the times the default answers are sane so you can simply hit ENTER. But watch out for a question that asks you about the policy of handling dependencies. The available choices are "ask" (default), "follow" and "ignore". You want to answer follow here because otherwise you'll need to explicitly agree to install each dependency.
After configuring the missing modules, install.pl will create the required MySQL database and will add an user and an IMAP server for you. You will need to answer some questions here, of course.
If anything fails
If anything bad happens, such as answering the wrong answer to some question in install.pl, running install.pl a second time might not work properly. To undo what install.pl does, do the following as root:
rm -rf /opt/Xuheki
rm -f /etc/init.d/xuheki
mysqladmin -u root drop $XUHEKI_DB_NAME_HERE
Then install.pl should work again.
