ePages Patch-Installation 6.14.0
Created: 6.12.2; Updated: 6.14.0

Inhaltsverzeichnis

1 Voraussetzungen

Das Patch 6.14.0 kann nur auf ePages 6.13.0, 6.13.1, 6.13.2, 6.13.3 installiert werden.

Das Patch kann nicht auf ePages mit Sybase ASE installiert werden. Benutzen Sie noch Sybase, müssen Sie zunächst die ePages-Datenbank auf MySQL migrieren (wie in Migrate Data from Sybase to MySQL beschrieben), bevor Sie das Patch installieren können.

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

Sollte der Datenbankserver nicht laufen, starten Sie ihn:

Windows
Starten Sie den Datenbank-Dienst MySQL
Linux
Führen Sie als root aus: /etc/init.d/epages6 start_db
Stoppen Sie alle anderen Nicht-ePages-Anwendungen (z.B. Editoren), die auf Dateien im Verzeichnis %EPAGES% (Linux: $EPAGES, siehe /etc/default/epages6) zugreifen.

Sichern Sie Ihre Daten, um im Notfall den Ausgangszustand wieder herstellen zu können.

Unter Linux muß das epages-Repository durch folgenden Befehl aktualisiert werden:

  curl http://epages.com/RPMS/rpmify/rpmify-epages.sh | sh

1.1 Linux: Patchen mit YUM-Repository

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

Vor dem Patchen durch RPM-Update müssen Sie ePages-Perl 5.12.3 installieren, wie es im Abschnitt Nutzerspezifische Konfiguration beschrieben ist.

Sind alle Voraussetzungen gegeben, können Sie ePages durch folgenden Befehl patchen:

Red Hat RHEL/CentOS:

  yum -y update epages-patch epages-j --enablerepo epages-update

SuSE SLES:

  zypper mr -e epages-update
  zypper update -y -r epages-update epages-patch epages-j
  zypper mr -d epages-update

Wollen Sie Language Pack Keys zum Update Ihrer Language Packs benutzen (siehe nächsten Abschnitt), rufen Sie bspw. auf (falls Sie Spanisch und Dänisch updaten wollen):

Red Hat RHEL/CentOS:

  EPAGES614_LANG_ES_KEY=<spanish key> EPAGES614_LANG_DA_KEY=<danish key> yum update epages-j epages-patch --enablerepo epages-update

SuSE SLES:

  zypper mr -e epages-update
  EPAGES614_LANG_ES_KEY=<spanish key> EPAGES614_LANG_DA_KEY=<danish key> zypper update -y -r epages-update epages-patch epages-j
  zypper mr -d epages-update

1.2 Patches für Language Packs

Haben Sie zusätzliche Language Packs installiert (außer Deutsch und Englisch), benötigen Sie zum Patchen die aktuellen Versionen dieser Language Packs. Sie benötigen dann entweder A) die Language Packs selbst oder B) die Language Pack Keys, mit denen Sie ePages inklusive der Language Packs aktualisieren können. Beides erhalten Sie von Ihrem zuständigen ePages Sales Account Manager.

Wählen Sie eine der 2 folgenden Methoden aus.

1.2.1 A) Benötigt: Language Packs

Sie benötigen alle Language Packs von Ihrer Ausgangsversion bis zur Patch-Zielversion für alle installierten Sprachen (außer Deutsch und Englisch).

Wollen Sie beispielsweise von der Version 6.11.2 aus patchen, brauchen Sie die Language Packs der Versionen 6.11.3 und 6.12.0.

Kopieren Sie alle benötigen Language Packs in das gleiche Verzeichnis wie das Patch selbst (d.h. z.B. nach /tmp, wenn sich das Verzeichnis patch_6_14_0 auch in /tmp befindet).

1.2.2 B) Benötigt: Language Pack Keys

Sie benötigen für jede installierte Sprache (außer Deutsch und Englisch) einen eigenen Language Pack Key. Die Language Pack Keys müssen dann bei der Patch-Vorbereitung in Make-Variablen übergeben werden.

Beispiel: Benutzen Sie die Sprachen Spanisch und Dänisch, geben Sie beim Patch-Aufruf folgendes an (ersetzen Sie die Werte in den eckigen Klammern):

