Installation

Required Software up to M2MLabs release 0.8

• JDK 1.6 or higher
• J2EE application server Oracle Glassfish 3.1 or higher
• Apache Cassandra 1.0.12 database

Apache Cassandra Database

download from http://cassandra.apache.org/download

please use version 1.0.12, do not use version 1.1 now, the production version of the Hector client Api used in Mainspring currently does not support it

Configuration

• File name: conf/cassandra.yaml

• To do: change the value for following directories to a valid path:

  • data_file_directories
  • commitlog_directory
  • saved_caches_directory

• File name: conf/log4j.properties

• To do: edit the path to the system log if needed:
  • entry log4j.appender.R.File

further configuration hints at http://wiki.apache.org/cassandra/GettingStarted

MS Windows

• go to cassandra\bin and start cassandra with cassandra.bat

Unix/Linux

• go to cassandra/bin and start cassandra with ./cassandra -f

Administration

• Start Cassandra:
  cassandra.bat

• In a a separate window start Cassandra CLI:
  cassandra-cli -h localhost

• Execute following commands:

  • create keyspace cs
    with placement_strategy = 'org.apache.cassandra.locator.OldNetworkTopologyStrategy'
    and strategy_options = {replication_factor:1};
  • quit;

Glassfish

• download from http://glassfish.java.net/public/downloadsindex.html#top and run the installer
• start the domain by asadmin start-domain domain1
• check the glassfish admin gui at http://localhost:4848

Mainspring Deployment

• download cs-ws.zip or cs-ws.tar.gz from http://sourceforge.net/projects/m2mlabs/files/
• deploy with asadmin -deploy cs-ws.war or from the glassfish admin gui
• go to http://localhost:8080/cs-ws
• enter your main administration key and remember it

proceed with the Tutorial

---

Build from Source

Required Software

• Netbeans version 7 or higher from http://netbeans.org/downloads
• Mercurial 2.3 or higher from http://mercurial.selenic.com

enter hg clone http://hg.code.sf.net/p/m2mlabs/mainspring

build and deploy in Netbeans