Esecuzione di un aggiornamento della build

In questa sezione viene fornita una dettagliata panoramica sul processo di aggiornamento e sui passaggi per identificare e risolvere i conflitti.

L'aggiornamento della costruzione deve essere effettuato con cautela, i suoi impatti devono essere presi in considerazione in anticipo e la procedura deve essere completata con un alto livello di disciplina. Per garantire il successo dell’aggiornamento, accertatevi 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:

  • Conoscenza dell'architettura della campagna
  • Conoscenza dei sistemi e del lato server
  • Diritti e autorizzazioni amministrativi

Ulteriori informazioni sono disponibili nelle sezioni seguenti: Aggiornamento Adobe Campaign, migrazione a una nuova versione.

Per le istanze ospitate e ibride, è necessario richiedere l'aggiornamento della build al team Operazioni tecniche di Adobe. Per ulteriori informazioni, consultare la sezione Domande frequenti in fondo alla pagina. Consultate anche le domande frequenti sull'aggiornamento della build.

Preparare l'aggiornamento

Prima di avviare l'aggiornamento della build, è necessario 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 risorse seguenti:

  • un architetto Adobe: per comprendere le strutture del database (schemi out-of-the-box ed eventuali schemi aggiuntivi aggiunti, le progettazioni delle campagne e tutte le funzionalità critiche del percorso che devono essere avviate e testate in un ordine specifico).
  • un project manager: nel caso in cui l'aggiornamento della build coinvolga molti casi diversi (produzione, staging, test) e altri server e applicazioni di terze parti (database, siti SFTP, provider di servizi di messaggistica), è consigliabile che un project manager coordini tutti i test.
  • un amministratore Adobe Campaign : l'amministratore conosce la configurazione del server, che include, tra l'altro: requisiti di sicurezza, layout delle cartelle, reporting e importazione\esportazione. Non eseguire un aggiornamento della build senza l'amministratore.
  • operatore Adobe Campaign (utente di marketing): un aggiornamento di successo dipende dalla capacità dell'utente di eseguire le proprie attività quotidiane con successo. Per questo motivo, includete sempre almeno uno degli operatori giornalieri nel test dei server aggiornati.

Pianificazione

Seguono alcuni punti chiave su come pianificare un aggiornamento della build:

  1. Riservare almeno 2 ore per l'aggiornamento.
  2. Distribuire i dati di contatto per Adobe e personale cliente.
  3. Per le istanze ospitate: Adobe e personale cliente coordineranno l'ora dell'aggiornamento e chi eseguirà l'aggiornamento.
  4. Per le istanze locali: il personale clienti gestisce l'intero processo - se è necessario fornire assistenza per testare flussi di lavoro personalizzati e per la logica di distribuzione, è necessario fornire servizi di consulenza.
  5. Determinate e confermate la versione di Adobe Campaign a cui desiderate effettuare l'aggiornamento. Consultate le note sulla versione diAdobe Campaign Classic.
  6. Confermare il possesso di eseguibili di aggiornamento.

Persone chiave

Il processo di aggiornamento della build richiede il coinvolgimento delle seguenti persone:

  • architetto Adobe: per le architetture ospitate o ibride, l'architetto deve coordinarsi con Adobe Campaign Client Care.

  • Project Manager:

    • per le installazioni aziendali interne: il Project Leader interno del cliente è leader nell'aggiornamento e gestisce i test del ciclo di vita.

    • per l'installazione ospitata: il team di hosting collaborerà con il team di assistenza clienti Adobe Campaign e il cliente per coordinare la cronologia dell'aggiornamento per tutte le istanze.

  • Amministratore Adobe Campaign :

    • per le installazioni aziendali interne: l'amministratore esegue l'aggiornamento.

    • per le installazioni ospitate: il team di hosting esegue l'aggiornamento.

  • operatore Adobe Campaign\utente marketing: l'operatore esegue test sulle istanze di sviluppo, test e produzione.

Preparare l'aggiornamento della build

Prima di avviare l'aggiornamento della build, i clienti interni devono eseguire la seguente preparazione:

  1. Assicurati che qualsiasi lavoro di sviluppo possa essere esportato prima dell'aggiornamento, esportato come pacchetti.

  2. Eseguire un backup completo dei database per tutte le istanze degli ambienti di origine e di destinazione.

  3. Ottenete la versione più recente del file di configurazione delserver.

  4. Scaricate la build più recente. Scopri di più sul Centrodownload.

