Installation_2

Required Software from M2MLabs release 0.9

• JDK 11
• J2EE application server WildFly 26 or higher,.
• Apache Cassandra 3.11.2 or higher
• Apache ZooKeeper 3.4.12 or higher (only required if Mainspring is run on more than one node)

Apache Cassandra Database

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

Optional 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://cassandra.apache.org/doc/latest/getting_started/index.html

MS Windows

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

Unix/Linux

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

Administration

None - no further administration is required anymore!

• Start Cassandra:
  cassandra.bat

Jboss WildFly

• download from http://wildfly.org/downloads and unzip
• create an admin user by executing add-user.(bat|sh) in <wildfly install="" dir="">/bin, a getting started guide for WildFly is available in </wildfly>
• start the WildFly server with standalone.(bat|sh) --server-config=standalone-full.xml
• WildFly 26 requires Java run time version 11 or higher.

Apache ZooKeeper

download from https://www.apache.org/dyn/closer.cgi/zookeeper

Mainspring Deployment

• download mainspring.ear from http://sourceforge.net/projects/m2mlabs/files/
• JBoss WildFly: open the admin console http://localhost:9990/console and deploy mainspring.ear
• go to http://localhost:8080/cs-ws
• create and enter your new main administration key and remember it.

proceed with the Tutorial

---

Build from Source

Required Software

• Netbeans version 8 or higher from http://netbeans.org/downloads
• Mercurial 3.2 or higher from http://mercurial.selenic.com
• Maven 3 from http://maven.apache.org/download.cgi

Build

• enter hg clone http://hg.code.sf.net/p/m2mlabs/mainspring
• enter mvn install
• deploy with asadmin deploy <mainspring-dir>/mainspring-ear/target/<ear-file></ear-file></mainspring-dir>
• go to http://localhost:8080/cs-ws
• enter your main administration key and remember it