Application Delivery Management

NetScaler ADM にファイルをアップロードするStyleBookを作成する

Citrix Application Delivery Management(Citrix ADM)StyleBooksを使用すると、Citrix ADM GUIまたはAPIを使用して、ローカルファイルシステムからCitrix ADCインスタンスにあらゆる種類のファイルをアップロードする際に、とりわけ含めることができるCitrix ADC構成を作成できます。これらのファイルは、証明書ファイルの例でも位置情報ファイルでもかまいません。これらのファイルをアップロードするディレクトリを指定することもできます。

StyleBookの設定

以下は、NetScaler ADC インスタンスに位置情報ファイルをアップロードする方法を説明するStyleBookの例です。地理ファイルは、地理的位置に基づいて静的近接を定義するために、GSLB設定で通常使用されます。

StyleBookの作成 -1

name: upload-geolocations
namespace: com.citrix.adc.stylebooks.samples
version: "1.0"
display-name: GeoLocation File Upload
description: This StyleBook is used to upload a geolocation file to Citrix ADC
schema-version: "1.0"

import-stylebooks:
-
 namespace: netscaler.nitro.config
 version: "11.1"
 prefix: ns

parameters:
-
 name: locationfile
 label: Location File
 description: The system file path of the geolocation file on Citrix ADM
 type: file
 required: true

components:
-
 name: upload-file-comp
 type: ns::systemfile
 properties:
    filename: $parameters.locationfile.filename
    filelocation: "/var/netscaler/inbuilt_db/"
    filecontent: base64.encode($parameters.locationfile.contents)
<!--NeedCopy-->

注:

この例で使用されているパラメータはタイプファイルのものです。このStyleBookをNetScaler ADM にインポートして、ジオロケーションファイルをアップロードできます。

このStyleBookでは、ファイルがCitrix ADM にすでに存在している必要があります(たとえば、scpなどのユーティリティを使用してCitrix ADM に既にコピーしているはずです)。

NetScaler ADMファイルシステムにファイルをコピーせずに、NetScaler ADM経由でNetScaler ADCにファイルをアップロードする場合は、2つの「文字列」パラメータを持つStyleBookを構築できます。1つはNetScaler ADCで使用するファイル名を指定し、もう1つはNetScaler ADCの内容を指定するものです。ファイルを作成し、upload-file-comp コンポーネントでこれら 2 つのパラメータを使用します。以下は、位置情報ファイルをアップロードするための代替StyleBookです。

StyleBookを構築する-2

name: upload-geolocations-alt
namespace: com.citrix.adc.stylebooks.samples
version: "1.0"
display-name: GeoLocation File Upload
description: This StyleBook is used to upload a geolocation file to Citrix ADC
schema-version: "1.0"

import-stylebooks:
 -
  namespace: netscaler.nitro.config
  version: "11.1"
  prefix: ns

parameters:
 -
  name: filename
  label: Location Filename
  description: The name of the location file on the Citrix ADC
  type: string
  required: true
 -
  name: filecontents
  label: Location File Contents
  description: The contents of the location file
  type: string
  required: true

components:
 -
  name: upload-file-comp
  type: ns::systemfile
  properties:
   filename: $parameters.filename
   filelocation: "/var/Citrix ADC/inbuilt_db/"
   filecontent: base64.encode($parameters.filecontents)
<!--NeedCopy-->

ファイルをアップロードするための構成の作成

以下の手順では、選択したNetScaler ADCインスタンスに、上記の最初のStyleBookを使用して位置情報ファイルをアップロードする構成を作成します。

ファイルをアップロードするための設定を作成するには

  1. NetScaler ADM で、[ アプリケーション ]>[ 構成]に移動し、[ 新規作成]をクリックします。「StyleBookの選択」ページには、NetScaler ADM で使用できるすべてのStyleBookが表示されます。下方向にスクロールして、インポートしたStyleBookを選択します。

    StyleBookパラメーターは、このStyleBookで定義されているすべてのパラメーターの値を入力できるユーザーインターフェイスページとして表示されます。

  2. ロードバランサーの基本設定セクションにロードバランサーの名前と仮想 IP アドレスを入力します。

  3. [ ロケーションファイル ] セクションで、ファイルの名前または場所を入力します。

    :Citrix ADM では、ファイルが現在のテナントのフォルダーのみにあることを確認してください。任意のファイル転送プロトコルを使用して、Citrix ADM ファイルシステムにファイルをコピーします。

  4. ターゲットインスタンスにアクセスする前に、ユーザー認証情報を入力するように求められる場合があります。

  5. 構成を作成する対象のNetScaler ADC インスタンスを選択し、[ 作成]をクリックします。

注:

インスタンスで実際の構成を実行する前に、[ Dry Run]を選択して、ターゲットインスタンス上に作成された構成オブジェクトをチェックすることをお勧めします。

コンフィグパックの作成が成功すると、ファイルはCitrix ADCインスタンスのファイルシステムの /var/netscaler/inbuilt_db/ という場所に保存されます。

更新アイコンをクリックして、NetScaler ADMで最近検出されたNetScaler ADCインスタンスをこのウィンドウで使用可能なインスタンスのリストに追加することもできます。

Citrix ADM API を使用してコンフィグパックを作成する

Citrix ADM APIを使用して、選択したCitrix ADC インスタンスにファイルをアップロードする構成パックを作成することもできます。API の使用方法の詳細については、「API を使用して任意のファイルタイプをアップロードする構成を作成する方法」を参照してください。

NetScaler ADM にファイルをアップロードするStyleBookを作成する