Installation auf Linux

Themenübersicht

In dieser Dokumentation wird die Installation eines Comarch-ERP-Enterprise- Installationssystems auf Oracle Linux sowie eines Oracle Datenbankmanagementsystems beschrieben. Der Installationsvorgang ist bei beiden Distributionen gleich.

Zielgruppe

  • Systemadministratoren
  • Technische Berater
  • Entwickler, die Comarch ERP installieren

Voraussetzungen

Einen Überblick über die erforderlichen Komponenten sowie die unterstützten Linux- und Oracle-Versionen erhalten Sie in der Dokumentation Systemvoraussetzungen.

Als Betriebssystem wird eine korrekte Installation Oracle Linux vorausgesetzt. Das Netzwerk muss so eingerichtet sein, dass die Namensauflösung des Rechnernamens möglich ist.

Als Datenbank-Management-System (DBMS) wird für die in dieser Dokumentation dargestellte Vorgehensweise das DBMS von Oracle vorausgesetzt. Eine Installationsanleitung, die auch Einstellungen für Comarch ERP Enterprise berücksichtigt, finden Sie in der Hilfe zum Thema „Datenbank-Management-Systeme installieren“.

Ein Benutzer „oracle“ muss eingerichtet worden und in der Lage sein, sich mit dem folgenden Befehl an der Datenbank anzumelden:

sqlplus sys/yourpassword@orcl as sysdba

Der Instanz-Name oder SID „ORCL“ für die Identifikation der Datenbankinstanz ist in der exportierten „Configuration“ hinterlegt und daher als SID für die Installation und den Betrieb des Installationssystems erforderlich.

Sie benötigen temporär 30 GB freien Speicherplatz für die Installationsdateien und das installierte System.

Verwenden Sie zur Installation den Benutzer „root“ oder einen Benutzer der

„root“-Gruppe.

Wir empfehlen, die Installation in der nachfolgenden Reihenfolge vorzunehmen.

  1. Überprüfen Sie die für Oracle Linux und Oracle DBMS genannten Voraussetzungen.
  2. Bringen Sie Ihr System gegebenenfalls zum Beispiel über „YUM“ auf den von Oracle Linux zertifizierten Stand.

Konventionen

Behalten Sie die vorgegebenen Verzeichnisstrukturen, um bei der parallelen Installation mehrerer Systeme eine einheitliche Struktur zu gewährleisten.

Das verwendete Installationsverzeichnis /opt/comarch/CEE630PA folgt den Konventionen des unter Unix verwendeten „Filesystem Hierarchy Standard“.

Der in der Dokumentation verwendete Name CEE630PA ist ein Platzhalter, der durch den korrekten Namen gemäß der erhaltenen Lizenz zu ersetzen ist.

Im Folgenden bezeichnet „SAS“ den ERP-System-Application-Server.

AdoptOpenJDK installieren

Comarch ERP Enterprise ist in der Programmiersprache JavaTM 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 dieses Dokumentes die Version jdk-11.0.10+9. Laden Sie sich das JDK bei https://adoptopenjdk.net/ , in der aktuellsten Version als tar.gz herunter.

Die im Folgenden beschriebene Vorgehensweise zur Installation des Java JDKs ist nur bei einer Erstinstallation notwendig, oder wenn sich die Version des aus- gelieferten JDKs ändert.

Vorgehensweise: Installation des Java JDKs

Während der Installation eines JDKs müssen die Lizenzvereinbarungen von Oracle bestätigt werden: Im Verlauf der Zeit können neuere Versionen des JDK mit einem Installationssystem ausgeliefert werden. Passen Sie die Angaben an die ausgelieferte Version des JDK an.

Erstellen Sie ein Verzeichnis für die JDK Installation

mkdir /opt/comarch/java

Wechseln Sie in das Verzeichnis /opt/comarch/java. Kopieren Sie das heruntergeladene tar file in das Verzeichnis /opt/comarch/java und führen Sie

tar –xzf OpenJDK11U-jdk_x64_linux_hotspot_11.0.10_9.tar.gz aus.

Anschließend benennen Sie das Verzeichnis des JDK mit

mv jdk-11.0.10+9/ jdk-11.0.10+9-64/ um.

Um die automatische Installation nachträglich zu überprüfen, können Sie folgende Befehle in der Shell eingeben:

  • export JAVA_HOME=/opt/comarch/jdk-11.0.10+9-64
  • $JAVA_HOME/bin/java –server –version

