Zum Hauptinhalt springen

Installation

Die aktuelle Version des Installationspakets ist unter software.one-unity.de zu finden.

Installation On-Premise​

success

Bevor Sie mit der Installation anfangen, sollte ein aktuelles Backup vorhanden sein! Zusätzlich sollten alle Portalskripte als XML-Export gespeichert werden.

gefahr

Unbedingt die Installationsvoraussetzungen vorab prüfen!

  1. Aktuelles Installationspaket herunterladen und entpacken (Installationsverzeichnis)

Datenbank​

Im Installationsverzeichnis befinden sich unter dem Ordner Database jeweils:

  • mssql.onpremise.sql
  • mssql.sql (Nur bei Versionen < VERSION_NEXT)
  • mariadb.onpremise.sql
  • mariadb.sql (Nur bei Versionen < VERSION_NEXT)

Je nach Datenbanksystem müssen die beiden entsprechenden .sql-Dateien ausgeführt werden. Hierbei muss unbedingt die *.onpremise.sql-Datei zuerst ausgeführt werden.

Microsoft SQL-Server (mssql)​

vorsicht

Es muss vorab (z.B. über das SQL Server Management Studio) die "ptpData"-Datenbank nach den jeweiligen Best Practices (siehe Confluence) erstellt werden. Hierzu kann als Vorlage die mssql.onpremise.sql-Datei genutzt werden - diese ist nur für die initiale Erstellung der Datenbank relevant.

Die Dateien (mssql.*.sql) können über das SQL Server Management Studio ausgeführt werden.

MariaDB​

vorsicht

Es muss vorab (z.B. über DBeaver) die "ptpData"-Datenbank nach den jeweiligen Best Practices (siehe Confluence) erstellt werden. Hierbei ist unbedingt auf das korrekte Charset (utf8mb4) und Collation (utf8mb4_general_ci) zu achten! Hierzu kann als Vorlage die mariadb.onpremise.sql-Datei genutzt werden - diese ist nur für die initiale Erstellung der Datenbank relevant.

Die Dateien (mariadb.*.sql) können über DBeaver ausgeführt werden.

ODBC-Verbindung erstellen​

Anschließend muss eine ODBC-Quelle angelegt werden, welche auf das ptpData-Schema verweist.

gefahr

Wichtiger Hinweis: Schritte VOR dem XML-Import

Direkt nach dem Erstellen der ousp bzw. ptpData-Datenbank und vor dem XML-Import müssen neben dem Anlegen der passenden ODBC-Quelle zwingend folgende Vorbereitungen durchgeführt werden:

  1. Die DB-Zugangsdaten müssen entweder
    • über das OUD PowerShell-Skript (env.ps1) angelegt oder
    • in Schritt 2 im cust-Skript direkt eingetragen werden.
  2. Im Skript ou.spc.library.dbConnections überprüfen, ob die hinterlegten Datenbankverbindungen so richtig sind – wenn nicht, ein zugehöriges Cust-Skript ou.cust.library.dbConnections erstellen und die nötigen Anpassungen durchführen (letzteres wird meistens der Fall sein, weil als dbSystem standardmäßig "mariadb" hinterlegt ist).

Erst wenn diese Voraussetzungen erfüllt sind, darf der XML-Import gestartet werden!

documents​

XML-Import​

Als letzten Schritt muss im documents-Manager die ousp-invoice-install.xml importiert werden.

  • Im Documents-Manager unter Servereinstellungen / XML-Import
  • In das Installationsverzeichnis/XML wechseln und die ousp-invoice-install.xml auswählen

Installer-Output prüfen​

In den documentsserver-Logs muss anschließend geprüft werden, ob die Installation über den Installer erfolgreich und ohne Fehler verlief.

Dateninstallation​

In documents mit dem Administrationsuser anmelden und im "Administration"-Dashboard auf die Kachel "Invoice installieren" klicken. Dieser Vorgang legt einige Mappen an, wie z.B. Standard-Steuercodes.

Archivkonfiguration​

Weiter geht es optional mit der Archivkonfiguration: otris EAS / Adaptive Schema

warnung

Für Neuinstallationen sollte bei EASY Archive nur noch Adaptives Schema verwendet werden.