Recent changes to Installation_2

Installation_2 modified by Jim

Jim — Sun, 30 Jan 2022 17:44:53 -0000

--- v31
+++ v32
@@ -1,17 +1,12 @@
 # Required Software from M2MLabs release 0.9 #

-* JDK 1.7 or higher
-* J2EE application server either Jboss WildFly 10.1 or higher, or Oracle Glassfish 4.1 or higher. JBoss WildFly is recommended since Glassfish is not developed any further.
-* Apache Cassandra database 2.1 or higher (actual version 2.1.20 or 3.11.2)
+* 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
-
-for Cassandra versions higher than 2.1 go to  conf/cassandra.yaml and enable thrift by adding
-start_rpc: true
-
-

 #### Optional Configuration ####

@@ -42,35 +37,9 @@

 # 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 https://docs.jboss.org/author/display/WFLY10/Getting+Started+Guide
+* create an admin user by executing add-user.(bat|sh) in <wildfly install="" dir="">/bin, a getting started guide for WildFly is available in 
 * start the WildFly server with standalone.(bat|sh) --server-config=standalone-full.xml
-* WildFly 10 requires Java run time version 8 or higher. If you do not have Java 8 please use Wildfly 9.
-* Wildfly 9 requires following patch: Open the mainspring.ear archive (e.g. with 7-Zip), go to cs-ws-0.9.war/WEB-INF/jboss-web.xml and remove <enable-websockets>true</enable-websockets>. Web Sockets in Wildfly 9 work without this tag and Wildfly 9 does not allow it. Please see https://issues.jboss.org/browse/JBMETA-386.
-
-# Glassfish #
-
-* download from https://glassfish.java.net/download.html and unzip
-
-* start the domain by asadmin start-domain domain1
-* check the glassfish admin gui at http://localhost:4848
-* for Glassfish 4.1.1 there is a known bug https://java.net/jira/browse/GLASSFISH-21440 that prevents web services using json to run properly. To correct the bug please download  jackson-module-jaxb-annotations-2.5.1.jar from https://mvnrepository.com/artifact/com.fasterxml.jackson.module/jackson-module-jaxb-annotations/2.5.1 and put it into the modules folder of your glassfish installation.
-*  for Glassfish 4.1.1 there is another known bug https://java.net/jira/browse/GLASSFISH-20850 that uses old guava.jar v13 instead of newer versions packaged with the application. To correct the bug please open mainspring.ear (copy and rename it to .zip), extract guava-<version>.jar from the lib folder and put it into the modules folder of your glassfish installation as guava.jar (without version, delete the existing guava.jar before there).
-*  after bug corrections restart the server
-
-#### Optional Server Configuration ####
-
->* **System property:** CLUSTER_NAME, CASSANDRA_URI
->* **To do:**     change if you are connecting to a seperate Cassandra cluster:
-    * ./asadmin create-system-properties CLUSTER_NAME=<name-of-the-cluster>, default is TestCluster
-    * ./asadmin create-system-properties CASSANDRA_URI=<uri-of-cassandra>, default is localhost:9160
-
->* **System property:** SERVER_TIMEZONE
->* **To do:**     change if you want to run in another timezone than the machine timezone:
-    * e.g. ./asadmin create-system-properties SERVER_TIMEZONE=Europe/Vienna, default is machine timezone
-
->* **System property:** ZOOKEEPER_URI
->* **To do:**     change if you want to run Mainspring on more than one node
-    * e.g. ./asadmin create-system-properties ZOOKEEPER_URI=<ip-address-of-zookeeper-machine>
+* WildFly 26 requires Java run time version 11 or higher.

 # Apache ZooKeeper #
 download from https://www.apache.org/dyn/closer.cgi/zookeeper
@@ -78,10 +47,9 @@
 # Mainspring Deployment #

 * download mainspring.ear from http://sourceforge.net/projects/m2mlabs/files/
-* Glassfish: deploy with asadmin deploy mainspring.ear or from the glassfish admin gui (before release 0.9.3 download and deploy cs-ws.war)
-*  JBoss WildFly: open the admin console http://localhost:9990/console and deploy mainspring.ear (before release 0.9.3 download and deploy cs-ws.war)
+*  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. 
+* **create **and enter your new main administration key and remember it. 

 ##### proceed with the [Tutorial](https://sourceforge.net/p/m2mlabs/wiki/Tutorial) #####

@@ -91,7 +59,7 @@

 #### Required Software ####

-* Netbeans version 7 or higher from http://netbeans.org/downloads
+* 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

</ip-address-of-zookeeper-machine></uri-of-cassandra></name-of-the-cluster></version></wildfly></wildfly>

