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

Last published : Oct 06, 2026
您可以在 VMware ESX 虚拟机管理程序上首次启动 NetScaler 设备时应用 NetScaler VPX 配置。因此,在某些情况下,可以大大缩短特定设置或 VPX 实例的启动时间。
有关预启动用户数据及其格式的更多信息,请参阅 在云中首次启动 NetScaler 设备时应用 NetScaler VPX 配置。
注意:
要在 ESX 中使用预启动用户数据进行引导,必须在 <NS-CONFIG> 部分中传递默认网关配置。有关 <NS-CONFIG> 标签内容的更多信息,请参阅 示例-<NS-CONFIG>-部分。
示例 <NS-CONFIG> 部分:
<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>

如何在 ESX 虚拟机管理程序上提供预启动用户数据

您可以通过以下两种方式从 Web 客户端或 vSphere 客户端在 ESX 虚拟机管理程序上提供预启动用户数据:
  • 使用 CD/DVD ISO
  • 使用 OVF 属性

使用 CD/DVD ISO 提供用户数据

您可以使用 VMware vSphere 客户端通过 CD/DVD 驱动器将用户数据作为 ISO 映像注入到虚拟机中。
请按照以下步骤使用 CD/DVD ISO 提供用户数据:
  1. 创建一个文件,文件名为 userdata,其中包含预启动用户数据内容。有关 <NS-CONFIG> 标签内容的更多信息,请参阅示例 <NS-CONFIG> 部分。
    注意:
    文件名必须严格使用 userdata。
  2. 将 userdata 文件存储在一个文件夹中,并使用该文件夹构建 ISO 映像。
    您可以通过以下两种方法构建包含 userdata 文件的 ISO 映像:
    • 使用任何图像处理工具,例如 PowerISO。
    • 在 Linux 中使用 mkisofs 命令。
    以下示例配置展示了如何在 Linux 中使用 mkisofs 命令生成 ISO 映像。
    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)
  3. 使用标准部署流程预置 NetScaler VPX 实例以创建 VM。但不要自动启动 VM。
    标准 VM 部署
  4. VM 成功创建后,将 ISO 文件作为 CD/DVD 驱动器附加到 VM。
  5. 导航到 新建 CD/DVD 驱动器 并从下拉菜单中选择 数据存储 ISO 文件。
    数据存储 ISO 文件
  6. 在 vSphere Client 中选择一个数据存储。
    vSphere Client 中的数据存储
  7. 启动 VM。

使用 ESX Web 客户端通过 OVF 属性提供用户数据

按照以下步骤使用 OVF 属性提供用户数据。
  1. 创建包含用户数据内容的文件。
    ESX 的预启动用户数据
  2. 使用 Base64 编码对用户数据内容进行编码。您可以使用以下两种方法执行 Base64 编码:
    • 在 Linux 中,使用以下命令:
      base64 <userdata-filename>  >   <outuput-file>
      示例:
      base64 esx_userdata.xml  > esx_userdata_b64Base64 编码的用户数据
    • 使用在线工具对用户数据内容进行编码,例如 Base64 Encode and Decode。
  3. 在 ESX 虚拟机管理程序上的 NetScaler VPX 实例的 OVF 模板中包含 Product 部分。
    Product 部分示例:
    <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>
  4. 在 Product 部分中,将 base64 编码的用户数据作为 guestinfo.userdata 属性的 ovf:value 提供。
    <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>
  5. 使用包含 Product 部分的修改后的 OVF 模板进行虚拟机部署。
    包含 Product 部分的 OVF 模板

使用 ESX vSphere 客户端通过 OVF 属性提供用户数据

按照以下步骤,使用 ESX vSphere 客户端的 OVF 属性提供用户数据。
  1. 创建一个包含用户数据内容的文件。
    适用于 ESX 的预启动用户数据(/en-us/vpx/media/ns-preboot-config-esx-userdata.png)
  2. 使用 Base64 编码对用户数据内容进行编码。您可以使用以下两种方法执行 Base64 编码:
    • 在 Linux 中,使用以下命令:
      base64 <userdata-filename>  >   <outuput-file>
      示例:
      base64 esx_userdata.xml  > esx_userdata_b64
      Base64 编码的用户数据(/en-us/vpx/media/base64-encoded-userdata.png)
    • 使用在线工具编码用户数据内容,例如 Base64 Encode and Decode。
  3. 在 ESX 虚拟机管理程序上的 NetScaler VPX 实例的 OVF 模板中包含一个 Product 部分。
    Product 部分示例:
    <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>
  4. 在 Product 部分中,将 base64 编码的用户数据作为 guestinfo.userdata 属性的 ovf:value 提供。
    <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>
  5. 如下所示将属性 ovf:transport="com.vmware.guestInfo" 添加到 VirtualHardwareSection:
    <VirtualHardwareSection  ovf:transport="com.vmware.guestInfo">
  6. 使用包含 Product 部分的修改后的 OVF 模板进行 VM 部署。
    包含 Product 部分的 OVF 模板(/en-us/vpx/media/ovf-template-with-product-section.png)