Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Kopiert OPC-Pakete aus einem Windows Azure-Speicherkonto und entpackt sie auf einem Windows Azure-Knoten.
Hinweis
Dieser Befehl wurde in HPC Pack 2008 R2 mit Service Pack 1 eingeführt und wird in früheren Versionen nicht unterstützt.
Syntax
hpcsync [<storageAccountName> <storageKey>] [<packageRoot>] [/packageName:<packageNameFilter>]
[/container:<Container name>] [/blocksize:<blockSize>] [/usehttp]
hpcsync {/? | /help}
Parameter
In einigen Fällen kann ein Clusteradministrator clusrun hpcsync ausführen, ohne Parameter für den Befehl hpcsync anzugeben.
| Parameter | Beschreibung |
|---|---|
| <storageAccountName-> | Gibt den öffentlichen Namen des Windows Azure-Speicherkontos an (derselbe Speichername, den Sie in der Windows Azure-Knotenvorlage angeben). Dies ist der Wert von <storageAccountName> in der öffentlichen URL des Kontos: https://<storageAccountName>.blob.core.windows.net. Wenn Sie <storageAccountName>angeben, müssen Sie auch <storageKey>Hinweis angeben: Wenn ein Clusteradministrator den Befehl clusrun hpcsyncausführt, müssen der Name und der Schlüssel des Speicherkontos nicht angegeben werden. Die Werte werden von der CCP_AZURE_CONNECTIONSTRING Umgebungsvariable bereitgestellt (die nur für clusrun Aufträge auf Prozessebene festgelegt ist). Wenn ein Clusteradministrator hpcsync- ohne clusrunausführt oder wenn ein Clusterbenutzer hpcsync-ausführt, müssen die Speicherkontoinformationen in den Befehlsparametern bereitgestellt werden. |
| <storageKey-> | Gibt den Zugriffsschlüssel für das Windows Azure-Speicherkonto an. Wenn Sie <storageKey->angeben, müssen Sie auch <storageAccountName->angeben. Hinweis: Wenn ein Clusteradministrator den Befehl clusrun hpcsyncausführt, müssen der Name und der Schlüssel des Speicherkontos nicht angegeben werden. Die Werte werden von der CCP_AZURE_CONNECTIONSTRING Umgebungsvariable bereitgestellt (die nur für Clusrun-Aufträge auf Prozessebene festgelegt wird). Wenn ein Clusteradministrator hpcsync- ohne clusrunausführt oder wenn ein Clusterbenutzer hpcsync-ausführt, müssen die Speicherkontoinformationen in den Befehlsparametern bereitgestellt werden. |
| <packageRoot-> | Gibt das Zielstammverzeichnis für die Bereitstellung der Pakete an. Der Standardwert, wenn ein Clusteradministrator den Befehl ausführt, ist %CCP_PACKAGE_ROOT%. Der Standardwert für einen Clusterbenutzer ist sein Benutzerverzeichnis, %USERPROFILE%\Packages. Damit SOA-Dienste und XLLs ordnungsgemäß funktionieren, sollte das Stammverzeichnis der Standardwert (%CCP_PACKAGE_ROOT% oder %USERPROFILE%\Packages) sein. Die %CCP_PACKAGE_ROOT% Umgebungsvariable verweist auf einen Speicherort, der von Windows Azure verwaltet wird. HPC Pack verwendet die Windows Azure-APIs, um einen Wert für diese Variable festzulegen, nachdem die Windows Azure-Knoten bereitgestellt wurden. Der Wert von %CCP_PACKAGE_ROOT% ist innerhalb einer Windows Azure-Bereitstellung konsistent, kann jedoch zwischen Bereitstellungen variieren. Hinweis: Beim Hochladen eines Pakets in ein Speicherkonto (mithilfe hpcpack upload) können Sie das relative Pfad-Attribut definieren. Wenn das Paket einen relativen Pfad angibt, wird das Paket für <packageRoot->\<relativePath-> bereitgestellt, z. B. %CCP_PACKAGE_ROOT%\myDir. |
| /packageName | Gibt das Paket an, das Sie herunterladen möchten. Wenn Sie diesen Parameter nicht angeben, werden alle OPC-Pakete heruntergeladen. |
| /Container | Gibt den Namen des Containers im Windows Azure-Speicherkonto an, aus dem Sie die Datei herunterladen möchten. Wenn Sie diesen Parameter nicht angeben, werden Pakete vom Standardspeicherort heruntergeladen: ein Container mit dem Namen hpcpackages im Speicherkonto. |
| /blocksize | Gibt die Größe des Blocks in Bytes an, in die die Datei beim Herunterladen getrennt wird. Die Standardblockgröße beträgt 4 MB (4194304 Bytes). 4 MB ist auch die maximale Blockgröße. Möglicherweise möchten Sie eine kleinere Blockgröße angeben, wenn eine instabile Netzwerkverbindung auftritt. |
| /usehttp | Gibt an, dass Sie den standardmäßigen HTTPS-Kanal über Port 443 außer Kraft setzen möchten, und versuchen Sie die Kommunikation mit http über Port 80. Wenn dies fehlschlägt, wird sie auf Port 443 zurückgesetzt. Hinweis: Dieser Parameter wurde in HPC Pack 2008 R2 mit Service Pack 3 eingeführt und wird in früheren Versionen nicht unterstützt. |
| /? | Zeigt die Hilfe an der Eingabeaufforderung an. |
| /Hilfe | Zeigt die Hilfe an der Eingabeaufforderung an. |
Anmerkungen
hpcsync- ist in Windows Azure-Computeressourcen verfügbar, die einem lokalen Cluster zugeordnet sind, der mindestens Microsoft HPC Pack 2008 R2 mit SP1 oder Windows Azure Computeressourcen ausführt, die Teil einer Windows Azure HPC Scheduler--Bereitstellung sind.
hpcsync- automatisch ausgeführt, wenn Sie Windows Azure-Knoten vom HPC Cluster Manager starten und automatisch ausgeführt werden, wenn eine der Knoteninstanzen als Teil der Windows Azure-Wartung neu bereitgestellt wird. Mit diesem Mechanismus wird sichergestellt, dass erforderliche Dateien beim Start auf den Knoten verfügbar sind oder ob die Knoteninstanzen neu bereitgestellt werden. Die automatische hpcsync- Aufrufe bei der Knotenbereitstellung werden ohne Parameter ausgeführt. Dies bedeutet, dass Pakete vom Standardspeicherort im Speicher an den Standardspeicherort auf den Knoten kopiert werden. Weitere Informationen finden Sie unter Nutzung von automatischen hpcsync-Aufrufen für die Anwendungsbereitstellung weiter unten in diesem Thema.
Da sie während des Bursts in Windows Azure-Bereitstellungen automatisch ausgeführt wird, müssen Sie nicht unbedingt hpcsync- direkt ausführen. Wenn Sie jedoch Pakete in den Speicher bereitstellen, nachdem die Windows Azure-Knoten bereits bereitgestellt wurden, oder wenn Sie Pakete in einer Windows Azure HPC Scheduler-Bereitstellung bereitstellen, können Sie hpcsync- mit clusrunmanuell ausführen. hpcsync stellt auch einige Parameter zum Kopieren von Paketen aus verschiedenen Speichercontainern und zum Bereitstellen der Pakete in alternativen Zielverzeichnissen bereit.
hpcsync- eignet sich ideal für die Bereitstellung von SOA-Diensten, XLL-Dateien und Startskripts aus Windows Azure Storage an ihren erwarteten Speicherorten auf Ihren Windows Azure-Knoten. Alternativ können Sie die befehle hpcpack (hpcpack upload und hpcpack download) verwenden, um andere Arten von Dateien, Anwendungen oder Auftragsdaten zwischen Windows Azure Storage und Ihren Windows Azure-Knoten zu verschieben. Weitere Informationen finden Sie unter hpcpack.
Um diesen Befehl verwenden zu können, müssen Clusterbenutzer den Namen des Speicherkontos und den primären Zugriffsschlüssel kennen.
Beispiele
Damit ein Clusteradministrator alle OPC-Dateien aus dem Standardcontainer in einem Windows Azure-Speicherkonto auf einer Reihe von Windows Azure-Workerknoten bereitstellt:
clusrun /nodegroup:AzureWorkerNodes hpcSync
Damit ein Clusterbenutzer alle OPC-Dateien aus einem bestimmten Container in einem Windows Azure-Speicherkonto (myContainer) in ihrem Standardverzeichnis auf einem Satz von Windows Azure-Knoten (Knoten 1-3) bereitstellen kann:
job submit /requestednodes:node1,node2,node3 hpcSync myAccount myKey /container:myContainer
Um die Problembehandlung bei der Dateibereitstellung zu erleichtern, können Sie den Befehl testen, indem Sie versuchen, die Dateien auf Ihrem lokalen Computer in C:\tempbereitzustellen:
hpcsync myAccount myKey C:\temp
Nutzen von automatischen hpcsync-Aufrufen für die Anwendungsbereitstellung
Um die automatischen hpcsync- Aufrufe während der Knotenbereitstellung zu nutzen, müssen Sie OPC-Pakete in den hpcpackages Container im Windows Azure-Speicherkonto bereitstellen, bevor Sie Ihre Knoten bereitstellen. Sie können die hpcpack- Befehle verwenden, um Dateien zu packen und dann in Windows Azure Storage hochzuladen. (Standardmäßig hpcpack upload Pakete in den hpcpackages Container platziert. Sie geben einen alternativen Container an, wenn die Pakete nicht automatisch auf allen Windows Azure-Knoten bereitgestellt werden sollen.)
Standardmäßig werden für Clusteradministratoren hpcsync Dateien an einem Speicherort auf den Windows Azure-Knoten bereitgestellt, die teilweise von der %CCP_PACKAGE_ROOT% Umgebungsvariable bestimmt werden. Diese Variable wird während des Bereitstellungsprozesses auf Windows Azure-Knoten festgelegt. Die extrahierten Dateien werden in einem Ordner platziert, der wie folgt bestimmt wird: %CCP_PACKAGE_ROOT%\<packageName>\<uploadTimeStamp>. Dies ist der erwartete Speicherort für SOA-Dienste, XLLs, Excel-Arbeitsmappen und Startskripts, die aus der Knotenvorlage aufgerufen werden. Dies ist jedoch nicht praktisch für Anwendungen, die Clusterbenutzer in ihren Befehlszeilen aufrufen.
Um die Ordnerstruktur für ausführbare Dateien zu vereinfachen, können Sie die relative Pfadeigenschaft für das Paket festlegen, wenn Sie es in den Speicher hochladen. hpcsync- wendet den relativen Pfad beim Extrahieren der Dateien an, sodass der Pfad wie folgt bestimmt wird: %CCP_PACKAGE_ROOT%\<relativePath->. Benutzer können dann den Pfad zu ihrer Anwendung angeben, wie im folgenden Beispiel eines Befehls zum Absenden eines Auftrags: Auftrag übermitteln %CCP_PACKAGE_ROOT%\myRelativePath\myapp.exe
Weitere Informationen finden Sie unter Deploying Applications to Windows Azure Nodes in a Windows HPC Cluster.
Wichtige Überlegungen zu %CCP_PACKAGE_ROOT%
Auf Windows Azure-Knoten wird der ordner "%CCP_PACKAGE_ROOT%" auf einer Datenträgerpartition mit 10 GB erstellt. Dies bedeutet, dass alle Anwendungsdateien in einer Knoteninstanz 10 GB nicht überschreiten können. Wenn eine Anwendung über umfangreiche Eingabe- und Ausgabedateien verfügt, können Sie ein Startskript verwenden, um Benutzerberechtigungen für die C:\-Laufwerke zu erteilen, sodass Benutzer in den gesamten verfügbaren Entwurfsbereich auf dem Knoten schreiben können.
Wenn Sie hpcsync- manuell ausführen, können Sie den Standardspeicherort (%CCP_PACKAGE_ROOT%) überschreiben. Sie können beispielsweise einen Ordner auf jedem Windows Azure-Knoten erstellen und dann diesen Speicherort angeben, wenn Sie hpcsync-ausführen. Alle Pakete werden in diesen Ordner extrahiert. Alle neuen Knoteninstanzen, die bereitgestellt werden (oder automatisch neu bereitgestellt werden), enthalten diesen Ordner jedoch nicht, und Pakete werden automatisch am Standardspeicherort bereitgestellt.
Clusterbenutzer verfügen nur über Schreibberechtigungen für Ordner in %CCP_PACKAGE_ROOT%. Sofern Sie keine Ordnerberechtigungen auf den Windows Azure-Knoten ändern, können nur Clusteradministratoren Anwendungen außerhalb %CCP_PACKAGE_ROOT%ausführen.
Wenn hpcsync ein Paket bereitstellt, kann keine der extrahierten Dateien einen vollständigen Pfad über 256 Zeichen aufweisen. Die Stammverzeichnisse, in denen sich die extrahierten Dateien vorübergehend befinden und dann schließlich platziert werden, können bis zu 136 Zeichen dauern, 120 Zeichen für den Dateinamen, Unterverzeichnisse (falls vorhanden) und die relativePath- (sofern angegeben). Wenn der Pfad für die extrahierten Dateien 256 Zeichen überschreitet, schlägt die Paketbereitstellung fehl.
Siehe auch
hpcpack
clusrun
Burst to Azure Worker Instances mit Microsoft HPC Pack