ネイティブ形式
変更を提案
PDF
SnapCenter では、 Perl 以外のプログラミング言語やスクリプト言語を使用してプラグインを作成できます。これは、スクリプトまたはバッチファイルとして使用できるネイティブスタイルプログラミングと呼ばれます。
ネイティブ形式のプラグインは、次に示す特定の表記規則に従う必要があります。
プラグインが実行可能である必要があります
-
UNIX システムの場合、エージェントを実行するユーザにはプラグインに対する実行権限が必要です
-
Windowsシステムの場合、PowerShellプラグインにはサフィックス.ps1、その他のWindowsが必要です スクリプトは、.cmdまたは.batサフィックスを持ち、ユーザが実行可能である必要があります
-
プラグインは、「 -quiesce 」、「 -unquiesce 」などのコマンドライン引数に対応する必要があります。
-
操作または関数が実装されていない場合、プラグインは終了コード 99 を返す必要があります
-
プラグインは、特定の構文を使用して結果をサーバに渡す必要があります
一般的なプラグイン処理
エラーメッセージのロギング
各オペレーションは ' サーバにメッセージを送信することができますサーバは ' コンテンツを表示して保存しますメッセージには、メッセージレベル、タイムスタンプ、およびメッセージテキストが含まれます。複数行のメッセージがサポートされます。
の形式で入力し
SC_MSG#<level>#<timestamp>#<message> SC_MESSAGE#<level>#<timestamp>#<message>
プラグインスタブを使用する
SnapCenter プラグインはプラグインスタブを実装する必要があります。SnapCenter サーバが呼び出すメソッドは、特定のワークフローに基づいています。
| プラグインスタブ | オプション / 必須 | 目的 |
|---|---|---|
休止 |
必須 |
このスタブは休止を実行します。が配置されます Snapshotコピーを作成できる状態に適用します。これは、ストレージ Snapshot コピー処理の前に呼び出されます。 |
休止解除 |
必須 |
休止解除を実行する場合は、このスタブを指定します。配置されます 通常の状態のアプリケーション。これは保管後に呼び出されます Snapshotコピー処理 |
clone_pre |
任意。 |
このスタブは、クローニング前のタスクを実行する役割を果たします。この場合、組み込みの SnapCenter クローニングインターフェイスを使用しており、「 clone_vol または clone_lun 」操作の実行時にのみトリガーされることを前提としています。 |
clone_post をクリックしてください |
任意。 |
この STUB は、クローニング後のタスクの実行を担当します。このパラメータは、組み込みの SnapCenter クローニングインターフェイスを使用していること、および「 clone_vol 」または「 clone_lun 」処理を実行するときにのみトリガーされることを前提としています。 |
restore_pre |
任意。 |
このスタブはリストア前のタスクを実行するためのものです。この処理は、組み込みの SnapCenter リストアインターフェイスを使用していることを前提としており、リストア処理の実行中にのみ実行されます。 |
リストア |
任意。 |
このスタブは、すべてのリストアアクションを実行するためのものです。これ 組み込みのリストアインターフェイスを使用していないことを前提としています。このコマンドはリストア処理の実行中にトリガーされます。 |
例
Windows PowerShell の場合
スクリプトをシステムで実行できるかどうかを確認します。スクリプトを実行できない場合は、スクリプトに対して Set-ExecutionPolicy bypass を設定して、操作を再試行します。
if ($args.length -ne 1) {
write-warning "You must specify a method";
break;
}
function log ($level, $message) {
$d = get-date
echo "SC_MSG#$level#$d#$message"
}
function quiesce {
$app_name = (get-item env:APP_NAME).value
log "INFO" "Quiescing application using script $app_name";
log "INFO" "Quiescing application finished successfully"
}
function unquiesce {
$app_name = (get-item env:APP_NAME).value
log "INFO" "Unquiescing application using script $app_name";
log "INFO" "Unquiescing application finished successfully"
}
switch ($args[0]) {
"-quiesce" {
quiesce;
}
"-unquiesce" {
unquiesce;
}
default {
write-error "Function $args[0] is not implemented";
exit 99;
}
}
exit 0;