# Jive Messenger Installation Guide

Jive Messenger is a powerful instant messaging (IM) and chat server that implements the XMPP protocol. This document will guide you through installing Jive Messenger as a standalone application. For a full list of features and more information, please visit the Jive Messenger website: http://www.jivesoftware.org/messenger

In order to install Jive Messenger, you'll need a server environment that meets the following requirements:

- JDK 1.5.0 (Java 5) or later. Java 5 is bundled with the platform-specific Jive Messenger installers. If you are using the ".zip" or ".tar.gz" distribution, 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.
- A supported database with a robust JDBC driver, or you can choose to use the embedded database during the setup process. Supported databases and recommended JDBC drivers are detailed in the database documentation below.

## Installation Overview

To complete the installation of Jive Messenger, you'll need to perform each of the following steps:

1. Database - prepare your database for Jive Messenger.
2. Setup - Use the built in web based setup tool to setup and verify the server configuration.
3. Admin Console - use the web-based admin tool to manage the server.

## Files in the Distribution

The files in your distribution should be as follows (some sub-directories omitted for brevity):

    jive_messenger/
     |- readme.html
     |- license.html
     |- conf/
     |- bin/
     |- lib/
     |- plugins/
         |- admin/
     |- resources/
         |-database/
         |-security/
     |- documentation/

- The `conf` directory is where Jive Messenger stores configuration files.
- The `bin` directory contains the server executables. Depending on which distribution you installed, different executables will be available.
- The `lib` directory contains libraries necessary for running Jive Messenger.
- The `plugins` directory contains server plugins. By default, Jive Messenger ships with a web-based admin console plugin.
- The `resources/database` directory contains SQL schema files to create new Jive Messenger databases, as well as upgrade scripts for existing installations.
- The `resources/security` directory is where Jive Messenger maintains keystores to support SSL connection security.
- The `documentation` directory contains server documentation.

## Setup the Database

Jive Messenger uses a database to store it's data. To setup your database you must load the appropriate database schema. You can find schemas in the `resources/database` directory of this distribution. View the database setup documentation to learn how to install the schemas and JDBC drivers. Alternatively, you can select the embedded database during the setup process.

Complete the database steps outlined in the database setup documentation before proceeding further.

## Setup the Server

A web based, "wizard" driven setup and configuration tool is built into Jive Messenger. Simply launch Jive Messenger 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 Messenger, the following URL will usually work: http://127.0.0.1:9090.

If you used the Jive Messenger installer, a shortcut for starting the a graphical launcher is provided. A button on the on the launcher allows you to automatically open your web browser to the correct URL to finish setting up the server:

### Windows Service

If you're running Messenger on Windows, you will likely want to run Messenger as a standard Windows service after initial setup. If you used the Windows installer, a `messenger-service.exe` file will be in the `bin` directory of the installation. You can use this executable to install and control the Jive Messenger service.

From a console window, you can run the following commands:

- `messenger-service /install` -- installs the service.
- `messenger-service /uninstall` -- uninstalls the service.
- `messenger-service /start` -- starts the service
- `messenger-service /stop` -- stops the service.

You can also use the Services tool in the Windows Control Panel to start and stop the service.

Note: the graphical launcher is not compatible with the Windows service at this time. If you install the service, you should use service controls as described above to control the server rather than the graphical launcher.

## Admin Console

After completing the above steps, Messenger will be configured and you can use the web-based admin console to administer the server. The URL should be the same as you used to setup the server unless you changed the port during the setup.