VirtualBox

Ignore:
Timestamp:
Jul 12, 2024 9:07:43 AM (7 months ago)
Author:
vboxsync
Message:

Docs: bugref:10705. Merging current changes to dita files from docs team's repo. (r6123, r6120, r6117)

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc/manual/en_US/dita/topics/unattended-guest-install-example.dita

    r105134 r105289  
    33  PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
    44<topic xml:lang="en-us" id="unattended-guest-install-example">
    5                <title>Using VBoxManage Commands for Unattended Guest Installation</title>
     5               <title>Using VBoxManage Commands for Unattended Guest Installation</title>           
    66               <body>
    7                   <p>
    8         The following example shows how to perform an unattended guest
    9         installation for an Oracle Linux VM. The example uses various
    10         <userinput>VBoxManage</userinput> commands to prepare the guest VM.
    11         The <userinput>VBoxManage unattended install</userinput> command is
    12         then used to install and configure the guest OS.
    13       </p>
     7                  <p>The following example shows how to perform an unattended guest installation for an Oracle Linux VM.
     8      The example uses various <userinput>VBoxManage</userinput> commands to prepare the guest VM. The
     9        <userinput>VBoxManage unattended install</userinput> command is then used to install and configure the guest OS. </p>
    1410                  <ol>
    1511                     <li>
    16                         <p>
    17             Create the virtual machine.
    18           </p>
     12                        <p>Create the virtual machine. </p>
    1913                        <pre xml:space="preserve"># VM="ol7-autoinstall"
    2014# VBoxManage list ostypes
    2115# VBoxManage createvm --name $VM --ostype "Oracle_64" --register</pre>
    22                         <p>
    23             Note the following:
    24           </p>
     16                        <p>Note the following: </p>
    2517                        <ul>
    2618                           <li>
    27                               <p>
    28                 The $VM variable represents the name of the VM.
    29               </p>
     19                              <p>The $VM variable represents the name of the VM. </p>
    3020                           </li>
    3121                           <li>
    32                               <p>
    33                 The <userinput>VBoxManage list ostypes</userinput> command
    34                 lists the guest OSes supported by <ph conkeyref="vbox-conkeyref-phrases/product-name"/>,
    35                 including the name used for each OS in the
    36                 <userinput>VBoxManage</userinput> commands.
    37               </p>
     22                              <p>The <userinput>VBoxManage list ostypes</userinput> command lists the guest OSes
     23              supported by <ph conkeyref="vbox-conkeyref-phrases/product-name"/>, including the name used for each OS in
     24              the <userinput>VBoxManage</userinput> commands. </p>
    3825                           </li>
    3926                           <li>
    40                               <p>
    41                 A 64-bit Oracle Linux 7 VM is created and registered
    42                 with <ph conkeyref="vbox-conkeyref-phrases/product-name"/>.
    43               </p>
     27                              <p>A 64-bit Oracle Linux 7 VM is created and registered with <ph
     28                conkeyref="vbox-conkeyref-phrases/product-name"/>. </p>
    4429                           </li>
    4530                           <li>
    46                               <p>
    47                 The VM has a unique UUID.
    48               </p>
     31                              <p>The VM has a unique UUID. </p>
    4932                           </li>
    5033                           <li>
    51                               <p>
    52                 An XML settings file is generated.
    53               </p>
     34                              <p>An XML settings file is generated. </p>
    5435                           </li>
    5536                        </ul>
    5637                     </li>
    5738                     <li>
    58                         <p>
    59             Create a virtual hard disk and storage devices for the VM.
    60           </p>
     39                        <p>Create a virtual hard disk and storage devices for the VM. </p>
    6140                        <pre xml:space="preserve"># VBoxManage createhd --filename /VirtualBox/$VM/$VM.vdi --size 32768
    6241# VBoxManage storagectl $VM --name "SATA Controller" --add sata --controller IntelAHCI
     
    6645# VBoxManage storageattach $VM --storagectl "IDE Controller" --port 0 --device 0 \
    6746--type dvddrive --medium /u01/Software/OL/OracleLinux-R7-U6-Server-x86_64-dvd.iso</pre>
    68                         <p>
    69             The previous commands do the following:
    70           </p>
     47                        <p>The previous commands do the following: </p>
    7148                        <ul>
    7249                           <li>
    73                               <p>
    74                 Create a 32768 MB virtual hard disk.
    75               </p>
     50                              <p>Create a 32768 MB virtual hard disk. </p>
    7651                           </li>
    7752                           <li>
    78                               <p>
    79                 Create a SATA storage controller and attach the virtual
    80                 hard disk.
    81               </p>
     53                              <p>Create a SATA storage controller and attach the virtual hard disk. </p>
    8254                           </li>
    8355                           <li>
    84                               <p>
    85                 Create an IDE storage controller for a virtual DVD drive
    86                 and attach an Oracle Linux installation ISO.
    87               </p>
     56                              <p>Create an IDE storage controller for a virtual DVD drive and attach an Oracle Linux
     57              installation ISO. </p>
    8858                           </li>
    8959                        </ul>
    9060                     </li>
    9161                     <li>
    92                         <p>
    93             (Optional) Configure some settings for the VM.
    94           </p>
     62                        <p>(Optional) Configure some settings for the VM. </p>
    9563                        <pre xml:space="preserve"># VBoxManage modifyvm $VM --ioapic on
    9664# VBoxManage modifyvm $VM --boot1 dvd --boot2 disk --boot3 none --boot4 none
    9765# VBoxManage modifyvm $VM --memory 8192 --vram 128</pre>
    98                         <p>
    99             The previous commands do the following:
    100           </p>
     66                        <p>The previous commands do the following: </p>
    10167                        <ul>
    10268                           <li>
    103                               <p>
    104                 Enable I/O APIC for the motherboard of the VM.
    105               </p>
     69                              <p>Enable I/O APIC for the motherboard of the VM. </p>
    10670                           </li>
    10771                           <li>
    108                               <p>
    109                 Configure the boot device order for the VM.
    110               </p>
     72                              <p>Configure the boot device order for the VM. </p>
    11173                           </li>
    11274                           <li>
    113                               <p>
    114                 Allocate 8192 MB of RAM and 128 MB of video RAM to the
    115                 VM.
    116               </p>
     75                              <p>Allocate 8192 MB of RAM and 128 MB of video RAM to the VM. </p>
    11776                           </li>
    11877                        </ul>
    11978                     </li>
    12079                     <li>
    121                         <p>
    122             Perform an unattended install of the OS.
    123           </p>
     80                        <p>Perform an unattended install of the OS. </p>
    12481                        <pre xml:space="preserve"># VBoxManage unattended install $VM \
    12582--iso=/u01/Software/OL/OracleLinux-R7-U6-Server-x86_64-dvd.iso \
    12683--user=<varname>login</varname> --full-user-name=<varname>name</varname> --user-password <varname>password</varname> \
    12784--install-additions --time-zone=CET</pre>
    128                         <p>
    129             The previous command does the following:
    130           </p>
     85                        <p>The previous command does the following: </p>
    13186                        <ul>
    13287                           <li>
    133                               <p>
    134                 Specifies an Oracle Linux ISO as the installation ISO.
    135               </p>
     88                              <p>Specifies an Oracle Linux ISO as the installation ISO. </p>
    13689                           </li>
    13790                           <li>
    138                               <p>
    139                 Specifies a login name, full name, and login password
    140                 for a default user on the guest OS.
    141               </p>
    142                               <p>
    143                 Note that the specified password is also used for the
    144                 root user account on the guest.
    145               </p>
     91                              <p>Specifies a login name, full name, and login password for a default user on the guest
     92              OS. </p>
     93                              <p>Note that the specified password is also used for the root user account on the guest. </p>
    14694                           </li>
    14795                           <li>
    148                               <p>
    149                 Installs the Guest Additions on the VM.
    150               </p>
     96                              <p>Installs the Guest Additions on the VM. </p>
    15197                           </li>
    15298                           <li>
    153                               <p>
    154                 Sets the time zone for the guest OS to Central European
    155                 Time (CET).
    156               </p>
     99                              <p>Sets the time zone for the guest OS to Central European Time (CET). </p>
    157100                           </li>
    158101                        </ul>
    159102                     </li>
    160103                     <li>
    161                         <p>
    162             Start the virtual machine.
    163           </p>
    164                         <p>
    165             This step completes the unattended installation process.
    166           </p>
     104                        <p>Start the virtual machine. </p>
     105                        <p>This step completes the unattended installation process. </p>
    167106                        <pre xml:space="preserve"># VBoxManage startvm $VM --type headless</pre>
    168                         <p>
    169             The VM starts in headless mode, which means that the
    170             <ph conkeyref="vbox-conkeyref-phrases/vbox-mgr"/> window does not open.
    171           </p>
     107                        <p>The VM starts in headless mode, which means that the <ph
     108            conkeyref="vbox-conkeyref-phrases/vbox-mgr"/> window does not open. </p>
    172109                     </li>
    173                      <li>
    174                         <p>
    175             (Optional) Update the guest OS to use the latest Oracle
    176             Linux packages.
    177           </p>
    178                         <p>
    179             On the guest VM, run the following command:
    180           </p>
    181                         <pre xml:space="preserve"># yum update</pre>
    182                      </li>
     110                     <li>(Optional) Update the guest OS to use the latest Oracle Linux packages. <p>On the guest VM, run
     111          the following command: </p><pre xml:space="preserve"># yum update</pre></li>
    183112                  </ol>
    184                </body>
     113               </body>             
    185114            </topic>
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