ePages Patch-Installation 6.17.12
Created: 6.12.2; Updated: 6.17.10

Inhaltsverzeichnis

1 Voraussetzungen

Das Patch 6.17.12 kann nur auf ePages 6.17.11 installiert werden.

Das Patch 6.17.12 funktioniert nur auf Linux-Rechnern, nicht auf Windows-Rechnern.

Die Default-MySQL-Datenbank-Engine muss InnoDB sein. Das SQL-Kommando 'SHOW ENGINES' zeigt Ihnen die Default-Engine.

Im MySQL-Konfigurationsfile (meist /etc/my.cnf) darf die Option skip-networking nicht auf '1' gesetzt sein. Der Default-Wert ist '0', so dass Sie ein originales Konfigurationsfile nicht ändern müssen.

Sollte der Datenbankserver nicht laufen, starten Sie ihn. Führen Sie als Linux-Nutzer root aus:

  /etc/init.d/epages6 start_db

Stoppen Sie alle anderen Nicht-ePages-Anwendungen (z.B. Editoren), die auf Dateien im Verzeichnis $EPAGES zugreifen.

WICHTIG: Sichern Sie Ihre Daten, um im Notfall den Ausgangszustand wieder herstellen zu können. Der Patch-Prozess selbst sichert keine Daten, weder Datenbanken noch Dateien.

Das Patchen erfordert externe Internet-Verbindungen, mindestens müssen HTTP- und FTP-Clients dateien von externen Internet-Verbindungen herunterladen können.