Windows:

  perl patch.pl prepare EPAGES614_LANG_ES_KEY=<spanish key> EPAGES614_LANG_DA_KEY=<danish key>

Linux:

  ./patch.sh prepare EPAGES614_LANG_ES_KEY=<spanish key> EPAGES614_LANG_DA_KEY=<danish key>

1.3 Logging beim Patchen

Sichern Sie die Logdateien in %EPAGES_LOG% (Linux: $EPAGES_LOG, siehe /etc/default/epages6) und löschen Sie diese danach in %EPAGES_LOG%.

2 Patchen einer 1-Rechner-ePages-Installation

Nur für Windows: Die nachfolgend vorgestellten Schritte müssen vom Windows-Nutzer Administrator ausgeführt werden bzw. der Nutzer muss administrative Rechte haben.

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

2.1 Vorbereitende Aufgaben

2.1.1 Patch-Paket auspacken

Kopieren Sie die Datei epages-6.14.0-patch.tar.gz in ein lokales Verzeichnis und packen Sie das Patch aus:

Windows:

  cd /d c:\temp
  gzip -d epages-6.14.0-patch.tar.gz
  tar ixf epages-6.14.0-patch.tar
  cd patch_6_14_0

Linux:

  . /etc/default/epages6
  cd /tmp
  tar izxf epages-6.14.0-patch.tar.gz
  cd patch_6_14_0

2.1.2 Nutzerspezifische Konfiguration

