Skip to main content

Version zu Version Server-Upgrade-Handbuch: Unterstützte Versionen

Wichtig

Bitte beachten Sie die Checkliste für Server-Upgrades, um ein erfolgreiches Server-Upgrade zu planen und durchzuführen, einschließlich des Workflows für die Überprüfung vor dem Upgrade, um Probleme zu identifizieren, die zu einem Fehlschlagen des Upgrades führen können.

Ist dieses Dokument hilfreich?

In diesem Dokument werden Aufgaben und Änderungen hervorgehoben, die Sie beim Aktualisieren über Versionen von Alteryx Server beachten müssen. Die Probleme sind kumulativ, daher sollten Sie sich beim Durcharbeiten mehrerer Versionen jeden Abschnitt durchlesen. Dies ersetzt nicht die Versionshinweise (siehe Links in im jeweiligen Abschnitt).

Versionsveröffentlichungsplan

  • Halbjährliche Versionsveröffentlichungen bieten zusätzliche Funktionen, können aber auch die Serververwaltung ändern, sodass Sie oder Ihre Benutzer:innen ihr Verhalten ändern müssen.

  • In den Wartungsversionen/-Patches in jedem Quartal werden die in der ursprünglichen Version gefundenen Probleme behoben. Die erste Wartungsversion für 2022.3 wäre beispielsweise 2022.3.2.

Legende

PIT-STOP

Signifikante Änderung, die ein Upgrade auf diese Version erfordert, bevor ein Upgrade auf eine neuere Version durchgeführt werden kann.

MongoDB-Upgrade

Die Version der Mongo-Datenbank wird aktualisiert.

Ein Alteryx-Server-Upgrade kann nur EIN MongoDB-Versions-Upgrade zwischen Ihrer aktuellen Version und der Zielversion umfassen.

KRITISCH

Kritisches Problem: Administratoren müssen diese Version beachten, wenn sie zu dieser Version wechseln oder sie überspringen.

Kriterien für Einträge in dieser Liste

Diese Liste enthält die Versionshinweise für jede Version, um Folgendes zu verdeutlichen:

  • Administrator:innen oder Benutzer:innen müssen eine Aktion ausführen.

  • Element ist wichtig bei der Auswahl einer Upgrade-Version (d. h. geändertes Verhalten oder Fehler).

  • In der Server-Administration wurde eine signifikante Änderung vorgenommen.

2022.3 und frühere Versionen

Nicht unterstützte Versionen (2022.3 und früher) finden Sie unter Version zu Version Server-Upgrade-Handbuch: Nicht unterstützte Versionen.

2024.1

Neuigkeiten / Versionshinweise

Version

Maßnahmen, die beim Aktualisieren auf diese Version – oder eine ältere Version – ergriffen werden müssen.

2024.1

Administrative Funktion: Möglichkeit, Asset-Besitzrechte über Benutzeroberfläche und API zu übertragen

Administratoren können die Besitzrechte von Workflows und Zeitplänen zwischen Benutzer:innen über die Server-Benutzeroberfläche oder mithilfe von Server-API V3-Endpunkten übertragen.

Auswirkung:

Anmerkung

  • Der Workflow-Auftragverlauf ist für den/die neue(n) Besitzer:in nicht sichtbar.

  • Der Workflow wird in das Studio des neuen Besitzers verschoben, was die Sichtbarkeit für andere Benutzer:innen im Quell- oder Zielstudio beeinträchtigt.

  • Zusätzliche Elemente müssen mit dem/der neuen Besitzer:in geteilt werden, um den Workflow erfolgreich auszuführen:

    • DCM-Verbindung

    • Shared-Gallery-Datenbankverbindung

    • Anmeldedaten für Shared Gallery

2024.1

Neue Funktion: Neue Datenbankoption hinzugefügt (SQL DB)

Die benutzerverwaltete SQL-Server-Datenbank kann anstelle von MongoDB verwendet werden. Derzeit sind MSSQL Server 2019 und 2022 die einzigen offiziell unterstützten Versionen von SQL.

Auswirkung:

2024.1

KRITISCH

Python-Upgrade: Eingebettetes Python upgradet von 3.8.16 auf 3.10.13

Auswirkung:

