Skip to main content

Guida all'aggiornamento di Server da versione a versione: versioni supportate

Importante

Consulta l'Elenco di controllo per l'upgrade di Server del server per pianificare ed eseguire correttamente l'aggiornamento del server, incluso il flusso di lavoro Controlli pre-upgrade per identificare i problemi che causano la non riuscita degli upgrade.

In che modo questo documento è d'aiuto?

In questo documento vengono evidenziate le attività e le modifiche di cui è necessario essere a conoscenza durante l'aggiornamento delle versioni di Alteryx Server. I problemi sono cumulativi, quindi leggi ogni sezione durante l'upgrade di più versioni. Questo non sostituisce le Note di release (vedi i collegamenti in ogni sezione).

Programma di release

  • Le release semestrali aggiungono funzionalità ma possono anche modificare la gestione di Server, richiedendo a te o ai tuoi utenti di modificare il comportamento.

  • Le release/patch di manutenzione all'interno di ogni trimestre risolvono i problemi riscontrati nella release iniziale. Ad esempio, la prima release di manutenzione per 2022.3 è 2022.3.2.

Legenda

PIT-STOP

Modifica significativa che richiede l'aggiornamento a questa versione prima di eseguire l'upgrade a una versione successiva.

Aggiornamento MongoDB

L'upgrade della versione del database Mongo è stato eseguito.

Un upgrade di Alteryx Server può includere solo UN upgrade della versione MongoDB tra la versione corrente e quella target.

CRITICAL

Problema critico: gli Amministratori devono affrontarlo o esserne a conoscenza quando passano a questa versione o la superano.

Criteri per le voci in questo elenco

Questo elenco contiene le note di release di ciascuna versione per evidenziare dove:

  • L'Amministratore o gli Utenti devono eseguire un'azione.

  • L'elemento è importante per scegliere una versione di aggiornamento (ovvero, comportamento modificato o difetto).

  • Un cambiamento significativo è stato apportato nell'amministrazione di Server.

2022.3 e versioni precedenti

Per le versioni non supportate (2022.3 e precedenti), consulta la Guida all'aggiornamento di Server da versione a versione: versioni non supportate.

2024.1

Novità / Note di release

Versione

Azioni da intraprendere quando si esegue l'upgrade a questa versione o a quella precedente.

2024.1

Funzionalità amministrativa: possibilità di trasferire la proprietà delle risorse tramite interfaccia utente e API

Gli Amministratori possono trasferire la proprietà dei flussi di lavoro e delle pianificazioni tra gli utenti tramite l'interfaccia utente di Server o tramite gli endpoint API V3 di Server.

Impatto:

Nota

  • La cronologia dei processi del flusso di lavoro non è visibile al nuovo proprietario.

  • Il flusso di lavoro si sposterà nello studio del nuovo proprietario, influenzando la visibilità degli altri utenti nello studio di origine o di destinazione.

  • Per eseguire correttamente il flusso di lavoro, devi condividere altri elementi con il nuovo proprietario:

    • Connessione DCM

    • Connessione al database della Gallery condivisa

    • Credenziali Gallery condivisa

2024.1

Nuova funzionalità: nuova opzione database (SQL DB) aggiunta

Il database SQL Server gestito dall'utente può essere utilizzato al posto di MongoDB. Attualmente, l'unica versione ufficialmente supportata di SQL è MSSQL Server 2019 e 2022.

Impatto:

2024.1

CRITICAL

Upgrade di Python: upgrade di Python incorporato da 3.8.16 a 3.10.13

Impatto:

Se in Designer viene utilizzata una versione incompatibile di un Connettore, viene visualizzato il seguente messaggio di errore: "Versione 3.8 non trovata nella distribuzione Alteryx. Selezionare un'altra versione. Errore interno - Deadlock rilevato".

Attività:

  • Tutti gli strumenti di Connettori devono essere sostituiti con una nuova versione.

  • Gli utenti dovrebbero ripetere il test di Python nei flussi di lavoro. Engine utilizza ancora Python versione 3, quindi dovrebbe esserci un impatto minimo sugli script.

2024.1

CRITICAL

Modifica del campo Data e ora in MongoDB (Indicatori di data e ora di Service spostati in formato UTC nei database di Server)

Impatto: abbiamo spostato tutti i campi Data e ora in UTC per migliorare la gestione delle modifiche del fuso orario e dell'ora legale. Per ulteriori informazioni, visita la sezione Note di release di Server 2024.1.

  • Sono interessate tutte le API di Server che contengono un indicatore di data e ora.

  • Se esegui l'upgrade da una versione precedente a 2024.1, gli indicatori di data e ora delle risorse esistenti verranno convertiti nel nuovo standard UTC all'avvio di AlteryxService.

Attività: verifica come vengono gestiti i campi Data e ora nelle applicazioni che accedono a MongoDB o all'API. Potrebbe essere necessario regolarli in modo da prevedere Data e ora in UTC.

2024.1

Gestione del Server DCM Dev/Prod: il server Prod può reindirizzare il DCM Dev alle connessioni Prod.

Impatto: Connessioni DCM e Gestione connessione DCM aggiunte al menu Amministratore. Per ulteriori informazioni, consulta le seguenti pagine di assistenza:

Attività: aggiungi reindirizzamenti DCM al server Prod per consentire ai flussi di lavoro migrati da Dev di accedere alle origini dati Prod senza modifiche nel flusso di lavoro.

2024.1

Amministrazione DCM: granularità delle autorizzazioni utente

Impatto: nuove autorizzazioni DCM aggiunte. Per ulteriori informazioni, consulta la pagina di assistenza Ruoli utente e autorizzazioni.

2024.1

Amministrazione DCM: vault esterno generico DCM aggiunto

Impatto: puoi configurare un vault generico in grado di recuperare i segreti da qualsiasi vault con un'interfaccia di programmazione che utilizza l'autenticazione di base.

2024.1

Modifica amministrativa: Condivisione simultanea in DCM

Impatto: puoi condividere la stessa Connessione DCM per la collaborazione e, separatamente, per l'esecuzione. In precedenza era possibile scegliere solo 1 opzione di condivisione. Per ulteriori informazioni, consulta la pagina Data Connection Manager: Interfaccia utente di Server.

2024.1

Fine del ciclo di vita di Insight

Impatto: approfondimenti non più disponibili in Alteryx Server. Per ulteriori informazioni, consulta la pagina delle domande frequenti.

2024.2

Novità / Note di release

Versione

Azioni da intraprendere quando si esegue l'upgrade a questa versione o a quella precedente.

2024.2

PIT-STOP

CRITICAL

Aggiornamento di MongoDB integrato alla versione 7

Impatto: nell'ambito dell'installazione di Server 2024.2, verrà eseguito l'upgrade di MongoDB integrato alla versione 7.0. La versione minima di Server per l'upgrade è 2023.2 (MongoDB versione 6.0).

Attività: verifica che la versione di Server sia 2023.2 o 2024.1, quindi segui la procedura descritta nelle Note di release di Server 2024.2 .

2024.2

PIT-STOP

CRITICAL

La versione 2024.2 è l'ultima release che include il codice Crypto Migrator.

Questo pit stop è applicabile solo per l'aggiornamento di MongoDB gestito dall'utente dalla versione 2022.1 o precedente, nel corso del quale verrà richiesta la migrazione del sistema di crittografia del database.

Attività: segui il processo di migrazione del sistema di crittografia descritto nella sezione 2022.3 della Guida all'aggiornamento di Server da versione a versione: versioni non supportate e nello strumento Preparazione alla migrazione.

2024.2

Migrazione di connessioni dati e flussi di lavoro a DCM

Ora puoi migrare le Connessioni dati del server condiviso alle Connessioni DCM. A tale scopo, controlla come migrare le Connessioni dati del server a DCM e alle Connessioni dati.

2024.2

Possibilità di limitare gli Utenti di Studio a un solo Utente

Gli Amministratori hanno l'opzione che permette di disattivare gli studi condivisi limitando a uno il numero di utenti di uno studio. In qualità di amministratore, ora puoi trasferire facilmente la proprietà delle risorse trasferendo il flusso di lavoro da uno studio a un altro

Per limitare a uno il numero di utenti di uno studio, scegli Amministratore> Impostazioni> Configurazione> Utenti. Dopodiché, seleziona la casella di spunta Limita studio a 1 utente. Per ulteriori informazioni, consulta la pagina Impostazioni di Alteryx Server.

2024.2

Restrizione per rendere pubblici i flussi di lavoro: impostazione globale

Ora gli Amministratori possono controllare il modo in cui i flussi di lavoro vengono pubblicati (pubblicamente o non pubblicamente) selezionando o deselezionando la casella di spunta Limita flusso di lavoro pubblico (globale). A tale scopo, accedi a Amministratore > Impostazioni > Sicurezza.

