NetScaler VPX-Konfigurationen beim ersten Start der NetScaler-Appliance auf dem VMware ESX-Hypervisor anwenden

Last published : Sep 23, 2026
Sie können die NetScaler VPX-Konfigurationen während des ersten Starts der NetScaler-Appliance auf dem VMware ESX-Hypervisor anwenden. In bestimmten Fällen kann dadurch ein spezifisches Setup oder eine VPX-Instanz in kürzerer Zeit gestartet werden.
Weitere Informationen zu Preboot-Benutzerdaten und deren Format finden Sie unter NetScaler VPX-Konfigurationen beim ersten Start der NetScaler-Appliance in der Cloud anwenden.
Hinweis:
Um mit Preboot-Benutzerdaten in ESX zu booten, muss die Standard-Gateway-Konfiguration im <NS-CONFIG>-Abschnitt übergeben werden. Weitere Informationen zum Inhalt des <NS-CONFIG>-Tags finden Sie unter Beispiel-<NS-CONFIG>-Abschnitt.
Beispiel-<NS-CONFIG>-Abschnitt:
<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>

So stellen Sie Preboot-Benutzerdaten auf dem ESX-Hypervisor bereit

Sie können Preboot-Benutzerdaten auf dem ESX-Hypervisor über den Webclient oder den vSphere-Client auf zwei Arten bereitstellen:
  • Verwenden eines CD/DVD-ISO
  • Verwenden einer OVF-Eigenschaft

Benutzerdaten über CD/DVD-ISO bereitstellen

Sie können den VMware vSphere-Client verwenden, um Benutzerdaten als ISO-Image über das CD/DVD-Laufwerk in die VM zu einschleusen.
Führen Sie die folgenden Schritte aus, um Benutzerdaten über das CD/DVD-ISO bereitzustellen:
  1. Erstellen Sie eine Datei mit dem Dateinamen userdata, die den Inhalt der Preboot-Benutzerdaten enthält. Weitere Informationen zum Inhalt des <NS-CONFIG>-Tags finden Sie im Beispiel-<NS-CONFIG>-Abschnitt.
    Hinweis:
    Der Dateiname muss strikt als userdata verwendet werden.
  2. Speichern Sie die Datei userdata in einem Ordner und erstellen Sie ein ISO-Image aus diesem Ordner.
    Sie können ein ISO-Image mit der Datei userdata auf die folgenden zwei Arten erstellen:
    • Verwenden Sie ein beliebiges Bildverarbeitungstool wie PowerISO.
    • Verwenden Sie den Befehl mkisofs unter Linux.
    Die folgende Beispielkonfiguration zeigt, wie ein ISO-Image mit dem Befehl mkisofs unter Linux generiert wird.
    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. Stellen Sie die NetScaler VPX-Instanz mithilfe des Standardbereitstellungsprozesses bereit, um die VM zu erstellen. Schalten Sie die VM jedoch nicht automatisch ein.
    Standard-VM-Bereitstellung
  4. Nachdem die VM erfolgreich erstellt wurde, hängen Sie die ISO-Datei als CD/DVD-Laufwerk an die VM an.
  5. Navigieren Sie zu Neues CD/DVD-Laufwerk und wählen Sie Datastore-ISO-Datei aus dem Dropdown-Menü.
    Datastore-ISO-Datei
  6. Wählen Sie einen Datenspeicher im vSphere Client aus.
    Datenspeicher im vSphere Client
  7. Schalten Sie die VM ein.

Benutzerdaten mithilfe der OVF-Eigenschaft über den ESX-Webclient bereitstellen

Führen Sie die folgenden Schritte aus, um Benutzerdaten mithilfe der OVF-Eigenschaft bereitzustellen.
  1. Erstellen Sie eine Datei mit Benutzerdateninhalt.
    Preboot-Benutzerdaten für ESX
  2. Codieren Sie den Benutzerdateninhalt mit Base64-Codierung. Sie können die Base64-Codierung mit den folgenden zwei Methoden durchführen:
    • Unter Linux verwenden Sie den folgenden Befehl:
      base64 <userdata-filename>  >   <outuput-file>
      Beispiel:
      base64 esx_userdata.xml  > esx_userdata_b64Base64-codierte Benutzerdaten
    • Verwenden Sie Online-Tools, um Benutzerdateninhalt zu codieren, zum Beispiel Base64 Encode and Decode.
  3. Fügen Sie einen Product-Abschnitt in die OVF-Vorlage einer NetScaler VPX-Instanz auf dem ESX-Hypervisor ein.
    Beispiel für einen Product-Abschnitt:
    <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. Geben Sie die Base64-codierten Benutzerdaten als ovf:value für die guestinfo.userdata-Eigenschaft im Product-Abschnitt an.
    <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. Verwenden Sie die geänderte OVF-Vorlage mit Product-Abschnitt für die VM-Bereitstellung.
    OVF-Vorlage mit Product-Abschnitt

Benutzerdaten mithilfe der OVF-Eigenschaft über den ESX vSphere Client bereitstellen

Führen Sie die folgenden Schritte aus, um Benutzerdaten mithilfe der OVF-Eigenschaft vom ESX vSphere Client bereitzustellen.
  1. Erstellen Sie eine Datei mit Benutzerdateninhalt.
    Preboot-Benutzerdaten für ESX
  2. Codieren Sie den Benutzerdateninhalt mit Base64-Codierung. Sie können die Base64-Codierung mit den folgenden zwei Methoden durchführen:
    • Unter Linux verwenden Sie den folgenden Befehl:
      base64 <userdata-filename>  >   <outuput-file>
      Beispiel:
      base64 esx_userdata.xml  > esx_userdata_b64Base64-codierte Benutzerdaten
    • Verwenden Sie Online-Tools, um Benutzerdateninhalt zu codieren, zum Beispiel Base64 Encode and Decode.
  3. Fügen Sie einen Product-Abschnitt in die OVF-Vorlage einer NetScaler VPX-Instanz auf dem ESX-Hypervisor ein.
    Beispiel-Product-Abschnitt:
    <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. Geben Sie die Base64-codierten Benutzerdaten als ovf:value für die guestinfo.userdata-Eigenschaft im Product-Abschnitt an.
    <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. Fügen Sie die Eigenschaft ovf:transport="com.vmware.guestInfo" zu VirtualHardwareSection wie folgt hinzu:
    <VirtualHardwareSection  ovf:transport="com.vmware.guestInfo">
  6. Verwenden Sie die geänderte OVF-Vorlage mit Product-Abschnitt für die VM-Bereitstellung.
    OVF-Vorlage mit Product-Abschnitt