Skip to content
Benjamin Paillereau edited this page Jun 7, 2013 · 5 revisions

Step 1 : Build

Step 1a : Maven

Prerequisite : install Maven 3.

Step 1b : Source

Clone the chat repo (compatible with eXo Platform 4) :

git clone https://github.com/exo-addons/chat-application.git
cd chat-application

or download the last tag v0.6 (old version compatible with eXo Platform 3.5)

unzip chat-application-XXX.zip
cd chat-application-XXX

Step 1c : Build

Finally, build the project with maven :

mvn clean install

If you have a problem of dependency during the building, try adding eXo Mirror in your Maven settings :


     <mirrors>
        <mirror>
          <id>exo-central-server</id>
          <name>eXo Central Server</name>
          <url>http://repository.exoplatform.org/public/</url>
          <mirrorOf>central</mirrorOf>
        </mirror>
      </mirrors>

Step 2 : Configure MongoDB Server

Prerequisite : install MongoDB. then configure your chat.properties file like :

dbServerHost=localhost
dbServerPort=27017
dbName=chat
dbAuthentication=false
dbUser=admin
dbPassword=pass
chatServerUrl=/chatServer
chatPortalPage=/portal/intranet/chat
chatIntervalNotif=3000
chatIntervalChat=3000
chatIntervalSession=60000
chatIntervalStatus=15000
chatIntervalUsers=5000
chatPassPhrase=your-passphrase-here
chatCronNotifCleanup=0 0/60 * * * ?
publicMode=true
publicAdminGroup=/platform/administrators
weemoKey=your-key-here

Important : don't forget to change the passphrase (chatPassPhrase) !

Step 3 : Dry Run eXo Platform 4

Prerequisite : install eXo Platform 4 and rename it tomcat/

Use eXo start script :

cd tomcat 
./start_eXo.sh

Now, point your browser to http://localhost:8080/portal/ and create your administrator account.

cd tomcat 
./stop_eXo.sh   #or CTRL+C in your terminal

Step 4 : Deploy

** DISCLAIMER : JuzuWeb 0.6.0 uses other Servlet 3.0+ methods. It's not possible to use Juzu with eXo Platform 3.5 in Servlet Mode anymore (only Portlet mode, the most important one will continue to work). eXo Platform 4 supports Servlet 3.0 and is fully compliant with the last Chat release.**

cp data/chat.properties tomcat/conf/
cp server/target/chatServer.war tomcat/webapps/
cp application/target/chat.war tomcat/webapps/
cp config/target/chat-extension-config-XXX.jar tomcat/lib/
cp extension/target/chat-extension.war tomcat/webapps/

Note : XXX in the jar stands for its version (i.e. 0.7.0 or 0.7.0-SNAPSHOT). There's also a source jar (chat-extension-config-XXX-sources.jar). This jar can be ignored.

Step 5 : Run with Chat

Use eXo start script :

cd tomcat 
./start_eXo.sh

Now, point your browser to http://localhost:8080/portal/ and login with your administrator.

You should have a new entry for the Chat in the Left Menu.