hpcsync

Windows Azure ストレージ アカウントから OPC パッケージをコピーし、Windows Azure ノードに解凍します。

手記

このコマンドは、Service Pack 1 を使用する HPC Pack 2008 R2 で導入されましたが、以前のバージョンではサポートされていません。

構文

hpcsync [<storageAccountName> <storageKey>] [<packageRoot>] [/packageName:<packageNameFilter>]   
[/container:<Container name>] [/blocksize:<blockSize>] [/usehttp]   
  
hpcsync {/? | /help}  

パラメーター

クラスター管理者は、hpcsync コマンド パラメーターを指定せずに、 を実行できます。

パラメーター 形容
storageAccountName> を <する Windows Azure ストレージ アカウントのパブリック名 (Windows Azure ノード テンプレートで指定したのと同じストレージ名) を指定します。

これは、アカウントのパブリック URL <storageAccountName> の値です。https://<storageAccountName>.blob.core.windows.net

storageAccountName指定する場合は、storageKey指定する必要があります。 クラスター管理者がコマンドを実行 場合は、のクラスターアカウント名とキーを指定する必要はありません。 値は、CCP_AZURE_CONNECTIONSTRING 環境変数によって提供されます (これは、clusrun ジョブのみのプロセス レベルで設定されます)。 クラスター管理者が clusrunなしで hpcsync 実行する場合、またはクラスター ユーザーが hpcsync実行する場合は、ストレージ アカウント情報をコマンド パラメーターで指定する必要があります。
storageKey> を <する Windows Azure ストレージ アカウントのアクセス キーを指定します。

storageKey指定する場合は、storageAccountName指定する必要もあります。 注: クラスター管理者がコマンドを clusrun hpcsync実行する場合、ストレージ アカウント名とキーを指定する必要はありません。 値は、CCP_AZURE_CONNECTIONSTRING 環境変数によって提供されます (clusrun ジョブのみのプロセス レベルで設定されます)。 クラスター管理者が clusrunなしで hpcsync 実行する場合、またはクラスター ユーザーが hpcsync実行する場合は、ストレージ アカウント情報をコマンド パラメーターで指定する必要があります。
packageRoot> を <する パッケージをデプロイするためのターゲット ルート ディレクトリを指定します。

クラスター管理者がコマンドを実行するときの既定値は %CCP_PACKAGE_ROOT%です。 クラスター ユーザーの既定値は、\Packages%USERPROFILE%ユーザー ディレクトリです。

SOA サービスと XLL が正常に動作するには、ルート ディレクトリが既定値 (%CCP_PACKAGE_ROOT% または %USERPROFILE%\Packages) である必要があります。

%CCP_PACKAGE_ROOT% 環境変数は、Windows Azure によって管理される場所を指します。 HPC Pack では、Windows Azure ノードがデプロイされた後、Windows Azure API を使用してこの変数の値を設定します。 %CCP_PACKAGE_ROOT% の値は Windows Azure デプロイ内で一貫していますが、デプロイによって異なる場合があります。 注: パッケージをストレージ アカウントにアップロードする場合 (hpcpack upload使用)、相対パス属性を定義できます。 パッケージで相対パスが指定されている場合、パッケージは packageRoot\relativePath (たとえば、\myDir%CCP_PACKAGE_ROOT%) に展開されます。
/packageName ダウンロードするパッケージを指定します。 このパラメーターを指定しない場合は、すべての OPC パッケージがダウンロードされます。
/コンテナ ファイルをダウンロードする Windows Azure ストレージ アカウント内のコンテナーの名前を指定します。 このパラメーターを指定しない場合、パッケージは既定の場所 (ストレージ アカウント hpcpackages という名前のコンテナー) からダウンロードされます。
/blocksize ダウンロード時にファイルを分離するブロックのサイズをバイト単位で指定します。 既定のブロック サイズは 4 MB (4194304 バイト) です。 最大ブロック サイズは 4 MB です。 ネットワーク接続が不安定な場合は、より小さいブロック サイズを指定できます。
/usehttp ポート 443 で既定の https チャネルをオーバーライドし、ポート 80 経由の http を使用して通信を試みるように指定します。 失敗した場合は、ポート 443 に戻ります。 注: このパラメーターは、Service Pack 3 を使用する HPC Pack 2008 R2 で導入され、以前のバージョンではサポートされていません。
/? コマンド プロンプトにヘルプを表示します。
/ヘルプ コマンド プロンプトにヘルプを表示します。

備考

  • hpcsync は、少なくとも Microsoft HPC Pack 2008 R2 sp1 を実行しているオンプレミス クラスター に参加 Windows Azure コンピューティング リソース、または Windows Azure HPC Scheduler デプロイ の一部である Windows Azure コンピューティング リソースで使用できます。

  • hpcsync は、HPC クラスター マネージャーから Windows Azure ノードを起動すると自動的に実行されます。また、いずれかのノード インスタンスが Windows Azure メンテナンスの一環として再プロビジョニングされた場合にも自動的に実行されます。 このメカニズムは、起動時に必要なファイルをノードで使用できるようにするか、ノード インスタンスを再プロビジョニングする場合に役立ちます。 hpcsync の自動 呼び出しは、パラメーターなしで実行されます。 つまり、パッケージは、ストレージ内の既定の場所からノード上の既定の場所にコピーされます。 詳細については、このトピックの後半の「アプリケーションデプロイ の自動 hpcsync 呼び出しの活用」を参照してください。

  • Windows Azure デプロイへのバースト中に自動的に実行されるため、必ずしも hpcsync 直接実行する必要はありません。 ただし、Windows Azure ノードが既にデプロイされた後にパッケージをストレージにステージングする場合、またはパッケージを Windows Azure HPC Scheduler デプロイにデプロイする場合は、clusrunを使用して hpcsync 手動で実行できます。 hpcsync には、異なるストレージ コンテナーからパッケージをコピーしたり、別のターゲット ディレクトリにパッケージをデプロイしたりするためのパラメーターも用意されています。

  • hpcsync は、Windows Azure Storage から Windows Azure ノード上の想定される場所に SOA サービス、XLL ファイル、スタートアップ スクリプトをデプロイするのに最適です。 または、hpcpack コマンド (hpcpack uploadhpcpack download) を使用して、Windows Azure ストレージと Windows Azure ノード間で他の種類のファイル、アプリケーション、またはジョブ データを移動することもできます。 詳細については、hpcpackの を参照してください。

  • このコマンドを使用するには、クラスター ユーザーがストレージ アカウント名とプライマリ アクセス キーを知っている必要があります。

