In dieser Dokumentation wird die Installation des ERP-Systems auf Windows und Microsoft SQL-Server beschrieben.

Zielgruppe

• Systemadministratoren
• Technische Berater
• Programmierer

Voraussetzungen

Einen Überblick über die erforderlichen Komponenten und den Systemaufbau des ausgelieferten Systems finden Sie in der Dokumentation „Systemanforderungen“.

Als Betriebssystem wird eine korrekte Installation von Microsoft Windows Server 2012R2 oder neuer vorausgesetzt. Das Netzwerk muss so eingerichtet sein, dass die Namensauflösung des Rechnernamens möglich ist. Installieren Sie die aktuell verfügbaren Service Packs.

Als Datenbank-Management-System (DBMS) wird Microsoft SQL Server 2012 oder neuer vorausgesetzt. Installieren Sie die aktuellen Service Packs für den SQL-Server.

Für die Installation des ERP-Systems benötigen Sie temporär 20 GB freien Speicherplatz.

Konventionen

Behalten Sie die vorgegebenen Verzeichnisstrukturen bei, um bei der parallelen Installation mehrerer Systeme eine einheitliche Struktur zu gewährleisten. Die Konventionen sind in der Dokumentation „Namenskonventionen“ beschrieben.

Der in dieser Dokumentation verwendete Systemname „SYSTEMNAME“ ist ein Platzhalter, der durch den korrekten Namen gemäß der erhaltenen Lizenz zu ersetzen ist.

Umgebungsvariablen einrichten

Bei einer Erstinstallation müssen System-Umgebungsvariablen angepasst werden um einen reibungslosen Betrieb zu ermöglichen.

Temporäres Verzeichnis

1. Erstellen Sie das Verzeichnis „C:\temp“.
2. Stellen Sie die System-Umgebungsvariablen „TMP“ und „TEMP“ zumindest für das Benutzerkonto, mit dem der ERP-System-Application-Server (SAS) oder der ERP-System-Output-Manager (SOM) ausgeführt werden, auf dieses Verzeichnis um.

Pfad zu SQL Server 2012 Tools

1. Fügen Sie den folgenden Pfad, der zu den SQL Server 2012 Tools führt, zu Ihrer Pfad-Umgebungsvariable hinzu: C:\Program Files\Microsoft SQL Server\110\Tools\Binn
2. Passen Sie den Pfad entsprechend Ihrer Installation des SQL Server 2012 an.

AdoptOpenJDK installieren

Das ERP-System ist in der Programmiersprache Java^TM entwickelt und benötigt daher als Laufzeitumgebung und zur Weiterentwicklung ein Java Development Kit (JDK). Das ausgelieferte JDK von AdoptOpen hat zum Zeitpunkt der Erstellung dieser Dokumentation die Version jdk-11.0.10+9.

Die im Folgenden beschriebene Vorgehensweise zur Installation des Java JDKs ist bei einer Erstinstallation notwendig oder wenn sich die Version des ausgelieferten JDKs ändert.

JDK

Bitte laden Sie sich die aktuelle JDK Version x64 für Windows unter https://adoptopenjdk.net/ herunter.

Installieren Sie die heruntergeladene Datei in das Verzeichnis „C:\comarch\java\jdk-11.0.10+9-64“.

Aktualisierung der Public Java Runtime Environment

Neben den für den Betrieb eines SAS notwendigen Java Executables im Installationsverzeichnis wird auch die Public Java Runtime Environment während der Installation in das Verzeichnis „C:\Programme\Java\“ kopiert. Diese Version wird z. B. von Browsern als Plug-In verwendet. Für die Public Java Runtime Environment wird ein Programm installiert, das in regelmäßigen Abständen prüft, ob neue Versionen oder Security Patches der Public Java Runtime Environment auf der Homepage von Oracle zur Verfügung stehen.