Verschieben Sie alle Logfiles aus $EPAGES_LOG/* in ein Backup-Verzeichnis.

Treten Fehler auf, unterbrechen Sie den Patchprozess, prüfen die Protokolldatei und setzen sich mit ePages-Support in Verbindung. Sie finden die Protokolldateien standardmäßig in (HOSTNAME ist Ihr Rechnername):

  $EPAGES_SHARED/Patches/var-patch_6_17_12/logs/HOSTNAME/*.log

2 Patchen einer 1-Rechner-ePages-Installation

Die nachfolgend vorgestellten Schritte müssen vom den Linux-Nutzer root ausgeführt werden.

2.1 Red Hat Linux: Patchen mit YUM-Repository

Das Patch kann auf Red-Hat-Linux-Rechnern durch ein RPM-Update installiert werden, wenn ePages nur auf einem Rechner installiert ist (nicht verteilt auf mehrere Rechner).

Patchen Sie den Rechner durch folgende Befehle:

  rpm -hUv http://epages.com/repo/epages/yum/epages-release.noarch.rpm
  yum -y update 'epages-[a-oq-z]*' --disablerepo epages-setup --enablerepo epages-update
  yum -y update epages-patch --disablerepo epages-setup --enablerepo epages-update

2.2 Debian Linux: Patchen mit APT-Repository

Das Patch kann auf Debian-Linux-Rechnern durch ein APT-Update installiert werden, wenn ePages nur auf einem Rechner installiert ist (nicht verteilt auf mehrere Rechner).

Patchen Sie den Rechner durch folgende Befehle:

  curl -O http://www.epages.com/repo/epages/apt/epages-release_all.deb
  dpkg -i epages-release_all.deb
  apt-get -y update
  apt-get -y --only-upgrade install 'epages-[^pt]'
  apt-get -y install epages-patch

2.3 Patchen mit tar.gz-Patch-Paket

2.3.1 Patch-Paket herunterladen und auspacken

2.3.1.1 Red Hat: Patch-Paket herunterladen und auspacken

Laden Sie das Patch-Paket herunter und packen Sie das Patch-Paket epages-6.17.12-patch.tar.gz aus:

  rpm -hUv http://epages.com/repo/epages/yum/epages-release.noarch.rpm
  . /etc/default/epages6
  EPAGES_PATCHES=${EPAGES_PATCHES:-$EPAGES_SHARED/Patches}
  mkdir -m 755 $EPAGES_PATCHES
  cd $EPAGES_PATCHES
  curl -O http://www.epages.com/repo/epages/patch/6.17.12/epages-6.17.12-patch.tar.gz
  tar izxf epages-6.17.12-patch.tar.gz
  cd patch_6_17_12

2.3.1.2 Debian: Patch-Paket herunterladen und auspacken

Laden Sie das Patch-Paket herunter und packen Sie das Patch-Paket epages-6.17.12-patch.tar.gz aus:

  curl -O http://www.epages.com/repo/epages/apt/epages-release_all.deb
  dpkg -i epages-release_all.deb
  apt-get -y update
  . /etc/default/epages6
  EPAGES_PATCHES=${EPAGES_PATCHES:-$EPAGES_SHARED/Patches}
  mkdir -m 755 $EPAGES_PATCHES
  cd $EPAGES_PATCHES
  curl -O http://www.epages.com/repo/epages/patch/6.17.12/epages-6.17.12-patch.tar.gz
  tar izxf epages-6.17.12-patch.tar.gz
  cd patch_6_17_12

2.3.2 Patch-Vorbereitung

Das Patch kann in 2 Teilschritten installiert werden:

prepare
Patch-Vorbereitung, die während der Online-Zeit des Stores ausgeführt werden kann.
install
Patch-Installation, die während der Offline-Zeit des Stores ausgeführt wird.
Sie können den ersten Schritt (prepare) weglassen, er wird dann automatisch mit dem zweiten Schritt ausgeführt. Wollen Sie so vorgehen, übersprinden Sie diesen Abschnitt und lesen im nächsten Abschnitt weiter.

Führen Sie folgendes Kommando aus:

  ./patch.sh prepare

2.3.3 Ausführen des Patches

Führen Sie folgendes Kommando aus:

  ./patch.sh install

3 Patchen einer auf mehrere Rechner verteilten ePages-Installation

Eine verteilte ePages-Installation besteht aus mehreren Rechnern. Es gibt genau einen primären Rechner (hier Alpha-Rechner genannt) und einen oder mehrere sekundäre Rechner:

Alpha-Rechner
Primärer Rechner auf dem der ePages-Service läuft. Läuft der ePages-Service auf mehreren Rechnern, wählen Sie genau einen davon als Alpha-Rechner aus.
Sekundäre(r) Rechner
Alle weiteren Rechner Ihrer Installation auf denen ePages-Perl installiert ist.
Führen Sie folgende Befehle auf den jeweiligen Rechnern aus.

Die nachfolgend vorgestellten Schritte müssen vom Linux-Nutzer root ausgeführt werden.

3.1 Patch-Paket auf allen Rechnern herunterladen und auspacken

Auf jedem Rechner (einer nach dem anderen, nicht parallel) muss zunächst das Patch-Paket ausgepackt werden. Führen Sie dazu die Kommandos (dem Betriebssystem entsprechend) wie in Abschnitt Patch-Paket herunterladen und auspacken beschrieben aus.

3.2 Patch-Vorbereitung auf dem Alpha-Rechner

Führen Sie auf dem Alpha-Rechner folgendes Kommando aus:

  ./patch.sh prepare

3.3 Patch-Installation auf sekundären Rechnern

Führen Sie auf den sekundären Rechnern folgendes Kommando aus:

  ./patch.sh preinstall

3.4 Patch-Installation auf dem Alpha-Rechner

Führen Sie auf dem Alpha-Rechner folgendes Kommando aus:

  ./patch.sh install

3.5 Installation auf allen Rechnern abschließen

Führen Sie zuerst auf den sekundären Rechnern, dann auf dem Alpha-Rechner folgendes Kommando aus:

  ./patch.sh postinstall

4 Abschlussarbeiten

4.1 Geänderte Datei Config/Scheduler.conf

Das Patch ändert die Konfigurationsdatei $EPAGES_CONFIG/Scheduler.conf. Überprüfen Sie nach dem Patch, ob Sie die geänderten Werte beibehalten wollen.

Die Änderungen finden Sie in dieser Datei:

Die ursprüngliche Konfigurationsdatei finden Sie in:

4.2 Auswerten des Patch-Loggings

Untersuchen Sie die Patch-Logfiles, die Sie in folgendem Verzeichnis finden (HOSTNAME ist der Rechnername):

  $EPAGES_SHARED/var-patch_6_17_12/logs/HOSTNAME/*.log

Untersuchen Sie die Meldungen der Patch-Installation in den Protokoll- dateien in $EPAGES_LOG/*, insbesondere die Datei error.log. In der Datei error.log kann folgende Warnung ignoriert werden:

  Can't connect to the MC at ....

Die Warnung wird geschrieben, weil bei der Patch-Installation der ePages-Service nicht gestartet sein darf.

4.3 Aufräumen von veralteten Dateien

Nachdem das Patch erfolgreich installiert wurde, gibt es noch folgende veraltete Dateien:

Die veralteten Dateien müssen gelöscht werden. Rufen Sie auf allen involvierten Rechnern folgenden Befehl auf:

  ./patch.sh cleanup

4.4 Konfiguration der Web-Services bei Multistore-Installationen

Nachdem eine Multistore-Installation gepatcht wurde, müssen die Web-Services im PBO konfiguriert werden.

Passen Sie die Einstellungen im PBO entsprechend Ihrer Multistore-Installation an, ersetzen Sie die in Klammern angegebenen Werte durch Ihre eigenen:

  Site - WebService URL: "http://<Domain>/epages/Site.soap"
  Site - WebserviceUser: "/Users/wsadmin"
  Site - WebservicePassword: "wsadmin"

  WebService URL: "http://<MasterShopDomain>/epages/MASTERSHOPNAME.soap"
  WebserviceUser: "/Shops/MASTERSHOPNAME/Users/admin"
  WebservicePassword: "admin"

  WebService URL: "http://<SubShopDomain>/epages/SUBSHOPNAME.soap"
  WebserviceUser: "/Users/wsadmin"
  WebservicePassword: "wsadmin"


Copyright ePages GmbH 2014