Durchführen eines Build-Upgrades

In diesem Abschnitt erhalten Sie eine ausführliche Anleitung zum Upgrade-Prozess und zu den Schritten zur Ermittlung und Lösung von Konflikten.

Das Build-Upgrade muss mit Vorsicht durchgeführt werden, seine Auswirkungen müssen im Voraus umfassend berücksichtigt werden und das Verfahren muss mit einem hohen Maß an Disziplin abgeschlossen werden. Um eine erfolgreiche Aktualisierung sicherzustellen, stellen Sie sicher, dass nur erfahrene Benutzer die unten beschriebenen Schritte ausführen. Darüber hinaus empfehlen wir dringend, mit Adobe-Kundenunterstützung vor dem Start eines Upgrades.

Folgende Voraussetzungen müssen gegeben sein:

• Kenntnis der Campaign-Architektur
• Kenntnis der Systeme und Server
• Administratorrechte und Berechtigungen

Weitere Informationen finden Sie in den folgenden Abschnitten: Aktualisieren von Adobe Campaign, Migration zu einer neuen Version.

Bei gehosteten und hybriden Instanzen müssen Sie das Build-Upgrade beim Adobe Technical Operations-Team anfordern. Weitere Informationen hierzu finden Sie im Abschnitt Häufig gestellte Fragen am unteren Rand dieser Seite. Lesen Sie auch Häufig gestellte Fragen zur Build-Aktualisierung.

Vorbereiten des Upgrades

Vor Beginn des Build-Upgrades müssen Sie eine vollständige Vorbereitung wie unten beschrieben durchführen.
Sobald das System für die Aktualisierung bereit ist, wird ein Build-Upgrade durchgeführt mindestens 2 Stunden.

Für das Build-Upgrade sind die folgenden Ressourcen erforderlich:

• ein Adobe Architect: Erläuterung der Datenbankstrukturen (vordefinierte Schemas und alle hinzugefügten zusätzlichen Schemata, Kampagnenentwürfe und alle wichtigen Pfadfunktionen, die in einer bestimmten Reihenfolge gestartet und getestet werden müssen).
• Projektmanager - Wenn das Build-Upgrade viele verschiedene Instanzen (Produktion, Staging, Tests) und andere Drittanbieter-Server und -Anwendungen (Datenbanken, SFTP-Sites, Messaging-Service-Provider) umfasst, gilt ein Projektmanager zur Koordinierung aller Tests als Best Practice.
• ein Adobe-Campaign-Administrator: Er kennt die Konfiguration des Servers, u. a. Anforderungen in Bezug auf Sicherheit, Ordneraufbau, Reporting und den Import und Export. Bitte nehmen Sie kein Build-Upgrade ohne Ihren Administrator vor.
• ein Adobe Campaign-Benutzer (Marketing-Benutzer): Ein erfolgreiches Upgrade hängt von der Fähigkeit des Benutzers ab, seine täglichen Aufgaben erfolgreich durchzuführen. Aus diesem Grund sollten Sie mindestens einen Ihrer täglichen Benutzer in Ihre Tests der aktualisierten Server einbeziehen.

Planung

Dies sind die wichtigsten Schritte zur Planung eines Build-Upgrades:

1. Planen Sie mindestens zwei Stunden für das Upgrade ein.
2. Stellen Sie Kontaktdetails für Adobe- und Kundenmitarbeiter bereit.
3. Für gehostete Instanzen: die Adobe- und Kundenmitarbeiter bestimmen den Zeitpunkt des Upgrades sowie die Person, die ihn durchführt.
4. Für On-Premise-Instanzen: die Kundenmitarbeiter führen den gesamten Prozess aus. Wenn Hilfe beim Testen benutzerdefinierter Workflows und Sendungen benötigt wird, sollten Beratungsdienste in Anspruch genommen werden.
5. Ermitteln und bestätigen Sie, auf welche Version von Adobe Campaign Sie aktualisieren möchten - konsultieren Sie die Versionshinweise zu Adobe Campaign Classic.
6. Bestätigen Sie das Vorhandensein ausführbarer Upgrade-Dateien.

