VirtualBox

Changeset 95209 in vbox for trunk/doc/manual/en_US


Ignore:
Timestamp:
Jun 6, 2022 5:50:37 PM (2 years ago)
Author:
vboxsync
Message:

Docs: Updating manual section for the new vm wizard. Needs proof reading. ​bugref:10236

Location:
trunk/doc/manual/en_US
Files:
3 edited

Legend:

Unmodified
Added
Removed

  • trunk/doc/manual/en_US/user_Introduction.xml

    r88089 r95209  
    981981
    982982    <para>
    983       Click <emphasis role="bold">New</emphasis> in the VirtualBox
    984       Manager window. A wizard is shown, to guide you through setting up
    985       a new virtual machine (VM).
     983      Selecting <emphasis role="bold">New</emphasis> menu item from
     984      <emphasis role="bold">Machine</emphasis> menu of the Manager Window
     985      shows a wizard which guides you through setting up a new virtual
     986      machine (VM).
    986987    </para>
    987988
    … …  
    10031004
    10041005    <orderedlist>
    1005 
    1006       <listitem>
    1007         <para>
    1008           The <emphasis role="bold">Name</emphasis> of the VM you choose
    1009           is shown in the machine list of the VirtualBox Manager window
    1010           and is also used for the VM's files on disk.
    1011         </para>
    1012 
    1013         <para>
    1014           Be sure to assign each VM an informative name that describes
    1015           the OS and software running on the VM. For example,
    1016           <literal>Windows 10 with Visio</literal>.
    1017         </para>
    1018       </listitem>
    1019 
    1020       <listitem>
    1021         <para>
    1022           The <emphasis role="bold">Machine Folder</emphasis> is the
    1023           location where VMs are stored on your computer. The default
    1024           folder location is shown.
    1025         </para>
    1026       </listitem>
    1027 
    1028       <listitem>
    1029         <para>
    1030           For <emphasis role="bold">Operating System Type</emphasis>,
    1031           select the OS that you want to install. The supported OSes are
    1032           grouped. If you want to install something very unusual that is
    1033           not listed, select <emphasis role="bold">Other</emphasis>.
    1034           Depending on your selection, &product-name; will enable or
    1035           disable certain VM settings that your guest OS may require.
    1036           This is particularly important for 64-bit guests. See
    1037           <xref linkend="intro-64bitguests" />. It is therefore
    1038           recommended to always set it to the correct value.
    1039         </para>
    1040       </listitem>
    1041 
    1042       <listitem>
    1043         <para>
    1044           On the next page, select the <emphasis role="bold">Memory
    1045           (RAM)</emphasis> that &product-name; should allocate every
     1006      <listitem>
     1007        <para>
     1008          The first page lets you specify name, location, and guest
     1009          operating system type. Additionally you can enable the unattended
     1010          guest operating system install feature (<xref linkend="gui-wizard-unattended"/>.).
     1011        </para>
     1012        <itemizedlist>
     1013          <listitem>
     1014            <para>
     1015              The <emphasis role="bold">Name</emphasis> of the VM you choose
     1016              is shown in the machine list of the VirtualBox Manager window
     1017              and is also used for the VM's files on disk.
     1018            </para>
     1019            <para>
     1020              Be sure to assign each VM an informative name that describes
     1021              the OS and software running on the VM. For example,
     1022              <literal>Windows 10 with Visio</literal>.
     1023            </para>
     1024          </listitem>
     1025          <listitem>
     1026            <para>
     1027              The <emphasis role="bold">Folder</emphasis> is the location
     1028              where VMs are stored on your computer. The default folder
     1029              location is shown.
     1030            </para>
     1031          </listitem>
     1032          <listitem>
     1033            <para>
     1034              The <emphasis role="bold">ISO Image</emphasis> is ISO file which
     1035              may be used to install the guest operating system or to be attached
     1036              to DVD drive of the new virtual machine. Note that selecting
     1037              an ISO image is optional. Please see the section <xref linkend="gui-wizard-unattended"/>.
     1038            </para>
     1039          </listitem>
     1040          <listitem>
     1041            <para>
     1042              For <emphasis role="bold">Type</emphasis>,
     1043              select the OS that you want to install. The supported OSes are
     1044              grouped. If you want to install something very unusual that is
     1045              not listed, select <emphasis role="bold">Other</emphasis>.
     1046              Depending on your selection, &product-name; will enable or
     1047              disable certain VM settings that your guest OS may require.
     1048              This is particularly important for 64-bit guests. See
     1049              <xref linkend="intro-64bitguests" />. It is therefore
     1050              recommended to always set it to the correct value. Also note
     1051              that if an ISO image is selected and &product-name; is able to detect
     1052              an operating system from that ISO, <emphasis role="bold">Type</emphasis>
     1053              and <emphasis role="bold">Version</emphasis> controls are populated
     1054              accordingly and disabled.
     1055            </para>
     1056          </listitem>
     1057          <listitem>
     1058            <para>
     1059              The checkox <emphasis role="bold">Skip Unattended Installation</emphasis>
     1060              can be used to disable unattended guest OS installation even if an ISO
     1061              image is selected that supports unattended install. In that case the
     1062              selected ISO image is inserted DVD drive of the new virtual machine.
     1063            </para>
     1064          </listitem>
     1065        </itemizedlist>
     1066      </listitem>
     1067      <listitem>
     1068        <para>
     1069          If unattended install is enabled then the second page of the wizard
     1070          will show some controls which can be used to input values needed during
     1071          unattended installation. These include username, password, host name,
     1072          product key (only applies to some guest operating system type), etc.
     1073          If for some reason unattended install is not enabled, this page is
     1074          skipped.
     1075        </para>
     1076      </listitem>
     1077      <listitem>
     1078        <para>
     1079          On the next page, select the <emphasis role="bold">Base Memory
     1080          </emphasis> that &product-name; should allocate every
    10461081          time the virtual machine is started. The amount of memory
    10471082          given here will be taken away from your host machine and
    10481083          presented to the guest OS, which will report this size as the
    1049           virtual computer's installed RAM.
    1050         </para>
    1051 
     1084          virtual computer's installed RAM. <emphasis role="bold">Processor(s)
     1085          </emphasis> control determines how many virtual processors are to be
     1086          assigned to new virtual machine.
     1087        </para>
    10521088        <caution>
    10531089          <para>
    … …  
    10551091            will not be available to your host OS while the VM is
    10561092            running, so do not specify more than you can spare.
    1057           </para>
    1058 
     1093            Also note that it is not advised to assign more than
     1094            half of the processor threads the host machine has.
     1095          </para>
    10591096          <para>
    10601097            For example, if your host machine has 4 GB of RAM and you
    … …  
    10661103            that memory is not available.
    10671104          </para>
    1068 
    10691105          <para>
    10701106            On the other hand, you should specify as much as your guest
    … …  
    10751111          </para>
    10761112        </caution>
    1077 
    10781113        <para>
    10791114          Always ensure that the host OS has enough RAM remaining. If
    … …  
    10821117          system to a standstill.
    10831118        </para>
    1084 
    10851119        <para>
    10861120          As with the other settings, you can change this setting later,
    … …  
    10881122        </para>
    10891123      </listitem>
    1090 
    1091       <listitem>
     1124       <listitem>
    10921125        <para>
    10931126          Next, you must specify a <emphasis role="bold">Virtual Hard
    10941127          Disk</emphasis> for your VM.
    10951128        </para>
    1096 
    10971129        <para>
    10981130          There are many and potentially complicated ways in which
    … …  
    11051137          &product-name; installation.
    11061138        </para>
    1107 
    1108         <para>
    1109           The wizard displays the following window:
    1110         </para>
    1111 
     1139        <para>
     1140          The wizard displays the following page:
     1141        </para>
    11121142        <figure id="fig-new-vm-hard-disk">
    11131143          <title>Creating a New Virtual Machine: Hard Disk</title>
    … …  
    11191149          </mediaobject>
    11201150        </figure>
    1121 
    11221151        <para>
    11231152          At this screen, you have the following options:
    11241153        </para>
    1125 
    11261154        <itemizedlist>
    1127 
    1128           <listitem>
    1129             <para>
    1130               To create a new, empty virtual hard disk, click the
    1131               <emphasis role="bold">Create</emphasis> button.
    1132             </para>
    1133           </listitem>
    1134 
    1135           <listitem>
    1136             <para>
    1137               You can pick an <emphasis>existing</emphasis> disk image
    1138               file.
     1155        <listitem>
     1156          <para>
     1157            To create a new, empty virtual hard disk, please select
     1158            <emphasis role="bold">Create a Virtual Hard Disk Now</emphasis>.
     1159            This will create a new disk image file in the new virtual
     1160            machine's folder.
     1161          </para>
     1162          <para>
     1163            The checkbox <emphasis role="bold">Pre-allocate Full Size</emphasis>
     1164            is initially not checked. This results in having a so called
     1165            <emphasis role="bold">dynamically allocated file</emphasis>
     1166            which only grows in size when the guest actually
     1167            stores data on its virtual hard disk. Therefore, this file
     1168            is small initially. As the drive is filled with data, the
     1169            file grows to the specified size. When the mentioned checkbox
     1170            is checked then &product-name; creates a
     1171            <emphasis role="bold">fixed-size file</emphasis> which
     1172            immediately occupies the file specified, even if only a
     1173            fraction of that virtual hard disk space is actually in
     1174            use. While occupying much more space, a fixed-size file
     1175            incurs less overhead and is therefore slightly faster than
     1176            a dynamically allocated file.
     1177          </para>
     1178          <para>
     1179            For more details on the differences between
     1180            <emphasis role="bold">dynamically allocated file</emphasis> and
     1181            <emphasis role="bold">fixed-size file</emphasis> please  see
     1182            <xref linkend="vdidetails" />.
     1183          </para>
     1184          <para>
     1185            To prevent your physical hard disk (host OS) from filling up,
     1186            &product-name; limits the size of the image file. But the
     1187            image file must be large enough to hold the contents of the
     1188            guest OS and the applications you want to install. For a
     1189            Windows or Linux guest, you will probably need several
     1190            gigabytes for any serious use. The limit of the image file
     1191            size can be changed later, see
     1192            <xref linkend="vboxmanage-modifymedium"/>.
     1193          </para>
     1194        </listitem>
     1195        <listitem>
     1196            <para>
     1197              You can pick an existing disk image
     1198              file by selecting <emphasis role="bold">Use
     1199              a Existing Virtual Hard Disk File </emphasis>.
    11391200            </para>
    11401201
    … …  
    11541215            </para>
    11551216          </listitem>
    1156 
    1157         </itemizedlist>
    1158 
     1217          <listitem>
     1218            <para>
     1219              You can skip attaching a virtual hard disk file to the
     1220              new virtual machine you are creating. Note that you will
     1221              need to attach an hard disk later on in order to install a
     1222              guest operating system.
     1223            </para>
     1224          </listitem>
     1225      </itemizedlist>
    11591226        <para>
    11601227          If you are using &product-name; for the first time, you will
    1161           want to create a new disk image. Click the
    1162           <emphasis role="bold">Create</emphasis> button.
    1163         </para>
    1164 
    1165         <para>
    1166           This displays another window, the <emphasis role="bold">Create
    1167           Virtual Hard Disk Wizard</emphasis> wizard. This wizard helps
    1168           you to create a new disk image file in the new virtual
    1169           machine's folder.
    1170         </para>
    1171 
    1172         <para>
    1173           &product-name; supports the following types of image files:
    1174         </para>
    1175 
    1176         <itemizedlist>
    1177 
    1178           <listitem>
    1179             <para>
    1180               A <emphasis role="bold">dynamically allocated
    1181               file</emphasis> only grows in size when the guest actually
    1182               stores data on its virtual hard disk. Therefore, this file
    1183               is small initially. As the drive is filled with data, the
    1184               file grows to the specified size.
    1185             </para>
    1186           </listitem>
    1187 
    1188           <listitem>
    1189             <para>
    1190               A <emphasis role="bold">fixed-size file</emphasis>
    1191               immediately occupies the file specified, even if only a
    1192               fraction of that virtual hard disk space is actually in
    1193               use. While occupying much more space, a fixed-size file
    1194               incurs less overhead and is therefore slightly faster than
    1195               a dynamically allocated file.
    1196             </para>
    1197           </listitem>
    1198 
    1199         </itemizedlist>
    1200 
    1201         <para>
    1202           For details about the differences, see
    1203           <xref linkend="vdidetails" />.
    1204         </para>
    1205 
    1206         <para>
    1207           To prevent your physical hard disk (host OS) from filling up,
    1208           &product-name; limits the size of the image file. But the
    1209           image file must be large enough to hold the contents of the
    1210           guest OS and the applications you want to install. For a
    1211           Windows or Linux guest, you will probably need several
    1212           gigabytes for any serious use. The limit of the image file
    1213           size can be changed later, see
    1214           <xref linkend="vboxmanage-modifymedium"/>.
    1215         </para>
    1216 
    1217         <figure id="fig-new-vm-vdi">
    1218           <title>Creating a New Virtual Machine: File Location and Size</title>
    1219         <mediaobject>
    1220             <imageobject>
    1221               <imagedata align="center" fileref="images/create-vdi-1.png"
    1222                          width="10cm" />
    1223             </imageobject>
    1224           </mediaobject>
    1225         </figure>
    1226 
     1228          want to create a new disk image. Select
     1229          <emphasis role="bold">Create a Virtual Hard Disk Now</emphasis> button.
     1230        </para>
    12271231        <para>
    12281232          After having selected or created your image file, click
    … …  
    12301234        </para>
    12311235      </listitem>
    1232 
    1233       <listitem>
    1234         <para>
    1235           Click <emphasis role="bold">Create</emphasis>, to create your
    1236           new virtual machine. The virtual machine is displayed in the
    1237           list on the left side of the VirtualBox Manager window, with
     1236      <listitem>
     1237        <para>The next page summarizes several attributes of the virtual
     1238        machine to be created. If you are not appy if any of them you
     1239        can use <emphasis role="bold">Back</emphasis> button to go
     1240        back to corresponding page to modify it.</para>
     1241        <para>
     1242          Alternatively you can click <emphasis role="bold">Finish</emphasis>,
     1243          to create your new virtual machine. The virtual machine is displayed
     1244          in the list on the left side of the VirtualBox Manager window, with
    12381245          the name that you entered initially.
    12391246        </para>
    12401247      </listitem>
    1241 
    12421248    </orderedlist>
    1243 
    12441249    <note>
    12451250      <para>
    … …  
    12501255      </para>
    12511256    </note>
    1252 
     1257    <sect2 id="gui-wizard-unattended">
     1258      <title>Unattended Install</title>
     1259      <para>
     1260        When supported by the selected ISO &product-name; attempts to install
     1261        the guest OS without any user input. When an ISO image is selected
     1262        &product-name; tries to determine type of the OS. If this succeeds and
     1263        if the selected OS is supported for the unattended install then the
     1264        newly created virtual machine is started after this wizard is closed
     1265        and OS install kicks off. Note that it is also possible to skip the
     1266        unattended install by ticking the checkbox "Skip unattended installation".
     1267        In this case the selected ISO is inserted to DVD drive of the new vm. The
     1268        guest OS will need to be installed manually. If OS cannot be determined
     1269        from the selected ISO or determined OS is not supported for the unattended
     1270        installation then again ISO is inserted to the DVD drive of the new virtual
     1271        machine and a manual guest OS install will be necessary.
     1272      </para>
     1273    </sect2>
    12531274  </sect1>
    12541275
Note: See TracChangeset for help on using the changeset viewer.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette