VirtualBox

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


Ignore:
Timestamp:
Aug 21, 2024 6:29:14 PM (7 months ago)
Author:
vboxsync
svn:sync-xref-src-repo-rev:
164503
Message:

Docs: bugref:10705. The following commits from doc's team git repo has been applied:

d40098418df3fbc310fa4e93692ad5af4d2afd8f Included review feedback from several reviewers, in several sections.
2676d3ef92e6e59b3b7e621a54f36e3820abc179 Merge branch 'VBP-724_Sergei_Feedback' into 'main'
3f3d0dd31d4651a1493b2b7344abec67c651e140 Updated title and wording to remove legacy
ed2f96ee6d74df775f14e27b9a22dfa90a163248 Merge branch 'VBP-844' into 'main'
027d54cc9407cb6c3127a2755f694d90f51caeee Updated host operating systems and added matrix of host and guest combos VBP-715
0198e7b29d83e90400d1f28209d658d7b9f3f2c9 Draft relnotes to start reviewing
03a9607c51487ca52cc9e679dfa604f1810756ea Copied over latest change log
3faf30c5fb864b72a617cbd98dca7b8722168cb7 Merge branch 'Change_log_update' into 'main'
1e0c0fd0ddf10251ec657b26ed2de708ef37cf0e Removed accessibility features documentation section from release notes. Not required.
dfd0067d47ee60d25a793b53324d343c7d5e90ea Removed deleted accessibility files from ditamap
5161634d4d02d91c333fbe890ed479691417a8ab Updates to wording around Arm hosts and guests
21bb36812315e246b9221b8a562381bb19df3a83 Merge branch 'Simon_relnotes_input' into 'main'

Location:
trunk/doc/manual/en_US/dita/topics
Files:
13 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc/manual/en_US/dita/topics/arm-host-limitations.dita

    r105303 r105791  
    22<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
    33<topic xml:lang="en-us" id="arm-host-limitations">
    4   <title>Arm Platform Host Limitations</title>
     4  <title>Arm Host Limitations</title>
    55  <!-- 7.1: Arm platform limitations -->
    66  <body>
     
    88    <ul><li><p>Virtual machines must use an Arm-based guest operating system. Running an x86-based guest operating
    99      system on an Arm host platform is not supported. </p></li>
    10     <li><p>Sound emulation is not available.</p></li>
    11     <li><p>Only virtio-scsi is supported as a storage controller.</p></li>
    1210    <li><p>Only VMSVGA is supported as a graphics controller.</p></li>
     11      <li>
     12        <p>2D and 3D video acceleration isn't available on Arm hosts.</p>
     13      </li>
    1314      <li><p><ph conkeyref="vbox-conkeyref-phrases/product-name"/> Guest Additions are not available for Arm
    1415          host platforms. Therefore, features such as seamless windows and shared folders are not
    1516          available.</p></li>   
    16       <li><p>Unattended installation is not available.</p></li>
    17       <li><p>The following <b>System</b> page settings may not be available for Arm guests:</p>
     17      <li><p>Unattended installation isn't available.</p></li>
     18      <li><p>The following <b>System</b> page settings aren't available for Arm guests:</p>
    1819      <ul><li><p><b>Motherboard tab:</b> Chipset, TPM</p></li>
    1920      <li><p><b>Processor tab:</b> Extended Features such as Enable PAE/NX, Enable Nested VT-x/AMD-V</p></li></ul></li>
    20       <li>
     21      <!-- <li>
    2122        <p>The following <b>System</b> page settings may not be available for x86 guests:</p>
    2223        <ul id="ul_zy2_r1b_t1c">
     
    2526          </li>
    2627        </ul>
    27       </li>
     28      </li> -->
    2829    </ul>
    2930  </body>
  • trunk/doc/manual/en_US/dita/topics/cloud-create-api-keypair.dita

    r105289 r105791  
    2828        <ul>
    2929          <li>
    30             <p>
    31                 To generate a private key with a passphrase:
    32               </p>
    33             <pre xml:space="preserve">$ openssl genrsa -out ~/.oci/oci_api_key.pem -aes128 2048 </pre>
     30            <p> To generate a private key with a passphrase (prompt for passphrase): </p>
     31            <pre xml:space="preserve">$ openssl genrsa -out ~/.oci/oci_api_key.pem -aes256 2048 </pre>
     32          </li>
     33          <li>
     34            <p> To generate a private key with a passphrase entered on the command line as an argument:</p>
     35            <pre xml:space="preserve">$ openssl genrsa -aes256 -passout pass:user_passphrase -out ~/.oci/oci_api_key.pem 2048</pre>
    3436          </li>
    3537          <li>
     
    4648        <p>Generate the public key. </p>
    4749        <pre xml:space="preserve">$ openssl rsa -pubout -in ~/.oci/oci_api_key.pem -out ~/.oci/oci_api_key_public.pem</pre>
     50        <p>Enter the passphrase when prompted, if you set one.</p>
    4851      </li>
    4952    </ol>
  • trunk/doc/manual/en_US/dita/topics/cloud-export-oci.dita

    r105573 r105791  
    6262          </li>
    6363          <li>
    64             <p>The launch mode for the custom image. </p>
    65             <p><b outputclass="bold">Paravirtualized</b> mode
    66                 gives improved performance and should be suitable for
    67                 most <ph conkeyref="vbox-conkeyref-phrases/product-name"/> VMs.
    68               </p>
     64            <p>The launch mode for the cloud instance.</p>
     65            <p><b outputclass="bold">Paravirtualized</b> mode gives improved performance and is suitable for most <ph conkeyref="vbox-conkeyref-phrases/product-name"/> VMs. </p>
    6966            <p><b outputclass="bold">Emulated</b> mode is
    7067                suitable for legacy OS images.
  • trunk/doc/manual/en_US/dita/topics/cloud-profile-creating.dita

    r105618 r105791  
    3535            </li>
    3636            <li>
    37                 <p>(Optional) If you are using the cloud profile to connect to cloud virtual machines, select the <b
    38                         outputclass="bold">Show VMs</b> check box. </p>
     37                <p>(Optional) If you are using the cloud profile to connect to cloud virtual machines, select the <b outputclass="bold">Show VMs</b> check box.</p>
    3938                <p>This creates a new subgroup of the <b outputclass="bold">OCI</b> group in <ph
    4039                        conkeyref="vbox-conkeyref-phrases/vbox-mgr"/>. See <xref
  • trunk/doc/manual/en_US/dita/topics/cloud-vm-oci-group.dita

    r105573 r105791  
    1515      cloud profile, follow these steps. </p>
    1616    <ol id="ol_uly_nwf_gcc">
    17       <li>Display the <b outputclass="bold">Cloud Profile Manager</b> .</li>
    18       <li>Select or deselect the <b outputclass="bold">List VMs</b> check box for each cloud profile.</li>
     17      <li>Display the <b outputclass="bold">Cloud Profile Manager</b>.</li>
     18      <li>Select or clear the <b outputclass="bold">List VMs</b> check box for each cloud profile.</li>
    1919    </ol>
    2020  </body>
  • trunk/doc/manual/en_US/dita/topics/cloud-vm.dita

    r105573 r105791  
    3131      </li>
    3232      <li>
    33         <p><b outputclass="bold">Configure an <ph conkeyref="vbox-conkeyref-phrases/oci"/>
    34             instance.</b> You can change settings for the
    35             instance, such as display name and shape. See
    36             <xref href="cloud-vm-settings.dita#cloud-vm-settings"/>.
    37           </p>
     33        <p><b outputclass="bold">Configure an <ph conkeyref="vbox-conkeyref-phrases/oci"/> instance.</b> You can change settings for the instance, such as display name. See <xref href="cloud-vm-settings.dita#cloud-vm-settings"/>. </p>
    3834      </li>
    3935      <li>
  • trunk/doc/manual/en_US/dita/topics/create-vm-wizard-unattended-install.dita

    r105134 r105791  
    1717            guest OS. </li>
    1818          <li>
    19             <p>For Windows guests, enter the <b outputclass="bold">Product Key.</b> supplied with
    20               Windows. </p>
    21       </li>
    22       <li>
     19            <p>For Windows guests, enter the <b outputclass="bold">Product Key</b> supplied with Windows. </p>
     20          </li>
     21          <li>
    2322            <p>Enter the <b outputclass="bold">Hostname</b> for the VM. By default, this is the same
    2423              as the VM name.</p>
     
    2928          <li>Select <b outputclass="bold">Install in Background</b> if you want to enable headless
    3029            mode for the VM rather than using a graphical user interface. </li>
    31           <li>Select <b outputclass="bold">Guest Additions</b> if you would like <ph
    32               conkeyref="vbox-conkeyref-phrases/product-name"/> to install the Guest Additions after
    33             the OS. Download the Guest Additions installation ISO to the host, and select the file
    34             location.</li>
     30          <li>Unattended Guest Additions installation is available for some x86 guests. Select <b outputclass="bold">Guest Additions</b> if you would like <ph conkeyref="vbox-conkeyref-phrases/product-name"/> to install the Guest Additions after the OS. Download the Guest Additions installation ISO to the host, and select the file location.</li>
    3531          <li>Click <b outputclass="bold">Next</b> to <xref href="create-vm-wizard-hardware.dita"/>.
    3632          </li>
  • trunk/doc/manual/en_US/dita/topics/hostcpurequirements.dita

    r98549 r105791  
    22<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
    33<topic xml:lang="en-us" id="hostcpurequirements">
    4   <title>Host CPU Requirements</title>
     4  <title>Intel Host CPU Requirements</title>
    55 
    66  <body>
    7     <p>
    8         SSE2 (Streaming SIMD Extensions 2) support is required for host
    9         CPUs.
    10       </p>
     7    <p>Intel host CPUs must have SSE2 (Streaming SIMD Extensions 2). </p>
    118  </body>
    129 
  • trunk/doc/manual/en_US/dita/topics/hostossupport.dita

    r105303 r105791  
    22<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
    33<topic xml:lang="en-us" id="hostossupport">
    4   <title>Supported Host Operating Systems</title>
     4  <title>Available Installation Packages</title>
    55  <!-- 7.1: Arm platforms; require statement on host support -->
    66  <body>
    7     <p>Currently, <ph conkeyref="vbox-conkeyref-phrases/product-name"/> runs on the following host
    8       OSes: </p>
     7    <p><ph conkeyref="vbox-conkeyref-phrases/product-name"/> runs on the following host Operating Systems (OSs): </p>
    98    <ul>
    109      <li>
    1110        <p>
    12           <b outputclass="bold">Windows hosts (64-bit):</b>
     11          <b outputclass="bold">x86-64 Windows hosts:</b>
    1312        </p>
    1413        <ul>
     
    2019          </li>
    2120          <li>
    22             <p>Windows Server 2019 </p>
    23           </li>
    24           <li>
    2521            <p>Windows Server 2022 </p>
    2622          </li>
    27           <li>Windows Server 2025</li>
    2823        </ul>
    2924      </li>
    3025      <li>
    3126        <p>
    32           <b outputclass="bold">macOS hosts (64-bit):</b>
     27          <b outputclass="bold">Intel x86-64 macOS hosts:</b>
    3328        </p>
    3429        <ul>
     
    4237            <p>13 (Ventura) </p>
    4338          </li>
    44           <li>14 (Sonoma)</li>
     39          <li>
     40            <p>14 (Sonoma)</p>
     41          </li>
    4542        </ul>
    46         <p>Intel hardware is required. See also <xref href="KnownIssues.dita">Known
    47             Limitations</xref>. </p>
    48         <p>An installer package is available for macOS/Arm64, for systems using an Apple silicon
    49           CPU. With this package, you can run some guest operating systems for Intel x86/x64 CPUs in
    50           an emulation. </p>
    51         <p>The macOS/Arm64 installer package for Apple silicon platform is available as a Developer
    52           Preview release. This package represents a work in progress project and the performance is
    53           very modest. </p>
    54         <note>
    55           <p>Developer Preview is a public release for developers, which provides early access to unsupported software
    56             release and features. </p>
    57         </note>
     43        <p>See also <xref href="KnownIssues.dita">Known Limitations</xref>. </p>
    5844      </li>
    5945      <li>
    60         <p><b outputclass="bold">Linux hosts (64-bit).</b>
    61           Includes the following:
    62         </p>
     46        <p>
     47          <b outputclass="bold">Arm macOS hosts (64-bit):</b></p>
     48        <ul>
     49          <li>
     50            <p>11 (Big Sur) </p>
     51          </li>
     52          <li>
     53            <p>12 (Monterey) </p>
     54          </li>
     55          <li>
     56            <p>13 (Ventura) </p>
     57          </li>
     58          <li>
     59            <p>14 (Sonoma)</p>
     60          </li>
     61        </ul>
     62        <p>See also <xref href="guest-os.dita"/> for limitations on the VMs you can create on an Arm host. </p>
     63      </li>
     64      <li>
     65        <p><b outputclass="bold">x86-64 Linux hosts.</b> Includes the following: </p>
    6366        <ul>
    6467          <li>
     
    6972          </li>
    7073          <li>
    71             <p>Oracle Linux 7, 8 and 9 </p>
     74            <p>Oracle Linux 8 and 9 </p>
    7275          </li>
    7376          <li>
     
    7578          </li>
    7679          <li>
    77             <p>Fedora 39 and 40 </p>
     80            <p>Fedora 39 and 40</p>
    7881          </li>
    7982          <li>
    80             <p>SUSE Linux Enterprise server 15 </p>
     83            <p>SUSE Linux Enterprise server 15</p>
    8184          </li>
    8285          <li>
     
    106109      </li>
    107110    </ul>
    108     <p>Note that any feature which is marked as <i>experimental</i> is not supported. Feedback and suggestions about
    109       such features are welcome. </p>
     111    <p>Note that any feature that is marked as <i>experimental</i> is not supported. Feedback and suggestions about such features are welcome. </p>
    110112  </body>
    111113</topic>
  • trunk/doc/manual/en_US/dita/topics/intro-running.dita

    r105388 r105791  
    55 
    66  <body>
    7     <p>
    8       To start a virtual machine, you have the following options:
    9     </p>
     7    <p> To start a virtual machine (VM), you have the following options: </p>
    108    <ul>
    119      <li>
     
    2422      </li>
    2523    </ul>
    26     <p>Starting a virtual machine displays a new window, and the virtual machine which you selected will boot up.
    27       Everything which would normally be seen on the virtual system's monitor is shown in the window. See <xref
    28         href="Introduction.dita#Introduction/fig-win2016-intro"/>. </p>
     24    <p>The VM you started appears in a new window and you will see it start to boot up, or prompt you to install an operating system as required. Everything that would normally be seen on the virtual system's monitor is shown in the window. </p>
    2925    <p>In general, you can use the virtual machine as you would use a real computer. The following topics describe a few
    3026      points to note when running a VM. </p>
  • trunk/doc/manual/en_US/dita/topics/intro-starting-vm-first-time.dita

    r105289 r105791  
    55 
    66  <body>
    7     <p>When you start a VM for the first time the OS installation process is started automatically, using the ISO image
    8       file specified in the <b outputclass="bold">Create Virtual Machine</b> wizard. </p>
     7    <p>When you start a VM for the first time the OS installation process is started automatically, using the ISO image file specified in the <b outputclass="bold">Create Virtual Machine</b> workflow. </p>
    98    <p>Follow the onscreen instructions to install your OS. </p>
    109  </body>
  • trunk/doc/manual/en_US/dita/topics/preferences.dita

    r105426 r105791  
    3030      </li>
    3131      <li>
    32         <p><b outputclass="bold">Input.</b> Enables you to specify
    33           keyboard shortcuts, such as the <b outputclass="bold">Host
    34           key</b>. This is the key that toggles whether the
    35           cursor is in the focus of the VM or the Host OS windows, see
    36           <xref href="keyb_mouse_normal.dita#keyb_mouse_normal"/>. The Host key is also used
    37           to trigger certain VM actions, see
    38           <xref href="specialcharacters.dita#specialcharacters"/>.
    39         </p>
     32        <p><b outputclass="bold">Input.</b> Enables you to specify keyboard shortcuts, both in <ph conkeyref="vbox-conkeyref-phrases/vbox-mgr"/> and in individual VMs. For example you might want to specify a different <b outputclass="bold">Host key</b>. This is the key that toggles whether the cursor is in the focus of the VM or the Host OS windows, see <xref href="keyb_mouse_normal.dita#keyb_mouse_normal"/>. The Host key is also used to trigger certain VM actions, see <xref href="specialcharacters.dita#specialcharacters"/>. </p>
    4033      </li>
    4134      <li>
  • trunk/doc/manual/en_US/dita/topics/ui-experience-level.dita

    r105498 r105791  
    88    <ul>
    99      <li>
    10         <p><b>Basic.</b> Only a limited number of settings and tools are shown. Wizards are used to display
    11           configuration options. This is the default setting.</p>
     10        <p><b>Basic.</b> Only a limited number of settings and tools are shown. Workflows are used to display settings and configuration options. This is the default setting for new installations.</p>
    1211        <p>This level is suitable for a first time user of <ph conkeyref="vbox-conkeyref-phrases/product-name"/>.</p>
    1312      </li>
    1413      <li>
    1514        <p><b>Expert.</b> All available settings and tools are shown.</p>
    16         <p>Tabbed displays rather than wizards are used for configuration options. </p>
     15        <p>Single pages show all settings and configuration options. This is the default setting for upgrades when a user already has at least one saved VM.</p>
    1716        <p>This level is suitable for an experienced user who needs more control of virtual machine settings.</p>
    1817      </li>
     
    2120      />:</p>   
    2221    <ul>
    23       <li><p>The <b>Welcome</b> screen.</p>
    24         <note><p>The option disappears from the Welcome screen, after you have selected it.</p></note>
     22      <li><p>The <b>Welcome</b> screen, for new installations only.</p>
    2523      </li>
    2624      <li><p>The <b>Preferences</b> window.</p>
     
    4543          </image>
    4644        </p>
    47       <p>The number of available settings and tools will change, depending on the selected experience level.</p></li>
     45      <p>The number of available settings and tools changes depending on the selected experience level.</p></li>
    4846      </ol>
    4947    </section>
Note: See TracChangeset for help on using the changeset viewer.

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