Die Aktualisierung der Public Java Runtime Environment beeinflusst das ERP-System nicht, da die Inhalte des von einem SAS verwendeten Verzeichnisses dabei nicht geändert werden.

Gehen Sie wie folgt vor um die Aktualisierung der Public Java Runtime Environment zu vermeiden:

• Verzichten Sie bei der Installation des JDK auf die Installation der-Java Runtime Environment. Deaktivieren Sie dazu bei der Auswahl der zu installierenden Komponenten den Punkt „Public JRE“. Wählen Sie für diesen Punkt die Option „Don’t install this feature now“.
• Wenn Sie die Public Java Runtime Environment bereits installiert haben, deaktivieren Sie die regelmäßige Prüfung für neue Updates über die Einstellungen des Java Update-Programms.

ERP-System installieren

Verzeichnisse erstellen

Sie benötigen ca. 20 GB freien Speicherplatz für die gepackte „semiramis.zip“-Datei, die Datenbankexporte und das entpackte CEE-Verzeichnis.

Sie erhalten die Auslieferung als Archiv „CEE630PA-Partnersystem.zip“ zum Download auf dem Comarch FTP. Dieses enthält eine Datei „semiramis.zip mit dem Programmcode, sowie weitere Verzeichnisse mit Installationsskripten, Datenbankexporten und Dokumentationen. Die Datei „semiramis.zip“ enthält eine große Anzahl Dateien, die z. B. mit WinZip oder auch dem mit neueren Windows-Versionen ausgelieferten Pack-Programm fehlerhaft entpackt werden können. Die Datei wird im weiteren Verlauf der Installation automatisch mithilfe des Programms „jar“ entpackt.

Vorgehensweise

1. Erstellen Sie das Verzeichnis „C:\comarch\CEE630PA“.
2. Entpacken Sie das heruntergeladene ZIP-Archiv in dieses Verzeichnis.

Die ausgelieferten Datenbankinhalte und Datenbankbenutzer werden per Skriptaufruf wiederhergestellt. Sie benötigen zur Installation mindestens 20 GB freien Speicherplatz.

Lizenzdatei bereitstellen

Stellen Sie die Lizenzdatei in dem entpackten Verzeichnis C:\comarch\CEE630PA\install\licence bereit.

Installations-Skript erzeugen

Rufen Sie in einer command-Shell folgenden Befehl auf:

C:\comarch\CEE630PA\install\scripts\windows\crtsem.cmd

Das Skript erwartet folgende Parameter:

• Java-Home-Verzeichnis (C:\comarch\java\11.0.10+9-64)
• Systemnamen gemäß Lizenz (SYSTEMNAME)
• Name der Lizenzdatei. Die Lizenzdatei muss auf dem üblichen Weg über das Support Center erworben werden und in das Unterverzeichnis „licence“ kopiert werden.
• Kennwort für die Lizenzdatei
• Datenbanktyp (MSSQL)
• Zielverzeichnis, in dem das CEE-Verzeichnis eingerichtet werden soll. Ist dieses Verzeichnis nicht vorhanden, dann erstellt das Skript automatisch dieses Verzeichnis sowie sämtliche übergeordneten Verzeichnisse.
• Zielverzeichnis, in dem später die physikalischen Datenbankdateien erstellt werden sollen

Vorgehensweise

1. Starten Sie eine command-Shell und wechseln Sie mit dem folgenden Befehl in das entsprechende Verzeichnis: cd /D C:\comarch\CEE630PA\install\scripts\windows.
2. Führen Sie in dem Verzeichnis den Befehl „crtsem“ mit den benötigten Parametern aus:
   crtsem C:\comarch\java\jdk-11.0.10+9-64 SYSTEMNAME LIZENZNAME LIZENZPWD MSSQL C:\comarch\SYSTEMNAME c:\sql_server_data

