Voraussetzungen

Das Patch 7.1.0 kann nur auf die vorherige ePages Version installiert werden.

Anmerkung
Das Patch 7.1.0 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_7_1_0/logs/HOSTNAME/*.log

Patchen einer 1-Rechner-ePages-Installation

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

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
/var/epages/update-epages.sh --singlehost

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
/var/epages/update-epages.sh --singlehost

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.

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 folgende Kommandos aus:

Red Hat: Patch-Paket herunterladen und auspacken

Führen Sie folgende Kommandos aus:

rpm -hUv http://epages.com/repo/epages/yum/epages-release.noarch.rpm
/var/epages/update-epages.sh --distributed

Debian: Patch-Paket herunterladen und auspacken

Führen Sie folgende Kommandos aus:

curl -O http://www.epages.com/repo/epages/apt/epages-release_all.deb
dpkg -i epages-release_all.deb
apt-get -y update
/var/epages/update-epages.sh --distributed

Patch-Vorbereitung auf sekundären Rechnern

Führen Sie folgendes Kommandos auf jedem sekundären Rechner aus:

echo "$(hostname)=beta" >> Conf/Hosts

Patch-Vorbereitung auf dem Alpha-Rechner

Führen Sie auf dem Alpha-Rechner folgende Kommandos aus:

echo "$(hostname)=alpha" >> Conf/Hosts
./patch.sh prepare

Patch-Installation auf sekundären Rechnern

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

./patch.sh preinstall

Patch-Installation auf dem Alpha-Rechner

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

./patch.sh install

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

Abschlussarbeiten

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:

  • $EPAGES_PATCHES/patch_7_1_0/Conf/ConfigurationFiles/imp_Scheduler_7_1_0.conf

Die ursprüngliche Konfigurationsdatei finden Sie in:

  • $EPAGES_PATCHES/var_patch_7_1_0/backup/$(hostname)/Shared/Config/Scheduler.conf

Auswerten des Patch-Loggings

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

$EPAGES_SHARED/var-patch_{rev_number}/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.

Aufräumen von veralteten Dateien

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

  • $EPAGES_CONFIG/StoreTypes.d/OLD_VERSION

  • $EPAGES_SHARED/Static/*

  • $EPAGES_WEBROOT/StoreTypes/OLD_VERSION

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

./patch.sh cleanup

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:

  • Änderungen in PBO der MasterDB: Passen Sie in "Shops >> MASTERSHOPNAME >> Tab: MultiStore" folgende Werte an:

    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"
  • Änderungen in PBO der MultiStoreDB: Passen Sie in "Shops >> SUBSHOPNAME >> Tab: MultiStore" folgende Werte an:

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