CTS2-LE Installation and Deployment - Versionsgeschichte

Krebs: /* Changing the Context Path */

2017-08-28T11:51:09Z

‎Changing the Context Path

Krebs am 28. August 2017 um 11:50 Uhr

2017-08-28T11:50:18Z

Krebs am 6. Juni 2017 um 14:27 Uhr

2017-06-06T14:27:40Z

Krebs am 15. Mai 2017 um 14:39 Uhr

2017-05-15T14:39:21Z

Krebs: /* Delivered Resources */

2017-05-15T14:34:34Z

‎Delivered Resources

Krebs am 15. Mai 2017 um 14:26 Uhr

2017-05-15T14:26:56Z

Krebs am 15. Mai 2017 um 14:21 Uhr

2017-05-15T14:21:15Z

Krebs: /* cts2_conf.xml */

2017-05-15T13:05:42Z

‎cts2_conf.xml

Krebs: /* Delivered resources */

2017-05-15T13:03:54Z

‎Delivered resources

Krebs: /* Increasing Java heap space */

2017-05-15T12:22:52Z

‎Increasing Java heap space

@@ Zeile 193: / Zeile 193: @@
 <source lang="xml">
-<Context docBase="WebCts2LE" path="/<p>" reloadable="true"/>
+<Context docBase="WebCts2LE" path="/<path>" reloadable="true"/>
 </source>

@@ Zeile 187: / Zeile 187: @@
 <pre>http://<host>:<port>/WebCts2LE</pre>
 = Troubleshooting =
 * Do not run the starter script with root privileges.

← Nächstältere Version		Version vom 6. Juni 2017, 14:27 Uhr
Zeile 20:		Zeile 20:
	</syntaxhighlight>		</syntaxhighlight>

		+	= Allowing Encoding Slashes in URL =
		+	Add the following line to '''/var/lib/tomcat7/conf/calatina.properties''':

		+	<syntaxhighlight lang="text">
		+	org.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH=true
		+	</syntaxhighlight>

	= Setting the Resource Root and Increasing Java Heap Space=		= Setting the Resource Root and Increasing Java Heap Space=

← Nächstältere Version		Version vom 15. Mai 2017, 14:39 Uhr
Zeile 1:		Zeile 1:
−	This section describes how to install and deploy a CTS2-LE server instance along with the navigator front-end. It has to be ensured that the system fulfils the defined [[Prerequisites_for_CTS2-LE_Installation\|prerequisites]]. The following steps are aligned to the recommended system environment and hence offer commands on the basis of an Ubuntu-like OS.	+	This section describes how to install and deploy a CTS2-LE server instance along with the navigator front-end. It has to be ensured that the system fulfils the defined [[Prerequisites_for_CTS2-LE_Installation\|prerequisites]]. The following steps are aligned to the recommended system environment and hence offer commands on the basis of an Ubuntu-like OS and an installed Tomcat.

@@ Zeile 42: / Zeile 42: @@
 = Delivered Resources =
 A customer will reveice two zip-compressed archives namely:
-# load-vocabs.zip (denoted by '''''<VOCABS-ZIP>''''' in the following)
+# load-vocabs.zip
-# WebCts2LE-resource-root.zip (denoted by '''''<RESOURCE-ROOT-ZIP>''''' in the following)
+# WebCts2LE-resource-root.zip
-Extract '''''<RESOURCE-ROOT-ZIP>''''' to the destination defined by means of the environment variable '''CTS2LE_RESOURCE_ROOT''' and set access rights recursively:
+Extract '''''WebCts2LE-resource-root.zip''''' to the destination defined by means of the environment variable '''CTS2LE_RESOURCE_ROOT''':
   sudo chmod -R <pattern> $CTS2LE_RESOURCE_ROOT
 <pattern> has to be set accordingly, such that the server has read/write access to the resources.
-Extract '''''<VOCABS-ZIP>''''' to $CTS2LE_RESOURCE_ROOT/../load-vocabs.
+Extract '''''load-vocabs.zip''''' to $CTS2LE_RESOURCE_ROOT/../.
 Make sure the folders are structured as presented below:
   /load-vocabs

