Installation and Setup V3: Unterschied zwischen den Versionen

Aus CTS2-LE
Zur Navigation springen Zur Suche springen
K
 
(7 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
= Standalone =
+
=Standalone=
All-in-one server mainly intended for testing and "to-go"-scenarios.
+
All-in-one server mainly intended for exploration, testing and "to-go"-scenarios.
  
== Release Files ==
+
==Release Files==
* <code>WebCts2LE-embedded-jetty.zip</code>: CTS2-LE jetty server
+
 
 +
*<code>WebCts2LE-embedded-jetty.zip</code>: CTS2-LE jetty server
 +
 
 +
==Required Software==
 +
 
 +
*Java 8
 +
 
 +
==Installation & Running==
 +
 
 +
*unzip <code>WebCts2LE-embedded-jetty.zip</code> to a directory (denoted by <code><W></code> in the following)
 +
*go to directory <code><W></code>
 +
*start command: <code>./bin/startup.sh -port <port></code>
 +
*:<span style="color:DarkGray">Windows Powershell: .\bin\startup.bat -port <port></span>
 +
*shutdown command: <code>./bin/shutdown.sh <port></code>
 +
*:<span style="color:DarkGray">Windows Powershell: ctrl-c</span>
 +
*admin navigation ui: <code>http://<host>:<port>/WebCts2LE</code>
 +
 
 +
==Docker==
 +
 
 +
'''TO BE UPDATED'''
 +
 
 +
Let <code><DI></code> be the docker image name. Run the image with
  
== Required Software ==
+
*<code>docker run -dit --restart=always --name=<name> --mount source=<volume>,target=/etc/webcts2le/inst/cts2lef-resources/resources-custom -p <port>:9090 <DI></code>
* Java 8
+
*:<span style="color:DarkGray">on windows git bash: you have to exec before: docker() { (export MSYS_NO_PATHCONV=1; "docker.exe" "$@"); }</span>
  
== Installation & Running ==
+
where
* unzip <code>WebCts2LE-embedded-jetty.zip</code> to a directory (denoted by <code><W></code> in the following)
 
* go to directory <code><W></code>
 
* start command: <code>./bin/startup.sh -port <port></code>
 
*: <span style="color:DarkGray">Windows Powershell: .\bin\startup.bat -port <port></span>
 
* shutdown command: <code>./bin/shutdown.sh <port></code>
 
*: <span style="color:DarkGray">Windows Powershell: ctrl-c</span>
 
* navigation ui: <code>http://<host>:<port>/WebCts2LE</code>
 
  
 +
*<code><name></code> is the container name
 +
*<code><volume></code> is the volume name (it will be created if it does not exist and it will be reused !)
 +
*<code><port></code> is the delivered port (cf. [[#Installation_.26_Running|Installation & Running]] above)
  
 +
<!--
 
= External Storage/Index Backends =
 
= External Storage/Index Backends =
 
This version is intended for use in environments where the data backend can run on separate machines.
 
This version is intended for use in environments where the data backend can run on separate machines.
Zeile 73: Zeile 91:
 
* shutdown command: <code>./bin/shutdown.sh <port></code>
 
* shutdown command: <code>./bin/shutdown.sh <port></code>
 
*: <span style="color:DarkGray">Windows Powershell: ctrl-c</span>
 
*: <span style="color:DarkGray">Windows Powershell: ctrl-c</span>
* navigation ui: <code>http://<host>:<port>/WebCts2LE</code>
+
* admin navigation ui: <code>http://<host>:<port>/WebCts2LE</code>
  
== Basic Security ==
 
The Embedded Jetty Variant supports simple security based on Basic Access Authentication for services that modify the data base (advanced security will not be supported at this architecture level, instead special security components should be placed on top of WebCts2LE).
 
Changing security (see HashLoginService at https://www.eclipse.org/jetty/documentation/9.4.x/configuring-security.html for details):
 
* edit <code><W>/conf/basic-realm.properties</code>. It contains <code>username: password,rolename</code>, e.g. <code>admin: webcts2le-admin,admin</code>. Change username or password if needed. Role name <code>admin</code> should not be changed.
 
 
* run service with basic authentication via option flag: <code>./bin/startup.sh -port <port> -basic_auth</code>
 
  
 
== (Bulk-)Loading of Terminologies ==
 
== (Bulk-)Loading of Terminologies ==
Zeile 111: Zeile 123:
 
* run <code>GET http://<host>:<port>/WebCts2LE/service/manage/index/suggester/update</code> to update the suggester index (possibly with basic auth credentials)
 
* run <code>GET http://<host>:<port>/WebCts2LE/service/manage/index/suggester/update</code> to update the suggester index (possibly with basic auth credentials)
 
* restart server
 
* restart server
 +
 +
-->
 +
 +
=Basic Security=
 +
The Embedded Jetty Variant supports simple security based on Basic Access Authentication for services that modify the data base (advanced security will not be supported at this architecture level, instead special security components should be placed on top of WebCts2LE).
 +
Changing security (see HashLoginService at https://www.eclipse.org/jetty/documentation/9.4.x/configuring-security.html for details):
 +
 +
*edit <code><W>/conf/basic-realm.properties</code>. It contains <code>username: password,rolename</code>, e.g. <code>admin: webcts2le-admin,admin</code>. Change username or password if needed. Role name <code>admin</code> should not be changed.
 +
 +
*run service with basic authentication via option flag: <code>./bin/startup.sh -port <port> -basic_auth</code>

Aktuelle Version vom 4. September 2020, 14:37 Uhr

Standalone

All-in-one server mainly intended for exploration, testing and "to-go"-scenarios.

Release Files

  • WebCts2LE-embedded-jetty.zip: CTS2-LE jetty server

Required Software

  • Java 8

Installation & Running

  • unzip WebCts2LE-embedded-jetty.zip to a directory (denoted by <W> in the following)
  • go to directory <W>
  • start command: ./bin/startup.sh -port <port>
    Windows Powershell: .\bin\startup.bat -port <port>
  • shutdown command: ./bin/shutdown.sh <port>
    Windows Powershell: ctrl-c
  • admin navigation ui: http://<host>:<port>/WebCts2LE

Docker

TO BE UPDATED

Let <DI> be the docker image name. Run the image with

  • docker run -dit --restart=always --name=<name> --mount source=<volume>,target=/etc/webcts2le/inst/cts2lef-resources/resources-custom -p <port>:9090 <DI>
    on windows git bash: you have to exec before: docker() { (export MSYS_NO_PATHCONV=1; "docker.exe" "$@"); }

where

  • <name> is the container name
  • <volume> is the volume name (it will be created if it does not exist and it will be reused !)
  • <port> is the delivered port (cf. Installation & Running above)


Basic Security

The Embedded Jetty Variant supports simple security based on Basic Access Authentication for services that modify the data base (advanced security will not be supported at this architecture level, instead special security components should be placed on top of WebCts2LE). Changing security (see HashLoginService at https://www.eclipse.org/jetty/documentation/9.4.x/configuring-security.html for details):

  • edit <W>/conf/basic-realm.properties. It contains username: password,rolename, e.g. admin: webcts2le-admin,admin. Change username or password if needed. Role name admin should not be changed.
  • run service with basic authentication via option flag: ./bin/startup.sh -port <port> -basic_auth