Skip to main content

Leitfaden: Server-Host wiederherstellen

Dieses Handbuch soll einem Server-Administrator bei der Wiederherstellung einer Serverinstanz im Falle eines Fehlers eines ursprünglichen Hosts oder von Hosts, beim Wechsel zu einem neuen aktualisierten Server, beim Wechsel von einem On-Premise- zu einem Cloud-Server und in anderen Fällen, in denen sich Ihre Infrastruktur ändert, behilflich sein.

Eine Serverwiederherstellung ermöglicht es Ihnen, einen neuen Server mit Ihren ursprünglichen Benutzern, Workflows, Zeitplänen usw. auszuführen, basierend auf den folgenden Daten Ihres ursprünglichen Servers:

  • Controller-Token

  • RuntimeSettings.xml vom Controller-Knoten

  • MongoDB-Sicherungen

Im Folgenden finden Sie Details zu den einzelnen Schritten des Prozesses:

1 – Vorbereiten

2 – Wiederherstellen RuntimeSettings.xml

3 – MongoDB wiederherstellen

4 – andere Dateien und Einstellungen wiederherstellen

5 – Alteryx Server starten

6 – Test

Im Umfang enthalten:

  • Wiederherstellung nach dem Ausfall einer Einzelrechner-Standardinstallation von Server mit integrierter MongoDB

  • Verfügbare Sicherung, bei der die notwendigen Informationen intakt sind

  • Überschreibungsmöglichkeit des/der Zielrechner/s

Nicht im Umfang enthalten:

  • Server-Umgebung mit mehreren Knoten oder vom Benutzer verwaltete MongoDB - wenden Sie sich an die Kundenbetreuung, wenn Sie Hilfe benötigen.

  • Zusammenführen von Datenbanken mit Verbindungsdateien

  • Sicherung oder Wiederherstellung von ODBC-Treibern

  • Sicherung oder Wiederherstellung von Benutzer- oder System-DSNs

  • Sicherung oder Wiederherstellung anderer in Windows gespeicherter Aliase, die nicht mit Alteryx verbunden sind

Voraussetzungen

  • Die Installation aller Datenbanktreiber und der erforderlichen Software für den Workflow-Betrieb sollte vor der Durchführung der Schritte in dieser Anleitung erfolgen, um minimale Ausfallzeiten zu gewährleisten.

  • Administratorrechte auf dem Zielserver

  • Zugriff auf alle verwendeten Anmeldedaten für den Identitätswechsel, einschließlich des Dienstkontos (falls nicht des lokalen Systems), des Run-As-Benutzers und aller definierten/verwendeten Workflow-Anmeldedaten

  • Controller-Token vom Original-Server.

  • Die Datei „RuntimeSettings.xml" vom Original-Server finden Sie unter:  %PROGRAMDATA%\Alteryx\RuntimeSettings.xml .

  • Sicherung von MongoDB vom Original-Server. Erfahren Sie, wie man eine Sicherung durchführt.

    • Weitere Informationen zur Wiederherstellung und Sicherung von Server finden Sie in den Best Practices zur Wiederherstellung und Sicherung von Server: Teil 1 und Teil 2 .

  • Stellen Sie in den Windows-Zeitzoneneinstellungen sicher, dass der Zielserver auf dieselbe Zeitzone wie der ursprüngliche Server eingestellt ist. Wenn nicht dieselbe Zeitzone eingestellt ist, können Fehler in den Zeitplanansichten auftreten.

Optional

Die folgenden Elemente wurden im Original-Server möglicherweise nicht eingesetzt. Überprüfen Sie, ob die Funktionalität verwendet wurde, und führen Sie die entsprechenden Schritte durch, die in dieser Anleitung als (Optional) gekennzeichnet sind.

  • Service-Anmelde-Benutzer, falls verwendet.

  • „Run-As User"-Details (Als Benutzer ausführen) für die Worker-Konfiguration:

    • Domain

    • Benutzername

    • Kennwort

  • SMTP-Server-Benutzername und -Kennwort für die Server-Konfiguration.

  • Verbindungsglieder von %ProgramData%\Alteryx\Tools .

  • Alteryx System-basierte und In-DB-Verbindungsaliase vom Original-Server.

    • In-DB-Datenverbindungen des Systems finden Sie unter %PROGRAMDATA%\Alteryx\Engine\SystemConnections.xml .

    • Informationen zu Datenverbindungen des Systems finden Sie unter %PROGRAMDATA%\Alteryx\Engine\SystemAlias.xml .

  • Alteryx-Benutzer- und -In-DB-Verbindungsaliase vom Original-Server - die folgenden Angaben können für jedes  Run-As- oder Workflow-Anmeldedaten-Benutzerkonto relevant sein.

    • Benutzerdatenverbindungen siehe C:\Users\[username]\AppData\ROaming\Alteryx\Engine\UserConnections.xml

    • Benutzer-in-DB-Datenverbindungen siehe C:\Users\[username]\AppData\ROaming\Alteryx\Engine\UserAlias.xml

Schritt 1: Zugang

#

Schritt

Details

1.1

Zeitzone der Maschine einstellen

Die Windows-Zeitzone der neuen Maschine muss so eingestellt werden, dass sie mit der ursprünglichen Maschine übereinstimmt.

1.2

Stellen Sie den Zugriff auf Alteryx sicher

Stellen Sie sicher, dass der Computer die vom Alteryx-Lizenzierungssystem verwendete Webdomain whitelist.alteryx.com kontaktieren kann.

1.3

Installieren Sie dieselbe Server-Version

Führen Sie eine saubere Installation des Servers derselben Version durch, die das Mongo-Backup generiert hat.

Verwenden Sie die neueste Wartungsversion für das Quartal, z. B. wenn Ihre Sicherung von Version 2022 stammt. 2 und 2022.4. 5 Wartungsversion ist verfügbar. Verwenden Sie diese Version. Wenn Ihre Version noch nicht unter http://downloads.alteryx.com verfügbar ist , wenden Sie sich bitte an fulfillment@alteryx.com .

Server installieren oder aktualisieren

Test die Server-UI wird in einem Browser angezeigt. Sie müssen sich nicht anmelden.

1.4

Fehlerbehebung

Fehler „in Gebrauch“ des Lizenzschlüssels

Wenn Ihr Lizenzschlüssel noch an Ihren alten Server gebunden ist, müssen Sie ihn auf diesem Computer deaktivieren. Wenn auf diesen Computer nicht zugegriffen werden kann, wenden Sie sich an Ihren Lizenzadministrator, um die Lizenz freizugeben.

Schritt 2: RuntimeSettings.xml wiederherstellen

#

Schritt

Details

2.1

Öffnen Sie die Eingabeaufforderung 1 im bin-Ordner

Öffnen Sie eine Eingabeaufforderung als Administrator, navigieren Sie zum Ordner Alteryx\bin, und geben Sie die folgenden Befehle ein (passen Sie sie je nach Installationsort an).

Programme\Alteryx\bin.

2.2

Stoppen Sie den Service

Geben Sie den Befehl ein

Befehl: net stop alteryxservice

Bei Erfolg sollte die Meldung „Der AlteryxService-Dienst wurde erfolgreich beendet“ angezeigt werden.

2.3

Sichern Sie vorhandene RuntimeSettings.xml

Geben Sie den Befehl ein

c: cd \ProgramData\Alteryx ren RuntimeSettings.xml RuntimeSettings_BACKUP.xml

2.4

Wiederherstellen RuntimeSettings.xml

Kopieren Sie die Datei RuntimeSettings.xml von Ihrem ursprünglichen Server in das aktuelle Verzeichnis %ProgramData%\Alteryx\.

2.5

Controller-Token fehlt

Bearbeiten Sie die RuntimeSettings.xml , die Sie gerade kopiert haben, und löschen Sie alles zwischen den Tags <ServerSecretEncrypted> , wobei nur die Tags wie unten dargestellt bleiben:

64ae505fe2c2c.png

Speichern und schließen Sie die Datei.

2.6

Controller-Token fehlt

Geben Sie den Befehl mit Ihrem ursprünglichen Server-Controller-Token ein

AlteryxService.exe setserversecret=CONTROLLER_TOKEN_FROM_ORIGINAL_SERVER

Problembehandlung

Version 2021.3+ kann bei diesem Schritt Fehler verursachen: „Set Server Secret failed: Error in CryptImportKey(3): Bad Data. (-2146893819)". Um dies zu korrigieren, lesen Sie den vorherigen Schritt, um sicherzustellen, dass der Wert zwischen den Tags entfernt wurde.

2.7

Verschlüsselungsschlüssel Wiederherstellen