Per ulteriori informazioni, consulta la pagina Impostazioni di Alteryx Server.

2024.2

Impostazioni proxy di Designer espanse

In Designer, Opzioni > Impostazioni utente > Modifica impostazioni utente > Proxy > Abilita nuove impostazioni proxy (anteprima) è stata aggiunta per fornire un controllo migliore sulle impostazioni proxy e consentire script PAC.

Nota: in questa versione iniziale, l'impostazione si applica a diverse funzionalità (ad esempio, Strumento Download) ma non ad altre (ad esempio, Connettori o ODBC) in Designer. Per ulteriori informazioni, vedi Impostazioni utente.

2024.2

L'impostazione di sistema "Annulla processi in esecuzione per più di (secondi)" ora viene applicata a tutti i processi.

Nelle versioni precedenti, questa impostazione si applicava solo ai processi pianificati. Per consentire l'esecuzione dei processi manuali più a lungo dei processi pianificati, deseleziona questa impostazione e utilizza le due nuove opzioni dell'Interfaccia utente di Server descritte di seguito.

Per ulteriori informazioni, consulta la pagina Impostazioni di Alteryx Server.

Opzione aggiunta per annullare le esecuzioni di processi manuali di lunga durata

In Interfaccia utente di Server > Amministratore > Impostazioni > Risorse, è disponibile una nuova opzione che consente di annullare le esecuzioni di processi manuali (comprese quelle API) che superano un determinato tempo. Questo si applica a tutti i Worker, a meno che il Worker non abbia impostato Impostazioni di sistema Alteryx > Worker > Generale > Annulla processi in esecuzione per più di (secondi). L'impostazione Worker sovrascrive l'impostazione dell'Interfaccia utente di Server.

Opzione aggiunta per annullare le esecuzioni di processi pianificate di lunga durata

In Interfaccia utente di Server > Amministratore > Impostazioni > Risorse, è disponibile una nuova opzione per annullare le esecuzioni di processi pianificate che si protraggono oltre un determinato periodo di tempo. Questo si applica a tutti i Worker, a meno che il Worker non abbia impostato Impostazioni di sistema Alteryx > Worker > Generale > Annulla processi in esecuzione per più di (secondi). L'impostazione Worker sovrascrive l'impostazione dell'Interfaccia utente di Server.

2024.2

Aggiornamenti API:

Filtro API aggiunto a GET v3/workflows/{workflowID}/jobs

L'endpoint GET v3/Workflows/{workflowID}/jobs può ora filtrare in base a status e resultCode, il che restituisce un elenco di ID processi che corrispondono a questi filtri. Per ulteriori informazioni, visita la sezione Note di release di Server 2024.2 e Endpoint del flusso di lavoro.

  • Sono interessate tutte le API di Server che contengono un indicatore di data e ora.

  • Se esegui l'upgrade da una versione precedente a 2024.1, gli indicatori di data e ora delle risorse esistenti verranno convertiti nel nuovo standard UTC all'avvio di AlteryxService.

Attività: verifica come vengono gestiti i campi Data e ora nelle applicazioni che accedono a MongoDB o all'API. Potrebbe essere necessario regolarli in modo da prevedere Data e ora in UTC.

Nuovi endpoint API per iscrizioni (studi)

Gli Amministratori possono ora gestire le iscrizioni (Studio) utilizzando gli endpoint API Server V3. Questi endpoint aiutano a modificare le iscrizioni in blocco e offrono la possibilità di riportare i singoli utenti negli studi individuali.

Per ulteriori informazioni su questi endpoint, consulta la pagina Endpoint per le iscrizioni.

Aggiornamenti API per gli endpoint del flusso di lavoro

  • SourceAppId viene ora restituito nel corpo di risposta delle seguenti chiamate API:

    • GET/v3/workflows

    • GET/v3/workflow/{workflowID}

    • GET /admin/v1/workflows/migratable

  • Ora i Creatori possono chiamare quanto segue:GET v3/Workflows/{workflowId}

  • I filtri per status e resultCode sono stati aggiunti aGET v3/Workflows/{workflowID}/Jobs:

Per ulteriori informazioni, visita la sezione Note di release di Server 2024.2 e Endpoint del flusso di lavoro.

Nuovo endpoint API per consentire l'aggiornamento delle singole impostazioni di pianificazione

