Esecuzione di un aggiornamento della build

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 effettuato con cautela, i suoi impatti devono essere considerati in anticipo e la procedura deve essere completata con un elevato livello di disciplina. Per garantire il successo dell’aggiornamento, assicurati che solo gli utenti esperti eseguano i passaggi descritti di seguito. Inoltre, consigliamo vivamente di contattare Adobe Customer Care prima di avviare qualsiasi aggiornamento.

Sono necessari i seguenti prerequisiti:

  • Informazioni sull’architettura di Campaign
  • Conoscenza dei sistemi e del lato server
  • Diritti e autorizzazioni amministrativi

Puoi trovare ulteriori informazioni in queste sezioni: Aggiornamento di Adobe Campaign, Migrazione a una nuova versione.

Per le istanze in hosting e ibride, è necessario richiedere l’aggiornamento della build al team di Adobe Technical Operations. 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.
Quando 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 di Adobe: per comprendere le strutture del database (schemi predefiniti e tutti gli 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 diverse istanze (produzione, staging, test) e altri server e applicazioni di terze parti (database, siti SFTP, fornitori di servizi di messaggistica), è consigliabile che un project manager coordini tutti i test.
  • un amministratore Adobe Campaign : il tuo amministratore conosce la configurazione del server, che include ma non si limita a: requisiti di sicurezza, layout delle cartelle, reporting e importazione\esportazione. Non eseguire un aggiornamento della build senza l'amministratore.
  • un operatore Adobe Campaign (utente di marketing) : un aggiornamento riuscito 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:

  1. Riserva almeno 2 ore per l'aggiornamento.
  2. Distribuire i dati di contatto per Adobe e personale cliente.
  3. Per le istanze in hosting: L’Adobe e il personale cliente coordineranno l’ora dell’aggiornamento e l’utente che verrà eseguito.
  4. Per le istanze on-premise: il personale clienti gestisce l'intero processo: se è necessaria assistenza per testare flussi di lavoro personalizzati e la logica di distribuzione, è necessario fornire servizi di consulenza.
  5. Determina e conferma la versione di Adobe Campaign a cui desideri eseguire l'aggiornamento: consulta le note sulla versione di Adobe Campaign Classic.
  6. Conferma il possesso dei file 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 l’Assistenza clienti Adobe Campaign.

  • Gestione progetti:

    • per installazioni on-premise: il Project Leader interno del cliente guida l'aggiornamento e gestisce i test del ciclo di vita.

    • per installazione in hosting: 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 installazioni on-premise: l'amministratore esegue l'aggiornamento.

    • per installazioni in hosting: 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 on-premise devono eseguire la seguente preparazione:

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

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

  3. Scarica la versione più recente del file di configurazione del server.

  4. Scarica la build più recente. Ulteriori informazioni.

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

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

Esegui l'aggiornamento

Le procedure seguenti vengono eseguite solo dai clienti on-premise . Per i clienti in hosting, è gestito dal team di hosting. Per aggiornare Adobe Campaign a una nuova build, la procedura dettagliata è descritta di seguito.

Duplicare l’ambiente

È possibile duplicare un ambiente Adobe Campaign per ripristinare un ambiente di origine in un ambiente di destinazione, in modo da ottenere due ambienti di lavoro identici.

Per farlo, segui la procedura indicata di seguito:

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

  2. Ripristina queste copie su tutte le istanze dell’ambiente di destinazione.

  3. Esegui lo script di cautela nms:frozenInstance.js sull'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 per campagne, ecc.

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

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

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

      SELECT iSate, count(*) FROM neolane.nmsdeliveryGroup By iProd;
      
    • Verifica 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;
      

Servizi di arresto

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

  1. Spegni i seguenti servizi:

    • Servizi Web (IIS): iisreset /stop
    • Servizio Adobe Campaign: net stop nlserver6
    NOTA

    Assicurati 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. Convalida che nessuna attività sia attiva eseguendo il comando nlserver pdump. In assenza di attività, l'output deve essere simile al seguente:

    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 Gestione attività di Windows per confermare che tutti i processi sono stati interrotti.

Aggiornare l’applicazione server Adobe Campaign

  1. Eseguire il file Setup.exe. Se hai bisogno di scaricare questo file, accedi al Centro download.

  2. Seleziona la modalità di installazione: Aggiorna o Ripara.

  3. Fare clic su Avanti.

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

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

Sincronizzare le risorse

  1. Apri la riga di comando.

  2. Esegui nlserver config -postupgrade -allinstances per eseguire le seguenti operazioni:

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

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

    Per sincronizzare un solo database, esegui il comando seguente:

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

Riavvia i 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 server.

Sul computer in cui è installato l’application server 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.

Attività aggiuntive specifiche

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

Messaggistica transazionale

Quando la messaggistica transazionale (Message Center) è abilitata nell’istanza Campaign, devi eseguire questi passaggi aggiuntivi per eseguire l’aggiornamento:

  1. Aggiorna il server di produzione del Centro messaggi alla versione scelta.

  2. Esegui gli script successivi all’aggiornamento.

  3. Esegui i test e assicurati che le e-mail vengano ricevute correttamente tramite l’istanza di produzione Message Center.

  4. Aggiorna i client e cancella la cache.

  5. Pacchetti di esportazione:

    • Esportare pacchetti utilizzando lo strumento di esportazione del pacchetto client
    • Importa pacchetto schema
    • Disconnetti e riconnette client
    • Aggiorna database
    • Disconnessione e riconnessione
    • Importa pacchetto amministratore
    • Importa pacchetto di contenuti
    • Importa pacchetto di gestione dei contenuti
    • Disconnessione e riconnessione
    • Esegui un controllo rapido dei flussi di lavoro
  6. Pubblica i modelli del Centro messaggi per garantire il funzionamento dell’interfaccia tra i server e l’istanza del Centro messaggi.

  7. Esegui i test per garantire che le e-mail vengano ricevute correttamente tramite l’istanza di produzione Message Center.

  8. Esegui test del flusso di lavoro in produzione per garantire che le consegne vengano ricevute.

Mid-sourcing

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

  1. Contatta Adobe Customer Care per coordinare l'aggiornamento del server Mid-Sourcing.

  2. Verifica che la versione sia stata aggiornata eseguendo un collegamento di prova. Ad esempio:

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

Il server di mid-Sourcing deve sempre eseguire la stessa versione (o più recente) dei server di marketing.

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, è gestito dal team di hosting. Esistono due modi per visualizzare il risultato della sincronizzazione:

Nell'interfaccia a riga di comando, gli errori vengono materializzati da una tripla freccia ">>" e la sincronizzazione viene arrestata automaticamente. Gli avvisi vengono materializzati da una doppia freccia ">>" e devono essere risolti una volta completata la sincronizzazione. Al termine del post aggiornamento, nel prompt dei comandi viene visualizzato un riepilogo. Può essere così:

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 a risolverlo.

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.

Analizzare i conflitti

Come si trova un conflitto?

I conflitti si trovano all’interno del post aggiornamento.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, verifica se le seguenti condizioni corrispondono:

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

Se nessuna di queste condizioni è applicabile, si tratta di un falso positivo. Se entrambe queste condizioni sono applicabili, è stato trovato un vero conflitto.

L’oggetto è stato modificato dal cliente?

  1. Identificare l'oggetto in conflitto.
  2. Chiedi al cliente se ha modificato l’oggetto.
  3. C'è qualcosa di insolito nell'oggetto?
  4. La data dell’ultima modifica è impostata nel codice dell’oggetto?
  5. Esamina il codice XML dal conflitto per gli attributi "_Conflist". Assomiglia a una personalizzazione?

L’oggetto è stato modificato nella nuova build?

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

Risolvere un conflitto

Per risolvere i conflitti, applicare il seguente processo:

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

  2. Selezionare il conflitto da risolvere nell'elenco.
    Sono disponibili tre opzioni per risolvere i conflitti: Accetta 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 si desidera utilizzare le funzioni standard.
  • Se non disponi di personalizzazioni (tutte le personalizzazioni verranno rimosse)

Quando posso mantenere la versione corrente?

  • Se disponi di personalizzazioni
  • Se non si desidera unire
  • Se non è necessario apportare alcuna correzione all'oggetto in conflitto dall'aggiornamento

Quando eseguire un'unione?

  • È possibile unire solo moduli, rapporti e applicazioni web.
  • Alcune fusioni minori possono essere risolte senza comprendere il codice.
  • Unioni più complesse dovrebbero essere eseguite da un soggetto 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 beneficerà di correzioni di bug.
IMPORTANTE

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, vengono modificati solo i commenti, le schede, gli spazi o le nuove righe. Esempio: salvataggio accidentale.
  3. Modifiche di tendenza: cambiò solo una riga. Esempio: xpathToLoad
  4. Unione complessa: quando è richiesta la codifica. Sono necessarie le capacità di sviluppo. Consulta Unioni complesse.

Come fondersi?

  1. Ottieni tutte e tre le versioni: la versione originale, la nuova versione e la versione personalizzata.
  2. Esegui un "diff" tra la versione originale e quella nuova.
  3. Isolare le modifiche.
  4. Se non vengono apportate modifiche, è necessario risolvere il problema mantenendo la versione corrente.

Dove trovare il codice?

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

Come fare una differenza?

  1. Installa un editor di testo o unione, ad esempio Blocco note ++, AraxisMerge, WinMerge.
  2. Apri il file originale e il nuovo file nell'editor.
  3. Esegui il confronto (confronta i due file).
  4. Identifica eventuali differenze.

Come fondersi?

  1. Inizia dalla versione personalizzata.
  2. Applica le modifiche.
  3. Risolvere il conflitto dichiarandolo come risolto.
  4. Verifica la non regressione.

Se si sceglie di risolvere il conflitto manualmente, procedere come segue:

  1. 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.
  2. Elimina la versione che non desideri mantenere. Elimina la stringa conflittuale dell'entità che stai mantenendo.
  3. Vai al conflitto che hai risolto. Fai clic sull'icona Azioni e seleziona Dichiara come risolto.
  4. Salva le modifiche: il conflitto è ora risolto.

Unioni complesse

  1. Scopri le operazioni della modifica: decodificare le modifiche, esaminare i registri delle modifiche e seguire le istruzioni degli esperti di Adobe Campaign.
  2. Decidi cosa fare con il cambiamento.
  3. Scopri le operazioni delle personalizzazioni: decodificare le modifiche

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

  1. Copia bit di codice dal set di modifiche
  2. Incolla alla versione personalizzata
  3. Test di non regressione della personalizzazione
  4. Test della funzione dei cambiamenti
  5. Eseguire test di accettazione degli utenti
  6. Esecuzione in ambiente di test
IMPORTANTE

Le competenze di sviluppo sono necessarie per eseguire fusioni complesse.

Argomenti correlati

In questa pagina