Allgemeiner Hinweis

In diesem Abschnitt finden Sie Schritt-für-Schritt-Anleitungen zur Nutzung der Software "Stata", wenn sie in zentral bereitgestellter Form (per "ASP" genutzt wird). Weitere Informationen zu Stata und über verschiedene Bereistellungswege finden Sie im Unterpunkt "Stata" unter "Anwendungen / Software".

1. ! Grundlegende Voraussetzung ist, dass Sie Zugang zum bwUniCluster haben!
   Siehe: "Schritte zur Nutzung des bwHPC"
2. VcXsrv starten (oder einen anderen X-Server) als Voraussetzungen für den GUI-Betrieb
3. PuTTY starten und folgende Optionen wählen:
   • Session:
     • Hostname: <UserID>@bwunicluster.scc.kit.edu oder <UserID>@uc1.scc.kit.edu
       ^{Mit <UserID> = Ihre UserID nach Entitlement und erfolgreicher Registrierung (siehe Schritte zur Nutzung des bwHPC) hierbei ist zwingend der Präfix tu_ erforderlich bspw. tu_wwnxx01}
     • SSH-Verbindung (Port 22)
   • Connection > SSH > X11:
     • Enable X11 Forwarding: ja
     • Display: [blank]
   • Nach dem Vornehmen der Einstellungen per Klick auf "Open" die Verbindung öffnen. Sie werden dann nach Ihrem "dienstspezifischen Passwort" gefragt. Nach Eingabe des richtigen Passworts landen Sie im PuTTY-Terminal-/Konsolen-Fenster auf einem der Login-Knoten des bwUniClusters.
     ^{[Hinweis: das "dienstspezifische Passwort" haben Sie bei der Registrierung für den bwUniCluster festgelegt. Siehe Schritte zur Nutzung der Infrastruktur des bwHPC]}
   • Hinweise:
     • _{Wenn die Display-Nr ihres X-Servers nicht "0" ist (=Default), dann müssen Sie im Feld "X Display Location" die entsprechende Nummer eingeben. Zur Notation siehe Hinweise zur Konfiguration von PuTTY für X11-Forwarding und X-Windows-Betrieb.}
     • _{Wenn Sie sich nicht sicher sind, unter welcher Display-Nr ihr X-Server erreichbar ist, fahren Sie mit der Maus (ohne zu Klicken) über das "X"-Icon in der Taskleiste und warten Sie, bis der gelblich hinterlegte "Tooltip" erscheint. Hinter dem Rechnernamen des X-Servers und einem Doppelpunkt erscheint Ihre Display-Nummer.}
       
     • _{Wenn Sie wissen wollen, wie Sie die Display-Nr Ihres X-Servers herausfinden oder festlegen können, lesen Sie weiter unter VcXsrv.}
4. Workspace-Verzeichnis anlegen (das ist zwar technisch nicht zwingend notwendig, sollten Sie sich aber zur Gewohnheit machen):
   • In der PuTTY-Konsole eingeben: ws_allocate <frei gewählter Name> 30
     ^{[Beispiel: "ws_allocate Testlauf 30". Dies legt ein Workspace-Verzeichnis an, das 30 Tage bestehen bleiben wird.]}
   • Lassen Sie sich jetzt den Pfad Ihres gerade angelegten Workspace-Verzeichnisses anzeigen. Am einfachsten geht dies durch die Eingabe von "ws_list" in der PuTTY-Konsole: dies liefert Ihnen eine Übersicht aller gerade vorhandenen Workspace-Verzeichnisse incl. der Pfade
     ^{[Beispiel für den Pfad eines Workspace-Verzeichnisses: /work/workspace/scratch/tu_wwwxx01-Testlauf-0]}
5. WinSCP starten und Daten in Ihr Workspace-Verzeichnis kopieren (sofern Daten benötigt werden):
   • Lesen Sie auf unserer Seite zu WinSCP nach, wenn Sie allgemeine Hilfe zum Start und zur Nutzung von WinSCP benötigen!
   • Wählen Sie in WinSCP die Funktion "Verzeichnis öffnen" und geben Sie den im vorherigen Punkt ermittelten Pfad ein
     ^{[Im Beispiel: /work/workspace/scratch/tu_wwwxx01-Testlauf-0
     /work/workspace ist dabei eine Verknüpfung, die auf den konkreten Speicherplatz zeigt, beispielsweise /pfs/work2/workspace. Welche Pfadangabe Sie verwenden, ist letztlich egal.]}
   • Kopieren Sie ggf. Ihr Stata-do-File in das Workspace-Verzeichnis
6. Ressourcen bei Moab anfordern
   • Beispiele _{[jeweils erstes -I = großes "i" für Interactive, zweites -l = kleines "L"]}:
     • msub -I -V -q develop
       ^{[fordert eine interaktive Session an, die defaultmässig 10 Minuten aktiv bleibt]}
     • msub -I -V -q singlenode -l walltime=8:00:00
       ^{[läuft auf einem Knoten und ändert die max. Rechenzeit auf 30 min]}
     • msub -I -V -q fat -l pmem=32000mb
       ^{[fordert eine Session auf einem "Fat"-Knoten mit 32GB Speicher an]}
     • _{Hinweis: Weitere Informationen zu vordefinierten Queues sowie den maximal anforderbaren Ressourcen erhalten Sie im Wiki zum bwUniCluster.}
       
       
   • Warten, bis Anfrage / Job bestätigt bzw. Ressourcen zugewiesen wurden:
     • Meldung "salloc: Granted job allocation"
     • Überprüfung mit "showq"
       
       
