Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Warning
titleDOCUMENTATION MOVED

This documentation refers to a state where SADE was still in development. The installation instructions are still up to date, but the complete version of the current documentationis available at https://gitlab.gwdg.de/SADE/SADE/blob/develop/docs/about.md only.

English

Pagetitle
SADE-Server
SADE-Server

Installation

This page describes the installation of the server package. Please see also the details about the installation of the TextGridLab plug-in.

Download

This report refers to the SADE version Latest-stable.tar.gz (SADE server) provided in the TextGrid Wiki. This software is still in development. The daily build can be retrieved at https://ci.de.dariah.eu/jenkins/job/SADE/lastSuccessfulBuild/artifact/dist-utils/antbuild/build/sade-textgrid.tar.gz. Windows user may need an application such as WinRAR or 7-Zip to unpack the compressed folder.

Start

The compressed archive needs to be unzipped after its download. Afterwards the “bin” folder can be found in the unpacked directory. Startup applications for the different operating systems are available. Windows user open the files with the extension ".bat", Linux and Mac user the ones with ".sh".

filenamefunction
backupcreates a backup of the database

clientstartup script for eXist interactive client
runwith startup options for Linked Java Object Builder and YourKit Java
Profiler with Launcher and tray icon
serverstartup script for Jetty + eXist
shutdownstop Jetty + eXist
startup

startup script for Jetty + eXist

with the option "Java debugging via JDWP on port 4000 in server mode"
without Launcher and tray icon

In case of installations with a graphical user interface (Windows or Linux on personal computers) "run.sh" (Linux / Mac) or "run.bat" (Windows) is recommended because it contains a launcher, runs in the background and can be accessed or terminated via a tray icon. To configure a remote server, the documentationof eXist provides an auto-start-guide, accessible via http://exist-db.org/exist/apps/doc/advanced-installation.xml. By default, the communication to the instance runs via the port 8080. The "conf.xml" file has to be edited with the appropriate entryin order to use the port 80, which is the established standard for http and for websites. Mainly a privileged user can open port 80 for incoming requests. That’s why the application has to be started as an administrator or super user. The configurations described below have to be adapted accordingly.

German

Pagetitle
SADE-Server (de)
SADE-Server (de)

Installation

Es stehen ein Serverpaket und ein Plug-In für das TextGridLab zur Verfügung. Diese Seite behandelt die Installation des Servers.

Download

Dieser Report bezieht sich auf die im TextGrid Wiki bereitgestellte SADE-Version latest-stable.tar.gz (SADE-Server) Diese Software befindet sich noch in Entwicklung. Der tagesaktuelle build kann unter  http://ci.de.dariah.eu/jenkins/view/TextGridRep/job/SADE/lastSuccessfulBuild/artifact/dist-utils/antbuild/build/sade-textgrid.tar.gz abgerufen werden. Windows-Nutzer benötigen ggf. ein Programm wie WinRAR oder 7-zip um den komprimierten Ordner entpacken zu können.

Starten

Nach dem Download des komprimierten Archives muss dieses entpackt werden. Anschließend kann man in dem nun entpackten Verzeichnis den Ordner "bin" finden. Hier stehen für die verschiedenen Betriebssysteme Startprogramme bereit. Unter Windows öffnet man die Dateien mit der Erweiterung ".bat", unter Linux und Mac jene mit ".sh".

DateinameFunktion
backuperstellt ein Backup der Datenbank
clientStart Script for eXist interactive client
runmit Startoptionen für Linked Java Object Builder und YourKit Java Profiler
mit Launcher und Tray-Icon
serverStart Script for Jetty + eXist
shutdownStop Jetty + eXist
startup

Start Script for Jetty + eXist

mit Option "Java debugging via JDWP on port 4000 in Server mode"
(auskommentiert)
ohne Launcher und Tray-Icon

Bei Installationen mit graphischen Interface (Windows oder Linux auf dem eigenen PC) ist "run.sh" (Linux/Mac) bzw. "run.bat" (Windows) zu bevorzugen, da es einen Launcher mitbringt, im Hintergrund startet und via Tray-Icon aufgerufen oder beendet werden kann. Zur Konfiguration eines entfernten Servers bietet die Dokumentation von eXist eine Anleitung zum automatischen Starten, zu finden unter http://exist-db.org/exist/apps/doc/advanced-installation.xml.
Standardmäßig läuft die Kommunikation zur Instanz über den Port 8080. Will man den für http und somit für Internetseiten gängigen Port 80 benutzen, muss man die Datei „conf.xml" bearbeiten und dort den entsprechenden Eintrag vornehmen. Port 80 kann für eingehende Anfragen an Computer oft nur von einem privilegierten Nutzer geöffnet werden. Entsprechend muss das Programm als Administrator/Super User gestartet werden. Die folgend beschriebenen Konfigurationen müssen dann auch entsprechend angepasst werden.