Der Wert <StorageKeysEncrypted> hat sich möglicherweise geändert, als das Controller-Token in Schritt 2.6 zurückgesetzt wurde. Wenn ja, sollte er durch den Wert aus der ursprünglichen RuntimeSettings.xml-Datei ersetzt werden. Es ist am einfachsten, die Tags ebenfalls zu kopieren, um sicherzustellen, dass der gesamte Wert zwischen ihnen aus der ursprünglichen RuntimeSettings.xml-Datei kopiert wird. Sie können RuntimeSettings.xml in einem Texteditor geöffnet lassen, wenn Sie in Schritt 3 weitere Änderungen vornehmen.

Step 2.7 Restore Encryption Keys

2.8

Ausführen als Benutzer

Wenn Sie auf dem ursprünglichen Server als Benutzer ausgeführt haben, geben Sie den folgenden Befehl ein, andernfalls überspringen Sie diesen Schritt. AlteryxService.exe setexecuteuser=NAME,DOMAIN,PASSWORD

2.9

SMTP-Kennwort wiederherstellen

Wenn Sie Alteryx-Systemeinstellungen > Server-UI > SMTP > Kennwort eingegeben haben (selbst wenn das Kontrollkästchen SMTP deaktiviert war), geben Sie den folgenden Befehl ein, andernfalls überspringen Sie diesen Schritt. AlteryxService.exe setsmtppassword=PASSWORD

2.10

Sparen Sie RuntimeSettings.xml

Speichern Sie die Datei RuntimeSettings.xml.

2.11

Verschlüsselungsschlüssel

Diese Funktion ist nur bei den folgenden Versionen verfügbar:

  • 2021.4.2 Patch 11+

  • 2022.1 Patch 9+

  • 2022.3 Patch 6+

  • 2023.1 Patch 2+

  • 2023.2 GA+

Wichtig

Bitte beachten Sie, dass hierfür der AlteryxService auf Ihrem ursprünglichen Server-Controller-Knoten ausgeführt werden muss und Ihr neuer Server über das Netzwerk darauf zugreifen muss.

Mit den in Übertragungsprozess für Verschlüsselungsschlüssel beschriebenen Schritten können Sie den Verschlüsselungsschlüssel von Ihrem vorhandenen Controller auf den neuen übertragen.Übertragungsprozess für Verschlüsselungsschlüssel

2.12

Bleiben Sie auf der Befehlszeile

In Schritt 3 wird davon ausgegangen, dass Sie sich in einer Admin-Befehlszeile im Ordner \Alteryx\bin befinden.

Schritt: MongoDB wiederherstellen

#

Schritt

3.1

MongoDB-Backup abrufen

Kopieren Sie die Mongo -Sicherung vom ursprünglichen Server in einen MONGO_BACKUP-Ordner auf Ihrem neuen Server.

3.2

In einem neuen Ordner wiederherstellen

Stellen Sie die Mongo-Datenbank aus dem Sicherungsordner in einem neuen Wiederherstellungsordner wieder her. Der letzte Parameter ,10 sorgt für eine geringere Speichernutzung durch Mongo während der Wiederherstellung. Dies verringert die Wahrscheinlichkeit von Fehlern wegen unzureichendem Arbeitsspeicher, kann jedoch die Wiederherstellungszeit verlängern. Wenn Sie das ,10 weglassen, können Sie die Wiederherstellung schneller durchführen. Prüfen Sie in beiden Fällen mongoRestore.log wie unten beschrieben, um sicherzustellen, dass die Wiederherstellung erfolgreich war.

AlteryxService.exe emongorestore="MONGO_BACKUP_FOLDER","MONGO_RESTORE_FOLDER",10

Beispiel:

AlteryxService.exe emongorestore="D:\db_bkp","%ProgramData%\Alteryx\Service\Persistence\Mongo_Restore",10

3.3

Bestätigen Sie, dass die Wiederherstellung erfolgreich war

Bestätigen Sie, dass die Wiederherstellung erfolgreich war.

Achtung

Dies ist ein notwendiger Schritt, da ein Wiederherstellungsfehler im vorigen Schritt nicht gemeldet wird und zu fehlenden Daten auf Ihrem Server führen kann. Überprüfen Sie dazu die Datei mongoRestore.log im MongoDB-Ordner, in dem die Daten wiederhergestellt wurden. Öffnen Sie mongoRestore.log und führen Sie die folgenden Schritte aus:

  • Prüfen Sie, ob in der letzten Zeile Folgendes vermerkt ist: #### document(s) restored successfully, 0 document(s) failed to restore .

  • Suchen Sie nach Fehler , Kritisch , Schwerwiegend und Fehlgeschlagen . Wenn Sie nach Fehlgeschlagen suchen, achten Sie darauf, dass das Ergebnis nicht der im vorherigen Punkt erwähnte Satz ist, der Wiederherstellung bei 0 Dokument(en) fehlgeschlagen enthält.

Wenn die Wiederherstellung fehlgeschlagen ist oder wenn Sie bei der Suche nach den oben aufgeführten Schlüsselwörtern Ergebnisse finden, wenden Sie sich an den Support und geben Sie alle gesammelten Informationen an.

Fahren Sie nicht fort, wenn die Wiederherstellung von MongoDB fehlgeschlagen ist.

3.4

Legen Sie den Mongo-Pfad in RuntimeSettings.XML fest

Bearbeiten Sie RuntimeSettings.xml und geben Sie den Pfad zum MONGO_RESTORE_FOLDER im Tag <EmbeddedMongoDBRootPath> ein.

Beispiel:

Set Mongo path in RuntimeSettings.XML

Speichern und schließen Sie den Texteditor.

3.5

Starten Sie MongoDB

Geben Sie den Befehl ein

Mongod ––dbpath „MONGO_RESTORE_FOLDER“ ––auth ––Port 27018

Beispiel

Mongod ––dbpath „%ProgramData%\Alteryx\SService\Persistence\Mongo_Restore“ ––auth ––Port 27018

Schließen Sie das Eingabeaufforderungsfenster nicht.

Wenn Sie das Fenster in Schritt 3.5 schließen, funktioniert keiner der folgenden Schritte.

<< Beginnen Sie mit dem zweiten Abschnitt der Eingabeaufforderung >>

3.6

Öffnen Sie die zweite Eingabeaufforderung im bin-Ordner

Öffnen Sie eine ZWEITE Eingabeaufforderung als Administrator , navigieren Sie zum Ordner Alteryx\bin, und geben Sie die folgenden Befehle ein (passen Sie sie an Ihren Installationsort an).

Programme\Alteryx\bin.

3.7

Mongo-Kennwort für nicht-Admin abrufen

Geben Sie den Befehl ein, und kopieren Sie Ihr NON_ADMIN_MONGO_PASSWORD in den Editor

AlteryxService.exe getemongopassword

3.8

Starten Sie Die Mongo-Befehlszeile

Geben Sie den Befehl ein

mongo mongodb://SERVER:PORT/AlteryxGallery -u user -p NON_ADMIN_MONGO_PASSWORD

Beispiel

mongo mongodb://localhost:27018/AlteryxGallery -u user -p CCEC***33C0

Bei Erfolg sollte die Eingabeaufforderung " > " angezeigt werden.

3.9

Vom ursprünglichen Server festgelegte Sperren löschen

Geben Sie den Befehl Mongo ein

db.locks.remove({})

Bei Erfolg sollten Sie Folgendes sehen: " WriteResult({ „nRemoved“ : N }) ", wobei N eine Zahl zwischen 0 und 3 ist.

3.10

Beenden Sie die Mongo-Befehlszeile und die Eingabeaufforderung. 2

Geben Sie den Befehl ein

Beenden

Schließen Sie Command_Prompt_2

<< Beenden Sie den zweiten Abschnitt der Eingabeaufforderung >>

3.11

Stoppen Sie die Mongo-Datenbank

Geben Sie in der ursprünglichen Eingabeaufforderung den Tastaturbefehl ein

strg+c

Einmal oder mehrmals, bis Sie MongoDB beenden und zu einer normalen Eingabeaufforderung zurückkehren.

Schließen Sie beide Eingabeaufforderungen.

Schritt 4: Andere Dateien und Einstellungen wiederherstellen

#

Schritt

Details

4.1

Hatten Sie einen Service-Anmelde-Benutzer auf dem ursprünglichen Server?

Dienstanmelde -Benutzer auf neuem Server festlegen.

Windows-Dienste-App > Klicken Sie mit der rechten Maustaste auf AlteryxService > Eigenschaften > Anmelden

4.2

Fügen Sie Datentreiber und System-DSNs hinzu.

Fügen Sie Treiber mit derselben Version und System-DSNs mit demselben Namen hinzu, um dem ursprünglichen Server https://downloads.alteryx.com/ zu entsprechen .

Erweiterte Probleme, die möglicherweise nicht auf Ihre Wiederherstellung zutreffen:

4.3

Konfigurieren Sie in sichereren Umgebungen die erforderlichen Benutzerberechtigungen „Ausführen als“.

Stellen Sie sicher, dass alle Anmeldeinformationen, die zur Ausführung von Workflows verwendet werden (Ausführen als, Dienstanmeldung oder Anmeldeinformationen beim Speichern des Workflows festgelegt), über ausreichende Zugriffsrechte verfügen. Konfigurieren Sie die erforderlichen Benutzerberechtigungen für die Ausführung.

4.4

Stellen Sie systembasierte und in-DB-Verbindungs-Aliasnamen wieder her

Datenverbindungen verwalten:

%ProgramData%\Alteryx\Engine\SystemAlias.xml

System-in-DB-Datenverbindungen:

%ProgramData%\Alteryx\Engine\SystemConnections.xml

4.5

Stellen Sie die Aliasnamen für benutzerbasierte und in-DB-Verbindungen wieder her

Datenverbindungen verwalten:

C:\Users\[username]\AppData\ROaming\Alteryx\Engine\UserConnections.xml

Benutzer-in-DB-Datenverbindungen:

C:\Users\[username]\AppData\ROaming\Alteryx\Engine\UserAlias.xml

4.6

Verwenden Workflows Connectors?

Kopieren Sie Connector-Ordner von Ihrem ursprünglichen Server in

\ProgramData\Alteryx\Tools

Wenden Sie sich an den Kundendienst , um Connectors auf Ihrem neuen Server zu aktivieren.

4.7

Verwenden Workflows das Python-Tool?

Installieren Sie alle Python-Pakete erneut, die von Workflows installiert wurden. Siehe Server Upgrade Python Tool Environment Checklist.

4.8

Verwenden Workflows das R-Tool?

In Kürze verfügbar ...

4.9

Verfügen Sie über eine Umgebung mit mehreren Knoten oder eine benutzerverwaltete Mongo-Umgebung?

(Demnächst verfügbar) Wenden Sie sich an Ihren Account Executive oder Kundendienst.

4.10

Verwenden Sie SSL?

Wenn Sie eine Wiederherstellung auf einem Sandbox-Server zum Testen durchführen, verwenden Sie HTTP zum Testen.

Wenn Sie auf einen neuen Server migrieren, stellen Sie SSL wieder her:

SSL/TLS für Server konfigurieren

Konfigurieren von Alteryx Server für SSL: Abrufen und Installieren der Zertifikate

Schritt 5: Starten Sie den Alteryx Server

#

Schritt

Details

5.1

Überprüfen Sie die Alteryx-Systemeinstellungen, und unterbrechen Sie die Zeitpläne, falls gewünscht.

Führen Sie die Alteryx-Systemeinstellungen aus , und gehen Sie durch jede Seite, um zu bestätigen, dass die Einstellungen (wie das Controller-Token) die erwarteten Werte enthalten.

Wenn Sie nicht möchten, dass Zeitpläne ausgeführt werden, wenn der Service gestartet wird, deaktivieren Sie Folgendes:

Ausführung geplanter Alteryx-Workflows auf Computer zulassen:

Wenn Sie Finish wählen, sollte der AlteryxService starten und Server in einem Browser verfügbar sein.

Wichtig

Achten Sie besonders auf die Server-UI-Konfigurationseinstellungen , da ein neuer Server möglicherweise eine andere URL hat oder kein SSL-Zertifikat hat.

System Settings, the Server UI configuration section.

Schritt 6: Optional

#

Schritt

Details

6.1

Grundlegende Tests

Wird der AlteryxService ausgeführt?

Können Sie:

  • Auf die Server-UI-URL zugreifen?

  • In Admin-Seiten navigieren und Benutzer, Sammlungen usw. anzeigen?

  • Workflow aus Designer auf dem Server veröffentlichen?

  • Workflow ausführen:

  • Wenn Ihre Konfiguration dies zulässt, speichern und führen Sie einen Workflow aus, in dem Sie Ihre Anmeldeinformationen angeben.

6.2

Workflow-spezifische Tests

Können Sie Workflows ausführen, die Erweiterungen oder externe Verbindungen enthalten, wie z. B.

  • Eingabe/Ausgabe zu einem Netzwerk-UNC-Pfad

  • Datenbankverbindungen

  • Konnektoren-Tool

  • Überblick: Location & Business Insights

  • Python-Tool

  • R-Tool