È inoltre necessario conoscere tutte le utili righe di comando prima di avviare un aggiornamento della build:

  • nlserver pdump: elenca i processi in esecuzione
  • nlserver pdump -who: elenca le sessioni client attive
  • monitor nlserver -missing: elenca le proprietà mancanti
  • avvio nlserver process@instanceName: avvia un processo
  • server di arresto process@instanceName: interrompe un processo
  • riavvio del server process@instanceName: riavvia un processo
  • arresto nlserver: arresta tutti i processi Campaign
  • nlserver watchdog -svc: avvia il watchdog (solo UNIX)

Eseguire l'aggiornamento

Le procedure riportate di seguito sono eseguite solo dai clienti interni . Per i clienti ospitati, è gestito dal team di hosting. Per aggiornare Adobe Campaign a una nuova build, la procedura dettagliata è descritta di seguito.

Duplicare l'ambiente

Di seguito viene illustrato come duplicare un ambiente Adobe Campaign , al fine di ripristinare un ambiente di origine in un ambiente di destinazione, ottenendo due ambienti di lavoro identici.

Per farlo, segui la procedura indicata di seguito:

  1. Create una copia dei database su tutte le istanze nell'ambiente di origine.

  2. Ripristinare queste copie in tutte le istanze dell'ambiente di destinazione.

  3. Eseguire lo script di cauterizzazione nms:FrostInstance.js nell'ambiente di destinazione prima di avviarlo. In questo modo tutti i processi che interagiscono con l'esterno verranno interrotti: registri, tracciamento, consegne, flussi di lavoro delle campagne, ecc.

    nlserverjavacsriptnms:freezeInstance.js–instance:<dev> -arg:run
    
  4. Controllare la cauterizzazione, come segue:

    • Verificate che l’unica parte di consegna sia quella con ID impostato su 0:

      SELECT * FROM neolane.nmsdeliverypart;
      
    • Verificate che l'aggiornamento dello stato di consegna sia corretto:

      SELECT iSate, count(*) FROM neolane.nmsdeliveryGroup By iProd;
      
    • Verificare che l'aggiornamento dello stato del flusso di lavoro sia corretto:

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

Arrestare i servizi

Per sostituire tutti i file con la nuova versione, è necessario che tutte le istanze del servizio nlserverservice siano chiuse.

  1. Arrestate i seguenti servizi:

    • Servizi Web (IIS): iisreset /stop
    • servizio Adobe Campaign: net stop nlserver6
    NOTE

    Assicurarsi 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.

  2. Verificare che non siano attive attività eseguendo il comando nlserver pdump . Se non sono presenti attività, l'output deve essere simile a quanto segue:

    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. Controllare Task Manager di Windows per confermare che tutti i processi sono stati interrotti.

Aggiornamento dell'applicazione Adobe Campaign Server

  1. Eseguite il file Setup.exe . Per scaricare questo file, accedete al Centrodownload.

  2. Selezionate la modalità di installazione: Aggiornamento o riparazione.

  3. Fate clic su Avanti.

  4. Fate clic su Fine: il programma di installazione copia i nuovi file.

  5. Al termine dell'operazione, fare clic su Fine.

Sincronizzare le risorse

  1. Aprite la riga di comando.

  2. Eseguite nlserver config -postupgrade -allinstance per eseguire le seguenti operazioni:

    • Sincronizzare le risorse
    • Aggiorna schemi
    • Aggiornare il database
    NOTE

    Questa operazione deve essere eseguita una sola volta e solo su un server applicazione nlserverweb.

    Per sincronizzare un solo database, eseguite il comando seguente:

    nlserver config -postupgrade -instance: <instance_name>
    
  3. Verificate se la sincronizzazione ha generato errori o avvisi.

Riavvia servizi

È necessario riavviare i servizi seguenti:

  • Servizi Web (IIS): issreset /start
  • servizio Adobe Campaign: net start nlserver6

Aggiornamento delle console client

Nel computer in cui è installato il server applicazioni Adobe Campaign (nlserverweb), scaricate e copiate il file:

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

Alla successiva connessione delle console client, una finestra informerà gli utenti della disponibilità di un nuovo aggiornamento e offrirà loro la possibilità di scaricarlo e installarlo.

Attività aggiuntive specifiche

Alcune configurazioni richiedono specifiche attività aggiuntive per l'aggiornamento a una nuova build.

Messaggi transazionali

Quando Messaggi transazionali (Centro messaggi) è abilitato nell'istanza Campaign, devi eseguire i seguenti passaggi aggiuntivi per effettuare l'aggiornamento:

  1. Aggiorna il server di produzione di Message Center alla versione scelta.

  2. Eseguire gli script postupgrade.

  3. Eseguite i test e assicuratevi che i messaggi e-mail vengano ricevuti correttamente tramite l'istanza di produzione del Centro messaggi.

  4. Aggiornare i client e cancellare la cache.

  5. Pacchetti di esportazione:

    • Esportare pacchetti con lo strumento di esportazione del pacchetto client
    • Importa pacchetto schema
    • Disconnessione e riconnessione del client
    • Aggiorna database
    • Disconnessione e riconnessione
    • Importa pacchetto Amministratore
    • Importa pacchetto di contenuto
    • Importa pacchetto di gestione dei contenuti
    • Disconnessione e riconnessione
    • Verifica rapida dei flussi di lavoro
  6. Pubblicare i modelli di Centro messaggi per assicurare il funzionamento dell’interfaccia tra i server e l’istanza del Centro messaggi.

  7. Eseguite i test per verificare che le e-mail vengano ricevute correttamente tramite l'istanza di produzione del Centro messaggi.

  8. Eseguite i test del flusso di lavoro in produzione per verificare che le consegne vengano ricevute.

Media-sourcing

Nel contesto di un ambiente di mid-sourcing, devi eseguire i seguenti passaggi aggiuntivi per aggiornare:

  1. Contatta Assistenza clienti del Adobe per coordinare l'aggiornamento del server di Media Source.

  2. Verificare che la versione sia stata aggiornata mediante un collegamento di prova. Ad esempio:

    http://[InsertServerURL]/r/test
    
NOTE

Il server di origine media deve sempre eseguire la stessa versione (o più recente) dei server di marketing.

In caso di conflitti

Identificare i conflitti

È necessario verificare il risultato della sincronizzazione. Questa procedura viene eseguita solo dai clienti interni. Per i clienti ospitati, è gestito dal team di hosting. Esistono due modi per visualizzare il risultato della sincronizzazione:

Nell'interfaccia della riga di comando, gli errori vengono generati da una tripla freccia '>>>' e la sincronizzazione viene arrestata automaticamente. Le avvertenze vengono materializzate da una doppia freccia '>>' e devono essere risolte una volta completata la sincronizzazione. Alla fine del post aggiornamento, nel 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 prestare attenzione alla risoluzione del problema.

Il file postupgrade_ServerVersionNumber_TimeOfPostupgrade.log contiene il risultato della sincronizzazione. È disponibile per impostazione predefinita nella seguente directory: installDirectory/var/instanceName/postupgrade. Gli errori e gli avvisi sono indicati dagli attributi di errore e avviso.

Analisi dei conflitti

Come si trova un conflitto?

I conflitti si trovano all'interno del post upgrade.log sul server in questione o nell'interfaccia client di Campaign (Amministrazione > Configurazione > Gestione pacchetti > Modifica conflitti).

Il documento con l’identificatore ‘stockOverview’ e il tipo ‘nms:webApp’ è in conflitto con la nuova versione.

Se viene rilevato un conflitto, verificate che le seguenti condizioni corrispondano:

  • L'oggetto è stato modificato o personalizzato dal cliente?
  • L'oggetto è stato modificato nel prodotto?

Se nessuna di queste condizioni è valida, si tratta di un falso positivo. Se si applicano entrambe queste condizioni, è stato trovato un vero conflitto.

L'oggetto è stato modificato dal cliente?

  1. Identificare l'oggetto in conflitto.
  2. Chiedere al cliente se ha modificato l'oggetto.
  3. C'è qualcosa di insolito con l'oggetto?
  4. La data dell'ultima modifica è impostata nel codice dell'oggetto?
  5. Esaminate il codice XML dal conflitto per gli attributi "_Conflitti". Sembra una personalizzazione?

L'oggetto è stato modificato nella nuova build?

  1. Qualche "solito sospetto?" Applicazioni Web o rapporti incorporati (ad esempio: 'deliveryValidation', 'deliveryOverview', 'budget').
  2. Esaminate i registri delle modifiche per eventuali aggiornamenti.
  3. Chiedete esperti Adobe Campaign.
  4. Eseguire una "diff" sul codice.

Risoluzione di un conflitto

Per risolvere i conflitti, eseguire il seguente processo:

  1. In Adobe Campaign Explorer, accedete a Amministrazione > Configurazione > Gestione pacchetti > Modifica conflitti.

  2. Selezionare il conflitto da risolvere nell'elenco.
    Esistono tre opzioni per risolvere i conflitti: Accettate la nuova versione, Mantieni la versione corrente, Unisci il codice (e dichiara come risolto), Ignora il conflitto (non consigliato).