Wichtige Personen

Für das Build-Upgrade müssen die folgenden Personen beteiligt sein:

• Adobe Architect: bei gehosteten oder hybriden Architekturen muss sich der Architekt mit der Kundenunterstützung von Adobe Campaign abstimmen.

• Projektmanager:

  • für On-Premise-Installationen: Der interne Projektleiter des Kunden leitet die Aktualisierung und verwaltet Lebenszyklustests.

  • für gehostete Installationen: Das Hosting-Team arbeitet mit dem Adobe Campaign Client Care-Team und dem Kunden zusammen, um die Aktualisierungszeitpläne für alle Instanzen zu koordinieren.

• Adobe-Campaign-Administrator:

  • für On-Premise-Installationen: führt der Administrator das Upgrade durch.

  • für gehostete Installationen: führt das Hosting-Team das Upgrade durch.

• Adobe Campaign-Benutzer/Marketing-Benutzer: der Benutzer führt Tests für Entwicklungs-, Test- und Produktionsinstanzen durch.

Build-Aktualisierung vorbereiten

Vor Beginn der Build-Aktualisierung müssen On-Premise-Kunden die folgende Vorbereitung durchführen:

1. Vergewissern Sie sich, dass alle Entwicklungsarbeiten exportiert werden können, bevor das Upgrade durchgeführt wird. Führen Sie den Export als Packages durch.

2. Führen Sie eine vollständige Sicherung der Datenbanken für alle Instanzen der Quell- und Zielumgebungen durch.

3. Laden Sie die neueste Version Ihrer Serverkonfigurationsdatei.

4. Neuesten Build herunterladen. Weitere Informationen.

Sie müssen auch alle nützliche Befehlszeilen vor Beginn einer Build-Aktualisierung:

• nlserver pdump: listet aktuelle Prozesse auf
• nlserver pdump -who: listet aktive Client-Sitzungen auf
• nlserver monitor -missing: listet fehlende Eigenschaften auf
• nlserver start process@instanceName: startet einen Prozess
• nlserver stop process@instanceName: stoppt einen Prozess
• nlserver Neustart process@instanceName: startet einen Prozess neu
• nlserver shutdown: stoppt alle Campaign-Prozesse
• nlserver watchdog -svc: startet den Watchdog-Prozess (nur UNIX)

Führen Sie das Upgrade durch

Die folgenden Verfahren werden nur von On-Premise -Kunden. Für gehostete Kunden wird dies vom Hosting-Team übernommen. Um Adobe Campaign auf einen neuen Build zu aktualisieren, wird das entsprechende Verfahren unten beschrieben.

Umgebung duplizieren

So duplizieren Sie eine Adobe Campaign-Umgebung, um eine Quellumgebung in eine Zielumgebung wiederherzustellen, was zu zwei identischen Arbeitsumgebungen führt.

Gehen Sie dazu wie folgt vor:

1. Erstellen Sie eine Kopie der Datenbanken auf allen Instanzen in der Quellumgebung.

2. Stellen Sie diese Kopien auf allen Instanzen der Zielumgebung wieder her.

3. Führen Sie die nms:freezeInstance.js Warnhinweisskript für die Zielumgebung erstellen, bevor sie gestartet wird. Dadurch werden alle Prozesse angehalten, die mit der Außenwelt interagieren: Protokolle, Tracking, Sendungen, Kampagnen-Workflows usw.

   nlserverjavacsriptnms:freezeInstance.js–instance:<dev> -arg:run
   

4. Überprüfen Sie die Vorsicht wie folgt:

   • Vergewissern Sie sich, dass der einzige Lieferteil der ist, für den die ID festgelegt ist. 0:

     SELECT * FROM neolane.nmsdeliverypart;
     

   • Vergewissern Sie sich, dass die Versandstatus-Aktualisierung korrekt ist:

     SELECT iSate, count(*) FROM neolane.nmsdeliveryGroup By iProd;
     

   • Vergewissern Sie sich, dass die Workflow-Status-Aktualisierung korrekt ist:

     SELECT iState, count (*) FROM neolane.xtkworkflowGROUP BY iState;
     SELECT iStatus, count (*) FROM neolane.xtkworkflowGROUP BY iStatus;
     

