Manage Node

Warnung

Obwohl die Manage Node-Schnittstelle für beide sichtbar sein sollte Admin und Configuration Benutzer, Konfiguration Benutzer werden nicht alle Management-Funktionalität auf dieser Seite beschrieben sehen. Das ist absichtlich. Die Konfigurationsbenutzer können den Laufprozess sehen und Protokolle zum Fehlerbehebung und Support herunterladen, können aber keine Knoten-Level-Einstellungen wie Benutzerberechtigungen, Emulator-Management oder OAI-PMH-Endpunktsynchronisation steuern.

Die Seite Manage Node hat zwei primäre Abschnitte: Node Management zur Steuerung der node selbst (Emulatoren, OAI-PMH, Rechenressourcen) und Node Benutzerverwaltung zur Verwaltung der Benutzer, die auf den Knoten zugreifen können. Siehe jeden Abschnitt unten für weitere Details.

Diese Seite zeigt auch die EaaSI Application Versionsnummer des Knotens an, die wichtige Informationen enthält, wenn Fehler melden.

Node Management

Emulatoren

Die EaaSI-Plattform basiert auf einer Reihe von Open-Source-Emulatoren. Replikieren von Umgebungen, Fehlerbehebung und Erweiterung einer Knoten-Funktionalität alle können eine gewisse Verwaltung der Emulatoren selbst beinhalten.

Admin Benutzer können Emulatoren über den Abschnitt „Emulatoren“ der Seite „Manage Node“ überprüfen und verwalten.

../_images/emulators_menu1.png

Die Auflistung auf dieser Seite stellt die gesamte Palette von Emulatoren dar, die vom Entwicklungsteam über das GitLab Repository dem EaaSI-Netzwerk containerisiert und zur Verfügung gestellt wurden.

Warnung

Dies bedeutet not, dass alle aufgelisteten Emulatoren für den sofortigen Einsatz im aktuellen Knoten notwendig sind. Die Anwesenheit/Verfügbarkeit des Emulators im Knoten wird durch die „Number of Images“ bestimmt.

Zum Beispiel enthält der Beispielknoten im obigen Screenshot QEMU (vier Versionen/Bilder), BasiliskII (eine Version), SheepShaver (eine Version) und VICE (eine Version).

Details für jeden Emulator - Versionsnummer(n), Docker Quell-Info, etc. - können durch Klicken auf die Schaltfläche „Details“ überprüft werden.

../_images/emulator_images.png

Auch im obigen Beispiel hat die Knoteninstallation vier Bilder/Versionen von QEMU zur Verfügung: 2,5, 2.12, 3.0 und 3.1. Dies kann für die Fehlerbehebung von Umgebungen bequem sein, da bestimmte Versionen eines Emulators mit bestimmten älteren Betriebssystemen oder Hardware besser kompatibel sein können als andere.

Wenn ein Emulator mehrere Bilder/Versionen in einem Knoten hat, kann die Version, die EaaSI verwendet, um eine Umgebung auszuführen, auf einer bestimmten Umgebungsdetailseite unter „Emulator“-Einstellungen angesehen und bearbeitet werden:

../_images/emulator_version_settings.png

Bemerkung

Das „Default“-Tag bestimmt, welche Emulatorbild/Version beim Erstellen neuer Umgebungen mit einer Systemvorlage verwendet wird, die von diesem Emulator abhängt.

Neue Emulatorbilder/Versionen können dem Knoten auf zwei Arten hinzugefügt werden: entweder durch Umgebungsreplikation oder manuelles Hinzufügen von Docker-Bildern.

Emulator-Bilder werden automatisch in einen Knoten importiert, wenn ein Knoten-Benutzer versucht, eine Umgebung von einem Remote-Knoten im Netzwerk zu replizieren, und der Host-Knoten hat nicht das Emulator-Bild, den Remote-Knoten verwendet, um diese Umgebung ursprünglich zu erstellen und zu konfigurieren.

*Zum Beispiel: Ein Benutzer bei Node A sieht eine entfernte Mac OS 9.0.4 Umgebung, die mit SheepShaver von Node B zur Verfügung steht. Node A hat derzeit kein SheepShaver-Bild installiert. Aber wenn der Benutzer sich für die Replikation entscheidet, wird das entsprechende SheepShaver-Bild im Rahmen des Umweltreplikationsprozesses importiert, ohne dass eine zusätzliche Eingabe erforderlich ist. Schafe Shaver wird nun auch in Node A für zukünftige Umwelterstellung und -konfiguration verfügbar sein. *

Die Replikationsmethode erfordert wenig bis kein direktes Management von einem EaaSI Admin. Aber Admins können auch manuell Emulatorbilder hinzufügen, indem Sie auf der Emulatorseite auf die Schaltfläche „Import Emulator“ klicken:

../_images/import_emulator_button1.png

Dies bringt das Import Emulator Pop-up-Menü auf:

../_images/import_emulator_menu1.png

Anweisungen zum Ausfüllen der Namens- und Tag-Felder divergieren leicht, je nachdem, ob der Benutzer versucht, ein neues QEMU-Bild oder einen anderen Emulator-Container zu importieren:

QEMU: EaaS QEMU Bilder werden auf DockerHub geschoben. Für das Feld „Name“ füllen Sie „eaas/qemu-eaas“ aus, dann verwenden Sie die Liste der verfügbaren Tags auf DockerHub, um den gewünschten QEMU-Container anzugeben: `<https://hub.docker.com/r/eaas/qemu-eaas/tags/> `_.

Alle anderen: Alle anderen Emulatorbilder werden direkt auf GitLab gehostet. Um die Referenzinformationen für ein Docker-Bild zu erhalten, wählen Sie zunächst den entsprechenden Emulator aus der Liste der verfügbaren Projekte auf dem EaaS GitLab: https://gitlab.com/emulation-as-a-service/emulators

Einmal im jeweiligen Emulatorprojekt (z.B. https://gitlab.com/emulation-as-a-service/emulators/vice-eaas), klicken Sie auf „Registry“ im linken GitLab Menü. Von diesem Bildschirm aus finden Sie den Link zum Container-Emulator (** Verwenden Sie die vollständige registy.gitlab.com Adresse als „Name“ des Emulators im Import Emulator Menü*) und bestimmte markierte Versionen, falls gewünscht.

../_images/container_registry_link1.png

Bemerkung

Wenn kein Tag angegeben ist, wird die EaaSI-Importfunktion wie in der Dockerdatei jedes Emulators angegeben in das „letzte“ Bild eingeblendet.

Das optionale Feld „Emulator Alias“ wird die „User-Version“-Informationen auf der Seite „Details“ des Emulators bevölkern und hilft zu unterscheiden, wenn es mehrere Bilder für einen Emulator in einem Knoten gibt.

Wenn Namen, Tag und Emulator Alias Felder alle nach Wunsch ausgefüllt wurden, klicken Sie auf die Schaltfläche „Import Emulator“. Nach einer Minute oder zwei sollte das neue Emulatorbild im Emulatoren-Menü sichtbar und zur Erstellung und Konfiguration von Umgebungen verfügbar sein.

Endpunkte/Metadata Sync

Benutzer können Metadaten von anderen Knoten im Netzwerk (d.h. synchronisieren veröffentlichte Umgebungen) mit den Einstellungen „Endpoints/Metadata Sync“ abrufen.

../_images/oai-pmh_settings1.png

Um Endpunkte (andere Knoten) dieser Seite hinzuzufügen, klicken Sie auf die Schaltfläche „Neuer Endpunkt hinzufügen“.

../_images/add_endpoint1.png

Details zum Hinzufügen von EaaSI Network-Knoten (d.h. den entsprechenden Host-Location-URLs für jeden Knoten) werden den Admins für die Konfiguration jedes Knotens zur Verfügung gestellt. Sie sollten das Feld „Endpoint Name“ verwenden, um den Endpunkt etwas schnell und beschreibend zu betiteln, um den Knoten oder die Organisation zu erinnern, die es darstellt (z.B. „yale“, „eaasi-open-source-sandbox“, etc.)

Warnung

Das Feld „Endpoint Name“ validiert automatisch die Eingabe bestimmter Benming-Konventionen - insbesondere Whitespaces, bestimmte Sonderzeichen/Symbole (wie „*“) oder Großbuchstaben.

Diese Benming-Konvention ist notwendig, um Fehler in der Speicherpfad-Validierung während der Umweltreplikation zwischen Knoten zu verhindern. Wenn Sie eine „Name ist ungültig“ Nachricht von der Schnittstelle erhalten, versuchen Sie bitte, Leerzeichen, Großbuchstaben und/oder spezielle Symbole zu entfernen, bevor Sie das EaaSI-Team kontaktieren.

Um die verfügbaren Metadaten/Umgebungen anderer Knoten zu holen, klicken Sie einfach auf die Schaltfläche „Synchronisieren“ neben dem ausgewählten Knotenendpunkt. Die verfügbaren „Public“-Umgebungen auf der Explore Resources-Seite sollten entsprechend aktualisiert werden.

Aufgaben ausführen

Die Registerkarte Running Tasks erlaubt Admins, die Aktivität auf dem Knoten zu überwachen, einschließlich aktuell laufender Umgebungssitzungen, Replikationsanfragen, Uploads oder Importe, etc. Diese hochrangigen Informationen sollen Admins helfen, den Knoten besser zu beheben (d.h. bestätigen, dass Uploads abgeschlossen sind, dass Umgebungen ordnungsgemäß geschlossen wurden, etc.)

../_images/running_tasks.png

Keine Vorlieben

Unter Node Preferences können Admin-Nutzer das lokale Tastaturlayout und die Sprache für ihren Knoten festlegen. Dies ist notwendig, um die Benutzereingabe (Keyboard-Pressen) auf eine laufende Umgebung abzubilden.

Die EaaSI UI selbst ist derzeit nur in Englisch (US) verfügbar.

Installieren und Updates

Verwenden Sie dieses Menü, EaaSI Admins kann zwei Wartungsaufgaben ausführen, die nach einer neuen Aktualisierung oder Freigabe der EaaSI-Plattform erforderlich sein können.

„Synchronize Backend“ wird die API-Verbindung zwischen den Frontend- und Backend-Komponenten von EaaSI aktualisieren (nach einem Update auf die EaaSI UI)

„Alte DB-Daten migrieren“ konvertiert bestehende Ressourcenmetadaten nach Änderungen in der Datenbank des Knotens. (ersucht, nur auf Anfrage durch das EaaSI dev-Team durchzuführen; Metadatenmigrationen werden nur nach wichtigen Aktualisierungen der Frontend- und Backend-Infrastruktur erforderlich)

Fehlerbehebung

Für den Fall, dass EaaSI-Nutzer Fehler oder unerwartetes Verhalten begegnen, können Admin-Nutzer dieses Menü verwenden, um Server- und Web-API-Logs herunterzuladen. Diese Protokolle können die lokale IT oder das EaaSI-Unterstützungsteam beraten. Bitte befestigen Sie diese Protokolle, wenn möglich:ref:bugs.

Node Benutzerverwaltung

Benutzer verwalten

Eaaa SI-Nutzer müssen jetzt manuell von einem Knoten Admin hinzugefügt werden, bevor sie :ref:`log in <logging_in>‘ zu einem Knoten. Die Seite Benutzer verwalten listet alle Individuen auf, die auf dem Knoten vorhanden sind, einschließlich ihres gegebenen Benutzernamens und ihrer Rolle / Leistung Ebene.

../_images/node_users.png

Durch das Klicken auf die Seite Details des Benutzers wird ein Admin die Möglichkeit ermöglicht, auch die E-Mail-Adresse des Benutzers zu bearbeiten (verwendet für die Authentisierung des Logins), dessen Benutzername und vollständige Namensinformationen sowie deren Rollen-/Permissionsebene:

../_images/edit_user.png

Neue Benutzer

Um einen neuen Benutzer zu einem Knoten hinzuzufügen, kann ein Admin auf die Schaltfläche „Neuen Benutzer erstellen“ klicken, um die E-Mail, den Namen und die Benutzerrolle des neuen Benutzers einzustellen.

Alle Felder im Menü Neue Benutzer erstellen sind erforderlich.

../_images/create_new_user.png

** Das temporäre Einmal-Passwort des Benutzers wird dem Admin in einer Benachrichtigung für ca. 15-20 Sekunden* angezeigt. Das Admin muss das Passwort sofort kopieren und speichern und dem Benutzer zur Verfügung stellen, zum Beispiel:

../_images/new_user_temp_password.png

Alle neuen Benutzer werden beim ersten Login aufgefordert, ihr Passwort von den angegebenen Anmeldeinformationen auf ein neues Passwort der Wahl des Benutzers zu ändern. Siehe Einloggen.

Passwort zurücksetzen

Wenn ein Benutzer (von jedem Level) forgets oder sonst verliert sein Passwort, müssen sie einen Admin-Level-Benutzer in ihrem Knoten fragen, um sein Passwort zurückzusetzen. Admin-Nutzer können dies auf der Seite Benutzer verwalten ihre Knoten-Einstellungen (Manage Node -> Benutzer verwalten -> Wählen Sie Details des jeweiligen Benutzers aus:

../_images/reset_password.png

Sobald die Admin bestätigt, dass sie das Passwort des Benutzers zurücksetzen möchten, ** das neue temporäre Passwort des Benutzers wird dem Admin in einer Benachrichtigung für ca. 15-20 Sekunden angezeigt*. Das Admin muss das Passwort sofort kopieren und speichern und dem Benutzer zur Verfügung stellen, zum Beispiel:

../_images/password_notification.png

Sobald der Admin dem Benutzer das temporäre Passwort zur Verfügung gestellt hat, kann sich der betreffende Benutzer erneut anmelden. Sie werden aufgefordert, das temporäre Passwort sofort wieder auf ein Passwort ihrer Wahl zu ändern/ einzustellen.

Genehmigungsstufen

Benutzer unterer Ebene („Konfiguration“) können durch den EaaSI-Client eingeschränkt werden, indem bestimmte in diesem Handbuch beschriebene Aktionen durchgeführt werden. Zusammenfassung:

Admin*-Level-Benutzer können:
  • Speichern Sie öffentliche Umgebungen (veröffentlicht von anderen Knoten/Quellen im EaaSI-Netzwerk) in den Speicher des lokalen Knotens

  • Fügen Sie neue Benutzer zum lokalen Knoten hinzu und ändern Sie ihre Berechtigungsstufe (z.B. fördern Sie einen Konfigurationsbenutzer zu einem Admin)

  • Veröffentlichen Sie Umgebungen und Software-Ressourcen, die ihrem Knoten zum breiteren EaSI-Netzwerk lokal sind

  • Zugriff auf administrative Funktionen, wie OAI-PMH-Einstellungen, Emulator-Management, etc.

  • Alle Funktionen und Aktionen zur Konfiguration von Benutzern

Konfiguration-Level-Benutzer können:
  • neue lokale Software- und Content-Ressourcen in ihren lokalen Knoten importieren

  • führen und erstellen Sie neue Umweltressourcen mithilfe von Umgebungen, die lokal von einem Admin in ihrem lokalen Knoten gespeichert wurden

  • neue Umweltressourcen mithilfe öffentlicher Software-Ressourcen oder ihrer privaten Software- und Content-Ressourcen betreiben und erstellen

  • Download-Server-Logs hilfreich für Fehlersuche und Fehlermeldungen

  • aktuell laufende Aufgaben in ihrem lokalen Knoten anzeigen (evtl. auch nützlich für die Einreichung von Fehlerberichten)

  • Ihre grundlegenden Benutzerkontoeinstellungen (E-Mail und Passwort) ändern