Die folgende Fehlermeldung wird angezeigt, wenn eine inkompatible Version eines Konnektors in Designer verwendet wird: „Version 3.8 wurde in unserer Alteryx-Verteilung nicht gefunden. Wählen Sie eine andere Version aus. Interner Fehler – Deadlock erkannt.“

Aufgabe

  • Alle Konnektor-Tools müssen durch eine neue Version ersetzt werden.

  • Benutzer:innen sollten Python in Workflows erneut testen. Die Engine verwendet weiterhin Python Version 3, daher sollte es kaum Auswirkungen auf Skripte geben.

2024.1

KRITISCH

Änderung des MongoDB-Datum/Uhrzeitfeld (Dienst-Zeitstempel in das UTC-Format in Serverdatenbanken umgestellt)

Auswirkung: Wir haben alle Datum/Uhrzeitfelder auf UTC umgestellt, um die Handhabung von Zeitzonen- und Sommerzeitänderungen zu verbessern. Weitere Informationen finden Sie in den Versionshinweisen zu Server 2024.1.

  • Alle Server-APIs mit einem Zeitstempel-Element sind betroffen.

  • Wenn Sie ein Upgrade von einer älteren Version auf 2024.1 durchführen, werden die Zeitstempel vorhandener Assets beim Start von AlteryxService in den neuen UTC-Standard konvertiert.

Aufgabe: Überprüfen Sie, wie Datums/Uhrzeitfelder in Anwendungen gehandhabt werden, die auf MongoDB oder die API zugreifen. Sie müssen möglicherweise angepasst werden, um die Datum/Zeitangaben in UTC zu erhalten.

2024.1

Verwaltung von DCM-Entwicklungs-/Produktionsservern: Der Produktionsserver kann den Entwicklungs-DCM auf Produktionverbindungen umleiten

Auswirkung: DCM-Verbindungen und DCM-Verbindungsbehandlung wurden zum Admin-Menü hinzugefügt. Weitere Informationen finden Sie auf den folgenden Hilfeseiten:

Aufgabe: Fügen Sie DCM-Umleitungen zu Produktivserver hinzu, damit von der Entwicklungsumgebung migrierte Workflows ohne Änderungen im Workflow auf Produktivdatenquellen zugreifen können.

2024.1

DCM-Administration: Granularität der Benutzerberechtigung

Auswirkung: Neue DCM-Berechtigungen hinzugefügt. Weitere Informationen finden Sie auf der Hilfeseite Benutzerrollen und -berechtigungen.

2024.1

DCM-Administration: Generischer externer DCM-Tresor hinzugefügt

Auswirkung: Sie können einen generischen Tresor konfigurieren, der mithilfe einer programmatischen Schnittstelle und einer Standardauthentifizierung Geheimnisse aus jedem Tresor abrufen kann.

2024.1

Administrationsänderung: Gleichzeitige DCM-Freigabe

Auswirkung: Sie können dieselbe DCM-Verbindung für die Zusammenarbeit und separat für die Ausführung verwenden. Bisher konnten Sie nur 1 Freigabeoption wählen. Weitere Informationen finden Sie unter Data Connection Manager: Server-Benutzeroberfläche.

2024.1

Ende der Lebensdauer von Insights

Auswirkung: Insights ist in Alteryx Server nicht mehr verfügbar. Weitere Informationen finden Sie auf der FAQ-Seite.

2024.2

Neuigkeiten / Versionshinweise

Version

Maßnahmen, die beim Aktualisieren auf diese Version – oder eine ältere Version – ergriffen werden müssen.

2024.2

PIT-STOP

KRITISCH

Aktualisierung der eingebetteten MongoDB auf Version 7

Auswirkung: Im Rahmen der Installation von Server 2024.2 wird die eingebettete MongoDB auf Version 7.0 aktualisiert. Die Mindestversion von Server für das Upgrade ist 2023.2 (MongoDB Version 6.0).

Aufgabe: Stellen Sie sicher, dass die Serverversion 2023.2 oder 2024.1 ist, und führen Sie dann die in den Versionshinweisen zu Server 2024.2 beschriebenen Schritte aus.

2024.2

PIT-STOP

KRITISCH

Version 2024.2 ist die letzte Version, die Crypto Migrator-Code enthält.