Dienste beenden

Um alle Dateien mit der neuen Version zu ersetzen, müssen alle Instanzen von nlserverservice beendet werden.

1. Beenden Sie die folgenden Dienste:

   • Webdienste (IIS): iisreset /stop
   • Adobe-Campaign-Dienst: net stop nlserver6
   HINWEIS

   Stellen Sie sicher, dass der Weiterleitungsserver (webmdl) angehalten ist, damit die von IIS verwendete Datei nlsrvmod.dll durch die neue Version ersetzt werden kann.

2. Überprüfen Sie, ob keine Aufgaben aktiv sind, indem Sie die nlserver pdump Befehl. Wenn keine Aufgaben vorhanden sind, sollte die Ausgabe wie folgt aussehen:

   C:\<installation path>\bin>nlserverpdump HH:MM:SS > Application Server for Adobe Campaign version x.x (build xxx) dated xx/xx/xxxx No tasks
   

3. Überprüfen Sie den Windows Task Manager, um sicherzustellen, dass alle Prozesse beendet wurden.

Aktualisieren der Adobe Campaign-Serveranwendung

1. Führen Sie die Setup.exe -Datei. Wenn Sie diese Datei herunterladen müssen, greifen Sie auf Download-Center.

2. Wählen Sie den Installationsmodus aus: Aktualisieren oder Reparatur.

3. Klicken Sie auf Weiter.

4. Wählen Sie Beenden aus: Die neue Datei wird vom Installationsprogramm kopiert.

5. Wählen Sie nach Abschluss des Vorgangs die Option Beenden aus.

Ressourcen synchronisieren

1. Öffnen Sie die Befehlszeile.

2. Führen Sie nlserver config -postupgrade -allinstances aus, um Folgendes durchzuführen:

   • Ressourcen synchronisieren
   • Schemata aktualisieren
   • Aktualisieren der Datenbank
   HINWEIS

   Dieser Vorgang sollte nur einmal und nur auf einem nlserverweb-Anwendungsserver ausgeführt werden.

   Um nur eine Datenbank zu synchronisieren, führen Sie den folgenden Befehl aus:

   nlserver config -postupgrade -instance: <instance_name>
   

3. Überprüfen Sie, ob bei der Synchronisierung Fehler oder Warnungen aufgetreten sind.

Dienste wieder starten

Die folgenden Dienste müssen wieder gestartet werden:

• Webdienste (IIS): issreset /start
• Adobe-Campaign-Dienst: net start nlserver6

Aktualisierung der Client-Konsolen

Die Client-Konsole muss denselben Build haben wie die Server-Instanz.

Laden Sie auf der Maschine, auf der der Adobe Campaign-Anwendungsserver installiert ist (nlserverweb), diese Datei herunter und kopieren Sie sie:

Setup-client-7.xxxx.exe in [path of the application]\datakit\nl\en\jsp

Wenn das nächste Mal Clientkonsolen verbunden werden, werden die Benutzer darauf hingewiesen, dass eine neue Aktualisierung verfügbar ist, und erhalten die Möglichkeit, diese herunterzuladen und zu installieren.

Spezifische zusätzliche Aufgaben

Einige Konfigurationen erfordern bestimmte zusätzliche Aufgaben, um auf einen neuen Build aktualisiert zu werden.

Transaktionsnachrichtenversand

Wenn Transaktionsnachrichten (Message Center) in Ihrer Campaign-Instanz aktiviert ist, müssen Sie die folgenden zusätzlichen Schritte ausführen, um eine Aktualisierung durchzuführen:

1. Aktualisieren Sie den Message-Center-Produktionsserver auf die gewünschte Version.

2. Führen Sie die Postupgrade-Scripts aus.

