StyleBookを作成してファイルをアップロードする
NetScaler ADM StyleBooksを使用すると、NetScaler ADM GUIまたはAPIを使用して、ローカルファイルシステムからCitrix ADCインスタンスにあらゆる種類のファイルをアップロードする際に、とりわけ含める可能性のあるCitrix ADC構成を作成できます。これらのファイルは、証明書ファイルの例でも位置情報ファイルでもかまいません。これらのファイルをアップロードするディレクトリを指定することもできます。
StyleBookの設定
以下は、NetScaler インスタンスに位置情報ファイルをアップロードする方法を説明するStyleBookの例です。地理ファイルは、地理的位置に基づいて静的近接を定義するために、GSLB設定で通常使用されます。
StyleBookを構築する-1
name:upload-geolocationsnamespace:com.citrix.adc.stylebooks.samplesversion:"1.0"display-name:GeoLocation File Uploaddescription:This StyleBook is used to upload a geolocation file to NetScalerschema-version:"1.0"import-stylebooks:-namespace:netscaler.nitro.configversion:"11.1"prefix:nsparameters:-name:locationfilelabel:Location Filedescription:The system file path of the geolocation file on NetScaler ADMtype:filerequired:truecomponents:-name:upload-file-comptype:ns::systemfileproperties:filename:$parameters.locationfile.filenamefilelocation:"/var/netscaler/inbuilt_db/"filecontent:base64.encode($parameters.locationfile.contents)
注:
この例で使用されているパラメータはタイプファイルのものです。このStyleBookをCitrix ADM にインポートして、ジオロケーションファイルをアップロードできます。
このStyleBookでは、ファイルがCitrix ADMにすでに存在している必要があります(たとえば、SCPなどのユーティリティを使用してCitrix ADMにコピー済みなど)。 ファイルをNetScaler ADMファイルシステムにコピーせずにNetScaler ADM経由でNetScalersにアップロードする場合は、2つの「文字列」パラメーターを持つStyleBookを構築できます。1つはNetScalerで使用するファイル名を指定するためのもので、もう1つはファイルの内容を指定するためのもので、これら2つのパラメーターをアップロードファイルコンプコンポーネントで使用します。以下は、位置情報ファイルをアップロードするための代替StyleBookです。
StyleBookを構築する-2
name:upload-geolocations-altnamespace:com.citrix.adc.stylebooks.samplesversion:"1.0"display-name:GeoLocation File Uploaddescription:This StyleBook is used to upload a geolocation file to NetScalerschema-version:"1.0"import-stylebooks:-namespace:netscaler.nitro.configversion:"11.1"prefix:nsparameters:-name:filenamelabel:Location Filenamedescription:The name of the location file on the NetScalertype:stringrequired:true-name:filecontentslabel:Location File Contentsdescription:文件的内容位置type:stringrequired:truecomponents:-name:upload-file-comptype:ns::systemfileproperties:filename:$parameters.filenamefilelocation:"/var/NetScaler/inbuilt_db/"filecontent:base64.encode($parameters.filecontents)
ファイルをアップロードするための構成の作成
以下の手順では、選択したCitrix ADCインスタンスに、上記の最初のStyleBookを使用して位置情報ファイルをアップロードする構成を作成します。
ファイルをアップロードするための設定を作成するには:
NetScaler ADM で、[アプリケーション]>[構成]に移動し、[新規作成]をクリックします。「スタイルブックの選択」ページには、NetScaler ADM で使用できるすべてのスタイルブックが表示されます。下方向にスクロールして、インポートしたStyleBookを選択します。
StyleBookパラメーターは、このStyleBookで定義されているすべてのパラメーターの値を入力できるユーザーインターフェイスページとして表示されます。
ロードバランサーの基本設定セクションにロードバランサーの名前と仮想 IP アドレスを入力します。
- [ロケーションファイル] セクションで、ファイルの名前または場所を入力します。
注:
NetScaler ADM では、ファイルが現在のテナントのフォルダーにのみ配置されていることを確認します。任意のFTPを使用してファイルをCitrix ADMファイルシステムにコピーします。
ターゲットインスタンスにアクセスする前に、ユーザー認証情報を入力するように求められる場合があります。
- 構成を作成する対象のCitrix ADC インスタンスを選択し、[作成]をクリックします。
注:
インスタンスで実際の構成を実行する前に、[Dry Run]を選択してターゲットインスタンスに作成された構成オブジェクトを確認することをお勧めします。
構成パックが正常に作成されると,ファイルはCitrix ADCインスタンスファイルシステムの/ var/netscaler/inbuilt_db/ という場所に保存されます。
注
更新アイコンをクリックして、Citrix ADMで最近検出されたCitrix ADCインスタンスをこのウィンドウで使用可能なインスタンスのリストに追加することもできます。
NetScaler ADM APIを使用した構成パックの作成
NetScaler ADM APIを使用して、選択したCitrix ADCインスタンスにファイルをアップロードする構成パックを作成することもできます。API の使用方法の詳細については、「API を使用して任意のファイルタイプをアップロードする構成を作成する方法」を参照してください。