Dieser Pit-Stop gilt nur für benutzerverwaltete MongoDB-Upgrades von 2022.1 oder früher, für das die Datenbank während des Upgrades eine Krypto-Migration durchlaufen muss.

Aufgabe: Durchlaufen Sie den Krypto-Migrationsprozess, der im Abschnitt zu 2022.3 im Version zu Version Server-Upgrade-Handbuch: Nicht unterstützte Versionen und unter Migration-Prep-Tool erläutert wird.

2024.2

Datenverbindungen und Workflows zu DCM migrieren

Sie können jetzt Shared-Server-Datenverbindungen zu DCM-Verbindungen migrieren. Überprüfen Sie hierzu den Abschnitt „So migrieren Sie Server-Datenverbindungen zu DCM“ und Datenverbindungen.

2024.2

Möglichkeit, Benutzer in einem Studio auf einen Benutzer zu beschränken

Administratoren haben die Möglichkeit, gemeinsam genutzte Studios zu deaktivieren, indem sie die Anzahl der Benutzer in einem Studio auf einen Benutzer beschränken. Als Administrator:in können Sie jetzt die Besitzrechte für Assets einfach übertragen, indem Sie den Workflow von einem Studio in ein anderes übertragen.

Um die Anzahl der Mitglieder in einem Studio auf einen Benutzer zu beschränken, gehen Sie zu Admin >Einstellungen >Konfiguration >Benutzer. Aktivieren Sie dann das Kontrollkästchen Studio auf einen Benutzer beschränken. Weitere Informationen finden Sie unter Alteryx-Server-Einstellungen.

2024.2

Einschränkung der Veröffentlichung von Workflows: Einstellung „Global“

Administrator:innen können jetzt steuern, wie Workflows veröffentlicht werden (öffentlich oder nicht öffentlich), indem sie das Kontrollkästchen Öffentlichen Workflow einschränken (global) aktivieren oder deaktivieren. Gehen Sie dazu zu Admin >Einstellungen >Sicherheit.

Weitere Informationen finden Sie unter Alteryx-Server-Einstellungen.

2024.2

Erweiterte Proxyeinstellungen in Designer

In Designer wurde unter Optionen > Benutzereinstellungen > Benutzereinstellungen bearbeiten > Proxy > Neue Proxy-Einstellungen aktivieren (Vorschau) hinzugefügt, um eine bessere Kontrolle über Proxyeinstellungen zu ermöglichen und PAC-Skripte zuzulassen.

Hinweis: In dieser ersten Version gilt die Einstellung für mehrere Funktionen (z. B. Herunterladen-Tool) in Designer, aber nicht für andere (z. B. Konnektoren oder ODBC). Weitere Informationen finden Sie unter Benutzereinstellungen.

2024.2

Die Systemeinstellung „Aufträge abbrechen, deren Ausführung länger dauert als (Sekunden)“ gilt jetzt für alle Aufträge.

In früheren Versionen wurde diese Einstellung nur auf geplante Aufträge angewendet. Damit manuelle Aufträge länger als geplante Aufträge ausgeführt werden können, löschen Sie diese Einstellung und verwenden Sie die beiden unten erläuterten neuen Optionen für die Server-Benutzeroberfläche.

Weitere Informationen finden Sie unter Alteryx-Server-Einstellungen.

Option zum Abbrechen von manuellen Aufträgen mit langer Laufzeit hinzugefügt

Unter Server-Benutzeroberfläche > Admin > Einstellungen > Assets gibt es eine neue Option, um die Ausführung manueller Aufträge (einschließlich API-Aufträge) abzubrechen, die länger als eine bestimmte Zeit laufen. Dies gilt für alle Mitarbeiter, es sei denn, der Worker hat Alteryx-Systemeinstellungen > Worker > Allgemein > Aufträge abbrechen, deren Ausführung länger dauert als (Sekunden). Die Worker-Einstellung überschreibt die Einstellung der Server-Benutzeroberfläche.

Option zum Abbrechen von geplanten Aufträgen mit langer Laufzeit hinzugefügt