Usa il nuovo endpoint API PATCH /v3/schedules/{scheduleId} per aggiornare una pianificazione senza dover compilare diversi campi obbligatori per ogni singola modifica. Per ulteriori informazioni, consulta la pagina Endpoint delle pianificazioni.

Aggiornamenti per gli endpoint dei processi

  • Nuovo endpoint API GET /v3/Jobs/{jobId}/messages

    Questo endpoint è solo per gli Amministratori. Utilizza jobId come parametro di input per recuperare i messaggi corrispondenti per quel processo.

  • Endpoint API aggiornatoGET /v3/Jobs/{jobId}

    L'endpoint GET /v3/Jobs/{jobId} è stato aggiornato in modo che gli utenti possano vedere i processi che sono stati condivisi con loro tramite Raccolte.

Per ulteriori informazioni, consulta la pagina Endpoint dei processi.

2025.1

Novità / Note di release

Versione

Azioni da intraprendere quando si esegue l'upgrade a questa versione o a quella precedente.

2025.1

Nuova pagina Credenziali per gli utenti non-amministratori

Gli utenti non-amministratori ora hanno accesso a una pagina Credenziali nell'interfaccia utente di Server. Questa pagina consente di visualizzare, creare, modificare ed eliminare le credenziali personalizzate. Per ulteriori informazioni, consulta Credenziali: interfaccia utente di Server.

2025.1

Aggiunta la visualizzazione Risultati del flusso di lavoro per gli amministratori

Gli amministratori ora possono visualizzare i risultati dei flussi di lavoro e i messaggi relativi ai processi tramite Risultati del flusso di lavoro. Per ulteriori informazioni, consulta Risultati del flusso di lavoro: interfaccia di amministrazione.

2025.1

Aggiunto AuditLog per Alteryx System Settings

Gli aggiornamenti a RuntimeSettings.xml tramite l'applicazione Alteryx System Settings ora sono registrati in C:\ProgramData\Alteryx.

2025.1

API Server

Nuovo endpoint per annullare un processo specifico

È stato aggiunto l'endpoint DELETE /v3/jobs/{jobId} per annullare qualsiasi processo in esecuzione o in coda (manuale o pianificato).

Per ulteriori informazioni, consulta la pagina Endpoint dei processi.

Nuovi endpoint per le credenziali di Server condivise

Sono stati aggiunti i seguenti endpoint per le credenziali di Server (non DCM):

  • Crea credenziali di Server: POST /v3/credentials

  • Aggiorna la password delle credenziali di Server esistenti: PUT /v3/credentials/{credentialId}

Questi endpoint sono disponibili solo per gli amministratori e richiedono l'attivazione del TLS. Per ulteriori informazioni, consulta la pagina di assistenza Endpoint delle credenziali.

Aggiunte espressioni Cron per gli endpoint di pianificazione

È stata aggiunta una flessibilità di pianificazione dinamica utilizzando le voci Cron. Ora è possibile utilizzare espressioni Cron nelle seguenti API:

  • POST /v3/schedules

  • PUT /v3/schedules/{scheduleId}

  • PATCH /v3/schedules/{scheduleId}

  • GET /v3/schedules/{scheduleId}

Per ulteriori informazioni, consulta la pagina di assistenza Endpoint di pianificazione.

2025.1

Gli amministratori possono invitare gli utenti ad aggiungere credenziali

Questa funzionalità consente agli amministratori di invitare un utente ad aggiungere una credenziale condivisa, che l'amministratore può successivamente gestire e condividere. Per ulteriori informazioni, consulta Invito a creare o modificare una credenziale.

2025.1

Aggiunto il supporto della crittografia delle asserzioni SAML

È stato introdotto il supporto della crittografia delle asserzioni SAML, che consente di crittografare e firmare le asserzioni. Questa funzionalità è disponibile in ambienti FIPS e non-FIPS.

Per informazioni sulla configurazione, consulta Configurazione dell'autenticazione di Alteryx Server.

2025.2

Novità / Note di release

Versione

Azioni da intraprendere quando si esegue l'upgrade a questa versione o a quella precedente.

2025.2

PIT-STOP

CRITICAL

Aggiornamento di MongoDB integrato alla versione 8

Impatto: nell'ambito dell'installazione di Server 2025.2, verrà eseguito l'upgrade di MongoDB integrato alla versione 8.0.