7. Stata laden und starten:
   • "module load math/stata" (lädt aktuelle/default-Version des Stata-Moduls)
   • Stata in einer der drei "Flavours"/Versionen starten durch Eingabe von: "xstata" oder "xstata-se" oder "xstata-mp"

1. ! Grundlegende Voraussetzung ist, dass Sie Zugang zum bwUniCluster haben!
   Siehe: "Schritte zur Nutzung des bwHPC"
2. PuTTY starten und folgende Optionen wählen:
   • Session:
     • Hostname: <UserID>@bwunicluster.scc.kit.edu oder <UserID>@uc1.scc.kit.edu
       ^{Mit <UserID> = Ihre UserID nach Entitlement und erfolgreicher Registrierung (siehe Schritte zur Nutzung der Infrastruktur des bwHPC)}
     • SSH-Verbindung (Port 22)
   • Nach dem Vornehmen der Einstellungen per Klick auf "Open" die Verbindung öffnen. Sie werden dann nach Ihrem "dienstspezifischen Passwort" gefragt. Nach Eingabe des richtigen Passworts landen Sie im PuTTY-Terminal-/Konsolen-Fenster auf einem der Login-Knoten des bwUniClusters.
     ^{[Hinweis: das "dienstspezifische Passwort" haben Sie bei der Registrierung für den bwUniCluster festgelegt. Siehe Schritte zur Nutzung der Infrastruktur des bwHPC]}
3. Workspace-Verzeichnis anlegen:
   • In der PuTTY-Konsole eingeben: ws_allocate <frei gewählter Name> 30
     ^{[Beispiel: "ws_allocate Testlauf 30". Dies legt ein Workspace-Verzeichnis an, das 30 Tage bestehen bleiben wird.]}
   • Lassen Sie sich jetzt den Pfad Ihres gerade angelegten Workspace-Verzeichnisses anzeigen. Am einfachsten geht dies durch die Eingabe von "ws_list" in der PuTTY-Konsole: dies liefert Ihnen eine Übersicht aller gerade vorhandenen Workspace-Verzeichnisse incl. der Pfade
     ^{[Beispiel für den Pfad eines Workspace-Verzeichnisses: /work/workspace/scratch/tu_wwwxx01-Testlauf-0]}
4. WinSCP starten und Daten in Ihr Workspace-Verzeichnis kopieren:
   • Lesen Sie auf unserer Seite zu WinSCP nach, wenn Sie allgemeine Hilfe zum Start und zur Nutzung von WinSCP benötigen!
   • Wählen Sie in WinSCP die Funktion "Verzeichnis öffnen" und geben Sie den im vorherigen Punkt ermittelten Pfad ein
     ^{[Im Beispiel: /work/workspace/scratch/tu_wwwxx01-Testlauf-0
     /work/workspace ist dabei eine Verknüpfung, die auf den konkreten Speicherplatz zeigt, beispielsweise /pfs/work2/workspace. Welche Pfadangabe Sie verwenden, ist letztlich egal.]}
   • Kopieren Sie Ihr Stata-do-File in das Workspace-Verzeichnis
   • Kopieren Sie Ihr Moab-Skript, das Sie nach Ihren Anforderungen angepasst haben, in das Verzeichnis.
     ^{[Ein Beispielskript haben wir für Sie zum Download bereitgestellt. Hinweise zur Anpassung finden Sie unter "Ressource Management".]}
5. Moab-Skript starten:
   • In der PuTTY-Konsole per "cd <Pfad Ihres Workspace-Verzeichnisses>" ins Workspace-Verzeichnis wechseln, in dem jetzt Ihr Stata do-File und Ihr Moab-Skript liegen müssten
   • In der PuTTY-Konsole eingeben: "msub Ihr_Skriptname.moab"
   • Warten, bis für Ihre Anfrage eine Job-ID zugewiesen wurde:
     • In der Konsole erscheint eine 7-stellige Job-ID
     • Überprüfung mit "showq"
6. Im Arbeitsverzeichnis erscheinen nach dem Start Ihres Jos (der nicht unbedingt sofort erfolgt, sondern erst zum zugeteilten Zeitpunkt) folgende Dateien:
   • <Job-ID>.out, in die das Moab-Skript seine Ausgaben schreibt
   • <Statadofilename>.log, in die Stata seine Ausgaben schreibt
   
   Außerdem sollten Sie, sofern Sie die entsprechende Option in unserem Moab-Beispiel-Skript nicht deaktiviert haben, beim Start, Ende und ggf. Abbruch des Skripts eine Mail an die im Skript angegebene Emailadresse erhalten!

Antwort: Ja.

Antwort: Die Nutzungsbedingungen des bwUniClusters sehen vor, dass 14 Tage nach der Erstanmeldung ein Fragebogen beantwortet werden muss.

Antwort: Beim Start verlangt Stata nach einer gültigen Lizenzdatei, die es im Fall dieser Fehlermeldung offensichtlich nicht findet. Das könnte folgende Gründe haben:

• Sie haben versucht, eine Stata-Version zu laden (z.B. Version 12 mit dem Befehl "module load math/stata/12"), für die aktuell keine Lizenzdatei vorhanden ist.
  => Bitte informieren Sie sich in diesem Fall auf unserer Webseite nach der aktuell verfügbaren Version.
  => Sie können sich mit dem Befehl "module avail" die auf dem Cluster verfügbaren Module, auf die Sie Zugriff haben, anzeigen lassen.
• Vielleicht haben Sie auch keine Berechtigung zur Nutzung von Stata und damit auch keinen Zugriff auf die Lizenzdatei.
  => Sie können sich mit dem Befehl "module avail" die auf dem Cluster verfügbaren Module, auf die Sie Zugriff haben, anzeigen lassen.