Unter Server-Benutzeroberfläche > Admin > Einstellungen > Assets gibt es eine neue Option, um die Ausführung geplanter Aufträge abzubrechen, die länger als eine bestimmte Zeit laufen. Dies gilt für alle Mitarbeiter, es sei denn, der Worker hat Alteryx-Systemeinstellungen > Worker > Allgemein > Aufträge abbrechen, deren Ausführung länger dauert als (Sekunden). Die Worker-Einstellung überschreibt die Einstellung der Server-Benutzeroberfläche.

2024.2

API-Aktualisierungen:

API-Filterung hinzugefügt für GET v3/workflows/{workflowID}/jobs

Der Endpunkt GET v3/workflows/{workflowID}/jobs kann jetzt optional nach Status und Ergebniscode filtern und gibt eine Liste von Auftrags-IDs zurück, die mit diesen Filtern übereinstimmen. Weitere Informationen finden Sie unter Versionshinweise zu Server 2024.2 und Workflow-Endpunkte.

  • Alle Server-APIs mit einem Zeitstempel-Element sind betroffen.

  • Wenn Sie ein Upgrade von einer älteren Version auf 2024.1 durchführen, werden die Zeitstempel vorhandener Assets beim Start von AlteryxService in den neuen UTC-Standard konvertiert.

Aufgabe: Überprüfen Sie, wie Datums/Uhrzeitfelder in Anwendungen gehandhabt werden, die auf MongoDB oder die API zugreifen. Sie müssen möglicherweise angepasst werden, um die Datum/Zeitangaben in UTC zu erhalten.

Neue API-Endpunkte für Abonnements (Studios)

Administratoren können Abonnements (Studios) jetzt über Server V3 API-Endpunkte verwalten. Diese Endpunkte helfen bei der Massenbearbeitung von Abonnements und bieten die Möglichkeit, einzelne Benutzer wieder in einzelne Studios zu verschieben.

Weitere Informationen zu diesen Endpunkten finden Sie unter Abonnement-Endpunkte.

API-Aktualisierungen für Workflow-Endpunkte

  • „SourceAppId“ wird jetzt im Antworttext der folgenden API-Aufrufe zurückgegeben:

    • GET/v3/workflows

    • GET/v3/workflow/{workflowID}

    • GET /admin/v1/workflows/migratable

  • Folgendes kann nun von Creators aufgerufen werden:GET v3/workflows/{workflowId}

  • Filtern nach Status und Ergebniscode wurden hinzugefügt zu GET v3/workflows/{workflowID}/jobs:

Weitere Informationen finden Sie unter Versionshinweise zu Server 2024.2 und Workflow-Endpunkte.

Neuer API-Endpunkt zum Aktualisieren individueller Zeitplaneinstellungen

Verwenden Sie den neuen API-Endpunkt PATCH /v3/schedules/{scheduleId}, um einen Zeitplan zu aktualisieren, ohne mehrere Pflichtfelder ausfüllen zu müssen, um eine einzelne Änderung vorzunehmen. Weitere Informationen finden Sie unter Endpunkte für Zeitpläne.

Aktualisierungen für Auftragsendpunkte

  • Neuer API-EndpunktGET /v3/jobs/{jobId}/messages

    Dieser Endpunkt ist nur für Administratoren bestimmt. Verwenden Sie die jobId als Eingabeparameter, um die entsprechenden Nachrichten für diesen Auftrag abzurufen.

  • Aktualisierung des API-EndpunktsGET /v3/jobs/{jobId}

    Der Endpunkt GET /v3/jobs/{jobId} wurde aktualisiert, damit Benutzer:innen die Aufträge sehen können, die über Sammlungen für sie freigegeben wurden.

Weitere Informationen finden Sie unter Auftragsendpunkte.

2025.1

Neuigkeiten / Versionshinweise

Version

Maßnahmen, die beim Aktualisieren auf diese Version – oder eine ältere Version – ergriffen werden müssen.

2025.1

Neue Anmeldedaten-Seite für Nicht-Admin-Benutzer:innen

Nicht-Admin-Benutzer:innen haben jetzt Zugriff auf die Seite „Anmeldedaten“ in der Server-Benutzeroberfläche. Auf dieser Seite können sie benutzerdefinierte Anmeldedaten anzeigen, erstellen, bearbeiten und löschen. Weitere Informationen finden Sie unter Anmeldedaten: Server-Benutzeroberfläche.

2025.1

Workflow-Ergebnisansicht für Admins hinzugefügt