Installation_2 modified by Jim

Jim — Sun, 24 Jun 2018 16:54:27 -0000

--- v30
+++ v31
@@ -57,7 +57,7 @@
 *  for Glassfish 4.1.1 there is another known bug https://java.net/jira/browse/GLASSFISH-20850 that uses old guava.jar v13 instead of newer versions packaged with the application. To correct the bug please open mainspring.ear (copy and rename it to .zip), extract guava-<version>.jar from the lib folder and put it into the modules folder of your glassfish installation as guava.jar (without version, delete the existing guava.jar before there).
 *  after bug corrections restart the server

-#### Optional Configuration ####
+#### Optional Server Configuration ####

 >* **System property:** CLUSTER_NAME, CASSANDRA_URI
 >* **To do:**     change if you are connecting to a seperate Cassandra cluster:
@@ -70,7 +70,7 @@

 >* **System property:** ZOOKEEPER_URI
 >* **To do:**     change if you want to run Mainspring on more than one node
-    * e.g. ./asadmin create-system-properties ZOOKEEPER_URI=<ip address="" of="" ZooKeeper="" machine="">
+    * e.g. ./asadmin create-system-properties ZOOKEEPER_URI=<ip-address-of-ZooKeeper-machine>

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

Installation_2 modified by Jim

Jim — Sun, 24 Jun 2018 16:51:49 -0000

--- v29
+++ v30
@@ -68,6 +68,13 @@
 >* **To do:**     change if you want to run in another timezone than the machine timezone:
     * e.g. ./asadmin create-system-properties SERVER_TIMEZONE=Europe/Vienna, default is machine timezone

+>* **System property:** ZOOKEEPER_URI
+>* **To do:**     change if you want to run Mainspring on more than one node
+    * e.g. ./asadmin create-system-properties ZOOKEEPER_URI=<ip address="" of="" ZooKeeper="" machine="">
+
+# Apache ZooKeeper #
+download from https://www.apache.org/dyn/closer.cgi/zookeeper
+
 # Mainspring Deployment #

 * download mainspring.ear from http://sourceforge.net/projects/m2mlabs/files/

Installation_2 modified by Jim

Jim — Sun, 24 Jun 2018 16:46:35 -0000

--- v28
+++ v29
@@ -3,7 +3,7 @@
 * JDK 1.7 or higher
 * J2EE application server either Jboss WildFly 10.1 or higher, or Oracle Glassfish 4.1 or higher. JBoss WildFly is recommended since Glassfish is not developed any further.
 * Apache Cassandra database 2.1 or higher (actual version 2.1.20 or 3.11.2)
-* Apache ZooKeeper 3.4.12 or higher (only required if Mainspring is run as a cluster)
+* 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

Installation_2 modified by Jim

Jim — Sun, 24 Jun 2018 16:45:58 -0000

--- v27
+++ v28
@@ -1,8 +1,9 @@
 # Required Software from M2MLabs release 0.9 #

 * JDK 1.7 or higher
-* J2EE application server either Jboss WildFly 10.1 or Oracle Glassfish 4.1 or higher. JBoss WildFly 10 is recommended since Glassfish is not developed any further.
-* **Apache Cassandra 2.1.2 or higher (actual version 2.1.17 or 3.0.13)** database
+* J2EE application server either Jboss WildFly 10.1 or higher, or Oracle Glassfish 4.1 or higher. JBoss WildFly is recommended since Glassfish is not developed any further.
+* Apache Cassandra database 2.1 or higher (actual version 2.1.20 or 3.11.2)
+* Apache ZooKeeper 3.4.12 or higher (only required if Mainspring is run as a cluster)

 # Apache Cassandra Database #
 download from http://cassandra.apache.org/download

Installation_2 modified by Jim

Jim — Mon, 01 May 2017 16:30:13 -0000

--- v26
+++ v27
@@ -1,8 +1,8 @@
 # Required Software from M2MLabs release 0.9 #

 * JDK 1.7 or higher
-* J2EE application server either Jboss WildFly 10.1 or Oracle Glassfish 4.1 or higher
-* **Apache Cassandra 2.1.2 or higher (actual version 2.1.17)** database
+* J2EE application server either Jboss WildFly 10.1 or Oracle Glassfish 4.1 or higher. JBoss WildFly 10 is recommended since Glassfish is not developed any further.
+* **Apache Cassandra 2.1.2 or higher (actual version 2.1.17 or 3.0.13)** database

 # Apache Cassandra Database #
 download from http://cassandra.apache.org/download

Installation_2 modified by Jim

