svn commit: r1821570 - /incubator/taverna/site/trunk/content/documentation/server/3.1/index.md

[st...@apache.org]

Author: stain
Date: Fri Jan 19 00:22:52 2018
New Revision: 1821570

URL: http://svn.apache.org/viewvc?rev=1821570&view=rev
Log:
Update from README.md in release

Modified:
    incubator/taverna/site/trunk/content/documentation/server/3.1/index.md

Modified: incubator/taverna/site/trunk/content/documentation/server/3.1/index.md
URL: http://svn.apache.org/viewvc/incubator/taverna/site/trunk/content/documentation/server/3.1/index.md?rev=1821570&r1=1821569&r2=1821570&view=diff
==============================================================================
--- incubator/taverna/site/trunk/content/documentation/server/3.1/index.md (original)
+++ incubator/taverna/site/trunk/content/documentation/server/3.1/index.md Fri Jan 19 00:22:52 2018
@@ -20,13 +20,38 @@ Taverna Server is a REST/WSDL web servic
 [Apache Taverna](http://taverna.incubator.apache.org/) (incubating)
 workflows.
 
+In-depth documentation is available for:
+
 * [Installation guide](install)
 * [API User guide](usage)
 
 
+# Prerequisites
+
+* Java 1.8
+* [Apache Maven](https://maven.apache.org/download.html) 3.3.9 or newer
+* a Java Servlet container, e.g. [Apache Tomcat](https://tomcat.apache.org/)
+
+
+# Building
+
+After [downloading Taverna Server](/download/server/) and unpacking, 
+then to build, use:
+
+    mvn clean install
+
+This will build each module and run their tests.
+
+You should then find `taverna-server.war` in the folder
+`taverna-server-webapp/target/`
+
+Below we'll show how to install and configure this _WAR file_ 
+with Apache Tomcat. 
+
+
 ## A Beginner's Installation Guide to Taverna Server
 
-When installing Taverna Server 2.5, you *need* to decide whether to
+When installing Taverna Server, you *need* to decide whether to
 install in secure or insecure mode. In secure mode, the server
 enforces logins, ensures that they are done over HTTPS, and applies
 strong restrictions to what users can see of other users'
@@ -102,19 +127,19 @@ On RedHat Linux (and derivatives), you i
 
 You then start Tomcat with:
 
-    sudo service tomcat6 start
+    sudo service tomcat8 start
 
 And stop it with:
 
-    sudo service tomcat6 stop
+    sudo service tomcat8 stop
 
 It's configuration file (called `conf/server.xml` in the instructions below) will be in:
 
-    /etc/tomcat6/server.xml
+    /etc/tomcat8/server.xml
 
 It's webapp directory (`webapps` below) will be in:
 
-    /var/lib/tomcat6
+    /var/lib/tomcat8
 
 ### Installing on MacOS X, and using a baseline Apache distribution
 
@@ -149,9 +174,9 @@ The insecure version is installed by:
 
 ### First, place the WAR into Tomcat's webapps directory
 
-Use a filename that relates to what URL you want Taverna Server to
-appear at within Tomcat (e.g., if you want it to be at
-`/tavernaserver`, use the filename `webapps/tavernaserver.war`).
+You may use a filename that relates to what URL you want Taverna Server to
+appear at within Tomcat (e.g., if you want it to be at `/taverna`, use the
+filename `webapps/taverna.war`).
 
 ### Next, start Tomcat (if stopped), and shut it down again once it has unpacked the WAR.
 
@@ -239,8 +264,12 @@ to do the delegation even when running a
 
 ### Now, place the WAR into Tomcat's `webapps` directory.
 
-Use a filename that relates to what URL you want Taverna Server to
-appear at within Tomcat (e.g., if you want it to be at
-`/tavernaserver`, use the filename `webapps/tavernaserver.war`).
+You may use a filename that relates to what URL you want Taverna Server to
+appear at within Tomcat (e.g., if you want it to be deployed at
+`/taverna`, rename the WAR to a filename like `webapps/taverna.war`).
 
 ### Finally, start Tomcat.
+
+Taverna Server should then become available at
+the equivalent of http://localhost:8080/taverna-server/
+