|
| 1 | +<?xml version="1.0" encoding="UTF-8"?> |
| 2 | +<!DOCTYPE topic |
| 3 | +[ |
| 4 | + <!ENTITY % entities SYSTEM "../common/generic-entities.ent"> |
| 5 | + %entities; |
| 6 | +]> |
| 7 | +<!-- refers to legacy doc: <add github link to legacy doc piece, if applicable> --> |
| 8 | +<!-- point back to this document with a similar comment added to your legacy doc piece --> |
| 9 | +<!-- refer to README.md for file and id naming conventions --> |
| 10 | +<!-- metadata is dealt with on the assembly level --> |
| 11 | +<topic xml:id="section-create-vm" |
| 12 | + role="task" xml:lang="en" |
| 13 | + xmlns="http://docbook.org/ns/docbook" version="5.2" |
| 14 | + xmlns:its="http://www.w3.org/2005/11/its" |
| 15 | + xmlns:xi="http://www.w3.org/2001/XInclude" |
| 16 | + xmlns:xlink="http://www.w3.org/1999/xlink" |
| 17 | + xmlns:trans="http://docbook.org/ns/transclusion"> |
| 18 | + <info> |
| 19 | + <title>Creating virtual machines using &cockpit;</title> |
| 20 | + <meta name="maintainer" content="shalaka.harne@suse.com" its:translate="no"/> |
| 21 | + <abstract> |
| 22 | + <para>The &cockpit; Web console allows you to create virtual machines.</para> |
| 23 | + </abstract> |
| 24 | + </info> |
| 25 | + <para>To create a virtual machine using &cockpit;:</para> |
| 26 | + <procedure> |
| 27 | + <step> |
| 28 | + <para> |
| 29 | + Navigate to the <guimenu>Virtual machines</guimenu> page. |
| 30 | + </para> |
| 31 | + </step> |
| 32 | + <step> |
| 33 | + <para> |
| 34 | + Click <guimenu>Create VM</guimenu>. |
| 35 | + </para> |
| 36 | + </step> |
| 37 | + <step> |
| 38 | + <para> |
| 39 | + Select the <guilabel>Connection</guilabel> as either <guimenu>System</guimenu> or <guimenu>User session</guimenu>.</para> |
| 40 | + <para>For more information on the connections, click the information icon next to <guimenu>Connection</guimenu>.</para> |
| 41 | + </step> |
| 42 | + <step><para>Select an installation type from the drop-down list and proceed with creating the VM.</para> |
| 43 | + <itemizedlist> |
| 44 | + <listitem><para><xref linkend="download-OS"/></para> |
| 45 | + <para>For this installation type, &cockpit; provides a list of popular Linux distributions (Fedora, Ubuntu, Rocky Linux, etc.). It automatically downloads the official ISO and starts the installer.</para></listitem> |
| 46 | + <listitem><para><xref linkend="cloud-base-image"/></para> |
| 47 | + <para>For this installation type, you create a virtual machine from the cloud image file on the host's file system. You must provide the path to the file for this. This installation type supports unattended installation, where you can pre-fill a username, password, and SSH key in &cockpit;. The VM then boots and configures itself automatically.</para></listitem> |
| 48 | + <listitem><para><xref linkend="local-install-media"/></para> |
| 49 | + <para>For this installation type, you manually provide a path to an .iso file already stored on your server’s hard drive.</para></listitem> |
| 50 | + <listitem><para><xref linkend="URL"/></para> |
| 51 | + <para>For this installation type, you provide a Web link to an installation tree (common for automated network installs).</para></listitem> |
| 52 | + <listitem><para><xref linkend="network-boot-PXE"/></para> |
| 53 | + <para>For this installation type, the system boots the VM from a network server. This is typically used in enterprise environments with existing deployment infrastructure.</para></listitem> |
| 54 | + </itemizedlist> |
| 55 | + </step> |
| 56 | + </procedure> |
| 57 | + <section xml:id="download-OS"><title >Download an OS</title> |
| 58 | + <para> |
| 59 | + You can select <guilabel>Download an OS</guilabel> to create a VM with your preferred OS. &cockpit; provides a list of popular Linux distributions (like OpenSUSE Leap, Fedora, Ubuntu, or CentOS). When you select the distribution, &cockpit; downloads the official ISO image from the internet and creates a VM based on the given configurations. </para> |
| 60 | + <procedure> |
| 61 | + <step><para>Select the distribution from the <guilabel>Operating system</guilabel> drop-down list.</para></step> |
| 62 | + <step> |
| 63 | + <para> |
| 64 | + Define the <guimenu>Storage limit</guimenu> and <guimenu>Memory</guimenu>.</para> |
| 65 | + <para>The available storage limit and memory are displayed so that you can configure the storage limit and memory accordingly. </para> |
| 66 | + </step> |
| 67 | + <step> |
| 68 | + <para>To run the VM after creation, click <guimenu>Create and run</guimenu>.</para> |
| 69 | + <para>The virtual machine has been installed.</para> |
| 70 | + </step> |
| 71 | + <step><para>To edit the VM parameters after creation, click <guimenu>Create and edit</guimenu>.</para> |
| 72 | + <para>Modify the parameters and click <guimenu>Install</guimenu>.</para> |
| 73 | + <para>For more information on modifying the parameters, see <xref linkend="task-managing-vm-cockpit"/>.</para></step> |
| 74 | + </procedure></section> |
| 75 | + |
| 76 | + <section xml:id="cloud-base-image"><title>Cloud base image</title> |
| 77 | + <para> |
| 78 | + You can create a virtual machine from the cloud image file on the host's file system. You must provide the path to the file for this. This installation type supports unattended installation, where you can pre-fill a username, password, and SSH key in &cockpit;. The VM then boots and configures itself automatically. |
| 79 | + </para> |
| 80 | + <procedure> |
| 81 | + <step><para>Select the path to the cloud image file on the host's file system from the <guilabel>Installation source</guilabel> drop-down list.</para> |
| 82 | + </step> |
| 83 | + <step><para>Select the distribution from the <guilabel>Operating system</guilabel> drop-down list.</para></step> |
| 84 | + <step> |
| 85 | + <para> |
| 86 | + Define the <guimenu>Storage limit</guimenu> and <guimenu>Memory</guimenu>.</para> |
| 87 | + <para>The available storage limit and memory are displayed so that you can configure the storage limit and memory accordingly. </para> |
| 88 | + </step> |
| 89 | + <step> |
| 90 | + <para>To run the VM after creation, click <guimenu>Create and run</guimenu>.</para> |
| 91 | + <para>The virtual machine has been installed.</para> |
| 92 | + </step> |
| 93 | + <step><para>To edit the VM parameters after creation, click <guimenu>Create and edit</guimenu>.</para> |
| 94 | + <para>Modify the parameters and click <guimenu>Install</guimenu>.</para> |
| 95 | + <para>For more information on modifying the parameters, see <xref linkend="task-managing-vm-cockpit"/>.</para></step> |
| 96 | + </procedure></section> |
| 97 | + <section xml:id="local-install-media"><title>Local installation media (ISO image or distro install tree)</title> |
| 98 | + <para> |
| 99 | + You can create a VM from the local installation media using the path to the ISO file on the host's file system. In this, you must provide the direct file path in which the ISO image is stored, and the VM boots from that local file and begins the installation. |
| 100 | + </para> |
| 101 | + <procedure> |
| 102 | + <step><para>Select the path to the ISO file on the host's file system from the <guilabel>Installation source</guilabel> drop-down list.</para> |
| 103 | + </step> |
| 104 | + <step><para>Select the distribution from the <guilabel>Operating system</guilabel> drop-down list.</para></step> |
| 105 | + <step> |
| 106 | + <para> |
| 107 | + Define the <guimenu>Storage limit</guimenu> and <guimenu>Memory</guimenu>.</para> |
| 108 | + <para>The available storage limit and memory are displayed so that you can configure the storage limit and memory accordingly. </para> |
| 109 | + </step> |
| 110 | + <step> |
| 111 | + <para>To run the VM after creation, click <guimenu>Create and run</guimenu>.</para> |
| 112 | + <para>The virtual machine has been installed.</para> |
| 113 | + </step> |
| 114 | + <step><para>To edit the VM parameters after creation, click <guimenu>Create and edit</guimenu>.</para> |
| 115 | + <para>Modify the parameters and click <guimenu>Install</guimenu>.</para> |
| 116 | + <para>For more information on modifying the parameters, see <xref linkend="task-managing-vm-cockpit"/>.</para></step> |
| 117 | + </procedure></section> |
| 118 | + <section xml:id="URL"><title>URL (ISO image or distro install tree)</title> |
| 119 | + <para> |
| 120 | + You can create a virtual machine by downloading the OS from a URL of the ISO image or distro install tree. In this type of installation, you can point the VM to a remote installation source via a web link (HTTP/HTTPS/FTP). It is particularly useful for network-based installations where the host doesn't have the image saved locally but can pull the necessary boot files directly from a public or private mirror. |
| 121 | + </para> |
| 122 | + <procedure> |
| 123 | + <step><para>Specify the URL of the ISO file in the <guilabel>Installation source</guilabel>.</para> |
| 124 | + </step> |
| 125 | + <step><para>Select the distribution from the <guilabel>Operating system</guilabel> drop-down list.</para></step> |
| 126 | + <step> |
| 127 | + <para> |
| 128 | + Define the <guimenu>Storage limit</guimenu> and <guimenu>Memory</guimenu>.</para> |
| 129 | + <para>The available storage limit and memory are displayed so that you can configure the storage limit and memory accordingly. </para> |
| 130 | + </step> |
| 131 | + <step> |
| 132 | + <para>To run the VM after creation, click <guimenu>Create and run</guimenu>.</para> |
| 133 | + <para>The virtual machine has been installed.</para> |
| 134 | + </step> |
| 135 | + <step><para>To edit the VM parameters after creation, click <guimenu>Create and edit</guimenu>.</para> |
| 136 | + <para>Modify the parameters and click <guimenu>Install</guimenu>.</para> |
| 137 | + <para>For more information on modifying the parameters, see <xref linkend="task-managing-vm-cockpit"/>.</para></step> |
| 138 | + </procedure></section> |
| 139 | + <section xml:id="network-boot-PXE"><title>Network boot (PXE)</title> |
| 140 | + <para> |
| 141 | + You can create a VM by installing the OS over the network using the Network boot PXE (Preboot eXecution Environment). In this type of installation, the VM starts without a local OS and requests boot files from a PXE server over the network. The PXE server supplies the bootloader, kernel, initrd, and OS installation files, allowing the operating system to install directly from the network. |
| 142 | + </para> |
| 143 | + <procedure> |
| 144 | + <step><para>Select the installation source from the <guilabel>Installation source</guilabel> drop-down list.</para> |
| 145 | + </step> |
| 146 | + <step><para>Select the distribution from the <guilabel>Operating system</guilabel> drop-down list.</para></step> |
| 147 | + <step> |
| 148 | + <para> |
| 149 | + Define the <guimenu>Storage limit</guimenu> and <guimenu>Memory</guimenu>.</para> |
| 150 | + <para>The available storage limit and memory are displayed so that you can configure the storage limit and memory accordingly. </para> |
| 151 | + </step> |
| 152 | + <step> |
| 153 | + <para>To run the VM after creation, click <guimenu>Create and run</guimenu>.</para> |
| 154 | + <para>The virtual machine has been installed.</para> |
| 155 | + </step> |
| 156 | + <step><para>To edit the VM parameters after creation, click <guimenu>Create and edit</guimenu>.</para> |
| 157 | + <para>Modify the parameters and click <guimenu>Install</guimenu>.</para> |
| 158 | + <para>For more information on modifying the parameters, see <xref linkend="task-managing-vm-cockpit"/>.</para></step> |
| 159 | + </procedure></section> |
| 160 | +</topic> |
0 commit comments