Skip to content

lmillet/tatami

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tatami

Presentation

Tatami is a micro-blogging platform, for internal use inside a company.

A publicly installed version of Tatami is provided by Ippon Technologies at : http://tatami.ippon.fr

Tatami is made with the following technologies :

Tatami is developped by Ippon Technologies

Current build status is available on BuildHive : Build Status

Installation for developpers

5 minutes installation

  • Clone, fork or download the source code from this Github page
  • Install Maven 3
  • Run Cassandra from Maven : mvn cassandra:run
  • Run Jetty from Maven : mvn jetty:run
  • Connect to the application at http://127.0.0.1:8080

To create users, use the registration form. As we have not configured a SMTP server (you can configure it in src/main/resources/META-INF/tatami/tatami.properties - see below "installation for production use" for more options), the validation URL as well as the password will not be e-mailed to you, but you can see them in the log (look at the Jetty console output).

Maven tuning and troubleshooting

If you run into some Permgen or OutOfMemory errors, you can configure your Maven settings accordingly :

export MAVEN_OPTS="-XX:MaxPermSize=64m -Xms128m -Xmx1024m"

If you want to debug remotely the application with your IDE, set up your MAVEN_OPTS :

export MAVEN_OPTS="$MAVEN_OPTS -Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,address=8000,server=y,suspend=n"

Installation for production use

Cassandra installation

  • Download Apache Cassandra
  • Install Cassandra : the application will work fine with just one node, but ideally you should have a cluster with at least 3 or 5 nodes
  • Cassandra is configured with its cassandra.yaml file : don't forget to backup your "data" and "commitlog" directories

Tatami installation

Tatami can be configured with the src/main/resources/META-INF/tatami/tatami.properties file. You can configure this file in 2 ways :

  • Edit the file in your own Tatami fork
  • Properties in this file are replaced at build time by Maven : you can set up your own Maven profile with your specific properties

Once Tatami is started, you will be able to check your properties at runtime in the Administration page.

To deploy Tatami :

  • Create the Tatami WAR file : mvn package
  • The WAR file will be called "root.war", as Tatami should be run as the root application (on the "/" Web context)
  • Deploy the WAR file on your favorite Java EE server
  • The WAR has been tested on Jetty 8 and Tomcat 7, and should work fine on all Java EE servers

Thanks

Jetbrains is providing us free Intellij IDEA licenses, which definitely allows us to be more productive and have more fun on the project!

YourKit is kindly supporting open source projects with its full-featured Java Profiler. YourKit, LLC is the creator of innovative and intelligent tools for profiling Java and .NET applications. Take a look at YourKit's leading software products: YourKit Java Profiler and YourKit .NET Profiler.

License

Copyright 2012 Ippon Technologies

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this application except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

About

An enterprise micro-blogging platform

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Java 81.2%
  • JavaScript 14.0%
  • Shell 4.8%