Linode Library Home
Linode Library RSS Feed
Home :: Communications :: XMPP Servers :: Openfire
Print View View Source

Instant Messaging Services with Openfire on Ubuntu 9.10 (Karmic)

Published: by

Warning

This document is an older, unmaintained guide. There may be a new guide available for this software.

Openfire is an open source real-time collaboration (instant messaging) server, built on the XMPP protocol and available for multiple platforms. This guide will help you get started with Openfire on your Ubuntu 9.10 (Karmic) Linux VPS.

If you haven't done so already, please follow the steps outlined in our getting started guide before following these instructions, and make sure your system is fully updated. Initial configuration steps will be performed through the terminal; please make sure you're logged into your Linode as root via SSH.

Contents

Install Prerequisites

Openfire requires a Java runtime engine (JRE). This tutorial uses the version provided by Sun Microsystems. Please note that although alternate Java runtime engines are available, Openfire may not work well with them.

Examine your /etc/apt/sources.list file to make sure you have the multiverse repository enabled. You can use an editor like nano to edit configuration files through the shell; you would issue the command "nano /etc/apt/sources.list" to edit this one. Please consult the nano manual page for information on using the editor. Your file should look similar to the following.

File:/etc/apt/sources.list

deb http://us.archive.ubuntu.com/ubuntu/ karmic main restricted
deb-src http://us.archive.ubuntu.com/ubuntu/ karmic main restricted

deb http://us.archive.ubuntu.com/ubuntu/ karmic-updates main restricted
deb-src http://us.archive.ubuntu.com/ubuntu/ karmic-updates main restricted

deb http://us.archive.ubuntu.com/ubuntu/ karmic universe
deb-src http://us.archive.ubuntu.com/ubuntu/ karmic universe
deb http://us.archive.ubuntu.com/ubuntu/ karmic-updates universe
deb-src http://us.archive.ubuntu.com/ubuntu/ karmic-updates universe

deb http://us.archive.ubuntu.com/ubuntu/ karmic multiverse
deb-src http://us.archive.ubuntu.com/ubuntu/ karmic multiverse
deb http://us.archive.ubuntu.com/ubuntu/ karmic-updates multiverse
deb-src http://us.archive.ubuntu.com/ubuntu/ karmic-updates multiverse

deb http://security.ubuntu.com/ubuntu karmic-security main restricted
deb-src http://security.ubuntu.com/ubuntu karmic-security main restricted
deb http://security.ubuntu.com/ubuntu karmic-security universe
deb-src http://security.ubuntu.com/ubuntu karmic-security universe
deb http://security.ubuntu.com/ubuntu karmic-security multiverse
deb-src http://security.ubuntu.com/ubuntu karmic-security multiverse

If you had to add the multiverse repositories to your sources, issue the following command to update your package database:

apt-get update
apt-get upgrade

Issue the following command to install prerequisite packages on your server:

apt-get install sun-java6-jre

The Sun Java6 JRE will be installed, along with a series of dependencies it requires. You will be prompted to accept the licensing agreement for Sun Java before proceeding.

Adjust Firewall Settings

If you employ a firewall to specify what ports can be accessed on your VPS, please make sure you have the following ports open:

Additional ports may need to be opened later to support more advanced XMPP services, but these are the ports that Openfire will use by default.

Install Openfire

Visit the download page for the Openfire RTC server and click the link for the "deb" package. You will be taken to another page, which will start the download to your workstation. You may cancel this download, as a manual download link will be presented that you may copy to your clipboard. Use wget on your Linode to retrieve the package (substitute the link for the current version in the command below). You may need to install wget first using the command "apt-get install wget".

wget http://www.igniterealtime.org/downloadServlet?filename=openfire/openfire_3.6.4_all.deb

Install the software using dpkg as follows:

dpkg -i openfire_3.6.4_all.deb

Next, edit the configuration file /etc/openfire/openfire.xml, inserting your Linode's public IP address in the <interface> section, and removing the "<!-- -->" comment markers that surround this section.

File excerpt:/etc/openfire/openfire.xml

<interface>12.34.56.78</interface>

Restart Openfire with the following command:

/etc/init.d/openfire restart

This completes the initial installation steps for Openfire. Next, we'll continue with configuration through a web browser.

Configure Openfire

Direct your browser to your Linode's IP address or FQDN (fully qualified domain name, if an entry in DNS points to your Linode's IP) on port 9090. As an example, if your Linode's IP address were "12.34.56.78", you would visit http://12.34.56.78:9090 in your web browser. You will be presented with a language selection screen similar to this:

Language selection in Openfire setup on Ubuntu 9.10 (Karmic).

Next, you'll be asked to configure your domain and ports for administration. Use the fully qualified domain name you have assigned to your Linode in DNS (more infomation: configuring DNS with the Linode Manager).

Domain and admin ports selection in Openfire setup on Ubuntu 9.10 (Karmic).

You may choose to use Openfire's internal database for account management, or you may connect to an external database. Most users will want to choose the built-in option.

Database type selection in Openfire setup on Ubuntu 9.10 (Karmic).

User profiles may be stored in the server database, or they may be pulled from LDAP or Clearspace. Most users will want to choose the default option.

Profile storage selection in Openfire setup on Ubuntu 9.10 (Karmic).

Enter the email address of the default administrative user and select a strong password.

Administrator account settings in Openfire setup on Ubuntu 9.10 (Karmic).

After the initial web-based configuration is complete, restart the Openfire server before attempting to log in with the default "admin" user account.

/etc/init.d/openfire restart

If you're experiencing difficulty using the credentials you just created to log in, please use "admin/admin" as the username/password. You'll need to update your credentials immediately afterward for security purposes. Congratulations! You've successfully installed the Openfire RTC server on Ubuntu 9.10.

More Information

You may wish to consult the following resources for additional information on this topic. While these are provided in the hope that they will be useful, please note that we cannot vouch for the accuracy or timeliness of externally hosted materials.

Creative Commons License

This guide is licensed under a Creative Commons Attribution-NoDerivs 3.0 United States License.

Last edited by Matthew Cone on Wednesday, October 3rd, 2012 (r3045).