Staxx Dokumentation - Benutzerbeiträge [de]

Systemanforderungen

2025-01-13T16:43:19Z

Hvr-support2:

Erfahrungsgemäß werden gute Ergebnisse mit Hardware mit folgender Spezifikation erzielt:

{| class="wikitable" style="width:100%;"
|-
! style="width:33%;" |
! style="width:33%;" | Client
! style="width:33%;" | Server
|-
| CPU
| 1.6 GHz, 2 Kerne
| 4 Kerne oder mehr
|-
|Betriebssystem
|Windows 10/11
|Windows und Linux
|-
| Festplattenspeicher*
| 50 MB
| 1.5 GB
|-
| RAM
| 600 MB oder mehr
| 8 GB oder mehr
|}

Folgende Mindestvoraussetzungen müssen gegeben sein:

{| class="wikitable" style="width:100%;"
|-
! style="width:33%;" |
! style="width:33%;" | Client
! style="width:33%;" | Server
|-
| CPU
| 1.6 GHz, 2 Kerne
| 2 Kerne
|-
|Betriebssystem
|Windows 10/11
|Windows und Linux
|-
| Festplattenspeicher*
| 50 MB
| 1.5 GB
|-
| RAM
| 400 MB
| 2 GB
|}
'''Hinweis''': ARM-CPUs werden für nur Beta-Weise unterstützt und es kann bei diesen zu Problemen kommen. Alle Angaben beinhalten nicht die Systemanforderungen weiterer Programme wie PDF24 und der PDF-XChange Editor.

<nowiki>*</nowiki> Dies sind nur die Anforderungen an die Programme StaXX und für den Server MySQL. Wird MySQL auf der selben Maschine wie der Client installiert summieren sich die Werte. Zudem sind die Angaben ohne den dynamischen Einfluss an Dokumenten.

Systemanforderungen

2025-01-13T16:38:08Z

Hvr-support2:

Erfahrungsgemäß werden gute Ergebnisse mit Hardware mit folgender Spezifikation erzielt:

{| class="wikitable" style="width:100%;"
|-
! style="width:33%;" |
! style="width:33%;" | Client
! style="width:33%;" | Server
|-
| CPU
| 1.6 GHz, 2 Kerne
| 4 Kerne oder mehr
|-
|Betriebssystem
|Windows 10/11
|Windows und Linux
|-
| Festplattenspeicher*
| 50 MB + 1 GB für PDF24
| 1.5 GB
|-
| RAM
| 600 MB oder mehr
| 8 GB oder mehr
|}

Folgende Mindestvoraussetzungen müssen gegeben sein:

{| class="wikitable" style="width:100%;"
|-
! style="width:33%;" |
! style="width:33%;" | Client
! style="width:33%;" | Server
|-
| CPU
| 1.6 GHz, 2 Kerne
| 2 Kerne
|-
|Betriebssystem
|Windows 10/11
|Windows und Linux
|-
| Festplattenspeicher*
| 50 MB + 1 GB für PDF24
| 1.5 GB
|-
| RAM
| 400 MB
| 2 GB
|}
'''Hinweis''': ARM-CPUs werden für nur Beta-Weise unterstützt und es kann bei diesen zu Problemen kommen.

<nowiki>*</nowiki> Dies sind nur die Anforderungen an die Programme StaXX und für den Server MySQL. Wird MySQL auf der selben Maschine wie der Client installiert summieren sich die Werte. Zudem sind die Angaben ohne den dynamischen Einfluss an Dokumenten.

Systemanforderungen

2025-01-13T16:29:05Z

Hvr-support2:

Erfahrungsgemäß werden gute Ergebnisse mit Hardware mit folgender Spezifikation erzielt:

{| class="wikitable" style="width:100%;"
|-
! style="width:33%;" |
! style="width:33%;" | Client
! style="width:33%;" | Server
|-
| CPU
| Windows 11/10 mit 1.6 GHz, 2 Kerne
| 4 Kerne oder mehr
|-
| Festplattenspeicher*
| 50 MB
| 1.5 GB
|-
| RAM
| 600 MB oder mehr
| 8 GB oder mehr
|}

Folgende Mindestvoraussetzungen müssen gegeben sein:

{| class="wikitable" style="width:100%;"
|-
! style="width:33%;" |
! style="width:33%;" | Client
! style="width:33%;" | Server
|-
| CPU
| Windows 11/10 mit 1.6 GHz, 2 Kerne
| 2 Kerne
|-
| Festplattenspeicher*
| 50 MB
| 1.5 GB
|-
| RAM
| 400 MB
| 2 GB
|}
'''Hinweis''': ARM-CPUs werden für nur Beta-Weise unterstützt und es kann bei diesen zu Problemen kommen.

<nowiki>*</nowiki> Dies sind nur die Anforderungen an das eigentliche Programm. Werden viele Daten (Dokumente) gepflegt wird entsprechend mehr Speicher benötigt.

Installation

2025-01-13T16:00:29Z

Hvr-support2:

==Installation==

Staxx kann als Einzelplatzinstallation (im folgenden mit '''lokal''' gekennzeichnet) oder als Server-Client-Applikation installiert werden. Bei der Einzelplatzinstallation werden alle erforderlichen Komponenten auf einem lokalen Gerät installiert. Bei der Server-Client-Installation werden die Datenbank und das File Repository (das Backend) auf dem Server installiert und auf den einzelnen Benutzer-Geräten lediglich der Staxx-Client (Frontend).

