Quelltext der Seite Installation SVWS-Server unter Linux (Installation)

==Download== 
[https://github.com/SVWS-NRW/SVWS-Server/releases GitHub.com/svws-nrw/svws-server/releases] 

<br />
Dann unter '''Assets''' den Link der '''1.x.x.sh'''-Datei kopieren.<br />



 wget <Pfad aus GitHub.com der install-1.x.x.sh einfügen> <br />

==Installation==

(root-Rechte beachten (z.B. sudo)) <br />

 (sudo) bash ./install-1.x.x.sh <br />

Es folgen die Einstellungsabfragen für MariaDB und SVWS-Server. <br />
Notieren Sie alle Kennwörter.<br />

Im Wurzelverzeichnis können die Daten in der Datei '''.env''' eingesehen werden.<br />

==Update==

Die neue Version muss im selben Verzeichnes der .env liegen. <br />
 (sudo) bash ./install-1.x.x.sh --update <br />

==Wichtige Verzeichnisse/Dateien:==
#/opt/app/svws/svwsconfig.json
#/etc/mysql/mariadb.conf/50-server.cnf (enth. u.a. bind-adress)
#.env (Enthält alle Verknüpfungsangaben)

====Nach Änderungen Dienst neu starten:====
 (sudo) systemctl restart svws 
 (sudo) systemctl restart mariadb

====Dienste Statusabfragen:====
 (sudo) systemctl status svws
 (sudo) systemctl status mariadb


= Verbindungen mit SVWS-Linux-Server per Win-Clients=

== MariaDB von „außen“ erreichbar machen: == 


====Server-Terminal auf Linux-Server:  ====
 sudo nano /etc/mysql/mariadb.conf.d/50-server.cnf
(''nano'' ist hier einer der vielen möglichen Editoren unter Linux.)
  
In dieser Datei in der Zeile:  

 bind-address: '''127.0.0.1''' auf '''0.0.0.0''' setzen, speichern  
  
    
====MariaDB neu starten: ==== 
 sudo systemctl restart mariadb



== SSH-Zugriff ermöglichen  ==

==== Linux-Server-Terminal====  

 (sudo) apt install openssh-server  
  
====Für Diagnosezwecke der Netzwerkkonfiguration:====  

 (sudo) apt install net-tools  

Bemerkung: Mit net-tools ist z.B. der Befehl `ifconfig` zum Ermitteln der Server-IP im Netzwerk ausführbar.
  


==Datenbank-Zugriff durch DBeaver==  

Verbindungseinstellungen auf dem Win-Client:  
1. SSH-Verbindung herstellen: <br />   

[[Datei:DBeaver_DatenbankVerbindung_1.png|500px|thumb|center|DBeaver]]

<br />  
IP: hostname oder IP-Adresse des DB-Servers  
Benutzer: superuser des Serversystems, z.B. root oder der bei der Installation vergebener Name  


'''Tunnelkonfiguration testen''' sollte diese Meldung liefern:
<br />  
[[Datei:DBeaver_Datenbankverbindung_2.png|500px|thumb|center|DBeaver]] 
<br />  

2.DB-Verbindung herstellen (Allgemein)
<br />  
[[Datei:DBeaver_DatenbankVerbindung_3.png|500px|thumb|center|DBeaver]] 
<br />  
Serverhost: '''localhost''', hier '''nicht die Server-IP''' eintragen, da durch die SSH-Verbindung bereits
der Zugriff auf dem Server gesteuert ist.  
Datenbankname: default ist svwsdb, DB-Name, der bei der svws-Server-Installation vergeben
wurde.  
 Benutzername: Benutzer der DB, default ist root  
 Passwort: DB-Passwort, nicht das des System-Superusers  

Verbindung testen: Möglicherweise erscheint eine Aufforderung zu einer Treiberinstallation.  
Dieser einfach folgen. Dann:  

[[Datei:DBeaver_DatenbankVerbindung_4.png|500px|thumb|center|DBeaver]]  



== Verbindung auf den Server mittels PUTTY:  ==
1. Einstellungen in PUTTY:  

[[Datei:Putty_Verbindung.png|500px|thumb|center|DBeaver]]  



Im Terminal dann als superuser des Server-Systems anmelden (Anmerkung: Das PW wird
nicht angezeigt, also tippen und Enter):
[[Datei:Putty_Client_Terminal.png|500px|thumb|center|DBeaver]]