Die folgenden Informationen werden angezeigt:

openjdk version “11.0.10” 2021-01-19

  • OpenJDK Runtime Environment AdoptOpenJDK (build 0.10+9)
  • OpenJDK 64-Bit Server VM AdoptOpenJDK (build 11.0.10+9, mixed mode)
Hinweis
Die Umgebungsvariable JAVA_HOME wird später bei jedem Aufruf des Start- Skripts „strsas-localhost.sh“ auf den Pfad des installierten Java JDKs gesetzt. Damit werden Probleme mit anderen bereits installierten JDK Versionen verhindert.

ERP-System installieren

Sie erhalten die Auslieferung als Archiv „CEE630PA-Partnersystem.zip“ zum Download auf dem Comarch FTP-Server. Durch das Aufrufen eines Skripts wer- den diese entpackt, die notwendigen Oracle Database-Dateien und Benutzer werden eingerichtet, die Daten aus den Export-Dateien importiert und die Statistiken für die Daten aufgebaut.

Zur Installation des ausgelieferten Systems aus einer Shell starten Sie eine

„bash“-Shell als Benutzer root.

Verzeichnis erstellen

Für die Installation legen Sie die folgenden Verzeichnisse an:

  1. mkdir –p /opt/comarch/CEE630PA
  2. Entpacken Sie das heruntergeladene ZIP-Archiv in dieses

unzip CEE630PA-Partnersystem.zip

Lizenzdatei bereitstellen

Stellen Sie die Lizenzdatei in dem entpackten Verzeichnis /opt/co- march/CIS620PB/install/licence bereit.

Oracle JDBC Connector bereitstellen

Stellen Sie den JDBC Connector für Oracle ojdbc8.jar, ojdbc10.jar oder neuer im Verzeichnis /opt/comarch/CEE630PA/install/lib bereit.

Installations-Skripts „crtsem.sh“

  1. Wechseln Sie in das Skript-Verzeichnis

cd /opt/comarch/CEE630PA/install/scripts/linux

  1. Ändern Sie die Berechtigung des Skripts sh

chmod 774 /opt/comarch/CEE630PA/install/scripts/linux/crtsem.sh

  1. Rufen Sie das Installations-Skript sh mit dem Parameter –help auf um die Hilfe sich anzeigen zu lassen ./crtsem.sh –help
  2. Das Skript erwartet folgende Parameter:
    • -systemname :gemäß Lizenz (z.B. CEE630PA)
    • -java :Java-Home-Verzeichnis /opt/comarch/java/jdk-11.0.10+9-64
    • -licencefile :Lizenzdateiname (z.B. 300-CEE630PA-01-CEE630PA.lic)
    • -licencepassword :Das Lizenz Kennwort
    • -database_type :ORACLE
    • -filedestination_dir : Das Zielverzeichnis, in dem der semiramis- Ordner eingerichtet werden soll. Existiert dieser Ordner nicht, so legt das Skript diesen sowie sämtliche Überordner an. (z.B. /opt/co- march/CEE630PA)
    • -configuration_database : Name der Konfiguration Datenbank gemäß Lizenz (z.B. CEE630PACF)
Hinweis
Die Konfigurationsdatenbank muss nach CEE Konventionen mit dem Buch- staben CF enden.
  • -database_dir : Pfad zum Oracle Datenbankverzeichnis meist oradata
  • -password :Kennwort des „system“ Benutzers des Oracle

Ein beispielhafter Aufruf sieht folgendermaßen aus:

./crtsem.sh -systemname CEE630PA -java /opt/comarch/java/jdk- 11.0.10+9-64 -licencefile 300-CEE630PA-01-CEE630PA.lic -licence- password <kennwort> -database_type ORACLE -filedestination_dir

/opt/comarch/CEE630PA -configuration_database CEE630PACF –data- base_dir /opt/oracle/oradata/orcl –password <kennwort>

Die Datei semiramis.zip wird in das angegebene Verzeichnis

/opt/comarch/CEE630PA/semiramis entpackt.

Anschließend werden die Oracle Datenbankdateien und die Datenbank-Benutzer angelegt. Danach beginnt der Import der mitgelieferten Comarch-ERP- Enterprise-Datenbanken. Zuletzt erfolgt der Aufbau der Optimierer-Statistiken.