=== Datenbank und File Repository installieren (Backend) ===
Laden Sie das [https://haverion.de/staxx/downloads/ StaXX-Backend herunter]. Dieser hilft Ihnen bei der Installation der erforderlichen Komponenten, legt notwendige Einträge in der Datenbank ab und erstellt notwendige Ordnerstrukturen.

# Entpacken Sie die zip-Datei.
# Starten Sie die Datei StaXX-Backend-SetupWizard.exe im Unterordner staxx-backend.
# Durchlaufen Sie den Assistenten.

Sollten Sie gemäß Wizard Java und/oder die MySQL-Datenbank installieren, müssen Sie nach der Installation die Maschine neu starten. Anschließend starten Sie erneut den Backend-Wizard.

Nachstehend finden Sie Hinweise zur Installation der vorrausgesetzten Programme.

==== MySQL-Datenbank installieren ====
Staxx benutzt zur Speicherung der Daten eine MySQL-Datenbank. Diese kann je nach Anwendungsfall lokal (wenn als Einzelplatzinstallation installiert) oder auf einem Server (wenn als Server-Client installiert) installiert werden. Dabei ist zu beachten, dass es verschiedene Edition von MySQL gibt und nicht jede davon kostenlos ist. Die Anleitung bezieht sich auf die Installation der kostenlosen Community Edition. Falls bereits eine MySQL-Datenbank installiert ist, können die nachfolgenden Schritte zur Installation von MySQL übersprungen werden. Folgende Anleitung ist für das Betriebssystem Windows:
[[Datei:MySQL Download.png|mini]]

# Download der [https://downloads.mysql.com/archives/installer/ MySQL Community Edition] (unterstützte Versionen: '''8.0.20''' - '''8.0.28''')
#* '''Beachten''': Download der ''mysql-installer-community-$version$.msi'', nicht der web variante (größere Datei).
# MSI ausführen und die Installation "Custom" durchführen.
# Auszuwählende und zu installierende Produkte:
#* MySQL Server (notwendig)
#* MySQL Workbench (zu finden unter Applications) (optional, jedoch empfohlen)
#** Benutzeroberfläche um unter anderem mit den Datenbanken zu arbeiten. Es können jedoch auch alternative Tools benutzt werden (bspw. DBeaver).
# Anschließend auf "Execute" drücken und die Produkte und deren Requirements automatisch installieren lassen
# In den weiteren Schritten folgende Angaben in den Product Configurations machen:
#* Typ und Netzwerk[[Datei:Setup-Type and Networking.jpg|mini|286x286px|Schritt: Type and Networking]]
#** Typ
#*** Wenn StaXX nur '''lokal''' genutzt werden soll: Development Computer
#*** Wenn StaXX in einer '''Serverumgebung''' genutzt werden soll: Server Computer
#* Account and Roles:
#** MySQL Root Passwort: Geben Sie ein starkes Passwort ein. Dieses benötigen Sie gleich bei der weiteren Installation von StaXX.[[Datei:Setup-Accounts and Roles.jpg|mini|286x286px|Schritt: Accounts and Roles]]
#* Windows Service
#** dringend empfohlen, ansonsten muss der Service immer manuell gestartet werden
#* Führen Sie die Konfiguration durch "Execute" aus.
==== Weitere Hinweise zur Installation (werden vom Backend-Wizard automatisch ausgeführt, nur notwendig bei manueller Installation) ====

===== StaXX Datenbank =====
Wenn MySQL erfolgreich installiert ist, kann nun die Datenbank für Staxx erstellt werden. Hierzu wird der Root-Benutzer benötigt.

# [https://haverion.de/staxx/downloads/ Download des StaXX-Backend] und entpacken der zip-Datei.
# Ausführen von ''create-db-user.bat''
#* Der MySQL-Host ist die '''IP des Servers''' oder für eine lokale Installation '''localhost'''
#* Mehrfache Abfrage des Passworts vom Root-Benutzer
# Ausführen von ''run-liquibase.bat''
#* Es wird immer eine ''update.log'' generiert, welche in der Regel ignoriert werden kann
#* Bei Fehlern sollte eine ''rollback.log'' generiert werden. Falls das der Fall ist, stehen die entsprechenden Fehler in der ''update.log''
# Bei Bedarf können Demo-Daten mithilfe von ''init-demo.bat'' eingefügt werden ('''optional''')
# Programm Settings mithilfe von der MySQL Workbench, DBeaver, Shell, etc. einpflegen. Um Staxx starten zu können sind folgende Einstellungen notwendig, jedoch sollten für alle Einstellungen entsprechende Werte hinterlegt sein.
#* GENERAL_FILE_DIRECTORY
#* GENERAL_LICENSE_FILE
#* GENERAL_EXPLORER_SERVER_IP

===== Weitere Hinweise bei Problemen bei der Installation =====
Es kann vorkommen, dass beim Starten von Staxx eine Fehlermeldung mit ''[...] SELECT list is not in GROUP BY [...]'' kommt. Für diesen Fall kann ''fix-group-by-error.bat'' ausgeführt werden, um den Fehler zu beheben. Andernfalls muss die MySQL Konfiguration manuell angepasst werden.

'''Achtung:''' Wenn die Skripte nicht ausgeführt werden können, weil ''mysql'' nicht erkannt wird, muss mysql noch als Pfadvariable hinzugefügt werden. Zunächst prüfen, ob nach der Installation von mySQL der PC neu gestartet wurde! Falls dies nichts geändert hat, folgende Schritte befolgen.
[[Datei:Umgebungsvariablen.png|mini]]

# In der Windows Suche nach "Umgebungsvariablen" suchen und "'''Systemumgebungsvariablen bearbeiten'''" auswählen
# Im geöffneten Fenster auf Umgebungsvariablen klicken
# Die Variable '''Path''' bearbeiten. Entweder für den Benutzer, falls die Skripte ausschließlich von dem Benutzer ausgeführt werden, andernfalls die Systemvariable anpassen.
# Im neuen Fenster einen neuen Eintrag erstellen und dort das ''bin''-Verzeichnis hinterlegen (''C:\Program Files\MySQL\MySQL Server 8.0\bin''). Entsprechend anpassen, falls MySQL an anderer Stelle installiert wurde

=== Staxx installieren (Frontend) ===

# [https://haverion.de/staxx/downloads/ Download des Setups für den StaXX-Client.]
# Setup ausführen und Schritte befolgen
#* '''Datenbankserver:''' Es ist wichtig, dass hier eine IP angegeben wird und keine Domain
#** Für eine lokale Installation '''127.0.0.1''' und nicht <s>localhost</s> ('''lokal''')
# Staxx starten
Zum Anmelden in StaXX und für Weiteres folgen Sie der [[Schritt-für-Schritt-Anleitung]].

== Hinweise für ARM-PCs ==
ARM-CPUs sind beispielsweise der Snapdragon, der auf neuen Surface-Produkten (zum Beispiel Surface Laptop 7) genutzt wird. Aufgrund des Wechsels der CPU-Topologie werden viele Windows-Programme nicht mehr nativ ausgeführt, sondern emuliert. Dies gilt auch für StaXX. StaXX unterstützt ARM als Beta.

Nachstehend einige Hinweise

=== Starten von StaXX ===
[[File:ARM1.png|276x276px|rechts]]
[[File:ARM2.png|276x276px|rechts]]

Es empfiehlt sich, in der StaXX-Verknüpfung etwa auf dem Desktop folgende Eigenschaften einzustellen:
*'''Rechtsklick''' auf die Verknüpfung → Eigenschaften
*Aufrufen der Registerkarte "Kompatibilität"
*Im unteren Bereich Emulationseinstellungen ändern

*Anwählen „sehr strenge Ausführung“

Auf diese Weise sollte StaXX problemlos starten.

=== PDF-Reader ===
Beachten Sie die [[Empfohlene PDF-Reader#Wichtig für PCs auf ARM-Basis|Hinweise zur Installation von PDF-Readern]]!

Einrichten der MySQL-Workbench

2025-01-10T18:35:40Z

Hvr-support2:

=== Connection hinzufügen ===
Damit über MySQL-Workbench auf die Datenbank zugegriffen werden kann, muss zunächst eine Verbindung erstellt werden. Über diese Verbindung kann dann auf die Datenbank zugegriffen werden. Es ist dabei möglich mehrere Verbindungen zu erstellen damit der Zugriff auf unterschiedliche Hosts einfach möglich ist. So kann bspw. eine Verbindung für eine lokale MySQL-Datenbank und eine weitere für eine serverseitige Datenbank erstellt werden. So wird eine Verbindung erstellt:
[[Datei:Add MySQL-Connection.png|mini|Verbindung hinzufügen]]

# Auf der Hauptseite neben MySQL Connections auf das Plus drücken
# Verbindungsdaten angeben[[Datei:MySQL-Connection enter password.png|mini|Passwort angeben]]
## Name vergeben
## Hostname: IP des Servers oder für eine lokale Datenbank 127.0.0.1
## Username: Es kann hier der Root-User oder der StaXX-User benutzt werden
## Passwort: Das Passwort kann über den ersten Button eingegeben werden
# Fertigstellen über den OK-Button

Die Verbindung sollte nun in der Übersicht zu sehen sein.

=== Tabellen einsehen ===
[[Datei:Hide unnecessary panels.png|mini|Bereiche ausblenden]]
Über die Verbindung kann nun auf die Datenbank zugegriffen werden. In der Übersicht befinden sich bereits mehrere Bereiche, die ausgeblendet werden können, da diese nicht notwendig sind. Diese können über die Buttons rechts oben ausgeblendet werden. Dabei sollte der erste Bereich (links) nicht ausgeblendet werden, da dieser benötigt wird. So ist die Übersicht anschaulicher.
[[Datei:Show table.png|mini|Tabelle anzeigen]]
Schritte um die Tabelle einzusehen:

# Im Navigator Panel muss der Reiter "Schemas" ausgewählt werden
# In der Übersicht ist nun die Datenbank zu finden.
# Um die Tabelle einzusehen, muss über die entsprechende Tabelle gehovert und der Button ganz rechts gedrückt werden.

=== Daten ändern ===
Um die Daten in einer Tabelle zu ändern, kann direkt ein Wert in der Tabelle per Doppelklick oder über den "Form Editor" (rechts zu sehen) geändert werden. Anschließend kann über den "Apply"-Button gespeichert oder über den "Revert"-Button die Änderungen rückgängig gemacht werden.
[[Datei:Update table data.png|zentriert|mini|768x768px|Daten ändern]]

Einrichten der MySQL-Workbench

2025-01-10T18:34:58Z

Hvr-support2: Anleitung hinzugefügt

Datei:Update table data.png

2025-01-10T18:32:53Z

Hvr-support2:

update table data

Datei:Show table.png

2025-01-10T18:27:39Z

Hvr-support2:

show table

Datei:Hide unnecessary panels.png

2025-01-10T18:11:36Z

Hvr-support2:

Hide unnecessary panels

Datei:MySQL-Connection enter password.png

2025-01-10T17:48:57Z

Hvr-support2:

MySQL-Connection enter password

Datei:Add MySQL-Connection.png

2025-01-10T17:39:47Z

Hvr-support2:

Add MySQL-Connection

Installation

2025-01-10T13:59:02Z

Hvr-support2:

=='''Installation'''==

Staxx kann als Einzelplatzinstallation (im folgenden mit '''lokal''' gekennzeichnet) oder als Server-Client-Applikation installiert werden. Bei der Einzelplatzinstallation werden alle erforderlichen Komponenten auf einem lokalen Gerät installiert. Bei der Server-Client-Installation werden die Datenbank und das File Repository (das Backend) auf dem Server installiert und auf den einzelnen Benutzer-Geräten lediglich der Staxx-Client (Frontend).

=== Datenbank und File Repository installieren (Backend) ===
Laden Sie den StaXX-Backend-Wizard herunter. Dieser hilft Ihnen bei der Installation der erforderlichen Komponenten, legt notwendige Einträge in der Datenbank ab und erstellt notwendige Ordnerstrukturen.

# Entpacken Sie die zip-Datei.
# Starten Sie die Datei StaXX-Backend-SetupWizard.exe im Unterordner staxx-backend.
# Durchlaufen Sie den Assistenten.

Sollten Sie gemäß Wizard Java und/oder die MySQL-Datenbank installieren, müssen Sie nach der Installation die Maschine neu starten. Anschließend starten Sie erneut den Backend-Wizard.

Nachstehend finden Sie Hinweise zur Installation der vorrausgesetzten Programme.

==== MySQL-Datenbank installieren ====
Staxx benutzt zur Speicherung der Daten eine MySQL-Datenbank. Diese kann je nach Anwendungsfall lokal (wenn als Einzelplatzinstallation installiert) oder auf einem Server (wenn als Server-Client installiert) installiert werden. Dabei ist zu beachten, dass es verschiedene Edition von MySQL gibt und nicht jede davon kostenlos ist. Die Anleitung bezieht sich auf die Installation der kostenlosen Community Edition. Falls bereits eine MySQL-Datenbank installiert ist, können die nachfolgenden Schritte zur Installation von MySQL übersprungen werden. Folgende Anleitung ist für das Betriebssystem Windows:
[[Datei:MySQL Download.png|mini]]

# Download der [https://downloads.mysql.com/archives/installer/ MySQL Community Edition] (unterstützte Versionen: '''8.0.20''' - '''8.0.28''')
#* '''Beachten''': Download der ''mysql-installer-community-$version$.msi'', nicht der web variante (größere Datei).
# MSI ausführen und die Installation "Custom" durchführen.
# Auszuwählende und zu installierende Produkte:
#* MySQL Server (notwendig)
#* MySQL Workbench (zu finden unter Applications) (optional, jedoch empfohlen)
#** Benutzeroberfläche um unter anderem mit den Datenbanken zu arbeiten. Es können jedoch auch alternative Tools benutzt werden (bspw. DBeaver).
# Anschließend auf "Execute" drücken und die Produkte und deren Requirements automatisch installieren lassen
# In den weiteren Schritten folgende Angaben in den Product Configurations machen:
#* Typ und Netzwerk
#** Typ
#*** Wenn StaXX nur '''lokal''' genutzt werden soll: Development Computer
#*** Wenn StaXX in einer '''Serverumgebung''' genutzt werden soll: Server Computer
#* Root-Passwort:
#** Geben Sie ein starkes Passwort ein. Dieses benötigen Sie gleich bei der weiteren Installation von StaXX.
#* Windows Service
#** dringend empfohlen, ansonsten muss der Service immer manuell gestartet werden
#* Führen Sie die Konfiguration durch "Execute" aus.[[Datei:Setup-Type and Networking.jpg|mini|410x410px|Schritt: Type and Networking|zentriert]][[Datei:Setup-Accounts and Roles.jpg|mini|410x410px|Schritt: Accounts and Roles|zentriert]]
==== Weitere Hinweise zur Installation (werden vom Backend-Wizard automatisch ausgeführt) ====

===== StaXX Datenbank =====
Wenn MySQL erfolgreich installiert ist, kann nun die Datenbank für Staxx erstellt werden. Hierzu wird der Root-Benutzer benötigt.

# Download von (''noch einfügen'')
# Ausführen von ''create-db-user.bat''
#* Der MySQL-Host ist die '''IP des Servers''' oder für eine lokale Installation '''localhost'''
#* Mehrfache Abfrage des Passworts vom Root-Benutzer
# Ausführen von ''run-liquibase.bat''
#* Es wird immer eine ''update.log'' generiert, welche in der Regel ignoriert werden kann
#* Bei Fehlern sollte eine ''rollback.log'' generiert werden. Falls das der Fall ist, stehen die entsprechenden Fehler in der ''update.log''
# Bei Bedarf können Demo-Daten mithilfe von ''init-demo.bat'' eingefügt werden ('''optional''')
# Programm Settings mithilfe von der MySQL Workbench, DBeaver, Shell, etc. einpflegen. Um Staxx starten zu können sind folgende Einstellungen notwendig, jedoch sollten für alle Einstellungen entsprechende Werte hinterlegt sein.
#* GENERAL_FILE_DIRECTORY
#* GENERAL_LICENSE_FILE
#* GENERAL_EXPLORER_SERVER_IP

'''Hinweis:''' Es kann vorkommen, dass beim Starten von Staxx eine Fehlermeldung mit ''[...] SELECT list is not in GROUP BY [...]'' kommt. Für diesen Fall kann ''fix-group-by-error.bat'' ausgeführt werden, um den Fehler zu beheben. Andernfalls muss die MySQL Konfiguration manuell angepasst werden (s. ''hier link einfügen'').

'''Achtung:''' Wenn die Skripte nicht ausgeführt werden können, weil ''mysql'' nicht erkannt wird, muss mysql noch zu Pfadvariable hinzugefügt werden. Dazu folgende Schritte befolgen.
[[Datei:Umgebungsvariablen.png|mini]]

# In der Windows Suche nach "Umgebungsvariablen" suchen und "'''Systemumgebungsvariablen bearbeiten'''" auswählen
# Im geöffneten Fenster auf Umgebungsvariablen klicken
# Die Variable '''Path''' bearbeiten. Entweder für den Benutzer, falls die Skripte ausschließlich von dem Benutzer ausgeführt werden, andernfalls die Systemvariable anpassen.
# Im neuen Fenster einen neuen Eintrag erstellen und dort das ''bin''-Verzeichnis hinterlegen (''C:\Program Files\MySQL\MySQL Server 8.0\bin''). Entsprechend anpassen, falls MySQL an anderer Stelle installiert wurde

=== Staxx installieren (Frontend) ===

# Download des Setups (''link hier einfügen'')
# Setup ausführen und Schritte befolgen
#* '''Datenbankserver:''' Es ist wichtig, dass hier eine IP angegeben wird und keine Domain
#** Für eine lokale Installation '''127.0.0.1''' und nicht <s>localhost</s> ('''lokal''')
# Staxx starten
Zum Anmelden in StaXX und für Weiteres folgen Sie der [[Schritt-für-Schritt-Anleitung]].

Installation

2025-01-10T13:57:59Z

Hvr-support2:

=='''Installation'''==

Staxx kann als Einzelplatzinstallation (im folgenden mit '''lokal''' gekennzeichnet) oder als Server-Client-Applikation installiert werden. Bei der Einzelplatzinstallation werden alle erforderlichen Komponenten auf einem lokalen Gerät installiert. Bei der Server-Client-Installation werden die Datenbank und das File Repository (das Backend) auf dem Server installiert und auf den einzelnen Benutzer-Geräten lediglich der Staxx-Client (Frontend).

=== Datenbank und File Repository installieren (Backend) ===
Laden Sie den StaXX-Backend-Wizard herunter. Dieser hilft Ihnen bei der Installation der erforderlichen Komponenten, legt notwendige Einträge in der Datenbank ab und erstellt notwendige Ordnerstrukturen.

# Entpacken Sie die zip-Datei.
# Starten Sie die Datei StaXX-Backend-SetupWizard.exe im Unterordner staxx-backend.
# Durchlaufen Sie den Assistenten.

Sollten Sie gemäß Wizard Java und/oder die MySQL-Datenbank installieren, müssen Sie nach der Installation die Maschine neu starten. Anschließend starten Sie erneut den Backend-Wizard.

Nachstehend finden Sie Hinweise zur Installation der vorrausgesetzten Programme.

==== MySQL-Datenbank installieren ====
Staxx benutzt zur Speicherung der Daten eine MySQL-Datenbank. Diese kann je nach Anwendungsfall lokal (wenn als Einzelplatzinstallation installiert) oder auf einem Server (wenn als Server-Client installiert) installiert werden. Dabei ist zu beachten, dass es verschiedene Edition von MySQL gibt und nicht jede davon kostenlos ist. Die Anleitung bezieht sich auf die Installation der kostenlosen Community Edition. Falls bereits eine MySQL-Datenbank installiert ist, können die nachfolgenden Schritte zur Installation von MySQL übersprungen werden. Folgende Anleitung ist für das Betriebssystem Windows:
[[Datei:MySQL Download.png|mini]]

# Download der [https://downloads.mysql.com/archives/installer/ MySQL Community Edition] (unterstützte Versionen: '''8.0.20''' - '''8.0.28''')
#* '''Beachten''': Download der ''mysql-installer-community-$version$.msi'', nicht der web variante (größere Datei).
# MSI ausführen und die Installation "Custom" durchführen.
# Auszuwählende und zu installierende Produkte:
#* MySQL Server (notwendig)
#* MySQL Workbench (zu finden unter Applications) (optional, jedoch empfohlen)
#** Benutzeroberfläche um unter anderem mit den Datenbanken zu arbeiten. Es können jedoch auch alternative Tools benutzt werden (bspw. DBeaver).
# Anschließend auf "Execute" drücken und die Produkte und deren Requirements automatisch installieren lassen
# In den weiteren Schritten folgende Angaben in den Product Configurations machen:
#* Typ und Netzwerk
#** Typ
#*** Wenn StaXX nur '''lokal''' genutzt werden soll: Development Computer
#*** Wenn StaXX in einer '''Serverumgebung''' genutzt werden soll: Server Computer
#* Root-Passwort:
#** Geben Sie ein starkes Passwort ein. Dieses benötigen Sie gleich bei der weiteren Installation von StaXX.
#* Windows Service
#** dringend empfohlen, ansonsten muss der Service immer manuell gestartet werden
#* Führen Sie die Konfiguration durch "Execute" aus.[[Datei:Setup-Type and Networking.jpg|links|mini|410x410px|Schritt: Type and Networking]][[Datei:Setup-Accounts and Roles.jpg|mini|410x410px|Schritt: Accounts and Roles]]

==== Weitere Hinweise zur Installation (werden vom Backend-Wizard automatisch ausgeführt) ====

===== StaXX Datenbank =====
Wenn MySQL erfolgreich installiert ist, kann nun die Datenbank für Staxx erstellt werden. Hierzu wird der Root-Benutzer benötigt.

# Download von (''noch einfügen'')
# Ausführen von ''create-db-user.bat''
#* Der MySQL-Host ist die '''IP des Servers''' oder für eine lokale Installation '''localhost'''
#* Mehrfache Abfrage des Passworts vom Root-Benutzer
# Ausführen von ''run-liquibase.bat''
#* Es wird immer eine ''update.log'' generiert, welche in der Regel ignoriert werden kann
#* Bei Fehlern sollte eine ''rollback.log'' generiert werden. Falls das der Fall ist, stehen die entsprechenden Fehler in der ''update.log''
# Bei Bedarf können Demo-Daten mithilfe von ''init-demo.bat'' eingefügt werden ('''optional''')
# Programm Settings mithilfe von der MySQL Workbench, DBeaver, Shell, etc. einpflegen. Um Staxx starten zu können sind folgende Einstellungen notwendig, jedoch sollten für alle Einstellungen entsprechende Werte hinterlegt sein.
#* GENERAL_FILE_DIRECTORY
#* GENERAL_LICENSE_FILE
#* GENERAL_EXPLORER_SERVER_IP

'''Hinweis:''' Es kann vorkommen, dass beim Starten von Staxx eine Fehlermeldung mit ''[...] SELECT list is not in GROUP BY [...]'' kommt. Für diesen Fall kann ''fix-group-by-error.bat'' ausgeführt werden, um den Fehler zu beheben. Andernfalls muss die MySQL Konfiguration manuell angepasst werden (s. ''hier link einfügen'').

'''Achtung:''' Wenn die Skripte nicht ausgeführt werden können, weil ''mysql'' nicht erkannt wird, muss mysql noch zu Pfadvariable hinzugefügt werden. Dazu folgende Schritte befolgen.
[[Datei:Umgebungsvariablen.png|mini]]

# In der Windows Suche nach "Umgebungsvariablen" suchen und "'''Systemumgebungsvariablen bearbeiten'''" auswählen
# Im geöffneten Fenster auf Umgebungsvariablen klicken
# Die Variable '''Path''' bearbeiten. Entweder für den Benutzer, falls die Skripte ausschließlich von dem Benutzer ausgeführt werden, andernfalls die Systemvariable anpassen.
# Im neuen Fenster einen neuen Eintrag erstellen und dort das ''bin''-Verzeichnis hinterlegen (''C:\Program Files\MySQL\MySQL Server 8.0\bin''). Entsprechend anpassen, falls MySQL an anderer Stelle installiert wurde

=== Staxx installieren (Frontend) ===

# Download des Setups (''link hier einfügen'')
# Setup ausführen und Schritte befolgen
#* '''Datenbankserver:''' Es ist wichtig, dass hier eine IP angegeben wird und keine Domain
#** Für eine lokale Installation '''127.0.0.1''' und nicht <s>localhost</s> ('''lokal''')
# Staxx starten
Zum Anmelden in StaXX und für Weiteres folgen Sie der [[Schritt-für-Schritt-Anleitung]].

Installation

2025-01-09T12:02:46Z

Hvr-support2: weitere Screenshots für die MySQL Installation

=='''Installation'''==

Staxx kann als Einzelplatzinstallation (im folgenden mit '''lokal''' gekennzeichnet) oder als Server-Client-Applikation installiert werden. Bei der Einzelplatzinstallation werden alle erforderlichen Komponenten auf einem lokalen Gerät installiert. Bei der Server-Client-Installation werden die Datenbank und das File Repository (das Backend) auf dem Server installiert und auf den einzelnen Benutzer-Geräten lediglich der Staxx-Client (Frontend).

=== Datenbank und File Repository installieren (Backend) ===
Laden Sie den StaXX-Backend-Wizard herunter. Dieser hilft Ihnen bei der Installation der erforderlichen Komponenten, legt notwendige Einträge in der Datenbank ab und erstellt notwendige Ordnerstrukturen.

# Entpacken Sie die zip-Datei.
# Starten Sie die Datei StaXX-Backend-SetupWizard.exe im Unterordner staxx-backend.
# Durchlaufen Sie den Assistenten.

Sollten Sie gemäß Wizard Java und/oder die MySQL-Datenbank installieren, müssen Sie nach der Installation die Maschine neu starten. Anschließend starten Sie erneut den Backend-Wizard

Nachstehend finden Sie Hinweise zur Installation der vorrausgesetzten Programme.

==== MySQL-Datenbank installieren ====
Staxx benutzt zur Speicherung der Daten eine MySQL-Datenbank. Diese kann lokal sowie auf einem Server installiert werden. Dabei ist zu beachten, dass es verschiedene Edition von MySQL gibt und nicht jede davon kostenlos ist. Die Anleitung bezieht sich auf die Installation der kostenlosen Community Edition. Falls bereits eine MySQL-Datenbank installiert ist, können die nachfolgenden Schritte zur Installation von MySQL übersprungen werden. Folgende Anleitung ist für das Betriebssystem Windows:
[[Datei:MySQL Download.png|mini]]

# Download der [https://downloads.mysql.com/archives/installer/ MySQL Community Edition] (unterstützte Versionen: '''8.0.20''' - '''8.0.28''')
#* '''Beachten''': Download der ''mysql-installer-community-$version$.msi'', nicht der web variante (größere Datei).
# MSI ausführen und die Installation "Custom" durchführen.
# Auszuwählende und zu installierende Produkte:
#* MySQL Server (notwendig)
#* MySQL Workbench (zu finden unter Applications) (optional, jedoch empfohlen)
#** Benutzeroberfläche um unter anderem mit den Datenbanken zu arbeiten. Es können jedoch auch alternative Tools benutzt werden (bspw. DBeaver).
# Anschließend auf "Execute" drücken und die Produkte und deren Requirements automatisch installieren lassen
# In den weiteren Schritten folgende Angaben in den Product Configurations machen:
#* Typ und Netzwerk
#** Typ
#*** Wenn StaXX nur '''lokal''' genutzt werden soll: Development Computer
#*** Wenn StaXX in einer '''Serverumgebung''' genutzt werden soll: Server Computer
#* Root-Passwort:
#** Geben Sie ein starkes Passwort ein. Dieses benötigen Sie gleich bei der weiteren Installation von StaXX.
#* Windows Service
#** dringend empfohlen, ansonsten muss der Service immer manuell gestartet werden
#* Führen Sie die Konfiguration durch "Execute" aus.[[Datei:Setup-Type and Networking.jpg|links|mini|400x400px|Schritt: Type and Networking]][[Datei:Setup-Accounts and Roles.jpg|mini|400x400px|Schritt: Accounts and Roles]]

==== Weitere Hinweise zur Installation (werden vom Backend-Wizard automatisch ausgeführt) ====

===== StaXX Datenbank =====
Wenn MySQL erfolgreich installiert ist, kann nun die Datenbank für Staxx erstellt werden. Hierzu wird der Root-Benutzer benötigt.

# Download von (''noch einfügen'')
# Ausführen von ''create-db-user.bat''
#* Der MySQL-Host ist die '''IP des Servers''' oder für eine lokale Installation '''localhost'''
#* Mehrfache Abfrage des Passworts vom Root-Benutzer
# Ausführen von ''run-liquibase.bat''
#* Es wird immer eine ''update.log'' generiert, welche in der Regel ignoriert werden kann
#* Bei Fehlern sollte eine ''rollback.log'' generiert werden. Falls das der Fall ist, stehen die entsprechenden Fehler in der ''update.log''
# Bei Bedarf können Demo-Daten mithilfe von ''init-demo.bat'' eingefügt werden ('''optional''')
# Programm Settings mithilfe von der MySQL Workbench, DBeaver, Shell, etc. einpflegen. Um Staxx starten zu können sind folgende Einstellungen notwendig, jedoch sollten für alle Einstellungen entsprechende Werte hinterlegt sein.
#* GENERAL_FILE_DIRECTORY
#* GENERAL_LICENSE_FILE
#* GENERAL_EXPLORER_SERVER_IP

'''Hinweis:''' Es kann vorkommen, dass beim Starten von Staxx eine Fehlermeldung mit ''[...] SELECT list is not in GROUP BY [...]'' kommt. Für diesen Fall kann ''fix-group-by-error.bat'' ausgeführt werden, um den Fehler zu beheben. Andernfalls muss die MySQL Konfiguration manuell angepasst werden (s. ''hier link einfügen'').

'''Achtung:''' Wenn die Skripte nicht ausgeführt werden können, weil ''mysql'' nicht erkannt wird, muss mysql noch zu Pfadvariable hinzugefügt werden. Dazu folgende Schritte befolgen.
[[Datei:Umgebungsvariablen.png|mini]]

# In der Windows Suche nach "Umgebungsvariablen" suchen und "'''Systemumgebungsvariablen bearbeiten'''" auswählen
# Im geöffneten Fenster auf Umgebungsvariablen klicken
# Die Variable '''Path''' bearbeiten. Entweder für den Benutzer, falls die Skripte ausschließlich von dem Benutzer ausgeführt werden, andernfalls die Systemvariable anpassen.
# Im neuen Fenster einen neuen Eintrag erstellen und dort das ''bin''-Verzeichnis hinterlegen (''C:\Program Files\MySQL\MySQL Server 8.0\bin''). Entsprechend anpassen, falls MySQL an anderer Stelle installiert wurde

=== Staxx installieren (Frontend) ===

# Download des Setups (''link hier einfügen'')
# Setup ausführen und Schritte befolgen
#* '''Datenbankserver:''' Es ist wichtig, dass hier eine IP angegeben wird und keine Domain
#** Für eine lokale Installation '''127.0.0.1''' und nicht <s>localhost</s> ('''lokal''')
# Staxx starten
Zum Anmelden in StaXX und für Weiteres folgen Sie der [[Schritt-für-Schritt-Anleitung]].

Datei:Setup-Accounts and Roles.jpg

2025-01-09T11:55:57Z

Hvr-support2:

MySQL: Schritt Setup-Accounts and Roles

Datei:Setup-Type and Networking.jpg

2025-01-09T11:52:55Z

Hvr-support2:

mysql setup: Setup-Type and Networking

Datei:MySQL Download.png

2025-01-09T11:45:30Z

Hvr-support2: Hvr-support2 lud eine neue Version von Datei:MySQL Download.png hoch

Download des MySQL Installers

Installation

2024-12-08T16:55:15Z

Hvr-support2:

'''Installation'''

Staxx kann als Einzelplatzinstallation (im folgenden mit '''lokal''' gekennzeichnet) oder als Server-Client-Applikation installiert werden. Bei der Einzelplatzinstallation werden alle erforderlichen Komponenten auf einem lokalen Gerät installiert. Bei der Server-Client-Installation werden die Datenbank und das File Repository auf dem Server installiert und auf den einzelnen Benutzer-Geräten lediglich der Staxx-Client.

=== Datenbank installieren ===

==== MySQL ====
Staxx benutzt zur Speicherung der Daten eine MySQL-Datenbank. Diese kann lokal sowie auf einem Server installiert werden. Dabei ist zu beachten, dass es verschiedene Edition von MySQL gibt und nicht jede davon kostenlos ist. Die Anleitung bezieht sich auf die Installation der kostenlosen Community Edition. Falls bereits eine MySQL-Datenbank installiert ist, können die nachfolgenden Schritte zur Installation von MySQL übersprungen werden. Folgende Anleitung ist für das Betriebssystem Windows:
[[Datei:MySQL Download.png|mini]]

# Download der [https://downloads.mysql.com/archives/installer/ MySQL Community Edition] (Version '''8.0.20''' - '''8.0.28''')
#* Es wird empfohlen die aktuellste Version zu nutzen
#* '''Beachten''': Download der ''mysql-installer-community-$version$.msi'', nicht der web variante.
# MSI ausführen (es können fast immer die vorgegebenen Werte genutzt werden)
#* Produkte:
#** MySQL Server (notwendig)
#** MySQL Workbench (optional, jedoch empfohlen)
#*** Benutzeroberfläche um unter anderem mit den Datenbanken zu arbeiten. Es können jedoch auch alternative Tools benutzt werden (bspw. DBeaver).
#* Typ und Netzwerk
#** Typ
#*** Development Computer ('''lokal''')
#*** Server Computer ('''Server''')
#* Windows Service
#** dringend empfohlen, ansonsten muss der Service immer manuell gestartet werden

===== Staxx Datenbank =====
Wenn MySQL erfolgreich installiert ist, kann nun die Datenbank für Staxx erstellt werden. Hierzu wird der Root-Benutzer benötig.

# Download von (''noch einfügen'')
# Ausführen von ''create-db-user.bat''
#* Der MySQL-Host ist die '''IP des Servers''' oder für eine lokale Installation '''localhost'''
#* Mehrfache Abfrage des Passworts vom Root-Benutzer
# Ausführen von ''run-liquibase.bat''
#* Es wird immer eine ''update.log'' generiert, welche in der Regel ignoriert werden kann
#* Bei Fehlern sollte eine ''rollback.log'' generiert werden. Falls das der Fall ist, stehen die entsprechenden Fehler in der ''update.log''
# Bei Bedarf können Demo-Daten mithilfe von ''init-demo.bat'' eingefügt werden ('''optional''')
# Programm Settings mithilfe von der MySQL Workbench, DBeaver, Shell, etc. einpflegen. Um Staxx starten zu können sind folgende Einstellungen notwendig, jedoch sollten für alle Einstellungen entsprechende Werte hinterlegt sein.
#* GENERAL_FILE_DIRECTORY
#* GENERAL_LICENSE_FILE
#* GENERAL_EXPLORER_SERVER_IP

'''Hinweis:''' Es kann vorkommen, dass beim Starten von Staxx eine Fehlermeldung mit ''[...] SELECT list is not in GROUP BY [...]'' kommt. Für diesen Fall kann ''fix-group-by-error.bat'' ausgeführt werden, um den Fehler zu beheben. Andernfalls muss die MySQL Konfiguration manuell angepasst werden (s. ''hier link einfügen'').

'''Achtung:''' Wenn die Skripte nicht ausgeführt werden können, weil ''mysql'' nicht erkannt wird, muss mysql noch zu Pfadvariable hinzugefügt werden. Dazu folgende Schritte befolgen.
[[Datei:Umgebungsvariablen.png|mini]]

# In der Windows Suche nach "Umgebungsvariablen" suchen und "'''Systemumgebungsvariablen bearbeiten'''" auswählen
# Im geöffneten Fenster auf Umgebungsvariablen klicken
# Die Variable '''Path''' bearbeiten. Entweder für den Benutzer, falls die Skripte ausschließlich von dem Benutzer ausgeführt werden, andernfalls die Systemvariable anpassen.
# Im neuen Fenster einen neuen Eintrag erstellen und dort das ''bin''-Verzeichnis hinterlegen (''C:\Program Files\MySQL\MySQL Server 8.0\bin''). Entsprechend anpassen, falls MySQL an anderer Stelle installiert wurde

=== Anwendung (Staxx) installieren ===

# Download des Setups (''link hier einfügen'')
# Setup ausführen und Schritte befolgen
#* '''Datenbankserver:''' Es ist wichtig, dass hier eine IP angegeben wird und keine Domain
#** Für eine lokale Installation '''127.0.0.1''' und nicht <s>localhost</s> ('''lokal''')
# Staxx starten

* Einzelplatzinstallation
* Server-Client-Installation
** Anforderungen an die IT-Umgebung
* Lizenz einlesen

Installation

2024-12-05T19:04:55Z

Hvr-support2: Grundgerüst der Installation

'''Installation'''

Staxx kann als Einzelplatzinstallation (im folgenden mit '''lokal''' gekennzeichnet) oder als Server-Client-Applikation installiert werden. Bei der Einzelplatzinstallation werden alle erforderlichen Komponenten auf einem lokalen Gerät installiert. Bei der Server-Client-Installation werden die Datenbank und das File Repository auf dem Server installiert und auf den einzelnen Benutzer-Geräten lediglich der Staxx-Client.

=== Datenbank installieren ===

==== MySQL ====
Staxx benutzt zur Speicherung der Daten eine MySQL-Datenbank. Diese kann lokal sowie auf einem Server installiert werden. Dabei ist zu beachten, dass es verschiedene Edition von MySQL gibt und nicht jede davon kostenlos ist. Die Anleitung bezieht sich auf die Installation der kostenlosen Community Edition. Falls bereits eine MySQL-Datenbank installiert ist, können die nachfolgenden Schritte zur Installation von MySQL übersprungen werden. Folgende Anleitung ist für das Betriebssystem Windows:
[[Datei:MySQL Download.png|mini]]

# Download der [https://dev.mysql.com/downloads/installer/ MySQL Community Edition]
#* Es wird empfohlen die aktuellste Version zu nutzen
#* '''Beachten''': Download der ''mysql-installer-community-$version$.msi'', nicht der web variante.
# MSI ausführen (es können fast immer die vorgegebenen Werte genutzt werden)
#* Produkte:
#** MySQL Server (notwendig)
#** MySQL Workbench (optional, jedoch empfohlen)
#*** Benutzeroberfläche um unter anderem mit den Datenbanken zu arbeiten. Es können jedoch auch alternative Tools benutzt werden (bspw. DBeaver).
#* Typ und Netzwerk
#** Typ
#*** Development Computer ('''lokal''')
#*** Server Computer ('''Server''')
#* Windows Service
#** dringend empfohlen, ansonsten muss der Service immer manuell gestartet werden

===== Staxx Datenbank =====
Wenn MySQL erfolgreich installiert ist, kann nun die Datenbank für Staxx erstellt werden. Hierzu wird der Root-Benutzer benötig.

# Download von (''noch einfügen'')
# Ausführen von ''create-db-user.bat''
#* Der MySQL-Host ist die '''IP des Servers''' oder für eine lokale Installation '''localhost'''
#* Mehrfache Abfrage des Passworts vom Root-Benutzer
# Ausführen von ''run-liquibase.bat''
#* Es wird immer eine ''update.log'' generiert, welche in der Regel ignoriert werden kann
#* Bei Fehlern sollte eine ''rollback.log'' generiert werden. Falls das der Fall ist, stehen die entsprechenden Fehler in der ''update.log''
# Bei Bedarf können Demo-Daten mithilfe von ''init-demo.bat'' eingefügt werden ('''optional''')
# Programm Settings mithilfe von der MySQL Workbench, DBeaver, Shell, etc. einpflegen. Um Staxx starten zu können sind folgende Einstellungen notwendig, jedoch sollten für alle Einstellungen entsprechende Werte hinterlegt sein.
#* GENERAL_FILE_DIRECTORY
#* GENERAL_LICENSE_FILE
#* GENERAL_EXPLORER_SERVER_IP

'''Hinweis:''' Es kann vorkommen, dass beim Starten von Staxx eine Fehlermeldung mit ''[...] SELECT LIST is not in Group by [...]'' kommt. Für diesen Fall kann ''fix-group-by-error.bat'' ausgeführt werden, um den Fehler zu beheben. Andernfalls muss die MySQL Konfiguration manuell angepasst werden (s. ''hier link einfügen'').

'''Achtung:''' Wenn die Skripte nicht ausgeführt werden können, weil ''mysql'' nicht erkannt wird, muss mysql noch zu Pfadvariable hinzugefügt werden. Dazu folgende Schritte befolgen.
[[Datei:Umgebungsvariablen.png|mini]]

# In der Windows Suche nach "Umgebungsvariablen" suchen und "'''Systemumgebungsvariablen bearbeiten'''" auswählen
# Im geöffneten Fenster auf Umgebungsvariablen klicken
# Die Variable '''Path''' bearbeiten. Entweder für den Benutzer, falls die Skripte ausschließlich von dem Benutzer ausgeführt werden, andernfalls die Systemvariable anpassen.
# Im neuen Fenster einen neuen Eintrag erstellen und dort das ''bin''-Verzeichnis hinterlegen (''C:\Program Files\MySQL\MySQL Server 8.0\bin''). Entsprechend anpassen, falls MySQL an anderer Stelle installiert wurde

=== Anwendung (Staxx) installieren ===

# Download des Setups (''link hier einfügen'')
# Setup ausführen und Schritte befolgen
#* '''Datenbankserver:''' Es ist wichtig, dass hier eine IP angegeben wird und keine Domain
#** Für eine lokale Installation '''127.0.0.1''' und nicht <s>localhost</s> ('''lokal''')
# Staxx starten

* Einzelplatzinstallation
* Server-Client-Installation
** Anforderungen an die IT-Umgebung
* Lizenz einlesen

Datei:Umgebungsvariablen.png

2024-12-05T18:48:06Z

Hvr-support2:

Fenster zum bearbeiten von den Umgebungsvariablen

Datei:MySQL Download.png

2024-12-05T17:46:05Z

Hvr-support2:

Download des MySQL Installers