Admins haben nun die Möglichkeit, die Workflow-Ergebnisse und Auftragsmeldungen in der Ansicht „Workflow-Ergebnisse“ anzuzeigen. Weitere Informationen finden Sie unter Workflow-Ergebnisse: Admin-Benutzeroberfläche.

2025.1

Auditprotokoll für Alteryx Systemeinstellungen hinzugefügt

Aktualisierungen von RuntimeSettings.xml über die Anwendung „Alteryx Systemeinstellungen“ werden nun unter C:\ProgramData\Alteryx protokolliert.

2025.1

Server-API

Neuer Endpunkt zum Abbrechen eines bestimmten Auftrags

Der Endpunkt DELETE /v3/jobs/{jobId} wurde hinzugefügt, um laufende oder in der Warteschlange befindliche Aufträge abzubrechen (manuell oder geplant).

Weitere Details finden Sie unter Auftragsendpunkte.

Neue Endpunkte für freigegebene Server-Anmeldedaten

Es wurden folgende Endpunkte für Server-Anmeldedaten (nicht-DCM) hinzugefügt:

  • Server-Anmeldedaten erstellen: POST /v3/credentials

  • Kennwort für vorhandene Server-Anmeldedaten aktualisieren: PUT /v3/credentials/{credentialId}

Diese Endpunkte sind nur für Administratoren verfügbar und erfordern, dass TLS aktiviert ist. Weitere Informationen finden Sie auf der Hilfeseite Anmeldedatenendpunkte.

Cron-Ausdruck für Zeitplanendpunkte hinzugefügt

Es wurde die Möglichkeit hinzugefügt, durch Verwendung von Cron-Einträgen dynamische Planung flexibler zu nutzen. Sie können Cron-Ausdrücke jetzt in folgenden APIs einsetzen:

  • POST /v3/schedules

  • PUT /v3/schedules/{scheduleId}

  • PATCH /v3/schedules/{scheduleId}

  • GET /v3/schedules/{scheduleId}

Weitere Details finden Sie auf der Hilfeseite Zeitplanendpunkte.

2025.1

Admins können Benutzer:innen zum Hinzufügen von Anmeldedaten einladen

Mit dieser Funktion können Admins eine/n Benutzer:in dazu einladen, freigegebene Anmeldedaten hinzuzufügen, die der Admin dann verwalten und teilen kann. Weitere Einzelheiten finden Sie unter Zum Erstellen oder Bearbeiten von Anmeldedaten einladen.

2025.1

Unterstützung für SAML-Assertion-Verschlüsselung hinzugefügt

Wir unterstützen jetzt die SAML-Assertion-Verschlüsselung, sodass Sie Assertions sowohl verschlüsseln als auch signieren können. Diese Funktion ist sowohl in FIPS- als auch Nicht-FIPS-Umgebungen verfügbar.

Details zur Konfiguration finden Sie auf der Hilfeseite Alteryx Server-Authentifizierung konfigurieren.

2025.2

Neuigkeiten / Versionshinweise

Version

Maßnahmen, die beim Aktualisieren auf diese Version – oder eine ältere Version – ergriffen werden müssen.

2025.2

PIT-STOP

KRITISCH

Aktualisierung der eingebetteten MongoDB auf Version 8

Auswirkung: Im Rahmen der Installation von Server 2025.2 wird die eingebettete MongoDB auf Version 8.0 aktualisiert.

Aufgabe: Überprüfen Sie den Schema Version Crosswalk (Schemaversions-Crosswalk), um sicherzustellen, dass der Upgradepfad zur selben Version von MongoDB oder nur auf eine Version höher führt. Sie können Server nicht direkt über mehrere MongoDB-Versionen gleichzeitig aktualisieren. Weitere Informationen finden Sie in den Versionshinweisen zu Server 2025.2.

2025.2

Server zu Alteryx One

Alteryx Server enthält jetzt auf der Controller-Seite die neue Funktion „Connections – Alteryx One“ (Verbindungen – Alteryx One). Diese Funktion vereinfacht und sichert den Prozess der Verknüpfung Ihrer Alteryx Server-Umgebung mit der Alteryx One Plattform. Sie ermöglicht die direkte Übertragung von Datenherkunft-Metadaten von Server in externe Datenkataloge (wie Atlan oder Collibra) über Alteryx One.

