NetScaler VPX

在 VMware ESX 虚拟机管理程序上首次启动 NetScaler 设备时应用 NetScaler VPX 配置

您可以在 VMware ESX 虚拟机管理程序上首次启动 NetScaler 设备期间应用 NetScaler VPX 配置。 因此,在某些情况下,特定的设置或 VPX 实例会在更短的时间内启动。

有关预引导用户数据及其格式的更多信息, 请参阅在云中首次启动 NetScaler 设备时应用 NetScaler VPX 配置

注意:

To bootstrap using preboot user data in ESX, default gateway config must be passed in <NS-CONFIG> section. For more information on the content of the <NS-CONFIG> tag, see Sample-<NS-CONFIG>-section. 有关 <NS-CONFIG> 标记内容的更多信息,请参见 [示例<NS-CONFIG>-部分](apply-preboot-userdata-on-esx-vpx.html #sample-<ns-config>-部分)。

Sample <NS-CONFIG> section:

  <NS-PRE-BOOT-CONFIG>

      <NS-CONFIG>
          add route 0.0.0.0 0.0.0.0  10.102.38.1
      </NS-CONFIG>

      <NS-BOOTSTRAP>
              <SKIP-DEFAULT-BOOTSTRAP>YES</SKIP-DEFAULT-BOOTSTRAP>
              <NEW-BOOTSTRAP-SEQUENCE>YES</NEW-BOOTSTRAP-SEQUENCE>

          <MGMT-INTERFACE-CONFIG>
                  <INTERFACE-NUM> eth0 </INTERFACE-NUM>
                  <IP> 10.102.38.216 </IP>
                  <SUBNET-MASK> 255.255.255.0 </SUBNET-MASK>
          </MGMT-INTERFACE-CONFIG>
      </NS-BOOTSTRAP>

  </NS-PRE-BOOT-CONFIG>
<!--NeedCopy-->

How to provide preboot user data on ESX hypervisor

您可以通过以下两种方式在 ESX Hypervisor 上从 Web 客户端或 vSphere 客户端提供预启动用户数据:

  • Using CD/DVD ISO
  • Using OVF Property

Provide user data using CD/DVD ISO

您可以使用 VMware vSphere 客户端使用 CD/DVD 驱动器将用户数据作为 ISO 映像注入虚拟机。

按照以下步骤使用 CD/DVD ISO 提供用户数据:

  1. 使用文件名 userdata 创建一个包含预启动用户数据内容的文件。 有关 &lt;NS-CONFIG&gt; 标签内容的更多信息,请参阅示例 &lt;NS-CONFIG&gt; 部分。

    注意:

    文件名必须严格使用为 userdata

  2. Store the userdata file in a folder, and build an ISO image using the folder.

    You can build an ISO image with userdata file by the following two methods:

    • Using any image processing tool such as PowerISO.
    • Using mkisofs command in Linux.

    The following sample configuration shows how to generate an ISO image using the mkisofs command in Linux.

      root@ubuntu:~/sai/14jul2021# ls -l total 4
      drwxr-xr-x 2 root root 4096 Jul 14 12:32 esx_preboot_userdata
      root@ubuntu:~/sai/14jul2021#
      root@ubuntu:~/sai/14jul2021# ls -l esx_preboot_userdata/total 4
      -rw-r--r-- 1 root root 3016 Jul 14 12:32 userdata
      root@ubuntu:~/sai/14jul2021# mkisofs -o esx_preboot_userdata.iso ./esx_preboot_userdata
      I: -input-charset not specified, using utf-8 (detected in locale settings)
      Total translation table size: 0
      Total rockridge attributes bytes: 0
      Total directory bytes: 112
      Path table size(bytes): 10
      Max brk space used 0
      176 extents written (0 MB)
      root@ubuntu:~/sai/14jul2021# ls -lh
      total 356K
      drwxr-xr-x 2 root root 4.0K Jul 14 12:32 esx_preboot_userdata
      -rw-r--r-- 1 root root 352K Jul 14 12:34 esx_preboot_userdata.iso
    
      root@ubuntu:~/sai# ls preboot_userdata_155_193 userdata
      root@ubuntu:~/sai# mkisofs -o preboot_userdata_155_193.iso ./preboot_userdata_155_193
      I: -input-charset not specified, using utf-8 (detected in locale settings)
      Total translation table size: 0
      Total rockridge attributes bytes: 0
      Total directory bytes: 112
      Path table size(bytes): 10
      Max brk space used 0
      176 extents written (0 MB)
    
    <!--NeedCopy-->
    
  3. 使用标准部署流程预配 NetScaler VPX 实例以创建虚拟机。 但是不要自动打开虚拟机的电源。

    Standard VM deployment

  4. After the VM is successfully created, attach the ISO file as CD/DVD drive to the VM.

    Attach CD DVD drive

  5. Navigate to New CD/DVD Drive and choose Datastore ISO file from the drop-down menu.

    Datastore ISO file

  6. Select a Datastore in the vSphere Client.

    Datastore in the vSphere Client

  7. Power on the VM.

使用 ESX Web 客户端中的 OVF 属性提供用户数据

Follow these steps to provide user data using OVF property.

  1. Create a file with user data content.

    Preboot user data for ESX

  2. 使用 Base64 编码对用户数据内容进行编码。 Encode the user data content with Base64 encoding. You can perform the Base64 encoding using the following two methods:

    • In Linux, use the following command:

         base64 <userdata-filename>  >   <outuput-file>
       <!--NeedCopy-->
      

      Example:

         base64 esx_userdata.xml  > esx_userdata_b64
       <!--NeedCopy-->
      

      Base64 encoded userdata

    • Use online tools to encode user data content, for example, Base64 Encode and Decode.

  3. 在 ESX 虚拟机管理程序上的 NetScaler VPX 实例的 OVF 模板中包含 产品 部分。

    Sample Product section:

      <ProductSection>
    
        <Info>Information about the installed software</Info>
        <Product>NSVPX-VSK Template</Product>
        <Vendor>Citrix</Vendor>
        <VendorUrl>www.citrix.com</VendorUrl>
        <Category> Preboot Userdata </Category>
    
        <Property ovf:key="guestinfo.userdata" ovf:type="string" ovf:userConfigurable="true" ovf:value="">
    
          <Label>Userdata</Label>
          <Description> Userdata for ESX VPX </Description>
        </Property>
    
      </ProductSection>
    <!--NeedCopy-->
    
  4. Provide the base64 encoded user data as the ovf:value for guestinfo.userdata property in the Product section.

      <ProductSection>
    
        <Info>Information about the installed software</Info>
        <Product>NSVPX-VSK Template</Product>
        <Vendor>Citrix</Vendor>
        <VendorUrl>www.citrix.com</VendorUrl>
        <Category> Preboot Userdata </Category>
        <Property ovf:key="guestinfo.userdata" ovf:type="string" ovf:userConfigurable="true"
          ovf:value="PE5TLVBSRS1CT09ULUNPTkZJRz4KICAgIDxOUy1DT05GSUc+CglhZGQgcm91dGUgMC4wLjAuMCAw
          LjAuMC4wIDEwLjEwMi4zOC4xCiAgICA8L05TLUNPTkZJRz4KCiAgICA8TlMtQk9PVFNUUkFQPgog
          ICAgICAgICAgICA8U0tJUC1ERUZBVUxULUJPT1RTVFJBUD5ZRVM8L1NLSVAtREVGQVVMVC1CT09U
          U1RSQVA+CiAgICAgICAgICAgIDxORVctQk9PVFNUUkFQLVNFUVVFTkNFPllFUzwvTkVXLUJPT1RT
          VFJBUC1TRVFVRU5DRT4KCiAgICAgICAgPE1HTVQtSU5URVJGQUNFLUNPTkZJRz4KICAgICAgICAg
          ICAgICAgIDxJTlRFUkZBQ0UtTlVNPiBldGgwIDwvSU5URVJGQUNFLU5VTT4KICAgICAgICAgICAg
          ICAgIDxJUD4gICAgMTAuMTAyLjM4LjIxOSA8L0lQPgogICAgICAgICAgICAgICAgPFNVQk5FVC1N
          QVNLPiAyNTUuMjU1LjI1NS4wIDwvU1VCTkVULU1BU0s+CiAgICAgICAgPC9NR01ULUlOVEVSRkFD
          RS1DT05GSUc+CiAgICA8L05TLUJPT1RTVFJBUD4KPC9OUy1QUkUtQk9PVC1DT05GSUc+Cg==">
    
          <Label>Userdata</Label>
          <Description> Userdata for ESX VPX </Description>
        </Property>
    
      </ProductSection>
    <!--NeedCopy-->
    
  5. Use the modified OVF template with Product section for the VM deployment.

    OVF template with Product section

使用 ESX vSphere 客户端中的 OVF 属性提供用户数据

按照以下步骤使用 ESX vSphere 客户端中的 OVF 属性提供用户数据。

  1. Create a file with user data content.

    Preboot user data for ESX

  2. 使用 Base64 编码对用户数据内容进行编码。 Encode the user data content with Base64 encoding. You can perform the Base64 encoding using the following two methods:

    • In Linux, use the following command:

         base64 <userdata-filename>  >   <outuput-file>
       <!--NeedCopy-->
      

      Example:

         base64 esx_userdata.xml  > esx_userdata_b64
       <!--NeedCopy-->
      

      Base64 encoded userdata

    • Use online tools to encode user data content, for example, Base64 Encode and Decode.

  3. 在 ESX 虚拟机管理程序上的 NetScaler VPX 实例的 OVF 模板中包含 产品 部分。

    Sample Product section:

      <ProductSection>
    
        <Info>Information about the installed software</Info>
        <Product>NSVPX-VSK Template</Product>
        <Vendor>Citrix</Vendor>
        <VendorUrl>www.citrix.com</VendorUrl>
        <Category> Preboot Userdata </Category>
    
        <Property ovf:key="guestinfo.userdata" ovf:type="string" ovf:userConfigurable="true" ovf:value="">
    
          <Label>Userdata</Label>
          <Description> Userdata for ESX VPX </Description>
        </Property>
    
      </ProductSection>
    <!--NeedCopy-->
    
  4. Provide the base64 encoded user data as the ovf:value for guestinfo.userdata property in the Product section.

      <ProductSection>
    
        <Info>Information about the installed software</Info>
        <Product>NSVPX-VSK Template</Product>
        <Vendor>Citrix</Vendor>
        <VendorUrl>www.Citrix.com</VendorUrl>
        <Category> Preboot Userdata </Category>
        <Property ovf:key="guestinfo.userdata" ovf:type="string" ovf:userConfigurable="true"
          ovf:value="PE5TLVBSRS1CT09ULUNPTkZJRz4KICAgIDxOUy1DT05GSUc+CglhZGQgcm91dGUgMC4wLjAuMCAw
          LjAuMC4wIDEwLjEwMi4zOC4xCiAgICA8L05TLUNPTkZJRz4KCiAgICA8TlMtQk9PVFNUUkFQPgog
          ICAgICAgICAgICA8U0tJUC1ERUZBVUxULUJPT1RTVFJBUD5ZRVM8L1NLSVAtREVGQVVMVC1CT09U
          U1RSQVA+CiAgICAgICAgICAgIDxORVctQk9PVFNUUkFQLVNFUVVFTkNFPllFUzwvTkVXLUJPT1RT
          VFJBUC1TRVFVRU5DRT4KCiAgICAgICAgPE1HTVQtSU5URVJGQUNFLUNPTkZJRz4KICAgICAgICAg
          ICAgICAgIDxJTlRFUkZBQ0UtTlVNPiBldGgwIDwvSU5URVJGQUNFLU5VTT4KICAgICAgICAgICAg
          ICAgIDxJUD4gICAgMTAuMTAyLjM4LjIxOSA8L0lQPgogICAgICAgICAgICAgICAgPFNVQk5FVC1N
          QVNLPiAyNTUuMjU1LjI1NS4wIDwvU1VCTkVULU1BU0s+CiAgICAgICAgPC9NR01ULUlOVEVSRkFD
          RS1DT05GSUc+CiAgICA8L05TLUJPT1RTVFJBUD4KPC9OUy1QUkUtQk9PVC1DT05GSUc+Cg==">
    
          <Label>Userdata</Label>
          <Description> Userdata for ESX VPX </Description>
        </Property>
    
      </ProductSection>
    <!--NeedCopy-->
    
  5. 将该属性添加 ovf:transport="com.vmware.guestInfo" 到“虚拟硬件”部分,如下所示:

      <VirtualHardwareSection  ovf:transport="com.vmware.guestInfo">
    <!--NeedCopy-->
    
  6. Use the modified OVF template with Product section for the VM deployment.

    OVF template with Product section

在 VMware ESX 虚拟机管理程序上首次启动 NetScaler 设备时应用 NetScaler VPX 配置