製品ドキュメント
Application Delivery Management
14.1 - Current Release 13.1 13.0 12.1
PDFを表示

構成ジョブでの変数の使用

February 6, 2024
寄稿者: 
C

構成ジョブとは、管理対象インスタンスで実行できる一連の構成コマンドのことです。複数のインスタンスで同じ構成を実行する場合は、構成内で使用されているパラメーターに対して、さまざまな値を使用できます。これらのパラメーターにさまざまな値を割り当てることや1つのジョブを複数のインスタンスにわたって実行することができるようになる変数を定義できます。

たとえば、負荷分散仮想サーバーを追加し、2つのサービスを追加し、それらのサービスをその仮想サーバーにバインドするという、基本的な負荷分散構成を考えてみましょう。ここでは、2つのインスタンスで同じ構成を使用するが、仮想サーバーとサービスの名前およびIPアドレスに異なる値を使用する必要があるとします。これを実現するには、変数を使用して仮想サーバーとサービスの名前およびIPアドレスを定義することで、構成ジョブ機能を使用します。

この例では、次のコマンドと変数を使用します。

lb 仮想サーバーサーバー名HTTP IP アドレス ポート番号を追加

サービス名 1、IP アドレス1 、HTTP 80 を追加

サービス名/サービス名/2 IP アドレス/2 HTTP 8.0 を追加

bind lb vserver サーバ名サービス名1

bind lb vserver サーバー名サービス名2