Aufgaben

  • Richten Sie die Verbindung in der Alteryx One Plattform ein. Weitere Informationen finden Sie unter Datenherkunft-Verbindung.

  • Richten Sie die Verbindung in den Alteryx-Systemeinstellungen ein. Weitere Informationen finden Sie unter Controller.

2025.2

Entkoppelte Designer- und Server-Aktualisierungen

Sie können Designer unabhängig von Server aktualisieren, sodass Benutzer:innen sofort auf die neuesten Designer-Funktionen zugreifen können, ohne auf die Server-Genehmigung oder auf Umgebungsaktualisierungen warten zu müssen. In neueren Versionen von Designer erstellte Assets werden nicht mehr für die Veröffentlichung in älteren Server-Umgebungen gesperrt.

Wichtige Details und laufende Aktualisierungen finden Sie unter Kompatibilität der Designer- und Server-Version.

Aufgrund dieser Änderung wurde den Workflow-API-Endpunkten ein neuer Parameter hinzugefügt. Weitere Informationen finden Sie unter Neuer Parameter zu Workflow-Endpunkten hinzugefügt.

2025.2

Serverhost-Wiederherstellungsprozess wurde aktualisiert

Wählen Sie zwischen 2 Wiederherstellungsoptionen:

  • Manuell: Führen Sie alle Schritte selbst aus.

  • Scripted (skriptbasiert): Verwenden Sie das neue Wiederherstellungsskript, um die Vorbereitung, Installation und Wiederherstellung von RuntimeSettings und MongoDB zu automatisieren, und schließen Sie dann die restlichen Schritte manuell ab.

Laden Sie das Skript über das Lizenzportal herunter. Weitere Informationen zum neuen Wiederherstellungsvorgang finden Sie im Leitfaden: Server-Host wiederherstellen.

2025.2

Planen von Analyse-Apps über die Server-Benutzeroberfläche

Sie können jetzt Analyse-Apps direkt über die Server-Benutzeroberfläche planen. Wählen Sie zur Zeitplanung einer Analyse-App einfach die App in der Server-Benutzeroberfläche aus, dann die Option Zeitplan, legen Sie Ihre Einstellungen fest, füllen Sie alle erforderlichen Eingabefelder aus und speichern Sie den Zeitplan. Weitere Informationen finden Sie unter Workflows planen.

2025.2

Server-API

Neuer API-Endpunkt zur Überwachung von Aufträgen

Der Endpunkt GET /v3/jobs/ wurde hinzugefügt, um alle Aufträge in Server zu überwachen.

Weitere Details finden Sie unter Auftragsendpunkte.

Neuer API-Endpunkt zur Unterstützung von SDK-Konnektoren

Der Endpunkt PUT /v3/dcm/connections/{id}/sharing/collaboration wurde zu den DCM-Endpunkten hinzugefügt.

Dieser Endpunkt ist nur für Administrator:innen verfügbar. Weitere Informationen finden Sie auf der Hilfeseite DCM-Endpunkte.

Neuer Parameter zu Workflow-Endpunkten hinzugefügt

Um entkoppelte Designer- und Server-Aktualisierungen zu unterstützen, wurde den folgenden Workflow-Endpunkten der neue Parameter bypassWorkflowVersionCheck hinzugefügt:

  • POST /v3/workflows

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

Dadurch können Sie die Schutzvorrichtung umgehen, die Uploads normalerweise blockiert, wenn die Server-Version älter als die Workflow-Version ist. Weitere Informationen zur Nutzung finden Sie unter Workflow-Endpunkte.

2025.2

Funktionen zur Freigabe von Benutzeranmeldedaten abgeschlossen

Sie können jetzt doppelte Anmeldedaten verwenden, auch wenn diese nicht über die Alteryx Server-Plattform freigegeben werden. Dieses Update behebt außerdem Probleme hinsichtlich der Benutzerfreundlichkeit und Darstellung und sorgt so für eine reibungslosere Verwaltung von Anmeldedaten.

Weitere Informationen zu den Anmeldedaten finden Sie unter Anmeldedaten: Server-Benutzeroberfläche und Anmeldedaten: Admin-Benutzeroberfläche.