Installation and Setup V3: Unterschied zwischen den Versionen

Aus CTS2-LE
Zur Navigation springen Zur Suche springen
 
Zeile 1: Zeile 1:
= Standalone =
+
=Standalone=
 
All-in-one server mainly intended for exploration, 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
  
== Required Software ==
+
==Installation & Running==
* Java 8
 
  
== Installation & Running ==
+
*unzip <code>WebCts2LE-embedded-jetty.zip</code> to a directory (denoted by <code><W></code> in the following)
* unzip <code>WebCts2LE-embedded-jetty.zip</code> to a directory (denoted by <code><W></code> in the following)
+
*go to directory <code><W></code>
* go to directory <code><W></code>
+
*start command: <code>./bin/startup.sh -port <port></code>
* start command: <code>./bin/startup.sh -port <port></code>
+
*:<span style="color:DarkGray">Windows Powershell: .\bin\startup.bat -port <port></span>
*: <span style="color:DarkGray">Windows Powershell: .\bin\startup.bat -port <port></span>
+
*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>
+
*admin navigation ui: <code>http://<host>:<port>/WebCts2LE</code>
* admin navigation ui: <code>http://<host>:<port>/WebCts2LE</code>
 
  
== Docker ==
+
==Docker==
  
TO BE UPDATED
+
'''TO BE UPDATED'''
  
 
Let <code><DI></code> be the docker image name. Run the image with
 
Let <code><DI></code> be the docker image name. Run the image with
* <code>docker run -dit --restart=always --name=<name> --mount source=<volume>,target=/etc/webcts2le/inst/cts2lef-resources/resources-custom -p <port>:9090 <DI></code>
+
 
 +
*<code>docker run -dit --restart=always --name=<name> --mount source=<volume>,target=/etc/webcts2le/inst/cts2lef-resources/resources-custom -p <port>:9090 <DI></code>
 
*:<span style="color:DarkGray">on windows git bash: you have to exec before: docker() { (export MSYS_NO_PATHCONV=1; "docker.exe" "$@"); }</span>
 
*:<span style="color:DarkGray">on windows git bash: you have to exec before: docker() { (export MSYS_NO_PATHCONV=1; "docker.exe" "$@"); }</span>
 +
 
where  
 
where  
* <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><name></code> is the container name
* <code><port></code> is the delivered port (cf. [[#Installation_.26_Running|Installation & Running]] above)
+
*<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)
  
 
<!--
 
<!--
Zeile 120: Zeile 126:
 
-->
 
-->
  
= Basic Security =
+
=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).
 
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):
 
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>
+
*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