NetScaler ADM で変数を定義して構成ジョブを作成するには：

  1. [ ネットワーク ] > [ 構成ジョブ] に移動します。

  2. [ ジョブの作成] をクリックします。

  3. Create Job ページで、ジョブの名前、インスタンスタイプ、設定タイプなどのカスタムジョブパラメータを選択します。

  4. ［Configuration Editor］でコマンドを入力して、負荷分散仮想サーバー、2つのサービスを追加し、それらのサービスをその仮想サーバーにバインドします。変数に変換する値をダブルクリックして選択し、[ 変数に変換] をクリックします。たとえば、 負荷分散サーバーのIPアドレスのIPアドレスを選択し、次の図に示すように [ 変数に変換 ] をクリックします。

    ローカライズされた画像

  5. 変数の値がドル記号で囲まれたら、変数をクリックして、名前、表示名、種類など、変数の詳細をさらに指定します。変数のデフォルト値をさらに指定する場合は、「詳細」( Advanced ) オプションをクリックすることもできます。[ 保存 ] をクリックし、[ 次へ] をクリックします。

    ローカライズされた画像

    残りのコマンドを入力し、すべての変数を定義します。

    ローカライズされた画像

  6. 構成ジョブの作成または編集中に定義したすべての変数を、1 つの統合ビューで確認できます。

  7. 次のいずれかの操作を行って、すべての変数を 1 つの統合ビューに表示します。

    • 構成ジョブを作成するときに、[ ネットワーク] > [構成ジョブ] に移動し、[ ジョブの作成] を選択します。[ Create Job ] ページでは、構成ジョブの作成時に追加したすべての変数を確認できます。

    • 構成ジョブの編集中に、[ ネットワーク] > [構成ジョブ] に移動し、ジョブ名を選択して [ 編集] をクリックします。[ ジョブの構成 ] ページでは、構成ジョブの作成時に追加されたすべての変数を確認できます。

  8. 次に、「 変数のプレビュー 」タブをクリックすると、構成ジョブの作成または編集中に定義した単一の統合ビューで変数をプレビューできます。

    ローカライズされた画像

  9. 新しいポップアップウィンドウが表示され、名前、表示名、タイプ、デフォルト値などの変数のすべてのパラメータが表形式で表示されます。これらのパラメータを編集および修正することもできます。パラメータを編集または変更したら、[ 完了 ] ボタンをクリックします。

    ローカライズされた画像

  10. その後、構成レーションエディタでコマンドを並べ替えたり、並べ替えたりすることができます。コマンドラインをドラッグアンドドロップすることで、コマンドをある行から別の行に移動できます。テキストボックスでコマンドライン番号を変更するだけで、コマンドラインを 1 行から任意のターゲットラインに移動または再配置することもできます。

  11. 構成ジョブを実行するインスタンスを選択します。

  12. 「 変数値の指定 」タブで、「 変数値の入力ファイルをアップロード」オプションを選択し、「 入力キーファイルのダウンロード」をクリックします。例では、各インスタンス上のサーバー名、サーバーとサービスのIPアドレス、ポート番号、およびサービス名を指定する必要があります。ファイルを保存し、アップロードします。値が正確に定義されていない場合は、システムによってエラーがスローされる場合があります。

  13. 入力キーファイルはローカルシステムにダウンロードされ、以前に選択した各NetScalerインスタンスの変数値を指定して編集できます。［ アップロード ］をクリックして入力キーファイルをCitrix ADM にアップロードします。［次へ］ をクリックします。入力キーファイルがローカルシステムにダウンロードされ、以前に選択した各NetScaler インスタンスの変数値を指定することで編集できます。

    注： 入力キーファイルでは、変数は3つのレベルで定義されています。

    • グローバルレベル
    • インスタンスグループレベル
    • インスタンスレベル

    グローバル変数は、すべてのインスタンスに適用される変数値です。インスタンスグループレベルの変数値は、グループで定義されているすべてのインスタンスに適用されます。インスタンスレベルの変数値は、特定のインスタンスにのみ適用されます。

    NetScaler ADM では、インスタンスレベルの値が最優先されます。個々のインスタンスの変数に値が提供されていない場合、NetScaler ADM はグループレベルで提供された値を使用します。グループレベルで値が指定されていない場合、NetScaler ADM はグローバルレベルで提供された変数値を使用します。3つのレベルすべてにわたって変数の入力を指定すると、NetScaler ADM はインスタンスレベル値をデフォルト値として使用します。

  14. 「 アップロード 」をクリックして、入力キーファイルをCitrix ADM にアップロードします。［次へ］ をクリックします。

    ローカライズされた画像

    重要

    Mac から CSV ファイルをアップロードすると、CSV ファイルはコンマではなくセミコロンで保存されます。これにより、入力ファイルをアップロードしてジョブを実行すると、設定が失敗します。Mac を使用している場合は、テキストエディタを使用して必要な変更を行い、ファイルをアップロードします。

  15. すべてのインスタンスに共通の変数値を指定し、「アップ ロード」をクリック して入力キーファイルをCitrix ADM にアップロードすることもできます。

    変数値を含むキー入力ファイルは、設定ジョブで (同じファイル名で) 保持されます。設定ジョブの作成または編集中に、以前に使用およびアップロードした入力ファイルを表示および編集できます。

    構成ジョブの作成中に実行された構成ジョブを表示するには、[ ネットワーク] > [構成ジョブ] に移動し、[ ジョブの作成] をクリックします。[ ジョブの作成 ] ページ。[ 変数値の指定 ] タブで、[ すべてのインスタンスに共通の変数値 ] オプションを選択し、アップロードされたファイルを表示します。入力ファイルを編集するには、入力ファイルをダウンロードし、ファイルを編集してアップロードします（同じファイル名を維持します）。

    構成ジョブの編集中に実行済みの構成ジョブを表示するには、[ ネットワーク] > [構成ジョブ] に移動し、ジョブ名を選択して [ 編集] をクリックします。[ ジョブの設定 ] ページの [ 変数値の指定 ] タブで、[ すべてのインスタンスに共通変数値 ] オプションを選択して、アップロードされたファイルを表示します。入力ファイルを編集するには、入力ファイルをダウンロードし、ファイルを編集してアップロードします（同じファイル名を維持します）。

  16. [ Job Preview ] タブでは、各インスタンスまたはインスタンスグループで実行するコマンドを評価および検証できます。

  17. [ 実行 ] タブでは、ジョブを今すぐ実行するか、後で実行するようにスケジュールするかを選択できます。また、コマンドが失敗した場合にCitrix ADM が実行するアクションや、ジョブの成功または失敗に関する電子メール通知を他の詳細とともに送信するかどうかを選択することもできます。

    ローカライズされた画像

ジョブを設定して実行したら、[ ネットワーク ] > [設定ジョブ] に移動し、 先ほど設定したジョブを選択すると 、ジョブの詳細が表示されます。 [ 詳細 ] をクリックし、[ 変数の詳細 ] をクリックすると、ジョブに追加された変数のリストが表示されます。

ローカライズされた画像

注

STEP 5 で変数に指定した値は、ジョブを保存して終了するとき、または後でジョブを実行するようにスケジュールするときに、NetScaler ADM によって保持されます。

構成ジョブでの変数の使用
February 6, 2024
寄稿者: 
C
February 6, 2024
寄稿者: 
C

この記事の概要

サイトに関するフィードバック | プライバシーと法令 | Cookieの設定 | 同意設定 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.