3. Führen Sie Tests durch und stellen Sie sicher, dass der E-Mail-Empfang über die Message-Center-Produktionsinstanz funktioniert.

4. Aktualisieren Sie die Clients und leeren Sie den Cache.

5. Packages exportieren:

   • Exportieren Sie Packages mit dem Client-Package-Export-Tool
   • Importieren Sie das Schema-Package
   • Melden Sie sich vom Client ab und wieder an
   • Aktualisieren Sie die Datenbank
   • Melden Sie sich ab und wieder an
   • Importieren Sie das Admin-Package
   • Importieren Sie das Content-Package
   • Importieren Sie das Content-Management-Package
   • Melden Sie sich ab und wieder an
   • Führen Sie eine kurze Prüfung der Workflows durch

6. Publizieren Sie Message-Center-Vorlagen, um sicherzugehen, dass die Schnittstelle zwischen den Servern und der Message-Center-Instanz funktioniert.

7. Führen Sie Tests durch, um sicherzustellen, dass E-Mails erfolgreich über die Message-Center-Produktionsinstanz empfangen werden.

8. Führen Sie Workflow-Tests bei der Produktion durch, um sicherzugehen, dass der Nachrichtenempfang funktioniert.

Mid-Sourcing

Im Kontext einer Mid-Sourcing-Umgebung müssen Sie die folgenden zusätzlichen Schritte ausführen, um eine Aktualisierung durchzuführen:

1. Kontakt Adobe-Kundenunterstützung um die Aktualisierung des Mid-Sourcing-Servers zu koordinieren.

2. Überprüfen Sie, ob die Version aktualisiert wurde, indem Sie einen Test-Link ausführen. Beispiel:

   http://[InsertServerURL]/r/test
   

Bei Konflikten

Konflikte identifizieren

Sie müssen das Synchronisierungsergebnis überprüfen. Dieser Schritt wird nur von On-Premise-Kunden ausgeführt. Für gehostete Kunden übernimmt diese Aufgabe das Hosting-Team. Es gibt zwei Möglichkeiten, das Synchronisationsergebnis anzuzeigen:

In der Befehlszeilenschnittstelle werden Fehler durch ein dreifaches Chevron ">>>"materialisiert und die Synchronisation wird automatisch angehalten. Warnungen werden durch ein doppeltes Chevron ">>"erzeugt und müssen nach Abschluss der Synchronisation behoben werden. Am Ende des Postupgrades wird an der Eingabeaufforderung eine Zusammenfassung angezeigt. Sie kann wie folgt aussehen:

YYYY-MM-DD HH:MM:SS.749Z 00002E7A 1 info log =========Summary of the update==========
YYYY-MM-DD HH:MM:SS.749Z 00002E7A 1 info log <instance name> instance, 6 warning(s) and 0 error(s) during the update.
YYYY-MM-DD HH:MM:SS.749Z 00002E7A 1 warning log The document with identifier 'mobileAppDeliveryFeedback' and type 'xtk:report' is in conflict with the new version.
YYYY-MM-DD HH:MM:SS.749Z 00002E7A 1 warning log The document with identifier 'opensByUserAgent' and type 'xtk:report' is in conflict with the new version.
YYYY-MM-DD HH:MM:SS.750Z 00002E7A 1 warning log The document with identifier 'deliveryValidation' and type 'nms:webApp' is in conflict with the new version.
YYYY-MM-DD HH:MM:SS.750Z 00002E7A 1 warning log Document of identifier 'nms:includeView‘ and type 'xtk:srcSchema' updated in the database and found in the file system. You will have to merge the two versions manually.

Wenn ein Warnhinweis aufgrund eines Konflikts von Ressourcen ausgegeben wird, muss ihn der Benutzer lösen.

Die postupgrade_ServerVersionNumber_TimeOfPostupgrade.log enthält das Synchronisierungsergebnis. Sie ist standardmäßig im folgenden Verzeichnis verfügbar: installationDirectory/var/instanceName/postupgrade. Fehler und Warnungen werden durch die Fehler- und Warnattribute angezeigt.

Konflikte analysieren