クラスター管理者が Windows Azure ストレージ アカウントの既定のコンテナーから一連の Windows Azure ワーカー ノードにすべての OPC ファイルをデプロイする場合:

clusrun /nodegroup:AzureWorkerNodes hpcSync

クラスター ユーザーが Windows Azure ストレージ アカウント (myContainer) 上の特定のコンテナーから、一連の Windows Azure ノード (ノード 1 から 3) 上の既定のディレクトリにすべての OPC ファイルをデプロイする場合:

job submit /requestednodes:node1,node2,node3 hpcSync myAccount myKey /container:myContainer

ファイルの展開のトラブルシューティングに役立つコマンドをテストするには、C:\tempでローカル コンピューターにファイルを展開します。

hpcsync myAccount myKey C:\temp

アプリケーションのデプロイに対する自動 hpcsync 呼び出しの活用

ノードのプロビジョニング中に hpcsync 呼び出し 自動 を利用するには、ノードをデプロイする前に、Windows Azure ストレージ アカウントの hpcpackages コンテナーに OPC パッケージをステージングする必要があります。 hpcpack コマンドを使用して、Windows Azure ストレージにファイルをパッケージ化してアップロードできます。 (既定では、hpcpack アップロード パッケージを hpcpackages コンテナーに配置します。パッケージをすべての Windows Azure ノードに自動的にデプロイしない場合は、代替コンテナーを指定します)。

既定では、クラスター管理者 hpcsync は、%CCP_PACKAGE_ROOT% 環境変数によって部分的に決定される Windows Azure ノード上の場所にファイルをデプロイします。 この変数は、プロビジョニング プロセス中に Windows Azure ノードで設定されます。 抽出されたファイルは、次のように決定されるフォルダーに配置されます。 %CCP_PACKAGE_ROOT%\<packageName>\<uploadTimeStamp>。 これは、ノード テンプレートから呼び出される SOA サービス、XLL、Excel ブック、および スタートアップ スクリプト に想定される場所です。 ただし、これは、クラスター ユーザーがコマンド ラインで呼び出すアプリケーションでは便利ではありません。

実行可能ファイルのフォルダー構造を簡略化するために、パッケージをストレージにアップロードするときに、パッケージの相対パス プロパティを設定できます。 hpcsync は、ファイルを抽出するときに相対パスを適用するため、パスは次のように決定されます:%CCP_PACKAGE_ROOT%\<relativePath>。 ユーザーは、ジョブ送信コマンドの例のように、アプリケーションへのパスを指定できます。ジョブの送信 %CCP_PACKAGE_ROOT%\myRelativePath\myapp.exe

詳細については、「アプリケーションを Windows HPC クラスター内の Windows Azure ノードにデプロイする」を参照してください。

%CCP_PACKAGE_ROOT% に関する重要な考慮事項

  • Windows Azure ノードでは、%CCP_PACKAGE_ROOT% フォルダーは 10 GB のディスク パーティションに作成されます。 つまり、ノード インスタンス上のすべてのアプリケーション ファイルが 10 GB を超えることはできません。 アプリケーションにかなりの入力ファイルと出力ファイルがある場合は、スタートアップ スクリプトを使用して C:\ ドライブに対するユーザーのアクセス許可を付与し、ユーザーがノード上の使用可能なすべてのスクラッチ領域に書き込むことができます。

  • hpcsync 手動で実行すると、既定の場所 (%CCP_PACKAGE_ROOT%) をオーバーライドできます。 たとえば、各 Windows Azure ノードにフォルダーを作成し、hpcsyncを実行するときにその場所 指定できます。 すべてのパッケージがそのフォルダーに抽出されます。 ただし、デプロイされた (または自動的に再プロビジョニングされる) 新しいノード インスタンスにはそのフォルダーは含まれません。パッケージは既定の場所に自動的にデプロイされます。

  • クラスター ユーザーには、%CCP_PACKAGE_ROOT%内のフォルダーへの書き込みアクセス許可しかありません。 Windows Azure ノードのフォルダーのアクセス許可を変更しない限り、クラスター管理者のみが %CCP_PACKAGE_ROOT%の外部でアプリケーションを実行できます。

  • hpcsync パッケージをデプロイする場合、抽出されたファイルの完全パスを 256 文字以上にすることはできません。 抽出されたファイルが一時的に配置され、最後に配置されるルート ディレクトリは最大 136 文字で、ファイル名、サブディレクトリ (存在する場合)、relativePath (指定されている場合) に 120 文字を残すことができます。 抽出されたファイルのパスが 256 文字を超える場合、パッケージの展開は失敗します。

関連項目

hpcpack を する
clusrun
する
Microsoft HPC Pack
を使用した Azure Worker インスタンスへのバーストの