...
Bitte prüfen Sie mit Hilfe des Dokuments Systemanforderungen, ob die bei Ihnen gegebene Infrastruktur aktuell ist. Sollte dies nicht der Fall sein, passen Sie die Infrastruktur bitte an, bevor Sie mit der ATP-Installation beginnen.
Installationsdateien
In Ihrem Auslieferungspaket sollten Sie nach dem Entpacken folgende Ordnerstruktur vorfinden:
- Datenbankskripte
- <„MSSql|Oracle-create.sql-Skript“>
- < ggf. weitere Skripte mit Nummerierung >
- Deployment
- <atp>.war
- <dac6>.war
Installation der Datenbank
- Die Schritte zur Einrichtung sind an dieser Stelle allgemein gehalten, um den unterschiedlichen Konfigurationen der Datenbanksysteme gerecht zu werden.
- Erstellen Sie zwei neue Datenbank/Datenbankschemata auf dem Datenbankserver. Eins für das AMANA Tax Portal, das zweite für das DAC 6 Modul.
- Erstellen Sie einen Datenbankbenutzer mit Berechtigung zum „INSERT“, „UPDATE“, „DELETE“, „ALTER“, „CREATE“ auf diese Datenbank.
- Unter SQL Server benötigt der Anwender die Datenbankrollen db_datareader, db_datawriter und ein Rolle zur Ausführung von Stored Procedures, z.B.: db_executor:
CREATE ROLE db_executor
GO
GRANT EXECUTE TO db_executor
GO
- Unter SQL Server benötigt der Anwender die Datenbankrollen db_datareader, db_datawriter und ein Rolle zur Ausführung von Stored Procedures, z.B.: db_executor:
- Stellen Sie sicher, dass vom sich der Applikationsserver aus mit diesem Benutzer auf die Datenbank zugegriffen werden kann. Wenn Sie den SQL Server mit Windows Authentisierung nutzen, muss der Tomcat-Dienst unter einem Domänen-Account laufen und dieser Domänen-Account in der Datenbank als User konfiguriert werden. Laden Sie aus dem Internet die sqljdbc_auth.dll des Microsoft JDBC-Treibers sqljdbc_6.2 herunter und kopieren Sie sie in das bin-Verzeichnis des TomcatBenutzer zur Datenbank verbinden kann.
- Bitte stellen sie sicher, dass ein aktuelles JDBC-Treiberpaket, passend zu ihrem DBMS und der eingesetzten Java-Version, im Lib-Verzeichnis des Tomcats befindet.
- Zur Aktualisierung des Datenbankschemas stehen zwei Varianten zur Verfügung:
- Automatisch
Über die integrierte Datenbankmigration (siehe Konfiguration des "Tomcat 8.5" Punkt 2b) - Manuell
Manuelle Einspielung der im Installationspaket enthaltenen Datenbankskripte
- Automatisch
- Bitte klären Sie im Vorfeld, welche Variante Sie bei Ihnen eingesetzt werden soll.
- Führen Sie die in Ihrer Auslieferung enthaltenen Skripte zur Erstellung der Datenbank auf dieser aus.
- Achten Sie darauf, dass der User, der die DB-Skripte einspielt, alle Rechte auf der Datenbank des ATP und DAC6 hat.
...
- Führen Sie nach der Installation die Applikation „->Startmenü->Tomcat->“configure tomcat“ Datei "tomcat8w.exe" im bin Verzeichnis des Tomcats aus.
- Führen Sie folgende Schritte durch:
- Tab „General“: Stellen Sie den Start des Dienstes auf automatisch.
- Tab „Java“: Im Feld „Java Options“ fügen Sie die Zeile "-XX:PermSize=256m" und "-XX:MaxPermSize=512m" ein
- Falls Sie die automatische Datenbankmigration aus den Applikationen nutzen wollen, fügen Sie bitte zusätzlich die folgenden folgende Parameter im Feld "Java Options" ein:
- "-Datp.db.migration=auto"
- für den ATP
- "-Ddac6.db.migration=auto" für DAC 6
- Tab „Java“: Im Feld "Initial Memory Pool" tragen Sie „128“ "512" ein
- Tab „Java“: Im Feld "Maximum Memory Pool" tragen Sie ca. die Hälfte des verfügbaren physikalischen Arbeitsspeichers ein. Als Minimum empfehlen wir jedoch "2048". Bedenken Sie bitte bei 32-Bit-Systemen die Beschränkung des Arbeitsspeichers auf ca. 3,5 GB. Die hier gemachten Speichereinstellungen beeinflussen die Performance und Lauffähigkeit der Applikation. Unter Umständen sind diese bei wachsender Benutzung im Laufe der Zeit anzupassen.
...