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 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
Per ulteriori informazioni, consulta le sezioni seguenti: 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 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, è necessario un aggiornamento della build 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 desideri eseguire l’aggiornamento: consulta 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.
-
Scarica 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
- Monitor nlserver - mancante: elenca le proprietà mancanti
- avvio nlserver process@instance-name: avvia un processo
- nlserver stop process@instance-name: interrompe un processo
- riavvio nlserver process@instance-name: riavvia un processo
- Arresto nlserver: arresta tutti i processi di Campaign
- watchdog nlserver - svc: avvia il watchdog (solo UNIX)
Eseguire l’aggiornamento
Le procedure seguenti vengono eseguite solo da on-premise clienti. 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.
-
Esegui il nms:freezeInstance.js script di cauterizzazione 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:
-
Verifica 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 non siano attive attività eseguendo il comando nlserver pdump comando. 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
-
Esegui il Setup.exe file. Se devi scaricare questo file, accedi Centro di download.
-
Selezionare la modalità di installazione: Aggiorna o Ripara.
-
Clic Successivo.
-
Clic Fine: il programma di installazione copia i nuovi file.
-
Al termine dell’operazione, fai clic su Fine.
Sincronizzare le risorse
-
Apri la riga di comando.
-
Esegui 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
-
Pubblica i modelli del Centro messaggi 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:
-
Contatto 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 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 viene 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 build?
- 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.
Per risolvere i conflitti sono disponibili tre opzioni: 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.
- Consulta 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. Consulta 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
- Recupera la versione originale: tramite Centro di download o un'altra installazione non aggiornata del prodotto.
- Recupera la nuova versione: tramite Centro di 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, cercare string_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. Elimina argomento_conflitto stringa dell’entità che stai mantenendo.
- Passare al conflitto risolto. Fai clic su Azioni e seleziona Dichiara come risolto.
- 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