Log-Dateien und die zum Import erzeugten SQL-Skripte können im Verzeichnis

/tmp/CEE630PA-log bzw. ${TMPDIR}/CEE630PA-log eingesehen werden und geben Aufschluss über einen erfolgreichen Importvorgang.Die für Comarch ERP Enterprise angelegten Datenbank-Benutzer und Kennwör- ter sind:

 

Benutzername/Passwort Datenbank
CEE630PACF für die Konfigurations-Datenbank
CEE630PARP für die Repository-Datenbank
CEE630PA00 für die OLTP-Datenbank „Basis“
CEE630PA02 für die OLTP-Datenbank „Multi-Site“

ERP-System-Application-Servers starten

Gehen Sie zum Starten des ERP-System-Application-Servers (SAS) folgender- maßen vor:

  1. Starten Sie eine „bash“-Shell als root Benutzer. Wechseln Sie in das Arbeitsverzeichnis des SAS:

cd /opt/comarch/CEE630PA/semiramis/servers/MESSAGESERVER

Führen Sie das folgende Skript aus, um den SAS zu starten:

./strsas-MESSAGESERVER.sh

Der SAS legt Log-Dateien im Verzeichnis /opt/co- march/CEE630PA/semiramis/servers/MESSAGESERVER/log ab.

Datenbankinformationen erzeugen

Vor der ersten Anmeldung am System müssen die Datenbankinformationen, er- zeugt werden.

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

crtdbinf –configuration –repository crtdbinf –oltp –nlsAutomatic restart

Am ERP-System anmelden

Die erstmalige Anmeldung am System erfolgt über die URL http://localhost mit Hilfe des Benutzernamens „ADMINISTRATOR“ und des Kennworts „12345“.

Zertifikate erstellen

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

Weitere Informationen finden Sie in der Dokumentation „Zertifikate erzeugen“.

Weitere Schritte

Nach der Installation sind noch einige Schritte notwendig, um das System weiter einzurichten. Das installierte System ist nur für einen beschränkten Funktionsumfang lizenziert. Um den vollen Funktionsumfang von Comarch ERP Enterprise nutzen zu können, müssen Sie zunächst eine Lizenz für ein neues System installieren und dieses System einrichten.

In der Dokumentation „Neues System erstellen“ wird das Vorgehen zur Erstellung eines neuen Systems erklärt. Darüber hinaus finden Sie weitere Informationen zur Inbetriebnahme im Dokument „Wegweiser: Installation“.

ERP-System-Application-Server als Dienst

Starten Sie Ihren ERP-System-Application-Server (SAS) als Dienst unter Linux. Informationen zur Vorgehensweise erhalten Sie in der Dokumentation

„Installation: Comarch ERP Enterprise als Dienst unter Windows oder Linux“.

ERP-System deinstallieren

Die De-Installation eines Comarch-ERP-Enterprise-Installationssystems gliedert sich in mehrere Schritte. Gehen Sie folgendermaßen vor:

  1. Stoppen Sie alle SAS, die über die zu löschenden Datenbank-Benutzer auf die Datenbank zugreifen. Die Daten eines Benutzers können nicht gelöscht werden, solange er noch mit der Datenbank verbunden ist.
  2. Löschen Sie alle Datenbankbenutzer, die bei der Installation angelegt wurden, mit der Option „kaskadierend“ im Enterprise Manager, z. B. die Benutzer CEE630PACF, CEE630PARP, CEE630PA00, CEE630PA02
Hinweis
Achten Sie unbedingt darauf, dass die zu löschenden Tablespaces keine Daten mehr enthalten und kein anderer Datenbankbenutzer einen der Tablespaces als Standard-Tablespace hinterlegt hat.
  1. Prüfen Sie z. B. mit der Enterprise-Manager-Konsole, ob die zu löschenden Tablespaces keine Daten mehr enthalten.
  2. Löschen Sie alle Tablespaces, die bei der Installation angelegt wurden, mit der Option auch die Betriebssystemdateien zu entfernen im Enterprise Manager, z. B. die Tablespaces CEE630PACF, CEE630PARP, CEE630PA00, CEE630PA02
  3. Löschen Sie folgendes Verzeichnis samt Inhalt:

/opt/comarch/CEE630PA/semiramis

Czy ten artykuł był pomocny?

Wyślij opnie