Attività: Rivedi lo schema Compatibilità tra versioni per assicurare che il percorso di aggiornamento passi alla stessa versione di MongoDB o solo a una versione successiva. Non è possibile aggiornare contemporaneamente Server su più versioni di MongoDB. Per ulteriori informazioni, consulta la sezione Note di release di Server 2025.2.

2025.2

Connessione da Server ad Alteryx One

Alteryx Server ora include la funzionalità Connessioni - Alteryx One sulla pagina Controller. Questa funzionalità semplifica e protegge il processo di collegamento dell'ambiente di Alteryx Server alla piattaforma Alteryx One. Consente inoltre il trasferimento diretto dei metadati di derivazione da Server ai cataloghi dati esterni (come Atlan o Collibra) tramite Alteryx One.

Attività:

  • Configurare la connessione nella piattaforma Alteryx One. Per ulteriori informazioni, fai riferimento alla sezione Connessione di derivazione dei dati.

  • Configurare la connessione nelle impostazioni di sistema di Alteryx. Per ulteriori informazioni, consulta la sezione Controller.

2025.2

Aggiornamenti separati di Designer e Server

Puoi aggiornare Designer indipendentemente da Server, in modo che gli utenti possano accedere immediatamente alle funzionalità più recenti di Designer, senza attendere l'approvazione di Server o gli aggiornamenti dell'ambiente. La pubblicazione delle risorse integrate nelle versioni più recenti di Designer non è più bloccata negli ambienti Server meno recenti.

Per informazioni importanti e aggiornamenti continui, consultare la sezione Compatibilità della versione di Designer e Server.

In seguito a questa modifica, è stato aggiunto un nuovo parametro agli endpoint API del flusso di lavoro. Per ulteriori dettagli, consulta la sezione Nuovo parametro aggiunto agli endpoint del flusso di lavoro.

2025.2

Aggiornamento della procedura di ripristino dell'host di Server

Puoi scegliere tra 2 opzioni di ripristino:

  • Manuale: per completare tutti i passaggi in autonomia.

  • Con script: per utilizzare il nuovo script di ripristino per automatizzare la preparazione, l'installazione e il ripristino di RuntimeSettings e MongoDB, quindi completare manualmente i passaggi rimanenti.

Puoi scaricare lo script dal portale Licenze. Per ulteriori informazioni sul processo di ripristino, consulta la Guida al ripristino dell'host di Server.

2025.2

Programmare le app analitiche direttamente dall'interfaccia utente di Server

Ora, puoi pianificare le app analitiche direttamente dall'interfaccia utente di Server Per pianificare un'app analitica basta selezionarla nell'interfaccia utente di Server, selezionare Programmata, impostare le preferenze, compilare i campi di input obbligatori e salvare la programmazione. Per ulteriori informazioni, consulta la sezione Pianificazione di un flusso di lavoro.

2025.2

API Server

Nuovo endpoint API per il monitoraggio dei processi

È stato aggiunto l'endpoint GET /v3/jobs/ per monitorare tutti i processi sul server.

Per ulteriori informazioni, consulta la pagina Endpoint dei processi.

Nuovo endpoint dell'API per il supporto dei connettori SDK

Aggiunto l'endpoint PUT /v3/dcm/connections/{id}/sharing/collaboration agli endpoint DCM.

Questo endpoint è disponibile solo per gli amministratori. Per ulteriori informazioni, consulta la pagina di assistenza Endpoint DCM.

Nuovo parametro aggiunto agli endpoint del flusso di lavoro

Per supportare gli aggiornamenti separati di Designer e Server, è stato aggiunto il nuovo parametro—bypassWorkflowVersionCheck,—ai seguenti endpoint del flusso di lavoro:

  • POST /v3/workflows

  • POST /v3/workflows/{workflowId}/versions

Questo consente di ignorare la barriera che in genere blocca i caricamenti se la versione di Server è precedente alla versione del flusso di lavoro. Per ulteriori informazioni, consulta la sezioneEndpoint del flusso di lavoro.

2025.2

Funzioni di condivisione delle credenziali utente completate

Ora, puoi utilizzare credenziali duplicate anche se non sono state condivise tramite la piattaforma Alteryx Server. Questo aggiornamento risolve anche i problemi di usabilità e visibilità, offrendo un'esperienza di gestione delle credenziali più fluida.

Per ulteriori informazioni sulle credenziali, consulta le sezioni Credenziali: Interfaccia utente di Server e Credenziali: Interfaccia di amministrazione.

In questa sezione: