lamexec - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

lamexec – Ausführen von Nicht-MPI-Programmen auf LAM-Knoten.

ZUSAMMENFASSUNG

lamexec [-fhvD] [-c # | -np #] [-nw | -w] [-pty] [-s Knoten] [-x
VAR1[=WERT1][,VAR2[=WERT2],...]] [wo] Programm [-- Argumente]

OPTIONAL

-c # Synonym für -np (siehe unten).

-D Verwenden Sie den Speicherort des ausführbaren Programms als aktuelles Arbeitsverzeichnis für erstellte
Prozesse. Das aktuelle Arbeitsverzeichnis der erstellten Prozesse wird gesetzt
bevor das Programm des Benutzers aufgerufen wird.

-f Konfigurieren Sie keine Standard-E/A-Dateideskriptoren – verwenden Sie Standardwerte.

-h Drucken Sie nützliche Informationen zu diesem Befehl.

-np # (siehe unten). Führen Sie so viele Kopien des Programms auf den angegebenen Knoten aus. Dies
Option gibt an, dass es sich bei der angegebenen Datei um ein ausführbares Programm und nicht um ein
Anwendungsschema. Wenn keine Knoten angegeben sind, werden alle LAM-Knoten berücksichtigt für
Terminplanung; LAM wird die Programme nach einem Round-Robin-Verfahren planen, "wrapping"
herum" (und bei Bedarf mehrere Kopien auf einem einzelnen Knoten planen).

-nw Warten Sie mit dem Beenden nicht, bis alle Prozesse abgeschlossen sind lamexec. Diese Option
schließt sich gegenseitig aus mit -w.

-pty Aktivieren Sie die Pseudo-TTY-Unterstützung. Dies ermöglichte unter anderem zeilengepufferte
Ausgabe (was wahrscheinlich das ist, was Sie wollen). Der einzige Grund für diese Funktion ist
nicht standardmäßig aktiviert ist, weil es so neu ist und nicht ausgiebig getestet wurde
noch getestet.

-s Knoten Laden Sie das Programm von diesem Knoten. Diese Option ist in der Befehlszeile nicht gültig
wenn ein Anwendungsschema angegeben ist.

-v Seien Sie ausführlich; berichten über wichtige Schritte, wie sie durchgeführt werden.

-w Warten Sie, bis alle Anwendungen beendet sind, bevor Sie lamexec Ausgänge.

-x Exportieren Sie die angegebenen Umgebungsvariablen vor der Ausführung in die Remote-Knoten
das Programm. Vorhandene Umgebungsvariablen können angegeben werden (siehe Beispiele
Abschnitt unten) oder neue Variablennamen mit entsprechenden Werten angegeben. Die
Parser für die -x Option ist nicht sehr anspruchsvoll; es versteht nicht einmal
zitierte Werte. Benutzern wird empfohlen, Variablen in der Umgebung festzulegen, und dann
- -x um sie zu exportieren (nicht zu definieren).

woher Eine Reihe von Knoten- und/oder CPU-Kennungen, die angeben, wo begonnen werden soll

-- args Übergeben Sie diese Laufzeitargumente an jeden neuen Prozess. Das muss immer das letzte sein
Argument zwei lamexec. Diese Option ist in der Befehlszeile nicht gültig, wenn ein
Anwendungsschema angegeben ist.

BESCHREIBUNG

lamexec ist im Wesentlichen ein Klon des mpirun(1), ist aber für Nicht-MPI-Programme gedacht.

Ein Aufruf von lamexec startet eine Nicht-MPI-Anwendung, die unter LAM ausgeführt wird. Um das zu starten
gleiches Programm auf allen LAM-Knoten, die Anwendung kann auf dem lamexec Befehl
Leitung. Um mehrere Anwendungen auf den LAM-Knoten zu starten, ist ein Anwendungsschema erforderlich
in einer separaten Datei. Sehen Anwendungsschema(5) für eine Beschreibung der Anwendungsschemasyntax,
aber es enthält im Wesentlichen mehrere lamexec Befehlszeilen, abzüglich des Befehlsnamens selbst.
Die Möglichkeit, verschiedene Optionen für verschiedene Instanziierungen eines Programms anzugeben, ist
ein weiterer Grund, ein Anwendungsschema zu verwenden.

Ort Nomenklatur
Die Ortsnomenklatur, die für die Erwähnung der Where-Klausel in der SYNOPSIS verwendet wird
Abschnitt oben ist identisch mit mpirun(1) Nomenklatur. Siehe die mpirun(1) Handbuchseite für
eine lange Diskussion der Standortnomenklatur.

Beachten Sie, dass die Syntax nach CPU zwar gültig ist für lamexec, ist nicht ganz so aussagekräftig, weil
Die Rangordnung der Prozesse in MPI_COMM_WORLD ist irrelevant. Als solches ist die Nebenknoten-Nomenklatur
ist normalerweise die bevorzugte Syntax für lamexec.

Anwendung Schema or Ausführbar Programm?
Um die beiden unterschiedlichen Formen zu unterscheiden, lamexec sucht in der Kommandozeile nach Knoten oder dem
-c Möglichkeit. Wenn keines angegeben ist, wird angenommen, dass die in der Befehlszeile angegebene Datei
ein Anwendungsschema sein. Wenn entweder eine oder beide angegeben sind, wird die Datei angenommen
ein ausführbares Programm sein. Wenn Knoten und -c beide sind angegeben, dann Kopien der
Programm werden auf den angegebenen Knoten gemäß einer internen LAM-Planungsrichtlinie gestartet.
Die Angabe nur eines Knotens zwingt LAM effektiv dazu, alle Kopien des Programms in einem auszuführen
Platz. Wenn -c gegeben ist, aber keine Knoten, dann werden alle LAM-Knoten verwendet. Wenn Knoten angegeben ist,
aber nicht -c, dann wird auf jedem Knoten eine Kopie des Programms ausgeführt.

Programm Art des
LAM sucht standardmäßig nach ausführbaren Programmen auf dem Zielknoten, auf dem ein bestimmtes
Instanziierung wird ausgeführt. Wenn das Dateisystem nicht geteilt wird, sind die Zielknoten
homogen ist und das Programm häufig neu kompiliert wird, kann es praktisch sein, LAM
Übertragen Sie das Programm von einem Quellknoten (normalerweise dem lokalen Knoten) auf jeden Zielknoten. Die
-s Option spezifiziert dieses Verhalten und identifiziert den einzelnen Quellenknoten.

Lokalisierung Mappen
LAM sucht nach einem ausführbaren Programm, indem es die Verzeichnisse im PATH des Benutzers durchsucht
Umgebungsvariable wie auf dem/den Quellknoten(n) definiert. Dieses Verhalten steht im Einklang mit
Einloggen in den Quellknoten und Ausführen des Programms von der Shell aus. Auf entfernten Knoten,
das "." Pfad ist das Home-Verzeichnis.

LAM sucht in drei Verzeichnissen nach einem Anwendungsschema: dem lokalen Verzeichnis, dem Wert
der Umgebungsvariablen LAMAPPLDIR und laminstalldir/boot, wobei "laminstalldir" ist
das Verzeichnis, in dem LAM/MPI installiert wurde.

Normen I / O
LAM leitet UNIX-Standardeingaben auf allen entfernten Knoten an /dev/null. Auf dem lokalen Knoten, der
aufgerufen lamexec, Standardeingabe wird geerbt von lamexec. Der Standard ist, was früher war
die Option -w, um einen widersprüchlichen Zugriff auf das Terminal zu verhindern.

LAM leitet UNIX-Standardausgaben und -Fehler an den LAM-Daemon auf allen entfernten Knoten. LAM
sendet alle erfassten Ausgaben/Fehler an den Knoten, der aufgerufen wurde lamexec und druckt es auf die
Standardausgabe/Fehler von lamexec. Lokale Prozesse erben die Standardausgabe/Fehler von
lamexec und direkt dorthin überweisen.

Somit ist es möglich, Standard-I/O für LAM-Anwendungen umzuleiten, indem die typischen
Shell-Umleitungsverfahren an lamexec.

% lamexec N my_app my_input my_output

Das -f Option vermeidet die gesamte Einrichtung, die zur Unterstützung der oben beschriebenen Standard-E/A erforderlich ist.
Entfernte Prozesse werden vollständig an /dev/null geleitet und lokale Prozesse erben die Datei
Beschreibungen von Lamm(1).

Pseudo-tty Support
Das -pty Option aktivierte Pseudo-TTY-Unterstützung für die Prozessausgabe. Dies ermöglicht unter anderem
Dinge, für zeilengepufferte Ausgaben von entfernten Knoten (was wahrscheinlich das ist, was Sie wollen).

Diese Option ist derzeit nicht die Standardeinstellung für lamexec weil es nicht gründlich war
auf verschiedenen Unixen getestet. Benutzer werden ermutigt, zu verwenden -pty und melden Sie alle
Probleme zurück an das LAM-Team.

Strom Arbeiten Verzeichnis
Das aktuelle Arbeitsverzeichnis für neue Prozesse, die auf dem lokalen Knoten erstellt wurden, wird vererbt
für lamexec. Das aktuelle Arbeitsverzeichnis für neue Prozesse, die auf Remote-Knoten erstellt werden, ist
das Home-Verzeichnis des Remote-Benutzers. Dieses Standardverhalten wird durch die -D .

Das -D Option ändert das aktuelle Arbeitsverzeichnis neuer Prozesse in das Verzeichnis
wo sich die ausführbare Datei befindet, bevor das Programm des neuen Benutzers aufgerufen wird.

Eine Alternative zum -D Option ist die -wd . -wd ermöglicht dem Benutzer die Angabe eines
beliebiges aktuelles Arbeitsverzeichnis (im Vergleich zum Speicherort der ausführbaren Datei). Notiere dass der
-wd Option kann in Anwendungsschemadateien verwendet werden (siehe Anwendungsschema(5)) auch.

Prozess Arbeitsumfeld
Prozesse in der Anwendung erben ihre Umgebung vom LAM-Daemon auf dem Knoten
auf denen sie laufen. Die Umgebung eines LAM-Daemons wird beim Booten des
LAM mit Lamm(1) und wird von der Shell des Benutzers geerbt. Auf dem Ursprungsknoten wird dies
sei die Schale, aus der Lamm(1) wurde aufgerufen und auf entfernten Knoten ist dies die Shell
begonnen von rsh(1). Beim Ausführen von dynamisch verknüpften Anwendungen, die die
Umgebungsvariable LD_LIBRARY_PATH gesetzt werden, muss darauf geachtet werden, dass dies
beim Booten des LAM richtig eingestellt.

Exportiert Arbeitsumfeld Variablen
Das -x Option zu lamexec kann verwendet werden, um bestimmte Umgebungsvariablen in das neue zu exportieren
Prozesse. Während die Syntax des -x Option ermöglicht die Definition neuer Variablen, Hinweis
dass der Parser für diese Option derzeit nicht sehr ausgereift ist - er tut es nicht einmal
zitierte Werte verstehen. Benutzern wird empfohlen, Variablen in der Umgebung festzulegen und zu verwenden
-x sie zu exportieren; sie nicht zu definieren.

Beispiele:

lamexec N prog1
Laden und führen Sie prog1 auf allen Knoten aus. Suchen Sie auf jedem Knoten nach der ausführbaren Datei.

lamexec -c 8 prog1
Führen Sie 8 Kopien von prog1 aus, wo immer LAM sie ausführen möchte.

lamexec n8-10 -v -nw -s n3 prog1 -- -q
Laden und führen Sie prog1 auf den Knoten 8, 9 und 10 aus. Suchen Sie nach prog1 auf Knoten 3 und übertragen Sie
es zu den drei Zielknoten. Berichten Sie, wenn jeder Prozess erstellt wird. Geben Sie "-q" als a . ein
Befehlszeile für jeden neuen Prozess. Warten Sie nicht, bis die Prozesse abgeschlossen sind, bevor Sie
Verlassen lamexec.

lamexec -v meineapp
Analysieren Sie das Anwendungsschema myapp und starten Sie alle darin angegebenen Prozesse. Prüfbericht
wie jeder Prozess erstellt wird.

lamexec NN -pty -wd /workstuff/output -x ANZEIGE run_app.csh
Führen Sie die Anwendung "run_app.csh" (angenommen ein C-Shell-Skript) zweimal auf jedem Knoten in . aus
das System (ideal für 2-Wege-SMPs). Aktivieren Sie auch die Pseudo-Tty-Unterstützung, ändern Sie das Verzeichnis
nach /workstuff/output und exportieren Sie die DISPLAY-Variable in die neuen Prozesse (vielleicht
das Shell-Skript ruft eine X-Anwendung wie xv auf, um die Ausgabe anzuzeigen).

lamexec -np 5 -D `pwd`/my_application
Eine gängige Verwendung von lamexec in Umgebungen, in denen ein Dateisystem von allen geteilt wird
Knoten im Multicomputer, mit dem Shell-escaped "pwd"-Befehl spezifiziert die vollständige
Name der ausführbaren Datei, die ausgeführt werden soll. Dies verhindert die Notwendigkeit, das Verzeichnis in
der Weg; die Remote-Notizen haben einen absoluten Dateinamen zum Ausführen (und Ändern)
Verzeichnis darauf beim Aufruf).

DIAGNOSE

lamexec: Exec-Formatfehler
Im Anwendungsschema wurde ein Nicht-ASCII-Zeichen erkannt. Dies ist normalerweise ein
Fehler bei der Befehlszeilenverwendung, bei dem lamexec erwartet ein Anwendungsschema und ein
ausführbare Datei gegeben wurde.

lamexec: Syntaxfehler im Anwendungsschema, Zeile XXX
Das Anwendungsschema kann aufgrund eines Verwendungs- oder Syntaxfehlers auf der Seite nicht geparst werden
gegebene Zeile in der Datei.

Dateiname: Keine solche Datei oder kein Verzeichnis
Dieser Fehler kann in zwei Fällen auftreten. Entweder kann die benannte Datei nicht gefunden werden oder sie hat
gefunden wurde, aber der Benutzer nicht über ausreichende Berechtigungen zum Ausführen des Programms verfügt oder
Lesen Sie das Anwendungsschema.

RÜCKKEHR BEWERTUNG

lamexec gibt 0 zurück, wenn alle Prozesse gestartet wurden von lamexec normal verlassen. Ein Wert ungleich Null ist
zurückgegeben, wenn ein interner Fehler in lamexec aufgetreten ist oder ein oder mehrere Prozesse beendet wurden
abnormal. Wenn in lamexec ein interner Fehler aufgetreten ist, lautet der entsprechende Fehlercode
ist zurückgekommen. Für den Fall, dass ein oder mehrere Prozesse mit einem Exit-Code ungleich Null beendet werden,
Rückgabewert des Prozesses, der lamexec erste Benachrichtigungen, die anormal gestorben sind, werden zurückgeschickt.
Beachten Sie, dass dies im Allgemeinen der erste Prozess ist, der gestorben ist, aber nicht garantiert wird
sei so.

Beachten Sie jedoch, dass, wenn die -nw switch verwendet wird, der Rückgabewert von lamexec nicht
geben den Exit-Status der von ihm gestarteten Prozesse an.

Verwenden Sie lamexec online mit den onworks.net-Diensten