• Das CEE-Verzeichnis wird aus der Datei „semiramis.zip“ entpackt.
• Ein Installations-Skript wird erzeugt, das die erforderlichen Informationen zur Anlage von Datenbanken und Benutzern enthält.
• Das Skript wird ausgeführt. Die Datenbanken und Datenbankbenutzer werden automatisch eingerichtet.
• Die Log-Dateien und die zum Import erzeugten SQL-Skripte können Sie in den Verzeichnissen „%TEMP%\SYSTEMNAME-log“ und „%TEMP%\SYSTEMNAME-tmp“ einsehen.

Das Skript legt folgende Benutzer und Kennwörter an:

Die Benutzer werden jeweils als „database_owner (dbo)“ angelegt. Weitere Benutzer, die mit einem SQL-Server arbeiten möchten, können über das SQL Server Management Studio angelegt werden.

Wenn das Quellen-Verzeichnis (source) auf einem Netzlaufwerk liegt, kann der Befehl „sqlcmd“ zur Wiederherstellung nicht auf dieses Laufwerk zugreifen.

ERP-System-Application-Server starten

1. Starten Sie eine command-Shell.
2. Wechseln Sie mit folgendem Befehl in das Arbeitsverzeichnis des SAS: cd /D C:\comarch\SYSTEMNAME\semiramis\servers\MESSAGESERVER
3. Führen Sie das folgende Skript aus, um den SAS zu starten: strsas-messageserver.cmd

• Der SAS legt Log-Dateien in folgendes Verzeichnis ab:

C:\comarch\SYSTEMNAME\semiramis\servers\MESSAGESERVER\log

Datenbankinformationen erzeugen

Vor der ersten Anmeldung am System müssen die Datenbankinformationen, erzeugt werden.

Führen Sie dazu auf dem gestarteten SAS folgende Befehle aus:

crtdbinf –configuration –repository

crtdbinf –oltp –nlsAutomatic

Am ERP-System anmelden

Die erstmalige Anmeldung am System erfolgt über die URL http://localhost mit Hilfe des Benutzernamens „ADMINISTRATOR“ und des Kennworts welches durch das Skript crtsem.cmd generiert und auf der Konsole ausgegeben wird.

Neues System einrichten

Durch die ausgelieferten Installationsskripte wurde bereits die angegebene Lizenz in der Konfigurationsdatenbank installiert und ein entsprechendes System angelegt.

Nach erfolgreicher Anmeldung kann über die Anwendung „Systemcockpit“, die weitere Einrichtung des Systems vorgenommen werden.

Weitere Informationen zur Inbetriebnahme finden Sie in der Dokumentation „Installationsanleitung“.

• ERP-System-Application-Server als Windows Dienst

Starten Sie Ihren ERP-System-Application-Server (SAS) als Windows Dienst.

Zertifikate erstellen

Wenn Sie für die Anmeldung eine gesicherte Verbindung nutzen wollen, müssen Sie dafür Zertifikate erstellen.

ERP-System deinstallieren

1. Stoppen Sie alle SAS, die über die zu löschenden Datenbankbenutzer auf die Datenbank zugreifen. Die Daten eines Benutzers können nicht gelöscht werden, solange er noch mit der Datenbank verbunden ist.
2. Starten Sie das SQL Server Management Studio.
3. Löschen Sie alle Datenbanken des zu löschenden Systems. Die Datendateien und Log-Dateien können dabei aus dem Dateisystem gelöscht werden.
4. Löschen Sie die Anmeldungen, die zu den Datenbanken des ERP-Systems gehören (SYSTEMNAMEyy).
5. Für den Fall, dass Dienste angelegt wurden, vgl. Kapitel 10, müssen diese über das entsprechenden Skript „UnInstallSemiramisServer.bat“, im Pfad „C:\comarch\SYSTEMNAME\semiramis\servers\MESSAGESERVER\service“, deinstalliert werden.
6. Löschen Sie die Dateien, die Sie im Verzeichnis „C:\comarch\SYSTEMNAME“ gespeichert haben.

• Das ERP-System ist deinstalliert.