Jim — Mon, 01 May 2017 16:27:05 -0000

--- v25
+++ v26
@@ -7,8 +7,9 @@
 # Apache Cassandra Database #
 download from http://cassandra.apache.org/download

-for Cassandra versions higher than 2.1 go to  <Cassandra install="" dir="">/conf/cassandra.yaml and enable thrift by adding
+for Cassandra versions higher than 2.1 go to  conf/cassandra.yaml and enable thrift by adding
 start_rpc: true
+

 #### Optional Configuration ####
@@ -29,7 +30,7 @@
 >* go to apache-cassandra\\bin and start cassandra with cassandra.bat

 **Unix/Linux** 
->* go to apache-cassandra/bin and start cassandra with ./cassandra -f
+>* go to apache-cassandra/bin and start cassandra with ./cassandra

 #### Administration ####

@@ -42,6 +43,8 @@
 * 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 https://docs.jboss.org/author/display/WFLY10/Getting+Started+Guide
 * start the WildFly server with standalone.(bat|sh) --server-config=standalone-full.xml
+* WildFly 10 requires Java run time version 8 or higher. If you do not have Java 8 please use Wildfly 9.
+* Wildfly 9 requires following patch: Open the mainspring.ear archive (e.g. with 7-Zip), go to cs-ws-0.9.war/WEB-INF/jboss-web.xml and remove <enable-websockets>true</enable-websockets>. Web Sockets in Wildfly 9 work without this tag and Wildfly 9 does not allow it. Please see https://issues.jboss.org/browse/JBMETA-386.

 # Glassfish #

Installation_2 modified by Jim

Jim — Mon, 01 May 2017 16:17:07 -0000

--- v24
+++ v25
@@ -6,6 +6,9 @@

 # Apache Cassandra Database #
 download from http://cassandra.apache.org/download
+
+for Cassandra versions higher than 2.1 go to  <Cassandra install="" dir="">/conf/cassandra.yaml and enable thrift by adding
+start_rpc: true

 #### Optional Configuration ####

Installation_2 modified by Jim

Jim — Fri, 31 Mar 2017 08:27:46 -0000

--- v23
+++ v24
@@ -47,6 +47,8 @@
 * start the domain by asadmin start-domain domain1
 * check the glassfish admin gui at http://localhost:4848
 * for Glassfish 4.1.1 there is a known bug https://java.net/jira/browse/GLASSFISH-21440 that prevents web services using json to run properly. To correct the bug please download  jackson-module-jaxb-annotations-2.5.1.jar from https://mvnrepository.com/artifact/com.fasterxml.jackson.module/jackson-module-jaxb-annotations/2.5.1 and put it into the modules folder of your glassfish installation.
+*  for Glassfish 4.1.1 there is another known bug https://java.net/jira/browse/GLASSFISH-20850 that uses old guava.jar v13 instead of newer versions packaged with the application. To correct the bug please open mainspring.ear (copy and rename it to .zip), extract guava-<version>.jar from the lib folder and put it into the modules folder of your glassfish installation as guava.jar (without version, delete the existing guava.jar before there).
+*  after bug corrections restart the server

 #### Optional Configuration ####

Installation_2 modified by Jim

Jim — Fri, 31 Mar 2017 08:14:45 -0000

--- v22
+++ v23
@@ -1,7 +1,7 @@
 # Required Software from M2MLabs release 0.9 #

 * JDK 1.7 or higher
-* J2EE application server Oracle Glassfish 4.1 or higher
+* J2EE application server either Jboss WildFly 10.1 or Oracle Glassfish 4.1 or higher
 * **Apache Cassandra 2.1.2 or higher (actual version 2.1.17)** database

 # Apache Cassandra Database #
@@ -35,6 +35,10 @@
 >* **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 https://docs.jboss.org/author/display/WFLY10/Getting+Started+Guide
+* start the WildFly server with standalone.(bat|sh) --server-config=standalone-full.xml

 # Glassfish #

@@ -58,7 +62,8 @@
 # Mainspring Deployment #

 * download mainspring.ear from http://sourceforge.net/projects/m2mlabs/files/
-* deploy with asadmin deploy mainspring.ear or from the glassfish admin gui (before release 0.9.3 download and deploy cs-ws.war)
+* Glassfish: deploy with asadmin deploy mainspring.ear or from the glassfish admin gui (before release 0.9.3 download and deploy cs-ws.war)
+*  JBoss WildFly: open the admin console http://localhost:9990/console and deploy mainspring.ear (before release 0.9.3 download and deploy cs-ws.war)
 * go to http://localhost:8080/cs-ws
 * create and enter your new main administration key and remember it.