pick-23 pick-24 moved instructions for virtualbox down to new section testing_purposes

Author: sebkir

src/onprem/de/appliance_install_virt1.asciidoc

@@ -3,7 +3,6 @@
 // SKIPCOMMITS 2025-07-31
 include::global_attr.adoc[]
 = Virtuelle Appliance installieren
-:revdate: 2025-07-23
 :title: Virtuelle Appliance installieren
 :description: Die virtuelle {CMK} Appliance können Sie in VirtualBox, Hyper-V, Proxmox oder VMware ESXi einrichten. Lesen Sie hier, was es jeweils zu beachten gilt.
 :experimental:
@@ -57,40 +56,6 @@ Die CMA-Datei benötigen Sie erst *nach* abgeschlossener Installation -- wenn Si
 Laden Sie die OVA-Datei für die Erstinstallation der virtuellen Appliance herunter.
 
 
-[#install_virtualbox]
-== Installation in VirtualBox
-
-=== Voraussetzungen
-
-Für die folgenden Schritte benötigen Sie außer der OVA-Datei eine laufende VirtualBox-Installation.
-Auf welchem System VirtualBox läuft, spielt dabei keine Rolle.
-
-
-=== Import der Appliance
-
-Starten Sie den Import der OVA-Datei über [.guihint]#File > Import Appliance# und wählen Sie die OVA-Datei aus.
-Sie sehen anschließend alle Einstellungen der virtuellen Maschine -- und können diese auch so belassen.
-Freilich können Sie an diesem Punkt oder nachträglich Werte ändern, um der Maschine etwa weitere Ressourcen zuzuschreiben.
-
-*Wichtig:* Bei den Appliance-Einstellungen sollten Sie unter [.guihint]#MAC Address Policy# dringend die Option [.guihint]#Generate new MAC addresses for all network adapters# wählen.
-Andernfalls wird es zu Problemen kommen, wenn mehrere Appliances mit derselben MAC-Adresse im Netzwerk laufen.
-
-[{image-border}]
-image::virt1_virtualbox_import.png[]
-
-Sie können die Appliance nun importieren.
-
-Nach dem Import müssen Sie noch einen weiteren Schritt durchführen:
-Rufen Sie die Netzwerkkonfiguration der virtuellen Maschine auf.
-Der Modus ist hier auf [.guihint]#Bridged Adapter# gesetzt:
-Der virtuelle Netzwerkadapter wird dabei mit einem Adapter auf Ihrem Host verbunden -- und die variieren natürlich.
-Im Zweifelsfall verlassen Sie die Konfiguration einfach ohne Änderung mit [.guihint]#OK# -- VirtualBox ergänzt den fehlenden Adapternamen dann automatisch mit Ihrem Standardadapter.
-
-image::virt1_virtualbox_network.png[width=90%]
-
-Damit haben Sie die VirtualBox-spezifischen Schritte abgeschlossen.
-
-
 [#install_esxi]
 == Installation in VMware ESXi
 
@@ -282,3 +247,45 @@ image::appliance_install_virt1_proxmox_boot_order.png[width=88%]
 
 Damit haben Sie die Proxmox-spezifischen Schritte abgeschlossen.
 Ihre Appliance ist jetzt startklar und Sie können mit der xref:appliance_usage#basic_config[Grundkonfiguration] beginnen.
+
+
+[#testing_purposes]
+== Installation für Testzwecke
+
+Die folgenden Umgebungen sollten nicht produktiv eingesetzt werden.
+Wir bieten diese Installationsanleitungen ausschließlich für den Zweck an, eine (ggf. eingeschränkt lauffähige) Test-Instanz von {CMK} zu erzeugen.
+
+
+[#install_virtualbox]
+=== Installation in VirtualBox
+
+
+==== Voraussetzungen
+
+Für die folgenden Schritte benötigen Sie außer der OVA-Datei eine laufende VirtualBox-Installation.
+Auf welchem System VirtualBox läuft, spielt dabei keine Rolle.
+
+==== Import der Appliance
+
+Starten Sie den Import der OVA-Datei über [.guihint]#File > Import Appliance# und wählen Sie die OVA-Datei aus.
+Sie sehen anschließend alle Einstellungen der virtuellen Maschine -- und können diese auch so belassen.
+Freilich können Sie an diesem Punkt oder nachträglich Werte ändern, um der Maschine etwa weitere Ressourcen zuzuschreiben.
+
+*Wichtig:* Bei den Appliance-Einstellungen sollten Sie unter [.guihint]#MAC Address Policy# dringend die Option [.guihint]#Generate new MAC addresses for all network adapters# wählen.
+Andernfalls wird es zu Problemen kommen, wenn mehrere Appliances mit derselben MAC-Adresse im Netzwerk laufen.
+
+[{image-border}]
+image::virt1_virtualbox_import.png[]
+
+Sie können die Appliance nun importieren.
+
+Nach dem Import müssen Sie noch einen weiteren Schritt durchführen:
+Rufen Sie die Netzwerkkonfiguration der virtuellen Maschine auf.
+Der Modus ist hier auf [.guihint]#Bridged Adapter# gesetzt:
+Der virtuelle Netzwerkadapter wird dabei mit einem Adapter auf Ihrem Host verbunden -- und die variieren natürlich.
+Im Zweifelsfall verlassen Sie die Konfiguration einfach ohne Änderung mit [.guihint]#OK# -- VirtualBox ergänzt den fehlenden Adapternamen dann automatisch mit Ihrem Standardadapter.
+
+image::virt1_virtualbox_network.png[width=90%]
+
+Damit haben Sie die VirtualBox-spezifischen Schritte abgeschlossen.
+Ihre Test-Appliance ist jetzt startklar und Sie können mit der xref:appliance_usage#basic_config[Grundkonfiguration] beginnen.

src/onprem/en/appliance_install_virt1.asciidoc

@@ -3,7 +3,6 @@
 // SKIPCOMMITS 2025-09-19
 include::global_attr.adoc[]
 = Installation of the virtual appliance
-:revdate: 2025-07-23
 :title: Installation of the virtual appliance
 :description: You can set up the virtual {CMK} Appliance within VirtualBox, Hyper-V, Proxmox or VMware ESXi. Read here what to keep in mind in each case.
 :experimental:
@@ -56,40 +55,6 @@ You will only need the CMA file *after* the installation has been completed -- w
 Download the OVA file for the initial installation of the virtual appliance.
 
 
-[#install_virtualbox]
-== Installation in VirtualBox
-
-=== Prerequisites
-
-For the following steps, you will need a functioning VirtualBox installation in addition to the OVA file.
-It does not matter on which system VirtualBox is running.
-
-
-=== Importing the appliance
-
-Start the import of the OVA file via [.guihint]#File > Import Appliance# and select the OVA file.
-You will then see all of the settings for the virtual machine -- and you can leave these as they are for now.
-You can, of course, modify values at this point or later, for example, to assign additional resources to the machine.
-
-*Important:* In the appliance settings, you should always select the [.guihint]#Generate new MAC addresses for all network adapters# option under [.guihint]#MAC Address Policy#.
-Otherwise, there will be problems if more than one appliance with the same MAC address is running on the network.
-
-[{image-border}]
-image::virt1_virtualbox_import.png[]
-
-You can now import the appliance.
-
-Following the import, you will still need to carry out one more step:
-Call up the network configuration for the virtual machine.
-The mode here is set to [.guihint]#Bridged Adapter#:
-The virtual network adapter is thereby connected to an adapter on your host -- and of course these will vary.
-If in doubt, simply exit the configuration without changing it by pressing [.guihint]#OK# -- VirtualBox will then automatically fill in the missing adapter name with your default adapter.
-
-image::virt1_virtualbox_network.png[width=90%]
-
-You have now completed the VirtualBox-specific steps.
-
-
 [#install_esxi]
 == Installation in VMware ESXi
 
@@ -281,3 +246,45 @@ image::appliance_install_virt1_proxmox_boot_order.png[width=88%]
 
 You have now completed the Proxmox-specific steps.
 Your appliance is now ready to start and you can begin with its xref:appliance_usage#basic_config[basic configuration].
+
+
+[#testing_purposes]
+== Installation for testing purposes
+
+The following environments should not be used productively.
+We provide these installation instructions solely for the purpose of creating a (possibly limited) test instance of {CMK}.
+
+
+[#install_virtualbox]
+=== Installation in VirtualBox
+
+
+==== Prerequisites
+
+For the following steps, you will need a functioning VirtualBox installation in addition to the OVA file.
+It does not matter on which system VirtualBox is running.
+
+==== Importing the appliance
+
+Start the import of the OVA file via [.guihint]#File > Import Appliance# and select the OVA file.
+You will then see all of the settings for the virtual machine -- and you can leave these as they are for now.
+You can, of course, modify values at this point or later, for example, to assign additional resources to the machine.
+
+*Important:* In the appliance settings, you should always select the [.guihint]#Generate new MAC addresses for all network adapters# option under [.guihint]#MAC Address Policy#.
+Otherwise, there will be problems if more than one appliance with the same MAC address is running on the network.
+
+[{image-border}]
+image::virt1_virtualbox_import.png[]
+
+You can now import the appliance.
+
+Following the import, you will still need to carry out one more step:
+Call up the network configuration for the virtual machine.
+The mode here is set to [.guihint]#Bridged Adapter#:
+The virtual network adapter is thereby connected to an adapter on your host -- and of course these will vary.
+If in doubt, simply exit the configuration without changing it by pressing [.guihint]#OK# -- VirtualBox will then automatically fill in the missing adapter name with your default adapter.
+
+image::virt1_virtualbox_network.png[width=90%]
+
+You have now completed the VirtualBox-specific steps.
+Your test appliance is now ready to start and you can begin with its xref:appliance_usage#basic_config[basic configuration].