Wie wird ein Konflikt festgestellt?

Konflikte werden in der Datei postupgrade.log auf dem jeweiligen Server oder innerhalb der Adobe-Campaign-Clientkonsole festgestellt (Administration > Konfiguration > Packageverwaltung > Konflikte bearbeiten).

Das Dokument mit der Kennung ‘stockOverview’ vom Typ ‘nms:webApp’ steht im Konflikt mit der neuen Version.

Wenn ein Konflikt gefunden wird, prüfen Sie, ob Folgendes zutrifft:

• Wurde das Objekt vom Kunden geändert oder personalisiert?
• Wurde das Objekt innerhalb des Produkts geändert?

Wenn keine dieser Fragen bejaht wird, ist dies eine Falschmeldung und es besteht kein Konflikt. Wenn beide dieser Fragen bejaht werden, besteht tatsächlich ein Konflikt.

Wurde das Objekt vom Kunden geändert?

1. Identifizieren Sie das Objekt, das den Konflikt auslöst.
2. Fragen Sie den Kunden, ob er das Objekt verändert hat.
3. Ist an dem Objekt etwas ungewöhnlich?
4. Ist das letzte Änderungsdatum im Code des Objekts angegeben?
5. Prüfen Sie den XML-Code des Konflikts auf “_conflict”-Attribute. Sieht es nach einer Personalisierung aus?

Wurde das Objekt im neuen Build geändert?

1. Prüfen Sie die üblichen Verursacher: integrierte Web-Anwendungen oder Berichte (z. B.: 'deliveryValidation', 'deliveryOverview', 'budget').
2. Prüfen Sie die Änderungsprotokolle auf Updates.
3. Fragen Sie Adobe Campaign-Experten.
4. Führen Sie einen "Diff"-Befehl für den Code aus.

Beheben eines Konflikts

Gehen Sie wie folgt vor, um einen Konflikt zu lösen:

1. Gehen Sie im Adobe-Campaign-Explorer zu Administration > Konfiguration > Packageverwaltung > Konflikte bearbeiten.

2. Wählen Sie in der Liste den Konflikt aus, den Sie lösen möchten.
   Es gibt drei Möglichkeiten, Konflikte zu lösen: Neue Version akzeptieren, Aktuelle Version beibehalten, Zusammenführen des Codes (und Deklarieren als aufgelöst), Ignorieren des Konflikts (nicht empfohlen).

Wann kann ich die neue Version akzeptieren?

• Wenn Sie die Standardfunktionen beibehalten möchten.
• Wenn Sie keine Personalisierungen durchgeführt haben (alle Personalisierungen werden entfernt)

Wann kann ich die aktuelle Version beibehalten?

• Wenn Sie Personalisierungen durchgeführt haben
• Wenn Sie keine Zusammenführung durchführen möchten
• Wenn Sie das Konflikt auslösende Objekt nicht im Postupgrade korrigieren müssen

Wann soll ich eine Zusammenführung durchführen?

• Nur Formulare, Berichte und Webanwendungen können zusammengeführt werden.
• Einige geringfügige Zusammenführungen können durchgeführt werden, ohne den Code zu verstehen.
• Kompliziertere Zusammenführungen sollten jedoch von einer Fachkraft durchgeführt werden.
• Siehe Zusammenführen.

Was passiert, wenn ich Konflikte ignoriere?

• Der Konflikt bleibt bestehen.
• Das Objekt wird nicht aktualisiert.
• Langfristige Auswirkungen: Inkompatibilität der Versionen, der Kunde profitiert nicht von Fehlerkorrekturen.

Zusammenführen

Es gibt verschiedene Arten von Zusammenführungen:

1. Einfache Zusammenführung: benutzerdefinierte und neue Elemente sind klein und nicht miteinander verknüpft und es ist keine Kodierung erforderlich.
2. Keine Änderungen: die neue Version wird akzeptiert, nur letztes Aktualisierungsdatum wurde geändert, nur Kommentare, Tabs, Leerzeichen oder neue Zeilen. Beispiel: irrtümliches Speichern.
3. Triviale Änderungen: nur eine einzige Zeile wurde geändert. Beispiel: xpathToLoad
4. Kompliziertes Zusammenführen: wenn Code geschrieben werden muss. Entwicklerkenntnisse sind erforderlich. Siehe Komplexe Zusammenführungen.

