openfire: instant messaging server

Openfire is a powerful instant messaging (IM) and chat server that implements the XMPP protocol. This document will guide you through installing Openfire. For a full list of features and more information, please visit the Openfire website: http://www.igniterealtime.org/projects/openfire/

A. INSTALLATIONS
first download the binary package from :
http://www.igniterealtime.org/openfire-3.8.1-1.i386.rpm

then run it using your package manager to install Openfire to /opt/openfire (as root):
rpm -ivh openfire_3_0_0.rpm

Note:

if you are using the .tar.gz build, it does not contain a bundled Java runtime (JRE). Therefore, you must have JDK or JRE 1.5.0 (Java 5) or later installed on your system. You can check your java version by typing "java -version" at the command line and (if necessary) upgrade your Java installation by visiting http://java.sun.com.

B. SETUP
the database
In the Openfire setup tool, use the following values:

• driver: com.mysql.jdbc.Driver
• server: jdbc:mysql://[YOUR_HOST]/[DATABASE_NAME]

where [YOUR_HOST] and [DATABASE_NAME] are the actual values for you server. In many cases localhost is a suitable value for [YOUR_HOST] when your database is running on the same server as your webserver.

Setup Instructions

1. Make sure that you are using MySQL 4.1.18 or later (5.x recommended) ¹.
2. Create a database for the Openfire tables:
   mysqladmin create [databaseName]
   (note: "databaseName" can be something like 'openfire')
3. Import the schema file from the resources/database directory of the installation folder:
   Unix/Linux: cat openfire_mysql.sql | mysql [databaseName];
   Windows: type openfire_mysql.sql | mysql [databaseName];
4. Start the Openfire setup tool, and use the appropriate JDBC connection settings.

  the server

A web-based, "wizard" driven setup and configuration tool is built into Openfire. Simply launch Openfire (platform-specific instructions below) and use a web browser to connect to the admin console. The default port for the web-based admin console is 9090. If you are on the same machine as Openfire, the following URL will usually work: http://127.0.0.1:9090. Initial setup and administration can also be done from a remote computer using LAN IP address instead or hostname if it is resolvable by the remote computer. Windows Server administrators should add http://127.0.0.1 address to Internet Explorer's Trusted Sites list, if Enhanced Security configuration is enabled in Internet Explorer. Otherwise they will get a blank screen.

Running Openfire
If you are running on a Red Hat or Red Hat like system (CentOS, Fedora, etc), we recommend using the RPM as it contains some custom handling of the standard Red Hat like environment. Assuming that you have used the RPM, you can start and stop Openfire using the /etc/init.d/openfire script. # /etc/init.d/openfire
Usage /etc/init.d/openfire {start|stop|restart|status|condrestart|reload}
# /etc/init.d/openfire start
Starting openfire:
If you are running on a different Linux/Unix varient, and/or you have used the .tar.gz 'installer', you can start and stop Openfire using the bin/openfire script in your Openfire installation: # ./openfire
Usage: ./openfire {start|stop}
# ./openfire start
Starting openfire