Esecuzione di un aggiornamento della build performing-a-build-upgrade
Questa sezione fornisce una descrizione dettagliata del processo di aggiornamento e dei passaggi per identificare e risolvere i conflitti.
L’aggiornamento della build deve essere eseguito con cautela, i suoi impatti devono essere considerati in anticipo e la procedura deve essere completata con un livello elevato di disciplina. Per garantire un aggiornamento corretto, accertati che solo gli utenti esperti eseguano i passaggi descritti di seguito. Inoltre, consigliamo vivamente di contattare l'Assistenza clienti Adobe prima di avviare qualsiasi aggiornamento.
Sono necessari i seguenti prerequisiti:
- Informazioni sull’architettura di Campaign
- Conoscenza dei sistemi e dei server
- Diritti e autorizzazioni amministrativi
Puoi trovare ulteriori informazioni nelle seguenti sezioni: Aggiornamento di Adobe Campaign, Migrazione a una nuova versione.
Per le istanze in hosting e ibride, devi richiedere l’aggiornamento della build al team Operazioni tecniche Adobe. Per ulteriori informazioni, consulta la sezione Domande frequenti in basso, se questa pagina. Consulta anche le domande frequenti sull'aggiornamento della build.
Preparare l’aggiornamento
Prima di avviare l’aggiornamento della build, devi eseguire una preparazione completa come descritto di seguito.
Una volta che il sistema è pronto per essere aggiornato, un aggiornamento della build richiede almeno 2 ore.
Il processo di aggiornamento della build richiede le seguenti risorse:
- un architetto Adobe: per comprendere le strutture del database (schemi predefiniti ed eventuali schemi aggiuntivi aggiunti, progettazioni di campagne ed eventuali funzionalità di percorso critiche che devono essere avviate e testate in un ordine specifico).
- un project manager: nel caso in cui l’aggiornamento della build coinvolga molte istanze diverse (produzione, staging, test) e altri server e applicazioni di terze parti (database, siti SFTP, provider di servizi di messaggistica), è considerata una best practice disporre di un project manager per coordinare tutti i test.
- amministratore di Adobe Campaign: l’amministratore conosce la configurazione del server, compresi, tra l’altro: sicurezza, layout delle cartelle, reporting e requisiti di importazione/esportazione. Non eseguire un aggiornamento della build senza l’amministratore.
- un operatore di Adobe Campaign (utente marketing): un aggiornamento corretto si basa sulla capacità dell’utente di eseguire correttamente le attività quotidiane. Per questo motivo, includi sempre almeno uno degli operatori giornalieri nel test dei server aggiornati.
Pianificazione
Di seguito sono riportati i punti chiave su come pianificare un aggiornamento della build:
- Riserva almeno 2 ore per l’aggiornamento.
- Distribuisci i dettagli di contatto per il personale Adobe e del cliente.
- Per le istanze in hosting: il personale di Adobe e del cliente coordinerà il tempo per l’aggiornamento e chi verrà eseguito.
- Per le istanze on-premise: il personale del cliente gestisce l’intero processo; se è necessaria assistenza nella verifica di flussi di lavoro personalizzati e nella logica di consegna, è necessario inserire i servizi di consulenza.
- Determinare e confermare a quale versione di Adobe Campaign si desidera eseguire l'aggiornamento. Consultare le note sulla versione di Adobe Campaign Classic.
- Confermare il possesso dei file eseguibili di aggiornamento.
Persone chiave
Il processo di aggiornamento della build richiede il coinvolgimento delle seguenti persone:
-
Architetto di Adobe: per le architetture in hosting o ibride, l’architetto deve coordinarsi con l’Assistenza clienti di Adobe Campaign.
-
Project manager:
-
per le installazioni on-premise: il responsabile di progetto interno del cliente guida l’aggiornamento e gestisce i test del ciclo di vita.
-
per l’installazione in hosting: il team di hosting collaborerà con il team di assistenza clienti di Adobe Campaign e con il cliente per coordinare la timeline di aggiornamento per tutte le istanze.
-
-
Amministratore Adobe Campaign:
-
per le installazioni locali: l’amministratore esegue l’aggiornamento.
-
per le installazioni in hosting: il team di hosting esegue l’aggiornamento.
-
-
Adobe Campaign operator\marketing user (operatore di marketing): esegue test sulle istanze di sviluppo, test e produzione.
Preparare l’aggiornamento della build
Prima di avviare l’aggiornamento della build, i clienti on-premise devono eseguire la seguente preparazione:
-
Assicurati che qualsiasi lavoro di sviluppo possa essere esportato prima dell’aggiornamento ed esporta come pacchetti.
-
Eseguire un backup completo dei database per tutte le istanze degli ambienti di origine e di destinazione.
-
Ottieni la versione più recente del file di configurazione del server.
È inoltre necessario conoscere tutte le righe di comando utili prima di avviare un aggiornamento della build:
- nlserver pdump: elenca i processi in esecuzione
- nlserver pdump -who: elenca le sessioni client attive
- nlserver monitor -missing: elenca le proprietà mancanti
- nlserver start process@instance-name: avvia un processo
- nlserver stop process@instance-name: arresta un processo
- nlserver restart process@instance-name: riavvia un processo
- nlserver shutdown: arresta tutti i processi di Campaign
- nlserver watchdog -svc: avvia il watchdog (solo UNIX)
Eseguire l’aggiornamento
Le procedure seguenti vengono eseguite solo dai clienti on-premise. Per i clienti in hosting, viene gestito dal team di hosting. Per aggiornare Adobe Campaign a una nuova build, la procedura dettagliata è descritta di seguito.
Duplicare l’ambiente
Ecco come duplicare un ambiente Adobe Campaign per ripristinare un ambiente di origine in un ambiente di destinazione, creando due ambienti di lavoro identici.
A questo scopo, segui la procedura indicata di seguito:
-
Creare una copia dei database in tutte le istanze nell'ambiente di origine.
-
Ripristina queste copie in tutte le istanze dell’ambiente di destinazione.
-
Eseguire lo script di cauterizzazione nms:freezeInstance.js nell'ambiente di destinazione prima di avviarlo. In questo modo tutti i processi interagiscono con l’esterno: registri, tracciamento, consegne, flussi di lavoro delle campagne, ecc.
code language-none nlserverjavacsriptnms:freezeInstance.js–instance:<dev> -arg:run -
Controllare la cauterizzazione, come segue:
-
Verificare che l'unica parte di consegna sia quella con ID impostato su 0:
code language-none SELECT * FROM neolane.nmsdeliverypart; -
Verifica che l’aggiornamento dello stato della consegna sia corretto:
code language-none SELECT iSate, count(*) FROM neolane.nmsdeliveryGroup By iProd; -
Verifica che l’aggiornamento dello stato del flusso di lavoro sia corretto:
code language-none SELECT iState, count (*) FROM neolane.xtkworkflowGROUP BY iState; SELECT iStatus, count (*) FROM neolane.xtkworkflowGROUP BY iStatus;
-
Arresta servizi
Per sostituire tutti i file con la nuova versione, è necessario che tutte le istanze di nlserverservice vengano chiuse.
-
Arrestare i servizi seguenti:
- Servizi Web (IIS): iisreset /stop
- Servizio Adobe Campaign: net stop nlserver6
note note NOTE Verificare che il server di reindirizzamento (webmdl) sia arrestato, in modo che il file nlsrvmod.dll utilizzato da IIS possa essere sostituito con la nuova versione. -
Verificare che nessuna attività sia attiva eseguendo il comando nlserver pdump. Se non sono presenti attività, l’output deve essere simile al seguente:
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 -
Verificare che tutti i processi siano stati arrestati.
Aggiornare l’applicazione server Adobe Campaign
-
Eseguire il file Setup.exe. Se devi scaricare questo file, accedi a Centro download.
-
Selezionare la modalità di installazione: Aggiorna o Ripristina.
-
Fai clic su Avanti.
-
Fare clic su Fine: il programma di installazione copia i nuovi file.
-
Al termine dell'operazione, fare clic su Fine.
Sincronizzare le risorse
-
Apri la riga di comando.
-
Eseguire nlserver config -postupgrade -allinstances per eseguire le operazioni seguenti:
- Sincronizzare le risorse
- Aggiornare schemi
- Aggiornare il database
note note NOTE Questa operazione deve essere eseguita una sola volta e solo su un server applicazioni nlserverweb. Per sincronizzare un solo database, eseguire il comando seguente:
code language-none nlserver config -postupgrade -instance: <instance_name> -
Verificare se la sincronizzazione ha generato errori o avvisi.
Riavvia servizi
È necessario riavviare i seguenti servizi:
- Servizi Web (IIS): issreset /start
- Servizio Adobe Campaign: net start nlserver6
Aggiornamento delle console client
La console client deve trovarsi nella stessa build dell’istanza del server.
Nel computer in cui è installato il server applicazioni di Adobe Campaign (nlserverweb), scarica e copia il file:
Setup-client-7.xxxx.exe in [path of the application]\datakit\nl\en\jsp
Alla successiva connessione delle console client, una finestra informa gli utenti della disponibilità di un nuovo aggiornamento e offre loro la possibilità di scaricarlo e installarlo.
Compiti aggiuntivi specifici
Alcune configurazioni richiedono attività aggiuntive specifiche per l’aggiornamento a una nuova build.
Messaggistica transazionale
Quando la messaggistica transazionale (Centro messaggi) è abilitata nell’istanza Campaign, è necessario eseguire questi passaggi aggiuntivi per aggiornare:
-
Aggiornare il server di produzione del Centro messaggi alla versione scelta.
-
Eseguire gli script post-aggiornamento.
-
Esegui i test e assicurati che le e-mail vengano ricevute correttamente tramite l’istanza di produzione del Centro messaggi.
-
Aggiornare i client e cancellare la cache.
-
Esporta pacchetti:
- Esportare i pacchetti utilizzando lo strumento di esportazione dei pacchetti client
- Importa pacchetto schema
- Disconnetti e riconnetti client
- Aggiorna database
- Disconnetti e riconnetti
- Importa pacchetto di amministrazione
- Importa pacchetto contenuti
- Importa pacchetto gestione contenuti
- Disconnetti e riconnetti
- Eseguire un rapido controllo di integrità dei flussi di lavoro
-
Modelli di Centro messaggi di Publish per garantire il funzionamento dell'interfaccia tra i server e l'istanza del Centro messaggi.
-
Esegui i test per garantire che le e-mail vengano ricevute correttamente tramite l’istanza di produzione del Centro messaggi.
-
Esegui test del flusso di lavoro in produzione per garantire che le consegne siano ricevute.
Mid-sourcing
Nel contesto di un ambiente di mid-sourcing, è necessario eseguire questi passaggi aggiuntivi per aggiornare:
-
Contatta l'Assistenza clienti Adobe per coordinare l'aggiornamento del server Mid-Sourcing.
-
Verifica che la versione sia stata aggiornata eseguendo un collegamento di test. Ad esempio:
code language-none http://[InsertServerURL]/r/test
In caso di conflitti
Identificare i conflitti
È necessario controllare il risultato della sincronizzazione. Questa procedura viene eseguita solo dai clienti on-premise. Per i clienti in hosting, viene gestito dal team di hosting. Esistono due modi per visualizzare il risultato della sincronizzazione:
Nell'interfaccia della riga di comando, gli errori vengono materializzati da una tripla freccia '>>>' e la sincronizzazione viene interrotta automaticamente. Gli avvisi vengono materializzati da una doppia freccia '>>' e devono essere risolti al termine della sincronizzazione. Al termine del post-aggiornamento, al prompt dei comandi viene visualizzato un riepilogo. Può essere simile al seguente:
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.
Se l’avviso riguarda un conflitto di risorse, è necessario l’attenzione dell’utente per risolverlo.
Il file postupgrade_ServerVersionNumber_TimeOfPostupgrade.log contiene il risultato della sincronizzazione. È disponibile per impostazione predefinita nella seguente directory: installationDirectory/var/<instance-name>/postupgrade. Gli errori e gli avvisi sono indicati dagli attributi di errore e di avviso.
Analizzare i conflitti
Come è stato trovato un conflitto?
I conflitti si trovano all’interno del file postupgrade.log sul server in questione o all’interno dell’interfaccia client di Campaign (Amministrazione > Configurazione > Gestione pacchetti > Modifica conflitti).
Il documento con identificatore "stockOverview" e tipo "nms:webApp" è in conflitto con la nuova versione.
Se viene rilevato un conflitto, verifica se le seguenti condizioni corrispondono:
- L'oggetto è stato modificato o personalizzato dal cliente?
- L’oggetto è stato modificato nel prodotto?
Se non si applica nessuna di queste condizioni, si tratta di un falso positivo. Se si applicano entrambe queste condizioni, è stato trovato un vero conflitto.
L'oggetto è stato modificato dal cliente?
- Identificare l'oggetto in conflitto.
- Chiedere al cliente se ha modificato l'oggetto.
- C'è qualcosa di insolito nell'oggetto?
- La data dell'ultima modifica è impostata nel codice dell'oggetto?
- Esaminate il codice XML dal conflitto per gli attributi "_conflitto". Ti sembra una personalizzazione?
L'oggetto è stato modificato nella nuova compilazione?
- Qualche "solito sospetto"? Applicazioni web o rapporti incorporati (ad esempio, "deliveryValidation", "deliveryOverview", "budget").
- Esaminare i registri delle modifiche per individuare eventuali aggiornamenti.
- Chiedi agli esperti di Adobe Campaign.
- Esegui una "diff" sul codice.
Risolvere un conflitto
Per risolvere i conflitti, attenersi alla seguente procedura:
-
In Adobe Campaign Explorer, vai a Amministrazione > Configurazione > Gestione pacchetti > Modifica conflitti.
-
Selezionare il conflitto che si desidera risolvere nell'elenco.
Sono disponibili tre opzioni per risolvere i conflitti: Accetta la nuova versione, Mantieni la versione corrente, Unisci il codice (e dichiaralo risolto), Ignora il conflitto (scelta non consigliata).
Quando posso accettare la nuova versione?
- Se desiderate utilizzare le feature standard.
- Se non hai personalizzazioni (tutte le personalizzazioni verranno rimosse)
Quando posso mantenere la versione corrente?
- Se disponi di personalizzazioni
- Se non si desidera eseguire l'unione
- Se non è necessario correggere l'oggetto in conflitto dall'aggiornamento
Quando eseguire un'unione?
- È possibile unire solo maschere, report e applicazioni Web.
- Alcune unioni minori possono essere risolte senza comprendere il codice.
- Unioni più complesse dovrebbero essere eseguite da un utente con le competenze e le capacità appropriate.
- Vedere Eseguire un'unione.
Cosa succede se ignoro i conflitti?
- Il conflitto rimarrà
- L'oggetto non verrà aggiornato
- Impatti a lungo termine: incompatibilità di versione, il cliente non trarrà vantaggio dalle correzioni di bug.
Eseguire un'unione perform-a-merge
Esistono diversi tipi di unione:
- Unione semplice: gli elementi personalizzati e nuovi sono piccoli e non correlati e non è richiesta alcuna codifica.
- Nessuna modifica: accetta la nuova versione, cambia solo la data dell’ultimo aggiornamento, solo commenti, tabulazioni, spazi o nuove righe. Esempio: salvataggio accidentale.
- Modifiche banali: è stata modificata solo una riga. Esempio: xpathToLoad
- Unione complessa: quando è richiesta la codifica. Sono necessarie competenze di sviluppo. Vedi Unioni complesse.
Come si esegue l'unione?
- Scarica tutte e tre le versioni: la versione originale, la nuova versione e la versione personalizzata.
- Esegui una "differenza" tra la versione originale e quella nuova.
- Isolare le modifiche.
- Se non vengono apportate modifiche, risolvi il problema mantenendo la versione corrente.
Dove trovare il codice?
- Il codice incorporato viene memorizzato in file XML nella cartella del datakit. Trovare il file XML corrispondente all'oggetto in conflitto. Esempio: installationDirectory\datakit\nms\fra\form\recipient.xml
- Recuperare la versione originale tramite l'Area download o un'altra installazione non aggiornata del prodotto.
- Recupera la nuova versione tramite l'Area download o i file installati del cliente.
- Recuperare la versione personalizzata: recupera il codice sorgente dell’oggetto dall’interno del client Campaign.
Come fare una differenza?
- Installare un editor di testo o di unione, ad esempio Blocco note ++, AraxisMerge, WinMerge.
- Apri il file originale e il nuovo file nell’editor.
- Esegui la differenza (confronta i due file).
- Identifica eventuali differenze.
Come si esegue l'unione?
- Inizia dalla versione personalizzata.
- Applica le modifiche.
- Risolvere il conflitto dichiarandolo risolto.
- Verificare la presenza di non regressioni.
Se si sceglie di risolvere il conflitto manualmente, procedere come segue:
- Nella sezione inferiore della finestra, cerca la stringa_conflitto per individuare le entità con conflitti. L’entità installata con la nuova versione contiene il nuovo argomento, l’entità che corrisponde alla versione precedente contiene l’argomento personalizzato.
- Elimina la versione che non desideri mantenere. Eliminare la stringa conflitto_argomento dell'entità che si desidera mantenere.
- Passare al conflitto risolto. Fai clic sull'icona Azioni e seleziona Dichiara come risolte.
- Salva le modifiche: il conflitto è stato risolto.
Unioni complesse complex-merges
- Scopri le funzioni della modifica: decodificare le modifiche, esaminare i registri di modifica e consultare gli esperti di Adobe Campaign.
- Decidi cosa fare con la modifica.
- Informazioni sulle personalizzazioni: decodificare le modifiche
Di seguito sono riportati i passaggi per eseguire un’unione complessa:
- Copiare bit di codice dal set di modifiche
- Incolla nella versione personalizzata
- Test di non regressione della personalizzazione
- Verifica della funzione delle modifiche
- Esegui test di accettazione utente
- Esecuzione in ambiente di test
Argomenti correlati