@@ Zeile 155: / Zeile 155: @@
 == WebCts2LE.war and WebCts2LEStarter.sh ==
-The web application archive '''WebCts2LE.war''' has to be deployed in a servlet container. Because there are further activities that come along with the deployment, a script ('''WebCts2LEStarter''') is provided.
+The web application archive '''WebCts2LE.war''' has to be deployed in a servlet container. Because there are further activities that come along with the deployment, a script ('''WebCts2LEStarter.sh''') is provided.
 = Deployment =
@@ Zeile 173: / Zeile 173: @@
 Ensure that '''CTS2LE_RESOURCE_ROOT''' is accessible from the script and that '''sudo''' is installed.
 = Troubleshooting =
 * Do not run the starter script with root privileges.

@@ Zeile 2: / Zeile 2: @@
-= General settings =
 <!--== Configure roles and users ==
@@ Zeile 13: / Zeile 13: @@
 -->
-== Encoding ==
+= Encoding =
 Make sure, the correct encoding for requests and responses is set. In '''/var/lib/tomcat7/conf/server.xml''' check the attribute '''URIEncoding''' in the connector tag.
@@ Zeile 20: / Zeile 20: @@
 </syntaxhighlight>
-= Setting the resource root =
+= Setting the Resource Root and Increasing Java Heap Space=
 Select a directory where the terminology store instances will be located. The directory has to be specified by setting an environment variable called '''CTS2LE_RESOURCE_ROOT'''.
 <div style="margin:0; border:2px solid #bfbfbf; padding: 1em 1em 1em 1em; background-color:#F8E3E3; align:center; ">
@@ Zeile 34: / Zeile 31: @@
   CTS2LE_RESOURCE_ROOT=/path/to/directory
   export CTS2LE_RESOURCE_ROOT
   #permanently increase heap space
   CATALINA_OPTS="-Xms512m -Xmx900m"
@@ Zeile 40: / Zeile 40: @@
 It is also recommended to follow [https://help.ubuntu.com/community/EnvironmentVariables these instructions] for setting environment variables system-wide.
-Extract the delivered resources (see below) to the defined destination '''CTS2LE_RESOURCE_ROOT''' and set access rights recursively:
+= Delivered Resources =
   sudo chmod -R <pattern> $CTS2LE_RESOURCE_ROOT
-<pattern> has to be set accordingly, such that the server have read/write access to the resources.
+<pattern> has to be set accordingly, such that the server has read/write access to the resources.
-= Delivered resources =
+Extract '''''<VOCABS-ZIP>''''' to $CTS2LE_RESOURCE_ROOT/../load-vocabs.
-You will be receiving a zip-compressed archive that combines several resources that allow for a fast and clean installation of CTS2-LE. The archive file has to be unzipped in the '''$CTS2LE_RESOURCE_ROOT''' directory and then shows the following structure:
+Make sure the folders are structured as presented below:
   /load-vocabs
-  <span style="color:#ff7f24">cts2_conf.xml</span>
+  /<$CTS2LE_RESOURCE_ROOT>
- <span style="color:#ff7f24">grouping.json</span>
+   <span style="color:#ff7f24">/bin</span>
- setting.json
+      <span style="color:#ff7f24">WebCts2LE.war</span>
 You should leave most of the directories untouched. Only adapt or execute the <span style="color:#ff7f24">highlighted</span> files as described in the section.

@@ Zeile 135: / Zeile 135: @@
 <syntaxhighlight lang="xml">
 <conf>
-	<vocabularies loadAll="false">
+	<vocabularies loadAll="false" fresh="true" index="true" sigCheck="true">
 		<vocabulary load="true" friendly-name="Example code system" resourceID="exa"/>
 	</vocabularies>

@@ Zeile 23: / Zeile 23: @@
 Experience has shown that increasing the heap space for tomcat positively influences the servers efficiency. Therefore, it is recommended to permanently set the environment variable '''CATALINA_OPTS'''.
-  CATALINA_OPTS="-Xms512m -Xmx900m"
+  export CATALINA_OPTS="-Xms512m -Xmx900m"
 = Setting the resource root =