Quando posso accettare la nuova versione?

  • Se desiderate le funzioni standard.
  • Se non disponete di personalizzazioni (tutte le personalizzazioni verranno rimosse)

Quando posso mantenere la versione corrente?

  • Se disponete di personalizzazioni
  • Se non si desidera unire
  • Se non sono necessarie correzioni all'oggetto in conflitto dall'aggiornamento

Quando eseguire un'unione?

  • È possibile unire solo moduli, rapporti e applicazioni Web.
  • Alcune piccole unioni possono essere risolte senza comprendere il codice.
  • Le fusioni più complesse dovrebbero essere eseguite da un utente con le competenze e le capacità adeguate.
  • Vedere Eseguire un'unione.

E se ignorassi i conflitti?

  • Il conflitto rimarrà
  • L'oggetto non verrà aggiornato
  • Impatto a lungo termine: incompatibilità delle versioni, il cliente non trarrà alcun beneficio dalle correzioni dei bug.
IMPORTANT

Si consiglia vivamente di risolvere i conflitti.

Eseguire un'unione

Esistono diversi tipi di unione:

  1. Unione semplice: gli elementi personalizzati e nuovi sono piccoli e non correlati, e non è necessaria alcuna codifica.
  2. Nessuna modifica: accetta nuova versione, cambia solo la data dell'ultimo aggiornamento, solo commenti, schede, spazi o nuove righe. Esempio: salvataggio accidentale.
  3. Modifiche ripetitive: è cambiata solo una riga. Esempio: xpathToLoad
  4. Unione complessa: quando la codifica è obbligatoria. Sono necessarie capacità di sviluppo. Consultate Unioni complesse.

Come si unisce?

  1. Ottenete tutte e tre le versioni: la versione originale, la nuova versione e la versione personalizzata.
  2. Eseguite una "diff" tra la versione originale e quella nuova.
  3. Isolare le modifiche.
  4. Se non vengono apportate modifiche, risolvete il problema mantenendo la versione corrente.

Dove trovare il codice?

  1. Il codice predefinito viene memorizzato in file XML nella cartella del dataKit. Individuare il file XML che corrisponde all'oggetto in conflitto. Esempio: installationDirectory\datakit\nms\fra\form\recipient.xml
  2. Recuperate la versione originale: tramite il Centro di download o un'altra installazione non aggiornata del prodotto.
  3. Recuperate la nuova versione: tramite il centro Download o i file installati dal cliente.
  4. Recuperate la versione personalizzata: recupera il codice sorgente dell'oggetto dall'interno del client Campaign.

Come fare una diff?

  1. Installate un editor di testo o di unione, ad esempio Blocco note ++, AraxisMerge, WinMerge.
  2. Aprite il file originale e il nuovo file nell’editor.
  3. Eseguite la diff (confrontate i due file).
  4. Identificare eventuali differenze.

Come si unisce?

  1. Iniziate dalla versione personalizzata.
  2. Applicate le modifiche.
  3. Risolvere il conflitto dichiarandolo come risolto.
  4. Verificare la presenza di non regressioni.

Se scegliete di risolvere il conflitto manualmente, procedete come segue:

  1. Nella sezione inferiore della finestra, cercare 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.
  2. Eliminate la versione che non desiderate mantenere. Eliminate la stringa conflitto_argomento dell'entità da mantenere.
  3. Vai al conflitto risolto. Fate clic sull'icona Azioni e selezionate Dichiara come risolto.
  4. Salvare le modifiche: il conflitto ora è risolto.

Unioni complesse

  1. Comprendere le operazioni eseguite dalla modifica: decodificare le modifiche, esaminare i registri delle modifiche e seguire esperti Adobe Campaign.
  2. Decidete cosa fare con il cambiamento.
  3. Comprendere le operazioni di personalizzazione: decodificare le modifiche

Di seguito sono riportati i passaggi per eseguire un'unione complessa:

  1. Copiare bit di codice dal set di modifiche
  2. Incolla sulla versione personalizzata
  3. Test per non regressioni di personalizzazione
  4. Test per la funzione dei cambiamenti
  5. Esegui test di accettazione utente
  6. Eseguire in ambiente di test
IMPORTANT

Le competenze di sviluppo sono necessarie per eseguire complesse operazioni di unione.

Argomenti correlati

In questa pagina