Überprüfen Sie, ob die patch-relevanten Variablen in den Konfigurationsfiles in %EPAGES_CONFIG%\Database.d\*.conf (Linux: $EPAGES_CONFIG/Database.d/*.conf) korrekte Werte haben. Die Variablen sind in folgenden Dokumenten beschrieben:

2.2 Patch-Installation

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.

2.2.1 Patch-Vorbereitung

Führen Sie folgende Kommandos aus:

Windows:

  perl patch.pl prepare

Linux:

  . /etc/default/epages6
  ./patch.sh prepare

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

Windows:

  %EPAGES_SHARED%\Patches\var-patch_6_14_0\logs\HOSTNAME\DATE-prepare.log

Linux:

  $EPAGES_SHARED/Patches/var-patch_6_14_0/logs/HOSTNAME/DATE-prepare.log

wobei HOSTNAME dem Namen Ihres Rechners entspricht und DATE ein Datum mit dem Format YYYY-MMM-DD-HH.MM.SS (z.B. 2007-May-31-15.34.23) ist.

2.2.2 Ausführen des Patches

Führen Sie folgende Kommandos aus:

Windows:

  perl patch.pl install

Linux:

  . /etc/default/epages6
  ./patch.sh install

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

Windows:

  %EPAGES_SHARED%\Patches\var-patch_6_14_0\logs\HOSTNAME\DATE-install.log

Linux:

  $EPAGES_SHARED/Patches/var-patch_6_14_0/logs/HOSTNAME/DATE-install.log

wobei HOSTNAME dem Namen Ihres Rechners entspricht und DATE ein Datum mit dem Format YYYY-MMM-DD-HH.MM.SS (z.B. 2007-May-31-15.34.23) ist.

3 Patch-Deinstallation bei einer 1-Rechner-ePages-Installation

Nur für Windows: Die nachfolgend vorgestellten Schritte müssen vom Windows-Nutzer Administrator ausgeführt werden bzw. der Nutzer muss administrative Rechte haben.

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

Führen Sie folgende Kommandos zur Patch-Deinstallation aus:

Windows:

  perl patch.pl restore

Linux:

  . /etc/default/epages6
  ./patch.sh restore

4 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.
Das ePages-Patch wird installiert, indem Sie folgende Befehle ausführen:

1. auf dem Alpha-Rechner (siehe Abschnitt Patch-Vorbereitung auf dem Alpha-Rechner):

   Windows:  perl patch.pl prepare
   Linux:    ./patch.sh prepare

2. auf jedem sekundären Rechner (siehe Abschnitt Patch-Installation auf sekundären Rechnern):

   Windows:  perl patch.pl preinstall
   Linux:    ./patch.sh preinstall

3. auf dem Alpha-Rechner (siehe Abschnitt Patch-Installation auf dem Alpha-Rechner):

   Windows:  perl patch.pl install
   Linux:    ./patch.sh install

4. auf jedem sekundären Rechner (siehe Abschnitt Installation auf allen Rechnern abschließen):

   Windows:  perl patch.pl postinstall
   Linux:    ./patch.sh postinstall

5. auf dem Alpha-Rechner (siehe Abschnitt Installation auf allen Rechnern abschließen):

   Windows:  perl patch.pl postinstall
   Linux:    ./patch.sh postinstall

Der erste Schritt (prepare) enthält vorbereitende Aufgaben, die während der Online-Zeit des Stores ausgeführt werden können.

Die anderen Schritte werden während der Offline-Zeit des Stores ausgeführt.

Sie können den ersten Schritt (Patch-Vorbereitung auf dem Alpha-Rechner) weglassen, er wird dann automatisch mit dem dritten Schritt (Patch-Installation auf dem Alpha-Rechner) ausgeführt.

4.1 Patch-Vorbereitung auf dem Alpha-Rechner

Führen Sie nur auf dem Alpha-Rechner die vorbereitenden Aufgaben wie in den Abschnitten Vorbereitende Aufgaben und Patch-Vorbereitung beschrieben durch.

4.2 Patch-Installation auf sekundären Rechnern

Nur für Windows: Die nachfolgend vorgestellten Schritte müssen vom Windows-Nutzer Administrator ausgeführt werden bzw. der Nutzer muss administrative Rechte haben.

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

Patchen Sie die Rechner in folgender Reihenfolge:

1. Führen Sie auf jedem Rechner die vorbereitenden Aufgaben wie im Abschnitt Vorbereitende Aufgaben beschrieben durch.

Bei Linux kann auf den sekundären Rechnern yum update epages-perl --enablerepo epages-update (bzw. bei SuSE SLES zypper ...) weggelassen werden, wenn $EPAGES_PERL (eproot/Perl) ein geshartes Verzeichnis ist, das von allen beteiligten ePages-Rechnern gemeinsam genutzt wird. Scripts/rpmify-epages.sh muß allerdings auf jedem sekundären Rechner ausgeführt werden.

2. Führen Sie auf jedem Rechner folgende Kommandos aus:

Windows:

  perl patch.pl preinstall

Linux:

  . /etc/default/epages6
  ./patch.sh preinstall

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

Windows:

  %EPAGES_SHARED%\Patches\var-patch_6_14_0\logs\HOSTNAME\DATE-preinstall.log

Linux:

  $EPAGES_SHARED/Patches/var-patch_6_14_0/logs/HOSTNAME/DATE-preinstall.log

wobei HOSTNAME dem Namen Ihres Rechners entspricht und DATE ein Datum mit dem Format YYYY-MMM-DD-HH.MM.SS (z.B. 2007-May-31-15.34.23) ist.

4.3 Patch-Installation auf dem Alpha-Rechner

Falls Sie den Schritt Patch-Vorbereitung auf dem Alpha-Rechner ausgeführt haben, führen Sie nur auf dem Alpha-Rechner die Patch-Installation wie im Abschnitt Ausführen des Patches beschrieben durch.

Falls Sie den Schritt Patch-Vorbereitung auf dem Alpha-Rechner nicht ausgeführt haben, führen Sie nur auf dem Alpha-Rechner die Patch-Installation wie in den Abschnitten Vorbereitende Aufgaben und Patch-Installation beschrieben durch.

4.4 Installation auf allen Rechnern abschließen

Nur für Windows: Die nachfolgend vorgestellten Schritte müssen vom Windows-Nutzer Administrator ausgeführt werden bzw. der Nutzer muss administrative Rechte haben.

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

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

Windows:

  perl patch.pl postinstall

Linux:

  . /etc/default/epages6
  ./patch.sh postinstall

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

Windows:

  %EPAGES_SHARED%\Patches\var-patch_6_14_0\logs\HOSTNAME\DATE-postinstall.log

Linux:

  $EPAGES_SHARED/Patches/var-patch_6_14_0/logs/HOSTNAME/DATE-postinstall.log

wobei HOSTNAME dem Namen Ihres Rechners entspricht und DATE ein Datum mit dem Format YYYY-MMM-DD-HH.MM.SS (z.B. 2007-May-31-15.34.23) ist.

5 Patch-Deinstallation bei einer verteilten ePages-Installation

Nur für Windows: Die nachfolgend vorgestellten Schritte müssen vom Windows-Nutzer Administrator ausgeführt werden bzw. der Nutzer muss administrative Rechte haben.

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

Das ePages-Patch wird deinstalliert, indem Sie folgende Befehle ausführen:

1. auf den sekundären Rechnern (siehe Abschnitt Patch-Deinstallation auf sekundären Rechnern):

   Windows:  perl patch.pl prerestore
   Linux:    ./patch.sh prerestore

2. auf dem Alpha-Rechner (siehe Abschnitt Patch-Deinstallation auf Alpha-Rechner):

   Windows:  perl patch.pl restore
   Linux:    ./patch.sh restore

3. auf den sekundären Rechnern (siehe Abschnitt Deinstallation auf sekundären Rechnern abschließen):

   Windows:  perl patch.pl postrestore
   Linux:    ./patch.sh postrestore

Dabei werden in den einzelnen Schritten die jeweiligen Schritte des Patchinstallationprozesses zurückgerollt:

5.1 Patch-Deinstallation auf sekundären Rechnern

Führen Sie zuerst auf jedem sekundären Rechnern der ePages-Installation folgenden Befehl aus:

Windows:

  perl patch.pl prerestore

Linux:

  . /etc/default/epages6
  ./patch.sh prerestore

5.2 Patch-Deinstallation auf Alpha-Rechner

Führen Sie folgenden Befehl nur auf den Alpha-Rechner aus:

Windows:

  perl patch.pl restore

Linux:

  . /etc/default/epages6
  ./patch.sh restore

5.3 Deinstallation auf sekundären Rechnern abschließen

Führen Sie zum Schluß auf jedem sekundären Rechner folgenden Befehl aus:

Windows:

  perl patch.pl postrestore

Linux:

  . /etc/default/epages6
  ./patch.sh postrestore

6 Patchen ohne Backup

Falls Sie das EPAGES-Verzeichnis und/oder die ePages-Datenbanken schon vor dem Patch-Beginn gesichert haben, können Sie auf das Backup während des Patchens verzichten. Sie müssen sich dann selbst um das Zurücksetzen von Verzeichnis und/oder Datenbanken kümmern, falls das Patch fehlschlägt.

Soll das EPAGES-Verzeichnis während des Patchens nicht gesichert werden, fügen Sie an den Patchaufruf BACKUP_DIR= an.

Sollen die ePages-Datenbanken während des Patchens nicht gesichert werden, fügen Sie an das Patchaufruf BACKUP_DB= an.

Beispiele:

Windows, gar kein Backup:

  perl patch.pl preinstall BACKUP_DIR= BACKUP_DB=
  perl patch.pl install BACKUP_DIR= BACKUP_DB=
  perl patch.pl postinstall BACKUP_DIR= BACKUP_DB=

Windows, kein Datenbank-Backup:

  perl patch.pl preinstall BACKUP_DB=
  perl patch.pl install BACKUP_DB=
  perl patch.pl postinstall BACKUP_DB=

Linux, gar kein Backup:

  . /etc/default/epages6
  ./patch.sh preinstall BACKUP_DIR= BACKUP_DB=
  ./patch.sh install BACKUP_DIR= BACKUP_DB=
  ./patch.sh postinstall BACKUP_DIR= BACKUP_DB=

7 Abschlussarbeiten

7.1 Auswerten des Patch-Loggings

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.

7.2 Aufräumen der Datensicherung

Sicherungsdateien werden in folgenden Verzeichnissen abgelegt:

wobei VERSION die ePages-Ausgangsversion vor dem Patch ist.

Wollen Sie alle beim Patchen angelegten Sicherungsdateien löschen, rufen Sie folgenden Befehl auf allen involvierten Rechnern auf:

Windows:

  perl patch.pl del_backup_files

Linux:

  . /etc/default/epages6
  ./patch.sh del_backup_files

7.3 Überprüfung der Shoptypen-Einstellungen im BBO

Neue Shops können mit bestimmten Grundeinstellungen und Beispielinhalten angelegt werden. Diese Daten werden in verschiedenen XML-Dateien bereitgestellt. Die jeweiligen XML-Dateien werden im BBO den einzelnen Shoptypen zugeordnet und beim Anlegen in den neuen Shop importiert.

Mit ePages-Version 6.12.0 wurden die vorbereiteten XML-Dateien neu strukturiert. Dadurch sind Grundeinstellungen und Beispieldaten nun in getrennten XML-Dateien hinterlegt.

Durch das Patch werden die neuen XML-Dateien bereitgestellt und nicht mehr benötigte Dateien gelöscht.

Die XML-Datei-Zuordnung für die Shoptypen im BBO wird durch das Patch nicht geändert, um benutzerdefinierte Zuordnungen nicht zu löschen.

Dadurch kann es dazu kommen, dass nach dem Patch in den Shoptypeinstellungen XML-Dateien eingetragen sind, die es nicht mehr gibt. Das kann beim Anlegen neuer Shops zu Fehlern führen.

Überprüfen Sie deshalb nach dem Patch, jedoch vor dem Anlegen neuer Shops, Ihre Einstellungen für neue Shops unter "BBO >> Shoptypen >> [shoptyp] >> Allgemein" für die Felder "Importdateien für neue Shops" und "Quellverzeichnis für Dateien eines neuen Shops" wie folgt:

  1. Entfernen Sie die Namen von XML-Dateien, die nicht mehr in der Auswahlliste der XML-Dateien aufgeführt sind.
  2. Tragen Sie die XML-Dateien ein, welche die gewünschten Grundeinstellungen, Beispieldaten und Ländereinstellungen für die Shops dieses Typs bereitstellen.
Hinweis: Ohne die Anpassung der Werte in den Eingabefeldern ist das Anlegen neuer Shops nicht möglich.

Folgende Hauptdateien stehen zur Verfügung:

Basic.xml
Für die Grundeinstellungen in allen Shops und Webseiten
Translation.Basic.[xx].xml
Sprachabhängige Inhalte für Basic.xml
StarterContent.xml
Beispieldaten für den neuen beschreibenden Startinhalt
Translation.StarterContent.[xx].xml
Sprachabhängige Inhalte für StarterContent.xml
DemoShop.xml
Beispieldaten des alten Milestones Demoshops
Translation.DemoShop.[xx].xml
sprachabhängige Inhalte für DemoShop.xml
Country_[XX].xml
Länderspezifische Einstellungen (Bsp: Country_DE.xml für Shops in Deutschland)
Die abschließenden Abschnitte zeigen Ihnen Beispiele für den Inhalt der Eingabefelder.

7.3.1 Anwendungsbeispiel 1: Shop mit neuem Startinhalt für Händler in Deutschland

Feld "Importdateien für neue Shops":

  Basic.xml,Translation.Basic.de.xml,Translation.Basic.en.xml,
  StarterContent.xml,Translation.StarterContent.de.xml,
  Translation.StarterContent.en.xml,Country_DE.xml

Feld "Quellverzeichnis für Dateien eines neuen Shops":

  $ENV{EPAGES_STORES}/Site/ShopPublicFiles/StarterShop

7.3.2 Anwendungsbeispiel 2: Einfache Webseite ohne Beispielinhalte in Großbritannien

Feld "Importdateien für neue Shops":

  Basic.xml,Translation.Basic.en.xml,Country_GB.xml

Feld "Quellverzeichnis für Dateien eines neuen Shops":

  Leer

7.3.3 Anwendungsbeispiel 3: Milestones Demoshop zur umfassenden Präsentation der Shop-Funktionen

Feld "Importdateien für neue Shops":

  Basic.xml,Translation.Basic.de.xml,Translation.Basic.en.xml,DemoShop.xml,
  Translation.DemoShop.de.xml,Translation.DemoShop.en.xml,DownloadProduct.xml,
  Translation.DownloadProduct.de.xml,Translation.DownloadProduct.en.xml,
  Country_DE.xml

Feld "Quellverzeichnis für Dateien eines neuen Shops":

  $ENV{EPAGES_STORES}/Site/ShopPublicFiles/DemoShop

Hinweis: Wenn Sie die bisherigen XML-Datei bereits angepasst haben, finden Sie eine Sicherungskopie dieser Datei unter:

  %EPAGES_SHARED%\Patches\var-patch_6_14_0\backup\HOSTNAME\Shared\Stores\Site\ShopImport


Copyright ePages Software GmbH 2012