Durchführen eines Build-Upgrades performing-a-build-upgrade
In diesem Abschnitt finden Sie eine ausführliche Anleitung zum Upgrade-Prozess und zu den Schritten zum Identifizieren und Beheben von Konflikten.
Das Build-Upgrade muss mit Vorsicht durchgeführt werden, seine Auswirkungen müssen zuvor vollständig berücksichtigt werden und das Verfahren muss mit einem hohen Maß an Disziplin abgeschlossen werden. Um ein erfolgreiches Upgrade sicherzustellen, stellen Sie sicher, dass nur erfahrene Benutzer die unten beschriebenen Schritte ausführen. Darüber hinaus empfehlen wir dringend, sich vor einem Upgrade an die Adobe-Kundenunterstützungwenden.
Die folgenden Voraussetzungen sind erforderlich:
- Kenntnis der Campaign-Architektur
- Kenntnis der Systeme und Server
- Administratorrechte und Berechtigungen
Adobe Campaign Weitere Informationen finden Sie in den folgenden Abschnitten: Aktualisieren von, Migrieren zu einer neuen Version.
Bei gehosteten und hybriden Instanzen müssen Sie das Build-Upgrade an das Adobe-Team für technische Vorgänge anfordern. Weiterführende Informationen hierzu finden Sie im Abschnitt Häufig gestellte Fragen unten auf dieser Seite. Lesen Sie auch die häufig gestellte Fragen zum Build-Upgrade.
Upgrade vorbereiten
Bevor Sie mit dem Build-Upgrade beginnen, müssen Sie eine vollständige Vorbereitung wie unten beschrieben durchführen.
Sobald das System für ein Upgrade bereit ist, dauert ein Build-Upgrade mindestens 2 Stunden.
Für das Build-Upgrade sind die folgenden Ressourcen erforderlich:
- Ein Adobe-Architekt: Zum Verständnis der Datenbankstrukturen (vordefinierte Schemata und alle zusätzlichen Schemata, die hinzugefügt wurden, Kampagnendesigns und alle kritischen Pfadfunktionen, die in einer bestimmten Reihenfolge gestartet und getestet werden müssen).
- Projektmanager: Für den Fall, dass das Build-Upgrade viele verschiedene Instanzen (Produktion, Staging, Tests) und andere Server und Anwendungen von Drittanbietern (Datenbanken, SFTP-Sites, Messaging-Service-Provider) umfasst, ist es als Best Practice zu betrachten, einen Projektmanager zu haben, der alle Tests koordiniert.
- 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): Für ein erfolgreiches Upgrade ist die Fähigkeit des Benutzers erforderlich, seine täglichen Aufgaben erfolgreich auszuführen. Aus diesem Grund sollten Sie immer mindestens einen Ihrer täglichen Benutzer in Ihre Tests der aktualisierten Server einbeziehen.
Planung
Dies sind die wichtigsten Schritte zur Planung eines Build-Upgrades:
- Planen Sie mindestens zwei Stunden für das Upgrade ein.
- Stellen Sie Kontaktdetails für Adobe- und Kundenmitarbeiter bereit.
- Für gehostete Instanzen: die Adobe- und Kundenmitarbeiter bestimmen den Zeitpunkt des Upgrades sowie die Person, die ihn durchführt.
- 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.
- Ermitteln und bestätigen Sie, auf welche Version von Adobe Campaign Sie ein Upgrade durchführen möchten - lesen Sie die Versionshinweise zu Adobe Campaign Classic.
- Bestätigen Sie das Vorhandensein ausführbarer Upgrade-Dateien.
Schlüsselpersonen
Für den Build-Upgrade-Prozess müssen die folgenden Personen beteiligt sein:
-
Adobe-Architekt: Bei gehosteten oder hybriden Architekturen muss sich der Architekt mit der Adobe Campaign-Kundenunterstützung abstimmen.
-
Projektmanager:
-
Bei On-Premise-Installationen: Der interne Projektleiter des Kunden leitet das Upgrade und verwaltet Lebenszyklustests.
-
bei gehosteter Installation: Das Hosting-Team arbeitet mit dem Adobe Campaign-Kundenunterstützungs-Team und dem Kunden zusammen, um den Zeitplan für die Aktualisierung für alle Instanzen zu koordinieren.
-
-
Adobe Campaign-Administrator:
-
Bei On-Premise-Installationen: Der Administrator führt das Upgrade durch.
-
für gehostete Installationen: Das Hosting-Team führt das Upgrade durch.
-
-
Adobe Campaign-Benutzer/Marketing-Benutzer: Der Benutzer führt Tests für Entwicklungs-, Test- und Produktionsinstanzen durch.
Build-Upgrade vorbereiten
Vor Beginn des Build-Upgrades müssen On-Premise-Kunden die folgende Vorbereitung durchführen:
-
Vergewissern Sie sich, dass alle Entwicklungsarbeiten exportiert werden können, bevor das Upgrade durchgeführt wird. Führen Sie den Export als Packages durch.
-
Führen Sie ein vollständiges Backup der Datenbanken für alle Instanzen der Quell- und Zielumgebung durch.
-
Erhalten Sie die neueste Version Ihrer Server-Konfigurationsdatei.
-
Laden Sie den neuesten Build herunter. Weitere Informationen.
Außerdem müssen Sie alle nützlichen Befehlszeilen“ kennen bevor Sie ein Build-Upgrade starten:
- nlserver pdump: listet aktuelle Prozesse auf
- nlserver pdump -who: listet aktive Client-Sitzungen auf
- nlserver monitor -missing: listet fehlende Eigenschaften auf
- nlserver start process@instance-name: Startet einen Prozess
- nlserver stop process@instance-name: Beendet einen Prozess
- nlserver restart process@instance-name: Startet einen Prozess neu
- nlserver shutdown: Beendet alle Campaign-Prozesse
- nlserver watchdog -svc: startet den Watchdog-Prozess (nur UNIX)
Durchführen des Upgrades
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 im Folgenden das detaillierte Verfahren beschrieben.
Duplizieren der Umgebung
So duplizieren Sie eine Adobe Campaign-Umgebung, um eine Quellumgebung in einer Zielumgebung wiederherzustellen, was zu zwei identischen Arbeitsumgebungen führt.
Gehen Sie dazu wie folgt vor:
-
Erstellen Sie eine Kopie der Datenbanken auf allen Instanzen in der Quellumgebung.
-
Stellen Sie diese Kopien auf allen Instanzen der Zielumgebung wieder her.
-
Führen Sie Skript ":freezeInstance.js vor dem Start in der Zielumgebung aus. Dadurch werden alle Prozesse gestoppt, die mit der Außenwelt interagieren: Protokolle, Tracking, Sendungen, Kampagnen-Workflows usw.
code language-none nlserverjavacsriptnms:freezeInstance.js–instance:<dev> -arg:run
-
Die Kauterisierung wie folgt überprüfen:
-
Vergewissern Sie sich, dass nur der Versandteil mit der ID "":
code language-none SELECT * FROM neolane.nmsdeliverypart;
-
Vergewissern Sie sich, dass die Versandstatus-Aktualisierung korrekt ist:
code language-none SELECT iSate, count(*) FROM neolane.nmsdeliveryGroup By iProd;
-
Vergewissern Sie sich, dass die Workflow-Status-Aktualisierung korrekt ist:
code language-none SELECT iState, count (*) FROM neolane.xtkworkflowGROUP BY iState; SELECT iStatus, count (*) FROM neolane.xtkworkflowGROUP BY iStatus;
-
Dienste beenden
Um alle Dateien durch die neue Version zu ersetzen, müssen alle Instanzen des nlserverservice heruntergefahren werden.
-
Beenden Sie die folgenden Dienste:
- Webdienste (IIS): iisreset/stop
- Adobe-Campaign-Dienst: net stop nlserver6
note note NOTE Stellen Sie sicher, dass der Weiterleitungsserver (webmdl) gestoppt ist, damit die von IIS verwendete Datei „nlsrvmod.dll“ durch die neue Version ersetzt werden kann. -
Überprüfen Sie, ob keine Aufgaben aktiv sind, indem Sie den Befehl nlserver pdump ausführen. Wenn keine Aufgaben vorhanden sind, sollte die Ausgabe der folgenden ähneln:
code language-none C:\<installation path>\bin>nlserverpdump HH:MM:SS > Application Server for Adobe Campaign version x.x (build xxx) dated xx/xx/xxxx No tasks
-
Überprüfen Sie im Windows Task-Manager, ob alle Prozesse angehalten wurden.
Aktualisieren der Adobe Campaign-Serveranwendung
-
Führen Sie die Datei Setup.exe aus. Wenn Sie diese Datei herunterladen müssen, rufen Sie Download-Center auf.
-
Wählen Sie den Installationsmodus aus: Aktualisieren oder Reparieren.
-
Klicken Sie auf Weiter.
-
Wählen Sie Beenden aus: Die neue Datei wird vom Installationsprogramm kopiert.
-
Wählen Sie nach Abschluss des Vorgangs die Option Beenden aus.
Ressourcen synchronisieren
-
Öffnen Sie die Befehlszeile.
-
Führen Sie nlserver config -postupgrade -allinstances aus, um Folgendes durchzuführen:
- Ressourcen synchronisieren
- Schemata aktualisieren
- Aktualisieren der Datenbank
note note NOTE Dieser Vorgang sollte nur einmal und nur auf einem nlserverwebanwendungsserver ausgeführt werden. Um nur eine Datenbank zu synchronisieren, führen Sie den folgenden Befehl aus:
code language-none nlserver config -postupgrade -instance: <instance_name>
-
Überprüfen Sie, ob bei der Synchronisierung Fehler oder Warnungen erzeugt wurden.
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 auf demselben Build wie die Server-Instanz erstellt werden.
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 zu aktualisieren.
Transaktionsnachrichten
Wenn Transaktionsnachrichten (Message Center) auf Ihrer Campaign-Instanz aktiviert ist, müssen Sie diese zusätzlichen Schritte ausführen, um ein Upgrade durchzuführen:
-
Aktualisieren Sie den Message-Center-Produktionsserver auf die gewünschte Version.
-
Führen Sie die Postupgrade-Scripts aus.
-
Führen Sie Tests durch und stellen Sie sicher, dass der E-Mail-Empfang über die Message-Center-Produktionsinstanz funktioniert.
-
Aktualisieren Sie die Clients und leeren Sie den Cache.
-
Packages exportieren:
- Exportieren von Paketen mit dem Tool zum Exportieren von Clientpaketen
- Schemapaket importieren
- Client trennen und erneut verbinden
- Datenbank aktualisieren
- Trennen und erneut verbinden
- Admin-Paket importieren
- Inhaltspaket importieren
- Content-Management-Paket importieren
- Trennen und erneut verbinden
- Durchführen einer schnellen Konsistenzprüfung von Workflows
-
Publizieren Sie Message-Center-Vorlagen, um sicherzugehen, dass die Schnittstelle zwischen den Servern und der Message-Center-Instanz funktioniert.
-
Führen Sie Tests durch, um sicherzustellen, dass E-Mails erfolgreich über die Produktionsinstanz von Message Center empfangen werden.
-
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 ein Upgrade durchzuführen:
-
Wenden Sie sich an die AdobeKundenunterstützung, um das Upgrade des Mid-Sourcing-Servers zu koordinieren.
-
Überprüfen Sie, ob die Version aktualisiert wurde, indem Sie einen Test-Link ausführen. Beispiel:
code language-none 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 einen dreifachen Chevron '>>>' materialisiert und die Synchronisierung wird automatisch angehalten. Warnungen werden durch einen doppelten Pfeil ">>" materialisiert und müssen nach Abschluss der Synchronisierung aufgelöst werden. Am Ende des Postupgrades wird in der Eingabeaufforderung eine Zusammenfassung angezeigt. Er 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 die Warnung einen Ressourcenkonflikt betrifft, ist ein Eingreifen des Benutzers erforderlich, um ihn zu lösen.
Die Datei postupgrade_ServerVersionNumber_TimeOfPostupgrade.log enthält das Synchronisierungsergebnis. Sie ist standardmäßig im folgenden Verzeichnis verfügbar: installationDirectory/var/<instance-name>
/postupgrade. Fehler und Warnungen werden durch die Attribute error und warning gekennzeichnet.
Konflikte analysieren
Wie kommt es zu einem Konflikt?
Konflikte finden sich im Protokoll „postupgrade.log“ auf dem betreffenden Server oder in der Client-Benutzeroberfläche von Campaign (Administration > Konfiguration > Paketverwaltung > 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?
- Identifizieren Sie das Objekt, das den Konflikt auslöst.
- Fragen Sie den Kunden, ob er das Objekt verändert hat.
- Ist an dem Objekt etwas ungewöhnlich?
- Ist das letzte Änderungsdatum im Code des Objekts angegeben?
- Untersuchen Sie den XML-Code aus dem Konflikt auf „_konflikt“-Attribute. Sieht es wie eine Anpassung aus?
Wurde das Objekt im neuen Build geändert?
- Prüfen Sie die üblichen Verursacher: integrierte Web-Anwendungen oder Berichte (z. B.: 'deliveryValidation', 'deliveryOverview', 'budget').
- Prüfen Sie die Änderungsprotokolle auf Updates.
- Fragen Sie Adobe Campaign-Fachleute.
- Führen Sie einen "Diff"-Befehl für den Code aus.
Konflikt lösen
Gehen Sie wie folgt vor, um einen Konflikt zu lösen:
-
Gehen Sie im Adobe-Campaign-Explorer zu Administration > Konfiguration > Packageverwaltung > Konflikte bearbeiten.
-
Wählen Sie in der Liste den Konflikt aus, den Sie auflösen möchten.
Es gibt drei Optionen zum Beheben von Konflikten: Neue Version akzeptieren, Aktuelle Version beibehalten, Code zusammenführen (und als aufgelöst deklarieren) Konflikt ignorieren (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 eine Zusammenführung durchgeführt werden?
- 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 Durchführen einer Zusammenführung.
Was ist, wenn ich die Konflikte ignoriere?
- Der Konflikt bleibt bestehen.
- Das Objekt wird nicht aktualisiert.
- Langfristige Auswirkungen: Inkompatibilität der Versionen, der Kunde profitiert nicht von Fehlerkorrekturen.
Zusammenführung durchführen perform-a-merge
Es gibt verschiedene Arten von Zusammenführungen:
- Einfaches Zusammenführen: Benutzerdefinierte und neue Elemente sind klein und nicht verwandt, und es ist keine Codierung erforderlich.
- Keine Änderungen: die neue Version wird akzeptiert, nur letztes Aktualisierungsdatum wurde geändert, nur Kommentare, Tabs, Leerzeichen oder neue Zeilen. Beispiel: irrtümliches Speichern.
- Triviale Änderungen: nur eine einzige Zeile wurde geändert. Beispiel: xpathToLoad
- Komplexe Zusammenführung: wenn Kodierung erforderlich ist. Entwicklungsfähigkeiten sind erforderlich. Siehe Komplexe Zusammenführungen.
Wie erfolgt die Zusammenführung?
- Rufen Sie alle drei Versionen ab: die Originalversion, die neue Version und die benutzerdefinierte Version.
- Führen Sie einen „Unterschied“ zwischen der ursprünglichen und der neuen Version aus.
- Isolieren Sie die Änderungen.
- Wenn keine Änderungen vorhanden sind, lösen Sie den Konflikt, indem Sie die aktuelle Version beibehalten.
Wo finden Sie den Code?
- Der integrierte Code wird in XML-Dateien im Datakit-Ordner gespeichert. Suchen Sie die XML-Datei, die dem widersprüchlichen Objekt entspricht. Beispiel: installationDirectory\datakit\nms\fra\form\recipient.xml
- Rufen Sie die Originalversion ab: über Download-Center oder eine andere nicht aktualisierte Installation des Produkts.
- Rufen Sie die neue Version ab: über Download-Center oder die installierten Dateien des Kunden.
- Rufen Sie die benutzerdefinierte Version ab: Rufen Sie den Quellcode des Objekts vom Campaign-Client ab.
Wie erstelle ich eine Diff-Datei?
- Installieren Sie einen Text- oder Merge-Editor, z. B. Notepad ++, AraxisMerge oder WinMerge.
- Öffnen Sie die Originaldatei und die neue Datei im Editor.
- Führen Sie den Diff-Befehl aus (vergleichen Sie die beiden Dateien).
- Stellen Sie etwaige Unterschiede fest.
Wie erfolgt die Zusammenführung?
- Beginnen Sie mit der benutzerdefinierten Version.
- Wenden Sie die Änderungen an.
- Lösen Sie den Konflikt, indem Sie ihn für gelöst erklären.
- Auf Nicht-Regressionen prüfen.
Wenn Sie den Konflikt manuell lösen möchten, gehen Sie folgendermaßen vor:
- Suchen Sie im unteren Abschnitt 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 mit der vorherigen Version übereinstimmende Entität enthält das benutzerdefinierte Argument.
- Löschen Sie die Version, die Sie nicht behalten möchten. Löschen Sie die CONFLICT_ARGUMENT-Zeichenfolge der Entität, die Sie beibehalten.
- Navigieren Sie zu dem Konflikt, den Sie gelöst haben. Klicken Sie auf Aktionen und wählen Sie Als aufgelöst deklarieren aus.
- Speichern Sie Ihre Änderungen: Der Konflikt ist jetzt gelöst.
Komplexe Zusammenführungen complex-merges
- Machen Sie sich mit den Auswirkungen der Änderung vertraut: Reverse Engineering der Änderungen, Prüfung der Änderungsprotokolle, Follow-up mit Adobe Campaign-Experten.
- Entscheide, was mit der Änderung geschehen soll.
- Verstehen, was die Anpassungen bewirken: Änderungen zurückentwickeln
So nehmen Sie eine komplexe Zusammenführung vor:
- Kopieren Sie Code-Bits aus dem Änderungssatz
- In die angepasste Version einfügen
- Testen auf Nicht-Regressionen der Anpassung
- Testen der Funktion von Änderungen
- Durchführen von Benutzerakzeptanztests
- Führen Sie die Zusammenführung in einer Testumgebung durch.
Verwandte Themen