Installing a Jabber server

This describes how to install a jabber server on ubuntu linux (6.06), but should work pretty well on just about any distro. I’ve used wildfire, becuse it is the most feature complete, and its as easy to install as it gets. Its java based, so you’ll need to have java installed properly first.

Make sure you have java installed (java -version), if not get it and install it

Install Sun Java

sudo apt-get install sun-java5-jre
sudo update-alternatives --config java

select sun java at the prompt (no 3 on mine)

Basic Install with Mysql

Download the latest version from http://www.jivesoftware.org/downloads.jsp#messenger

Untar to /opt
cd /opt
sudo tar zxvf wildfire_x_x_x.tar.gz

Create the wildfire database
mysqladmin create wildfire -uroot -p
mysql -uroot -p (enter password)
GRANT ALL PRIVILEGES ON wildfire.* TO wildfireusr@localhost IDENTIFIED BY ‘whatever-password-you-like’;
quit;
mysql -uwildfireusr -p wildfire < wildfire/resources/database/wildfire_mysql.sql (enter the password for wildfireusr)

Start wildfire
./wildfire/bin/wildfire start

Connect to web gui
http://localhost:9090 or https://whateverhost:9091

Configure
Follow the basic config steps, here you can also choose to use the embedded database (if you have set up mysql, dont, use standard)
Select mysql from the presets
Your database url should look something like jdbc:mysql://localhost:3306/wildfire
Provide the username and password you did earlier (wildfireusr and the password you chose)
Choose an admin password and fill in your email address
Wildfire is now installed, play around with the config!

Configure wildfire to run on system start

I’m running wildfire on an ubuntu 6.0.6 server, I had to modify the redhat based script a little, heres my ubuntu-postinstall.sh (modified from redhat-postinstall.sh)

 #!/bin/sh

# ubuntu-postinstall.sh (from redhat-poinstall.sh)
#
# This script sets permissions on the Wildfire installtion
# and install the init script.
#
# Run this script as root after installation of wildfire
# It is expected that you are executing this script from the bin directory

# If you used an non standard directory name of location
# Please specify it here
# WILDFIRE_HOME=

WILDFIRE_USER="jive"
WILDFIRE_GROUP="jive"

if [ ! $WILDFIRE_HOME ]; then
        if [ -d "/opt/wildfire" ]; then
                WILDFIRE_HOME="/opt/wildfire"
        elif [ -d "/usr/local/wildfire" ]; then
                WILDFIRE_HOME="/usr/local/wildfire"
        fi
fi

# Grant execution permissions
chmod +x $WILDFIRE_HOME/bin/extra/wildfired

# Install the init script
cp $WILDFIRE_HOME/bin/extra/wildfired /etc/init.d
# Use update-rc.d for debian based systems
update-rc.d wildfired defaults
#uncomment for redhat based systems
#/sbin/chkconfig --add wildfired
#/sbin/chkconfig wildfired on

# Create the jive user and group
/usr/sbin/groupadd $WILDFIRE_GROUP
#create user and home dir for user
/usr/sbin/useradd $WILDFIRE_USER -g $WILDFIRE_GROUP -s /bin/bash -m

# Change the permissions on the installtion directory
/bin/chown -R $WILDFIRE_USER:$WILDFIRE_GROUP $WILDFIRE_HOME

Configure SSL

You may want to use your own certificates for the deployment, there is a lot more information on how to use the keystore with wildfire here: http://www.jivesoftware.org/builds/messenger/docs/latest/documentation/ssl-guide.html

Connect

To connect with gaim, add a new jabber account with these settings:

Protocol: Jabber

Screren name: Whatever you like

Server: The fqdn of your jabber server (or ip if you like)

Resource: Whatever you like

Password: Choose one!

In the advanced tab, tick Require TLS, and Force old (port 5223) SSL, then click register. This will pop up a window asking for some details, fill them in, and you will then be able to connect.