Stand: 28.01.2022, Ecipse 2021-12-R

Voraussetzung:

Datenbank-Rolle anlegen als User postgres

sudo su postgres

psql

CREATE ROLE tad;  
alter role tad with password 'tad';  
alter role tad login;  
alter role tad SUPERUSER;

Anschließend den Rechner neu starten, um die neue Rolle zu aktivieren.

Datenbak anlegen

sudo su postgres

psql

create database openz;

Datenbank-Dump importieren

OpenZ-Enterprise Kunden nutzen einen beliebigen Datenbank-Dump, der mit pg_dump erzeugt wurde (z.B. aus Ihrem Produktiv-System)
Community-Nutzer finden den zu den Sourcen passenden Datenbank-Dump in den Sourcen in der Virtuellen Machine unter /home/zisoft/openz/openz.sql. Alternativ liegt in der VM unter /var/lib/postgresql/testcompany.sql ein Datenbank-Dump mit Testdaten.

psql openz < /*pfad zu*/openz.sql

Empfehlung: Tomcat bei Entwicklungsmaschinen nicht aus den Paketen installieren:  Download von Apache 9 direkt auf https://tomcat.apache.org/download-90.cgi

Entpacken nach /home/*user*/tomcat/

In /tomcat/bin/catalina.sh Zeile 295 anpassen
UMASK=”0022″

In /tomcat/conf/tomcat-users.xml Zeile 55 einfügen:

<role rolename="manager-gui"/>
<role rolename="manager"/>
<role rolename="admin"/>
<user password="a" roles="admin,manager,manager-gui" username="admin"/>

Umgebungsvariablen

In /etc/environment müssen die folgenden Variablen eingefügt werden.

JAVA_HOME="/usr/lib/jvm/java-11-openjdk-amd64/"
CATALINA_HOME="/*pfad zu*/tomcat"
CATALINA_BASE="/*pfad zu*/tomcat"
OPENZ_GITPT="/tmp/"
OPENZ_GITOSS="/*pfad zu*/openz/"

Sourcen mit ant Kompilieren

Ja nachdem, welche Version in der Datenbank ist, muss ggf. vorher ein Update vorgenommen werden. In der Distribution (virtuelle Maschine) passen Datenbank und Sourcen zusammen. Dann fällt folgender Schritt weg. Der folgende Schritt kann nur mit OpenZ-Enterprise (Update Lizenz) durchgeführt werden.

Wenn man eine Datenbank (z.B. aus dem eigenen Produktiv-System nutzt und Sourcen einer neueren OpenZ-Version hat, passen die Datenbank-Version und die Version der Sourcen nicht zusammen. In diesem Fall die Datei openz-update.jar (zu Finden im Kunden Download Bereich) nach $OPENZ_GITOSS/lib/runtime/ kopieren. Dann Update auf der DEV-Maschine unter ROOT mit:

java -cp "$OPENZ_GITOSS/lib/runtime/*" com.openz.update.ImportModule DISTRI "$OPENZ_GITOSS/config/Openbravo.properties"

1. Kompilieren der Src-Core unter dem Entwicklungs-User

ant core.lib

2. Kompilieren der Src-trl

 ant trl.lib

3. Kompilieren der Src-Wad

ant wad.lib

4. Kompilieren des gesamten Sourcecodes

ant compile.complete

1. Schritt: Eclipse herunterladen und entpacken

tar -xzvf ./eclipse(version).tar.gz

2. Schritt: Eclipse öffnen

Workspace wählen und bestätigen

3. Schritt: Projekt anlegen

Window -> Preferences -> Java -> installed JRE’s überprüfen / setzen

Window -> Preferences -> Server -> Runtime-Environment: Apache Tomcat 9 hinzufügen. o.a. Installation-Directory angeben.

File -> New -> Dynamic Web Project

Pfad zu den Sourcen der entpackten OpenZ-Distribution angeben:

Target runtime: Apache Tomcat v9.0

Dynamic web module version: 4.0 (das wird später noch angepasst)

Configuration: Default Configuration for Apache Tomcat v9.0

Danach im Menü Project -> Build automatically aus.

4. Schritt: Build Path einpflegen

4.1 Window -> Preferences

4.2 Java -> Build Path

User Libraries -> New… Namen „Openz“ eingeben, Add External JARs…

browsen auf Lib -> runtime

Alles auswählen und bestätigen

5. Schritt:  Importieren der Sourcen

Folgende Ordner müssen dem Build-Path hinzugefügt werden:

Alle mit src bezeichneten Unterordner in ..modules (Siehe Bild)

So muss es aussehen. Wichtig sind die Unterordner src, srcAD, src-gen, src-core/src, build/javasqlc/src und build/javasqlc/srcAD

6. Schritt: Validation aus / Build an

Window -> Preferences -> Validation -> Suspend all Validators

Project -> Properties -> Java Build Path -> Libraries -> Add Library -> User Library -> openz hinzufügen

Project -> Properties -> Java Compiler -> Compiler compliance Level 1.8 setzen

Project -> Properties -> Project Facets -> Java 1.8 setzen

Project -> Properties -> Project Facets -> Dynamic Web Module 3.1 setzen

Project -> Build automatically an

ggf. unter Project Properties, Build Path Apache, JRE System Library und OpenZ user Library zuordnen.

7. Schritt: Web-Server einrichten(Apache Tomcat)

Anpassen der Einstellungen des Tomcats (unten um Menü unter Server auf den Link klicken, um einen neuen Server zu konfigurieren)

Die launch configuration anpassen (Doppelklick auf den erstellten Server)

Publishing -> never publish automatically

Server Location -> Use Tomcat installation

Timeout Werte erhöhen: 

Start: 60

Stop: 30

8. Schritt: Jasper Studio:
Menue
Help -> Eclipse Marketplace: Jasper Studio suchen und install klicken.

Window -> Preferences -> Jaspersoft Studio: Compatiblity

JasperReport 6.1.1 einstellen

Fertig.