Die DLE 2.1 Aktualisierung bietet eine modernere Entwicklungsumgebung, Unterstützung für höhere Sicherheitsstandards, verbesserte Kommandos, Datenbankerweiterungen, Geschwindigkeitsoptimierungen sowie aktualisierte Javabibliotheken (JAR-Dateien).
Wichtige Hinweise:
Wenn der Security Service vor dem Update nicht in der Session-Config aktiviert ist, müssen Sie nach dem Aktivieren, die Passwörter für Ihre administrativen Benutzerkonten einmalig neu setzen. Dadurch vermeiden Sie, dass Probleme auftreten nach dem Update beim Einloggen.
Wir empfehlen eine Datensicherung vor der Aktualisierung. Diese sollte die DLE-Datenbank sowie die DLE-Anwendungsdateien beinhalten.
Siehe dle.vision-flow.at/technische-details/technik/dle-java-api/reorganisation-von-bricks/
Deaktivieren Sie Dienste, welche DLE-Server überwachen und automatisch starten.
Abhängig vom Betriebssystem sollten Sie andere Benutzerkonten auf dem betroffenen DLE-Server-Computer abmelden, um gesperrte Ressourcen zu verhindern.
Windows: Taskmanager > Benutzer > andere "Abmelden"
Kontrollieren Sie unter Oracle in der Sessionconfig.xml folgende Property:
<Property name="JDBCDriver" value="oracle.jdbc.driver.OracleDriver" />
Fügen Sie es in der SessionConfig hinzu, falls dieser Eintrag nicht vorhanden ist.
DLE 2.1 erfordert JDK 8. Aktualisieren Sie Ihr DLE JDK im Verzeichnis DLE\java. Verwenden Sie mindestens JDK 1.8.0_191, da es bei älteren JDK-Versionen Kompatibilitätsprobleme mit SSL-TLS-Verschüsselung sowie Rootzertifikatanbietern gibt. Wir empfehlen die allerneueste JDK-Patchversion, da diese die beste Sicherheit und Leistung bietet.
Download: https://docs.aws.amazon.com/corretto/latest/corretto-8-ug/downloads-list.html
Extrahieren unter Linux:
Shell tar -zxvf amazon-corretto...tar.gz
Shell tar -xvf amazon-corretto...tar
Download: https://www.oracle.com/java/technologies/downloads/
Download: https://openjdk.java.net/
Abhängig von Ihrer Datenbankversion müssen Sie gegebenenfalls die JDBC-Datenbanktreiber aktualisieren, falls diese nicht zwischen Java 6 (DLE 2.0) und Java 8 (DLE 2.1) kompatibel sind. Dies betrifft u.a.:
| Datenbank | JDK 6 Treiber | JDK 8 Treiber | Anmerkung |
|---|---|---|---|
| Microsoft SQL Server | sqljdbc.jar | sqljdbc42.jar | |
| MySQL | mysql-connector-java-5.1.48.jar | mysql-connector-java-5.1.48.jar | |
| Oracle | ojdbc6.jar | ojdbc8-19.8.0.0.jar | |
Diese Aktualisierung ersetzt die DLE 2.0 Stammkomponenten durch jene der DLE 2.1. Dieser Vorgang muss nur einmalig ausgeführt werden.
Kopieren Sie die Datei update_DLE_V2.0_V2.1.zip nach DLE\install\updates.
Führen Sie folgende Kommandos in der Kommandozeile (Shell) aus.
Sie können die DLE-Datenbank sofort aktualisieren (empfohlen) oder eine SQL-DDL-Datei generieren und diese manuell mit einer DBMS-Software ausführen.
Abhängig von der DLE-Standarddatenbank, die im defaultConnector hinterlegt ist, müssen Sie ggfls. bestimmte Verbindungsparameter setzen.
<Service name="defaultConnectorMSSql">
<Property name="DatabaseRelease" value="2008" />
</Service>
Führen Sie folgenden SQL-DDL-Skript aus, um die Default-Constraints zu entfernen. Dieser Vorgang ist erforderlich, damit die VARCHAR-Spaltenlängen vergrößert werden können.
select 'ALTER TABLE ' + TAB.NAME + ' DROP CONSTRAINT ' + OBJ.NAME + ';' as DDL
from dbo.sysobjects OBJ
inner join sys.tables TAB on OBJ.PARENT_OBJ = TAB.OBJECT_ID
where OBJ.XTYPE = 'D'
order by 1
Die DLE aktualisiert die Datenbank sofort von Version 2.0 auf 2.1. Führen Sie folgende Kommandos in der Kommandozeile (Shell) aus.
Bei einer Log-O integrierten DLE muss man vor der Aktualisierung in der Datei DLE/client/SessionConfig.xml den im DefaultConnector den "User" dbuser mit sped ersetzen. Nach der Datenbankaktualisierung müssen Sie den Wert sped wieder auf dbuser zurücksetzen.
Diese Methode ändert die Datenbank nicht, sondern generiert eine *.sql-Datei im DLE-Tempverzeichnis. Führen Sie folgende Kommandos in der Kommandozeile (Shell) aus.
Unter bestimmte DLE-Versionen und Datenbankversionen müssen SQL-Hotfix-Skripte ausgeführt werden:
Führen Sie das Skript aus:
update DLEFUN set RIGHTFIELD = ' ', ORGTYPE = ' ', MODIFIEDDATE = sysdate, MODIFIEDUSER = 'admin' where RIGHTFIELD is null or ORGTYPE is null;
Eine Aktualisierung auf die aktuelle DLE 2.1 Version erfolgt mittels bereitgestelltem DLE-Update-ZIP.
Kopieren Sie die neueste Datei update_DLE_v2.1.X.XXX_YYYYMMDD.zip nach DLE\install\updates.
Installieren Sie die DLE 2.1 Aktualisierung.
Die folgenden Maßnahmen haben keinen unmittelbaren Bezug zum Aktualisierungsvorgang der DLE 2.1. Wir empfehlen dennoch, die folgenden Maßnahmen zu prüfen.
Wir empfehlen, in DLE/startupParams.xml den maximal zugesicherten Arbeitsspeicher auf mindestens 2 GB zu erhöhen.
<param value="Xmx2G" />
DLE 2.1 bietet neue Funktionen und Assistenten, welche Schreibzugriff auf das DLE-Installationsverzeichnis erfordern. Wir empfehlen, den Schreibzugriff auf das DLE-Installationsverzeichnis zu erweitern. Der erste Parameter sollte "~/temp" sein. "~" entspricht dem DLE-Instllationsverzeichnis.
<Property name="FileDirectories" value="~/temp;~/;~"/>
Wir empfehlen, die maximalen Anzahl der DLE-internen Worker in DLE/server/Serverconfig.xml auf die Anzahl der zeitgleich angemeldeten Anwender plus die Anzahl der Queues - typischerweise drei - plus einer Reserve von fünf, zu setzen. Dieser Wert ist abhängig von der Belastung.
Empfohlener Wert, wenn Sie bis zu 20 Mitarbeiter im Intranet haben:
<Property name="MaxWorkers" value="30" />
Empfohlener Wert, wenn Sie öffentlich verfügbare Webapps betreiben:
<Property name="MaxWorkers" value="100" />
Wir empfehlen, den DLE Security Service zu aktivieren. Dieser erfordert die Authentifizierung von DLE-Benutzern mit Kennwort. Sie sollten administrativen Benutzerkonten die Benutzergruppe "DLE Admin" zuweisen.
<Service name="SecurityService" class="at.visionflow.dle.engine.security.DLESecurityService">
<Properties>
<Property name="ByConflictForbidden" value="True" />
<Property name="NotDefinedRightsAllowed" value="False" />
<Property name="WithoutSecurity" value="False" />
<Property name="PublishDLEEnvironment" value="True" />
</Properties>
</Service>
Vor dem Update müssen Sie die Passwörter für Ihre administrative Benutzerkonten einmalig neu setzen. Dadurch vermeiden Sie, dass es Probleme auftreten nach dem Update beim Einloggen.
Wir empfehlen, den DLE Logger Service - nicht zu verwechseln mit dem DLE System Logger Service - zu deaktivieren. Sie können das betreffend XML-Element auskommentieren oder entfernen.
<Service name="LoggerService" class="at.visionflow.dle.engine.logging.DLELog4jLoggerService">
<Properties>
<Property name="level" value="warn" />
</Properties>
</Service>
In der Session-Config kann das Property <Property name="TestSystem" value="true" /> gesetzt werden, welches man die Systeme (z.b. Test- und Produktivsystem) unterscheiden kann.
Ein Mindestkomprimierungsverhältnis schützt in der DLE ZIP- und Excel-Dateien vor potenziellen Sicherheitslücken wie ZIP-Bomben.
Dafür wird im startupParams.xml <param value="Ddle.zip.minInflateRatio=0.005" /> eingetragen.
Die DLE-Softwareaktualisierung ist abgeschlossen. Starten Sie den DLE-Server wieder im regulären Betrieb.
Führen Sie in der DLE Online IDE den Menüpunkt Werkzeuge > Metadatenvalidierung aus. Wählen Sie das Paket DLE und kontrollieren Sie, ob die Datenbankaktualisierung fehlerfrei war.
In manchen Fällen gibt es Browsercache-Probleme nach einer DLE Softwareaktualisierung. Drücken Sie in diesem Fall STRG+SHIFT+R (Chrome, Firefox, Edge) oder STRG+F5 (Internet Explorer), um den Browsercache erzwungen zu aktualisieren.
Führen Sie in der DLE Online IDE den Menüpunkt Werkzeuge > Toolbricks > DLETools_DLE2_1_Update_BrickCompilierung aus.
Bestimmte DLE-Pakete sind zwischen DLE 2.0 und 2.1 inkompatibel. Diese müssen erneut installiert werden.
| Paket | Kompatibel? | Empfohlene Aktion |
|---|---|---|
| CBR | nein | Paket deinstallieren (löschen Sie das Verzeichnis DLE\packages\CBR) |
| DLECHART | ja | |
| DLEGEN | ja | |
| DPE | ja | |
| DTMS | ja | |
| DVIEW | nein | Paket erneut installieren |
| DWA | ja | |
| EDI | ja | |
| FLEETBOARD3 | ja | |
| MONITORING | ja | |
| OFFICE_INTEGRATION | ja | |
| TRULIOO | ja | |
| VFXFORM | ja | |
| VFXOES | ja | |
| VFXPDF | ja | |
| VFXWPS | ja | Ab der Version 1.8.5 müssen Sie jene Bricks, welches das Kommando "VFXWPS Portal" beinhalten, neu kompilieren |
| WEB | ja | |
| WEBMOBILE | ja |
Nach dem Update auf 2.1 muss der Datentyp "Datum" explizit im Kommando "Tabellengitter Spalte" gesetzt werden, um Fehler zu vermeiden.
Mögliche Ursache:
Bestimmte JAR-Dateien in DLE/lib/ konnten nicht aktualisiert werden oder haben eine andere Version als erwartet.
Lösung:
Stellen Sie sicher, dass JAR-Dateien in DLE/lib/ in der korrekten Version vorhanden sind.
Mögliche Ursache:
Falls der Fehler in einem DVIEW-Kontext auftritt: Aktualisieren Sie DVIEW auf die neueste Paketversion. Falls die neueste Version von DVIEW bereits installiert ist, installieren Sie diese Version erneut.
Mögliche Ursachen:
Lösung 1:
Lösung 2:
Lösung 3:
Ursache:
Dieses Problem tritt mitunter bei JDK 8 und Windows Server 2008 R2 auf.
Lösung:
Verwenden Sie Corretto 8 anstatt JDK 8.
Ab der Version 2.1.3 werden beim Update der DLE auch Datenbankänderungen (ALTER/CREATE Table-Statements) direkt von der Update-Routine ausgeführt. Dies bedeutet, dass der Datenbankbenutzer des default-Connectors der DLE die dafür notwendigen Rechte auf der Datenbank benötigt.
Es kann auch nur für die Dauer der Ausführung des Updates der Benutzer verändert werden.
Sollte die Rechtevergabe nicht möglich sein, dann können die SQL-Statements vom Vision-Flow Support erfragt werden, und müssen manuell vor dem Einspielen des Updates ausgeführt werden.
