Best practice per l'aggiornamento di Server
Sebbene l'aggiornamento da una versione di Alteryx Server a un'altra sia un processo semplice, esistono diverse considerazioni e fasi di preparazione che possono contribuire a garantire un aggiornamento senza problemi. Questa pagina fornisce una panoramica generale del processo, inclusi collegamenti a una documentazione utile e un approccio passo-passo da prendere in considerazione durante la pianificazione dell'aggiornamento.
Non tutti i passaggi o le raccomandazioni di questo documento sono applicabili a qualsiasi ambiente o installazione. Il piano potrebbe essere diverso.
In generale, il processo di aggiornamento deve comprendere i seguenti passaggi fondamentali:
Le sezioni seguenti descrivono questi passaggi e aggiungono una descrizione per aiutare a pianificare il lavoro. I collegamenti alle istruzioni dettagliate, laddove presenti, saranno visualizzati in linea. Inoltre, nella sezione Guide e articoli della Guida è disponibile un elenco aggregato di tutti i collegamenti forniti in questo documento.
L'elenco di controllo di questa procedura è disponibile in Elenco di controllo per l'aggiornamento di Server.
Alteryx e i rispettivi partner sono disponibili per fornire assistenza durante la pianificazione e l'esecuzione di un aggiornamento. Se hai bisogno di assistenza per questo processo, rivolgiti al tuo account executive.
Nuova terminologia
Con la release di Server 2022.3, il termine Gallery è stato deprecato a favore di Interfaccia utente di Server. Sebbene il termine legacy esista ancora nel software e nella documentazione al momento della stesura di questo documento è stato utilizzato il termine Interfaccia utente di Server per fare riferimento ai servizi, ai nodi, alle configurazioni e ad altri elementi applicabili.
Sezione 1. Documentazione dell'ambiente
Acquisizione dell'architettura e configurazione
È necessario aver compreso appieno il proprio ambiente (e la documentazione). Come minimo, devi sapere:
Quanti server sono installati e quali sono le loro funzioni?
Quanti controller, istanze dell'interfaccia utente di Server, worker e nodi MongoDB o SQL sono presenti in ciascun ambiente (Sviluppo/Test/Produzione)?
Utilizzi un ambiente ad alta disponibilità (HA)?
Esiste un diagramma architettonico che visualizza l'ambiente? In caso contrario, questa è una buona opportunità per crearne uno.
Quale versione software di Alteryx Server è in esecuzione nel tuo ambiente?
Quale software aggiuntivo è stato installato?
Librerie R personalizzate
Librerie Python personalizzate
Utilità di terze parti
Connettori
Non tutti i connettori devono essere aggiornati e per alcuni l'aggiornamento potrebbe non essere disponibile.
Data pack: Location Insights, Business Insights, Intelligence Suite e così via.
Le best practice consigliate consistono nell'installare le versioni corrispondenti di questi componenti aggiuntivi durante l'aggiornamento, se disponibili.
Strumenti personalizzati progettati dagli utenti o scaricati dalla community, altri strumenti e connettori acquistati o gratuiti di terze parti. Fai un elenco di questi strumenti, unitamente alle versioni.
Le opzioni di configurazione che sono state impostate tramite lo strumento Configurazione impostazioni di sistema di Alteryx, inclusi, a titolo di esempio non esaustivo:
Spazi di lavoro
Directory di registrazione
Impostazioni di abilitazione di Programmatore ed Engine
Impostazioni di persistenza, tra cui:
Tipo di database
Cartella dati
Opzioni di conservazione
Impostazioni dell'interfaccia utente di Server (URL e sicurezza)
Metodi di autenticazione e informazioni IDP
SMTP
Utente run-as
Nota
Poiché queste opzioni di configurazione (come Programmatore, Engine, Persistenza, Interfaccia utente di Server, Impostazioni SMTP, Utente run-as e altre) vengono acquisite in C:\ProgramData\Alteryx\RuntimeSettings.xml, l'Amministratore non deve registrarle separatamente. Una copia di RuntimeSettings.xml fornisce tutte queste impostazioni in un file XML di testo normale.
Utente di accesso al servizio
Specifiche dei server fisici e virtuali
Core e memoria
Versione del sistema operativo
Per ulteriori informazioni, consulta la sezione Requisiti di sistema di Server.
Database e versioni Python:
MongoDB gestito dall'utente: la versione MongoDB gestita dall'utente è indipendente dall'aggiornamento di Server. Potrebbe essere necessario aggiornare separatamente MongoDB gestito dall'utente in parallelo a un aggiornamento di Server. Nel caso dell'istanza gestita dall'utente, Alteryx non fornisce assistenza. Per ulteriori informazioni, consulta la Politica di supporto versioni.
MongoDB integrato: le versioni di Mongo e Python integrate seguono la versione di Server e non devono essere annotate separatamente. Per ulteriori informazioni sulle versioni di MondoDB incorporate, consulta la sezione Riferimento dello schema MongoDB o Politica di sostegno versioni.
DB SQL gestito dall'utente: la versione del DB SQL gestita dall'utente è indipendente dall'aggiornamento di Server. Potrebbe essere necessario aggiornare separatamente il DB SQL gestito dall'utente parallelamente all'aggiornamento di Server. Nel caso dell'istanza gestita dall'utente, Alteryx non fornisce assistenza. Per ulteriori informazioni, consulta la Politica di supporto versioni.
Nota
Se utilizzi lo strumento Python, verifica Ambiente strumento Phyton negli aggiornamenti di Server prima dell'aggiornamento.
Nota
L'elenco dei processi pianificati, delle raccolte, dei flussi di lavoro e delle appartenenze fa parte di MongoDB e non viene perso durante l'aggiornamento.
Abbiamo preparato un Configuration and Architecture Checklist per semplificare questo passaggio. Il completamento di questo elenco di controllo fornisce una panoramica dell'infrastruttura e della configurazione.
Identificazione dei flussi di lavoro d'importanza critica
Una parte importante della pianificazione dell'aggiornamento consiste nell'identificare i flussi di lavoro d'importanza critica che desideri proteggere e testare come parte del processo di aggiornamento. Si tratta in genere di flussi di lavoro eseguiti secondo una pianificazione, che fungono da dipendenze per i lavori a valle (all'interno o all'esterno di Alteryx) e/o forniscono dati/output critici alle principali parti interessate dell'azienda. In sostanza, identifichi qualsiasi flusso di lavoro che, se non disponibile per un periodo di tempo significativo, avrà un effetto deleterio sulla tua azienda.
L'identificazione dei flussi di lavoro critici può aiutarti a scegliere la versione di destinazione. Se il flusso di lavoro critico contiene strumenti o connettori non compatibili con una particolare versione, devi tenerne conto quando selezioni la versione di destinazione (consulta la sezione 3 di seguito per la Guida all'aggiornamento di Server da versione a versione: versioni supportate). È inoltre possibile modificare questi flussi di lavoro per i test successivi all'aggiornamento (di seguito) e includerli nel piano di controllo qualità.
Creazione di versioni di test dei flussi di lavoro d'importanza critica
Per i test dei flussi critici durante il controllo qualità post-aggiornamento, è necessario disabilitare o modificare tutti gli output che scrivono dati in altri sistemi di produzione, oppure producono output che risiederanno nell'ambiente di produzione.
Una metodologia comune consiste nel creare versioni di test dedicate di questi flussi che accedono ancora ai sistemi e alle directory di destinazione, ma non sovrascrivono i dati nei file e nelle tabelle di produzione.
Per le operazioni dei dati, modifica gli output in modo che vengano scritti nelle versioni di test dedicate delle tabelle.
Per le operazioni sui file, scrivi i file con una convenzione di denominazione diversa o in una sottocartella di test.
Ciò consente di eseguire test end-to-end che non influiscono sulla produzione. Questi flussi di lavoro di test devono essere utilizzati nei test di produzione per lo stesso motivo.
Considerazioni aggiuntive
Pianifica e programma le attività di aggiornamento per ridurre al minimo l'interruzione delle operazioni aziendali in corso. Pianifica la finestra di aggiornamento al di fuori del normale orario di lavoro (se possibile) e durante i periodi di utilizzo "più leggero". Ad esempio, non pianificare durante la chiusura di fine anno fiscale, l'elaborazione di fine trimestre, i controlli mensili e così via.
Alcuni client utilizzano una finestra di aggiornamento per rivisitare le versioni del sistema operativo (OS) sui loro computer Alteryx. Se desideri eseguire questa operazione, rivolgiti al reparto IT ed esamina i requisiti di sistema. Assicurati di documentare nel piano di aggiornamento se stai aggiornando anche il sistema operativo. Se si verificano problemi dopo l'aggiornamento di Alteryx, i tecnici dell'assistenza ne saranno informati.
Sezione 2. Esecuzione di un controllo dell'integrità di Server (facoltativo)
Il controllo dell'integrità di Alteryx Server è una risorsa preziosa per comprendere i modelli di utilizzo di un ambiente Alteryx Server. Analizza i modelli di utilizzo cronologici per determinare il carico di lavoro dell'ambiente server, il tipo di attività di ottimizzazione che potrebbe essere necessaria e se le dimensioni dell'ambiente sono appropriate.
Se desideri saperne di più, contatta il tuo account executive Alteryx.
Sezione 3. Selezione di una o più versioni di destinazione
Scegli la versione di Server a cui desideri effettuare l'upgrade. A seconda del ciclo di upgrade della tua organizzazione, potrebbero mancarti alcune versioni per arrivare alla release più recente. Il tuo approccio all'upgrade dipende dal numero di versioni che separano la versione corrente da quella di destinazione, pertanto deve essere pianificato di conseguenza.
Molte organizzazioni non effettuano l'upgrade a ogni release, soprattutto perché ogni anno vengono rilasciate più versioni. Tuttavia, è importante mantenersi ragionevolmente aggiornati. Gli upgrade regolari offrono aggiornamenti critici della sicurezza, miglioramenti delle prestazioni e nuove funzionalità.
Molte aziende scelgono di standardizzare l'ambiente sull'ultima release o su quella precedente, per trovare un giusto equilibrio fra stabilità e accesso puntuale ai miglioramenti.
Nota
Tutte le versioni principali sono supportate per 24 mesi. Se la tua organizzazione ha adottato aggiornamenti poco frequenti, questo aspetto dovrebbe essere fondamentale per la tua decisione.
Revisione delle note di release
Il primo passo del processo di selezione consiste nel leggere le note di release. Queste informazioni descrivono in dettaglio le nuove funzionalità e le modifiche di programmazione nelle potenziali versioni di destinazione, nonché le correzioni di bug e i problemi noti.
Percorso di aggiornamento: dall'ubicazione attuale a quella di destinazione
Per alcune versioni è necessario fare ulteriori considerazioni se provengono da versioni precedenti e non sono adatte per tutti i clienti. Ad esempio, potresti dover aggiornare MongoDB per passare da una versione all'altra oppure, nel caso della versione 2022.3, potresti dover aggiornare Server e Designer insieme a causa dei miglioramenti apportati alla crittografia dei dati nel software che rendono tale versione di Server incompatibile con le versioni precedenti.
Il sito di assistenza di Alteryx contiene una Guida all'aggiornamento di Server da versione a versione: versioni supportate (per le versioni non supportate, consulta la Guida all'aggiornamento di Server da versione a versione: versioni non supportate), in cui sono evidenziate le attività e le considerazioni di cui devi essere a conoscenza quando esegui l'aggiornamento delle versioni di Alteryx Server. La Guida è particolarmente utile se esegui l'aggiornamento attraverso più versioni contemporaneamente, ad esempio la migrazione da 2019.1 a 2022.1. Per garantire un aggiornamento senza problemi, potresti dover eseguire alcune operazioni incrementali.
Selezione della versione dell'utente
Ora che sei a conoscenza delle varie versioni disponibili e delle considerazioni speciali che caratterizzano il tuo percorso di aggiornamento, puoi selezionare la versione di destinazione. Da qui, accedi al sito Download.
Sezione 4. Download del software
Visita il portale delle licenze di Alteryx. È necessario un account per visitare il sito. Una volta lì, troverai tutti i download disponibili, inclusi ma non limitati a:
Alteryx Server (versioni correnti e precedenti)
Alteryx Designer
Alteryx Intelligence Suite e dati di Insight
Driver di database supportati da Alteryx
Scarica tutto il software necessario e passa alla fase successiva del processo. Per indicazioni sul download, visita la pagina della Guida Download e installazione di un prodotto.
Parità di versione
In generale, è una best practice mantenere Server e Designer sulla stessa versione. Quindi, il download del programma di installazione di Designer corrispondente in questo momento è la cosa più sensata. Tuttavia, poiché l'aggiornamento di Designer in una vasta base di utenti richiede pianificazione e risorse aggiuntive, potresti non voler completare l'aggiornamento contemporaneamente a quello di Server.
A partire dalla versione 2025.2, Alteryx ha separato gli aggiornamenti di Designer da quelli di Server, per modernizzare l'esperienza di aggiornamento e ridurre l'overhead IT. Ora è ora possibile aggiornare Designer indipendentemente da Server.
Server è generalmente retrocompatibile con le versioni precedenti di Designer, con l'avvertimento che le nuove funzionalità supportate nella versione di destinazione di Server non saranno disponibili nelle versioni precedenti di Designer.
Nel caso di Server e Designer 2022.3, questa compatibilità con le versioni precedenti non esiste a causa dei miglioramenti apportati alla crittografia dei dati in tutta la piattaforma. Se intendi eseguire l'aggiornamento a questa versione o a una successiva, devo aggiornare anche Designer. Nella pagina della Guida Strumento Preparazione alla migrazione sono disponibili istruzioni speciali per preparare l'upgrade a questa versione. Se hai l'esigenza di scaricare una versione precedente che non è più disponibile nella pagina Download, contatta il team Fulfillment.
Sezione 5. Esecuzione di un upgrade in un ambiente Sandbox o deployment blu-verde
Avvertimento
L'upgrade diretto del server di produzione può comportare tempi di fermo, se si verifica un problema durante l'upgrade o i test successivi.
Se non è disponibile un backup, potrebbe essere impossibile eseguire il rollback, lasciando inattivo l'ambiente di produzione fino a quando il problema dell'upgrade non viene risolto.
È preferibile...
Aggiornamento di Sandbox
Il test dell'upgrade in un ambiente non di produzione e la documentazione delle fasi del processo che precedono l'upgrade dell'istanza di Server utilizzata in produzione contribuiscono a garantire un aggiornamento senza problemi. Permettono anche di verificare che gli strumenti di terze parti e i flussi di lavoro business-critical continuino a funzionare come previsto. In caso contrario, è un'opportunità per esplorare e risolvere questi problemi e per aggiungere questa procedura correttiva al piano di aggiornamento della produzione. La procedura seguita in questo upgrade del test, oltre agli ulteriori passaggi correttivi eventualmente aggiunti alla fase di controllo qualità, diventerà lo "script" di upgrade per la produzione. Contatta il team dell'account per richiedere una licenza Sandbox.
Distribuzione blu-verde
L'aggiornamento di un server Sandbox diventa il nuovo ambiente di produzione dopo la convalida. Questo elimina il rischio che il Server di produzione rimanga inattivo per un tempo indeterminato se non è stato eseguito alcun aggiornamento. L'ambiente di produzione originale è blu e l'ambiente nuovo/Sandbox, dove è possibile installare e testare gli aggiornamenti, è verde. La distribuzione blu-verde convalida che l'ambiente Server e i driver del database richiesti, i DSN, i connettori e le altre impostazioni siano pienamente compresi, in quanto devono essere configurati sul Sandbox per la convalida.
Nella tabella che segue sono riportate le raccomandazioni per l'upgrade del server, dal livello minimo a quello ottimale:
Backup di MongoDB incorporato | Minimo | Buono | best | Vantaggi |
|---|---|---|---|---|
Backup MongoDB | ☑ | ☐ | ☐ | Preserva le informazioni del database per il rollback in caso di errori durante l'upgrade. Il rollback potrebbe richiedere passaggi manuali e l'assistenza del Supporto Alteryx. |
Snapshot del sistema Windows Server da parte del reparto IT | ☐ | ☑ | ☐ | Garantisce un rollback semplice e veloce, senza interventi manuali. Procedura: il personale IT esegue il backup di un'istanza completa del sistema Alteryx Server. Nota: è necessario arrestare il servizio, per evitare che lo snapshot catturi il database mentre viene aggiornato, poiché in tal modo verrebbe ripristinato in uno stato non funzionante. |
Distribuzione blu-verde | ☐ | ☐ | ☑ | In un deployment blu-verde è necessario un backup del database per eseguire la migrazione dei sistemi host, ma non è necessario che il personale IT esegua uno snapshot. |
Backup di MongoDB o SQL Server gestito dall'utente | Minimo | Buono | best | Vantaggi |
Backup del database | ☐ | ☐ | ☑ | Gli upgrade eseguono la migrazione degli schemi nelle raccolte di database. Il database originale deve essere in grado di eseguire il rollback dell'upgrade. |
Upgrade | Minimo | Buono | best | Vantaggi |
Upgrade in-place del server di produzione | ☑ | ☐ | ☐ | È il più semplice da eseguire, ma comporta il massimo rischio di fermo imprevedibile del server di produzione in caso di problemi durante l'upgrade. |
Upgrade di prova su un server Sandbox | ☐ | ☑ | ☐ | I problemi di upgrade e i test di connettori e flussi di lavoro critici vengono scaricati sull'ambiente aggiornato, evitando di interrompere le produzione. Procedura: esegui un ripristino dell'host in un ambiente Sandbox:
Dopo la convalida del processo di upgrade, esegui un upgrade in-place del server di produzione. |
Distribuzione blu-verde | ☐ | ☐ | ☑ | Il deployment blu-verde elimina il rischio di downtime associato all'upgrade in-place, perché il server di produzione originale non viene aggiornato. Procedura: esegui l'upgrade nell'ambiente Sandbox, convalida i flussi di lavoro critici, quindi scambia l'URL del server di produzione con quello dell'ambiente Sandbox, che in questo modo diventa il nuovo server di produzione. |
Idealmente, inizia con la stessa versione di Server Sandbox/Sviluppo/Test e aggiornalo. Per ulteriori informazioni sugli ambienti Sandbox, consulta l'articolo della community Ambiente Sandbox di Alteryx Server.
Se disponi di un ambiente multinodo, il test è efficace anche su un singolo computer che esegue Controller + Interfaccia utente di Server + Worker. In modo analogo, se disponi di MongoDB gestito dall'utente, il ripristino di un backup del database sul MongoDB incorporato del computer di test può aiutare a convalidare l'aggiornamento. Per informazioni su una licenza Sandbox, contatta il tuo account executive.
Come minimo, è necessario installare la versione di destinazione di Designer sul computer di un utente per testare i flussi di lavoro critici nella nuova versione. Le istruzioni sono disponibili nella pagina della Guida Installazione di due versioni di Designer sullo stesso computer.
1. Esegui un backup
Esegui un backup per:
MongoDB e DB SQL gestiti dall'utente
La creazione di un backup è responsabilità del cliente e non è supportata da Alteryx.
2. Completa i controlli pre-aggiornamento
Molti dei problemi tipici dell'upgrade di Server possono essere evitati eseguendo il flusso di lavoro e i controlli preliminari illustrati nell'articolo della community Alteryx Server: Controlli pre-aggiornamento. Questa procedura risolve i problemi più comuni che un client deve affrontare durante l'esecuzione di un aggiornamento ed elenca le soluzioni/i passaggi consigliati per ciascuno di essi.
Prima di eseguire l'aggiornamento, è importante eseguire i controlli pre-aggiornamento in ciascuno degli ambienti. Ad esempio, stai eseguendo un test su un computer di sviluppo e vuoi eseguire di nuovo i controlli sul tuo ambiente di produzione ed effettuare i passaggi indicati prima di completare l'aggiornamento.
Come parte della pianificazione pre-aggiornamento, devi concordare con le parti interessate dell'azienda il tempo di esecuzione dell'aggiornamento prima di attivare un rollback.
Per risultati ottimali, evita di eseguire contemporaneamente un aggiornamento di Server e una migrazione dell'host. Esegui un'operazione alla volta, consentendo un intero periodo di convalida dopo il completamento, prima di iniziare la successiva.
Disattiva Programmatore sui nodi del worker durante gli aggiornamenti
Per impostazione predefinita, le pianificazioni che devono essere eseguite durante l'aggiornamento di Server verranno rilevate non appena Server e i nodi vengono riavviati. Tieni presente questo aspetto quando esegui l'aggiornamento di test in Sandbox, poiché probabilmente non vuoi che i flussi di lavoro vengano attivati e abbiano un impatto sui tuoi sistemi di produzione.
Si consiglia di disabilitare tutte le pianificazioni prima dell'aggiornamento e di determinare cosa eseguire su base individuale.
Se non desideri eseguire le pianificazioni all'avvio del servizio:
Esegui le impostazioni di sistema di Alteryx su ciascun worker (e nodo Server principale).
Deseleziona Worker > Generale > Esegui processi non assegnati.
Assegna al worker un tag processo univoco (ad esempio "UPGRADETESTING").
In alternativa, se hai bisogno di supporto per l'eliminazione di tutte le pianificazioni, contatta l'assistenza clienti.
3. Esecuzione dell'aggiornamento
L'esecuzione dell'aggiornamento è un processo semplice se viene eseguito in loco. Se esegui una nuova installazione dell'ultima versione su un computer di destinazione, i passaggi sono diversi e comprendono l'applicazione delle licenze, che non fa parte del percorso di aggiornamento; le licenze attive esistenti continuano a funzionare sui computer aggiornati senza alcun intervento. La procedura generale di upgrade è riportata nella sezione Installazione o aggiornamento di Server.
Le varie istruzioni per le nuove installazioni e gli aggiornamenti in loco sono dettagliate e il documento include collegamenti ai file della guida/articoli associati su licenze, requisiti di sistema, elenchi di controllo di preparazione, aggiornamenti MongoDB e altro ancora. Molti di questi sono inclusi nella sezione Guide e articoli della Guida, alla fine di questo documento.
Nota che è necessario aggiornare gli strumenti predittivi con l'installazione principale. Se è stato impostato un utente di accesso al servizio, è necessario reimpostarlo dopo l'aggiornamento; gli aggiornamenti eliminano e reinstallano il servizio Alteryx.
Aggiornamento di un ambiente multinodo
Negli ambienti multinodo, tutti i nodi devono essere aggiornati alla stessa versione e devono essere arrestati nell'ordine indicato nella sezione Arresto dell'articolo della community Come riavviare i servizi in un Alteryx Server multinodo.
Dopo aver aggiornato tutti i nodi, segui l'ordine di riavvio corretto indicato nella sezione relativa all'avvio dello stesso documento.
Una volta che tutto è pronto e funzionante, aggiorna tutti i connettori, i data pack, i driver, i componenti aggiuntivi (come Intelligence Suite) e gli strumenti di terze parti necessari.
4. Esegui il test dell'upgrade.
Ora che il software di Server e tutti i connettori applicabili sono stati aggiornati, è il momento di iniziare il test.
Servizi Alteryx
I primi test sono di base e sono disponibili nella sezione Test dell'Elenco di controllo per l'aggiornamento di Server.
Il servizio Alteryx è in esecuzione?
È possibile:
Accedere all'URL di Server?
Spostarsi fra le pagine di amministrazione per visualizzare utenti, raccolte e così via?
Pubblicare un flusso di lavoro da Designer a Server?
Eseguire il flusso di lavoro?
Salvare ed eseguire un flusso di lavoro specificando le tue credenziali, se la configurazione lo consente?
Opzioni di configurazione
Successivamente, esamina le opzioni di configurazione nello strumento di configurazione delle Impostazioni di sistema di Alteryx per assicurarti che le impostazioni non siano andate perse. Queste impostazioni sono documentate nella sezione Documentazione dell'ambiente. Se è necessario apportare modifiche, ad esempio le impostazioni di persistenza, le configurazioni SMTP, ecc., è il momento di farlo. Inoltre, prendi nota di queste modifiche per riutilizzarle nell'ambiente di produzione aggiornato.
Nota
Alcune impostazioni vengono modificate attivamente in alcuni aggiornamenti. Ad esempio, nella release 2022.1 AMP è stato impostato su attivo per il Server ed è stato modificato il numero di flussi di lavoro che è possibile eseguire simultaneamente.
Per ulteriori informazioni, consulta sempre le Note di release.
Connettori e driver
Il passo successivo consiste nel testare i connettori e i driver nei sistemi critici, come i connettori SharePoint e O365 e quelli ODBC/OleDB per SQL Server, Snowflake, Databricks e così via. Accertati di poter collegare, leggere e scrivere dati.
Flussi di lavoro critici
Ora, esegui il test dei flussi d'importanza critica e di quelli che utilizzano i connettori, anch'essi documentati nella sezione Documentazione dell'ambiente. Questa serie di test utilizza le versioni di test dei flussi di lavoro creati nella sezione Creazione di versioni di test dei flussi di lavoro d'importanza critica di questa guida. Se esegui versioni di produzione non modificate di questi flussi, le destinazioni di produzione saranno influenzate come se questi flussi funzionassero normalmente.
Programmatore e Interfaccia utente di Server
Infine, se esegui Programmatore e Interfaccia utente di Server, verifica anche quanto segue:
È possibile pianificare ed eseguire un flusso di lavoro?
Le app analitiche vengono eseguite correttamente?
Importante
Assicurati che tutte le app pubblicate e pianificate/eseguite in questo ambiente non siano versioni di produzione. Se esegui versioni di produzione non modificate di questi flussi, le destinazioni di produzione saranno influenzate come se questi flussi funzionassero normalmente.
5. Annota eventuali errori e richiedi assistenza
Cataloga eventuali problemi rilevati dai test, ad esempio:
Servizi che non si avviano o segnalano errori.
Schema MongoDB o migrazioni crittografiche non riuscite.
Flussi di lavoro che non vengono eseguiti o vengono eseguiti generando risultati o errori imprevisti.
Connettori che non funzionano.
Errori in MongoDB.
Nell'ultima sezione dell'articolo Elenco di controllo per l'aggiornamento di Server sono illustrate alcune procedure comuni per la risoluzione dei problemi. L'assistenza clienti può fornire assistenza se riscontri un errore durante il processo di aggiornamento e non sei in grado di risolverlo con le procedure comuni di risoluzione dei problemi illustrate nella guida. Il tuo account executive può indicarti le varie opzioni disponibili per la pianificazione o l'esecuzione di un aggiornamento.
6. Esegui un rollback/ripristino
Se non è stato possibile risolvere i problemi rilevati durante la fase di test e controllo qualità, devi eseguire un rollback o un ripristino. Prima di eseguire il rollback o il ripristino, puoi raccogliere i file di log dai computer server da trasmettere all'assistenza clienti o per una revisione interna prima del prossimo tentativo di aggiornamento. Se disponi di un'istantanea o di un backup, puoi effettuare il ripristino ora e pianificare il prossimo tentativo di aggiornamento. Se non è stato possibile creare un'istantanea della metodologia, puoi seguire la metodologia di rollback convenzionale illustrata nell'articolo della community Come effettuare il downgrade di Alteryx Server.
Sezione 6. Pianificazione dell'aggiornamento della produzione
Dopo aver testato l'aggiornamento con esito positivo in un ambiente non di produzione e aver completato il processo di aggiornamento documentato, è il momento di pianificare l'aggiornamento dell'ambiente di produzione.
Nota
L'aggiornamento della produzione deve seguire lo "script" creato nell'ambiente di test, con modifiche specifiche a eventuali differenze architettoniche tra gli ambienti. Ad esempio, se l'ambiente testato era un'architettura a nodo singolo, ma l'ambiente di produzione presenta nodi separati per i worker e l'interfaccia utente di Server, per l'ambiente di produzione sarà necessaria una procedura di installazione aggiuntiva. Tieni conto di questo aspetto durante la pianificazione.
Suggerimento degli esperti: utilizza le notifiche di Server tramite l'interfaccia utente di Alteryx Server come canale di comunicazione aggiuntivo per informare gli utenti sugli upgrade in sospeso. È inoltre possibile pubblicare informazioni sull'aggiornamento nella community interna di Alteryx (ad esempio, SharePoint, Confluence, Yammer, Teams e così via).
È necessario pianificare una quantità appropriata di tempi di inattività e informare gli utenti che i flussi di lavoro su Server non verranno eseguiti durante l'aggiornamento. Per i flussi d'importanza critica, gli utenti possono eseguirli nell'ambiente di test appena aggiornato, localmente, o possono semplicemente pianificarne l'interruzione e informare il pubblico interessato del ritardo.
Se stai pianificando di aggiornare anche Designer, sia tramite pacchetti/automazione che con un processo di installazione manuale, pianifica il tempo e le risorse supplementari necessari per completare le installazioni e assicurati di informare anche la tua base di utenti. Tieni presente che il Server è retrocompatibile con Designer, fino alla versione 2022.3, ma le versioni più recenti di Designer non funzionano con le quelle precedenti di Server. Pertanto, gli aggiornamenti di Server devono precedere sempre quelli di Designer.
Importante
Ricorda di pianificare l'aggiornamento in un momento in cui le interruzioni dell'attività sono ridotte al minimo. Per ulteriori dettagli e suggerimenti, consulta la sezione Considerazioni aggiuntive.
Sezione 7. Esecuzione dell'aggiornamento della produzione
Aggiornamento di Server
I passaggi fondamentali in questa sezione sono uno specchio dei passaggi da 1 a 6 della Sezione 5. Fai riferimento alla sezione appropriata per ulteriori dettagli e collegamenti alla guida.
Test e controllo qualità dell'upgrade.
Verifica che i processi pianificati, le raccolte, le appartenenze e i flussi di lavoro pubblicati siano ancora presenti e funzionino come previsto (se testabili).
Annota eventuali errori e richiedi supporto all'assistenza clienti.
Esegui un rollback/ripristino se necessario.
Esegui il ripristino dai backup o segui la procedura descritta nell'articolo della community su come effettuare il downgrade di Alteryx Server.
Aggiornamento di Designer (opzionale)
Una volta che l'ambiente di produzione è operativo, è possibile aggiornare le installazioni di Designer se fanno parte del piano. Ricorda che la versione di Designer non può essere successiva a quella installata su Server e che questo aggiornamento influisce direttamente sui computer degli utenti. La procedura per aggiornare Designer è disponibile in Aggiornamento di Designer.
Compatibilità di Designer e Server
La versione di Designer deve essere uguale o precedente quella di Server a cui si connette. L'eccezione è Server 2022.3 (o versione successiva) che richiede almeno Designer 2022.3 a causa di modifiche nella crittografia.
La versione di Designer NON può essere più recente a quella di Server a cui si connette.
Solo la versione (Anno.Release) deve corrispondere, non la patch specifica.
Analogamente a un aggiornamento di Server, le versioni di Designer aggiornate devono essere testate per assicurarsi che i flussi di lavoro continuino a essere eseguiti e che le connessioni a Server possano ancora essere effettuate. Come nelle best practice per gli aggiornamenti di Server, pianifica di testare l'aggiornamento di Designer su un piccolo sottogruppo di computer utente.
Cosa fare se l'upgrade non riesce
Se l'upgrade di Server non riesce, o si verifica un problema critico, non tentare ripetutamente di riavviare il processo di upgrade, ma prosegui come spiegato di seguito per raccogliere le informazioni diagnostiche, quindi contatta il Supporto clienti Alteryx per ottenere assistenza.
1. Crea un ticket di assistenza
Apri un caso presso il Supporto clienti Alteryx, includendo i dettagli che seguono:
Versione di Server prima e dopo l'upgrade.
Breve descrizione dei problemi riscontrati (ad esempio, durante l'installazione, dopo l'avvio del servizio o durante la migrazione dello schema).
Tipo di ambiente: la configurazione contiene un nodo solo o più di uno?
La migrazione dell'host è stata tentata contemporaneamente all'upgrade?
L'ambiente server è di produzione?
Il timestamp del problema e gli eventuali messaggi di errore visualizzati.
Sono già state eseguite procedure di risoluzione dei problemi? (Ad esempio, riavvio del servizio, riavvio del sistema o tentativo di rollback manuale)
Disponi di un backup aggiornato di Alteryx Server e dei dati del database?
Per la risoluzione dei problemi, includi i seguenti file di log registrati nelle ultime 24 ore (o i 2-3 file di log più recenti):
Log di Server (Gallery)
Percorso:
\%ProgramData%\Alteryx\Gallery\LogsLog di servizio
Percorso:
\%ProgramData%\Alteryx\Service\AlteryxServiceLog.logPuoi inviare anche diversi file di
log, se disponibili.RuntimeSettings.xml
Percorso:
\%ProgramData%\Alteryx\RuntimeSettings.xmlLog di migrazione dello schema di AlteryxGallery configurato in Impostazioni di sistema Alteryx > Interfaccia utente di Server > Directory di registrazione.
Versioni 2025.1 e successive:
C:\ProgramData\Alteryx\Service\alteryx-gallery-migration.csvVersioni 2024.2 e precedenti:
C:\ProgramData\Alteryx\Gallery\Logs\alteryx-migration.csv
Log di migrazione dello schema di AlteryxService configurato in Impostazioni di sistema Alteryx > Controller > Log.
Versioni 2025.1 e successive:
C:\ProgramData\Alteryx\Service\alteryx-service-migration.csvVersioni 2024.2 e precedenti:
C:\ProgramData\Alteryx\Service\alteryx-migration.csv
File AlteryxServiceMigrator_#.log (necessari per l'upgrade fino alla versione 2022.3 o per gli upgrade che richiedono tale versione), disponibili in:
Log dello strumento Preparazione:
C:\ProgramData\Alteryx\ServiceLog di avvio dei servizi: cartella Impostazioni di sistema Alteryx > Controller > Generale > Registrazione
2. Informazioni aggiuntive (facoltativo)
Se possibile, includi anche:
Schermate degli eventuali messaggi di errore.
File di log del programma di installazione (solitamente disponibile in
%TEMP% o %LOCALAPPDATA%\Temp).Output di qualunque strumento di preparazione alla migrazione utilizzato prima dell'upgrade.
3. Prossimi passi
Non eseguire la disinstallazione o il rollback, a meno che non ti venga richiesto dal Supporto Alteryx.
Attendi che il Supporto analizzi i log e fornisca indicazioni per la correzione.
Guide e articoli della Guida
In questo elenco sono disponibili collegamenti a tutte le risorse menzionate in questo documento, nonché risorse aggiuntive che possono essere utili nel processo di aggiornamento di Server.