VirtualBox

Ignore:
Timestamp:
Oct 6, 2022 3:11:29 PM (2 years ago)
Author:
vboxsync
Message:

doc/manual: Integrate documentation update.

File:
1 edited

Legend:

Unmodified
Added
Removed

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

    r96856 r97032  
    122122          <row>
    123123            <entry><para>
     124                Windows 11 (64-bit)
     125              </para></entry>
     126            <entry><para>
     127                Insider preview builds are not supported
     128              </para></entry>
     129          </row>
     130          <row>
     131            <entry><para>
    124132                Windows 10 (32-bit and 64-bit)
    125133              </para></entry>
    … …  
    392400          for virtual machines that you intend to use in 64-bit mode.
    393401          This is especially true for 64-bit Windows VMs. See
    394           <xref linkend="settings-general-advanced" />. For 64-bit
    395           Windows guests, ensure that the VM uses the
     402          <xref linkend="settings-motherboard" />. For 64-bit Windows
     403          guests, ensure that the VM uses the
    396404          <emphasis role="bold">Intel networking device</emphasis>
    397405          because there is no 64-bit driver support for the AMD PCNet
    … …  
    402410      <para>
    403411        If you use the <emphasis role="bold">Create VM</emphasis> wizard
    404         of the VirtualBox Manager, &product-name; automatically uses the
    405         correct settings for each selected 64-bit OS type. See
    406         <xref linkend="gui-createvm" />.
     412        of &vbox-mgr;, &product-name; automatically uses the correct
     413        settings for each selected 64-bit OS type. See
     414        <xref linkend="create-vm-wizard" />.
    407415      </para>
    408416
    … …  
    422430
    423431    <para>
    424       Performing an unattended guest installation involves the following
    425       steps:
     432      You can perform an unattended guest installation in the following
     433      ways:
    426434    </para>
    427435
    … …  
    430438      <listitem>
    431439        <para>
    432           <emphasis role="bold">Create a new VM.</emphasis> Use one of
    433           the following methods:
    434         </para>
    435 
    436         <itemizedlist>
    437 
    438           <listitem>
    439             <para>
    440               The VirtualBox Manager, see
    441               <xref linkend="gui-createvm" />.
    442             </para>
    443           </listitem>
    444 
    445           <listitem>
    446             <para>
    447               The <command>VBoxManage createvm</command> command, see
    448               <xref linkend="vboxmanage-createvm" />.
    449             </para>
    450           </listitem>
    451 
    452         </itemizedlist>
    453 
    454         <para>
    455           For the new VM, choose the guest OS type and accept the
    456           default settings for that OS. The following sections in this
    457           chapter describe how to change the settings for a VM.
    458         </para>
    459       </listitem>
    460 
    461       <listitem>
    462         <para>
    463           <emphasis role="bold">Prepare the VM for unattended guest
    464           installation.</emphasis> Use the <command>VBoxManage
    465           unattended</command> command, see
    466           <xref linkend="vboxmanage-unattended" />.
     440          <emphasis role="bold">Use the Create Virtual Machine
     441          wizard.</emphasis> An optional step in the wizard enables you
     442          to configure unattended installation. You can specify the
     443          default user credentials for the guest OS and also whether to
     444          install the Guest Additions automatically. See
     445          <xref linkend="create-vm-wizard"/>.
    467446        </para>
    468447
    … …  
    476455      <listitem>
    477456        <para>
    478           <emphasis role="bold">Start the VM.</emphasis> Use the
    479           VirtualBox Manager or the <command>VBoxManage
    480           startvm</command> command.
    481         </para>
    482 
    483         <para>
    484           When you start the VM, the unattended installation is
    485           performed automatically.
    486         </para>
    487 
    488         <para>
    489           The installation operation changes the boot device order to
    490           boot the virtual hard disk first and then the virtual DVD
    491           drive. If the virtual hard disk is empty prior to the
    492           automatic installation, the VM boots from the virtual DVD
    493           drive and begins the installation.
    494         </para>
    495 
    496         <para>
    497           If the virtual hard disk contains a bootable OS, the
    498           installation operation exits. In this case, change the boot
    499           device order manually by pressing F12 during the BIOS splash
    500           screen.
     457          <emphasis role="bold">Use the <command>VBoxManage</command>
     458          commands.</emphasis>
     459          <xref linkend="unattended-guest-install-example"/> describes
     460          how to perform an unattended guest installation for an Oracle
     461          Linux guest.
    501462        </para>
    502463      </listitem>
    … …  
    505466
    506467    <para>
    507       <xref linkend="unattended-guest-install-example"/> describes how
    508       to perform an unattended guest installation for an Oracle Linux
    509       guest.
     468      When you first start a VM that has been configured for unattended
     469      installation, the guest OS installation is performed
     470      automatically.
     471    </para>
     472
     473    <para>
     474      The installation operation changes the boot device order to boot
     475      the virtual hard disk first and then the virtual DVD drive. If the
     476      virtual hard disk is empty prior to the automatic installation,
     477      the VM boots from the virtual DVD drive and begins the
     478      installation.
     479    </para>
     480
     481    <para>
     482      If the virtual hard disk contains a bootable OS, the installation
     483      operation exits. In this case, change the boot device order
     484      manually by pressing F12 during the BIOS splash screen.
    510485    </para>
    511486
    512487    <sect2 id="unattended-guest-install-example">
    513488
    514       <title>An Example of Unattended Guest Installation</title>
     489      <title>Using VBoxManage Commands for Unattended Guest Installation</title>
    515490
    516491      <para>
    … …  
    718693          <para>
    719694            The VM starts in headless mode, which means that the
    720             VirtualBox Manager window does not open.
     695            &vbox-mgr; window does not open.
    721696          </para>
    722697        </listitem>
    … …  
    885860            OS for the VM. This is the same setting that is specified in
    886861            the <emphasis role="bold">New Virtual Machine</emphasis>
    887             wizard. See <xref linkend="gui-createvm" />.
     862            wizard. See <xref linkend="create-vm-wizard" />.
    888863          </para>
    889864
    … …  
    902877            specified in the <emphasis role="bold">New Virtual
    903878            Machine</emphasis> wizard. See
    904             <xref linkend="gui-createvm" />.
     879            <xref linkend="create-vm-wizard" />.
    905880          </para>
    906881        </listitem>
    … …  
    10371012        <para>
    10381013          All files related to the virtual machine except disk images
    1039           are stored unencrypted.
     1014          are stored unencrypted. To encrypt these files, use the
     1015          <command>VBoxManage encryptvm</command> command as described
     1016          in <xref linkend="vmencryption"/>.
    10401017        </para>
    10411018      </note>
    … …  
    10901067            running. This is the same setting that was specified in the
    10911068            <emphasis role="bold">New Virtual Machine</emphasis> wizard,
    1092             as described in <xref linkend="gui-createvm" />.
     1069            as described in <xref linkend="create-vm-wizard" />.
    10931070          </para>
    10941071
    … …  
    11391116        <listitem>
    11401117          <para>
     1118            <emphasis role="bold">TPM:</emphasis> Enables support for a
     1119            Trusted Platform Module (TPM) security processor. Choose
     1120            from the supported TPM versions.
     1121          </para>
     1122        </listitem>
     1123
     1124        <listitem>
     1125          <para>
    11411126            <emphasis role="bold">Pointing Device:</emphasis> The
    11421127            default virtual pointing device for some guest OSes is the
    … …  
    12011186        <listitem>
    12021187          <para>
    1203             <emphasis role="bold">Enable EFI:</emphasis> Enables
    1204             Extensible Firmware Interface (EFI), which replaces the
    1205             legacy BIOS and may be useful for certain advanced use
    1206             cases. See <xref linkend="efi" />.
    1207           </para>
    1208         </listitem>
    1209 
    1210         <listitem>
    1211           <para>
    12121188            <emphasis role="bold">Hardware Clock in UTC Time:</emphasis>
    12131189            If selected, &product-name; will report the system time in
    … …  
    12161192            and may be useful for UNIX-like guest OSes, which typically
    12171193            expect the hardware clock to be set to UTC.
     1194          </para>
     1195        </listitem>
     1196
     1197        <listitem>
     1198          <para>
     1199            <emphasis role="bold">Enable EFI:</emphasis> Enables
     1200            Extensible Firmware Interface (EFI), which replaces the
     1201            legacy BIOS and may be useful for certain advanced use
     1202            cases. See <xref linkend="efi" />.
     1203          </para>
     1204        </listitem>
     1205
     1206        <listitem>
     1207          <para>
     1208            <emphasis role="bold">Enable Secure Boot:</emphasis> Enables
     1209            Secure Boot, to provide a secure environment for starting
     1210            the guest OS.
    12181211          </para>
    12191212        </listitem>
    … …  
    14251418
    14261419          <para>
    1427             The GUI will show a warning if the amount of video memory is
    1428             too small to be able to switch the VM into full screen mode.
    1429             The minimum value depends on the number of virtual monitors,
    1430             the screen resolution and the color depth of the host
    1431             display as well as on the use of <emphasis>3D
     1420            &vbox-mgr; will show a warning if the amount of video memory
     1421            is too small to be able to switch the VM into full screen
     1422            mode. The minimum value depends on the number of virtual
     1423            monitors, the screen resolution and the color depth of the
     1424            host display as well as on the use of <emphasis>3D
    14321425            acceleration</emphasis> and <emphasis>2D video
    14331426            acceleration</emphasis>. A rough estimate is
    … …  
    14841477          <para>
    14851478            You can set a default scale factor for all VMs. Use the
    1486             <emphasis role="bold">Display</emphasis> tab in the Global
    1487             Settings dialogs.
     1479            <emphasis role="bold">Display</emphasis> tab in the
     1480            Preferences window.
    14881481          </para>
    14891482        </listitem>
    … …  
    15521545            select here whether the guest should support accelerated 3D
    15531546            graphics. See <xref linkend="guestadd-3d" />.
    1554           </para>
    1555         </listitem>
    1556 
    1557         <listitem>
    1558           <para>
    1559             <emphasis role="bold">Enable 2D Video
    1560             Acceleration:</emphasis> If a virtual machine with Microsoft
    1561             Windows has Guest Additions installed, you can select here
    1562             whether the guest should support accelerated 2D video
    1563             graphics. See <xref linkend="guestadd-2d" />.
    15641547          </para>
    15651548        </listitem>
    … …  
    17241707
    17251708    <para>
    1726       If you have used the <emphasis role="bold">Create VM</emphasis>
    1727       wizard to create a machine, you will normally see something like
    1728       the following:
     1709      If you have used the <emphasis role="bold">Create Virtual
     1710      Machine</emphasis> wizard to create a machine, you will normally
     1711      see something like the following:
    17291712    </para>
    17301713
    … …  
    17361719                     width="10cm" />
    17371720        </imageobject>
    1738       </mediaobject>
     1721      </mediaobject>     
    17391722    </figure>
    17401723
    … …  
    18951878      Removable media, such as CD/DVDs and floppies, can be changed
    18961879      while the guest is running. Since the
    1897       <emphasis role="bold">Settings</emphasis> dialog is not available
     1880      <emphasis role="bold">Settings</emphasis> window is not available
    18981881      at that time, you can also access these settings from the
    18991882      <emphasis role="bold">Devices</emphasis> menu of your virtual
    … …  
    19251908        <para>
    19261909          <emphasis role="bold">Host Audio Driver:</emphasis> The audio
    1927           driver that &product-name; uses on the host. On a Linux host,
    1928           depending on your host configuration, you can select between
    1929           the OSS, ALSA, or the PulseAudio subsystem. On newer Linux
    1930           distributions, the PulseAudio subsystem is preferred.
     1910          driver that &product-name; uses on the host.
     1911        </para>
     1912
     1913        <para>
     1914          The <emphasis role="bold">Default</emphasis> option is enabled
     1915          by default for all new VMs. This option selects the best audio
     1916          driver for the host platform automatically. This enables you
     1917          to move VMs between different platforms without having to
     1918          change the audio driver.
     1919        </para>
     1920
     1921        <para>
     1922          On a Linux host, depending on your host configuration, you can
     1923          select between the OSS, ALSA, or the PulseAudio subsystem. On
     1924          newer Linux distributions, the PulseAudio subsystem is
     1925          preferred.
    19311926        </para>
    19321927
    … …  
    19891984      virtualize networking. It supports many virtual network cards per
    19901985      virtual machine. The first four virtual network cards can be
    1991       configured in detail in the VirtualBox Manager window. Additional
    1992       network cards can be configured using the
    1993       <command>VBoxManage</command> command.
     1986      configured in detail in &vbox-mgr;. Additional network cards can
     1987      be configured using the <command>VBoxManage</command> command.
    19941988    </para>
    19951989
    … …  
    21972191          <listitem>
    21982192            <para>
    2199               <emphasis role="bold">TCP Socket:</emphasis> Useful for
     2193              <emphasis role="bold">TCP:</emphasis> Useful for
    22002194              forwarding serial traffic over TCP/IP, acting as a server,
    22012195              or it can act as a TCP client connecting to other servers.
    … …  
    23472341
    23482342          </itemizedlist>
    2349 
    23502343        </listitem>
    23512344
    … …  
    25152508    <para>
    25162509      The <emphasis role="bold">User Interface</emphasis> section
    2517       enables you to change certain aspects of the user interface of
    2518       this VM.
     2510      enables you to change certain aspects of the user interface of the
     2511      selected VM.
    25192512    </para>
    25202513
    … …  
    25242517        <para>
    25252518          <emphasis role="bold">Menu Bar:</emphasis> This widget enables
    2526           you to disable menus by clicking on the menu to release it,
    2527           menu entries by deselecting the check box of the entry to
    2528           disable it and the complete menu bar by deselecting the
    2529           rightmost check box.
     2519          you to disable a complete menu, by clicking on the menu name
     2520          to deselect it. Menu entries can be disabled, by deselecting
     2521          the check box next to the entry. On Windows and Linux hosts,
     2522          the complete menu bar can be disabled by deselecting the check
     2523          box on the right.
    25302524        </para>
    25312525      </listitem>
    … …  
    25392533          itself to a small gray line unless you move the mouse over it.
    25402534          With the toolbar, you can return from full screen or seamless
    2541           mode, control machine execution or enable certain devices. If
    2542           you do not want to see the toolbar, disable this setting.
    2543         </para>
    2544 
    2545         <para>
    2546           The second setting enables you to show the toolbar at the top
    2547           of the screen, instead of showing it at the bottom.
     2535          mode, control machine execution, or enable certain devices. If
     2536          you do not want to see the toolbar, disable the
     2537          <emphasis role="bold">Show in Full Screen/Seamless</emphasis>
     2538          setting.
     2539        </para>
     2540
     2541        <para>
     2542          The <emphasis role="bold">Show at Top of Screen</emphasis>
     2543          setting enables you to show the toolbar at the top of the
     2544          screen, instead of showing it at the bottom.
     2545        </para>
     2546
     2547        <para>
     2548          The Mini Toolbar is not available on macOS hosts.
    25482549        </para>
    25492550      </listitem>
    … …  
    25522553        <para>
    25532554          <emphasis role="bold">Status Bar:</emphasis> This widget
    2554           enables you to disable icons on the status bar by deselecting
    2555           the check box of an icon to disable it, to rearrange icons by
    2556           dragging and dropping the icon, and to disable the complete
    2557           status bar by deselecting the leftmost check box.
     2555          enables you to disable and reorder icons on the status bar.
     2556          Deselect the check box of an icon to disable it, or rearrange
     2557          icons by dragging and dropping the icon. To disable the
     2558          complete status bar deselect the check box on the left.
    25582559        </para>
    25592560      </listitem>
    … …  
    25782579      machines. To use EFI for a given virtual machine, you can enable
    25792580      EFI in the machine's <emphasis role="bold">Settings</emphasis>
    2580       dialog. See <xref linkend="settings-motherboard"/>. Alternatively,
     2581      window. See <xref linkend="settings-motherboard"/>. Alternatively,
    25812582      use the <command>VBoxManage</command> command line interface as
    25822583      follows:
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