Wie erfolgt die Zusammenführung?

1. Alle drei Versionen abrufen: die Originalversion, die neue Version und die benutzerdefinierte Version.
2. Führen Sie einen "Vergleich"zwischen der ursprünglichen und der neuen Version aus.
3. Isolieren Sie die Änderungen.
4. Wenn keine Änderungen vorhanden sind, lösen Sie den Konflikt, indem Sie die aktuelle Version beibehalten.

Wo finden Sie den Code?

1. Integrierter Code wird in XML-Dateien im Ordner datakit gespeichert. Suchen Sie die XML-Datei, die dem widersprüchlichen Objekt entspricht. Beispiel: installationDirectory\datakit\nms\fra\form\recipient.xml
2. Abrufen der Originalversion: über die Download-Center oder einer anderen nicht aktualisierten Installation des Produkts.
3. Rufen Sie die neue Version ab: über die Download-Center oder die vom Kunden installierten Dateien.
4. Rufen Sie die benutzerdefinierte Version ab: Rufen Sie den Quellcode des Objekts vom Campaign-Client ab.

Wie erstelle ich eine Diff-Datei?

1. Installieren Sie einen Text- oder Merge-Editor, z. B. Notepad ++, AraxisMerge oder WinMerge.
2. Öffnen Sie die Originaldatei und die neue Datei im Editor.
3. Führen Sie den Diff-Befehl aus (vergleichen Sie die beiden Dateien).
4. Stellen Sie etwaige Unterschiede fest.

Wie erfolgt die Zusammenführung?

1. Beginnen Sie mit der benutzerdefinierten Version.
2. Wenden Sie die Änderungen an.
3. Lösen Sie den Konflikt, indem Sie ihn als gelöst erklären.
4. Auf Nicht-Regressionen prüfen.

Wenn Sie den Konflikt manuell lösen möchten, gehen Sie folgendermaßen vor:

1. Suchen Sie im unteren Bereich des Fensters nach der conflict_string , um die Entitäten mit Konflikten zu finden. Die mit der neuen Version installierte Entität enthält das neue Argument. Die Entität, die mit der vorherigen Version übereinstimmt, enthält das benutzerdefinierte Argument.
2. Löschen Sie die Version, die Sie nicht beibehalten möchten. Löschen Sie die conflict_argument Zeichenfolge der Entität, die Sie beibehalten.
3. Gehen Sie zum gelösten Konflikt. Klicken Sie auf das Symbol Aktionen und wählen Sie Als gelöst deklarieren aus.
4. Speichern Sie Ihre Änderungen: Der Konflikt ist jetzt gelöst.

Komplexe Zusammenführungen

1. Verstehen Sie, was die Änderung bewirkt: die Änderungen rückgängig zu machen, die Änderungsprotokolle zu untersuchen und sich mit Adobe Campaign-Experten zu beraten.
2. Entscheiden Sie, was mit der Änderung zu tun ist.
3. Machen Sie sich mit den Anpassungen vertraut: Reverse Engineering der Änderungen

So nehmen Sie eine komplexe Zusammenführung vor:

1. Kopieren Sie Code aus der geänderten Version
2. Fügen Sie ihn in die benutzerdefinierte Version ein
3. Prüfung auf Nichtregressionen der Anpassung
4. Überprüfen Sie die Funktionsfähigkeit der Änderungen
5. Durchführen des Benutzerakzeptanztests
6. Führen Sie die Zusammenführung in einer Testumgebung durch.

Verwandte Themen

• Häufig gestellte Fragen zur Build-Aktualisierung
• Versionshinweise zu Campaign Classic
• Hilfe- und Support-Optionen für Campaign Classic
• Jährliches Upgrade-Programm für Campaign