Getting the source

This project uses Subversion to manage its source code. Instructions on Subversion use can be found at http://svnbook.red-bean.com/. If you are on Windows, the excellent TortoiseSVN client is highly recommended.

Web Access

The following is a link to the online source repository.

Anonymous access

The source can be checked out anonymously from SVN with this command:

$ svn checkout http://svn.apache.org/repos/asf/mina/vysper/trunk vysper

Developer access

Everyone can access the Subversion repository via HTTPS, but Committers must checkout the Subversion repository via HTTPS.

$ svn checkout https://svn.apache.org/repos/asf/mina/vysper/trunk vysper

To commit changes to the repository, execute the following command to commit your changes (svn will prompt you for your password)

$ svn commit --username your-username -m "A message"

Access from behind a firewall

For those users who are stuck behind a corporate firewall which is blocking http access to the Subversion repository, you can try to access it via the developer connection:

$ svn checkout https://svn.apache.org/repos/asf/mina/vysper/trunk vysper

Access through a proxy

The Subversion client can go through a proxy, if you configure it to do so. First, edit your "servers" configuration file to indicate which proxy to use. The files location depends on your operating system. On Linux or Unix it is located in the directory "~/.subversion". On Windows it is in "%APPDATA%\Subversion". (Try "echo %APPDATA%", note this is a hidden directory.)

There are comments in the file explaining what to do. If you don't have that file, get the latest Subversion client and run any command; this will cause the configuration directory and template files to be created.

Example : Edit the 'servers' file and add something like :

[global]
http-proxy-host = your.proxy.name
http-proxy-port = 3128

Building

We use Maven for managing our dependencies and packaging. Please use Maven 2.2.1 or later.
To install all of Vysper (core, modules etc) you can try this after the checkout:

mvn clean install

You can also build a complete, runnable Vysper server:

cd dist
mvn clean package

On successful build, you will find a functional binary package at

target/vysper-1.0.0-SNAPSHOT-bin.{zip|tar.gz}

Unpackaging a bin-package reveals a bin/ directory, containing run-scripts for Windows and Unix/MacOS.
Executing this script will boot a working Vysper XMPP server.