Als Entwicklungsumgebung für das CRM kommt das Bundle Java / Eclipse / Tomcat zum Einsatz. Die Installation funktioniert wie folgt:

Installation

Java

  • Java OpenJDK 11 installieren (Link)
  • Unter Windows: curl, 7zip und notepad++ installieren

Tomcat 8.5

Das Tomcat-Verzeichnis wird das zentrale Installationsverzeichnis. Hier landen später alle Servlets sowie das Plugin-Verzeichnis mit der App&Run-Laufzeitumgebung

  • Tomcat Application Server (Link)
    Entweder per Installer als Dienst installieren oder die Binaries in C:\Entwicklung\Tomcat und von dort per Hand starten
  • Verzeichnis <Tomcat-Pfad>\app-and-run anlegen
    -> hier kommen die kompilierten Plugins rein
  • In tomcat8w.exe Java-Parameter -Dfile.encoding=UTF-8 setzen
    In tomcat8w.exe die jvm.dll von (jdk11)\server\jvm.dll setzen
  • Umgebungsvariable APP_AND_RUN_APP_DEPLOY_PATH=<Tomcat-Pfad>\app-and-run setzen

Zusätzlich für Kunden-Laufzeitumgebungen

  • <Tomcat-Pfad>\upgrade-app-and-run.cmd ausführen (Vorlage in gyp-webserver01 C:\Program Files\Tomcat 8.5\upgrade-app-and-run.cmd)
    ACHTUNG: ausführen als administrator wg. net stop/start
  • Leere <Tomcat-Pfad>\app-and-run\config.properties anlegen
  • Datenbanken in C:\APP\Tomcat 8.5\conf\context.xml konfigurieren
jdbc/sysadm = Verwaltung App-And-Run (identisch mit grw-Datenbank)
jdbc/fibgs-AppTenant--(Kundenkürzel) = fibgs-Datenbank
jdbc/gyrebu-AppTenant--(Kundenkürzel) = grw-Datenbank
Beispiel:
<Resource
name="jdbc/sysadm"
auth="Container"
type="javax.sql.DataSource"
factory="org.apache.tomcat.jdbc.pool.DataSourceFactory"
defaultAutoCommit="false"
initialSize="0"
maxActive="100"
maxIdle="10"
minIdle="0"
timeBetweenEvictionRunsMillis="340000"
minEvictableIdleTimeMillis="550000"
validationQuery="SELECT 1"
validationInterval="340000"
testOnBorrow="true"
removeAbandoned="true"
removeAbandonedTimeout="600"
username="fibgs"
password="fibgs"
driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver"
url="jdbc:sqlserver://gyp-kds01.gypsilon.de:1433;DatabaseName=F_gypsilon90_gyRebu90"
/>
<Resource
name="jdbc/fibgs-AppTenant--gypsilon"
auth="Container"
type="javax.sql.DataSource"
factory="org.apache.tomcat.jdbc.pool.DataSourceFactory"
defaultAutoCommit="false"
initialSize="0"
maxActive="100"
maxIdle="10"
minIdle="0"
timeBetweenEvictionRunsMillis="340000"
minEvictableIdleTimeMillis="550000"
validationQuery="SELECT 1"
validationInterval="340000"
testOnBorrow="true"
removeAbandoned="true"
removeAbandonedTimeout="600"
username="fibgs"
password="fibgs"
driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver"
url="jdbc:sqlserver://gyp-kds01.gypsilon.de:1433;DatabaseName=F_gyV90"
/>
<Resource
name="jdbc/gyrebu-AppTenant--gypsilon"
auth="Container"
type="javax.sql.DataSource"
factory="org.apache.tomcat.jdbc.pool.DataSourceFactory"
defaultAutoCommit="false"
initialSize="0"
maxActive="100"
maxIdle="10"
minIdle="0"
timeBetweenEvictionRunsMillis="340000"
minEvictableIdleTimeMillis="550000"
validationQuery="SELECT 1"
validationInterval="340000"
testOnBorrow="true"
removeAbandoned="true"
removeAbandonedTimeout="600"
username="fibgs"
password="fibgs"
driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver"
url="jdbc:sqlserver://gyp-kds01.gypsilon.de:1433;DatabaseName=F_gypsilon90_gyRebu90"
/>

Zusätzlich für Entwicklungsumgebungen

Verzeichnisse

  • Verzeichnis C:\Entwicklung anlegen
    (hier kommen Quellen und Programminstallationen rein)

VPN

  • OpenVPN-kompatibler VPN-Zugang (z.B. OpenVPN oder Sophos VPN)
    Zertifikate und Key von CMU

Eclipse

  • aktuelles Eclipse installieren (Link)
  • Zusätzliche Plugins aus dem Eclipse Marketplace (Menü Help / Eclipse Marketplace)
    • Eclipse PDE (Plugin-Entwicklung)
    • findbugs (statische Code-Analyse)
    • Vaadin Plugin for Eclipse (Oberflächen-Framework)
    • sonarlint (statische Code-Analyse)
    • Jaspersoft Studio (Reporting)
  • Eclipse Updatesite
    • Ivy (Dependency Managment) (Link)
  • manuell ins Eclipse/Dropins-Verzeichnis kopieren
    • -> gwtappbuilder.jar (liegt im svn)

Tortoise svn (optional)

  • Tortoise svn-Client für Windows (Link)
  • svn-Client für Linux (Link)
  • svn checkout von svn://10.8.0.1/bmr/dev/project/app-and-run in C:\Entwicklung\app-and-run

Ant (optional)

  • wenn man lokal alle Plugins kompileren möchte, dann wird Apache Ant benötigt (Link)
    Ant-Verzeichnis in <Tomcat-Pfad>\ant entpacken und die Umgebungsvariablen wie im Link beschrieben setzen

MySql

  • aktuellen MySql-Server installieren (Link)

Eclipse einrichten

Preferences

in Eclipse im Menü Windows / Preferences

  • Ant / Runtime / Properties
    app-and-run -> <Tomcat-Pfad>\app-and-run
    war-deployment -> <Tomcat-Pfad>\webapps
  • Compiler-Settings
    -> auf workspace (nicht projektindividuell), compliency-settings 11
  • Java / Codestyle / Formater
    -> bmr.xml aus app-and-run importieren
  • General / Keys -> KeyBindings einstellen (bzw. prüfen, ob die nicht durch etwas anderes überlagert sind)
    -> F9 build-app-and-run
    -> SHIFT-F9 rebuild-app-and-run
    -> CTRL-R  duplicate lines

 

Entwicklungsumgebung installieren