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_Introduction.xml

    r96856 r97032  
    3737    &product-name; is a cross-platform virtualization application. What
    3838    does that mean? For one thing, it installs on your existing Intel or
    39     AMD-based computers, whether they are running Windows, macOS,
    40     Linux, or Oracle Solaris operating systems (OSes). Secondly, it
    41     extends the capabilities of your existing computer so that it can
    42     run multiple OSes, inside multiple virtual machines, at the same
    43     time. As an example, you can run Windows and Linux on your Mac, run
    44     Windows Server 2016 on your Linux server, run Linux on your Windows
    45     PC, and so on, all alongside your existing applications. You can
    46     install and run as many virtual machines as you like. The only
    47     practical limits are disk space and memory.
     39    AMD-based computers, whether they are running Windows, macOS, Linux,
     40    or Oracle Solaris operating systems (OSes). Secondly, it extends the
     41    capabilities of your existing computer so that it can run multiple
     42    OSes, inside multiple virtual machines, at the same time. As an
     43    example, you can run Windows and Linux on your Mac, run Windows
     44    Server on your Linux server, run Linux on your Windows PC, and so
     45    on, all alongside your existing applications. You can install and
     46    run as many virtual machines as you like. The only practical limits
     47    are disk space and memory.
    4848  </para>
    4949
    … …  
    136136
    137137        <para>
    138           On top of that, with the use of another &product-name; feature
    139           called <emphasis>snapshots</emphasis>, one can save a
     138          Using virtual machines enables you to build and test a
     139          multi-node networked service, for example. Issues with
     140          networking, operating system, and software configuration can
     141          be investigated easily.
     142        </para>
     143
     144        <para>
     145          In addition to that, with the use of another &product-name;
     146          feature called <emphasis>snapshots</emphasis>, one can save a
    140147          particular state of a virtual machine and revert back to that
    141148          state, if necessary. This way, one can freely experiment with
    … …  
    189196          OS).</emphasis> This is the OS of the physical computer on
    190197          which &product-name; was installed. There are versions of
    191           &product-name; for Windows, macOS, Linux, and Oracle
    192           Solaris hosts. See <xref linkend="hostossupport" />.
     198          &product-name; for Windows, macOS, Linux, and Oracle Solaris
     199          hosts. See <xref linkend="hostossupport" />.
    193200        </para>
    194201
    … …  
    239246
    240247        <para>
    241           You can view these VM settings in the VirtualBox Manager
    242           window, the <emphasis role="bold">Settings</emphasis> dialog,
    243           and by running the <command>VBoxManage</command> command. See
     248          You can view these VM settings in &vbox-mgr;, in the
     249          <emphasis role="bold">Settings</emphasis> window, and by
     250          running the <command>VBoxManage</command> command. See
    244251          <xref linkend="vboxmanage" />.
    245252        </para>
    … …  
    284291          2</emphasis> hypervisor. Whereas a
    285292          <emphasis>bare-metal</emphasis> or <emphasis>type 1</emphasis>
    286           hypervisor would run directly on the hardware, &product-name;
     293          hypervisor runs directly on the hardware, &product-name;
    287294          requires an existing OS to be installed. It can thus run
    288295          alongside existing applications on that host.
    … …  
    295302          machines created on one host on another host with a different
    296303          host OS. For example, you can create a virtual machine on
    297           Windows and then run it under Linux.
     304          Windows and then run it on Linux.
    298305        </para>
    299306
    … …  
    339346      <listitem>
    340347        <para>
    341           <emphasis role="bold">Great hardware support.</emphasis> Among
    342           other features, &product-name; supports the following:
     348          <emphasis role="bold">Comprehensive hardware
     349          support.</emphasis> Among other features, &product-name;
     350          supports the following:
    343351        </para>
    344352
    … …  
    636644          <xref linkend="KnownIssues" />.
    637645        </para>
     646
     647        <para>
     648          An installer package is available for macOS/Arm64, for systems
     649          using an Apple silicon CPU. With this package, you can run
     650          some guest operating systems for Intel x86/x64 CPUs in an
     651          emulation.
     652        </para>
     653
     654        <para>
     655          The macOS/Arm64 installer package for Apple silicon platform
     656          is available as a Developer Preview release. This package
     657          represents a work in progress project and the performance is
     658          very modest.
     659        </para>
     660
     661        <note>
     662          <para>
     663            Developer Preview is a public release for developers, which
     664            provides early access to unsupported software release and
     665            features.
     666          </para>
     667        </note>
    638668      </listitem>
    639669
    … …  
    660690          <listitem>
    661691            <para>
    662               Oracle Linux 7 and 8
    663             </para>
    664           </listitem>
    665 
    666           <listitem>
    667             <para>
    668               CentOS/Red Hat Enterprise Linux 7 and 8
     692              Oracle Linux 7, 8 and 9
     693            </para>
     694          </listitem>
     695
     696          <listitem>
     697            <para>
     698              CentOS/Red Hat Enterprise Linux 7, 8 and 9
    669699            </para>
    670700          </listitem>
    … …  
    825855          <listitem>
    826856            <para>
    827               Cloud integration features. See <xref linkend="ovf"/>.
     857              Cloud integration features. See
     858              <xref linkend="cloud-integration"/>.
    828859            </para>
    829860          </listitem>
    … …  
    832863
    833864        <para>
    834           &product-name; extension packages have a
    835           <filename>.vbox-extpack</filename> file name extension. To
    836           install an extension, simply double-click on the package file
    837           and a <emphasis role="bold">Network Operations
    838           Manager</emphasis> window is shown to guide you through the
    839           required steps.
    840         </para>
    841 
    842         <para>
    843           To view the extension packs that are currently installed,
    844           start the VirtualBox Manager, as shown in
    845           <xref linkend="intro-starting"/>. From the
    846           <emphasis role="bold">File</emphasis> menu, select
    847           <emphasis role="bold">Preferences</emphasis>. In the window
    848           that displays, go to the
    849           <emphasis role="bold">Extensions</emphasis> category. This
    850           shows you the extensions which are currently installed, and
    851           enables you to remove a package or add a new package.
    852         </para>
    853 
    854         <para>
    855           Alternatively, you can use the <command>VBoxManage</command>
    856           command line. See <xref linkend="vboxmanage-extpack" />.
     865          For details of how to install an extension pack, see
     866          <xref linkend="install-ext-pack"/>.
    857867        </para>
    858868      </listitem>
    … …  
    874884      <listitem>
    875885        <para>
    876           On a Windows host, in the
     886          <emphasis role="bold">Windows hosts.</emphasis> In the
    877887          <emphasis role="bold">Programs</emphasis> menu, click on the
    878888          item in the <emphasis role="bold">VirtualBox</emphasis> group.
    … …  
    885895      <listitem>
    886896        <para>
    887           On a macOS host, in the Finder, double-click on the
     897          <emphasis role="bold">macOS hosts.</emphasis> In the Finder,
     898          double-click on the
    888899          <emphasis role="bold">VirtualBox</emphasis> item in the
    889900          Applications folder. You may want to drag this item onto your
    … …  
    894905      <listitem>
    895906        <para>
    896           On a Linux or Oracle Solaris host, depending on your desktop
    897           environment, an &product-name; item may have been placed in
    898           either the System or System Tools group of your
     907          <emphasis role="bold">Linux or Oracle Solaris
     908          hosts</emphasis>. Depending on your desktop environment, an
     909          &product-name; item may have been placed in either the System
     910          or System Tools group of your
    899911          <emphasis role="bold">Applications</emphasis> menu.
    900912          Alternatively, you can enter <command>VirtualBox</command> in
    … …  
    906918
    907919    <para>
    908       When you start &product-name; for the first time, a window like
    909       the following is displayed:
     920      When you start &product-name;, the &vbox-mgr; interface is shown.
     921      See <xref linkend="gui-virtualboxmanager"/>.
    910922    </para>
    911923
     924  </sect1>
     925
     926  <sect1 id="gui-virtualboxmanager">
     927
     928    <title>&vbox-mgr;</title>
     929
     930    <para>
     931      &vbox-mgr; is the user interface for &product-name;. You can use
     932      &vbox-mgr; to create, configure, and manage your virtual machines.
     933    </para>
     934
     935    <para>
     936      This section describes the main features of the &vbox-mgr; user
     937      interface. Subsequent sections and chapters describe how to use
     938      &vbox-mgr; to perform tasks in &product-name;.
     939    </para>
     940
     941    <para>
     942      When you start &product-name;, the
     943      <emphasis role="bold">&vbox-mgr;</emphasis> window is displayed.
     944    </para>
     945
     946    <para>
     947      <xref linkend="fig-vbox-manager-initial"/> shows &vbox-mgr; the
     948      first time you start &product-name;, before you have created any
     949      virtual machines.
     950    </para>
     951
    912952    <figure id="fig-vbox-manager-initial">
    913       <title>VirtualBox Manager Window, After Initial Startup</title>
    914     <mediaobject>
     953      <title>&vbox-mgr;, Showing Welcome Screen After Initial Startup</title>
     954      <mediaobject>
    915955        <imageobject>
    916956          <imagedata align="center" fileref="images/virtualbox-main-empty.png"
    … …  
    921961
    922962    <para>
    923       This window is called the <emphasis role="bold">VirtualBox
    924       Manager</emphasis>. The left pane will later list all your virtual
    925       machines. Since you have not yet created any virtual machines,
    926       this list is empty. The <emphasis role="bold">Tools</emphasis>
    927       button provides access to user tools, such as the Virtual Media
    928       Manager.
     963      <xref linkend="fig-vbox-manager-populated"/> shows how &vbox-mgr;
     964      might look after you have created some virtual machines.
    929965    </para>
    930966
    931     <para>
    932       The pane on the right displays the properties of the currently
    933       selected virtual machine. Since you do not have any machines yet,
    934       the pane displays a welcome message.
    935     </para>
    936 
    937     <para>
    938       The buttons on the right pane are used to create and work with
    939       VMs.
    940     </para>
    941 
    942     <para>
    943       The following figure gives an idea of what &product-name; might
    944       look like after you have created some VMs.
    945     </para>
    946 
    947967    <figure id="fig-vbox-manager-populated">
    948       <title>VirtualBox Manager Window, After Creating Virtual Machines</title>
    949     <mediaobject>
     968      <title>&vbox-mgr; Window, After Creating Virtual Machines</title>
     969      <mediaobject>
    950970        <imageobject>
    951971          <imagedata align="center" fileref="images/virtualbox-main.png"
    … …  
    955975    </figure>
    956976
     977    <para>
     978      The main components of the &vbox-mgr; window are as follows:
     979    </para>
     980
     981    <itemizedlist>
     982
     983      <listitem>
     984        <para>
     985          <emphasis role="bold">The machine list.</emphasis> The left
     986          pane of the <emphasis role="bold">VirtualBox
     987          Manager</emphasis> window lists all your virtual machines. If
     988          you have not yet created any virtual machines, this list is
     989          empty. See <xref linkend="gui-machine-list"/>.
     990        </para>
     991      </listitem>
     992
     993      <listitem>
     994        <para>
     995          <emphasis role="bold">The Details pane.</emphasis> The pane on
     996          the right displays the properties of the currently selected
     997          virtual machine. If you do not have any machines yet, the pane
     998          displays a welcome message.
     999        </para>
     1000
     1001        <para>
     1002          The toolbar buttons on the Details pane can be used to create
     1003          and work with virtual machines. See
     1004          <xref linkend="gui-details"/>.
     1005        </para>
     1006      </listitem>
     1007
     1008      <listitem>
     1009        <para>
     1010          <emphasis role="bold">Help Viewer.</emphasis> A window that
     1011          displays context-sensitive help topics for &vbox-mgr; tasks.
     1012          See <xref linkend="help-viewer"/>.
     1013        </para>
     1014      </listitem>
     1015
     1016    </itemizedlist>
     1017
     1018    <sect2 id="gui-machine-list">
     1019
     1020      <title>The Machine List</title>
     1021
     1022      <para>
     1023        The list of virtual machines in the left pane is called the
     1024        <emphasis>machine list</emphasis>.
     1025      </para>
     1026
     1027      <para>
     1028        The following methods can be used to control and configure
     1029        virtual machines in the machine list:
     1030      </para>
     1031
     1032      <itemizedlist>
     1033
     1034        <listitem>
     1035          <para>
     1036            Right-click on the virtual machine name, to display menu
     1037            options.
     1038          </para>
     1039        </listitem>
     1040
     1041        <listitem>
     1042          <para>
     1043            Click on the Machine Tools menu, to the right of the virtual
     1044            machine name. See <xref linkend="gui-tools-machine"/>.
     1045          </para>
     1046        </listitem>
     1047
     1048        <listitem>
     1049          <para>
     1050            Click a button in the toolbar in the Details pane. See
     1051            <xref linkend="gui-details"/>.
     1052          </para>
     1053        </listitem>
     1054
     1055      </itemizedlist>
     1056
     1057    </sect2>
     1058
     1059    <sect2 id="gui-details">
     1060
     1061      <title>The Details Pane</title>
     1062
     1063      <para>
     1064        The Details pane shows configuration information for a virtual
     1065        machine that is selected in the machine list. The pane also
     1066        includes a toolbar for performing tasks.
     1067      </para>
     1068
     1069      <figure id="fig-vbox-details-pane">
     1070        <title>&vbox-mgr; Details Pane, Including Toolbar</title>
     1071      <mediaobject>
     1072        <imageobject>
     1073          <imagedata align="center" fileref="images/details-pane.png"
     1074                     width="12cm" />
     1075        </imageobject>
     1076      </mediaobject>
     1077      </figure>
     1078
     1079      <para>
     1080        The Details pane includes the following:
     1081      </para>
     1082
     1083      <simplesect id="gui-details-toolbar">
     1084
     1085        <title>&vbox-mgr; Toolbar</title>
     1086
     1087        <para>
     1088          A toolbar at the top of the Details pane contains buttons that
     1089          enable you to configure the selected virtual machine, or to
     1090          create a new virtual machine.
     1091        </para>
     1092
     1093        <para>
     1094          The toolbar includes the following buttons:
     1095        </para>
     1096
     1097        <itemizedlist>
     1098
     1099          <listitem>
     1100            <para>
     1101              <emphasis role="bold">New.</emphasis> Creates a new
     1102              virtual machine, and adds it to the machine list.
     1103            </para>
     1104          </listitem>
     1105
     1106          <listitem>
     1107            <para>
     1108              <emphasis role="bold">Add.</emphasis> Adds an existing
     1109              virtual machine to the machine list.
     1110            </para>
     1111          </listitem>
     1112
     1113          <listitem>
     1114            <para>
     1115              <emphasis role="bold">Settings.</emphasis> Displays the
     1116              <emphasis role="bold">Settings</emphasis> window for the
     1117              virtual machine, enabling you to make configuration
     1118              changes.
     1119            </para>
     1120          </listitem>
     1121
     1122          <listitem>
     1123            <para>
     1124              <emphasis role="bold">Discard.</emphasis> For a running
     1125              virtual machine, discards the saved state for the virtual
     1126              machine and closes it down.
     1127            </para>
     1128          </listitem>
     1129
     1130          <listitem>
     1131            <para>
     1132              <emphasis role="bold">Show/Start.</emphasis> For a running
     1133              virtual machine, <emphasis role="bold">Show</emphasis>
     1134              displays the virtual machine window. For a stopped virtual
     1135              machine, <emphasis role="bold">Start</emphasis> displays
     1136              options for powering up the virtual machine.
     1137            </para>
     1138          </listitem>
     1139
     1140        </itemizedlist>
     1141
     1142      </simplesect>
     1143
     1144      <simplesect id="gui-details-settings">
     1145
     1146        <title>Settings</title>
     1147
     1148        <para>
     1149          A summary of settings is shown for the virtual machine.
     1150        </para>
     1151
     1152        <para>
     1153          You can change some virtual machine settings, by clicking on
     1154          the setting in the Details pane.
     1155        </para>
     1156
     1157        <note>
     1158          <para>
     1159            If a virtual machine is running, some settings cannot be
     1160            altered. You must stop the virtual machine first in order to
     1161            change the setting.
     1162          </para>
     1163        </note>
     1164
     1165        <para>
     1166          Virtual machine settings can also be changed using the
     1167          <emphasis role="bold">Settings</emphasis> button on the
     1168          &vbox-mgr; toolbar.
     1169        </para>
     1170
     1171        <para>
     1172          The virtual machine settings on the Details pane are organized
     1173          in sections that correspond to those used in the
     1174          <emphasis role="bold">Settings</emphasis> window. See
     1175          <xref linkend="BasicConcepts"/>.
     1176        </para>
     1177
     1178        <para>
     1179          Click the arrow icon to hide or show each section.
     1180        </para>
     1181
     1182      </simplesect>
     1183
     1184      <simplesect id="gui-details-preview">
     1185
     1186        <title>Preview Window</title>
     1187
     1188        <para>
     1189          The virtual machine display is shown in a small window.
     1190        </para>
     1191
     1192        <para>
     1193          You can use the Preview window to check if your virtual
     1194          machine has finished booting up.
     1195        </para>
     1196
     1197        <para>
     1198          Click the arrow icon to hide or show the Preview window.
     1199        </para>
     1200
     1201      </simplesect>
     1202
     1203      <simplesect id="gui-notification-center">
     1204
     1205        <title>Notification Center</title>
     1206
     1207        <para>
     1208          Notification messages may be shown in a sliding panel on the
     1209          right of the Details pane, called the
     1210          <emphasis role="bold">Notification Center</emphasis>. Click
     1211          the warning triangle to show the notification messages.
     1212        </para>
     1213
     1214        <para>
     1215          Most system messages that do not require user interaction are
     1216          displayed in the Notification Center, including task failure
     1217          alerts.
     1218        </para>
     1219
     1220        <para>
     1221          The progress of some tasks can be observed and stopped using
     1222          the Notification Center.
     1223        </para>
     1224
     1225      </simplesect>
     1226
     1227    </sect2>
     1228
     1229    <sect2 id="gui-tools">
     1230
     1231      <title>&vbox-mgr; Tools</title>
     1232
     1233      <para>
     1234        &vbox-mgr; provides two types of user tools, to enable you to
     1235        perform common tasks easily.
     1236      </para>
     1237
     1238      <itemizedlist>
     1239
     1240        <listitem>
     1241          <para>
     1242            <emphasis role="bold">Global Tools.</emphasis> These tools
     1243            apply to <emphasis>all</emphasis> virtual machines. See
     1244            <xref linkend="gui-tools-global"/>.
     1245          </para>
     1246        </listitem>
     1247
     1248        <listitem>
     1249          <para>
     1250            <emphasis role="bold">Machine Tools.</emphasis> These tools
     1251            apply to a <emphasis>specific</emphasis> virtual machine.
     1252            See <xref linkend="gui-tools-machine"/>.
     1253          </para>
     1254        </listitem>
     1255
     1256      </itemizedlist>
     1257
     1258      <simplesect id="gui-tools-global">
     1259
     1260        <title>Global Tools</title>
     1261
     1262        <para>
     1263          In the left pane of the &vbox-mgr; window, click the
     1264          <emphasis role="bold">Menu</emphasis> icon in the
     1265          <emphasis role="bold">Tools</emphasis> banner located above
     1266          the machine list. The <emphasis role="bold">Global
     1267          Tools</emphasis> menu is displayed.
     1268        </para>
     1269
     1270        <figure id="fig-global-tools-menu">
     1271          <title>Global Tools Menu</title>
     1272      <mediaobject>
     1273        <imageobject>
     1274          <imagedata align="center" fileref="images/global-tools-menu.png"
     1275                     width="10cm" />
     1276        </imageobject>
     1277      </mediaobject>
     1278        </figure>
     1279
     1280        <para>
     1281          A drop-down list enables you to select from the following
     1282          global tools:
     1283        </para>
     1284
     1285        <itemizedlist>
     1286
     1287          <listitem>
     1288            <para>
     1289              <emphasis role="bold">Welcome.</emphasis> Displays the
     1290              &vbox-mgr; welcome message. The &vbox-mgr; toolbar is also
     1291              included, to enable you to get started with using
     1292              &product-name;. See
     1293              <xref linkend="fig-vbox-manager-initial"/>.
     1294            </para>
     1295          </listitem>
     1296
     1297          <listitem>
     1298            <para>
     1299              <emphasis role="bold">Extensions.</emphasis> Displays the
     1300              <emphasis role="bold">Extension Pack Manager</emphasis>
     1301              tool. This tool is used to install and uninstall
     1302              &product-name; Extension Packs. See
     1303              <xref linkend="install-ext-pack-manager"/>.
     1304            </para>
     1305          </listitem>
     1306
     1307          <listitem>
     1308            <para>
     1309              <emphasis role="bold">Media.</emphasis> Displays the
     1310              <emphasis role="bold">Virtual Media Manager</emphasis>
     1311              tool. This tool is used to manage the disk images used by
     1312              &product-name;. See
     1313              <xref linkend="virtual-media-manager"/>.
     1314            </para>
     1315          </listitem>
     1316
     1317          <listitem>
     1318            <para>
     1319              <emphasis role="bold">Network.</emphasis> Displays the
     1320              <emphasis role="bold">Network Manager</emphasis> tool.
     1321              This tool is used to create and configure some types of
     1322              networks used by &product-name;. See
     1323              <xref linkend="network-manager"/>.
     1324            </para>
     1325          </listitem>
     1326
     1327          <listitem>
     1328            <para>
     1329              <emphasis role="bold">Cloud.</emphasis> Displays the
     1330              <emphasis role="bold">Cloud Profile Editor</emphasis>
     1331              tool. This tool is used to configure connections to a
     1332              cloud service, such as &oci;. See
     1333              <xref linkend="cloud-using-cloud-profile-manager"/>.
     1334            </para>
     1335          </listitem>
     1336
     1337          <listitem>
     1338            <para>
     1339              <emphasis role="bold">Activities.</emphasis> Displays the
     1340              <emphasis role="bold">VM Activity Overview</emphasis>
     1341              tool. This tool is used to monitor performance and
     1342              resource usage of virtual machines. See
     1343              <xref linkend="vm-info"/>.
     1344            </para>
     1345          </listitem>
     1346
     1347        </itemizedlist>
     1348
     1349        <para>
     1350          The <emphasis role="bold">Pin</emphasis> icon is used to keep
     1351          the <emphasis role="bold">Tools</emphasis> banner visible as
     1352          you scroll down the entries in the machine list.
     1353        </para>
     1354
     1355      </simplesect>
     1356
     1357      <simplesect id="gui-tools-machine">
     1358
     1359        <title>Machine Tools</title>
     1360
     1361        <para>
     1362          In the machine list in the left pane of the &vbox-mgr; window,
     1363          select a virtual machine.
     1364        </para>
     1365
     1366        <para>
     1367          Click the <emphasis role="bold">Menu</emphasis> icon to the
     1368          right of the virtual machine name. The
     1369          <emphasis role="bold">Machine Tools</emphasis> menu is
     1370          displayed.
     1371        </para>
     1372
     1373        <figure id="fig-machine-tools-menu">
     1374          <title>Machine Tools Menu</title>
     1375      <mediaobject>
     1376        <imageobject>
     1377          <imagedata align="center" fileref="images/machine-tools-menu.png"
     1378                     width="10cm" />
     1379        </imageobject>
     1380      </mediaobject>
     1381        </figure>
     1382
     1383        <para>
     1384          A drop-down list enables you to select from the following
     1385          machine tools:
     1386        </para>
     1387
     1388        <itemizedlist>
     1389
     1390          <listitem>
     1391            <para>
     1392              <emphasis role="bold">Details.</emphasis> Displays the
     1393              Details pane for the selected virtual machine. See
     1394              <xref linkend="gui-details"/>.
     1395            </para>
     1396          </listitem>
     1397
     1398          <listitem>
     1399            <para>
     1400              <emphasis role="bold">Snapshots.</emphasis> Displays the
     1401              <emphasis role="bold">Snapshots</emphasis> tool. This tool
     1402              enables you to view and manage snapshots for the virtual
     1403              machine. See <xref linkend="snapshots"/>.
     1404            </para>
     1405          </listitem>
     1406
     1407          <listitem>
     1408            <para>
     1409              <emphasis role="bold">Logs.</emphasis> Displays the
     1410              <emphasis role="bold">Log Viewer</emphasis> tool. This
     1411              tool enables you to view and search system logs for the
     1412              virtual machine. See <xref linkend="log-viewer"/>.
     1413            </para>
     1414          </listitem>
     1415
     1416          <listitem>
     1417            <para>
     1418              <emphasis role="bold">Activity.</emphasis> Displays the
     1419              <emphasis role="bold">VM Activity</emphasis> page of the
     1420              <emphasis role="bold">Session Information</emphasis>
     1421              dialog. This dialog enables you to view and analyze
     1422              performance metrics for the virtual machine. See
     1423              <xref linkend="vm-info"/>.
     1424            </para>
     1425          </listitem>
     1426
     1427          <listitem>
     1428            <para>
     1429              <emphasis role="bold">File Manager.</emphasis> Displays
     1430              the <emphasis role="bold">Guest Control File
     1431              Manager</emphasis> tool. This tool enables you to manage
     1432              files on the guest system. See
     1433              <xref linkend="guestadd-gc-file-manager"/>.
     1434            </para>
     1435          </listitem>
     1436
     1437        </itemizedlist>
     1438
     1439      </simplesect>
     1440
     1441    </sect2>
     1442
     1443    <sect2 id="help-viewer">
     1444
     1445      <title>Help Viewer</title>
     1446
     1447      <para>
     1448        The Help Viewer is a window that displays context-sensitive help
     1449        to assist you in completing common &vbox-mgr; tasks. You can
     1450        display the Help Viewer in the following ways:
     1451      </para>
     1452
     1453      <itemizedlist>
     1454
     1455        <listitem>
     1456          <para>
     1457            In a &vbox-mgr; wizard or dialog, click
     1458            <emphasis role="bold">Help</emphasis> to display the
     1459            relevant help topic.
     1460          </para>
     1461        </listitem>
     1462
     1463        <listitem>
     1464          <para>
     1465            In &vbox-mgr; or from a guest VM, do either of the
     1466            following:
     1467          </para>
     1468
     1469          <itemizedlist>
     1470
     1471            <listitem>
     1472              <para>
     1473                Select the <emphasis role="bold">Help</emphasis>,
     1474                <emphasis role="bold">Contents</emphasis> menu option.
     1475              </para>
     1476            </listitem>
     1477
     1478            <listitem>
     1479              <para>
     1480                Press the <emphasis role="bold">F1</emphasis> button.
     1481              </para>
     1482
     1483              <para>
     1484                The keyboard shortcut used to access the Help Viewer can
     1485                be configured in the
     1486                <emphasis role="bold">Preferences</emphasis> window.
     1487              </para>
     1488            </listitem>
     1489
     1490          </itemizedlist>
     1491        </listitem>
     1492
     1493      </itemizedlist>
     1494
     1495      <para>
     1496        The Help Viewer has the following features:
     1497      </para>
     1498
     1499      <itemizedlist>
     1500
     1501        <listitem>
     1502          <para>
     1503            <emphasis role="bold">Navigation tools.</emphasis> The left
     1504            hand pane contains the following navigation tools:
     1505          </para>
     1506
     1507          <itemizedlist>
     1508
     1509            <listitem>
     1510              <para>
     1511                <emphasis role="bold">Contents.</emphasis> Displays the
     1512                help topic location in the &product-name; documentation.
     1513              </para>
     1514            </listitem>
     1515
     1516            <listitem>
     1517              <para>
     1518                <emphasis role="bold">Search.</emphasis> Enables you to
     1519                search the documentation for help topics.
     1520              </para>
     1521            </listitem>
     1522
     1523            <listitem>
     1524              <para>
     1525                <emphasis role="bold">Bookmarks.</emphasis> Enables you
     1526                to bookmark useful help topics.
     1527              </para>
     1528            </listitem>
     1529
     1530          </itemizedlist>
     1531        </listitem>
     1532
     1533        <listitem>
     1534          <para>
     1535            <emphasis role="bold">Tabbed browsing.</emphasis> Help
     1536            topics that you have visited are displayed in tabs in the
     1537            main window pane.
     1538          </para>
     1539        </listitem>
     1540
     1541        <listitem>
     1542          <para>
     1543            <emphasis role="bold">Zoomable topics.</emphasis> Zoom
     1544            controls enable you to enlarge help topic details.
     1545          </para>
     1546        </listitem>
     1547
     1548        <listitem>
     1549          <para>
     1550            <emphasis role="bold">Printing.</emphasis> Help topics can
     1551            be printed to PDF file or to a local printer.
     1552          </para>
     1553        </listitem>
     1554
     1555      </itemizedlist>
     1556
     1557    </sect2>
     1558
     1559    <sect2 id="vboxmanager-wizards">
     1560
     1561      <title>About &vbox-mgr; Wizards</title>
     1562
     1563      <para>
     1564        &vbox-mgr; includes wizards that enable you to complete tasks
     1565        easily. Examples of such tasks are when you create a new virtual
     1566        machine or use the cloud integration features of &product-name;.
     1567      </para>
     1568
     1569      <para>
     1570        To display a help topic for the wizard, click the
     1571        <emphasis role="bold">Help</emphasis> button.
     1572      </para>
     1573
     1574      <para>
     1575        Some wizards can be displayed in either of the following modes:
     1576      </para>
     1577
     1578      <itemizedlist>
     1579
     1580        <listitem>
     1581          <para>
     1582            <emphasis role="bold">Guided mode.</emphasis> This is the
     1583            default display mode. Wizards are shown in the conventional
     1584            manner, using a series of pages with descriptions to guide
     1585            the user through the steps for a task.
     1586          </para>
     1587        </listitem>
     1588
     1589        <listitem>
     1590          <para>
     1591            <emphasis role="bold"><emphasis role="bold">Expert
     1592            mode.</emphasis></emphasis> This display mode is designed
     1593            for more advanced users of &product-name;. All settings are
     1594            displayed on a single page, enabling quicker completion of
     1595            tasks.
     1596          </para>
     1597        </listitem>
     1598
     1599      </itemizedlist>
     1600
     1601      <para>
     1602        Click the button at the bottom of the wizard window to switch
     1603        between Guided mode and Expert mode.
     1604      </para>
     1605
     1606    </sect2>
     1607
    9571608  </sect1>
    9581609
    959   <sect1 id="gui-createvm">
     1610  <sect1 id="create-vm-wizard">
    9601611
    9611612    <title>Creating Your First Virtual Machine</title>
    9621613
    9631614    <para>
    964       Selecting <emphasis role="bold">New</emphasis> menu item from
    965       <emphasis role="bold">Machine</emphasis> menu of the Manager Window
    966       shows a wizard which guides you through setting up a new virtual
    967       machine (VM).
     1615      Click <emphasis role="bold">New</emphasis> in the VirtualBox
     1616      Manager window. The <emphasis role="bold">Create Virtual
     1617      Machine</emphasis> wizard is shown, to guide you through the
     1618      required steps for setting up a new virtual machine (VM).
    9681619    </para>
    9691620
    970     <figure id="fig-new-vm-name">
    971       <title>Creating a New Virtual Machine: Name and Operating System</title>
    972     <mediaobject>
     1621    <para>
     1622      The <emphasis role="bold">Create Virtual Machine</emphasis> wizard
     1623      pages are described in the following sections.
     1624    </para>
     1625
     1626    <sect2 id="create-vm-wizard-name-os">
     1627
     1628      <title>Create Virtual Machine Wizard: Name and Operating System</title>
     1629
     1630      <figure id="fig-create-vm-name">
     1631        <title>Creating a Virtual Machine: Name and Operating System</title>
     1632      <mediaobject>
    9731633        <imageobject>
    9741634          <imagedata align="center" fileref="images/create-vm-1.png"
    … …  
    9761636        </imageobject>
    9771637      </mediaobject>
    978     </figure>
    979 
    980     <para>
    981       On the following pages, the wizard will ask you for the bare
    982       minimum of information that is needed to create a VM, in
    983       particular:
    984     </para>
    985 
    986     <orderedlist>
    987       <listitem>
    988         <para>
    989           The first page lets you specify name, location, and guest
    990           operating system type. Additionally you can enable the unattended
    991           guest operating system install feature (<xref linkend="gui-wizard-unattended"/>.).
    992         </para>
    993         <itemizedlist>
    994           <listitem>
    995             <para>
    996               The <emphasis role="bold">Name</emphasis> of the VM you choose
    997               is shown in the machine list of the VirtualBox Manager window
    998               and is also used for the VM's files on disk.
    999             </para>
    1000             <para>
    1001               Be sure to assign each VM an informative name that describes
    1002               the OS and software running on the VM. For example,
    1003               <literal>Windows 10 with Visio</literal>.
    1004             </para>
    1005           </listitem>
    1006           <listitem>
    1007             <para>
    1008               The <emphasis role="bold">Folder</emphasis> is the location
    1009               where VMs are stored on your computer. The default folder
    1010               location is shown.
    1011             </para>
    1012           </listitem>
    1013           <listitem>
    1014             <para>
    1015               The <emphasis role="bold">ISO Image</emphasis> is ISO file which
    1016               may be used to install the guest operating system or to be attached
    1017               to DVD drive of the new virtual machine. Note that selecting
    1018               an ISO image is optional. Please see the section <xref linkend="gui-wizard-unattended"/>.
    1019             </para>
    1020           </listitem>
    1021           <listitem>
    1022             <para>
    1023               For <emphasis role="bold">Type</emphasis>,
    1024               select the OS that you want to install. The supported OSes are
    1025               grouped. If you want to install something very unusual that is
    1026               not listed, select <emphasis role="bold">Other</emphasis>.
    1027               Depending on your selection, &product-name; will enable or
    1028               disable certain VM settings that your guest OS may require.
    1029               This is particularly important for 64-bit guests. See
    1030               <xref linkend="intro-64bitguests" />. It is therefore
    1031               recommended to always set it to the correct value. Also note
    1032               that if an ISO image is selected and &product-name; is able to detect
    1033               an operating system from that ISO, <emphasis role="bold">Type</emphasis>
    1034               and <emphasis role="bold">Version</emphasis> controls are populated
    1035               accordingly and disabled.
    1036             </para>
    1037           </listitem>
    1038           <listitem>
    1039             <para>
    1040               The checkox <emphasis role="bold">Skip Unattended Installation</emphasis>
    1041               can be used to disable unattended guest OS installation even if an ISO
    1042               image is selected that supports unattended install. In that case the
    1043               selected ISO image is inserted DVD drive of the new virtual machine.
    1044             </para>
    1045           </listitem>
    1046         </itemizedlist>
    1047       </listitem>
    1048       <listitem>
    1049         <para>
    1050           If unattended install is enabled then the second page of the wizard
    1051           will show some controls which can be used to input values needed during
    1052           unattended installation. These include username, password, host name,
    1053           product key (only applies to some guest operating system type), etc.
    1054           If for some reason unattended install is not enabled, this page is
    1055           skipped.
    1056         </para>
    1057       </listitem>
    1058       <listitem>
    1059         <para>
    1060           On the next page, select the <emphasis role="bold">Base Memory
    1061           </emphasis> that &product-name; should allocate every
    1062           time the virtual machine is started. The amount of memory
    1063           given here will be taken away from your host machine and
    1064           presented to the guest OS, which will report this size as the
    1065           virtual computer's installed RAM. <emphasis role="bold">Processor(s)
    1066           </emphasis> control determines how many virtual processors are to be
    1067           assigned to new virtual machine.
    1068         </para>
    1069         <caution>
    1070           <para>
    1071             Choose this setting carefully. The memory you give to the VM
    1072             will not be available to your host OS while the VM is
    1073             running, so do not specify more than you can spare.
    1074             Also note that it is not advised to assign more than
    1075             half of the processor threads the host machine has.
    1076           </para>
    1077           <para>
    1078             For example, if your host machine has 4 GB of RAM and you
    1079             enter 2048 MB as the amount of RAM for a particular virtual
    1080             machine, you will only have 2 GB left for all the other
    1081             software on your host while the VM is running. If you run
    1082             two VMs at the same time, even more memory will be allocated
    1083             for the second VM, which may not even be able to start if
    1084             that memory is not available.
    1085           </para>
    1086           <para>
    1087             On the other hand, you should specify as much as your guest
    1088             OS and your applications will require to run properly. A
    1089             guest OS may require at least 1 or 2 GB of memory to install
    1090             and boot up. For best performance, more memory than that may
    1091             be required.
    1092           </para>
    1093         </caution>
    1094         <para>
    1095           Always ensure that the host OS has enough RAM remaining. If
    1096           insufficient RAM remains, the system might excessively swap
    1097           memory to the hard disk, which effectively brings the host
    1098           system to a standstill.
    1099         </para>
    1100         <para>
    1101           As with the other settings, you can change this setting later,
    1102           after you have created the VM.
    1103         </para>
    1104       </listitem>
    1105        <listitem>
    1106         <para>
    1107           Next, you must specify a <emphasis role="bold">Virtual Hard
    1108           Disk</emphasis> for your VM.
    1109         </para>
    1110         <para>
    1111           There are many and potentially complicated ways in which
    1112           &product-name; can provide hard disk space to a VM, see
    1113           <xref linkend="storage" />, but the most common way is to use
    1114           a large image file on your physical hard disk, whose contents
    1115           &product-name; presents to your VM as if it were a complete
    1116           hard disk. This file then represents an entire hard disk, so
    1117           you can even copy it to another host and use it with another
    1118           &product-name; installation.
    1119         </para>
    1120         <para>
    1121           The wizard displays the following page:
    1122         </para>
    1123         <figure id="fig-new-vm-hard-disk">
    1124           <title>Creating a New Virtual Machine: Hard Disk</title>
     1638      </figure>
     1639
     1640      <para>
     1641        Use this page to specify a name and operating system (OS) for
     1642        the virtual machine and to change the storage location used for
     1643        VMs.
     1644      </para>
     1645
     1646      <para>
     1647        You can also choose to disable the unattended guest operating
     1648        system install feature. See also
     1649        <xref linkend="create-vm-wizard-unattended-install"/>.
     1650      </para>
     1651
     1652      <para>
     1653        The following fields are available on this wizard page:
     1654      </para>
     1655
     1656      <itemizedlist>
     1657
     1658        <listitem>
     1659          <para>
     1660            <emphasis role="bold">Name.</emphasis> A name for the new
     1661            VM. The name you enter is shown in the machine list of
     1662            &vbox-mgr; and is also used for the virtual machine's files
     1663            on disk.
     1664          </para>
     1665
     1666          <para>
     1667            Be sure to assign each VM an informative name that describes
     1668            the OS and software running on the VM. For example, a name
     1669            such as <literal>Windows 10 with Visio</literal>.
     1670          </para>
     1671        </listitem>
     1672
     1673        <listitem>
     1674          <para>
     1675            <emphasis role="bold">Folder.</emphasis> The location where
     1676            VMs are stored on your computer, called the
     1677            <emphasis>machine folder</emphasis>. The default folder
     1678            location is shown.
     1679          </para>
     1680
     1681          <para>
     1682            Ensure that the folder location has enough free space,
     1683            especially if you intend to use the snapshots feature. See
     1684            also <xref linkend="vboxconfigdata-machine-folder"/>.
     1685          </para>
     1686        </listitem>
     1687
     1688        <listitem>
     1689          <para>
     1690            <emphasis role="bold">ISO Image.</emphasis> Select an ISO
     1691            image file. The image file can be used to install an OS on
     1692            the new virtual machine or it can be attached to a DVD drive
     1693            on the new virtual machine.
     1694          </para>
     1695        </listitem>
     1696
     1697        <listitem>
     1698          <para>
     1699            <emphasis role="bold">Type and Version.</emphasis> These
     1700            fields are used to select the OS that you want to install on
     1701            the new virtual machine.
     1702          </para>
     1703
     1704          <para>
     1705            The supported OSes are grouped into types. If you want to
     1706            install something very unusual that is not listed, select
     1707            the <emphasis role="bold">Other</emphasis> type. Depending
     1708            on your selection, &product-name; will enable or disable
     1709            certain VM settings that your guest OS may require. This is
     1710            particularly important for 64-bit guests. See
     1711            <xref linkend="intro-64bitguests" />. It is therefore
     1712            recommended to always set this field to the correct value.
     1713          </para>
     1714
     1715          <para>
     1716            If an ISO image is selected and &product-name; detects the
     1717            operating system for the ISO, the
     1718            <emphasis role="bold">Type</emphasis> and
     1719            <emphasis role="bold">Version</emphasis> fields are
     1720            populated automatically and are disabled.
     1721          </para>
     1722        </listitem>
     1723
     1724        <listitem>
     1725          <para>
     1726            <emphasis role="bold">Skip Unattended
     1727            Installation.</emphasis> Disables unattended guest OS
     1728            installation, even if an ISO image is selected that supports
     1729            unattended installation. In that case, the selected ISO
     1730            image is mounted automatically on the DVD drive of the new
     1731            virtual machine and user interaction is required to complete
     1732            the OS installation.
     1733          </para>
     1734
     1735          <para>
     1736            The unattended installation step in the wizard is skipped.
     1737          </para>
     1738
     1739          <note>
     1740            <para>
     1741              This option is disabled if you do not select an
     1742              installation medium in the <emphasis role="bold">ISO
     1743              Image</emphasis> field.
     1744            </para>
     1745          </note>
     1746        </listitem>
     1747
     1748      </itemizedlist>
     1749
     1750      <para>
     1751        Click <emphasis role="bold">Next</emphasis> to go to the next
     1752        wizard page.
     1753      </para>
     1754
     1755    </sect2>
     1756
     1757    <sect2 id="create-vm-wizard-unattended-install">
     1758
     1759      <title>(Optional) Create Virtual Machine Wizard: Unattended Guest OS Install</title>
     1760
     1761      <para>
     1762        Unattended guest OS installation enables you to install the OS
     1763        on a virtual machine automatically.
     1764      </para>
     1765
     1766      <note>
     1767        <para>
     1768          This page is optional. It is not displayed if you have
     1769          selected the <emphasis role="bold">Skip Unattended
     1770          Installation</emphasis> option on the initial wizard page.
     1771        </para>
     1772      </note>
     1773
     1774      <para>
     1775        Use this page to set up the required parameters for unattended
     1776        guest OS installation and to configure automatic installation of
     1777        the &product-name; Guest Additions. See also
     1778        <xref linkend="create-vm-wizard-unattended-examples"/> for some
     1779        typical scenarios when using automated installation.
     1780      </para>
     1781
     1782      <figure id="fig-create-vm-unattended-install">
     1783        <title>Creating a Virtual Machine: Unattended Guest OS Installation</title>
     1784      <mediaobject>
     1785        <imageobject>
     1786          <imagedata align="center" fileref="images/create-vm-2.png"
     1787                     width="10cm" />
     1788        </imageobject>
     1789      </mediaobject>
     1790      </figure>
     1791
     1792      <para>
     1793        The following fields are available on this wizard page:
     1794      </para>
     1795
     1796      <itemizedlist>
     1797
     1798        <listitem>
     1799          <para>
     1800            <emphasis role="bold">Username and Password.</emphasis>
     1801            Enter the credentials for a default user on the guest OS.
     1802          </para>
     1803        </listitem>
     1804
     1805        <listitem>
     1806          <para>
     1807            <emphasis role="bold">Guest Additions.</emphasis> Enables
     1808            automatic installation of the Guest Additions, following
     1809            installation of the guest OS. Use the drop-down list to
     1810            select the location of the ISO image file for the Guest
     1811            Additions.
     1812          </para>
     1813        </listitem>
     1814
     1815        <listitem>
     1816          <para>
     1817            <emphasis role="bold">Additional Options.</emphasis> The
     1818            following options enable you to perform extra configuration
     1819            of the guest OS:
     1820          </para>
     1821
     1822          <itemizedlist>
     1823
     1824            <listitem>
     1825              <para>
     1826                <emphasis role="bold">Product Key.</emphasis> For
     1827                Windows guests only. Enter the product key required for
     1828                Windows installation.
     1829              </para>
     1830            </listitem>
     1831
     1832            <listitem>
     1833              <para>
     1834                <emphasis role="bold">Hostname.</emphasis> Host name for
     1835                the guest. By default, this is the same as the VM name.
     1836              </para>
     1837            </listitem>
     1838
     1839            <listitem>
     1840              <para>
     1841                <emphasis role="bold">Domain Name.</emphasis> Domain
     1842                name for the guest.
     1843              </para>
     1844            </listitem>
     1845
     1846            <listitem>
     1847              <para>
     1848                <emphasis role="bold">Install in Background.</emphasis>
     1849                Enable headless mode for the VM, where a graphical user
     1850                interface is not shown.
     1851              </para>
     1852            </listitem>
     1853
     1854          </itemizedlist>
     1855        </listitem>
     1856
     1857      </itemizedlist>
     1858
     1859      <para>
     1860        Click <emphasis role="bold">Next</emphasis> to go to the next
     1861        wizard page.
     1862      </para>
     1863
     1864    </sect2>
     1865
     1866    <sect2 id="create-vm-wizard-hardware">
     1867
     1868      <title>Create Virtual Machine Wizard: Hardware</title>
     1869
     1870      <para>
     1871        Use this page to configure hardware settings for the virtual
     1872        machine.
     1873      </para>
     1874
     1875      <figure id="fig-create-vm-hardware">
     1876        <title>Creating a Virtual Machine: Hardware</title>
     1877       <mediaobject>
     1878        <imageobject>
     1879          <imagedata align="center" fileref="images/create-vm-3.png"
     1880                     width="10cm" />
     1881        </imageobject>
     1882      </mediaobject>
     1883      </figure>
     1884
     1885      <para>
     1886        The following fields are available on this wizard page:
     1887      </para>
     1888
     1889      <itemizedlist>
     1890
     1891        <listitem>
     1892          <para>
     1893            <emphasis role="bold">Base Memory.</emphasis> Select the
     1894            amount of RAM that &product-name; should allocate every time
     1895            the virtual machine is started. The amount of memory
     1896            selected here will be taken away from your host machine and
     1897            presented to the guest OS, which will report this size as
     1898            the virtual machines installed RAM.
     1899          </para>
     1900
     1901          <caution>
     1902            <para>
     1903              Choose this setting carefully. The memory you give to the
     1904              VM will not be available to your host OS while the VM is
     1905              running, so do not specify more than you can spare.
     1906            </para>
     1907
     1908            <para>
     1909              For example, if your host machine has 4 GB of RAM and you
     1910              enter 2048 MB as the amount of RAM for a particular
     1911              virtual machine, you will only have 2 GB left for all the
     1912              other software on your host while the VM is running. If
     1913              you run two VMs at the same time, even more memory will be
     1914              allocated for the second VM, which may not even be able to
     1915              start if that memory is not available.
     1916            </para>
     1917
     1918            <para>
     1919              On the other hand, you should specify as much as your
     1920              guest OS and your applications will require to run
     1921              properly. A guest OS may require at least 1 or 2 GB of
     1922              memory to install and boot up. For best performance, more
     1923              memory than that may be required.
     1924            </para>
     1925          </caution>
     1926
     1927          <para>
     1928            Always ensure that the host OS has enough RAM remaining. If
     1929            insufficient RAM remains, the system might excessively swap
     1930            memory to the hard disk, which effectively brings the host
     1931            system to a standstill.
     1932          </para>
     1933
     1934          <para>
     1935            As with other <emphasis role="bold">Create Virtual
     1936            Machine</emphasis> wizard settings, you can change this
     1937            setting later, after you have created the VM.
     1938          </para>
     1939        </listitem>
     1940
     1941        <listitem>
     1942          <para>
     1943            <emphasis role="bold">Processor(s).</emphasis> Select the
     1944            number of virtual processors to assign to the VM.
     1945          </para>
     1946
     1947          <para>
     1948            It is not advised to assign more than half of the total
     1949            processor threads from the host machine.
     1950          </para>
     1951        </listitem>
     1952
     1953        <listitem>
     1954          <para>
     1955            <emphasis role="bold">Enable EFI.</emphasis> Enables
     1956            Extensible Firware Interface (EFI) booting for the guest OS.
     1957          </para>
     1958        </listitem>
     1959
     1960      </itemizedlist>
     1961
     1962      <para>
     1963        Click <emphasis role="bold">Next</emphasis> to go to the next
     1964        wizard page.
     1965      </para>
     1966
     1967    </sect2>
     1968
     1969    <sect2 id="create-vm-wizard-virtual-hard-disk">
     1970
     1971      <title>Create Virtual Machine Wizard: Virtual Hard Disk</title>
     1972
     1973      <para>
     1974        Use this page to specify a virtual hard disk for the virtual
     1975        machine.
     1976      </para>
     1977
     1978      <para>
     1979        There are many ways in which &product-name; can provide hard
     1980        disk space to a VM, see <xref linkend="storage" />. The most
     1981        common way is to use a large image file on your physical hard
     1982        disk, whose contents &product-name; presents to your VM as if it
     1983        were a complete hard disk. This file then represents an entire
     1984        hard disk, so you can even copy it to another host and use it
     1985        with another &product-name; installation.
     1986      </para>
     1987
     1988      <figure id="fig-create-vm-hard-disk">
     1989        <title>Creating a New Virtual Machine: Virtual Hard Disk</title>
    11251990        <mediaobject>
    11261991            <imageobject>
    1127               <imagedata align="center" fileref="images/create-vm-2.png"
     1992              <imagedata align="center" fileref="images/create-vm-4.png"
    11281993                           width="10cm" />
    11291994            </imageobject>
    11301995          </mediaobject>
    1131         </figure>
    1132         <para>
    1133           At this screen, you have the following options:
    1134         </para>
    1135         <itemizedlist>
    1136         <listitem>
    1137           <para>
    1138             To create a new, empty virtual hard disk, please select
    1139             <emphasis role="bold">Create a Virtual Hard Disk Now</emphasis>.
    1140             This will create a new disk image file in the new virtual
    1141             machine's folder.
    1142           </para>
    1143           <para>
    1144             The checkbox <emphasis role="bold">Pre-allocate Full Size</emphasis>
    1145             is initially not checked. This results in having a so called
    1146             <emphasis role="bold">dynamically allocated file</emphasis>
    1147             which only grows in size when the guest actually
    1148             stores data on its virtual hard disk. Therefore, this file
    1149             is small initially. As the drive is filled with data, the
    1150             file grows to the specified size. When the mentioned checkbox
    1151             is checked then &product-name; creates a
    1152             <emphasis role="bold">fixed-size file</emphasis> which
    1153             immediately occupies the file specified, even if only a
    1154             fraction of that virtual hard disk space is actually in
    1155             use. While occupying much more space, a fixed-size file
    1156             incurs less overhead and is therefore slightly faster than
    1157             a dynamically allocated file.
    1158           </para>
    1159           <para>
    1160             For more details on the differences between
    1161             <emphasis role="bold">dynamically allocated file</emphasis> and
    1162             <emphasis role="bold">fixed-size file</emphasis> please  see
    1163             <xref linkend="vdidetails" />.
    1164           </para>
    1165           <para>
    1166             To prevent your physical hard disk (host OS) from filling up,
    1167             &product-name; limits the size of the image file. But the
    1168             image file must be large enough to hold the contents of the
    1169             guest OS and the applications you want to install. For a
    1170             Windows or Linux guest, you will probably need several
    1171             gigabytes for any serious use. The limit of the image file
    1172             size can be changed later, see
    1173             <xref linkend="vboxmanage-modifymedium"/>.
    1174           </para>
    1175         </listitem>
    1176         <listitem>
    1177             <para>
    1178               You can pick an existing disk image
    1179               file by selecting <emphasis role="bold">Use
    1180               a Existing Virtual Hard Disk File </emphasis>.
    1181             </para>
    1182 
    1183             <para>
    1184               The drop-down list presented in the window lists all disk
    1185               images which are currently remembered by &product-name;.
    1186               These disk images are currently attached to a virtual
    1187               machine, or have been attached to a virtual machine.
    1188             </para>
    1189 
    1190             <para>
    1191               Alternatively, click on the small
    1192               <emphasis role="bold">folder icon</emphasis> next to the
    1193               drop-down list. In the displayed file dialog, you can
    1194               click <emphasis role="bold">Add</emphasis> to select any
    1195               disk image file on your host disk.
    1196             </para>
    1197           </listitem>
    1198           <listitem>
    1199             <para>
    1200               You can skip attaching a virtual hard disk file to the
    1201               new virtual machine you are creating. Note that you will
    1202               need to attach an hard disk later on in order to install a
    1203               guest operating system.
    1204             </para>
    1205           </listitem>
     1996      </figure>
     1997
     1998      <para>
     1999        The following fields are available on this wizard page:
     2000      </para>
     2001
     2002      <itemizedlist>
     2003
     2004        <listitem>
     2005          <para>
     2006            <emphasis role="bold">Create a Virtual Hard Disk
     2007            Now</emphasis>. Creates a new empty virtual hard disk image,
     2008            located in the VM's machine folder.
     2009          </para>
     2010
     2011          <para>
     2012            Enter the following settings:
     2013          </para>
     2014
     2015          <itemizedlist>
     2016
     2017            <listitem>
     2018              <para>
     2019                <emphasis role="bold">Disk Size</emphasis>. Use the
     2020                slider to select a maximum size for the hard disk in the
     2021                new VM.
     2022              </para>
     2023            </listitem>
     2024
     2025            <listitem>
     2026              <para>
     2027                <emphasis role="bold">Pre-Allocate Full Size.</emphasis>
     2028                This setting determines the type of image file used for
     2029                the disk image. Select this setting to use a
     2030                <emphasis>fixed-size file</emphasis> for the disk image.
     2031                Deselect this setting to use a <emphasis>dynamically
     2032                allocated file</emphasis> for the disk image.
     2033              </para>
     2034
     2035              <para>
     2036                The different types of image file behave as follows:
     2037              </para>
     2038
     2039              <itemizedlist>
     2040
     2041                <listitem>
     2042                  <para>
     2043                    <emphasis role="bold">Dynamically allocated
     2044                    file.</emphasis> This type of image file only grows
     2045                    in size when the guest actually stores data on its
     2046                    virtual hard disk. Therefore, this file is small
     2047                    initially. As the drive is filled with data, the
     2048                    file grows to the specified size.
     2049                  </para>
     2050                </listitem>
     2051
     2052                <listitem>
     2053                  <para>
     2054                    <emphasis role="bold">Fixed-size file.</emphasis>
     2055                    This type of image file immediately occupies the
     2056                    file specified, even if only a fraction of that
     2057                    virtual hard disk space is actually in use. While
     2058                    occupying much more space, a fixed-size file incurs
     2059                    less overhead and is therefore slightly faster than
     2060                    a dynamically allocated file.
     2061                  </para>
     2062                </listitem>
     2063
     2064              </itemizedlist>
     2065
     2066              <para>
     2067                For more details about the differences, see
     2068                <xref linkend="vdidetails" />.
     2069              </para>
     2070            </listitem>
     2071
     2072          </itemizedlist>
     2073        </listitem>
     2074
     2075        <listitem>
     2076          <para>
     2077            <emphasis role="bold">Use an Existing Hard Disk
     2078            File.</emphasis> Enables you to select an
     2079            <emphasis>existing</emphasis> disk image file to use with
     2080            the new VM.
     2081          </para>
     2082
     2083          <para>
     2084            The drop-down list presented in the window lists all disk
     2085            images which are known by &product-name;. These disk images
     2086            are currently attached to a virtual machine, or have been
     2087            attached to a virtual machine.
     2088          </para>
     2089
     2090          <para>
     2091            Alternatively, click on the small folder icon next to the
     2092            drop-down list. In the <emphasis role="bold">Hard Disk
     2093            Selector</emphasis> window that is displayed, click
     2094            <emphasis role="bold">Add</emphasis> to select a disk image
     2095            file on your host disk.
     2096          </para>
     2097        </listitem>
     2098
     2099        <listitem>
     2100          <para>
     2101            <emphasis role="bold">Do Not Add a Virtual Hard
     2102            Disk.</emphasis> The new VM is created without a hard disk.
     2103          </para>
     2104        </listitem>
     2105
    12062106      </itemizedlist>
    1207         <para>
    1208           If you are using &product-name; for the first time, you will
    1209           want to create a new disk image. Select
    1210           <emphasis role="bold">Create a Virtual Hard Disk Now</emphasis> button.
    1211         </para>
    1212         <para>
    1213           After having selected or created your image file, click
    1214           <emphasis role="bold">Next</emphasis> to go to the next page.
    1215         </para>
    1216       </listitem>
    1217       <listitem>
    1218         <para>The next page summarizes several attributes of the virtual
    1219         machine to be created. If you are not appy if any of them you
    1220         can use <emphasis role="bold">Back</emphasis> button to go
    1221         back to corresponding page to modify it.</para>
    1222         <para>
    1223           Alternatively you can click <emphasis role="bold">Finish</emphasis>,
    1224           to create your new virtual machine. The virtual machine is displayed
    1225           in the list on the left side of the VirtualBox Manager window, with
    1226           the name that you entered initially.
    1227         </para>
    1228       </listitem>
    1229     </orderedlist>
    1230     <note>
    1231       <para>
    1232         After becoming familiar with the use of wizards, consider using
    1233         the Expert Mode available in some wizards. Where available, this
    1234         is selectable using a button, and speeds up the process of using
    1235         wizards.
    1236       </para>
    1237     </note>
    1238     <sect2 id="gui-wizard-unattended">
    1239       <title>Unattended Install</title>
    1240       <para>
    1241         When supported by the selected ISO &product-name; attempts to install
    1242         the guest OS without any user input. When an ISO image is selected
    1243         &product-name; tries to determine type of the OS. If this succeeds and
    1244         if the selected OS is supported for the unattended install then the
    1245         newly created virtual machine is started after this wizard is closed
    1246         and OS install kicks off. Note that it is also possible to skip the
    1247         unattended install by ticking the checkbox "Skip unattended installation".
    1248         In this case the selected ISO is inserted to DVD drive of the new vm. The
    1249         guest OS will need to be installed manually. If OS cannot be determined
    1250         from the selected ISO or determined OS is not supported for the unattended
    1251         installation then again ISO is inserted to the DVD drive of the new virtual
    1252         machine and a manual guest OS install will be necessary.
    1253       </para>
     2107
     2108      <para>
     2109        To prevent your physical hard disk on the host OS from filling
     2110        up, &product-name; limits the size of the image file. But the
     2111        image file must be large enough to hold the contents of the
     2112        guest OS and the applications you want to install. For a Windows
     2113        or Linux guest, you will probably need several gigabytes for any
     2114        serious use. The limit of the image file size can be changed
     2115        later, see <xref linkend="vboxmanage-modifymedium"/>.
     2116      </para>
     2117
     2118      <note>
     2119        <para>
     2120          You can skip attaching a virtual hard disk file to the new
     2121          virtual machine you are creating. But you will then need to
     2122          attach an hard disk later on, in order to install a guest
     2123          operating system.
     2124        </para>
     2125      </note>
     2126
     2127      <para>
     2128        After having selected or created your image file, click
     2129        <emphasis role="bold">Next</emphasis> to go to the next wizard
     2130        page.
     2131      </para>
     2132
    12542133    </sect2>
     2134
     2135    <sect2 id="create-vm-wizard-summary">
     2136
     2137      <title>Create Virtual Machine Wizard: Summary</title>
     2138
     2139      <para>
     2140        This page displays a summary of the configuration for the
     2141        virtual machine.
     2142      </para>
     2143
     2144      <para>
     2145        If you are not happy with any of the settings, use the
     2146        <emphasis role="bold">Back</emphasis> button to return to the
     2147        corresponding page and modify the setting.
     2148      </para>
     2149
     2150      <para>
     2151        Click <emphasis role="bold">Finish</emphasis> to create your new
     2152        virtual machine. The virtual machine is displayed in the machine
     2153        list on the left side of the &vbox-mgr; window, with the name
     2154        that you entered on the first page of the wizard.
     2155      </para>
     2156
     2157    </sect2>
     2158
     2159    <sect2 id="create-vm-wizard-unattended-examples">
     2160
     2161      <title>Some Examples of Unattended Installation</title>
     2162
     2163      <para>
     2164        To configure unattended installation, you typically just need to
     2165        specify an ISO image in the <emphasis role="bold">Create Virtual
     2166        Machine</emphasis> wizard. &product-name; then detects the OS
     2167        type and the unattended installation process is done
     2168        automatically when the wizard is completed. However, in some
     2169        situations the installation may need be completed manually.
     2170      </para>
     2171
     2172      <para>
     2173        The following list describes some common scenarios for
     2174        unattended installation:
     2175      </para>
     2176
     2177      <itemizedlist>
     2178
     2179        <listitem>
     2180          <para>
     2181            <emphasis role="bold">OS type is detected
     2182            automatically.</emphasis> The following outcomes are
     2183            possible:
     2184          </para>
     2185
     2186          <itemizedlist>
     2187
     2188            <listitem>
     2189              <para>
     2190                If unattended installation is supported for the selected
     2191                ISO, the guest OS is installed automatically. No user
     2192                input is required.
     2193              </para>
     2194            </listitem>
     2195
     2196            <listitem>
     2197              <para>
     2198                If unattended installation is not supported for the
     2199                selected ISO, the ISO image is inserted automatically
     2200                into the DVD drive of the new VM. The guest OS
     2201                installation must then be completed manually.
     2202              </para>
     2203            </listitem>
     2204
     2205          </itemizedlist>
     2206        </listitem>
     2207
     2208        <listitem>
     2209          <para>
     2210            <emphasis role="bold">OS type is not detected
     2211            automatically.</emphasis> You must configure
     2212            <emphasis role="bold">Type</emphasis> and
     2213            <emphasis role="bold">Version</emphasis> settings in the
     2214            wizard.
     2215          </para>
     2216
     2217          <para>
     2218            The ISO image is inserted automatically into the DVD drive
     2219            of the new VM. The guest OS installation must then be
     2220            completed manually.
     2221          </para>
     2222        </listitem>
     2223
     2224        <listitem>
     2225          <para>
     2226            <emphasis role="bold">Unattended Installation is
     2227            disabled.</emphasis> Users can disable unattended
     2228            installation, by selecting the <emphasis role="bold">Skip
     2229            Unattended Installation</emphasis> check box on the initial
     2230            wizard page.
     2231          </para>
     2232
     2233          <para>
     2234            The ISO image is inserted automatically into the DVD drive
     2235            of the new VM. The guest OS installation must then be
     2236            completed manually.
     2237          </para>
     2238        </listitem>
     2239
     2240      </itemizedlist>
     2241
     2242      <para>
     2243        See also <xref linkend="basic-unattended"/> for details of how
     2244        to perform unattended installation from the command line.
     2245      </para>
     2246
     2247    </sect2>
     2248
    12552249  </sect1>
    12562250
    … …  
    12602254
    12612255    <para>
    1262       To start a virtual machine, you have several options:
     2256      To start a virtual machine, you have the following options:
    12632257    </para>
    12642258
    … …  
    12672261      <listitem>
    12682262        <para>
    1269           Double-click on the VM's entry in the list in the VirtualBox
    1270           Manager window.
    1271         </para>
    1272       </listitem>
    1273 
    1274       <listitem>
    1275         <para>
    1276           Select the VM's entry in the list in the VirtualBox Manager
    1277           window, and click <emphasis role="bold">Start</emphasis> at
     2263          Double-click on the VM's entry in the machine list in
     2264          &vbox-mgr;.
     2265        </para>
     2266      </listitem>
     2267
     2268      <listitem>
     2269        <para>
     2270          Select the VM's entry in the machine list in &vbox-mgr;, and
     2271          click <emphasis role="bold">Start</emphasis> in the toolbar
    12782272          the top of the window.
    12792273        </para>
    … …  
    12962290      machine which you selected will boot up. Everything which would
    12972291      normally be seen on the virtual system's monitor is shown in the
    1298       window. See the screenshot image in
    1299       <xref linkend="Introduction"/>.
     2292      window. See <xref linkend="fig-win2016-intro"/>.
    13002293    </para>
    13012294
    13022295    <para>
    13032296      In general, you can use the virtual machine as you would use a
    1304       real computer. There are couple of points worth mentioning
    1305       however.
     2297      real computer. The following topics describe a few points to note
     2298      when running a VM.
    13062299    </para>
    13072300
    … …  
    13112304
    13122305      <para>
    1313         When a VM is started for the first time, the
    1314         <emphasis role="bold">First Start Wizard</emphasis>, is
    1315         displayed. This wizard helps you to select an installation
    1316         medium. Since the VM is created empty, it would otherwise behave
    1317         just like a real computer with no OS installed. It will do
    1318         nothing and display an error message that no bootable OS was
    1319         found.
    1320       </para>
    1321 
    1322       <para>
    1323         For this reason, the wizard helps you to select a medium to
    1324         install an OS from.
    1325       </para>
    1326 
    1327       <itemizedlist>
    1328 
    1329         <listitem>
    1330           <para>
    1331             If you have physical CD or DVD media from which you want to
    1332             install your guest OS, such as a Windows installation CD or
    1333             DVD, put the media into your host's CD or DVD drive.
    1334           </para>
    1335 
    1336           <para>
    1337             In the wizard's drop-down list of installation media, select
    1338             <emphasis role="bold">Host Drive</emphasis> with the correct
    1339             drive letter. In the case of a Linux host, choose a device
    1340             file. This will allow your VM to access the media in your
    1341             host drive, and you can proceed to install from there.
    1342           </para>
    1343         </listitem>
    1344 
    1345         <listitem>
    1346           <para>
    1347             If you have downloaded installation media from the Internet
    1348             in the form of an ISO image file such as with a Linux
    1349             distribution, you would normally burn this file to an empty
    1350             CD or DVD and proceed as described above. With
    1351             &product-name; however, you can skip this step and mount the
    1352             ISO file directly. &product-name; will then present this
    1353             file as a CD or DVD-ROM drive to the virtual machine, much
    1354             like it does with virtual hard disk images.
    1355           </para>
    1356 
    1357           <para>
    1358             In this case, the wizard's drop-down list contains a list of
    1359             installation media that were previously used with
    1360             &product-name;.
    1361           </para>
    1362 
    1363           <para>
    1364             If your medium is not in the list, especially if you are
    1365             using &product-name; for the first time, click the small
    1366             folder icon next to the drop-down list to display a standard
    1367             file dialog. Here you can pick an image file on your host
    1368             disks.
    1369           </para>
    1370         </listitem>
    1371 
    1372       </itemizedlist>
    1373 
    1374       <para>
    1375         After completing the choices in the wizard, you will be able to
    1376         install your OS.
    1377       </para>
     2306        When you start a VM for the first time the OS installation
     2307        process is started automatically, using the ISO image file
     2308        specified in the <emphasis role="bold">Create Virtual
     2309        Machine</emphasis> wizard.
     2310      </para>
     2311
     2312      <para>
     2313        Follow the onscreen instructions to install your OS.
     2314      </para>
     2315
     2316<!--  <para>
     2317        If you have physical CD or DVD media from which you want to
     2318        install your guest OS, such as a Windows installation CD or DVD,
     2319        put the media into your host's CD or DVD drive.
     2320      </para>
     2321
     2322      <para>
     2323        If you have downloaded installation media from the Internet in
     2324        the form of an ISO image file such as with a Linux distribution,
     2325        you could burn this file to an empty CD or DVD and proceed as
     2326        described above. With &product-name; however, you can skip this
     2327        step and mount the ISO file directly. &product-name; will then
     2328        present this file as a CD or DVD-ROM drive to the virtual
     2329        machine, much like it does with virtual hard disk images.
     2330      </para>-->
    13782331
    13792332    </sect2>
    … …  
    14042357      <para>
    14052358        After installing a guest OS and before you install the Guest
    1406         Additions, described later, either your VM or the rest of your
    1407         computer can "own" the keyboard and the mouse. Both cannot own
    1408         the keyboard and mouse at the same time. You will see a
     2359        Additions, described in <xref linkend="guestadditions"/>, either
     2360        your VM or the rest of your computer can
     2361        <emphasis>own</emphasis> the keyboard and the mouse. Both cannot
     2362        own the keyboard and mouse at the same time. You will see a
    14092363        <emphasis>second</emphasis> mouse pointer which is always
    14102364        confined to the limits of the VM window. You activate the VM by
    … …  
    14182372        <emphasis>right Ctrl key</emphasis> on your keyboard. On a Mac
    14192373        host, the default Host key is the left Command key. You can
    1420         change this default in the &product-name; Global Settings. See
    1421         <xref linkend="globalsettings" />. The current setting for the
    1422         Host key is always displayed at the bottom right of your VM
    1423         window.
     2374        change this default using the Preferences window. See
     2375        <xref linkend="preferences" />. The current setting for the Host
     2376        key is always displayed at the bottom right of your VM window.
    14242377      </para>
    14252378
    14262379      <figure id="fig-host-key">
    1427         <title>Host Key Setting on the Virtual Machine Task Bar</title>
     2380        <title>Host Key Setting on the Virtual Machine Taskbar</title>
    14282381        <mediaobject>
    14292382          <imageobject>
    … …  
    14322385          </imageobject>
    14332386        </mediaobject>
    1434 
    14352387      </figure>
    14362388
    … …  
    15252477            For example, you cannot use the
    15262478            <emphasis role="bold">Ctrl+Alt+Delete</emphasis> combination
    1527             to reboot the guest OS in your VM because this key
    1528             combination is usually hard-wired into the host OS. So, even
    1529             though both the Windows and Linux OSes intercept this key
    1530             combination, only the host OS would be rebooted.
     2479            to reboot the guest OS in your VM, because this key
     2480            combination is reserved by the host OS. Even though both
     2481            Windows and Linux OSes can intercept this key combination,
     2482            the host OS is rebooted automatically.
    15312483          </para>
    15322484
    … …  
    16622614      <para>
    16632615        The settings are the same as those available for the VM in the
    1664         <emphasis role="bold">Settings</emphasis> dialog of the
    1665         &product-name; main window. But as the
    1666         <emphasis role="bold">Settings</emphasis> dialog is disabled
    1667         while the VM is in the Running or Saved state, the
     2616        <emphasis role="bold">Settings</emphasis> window of &vbox-mgr;.
     2617        But as the <emphasis role="bold">Settings</emphasis> window is
     2618        disabled while the VM is in the Running or Saved state, the
    16682619        <emphasis role="bold">Devices</emphasis> menu saves you from
    16692620        having to shut down and restart the VM every time you want to
    … …  
    16942645      </para>
    16952646
    1696       <orderedlist>
     2647      <itemizedlist>
    16972648
    16982649        <listitem>
    … …  
    17542705        </listitem>
    17552706
    1756       </orderedlist>
     2707      </itemizedlist>
    17572708
    17582709    </sect2>
    … …  
    18372788            As an exception, if your virtual machine has any snapshots,
    18382789            see <xref linkend="snapshots"/>, you can use this option to
    1839             quickly <emphasis
    1840           role="bold">restore the current
     2790            quickly <emphasis role="bold">restore the current
    18412791            snapshot</emphasis> of the virtual machine. In that case,
    1842             powering off the machine will not disrupt its state, but any
    1843             changes made since that snapshot was taken will be lost.
     2792            powering off the machine will discard the current state and
     2793            any changes made since the previous snapshot was taken will
     2794            be lost.
    18442795          </para>
    18452796        </listitem>
    … …  
    18492800      <para>
    18502801        The <emphasis role="bold">Discard</emphasis> button in the
    1851         VirtualBox Manager window discards a virtual machine's saved
    1852         state. This has the same effect as powering it off, and the same
    1853         warnings apply.
     2802        &vbox-mgr; window discards a virtual machine's saved state. This
     2803        has the same effect as powering it off, and the same warnings
     2804        apply.
    18542805      </para>
    18552806
    … …  
    18632814
    18642815    <para>
    1865       VM groups enable the user to create ad hoc groups of VMs, and to
    1866       manage and perform functions on them collectively, as well as
    1867       individually.
     2816      VM groups are groups of VMs that you can create as and when
     2817      required. You can manage and perform functions on them
     2818      collectively, as well as individually.
    18682819    </para>
    18692820
    … …  
    18812832        </imageobject>
    18822833      </mediaobject>
    1883 
    18842834    </figure>
    18852835
    … …  
    18922842      <listitem>
    18932843        <para>
    1894           Create a group using the VirtualBox Manager. Do one of the
    1895           following:
     2844          Create a group using &vbox-mgr;. Do one of the following:
    18962845        </para>
    18972846
    … …  
    19002849          <listitem>
    19012850            <para>
    1902               Drag one VM on top of another VM.
     2851              Drag a VM on top of another VM.
    19032852            </para>
    19042853          </listitem>
    … …  
    19312880
    19322881            <para>
    1933               This command creates a group "TestGroup" and attaches the
    1934               VM "vm01" to that group.
     2882              This command creates a group <literal>TestGroup</literal>
     2883              and attaches the VM <literal>vm01</literal> to that group.
    19352884            </para>
    19362885          </listitem>
    … …  
    19452894
    19462895            <para>
    1947               This command detaches all groups from the VM "vm01" and
    1948               deletes the empty group.
     2896              This command detaches all groups from the VM
     2897              <literal>vm01</literal> and deletes the empty group.
    19492898            </para>
    19502899          </listitem>
    … …  
    19612910
    19622911        <para>
    1963           This command creates the groups "TestGroup" and "TestGroup2",
    1964           if they do not exist, and attaches the VM "vm01" to both of
    1965           them.
     2912          This command creates the groups <literal>TestGroup</literal>
     2913          and <literal>TestGroup2</literal>, if they do not exist, and
     2914          attaches the VM <literal>vm01</literal> to both of them.
    19662915        </para>
    19672916      </listitem>
    … …  
    19752924
    19762925        <para>
    1977           This command attaches the VM "vm01" to the subgroup
    1978           "TestGroup2" of the "TestGroup" group.
    1979         </para>
    1980       </listitem>
    1981 
    1982       <listitem>
    1983         <para>
    1984           The following is a summary of group commands: Start, Pause,
    1985           Reset, Close (save state, send shutdown signal, poweroff),
    1986           Discard Saved State, Show in File System, Sort.
     2926          This command attaches the VM <literal>vm01</literal> to the
     2927          subgroup <literal>TestGroup2</literal> of the
     2928          <literal>TestGroup</literal> group.
     2929        </para>
     2930      </listitem>
     2931
     2932      <listitem>
     2933        <para>
     2934          Use &vbox-mgr; menu options to control and manage all the VMs
     2935          in a group. For example:
     2936          <emphasis role="bold">Start</emphasis>,
     2937          <emphasis role="bold">Pause</emphasis>,
     2938          <emphasis role="bold">Reset</emphasis>,
     2939          <emphasis role="bold">Close</emphasis> (save state, send
     2940          shutdown signal, poweroff), <emphasis role="bold">Discard
     2941          Saved State</emphasis>, <emphasis role="bold">Show in
     2942          Explorer</emphasis>, <emphasis role="bold">Sort</emphasis>.
    19872943        </para>
    19882944      </listitem>
    … …  
    20072963    <para>
    20082964      To see the snapshots of a virtual machine, click on the machine
    2009       name in VirtualBox Manager. Then click the
    2010       <emphasis role="bold">List</emphasis> icon next to the machine
    2011       name, and select <emphasis role="bold">Snapshots</emphasis>. Until
    2012       you take a snapshot of the machine, the list of snapshots will be
    2013       empty except for the <emphasis role="bold">Current
    2014       State</emphasis> item, which represents the "now" point in the
    2015       lifetime of the virtual machine.
     2965      name in &vbox-mgr;. In the machine tools menu for the VM, click
     2966      <emphasis role="bold">Snapshots</emphasis>. The Snapshots tool is
     2967      displayed.
    20162968    </para>
    20172969
     2970    <figure id="fig-snapshots-tool">
     2971      <title>Snapshots Tool, Showing Snapshot Properties</title>
     2972       <mediaobject>
     2973        <imageobject>
     2974          <imagedata align="center" fileref="images/snapshots-1.png"
     2975                   width="10cm" />
     2976        </imageobject>
     2977      </mediaobject>
     2978    </figure>
     2979
     2980    <para>
     2981      If you select multiple VMs in the machine list, all snapshots are
     2982      listed for each VM.
     2983    </para>
     2984
     2985    <para>
     2986      Until you take a snapshot of the virtual machine, the list of
     2987      snapshots will be empty, except for the
     2988      <emphasis role="bold">Current State</emphasis> item. This item
     2989      represents the current point in the lifetime of the virtual
     2990      machine.
     2991    </para>
     2992
     2993    <para>
     2994      The Snapshots window includes a toolbar, enabling you to perform
     2995      the following snapshot operations:
     2996    </para>
     2997
     2998    <itemizedlist>
     2999
     3000      <listitem>
     3001        <para>
     3002          <emphasis role="bold">Take.</emphasis> Takes a snapshot of the
     3003          selected VM. See
     3004          <xref linkend="snapshots-take-restore-delete"/>.
     3005        </para>
     3006      </listitem>
     3007
     3008      <listitem>
     3009        <para>
     3010          <emphasis role="bold">Delete.</emphasis> Removes a snapshot
     3011          from the list of snapshots. See
     3012          <xref linkend="snapshots-take-restore-delete"/>.
     3013        </para>
     3014      </listitem>
     3015
     3016      <listitem>
     3017        <para>
     3018          <emphasis role="bold">Restore.</emphasis> Restores the VM
     3019          state to be the same as the selected snapshot. See
     3020          <xref linkend="snapshots-take-restore-delete"/>.
     3021        </para>
     3022      </listitem>
     3023
     3024      <listitem>
     3025        <para>
     3026          <emphasis role="bold">Properties.</emphasis> Displays the
     3027          properties for the selected snapshot. The
     3028          <emphasis role="bold">Attributes</emphasis> tab is used to
     3029          specify a Name and Description for the snapshot. The
     3030          <emphasis role="bold">Information</emphasis> tab shows VM
     3031          settings for the snapshot.
     3032        </para>
     3033      </listitem>
     3034
     3035      <listitem>
     3036        <para>
     3037          <emphasis role="bold">Clone.</emphasis> Displays the
     3038          <emphasis role="bold">Clone Virtual Machine</emphasis> wizard.
     3039          This enables you to create a clone of the VM, based on the
     3040          selected snapshot.
     3041        </para>
     3042      </listitem>
     3043
     3044      <listitem>
     3045        <para>
     3046          <emphasis role="bold">Settings.</emphasis> Available for the
     3047          Current State snapshot only. Displays the
     3048          <emphasis role="bold">Settings</emphasis> window for the VM,
     3049          enabling you to make configuration changes.
     3050        </para>
     3051      </listitem>
     3052
     3053      <listitem>
     3054        <para>
     3055          <emphasis role="bold">Discard.</emphasis> For a running VM,
     3056          discards the saved state for the VM and closes it down.
     3057        </para>
     3058      </listitem>
     3059
     3060      <listitem>
     3061        <para>
     3062          <emphasis role="bold">Start.</emphasis> Start the VM. This
     3063          operation is available for the <emphasis role="bold">Current
     3064          State</emphasis> item.
     3065        </para>
     3066      </listitem>
     3067
     3068    </itemizedlist>
     3069
    20183070    <sect2 id="snapshots-take-restore-delete">
    20193071
    … …  
    20283080        <listitem>
    20293081          <para>
    2030             <emphasis role="bold">Take a snapshot</emphasis>. This makes
     3082            <emphasis role="bold">Take a snapshot.</emphasis> This makes
    20313083            a copy of the machine's current state, to which you can go
    20323084            back at any given time later.
    … …  
    20373089            <listitem>
    20383090              <para>
    2039                 If your VM is running, select <emphasis role="bold">Take
    2040                 Snapshot</emphasis> from the
    2041                 <emphasis role="bold">Machine</emphasis> pull-down menu
    2042                 of the VM window.
     3091                If your VM is running:
     3092              </para>
     3093
     3094              <para>
     3095                Select <emphasis role="bold">Take Snapshot</emphasis>
     3096                from the <emphasis role="bold">Machine</emphasis> menu
     3097                in the VM window.
     3098              </para>
     3099
     3100              <para>
     3101                The VM is paused while the snapshot is being created.
     3102                After snapshot creation, the VM continues to run as
     3103                normal.
    20433104              </para>
    20443105            </listitem>
    … …  
    20473108              <para>
    20483109                If your VM is in either the Saved or the Powered Off
    2049                 state, as displayed next to the VM name in the
    2050                 &product-name; main window, click the
    2051                 <emphasis role="bold">List</emphasis> icon next to the
    2052                 machine name and select
    2053                 <emphasis role="bold">Snapshots</emphasis>. The
    2054                 snapshots window is shown. Do one of the following:
     3110                state, as displayed next to the VM name in the machine
     3111                list:
     3112              </para>
     3113
     3114              <para>
     3115                Display the Snapshots window and do one of the
     3116                following:
    20553117              </para>
    20563118
    … …  
    20593121                <listitem>
    20603122                  <para>
    2061                     Click the <emphasis role="bold">Take</emphasis>
    2062                     icon.
     3123                    Click <emphasis role="bold">Take</emphasis> in the
     3124                    Snapshots window toolbar.
    20633125                  </para>
    20643126                </listitem>
    … …  
    20783140
    20793141          <para>
    2080             In either case, a window is displayed prompting you for a
    2081             snapshot name. This name is purely for reference purposes to
    2082             help you remember the state of the snapshot. For example, a
    2083             useful name would be "Fresh installation from scratch, no
    2084             Guest Additions", or "Service Pack 3 just installed". You
    2085             can also add a longer text in the
    2086             <emphasis role="bold">Description</emphasis> field.
     3142            A dialog is displayed, prompting you for a snapshot name.
     3143            This name is purely for reference purposes, to help you
     3144            remember the state of the snapshot. For example, a useful
     3145            name would be "Fresh installation from scratch, no Guest
     3146            Additions", or "Service Pack 3 just installed". You can also
     3147            add a longer text description in the
     3148            <emphasis role="bold">Snapshot Description</emphasis> field.
    20873149          </para>
    20883150
    … …  
    21003162          <figure id="fig-snapshots-list">
    21013163            <title>Snapshots List For a Virtual Machine</title>
    2102            <mediaobject>
     3164            <mediaobject>
    21033165              <imageobject>
    2104                 <imagedata align="center" fileref="images/snapshots-1.png"
     3166                <imagedata align="center" fileref="images/snapshots-2.png"
    21053167                             width="10cm" />
    21063168              </imageobject>
    … …  
    21203182        <listitem>
    21213183          <para>
    2122             <emphasis role="bold">Restore a snapshot</emphasis>. In the
    2123             list of snapshots, right-click on any snapshot you have
    2124             taken and select <emphasis role="bold">Restore</emphasis>.
    2125             By restoring a snapshot, you go back or forward in time. The
    2126             current state of the machine is lost, and the machine is
    2127             restored to the exact state it was in when the snapshot was
    2128             taken.
     3184            <emphasis role="bold">Restore a snapshot.</emphasis> In the
     3185            Snapshots window, select the snapshot you have taken and
     3186            click <emphasis role="bold">Restore</emphasis> in the
     3187            toolbar. By restoring a snapshot, you go back or forward in
     3188            time. The current state of the machine is lost, and the
     3189            machine is restored to the exact state it was in when the
     3190            snapshot was taken.
    21293191          </para>
    21303192
    … …  
    21583220            alternate reality and to switch between these different
    21593221            histories of the virtual machine. This can result in a whole
    2160             tree of virtual machine snapshots, as shown in the
    2161             screenshot above.
    2162           </para>
    2163         </listitem>
    2164 
    2165         <listitem>
    2166           <para>
    2167             <emphasis role="bold">Delete a snapshot</emphasis>. This
     3222            tree of virtual machine snapshots.
     3223          </para>
     3224        </listitem>
     3225
     3226        <listitem>
     3227          <para>
     3228            <emphasis role="bold">Delete a snapshot.</emphasis> This
    21683229            does not affect the state of the virtual machine, but only
    21693230            releases the files on disk that &product-name; used to store
    21703231            the snapshot data, thus freeing disk space. To delete a
    2171             snapshot, right-click on the snapshot name in the snapshots
    2172             tree and select <emphasis role="bold">Delete</emphasis>.
    2173             Snapshots can be deleted even while a machine is running.
     3232            snapshot, select the snapshot name in the Snapshots window
     3233            and click <emphasis role="bold">Delete</emphasis> in the
     3234            toolbar. Snapshots can be deleted even while a machine is
     3235            running.
    21743236          </para>
    21753237
    … …  
    23063368        The <emphasis role="bold">Settings</emphasis> button is disabled
    23073369        while a VM is either in the Running or Saved state. This is
    2308         because the <emphasis role="bold">Settings</emphasis> dialog
     3370        because the <emphasis role="bold">Settings</emphasis> window
    23093371        enables you to change fundamental characteristics of the virtual
    23103372        machine that is created for your guest OS. For example, the
    … …  
    23433405        <para>
    23443406          <emphasis role="bold">Removing a VM.</emphasis> To remove a
    2345           VM, right-click on the VM in the VirtualBox Manager's machine
    2346           list and select <emphasis role="bold">Remove</emphasis>.
     3407          VM, right-click on the VM in the &vbox-mgr; machine list and
     3408          select <emphasis role="bold">Remove</emphasis>.
    23473409        </para>
    23483410
    … …  
    23633425          <emphasis role="bold">Moving a VM.</emphasis> To move a VM to
    23643426          a new location on the host, right-click on the VM in the
    2365           VirtualBox Manager's machine list and select
    2366           <emphasis
    2367           role="bold">Move</emphasis>.
     3427          &vbox-mgr;'s machine list and select
     3428          <emphasis role="bold">Move</emphasis>.
    23683429        </para>
    23693430
    … …  
    23933454    <para>
    23943455      For information about removing or moving a disk image file from
    2395       &product-name;, see <xref linkend="vdis"/>.
     3456      &product-name;, see <xref linkend="virtual-media-manager"/>.
    23963457    </para>
    23973458
    … …  
    24143475    </para>
    24153476
    2416     <figure id="fig-clone-wizard">
    2417       <title>The Clone Virtual Machine Wizard</title>
     3477    <para>
     3478      You can start the Clone Virtual Machine wizard in one of the
     3479      following ways:
     3480    </para>
     3481
     3482    <itemizedlist>
     3483
     3484      <listitem>
     3485        <para>
     3486          Click the VM name in the machine list and then select
     3487          <emphasis role="bold">Clone</emphasis> from the
     3488          <emphasis role="bold">Machine</emphasis> menu.
     3489        </para>
     3490      </listitem>
     3491
     3492      <listitem>
     3493        <para>
     3494          Click <emphasis role="bold">Clone</emphasis> in the
     3495          <emphasis role="bold">Snapshots</emphasis> window for the
     3496          selected VM.
     3497        </para>
     3498      </listitem>
     3499
     3500    </itemizedlist>
     3501
     3502    <note>
     3503      <para>
     3504        The <emphasis role="bold">Clone</emphasis> menu item is disabled
     3505        while a virtual machine is running.
     3506      </para>
     3507    </note>
     3508
     3509    <para>
     3510      The <emphasis role="bold">New Machine Name and Path</emphasis>
     3511      page is displayed.
     3512    </para>
     3513
     3514    <figure id="fig-clone-wizard-name-path">
     3515      <title>Clone Virtual Machine Wizard: New Machine Name and Path</title>
    24183516      <mediaobject>
    24193517        <imageobject>
    2420           <imagedata align="center" fileref="images/clone-vm.png"
     3518          <imagedata align="center" fileref="images/clone-vm-1.png"
    24213519                   width="10cm" />
    24223520        </imageobject>
    … …  
    24253523
    24263524    <para>
    2427       Start the wizard by clicking
    2428       <emphasis role="bold">Clone</emphasis> in the right-click menu of
    2429       the VirtualBox Manager's machine list or in the
    2430       <emphasis role="bold">Snapshots</emphasis> view of the selected
    2431       VM.
    2432     </para>
    2433 
    2434     <para>
    2435       Specify a new <emphasis role="bold">Name</emphasis> for the clone.
    2436       You can choose a <emphasis role="bold">Path</emphasis> for the
    2437       cloned virtual machine, otherwise &product-name; uses the default
    2438       machines folder.
    2439     </para>
    2440 
    2441     <para>
    2442       The <emphasis role="bold">Clone Type</emphasis> option specifies
    2443       whether to create a clone linked to the source VM or to create a
    2444       fully independent clone:
    2445     </para>
    2446 
    2447     <itemizedlist>
    2448 
    2449       <listitem>
    2450         <para>
    2451           <emphasis role="bold">Full Clone:</emphasis> Copies all
    2452           dependent disk images to the new VM folder. A full clone can
    2453           operate fully without the source VM.
    2454         </para>
    2455       </listitem>
    2456 
    2457       <listitem>
    2458         <para>
    2459           <emphasis role="bold">Linked Clone:</emphasis> Creates new
    2460           differencing disk images based on the source VM disk images.
    2461           If you select the current state of the source VM as the clone
    2462           point, &product-name; creates a new snapshot.
    2463         </para>
    2464       </listitem>
    2465 
    2466     </itemizedlist>
    2467 
    2468     <para>
    2469       The <emphasis role="bold">Snapshots</emphasis> option specifies
    2470       whether to create a clone of the current machine state only or of
    2471       everything.
    2472     </para>
    2473 
    2474     <itemizedlist>
    2475 
    2476       <listitem>
    2477         <para>
    2478           <emphasis role="bold">Everything:</emphasis> Clones the
    2479           current machine state and all its snapshots.
    2480         </para>
    2481       </listitem>
    2482 
    2483       <listitem>
    2484         <para>
    2485           <emphasis role="bold">Current Machine State and All
    2486           Children:</emphasis>. Clones a VM snapshot and all its child
    2487           snapshots.
    2488         </para>
    2489       </listitem>
    2490 
    2491     </itemizedlist>
    2492 
    2493     <para>
    24943525      The following clone options are available:
    24953526    </para>
    … …  
    24993530      <listitem>
    25003531        <para>
     3532          <emphasis role="bold">Name:</emphasis> A name for the cloned
     3533          machine.
     3534        </para>
     3535      </listitem>
     3536
     3537      <listitem>
     3538        <para>
     3539          <emphasis role="bold">Path:</emphasis> Choose a location for
     3540          the cloned virtual machine, otherwise &product-name; uses the
     3541          default machines folder.
     3542        </para>
     3543      </listitem>
     3544
     3545      <listitem>
     3546        <para>
    25013547          <emphasis role="bold">MAC Address Policy:</emphasis> Specifies
    2502           how to retain network card MAC addresses when cloning the VM.
     3548          whether to retain network card MAC addresses when cloning the
     3549          VM.
    25033550        </para>
    25043551
    … …  
    25323579
    25333580    <para>
     3581      Click <emphasis role="bold">Next</emphasis>. The
     3582      <emphasis role="bold">Clone Type</emphasis> page is displayed.
     3583    </para>
     3584
     3585    <figure id="fig-clone-wizard-clone-type">
     3586      <title>Clone Virtual Machine Wizard: Clone Type</title>
     3587      <mediaobject>
     3588        <imageobject>
     3589          <imagedata align="center" fileref="images/clone-vm-2.png"
     3590                   width="10cm" />
     3591        </imageobject>
     3592      </mediaobject>
     3593    </figure>
     3594
     3595    <para>
     3596      The <emphasis role="bold">Clone Type</emphasis> option specifies
     3597      whether to create a clone that is linked to the source VM or to
     3598      create a fully independent clone:
     3599    </para>
     3600
     3601    <itemizedlist>
     3602
     3603      <listitem>
     3604        <para>
     3605          <emphasis role="bold">Full Clone:</emphasis> Copies all
     3606          dependent disk images to the new VM folder. A full clone can
     3607          operate fully without the source VM.
     3608        </para>
     3609      </listitem>
     3610
     3611      <listitem>
     3612        <para>
     3613          <emphasis role="bold">Linked Clone:</emphasis> Creates new
     3614          differencing disk images based on the source VM disk images.
     3615          If you select the current state of the source VM as the clone
     3616          point, &product-name; creates a new snapshot.
     3617        </para>
     3618      </listitem>
     3619
     3620    </itemizedlist>
     3621
     3622    <para>
     3623      (Optional) Click <emphasis role="bold">Next</emphasis>. The
     3624      <emphasis role="bold">Snapshots</emphasis> page is displayed.
     3625    </para>
     3626
     3627    <note>
     3628      <para>
     3629        The Snapshots page is only displayed for machines that have
     3630        snapshots and the selected clone type is
     3631        <emphasis role="bold">Full Clone</emphasis>.
     3632      </para>
     3633    </note>
     3634
     3635    <figure id="fig-clone-wizard-snapshots">
     3636      <title>Clone Virtual Machine Wizard: Snapshots</title>
     3637        <mediaobject>
     3638        <imageobject>
     3639          <imagedata align="center" fileref="images/clone-vm-3.png"
     3640                   width="10cm" />
     3641        </imageobject>
     3642      </mediaobject>
     3643    </figure>
     3644
     3645    <para>
     3646      You use this page to select which parts of the snapshot tree to
     3647      include in the clone. The available options are as follows:
     3648    </para>
     3649
     3650    <itemizedlist>
     3651
     3652      <listitem>
     3653        <para>
     3654          <emphasis role="bold">Current Machine State:</emphasis> Clones
     3655          the current state of the VM. Snapshots are not included.
     3656        </para>
     3657      </listitem>
     3658
     3659      <listitem>
     3660        <para>
     3661          <emphasis role="bold">Everything:</emphasis> Clones the
     3662          current machine state and all its snapshots.
     3663        </para>
     3664      </listitem>
     3665
     3666    </itemizedlist>
     3667
     3668    <para>
     3669      Click <emphasis role="bold">Finish</emphasis> to start the clone
     3670      operation.
     3671    </para>
     3672
     3673    <para>
    25343674      The duration of the clone operation depends on the size and number
    25353675      of attached disk images. In addition, the clone operation saves
    … …  
    25383678
    25393679    <para>
    2540       Note that the <emphasis role="bold">Clone</emphasis> menu item is
    2541       disabled while a machine is running.
    2542     </para>
    2543 
    2544     <para>
    25453680      You can also use the <command>VBoxManage clonevm</command> command
    25463681      to clone a VM. See <xref linkend="vboxmanage-clonevm" />.
    … …  
    25873722        virtual machines that can then be imported into a hypervisor
    25883723        such as &product-name;. &product-name; makes OVF import and
    2589         export easy to do, using the VirtualBox Manager window or the
    2590         command-line interface.
     3724        export easy to do, using &vbox-mgr; or the command-line
     3725        interface.
    25913726      </para>
    25923727
    … …  
    26743809            for any OVF and OVA files on your host OS.
    26753810          </para>
    2676         </listitem>
    2677 
    2678         <listitem>
    2679           <para>
    2680             Select <emphasis role="bold">File</emphasis>,
    2681             <emphasis role="bold">Import Appliance</emphasis> from the
    2682             VirtualBox Manager window.
    2683           </para>
    2684 
    2685           <para>
    2686             From the file dialog, go to the file with either the
    2687             <filename>.ovf</filename> or the <filename>.ova</filename>
    2688             file extension.
    2689           </para>
    2690 
    2691           <para>
    2692             Click <emphasis role="bold">Import</emphasis> to open the
    2693             <emphasis role="bold">Appliance Settings</emphasis> screen.
     3811
     3812          <para>
     3813            The <emphasis role="bold">Appliance Settings</emphasis> page
     3814            of the <emphasis role="bold">Import Virtual
     3815            Appliance</emphasis> wizard is shown.
    26943816          </para>
    26953817
    26963818          <figure id="fig-import-appliance">
    2697             <title>Appliance Settings Screen for Import Appliance</title>
     3819            <title>Import Virtual Appliance Wizard: Appliance Settings</title>
    26983820            <mediaobject>
    26993821              <imageobject>
    … …  
    27023824              </imageobject>
    27033825            </mediaobject>
    2704 
    27053826          </figure>
    2706 
    2707           <para>
    2708             This screen shows the VMs described in the OVF or OVA file
    2709             and enables you to change the VM settings.
     3827        </listitem>
     3828
     3829        <listitem>
     3830          <para>
     3831            The <emphasis role="bold">Appliance Settings</emphasis> page
     3832            shows the VMs described in the OVF or OVA file and enables
     3833            you to change the VM settings.
    27103834          </para>
    27113835
    … …  
    27143838            for VMs that were initially exported from &product-name;.
    27153839            You can change this behavior by using the
    2716             <emphasis
    2717             role="bold">Primary Group</emphasis>
    2718             setting for the VM.
     3840            <emphasis role="bold">Primary Group</emphasis> setting for
     3841            the VM.
    27193842          </para>
    27203843
    … …  
    27643887        <listitem>
    27653888          <para>
    2766             Click <emphasis role="bold">Import</emphasis> to import the
     3889            Click <emphasis role="bold">Finish</emphasis> to import the
    27673890            appliance.
    27683891          </para>
    … …  
    27713894            &product-name; copies the disk images and creates local VMs
    27723895            with the settings described on the
    2773             <emphasis role="bold">Appliance Settings</emphasis> screen.
     3896            <emphasis role="bold">Appliance Settings</emphasis> page.
    27743897            The imported VMs are shown in the list of VMs in VirtualBox
    27753898            Manager.
    … …  
    28083931          <para>
    28093932            Select <emphasis role="bold">File</emphasis>,
    2810             <emphasis role="bold"> Export Appliance</emphasis> to open
    2811             the <emphasis role="bold">Export Virtual
     3933            <emphasis role="bold"> Export Appliance</emphasis> to
     3934            display the <emphasis role="bold">Export Virtual
    28123935            Appliance</emphasis> wizard.
    28133936          </para>
    28143937
    28153938          <para>
    2816             From the initial window, you can combine several VMs into an
    2817             OVF appliance.
     3939            On the initial <emphasis role="bold">Virtual
     3940            Machines</emphasis> page, you can combine several VMs into
     3941            an OVF appliance.
    28183942          </para>
    28193943
    … …  
    28263950        <listitem>
    28273951          <para>
    2828             The <emphasis role="bold">Appliance Settings</emphasis>
    2829             screen enables you to select the following settings:
     3952            The <emphasis role="bold">Format Settings</emphasis> page
     3953            enables you to configure the following settings:
    28303954          </para>
    28313955
    … …  
    28834007          <para>
    28844008            Click <emphasis role="bold">Next</emphasis> to show the
    2885             <emphasis role="bold">Virtual System Settings</emphasis>
    2886             screen.
     4009            <emphasis role="bold">Appliance Settings</emphasis> page.
    28874010          </para>
    28884011
    … …  
    29014024        <listitem>
    29024025          <para>
    2903             Click <emphasis role="bold">Export</emphasis> to begin the
     4026            Click <emphasis role="bold">Finish</emphasis> to begin the
    29044027            export process. Note that this operation might take several
    29054028            minutes.
    … …  
    31444267          <figure id="fig-upload-key-oci">
    31454268            <title>Upload Public Key Dialog in &oci; Console</title>
    3146             <mediaobject>
     4269           <mediaobject>
    31474270              <imageobject>
    31484271                <imagedata align="center" fileref="images/upload-key.png"
    … …  
    31504273              </imageobject>
    31514274            </mediaobject>
    3152 
    31534275          </figure>
    31544276
    … …  
    32224344          <para>
    32234345            <emphasis role="bold">(Optional) Passphrase for the private
    3224             key.</emphasis>. This is only required if the key is
     4346            key.</emphasis> This is only required if the key is
    32254347            encrypted.
    32264348          </para>
    … …  
    32914413
    32924414          <para>
    3293             The Cloud Profile Manager is a component of &product-name;
    3294             that enables you to create, edit, and manage cloud profiles
    3295             for your cloud service accounts.
     4415            The Cloud Profile Manager is a &vbox-mgr; tool that enables
     4416            you to create, edit, and manage cloud profiles for your
     4417            cloud service accounts.
    32964418          </para>
    32974419        </listitem>
    … …  
    33524474        To open the Cloud Profile Manager click
    33534475        <emphasis role="bold">File</emphasis>,
    3354         <emphasis role="bold">Cloud Profile Manager</emphasis> in the
    3355         VirtualBox Manager window.
     4476        <emphasis role="bold">Cloud Profile Manager</emphasis> in
     4477        &vbox-mgr;.
    33564478      </para>
    33574479
    … …  
    34634585        <listitem>
    34644586          <para>
     4587            (Optional) If you are using the cloud profile to connect to
     4588            cloud virtual machines, select the
     4589            <emphasis role="bold">Show VMs</emphasis> check box.
     4590          </para>
     4591
     4592          <para>
     4593            This creates a new subgroup of the
     4594            <emphasis role="bold">OCI</emphasis> group in &vbox-mgr;.
     4595            See <xref linkend="cloud-vm-oci-group"/>.
     4596          </para>
     4597        </listitem>
     4598
     4599        <listitem>
     4600          <para>
    34654601            Click <emphasis role="bold">Apply</emphasis> to save your
    34664602            changes.
    … …  
    34684604
    34694605          <para>
    3470             The cloud profile settings are saved in the
     4606            The cloud profile settings are saved to the
    34714607            <filename>oci_config</filename> file in your &product-name;
    34724608            global settings directory.
    … …  
    35534689        <listitem>
    35544690          <para>
     4691            Create, add, and manage &oci; cloud instances using
     4692            &vbox-mgr;. See <xref linkend="cloud-vm"/>.
     4693          </para>
     4694        </listitem>
     4695
     4696        <listitem>
     4697          <para>
    35554698            Export an &product-name; VM to &oci;. See
    35564699            <xref linkend="cloud-export-oci"/>.
    … …  
    35674710        <listitem>
    35684711          <para>
    3569             Create a new cloud instance from a custom image stored on
    3570             &oci;. See <xref linkend="cloud-new-vm"/>.
     4712            Connect from a local VM to an &oci; cloud subnet. See
     4713            <xref linkend="cloud-using-cloud-networks"/>.
    35714714          </para>
    35724715        </listitem>
    … …  
    35814724
    35824725      </itemizedlist>
     4726
     4727    </sect2>
     4728
     4729    <sect2 id="cloud-vm">
     4730
     4731      <title>Using Cloud Virtual Machines</title>
     4732
     4733      <para>
     4734        A cloud virtual machine (<emphasis>cloud VM</emphasis>) is a
     4735        type of VM that represents an instance on a cloud service. Cloud
     4736        VMs are shown in the machine list in &vbox-mgr;, in the same way
     4737        as local VMs are.
     4738      </para>
     4739
     4740      <para>
     4741        By using cloud VMs you can create, manage, and control your
     4742        &oci; instances from &vbox-mgr;.
     4743      </para>
     4744
     4745      <note>
     4746        <para>
     4747          Cloud VMs do not install, export, or import instances to the
     4748          &product-name; host. All operations are done remotely on the
     4749          cloud service.
     4750        </para>
     4751      </note>
     4752
     4753      <figure id="fig-cloud-vm-overview">
     4754        <title>Cloud VMs, Shown in &vbox-mgr;</title>
     4755       <mediaobject>
     4756          <imageobject>
     4757            <imagedata align="center" fileref="images/cloudvm-overview.png"
     4758              width="12cm" />
     4759          </imageobject>
     4760        </mediaobject>
     4761      </figure>
     4762
     4763      <para>
     4764        Cloud VMs can be used to do the following tasks in &oci;:
     4765      </para>
     4766
     4767      <itemizedlist>
     4768
     4769        <listitem>
     4770          <para>
     4771            <emphasis role="bold">Create a new &oci;
     4772            instance.</emphasis> See <xref linkend="cloud-vm-new"/>.
     4773          </para>
     4774        </listitem>
     4775
     4776        <listitem>
     4777          <para>
     4778            <emphasis role="bold"> Use an existing &oci;
     4779            instance.</emphasis> See <xref linkend="cloud-vm-add"/>.
     4780          </para>
     4781        </listitem>
     4782
     4783        <listitem>
     4784          <para>
     4785            <emphasis role="bold">Configure an &oci;
     4786            instance.</emphasis> You can change settings for the
     4787            instance, such as display name and shape. See
     4788            <xref linkend="cloud-vm-settings"/>.
     4789          </para>
     4790        </listitem>
     4791
     4792        <listitem>
     4793          <para>
     4794            <emphasis role="bold">Control an &oci; instance.</emphasis>
     4795            Stop, start, and terminate the instance. See
     4796            <xref linkend="cloud-vm-control"/>
     4797          </para>
     4798        </listitem>
     4799
     4800        <listitem>
     4801          <para>
     4802            <emphasis role="bold">Create a console connection to an
     4803            &oci; instance</emphasis>. See
     4804            <xref linkend="cloud-vm-instance-console"/>.
     4805          </para>
     4806        </listitem>
     4807
     4808      </itemizedlist>
     4809
     4810      <sect3 id="cloud-vm-oci-group">
     4811
     4812        <title>About the OCI VM Group</title>
     4813
     4814        <para>
     4815          All cloud VMs are shown in the machine list in &vbox-mgr;, in
     4816          a special VM group called
     4817          <emphasis role="bold">OCI</emphasis>.
     4818        </para>
     4819
     4820        <para>
     4821          Cloud VMs are further grouped according to the cloud profile
     4822          used to connect to them. The cloud profile identifies the user
     4823          and compartment for the cloud VM and includes details of the
     4824          key pair used to connect to cloud instances. See
     4825          <xref linkend="cloud-create-cloud-profile"/>.
     4826        </para>
     4827
     4828        <figure id="fig-cloud-vm-oci-group">
     4829          <title>OCI Group, Containing Cloud VMs</title>
     4830        <mediaobject>
     4831          <imageobject>
     4832            <imagedata align="center" fileref="images/cloudvm-oci-group.png"
     4833              width="10cm" />
     4834          </imageobject>
     4835        </mediaobject>
     4836       </figure>
     4837
     4838        <para>
     4839          All cloud profiles registered with &product-name; are listed
     4840          automatically in the OCI group.
     4841        </para>
     4842
     4843        <para>
     4844          To enable or disable listing of cloud VMs in &vbox-mgr; for a
     4845          specific cloud profile, do the following:
     4846        </para>
     4847
     4848        <para>
     4849          Display the <emphasis role="bold">Cloud Profile
     4850          Manager</emphasis> and select or deselect the
     4851          <emphasis role="bold">List VMs</emphasis> check box for each
     4852          cloud profile.
     4853        </para>
     4854
     4855      </sect3>
     4856
     4857      <sect3 id="cloud-vm-new">
     4858
     4859        <title>Creating a New Cloud VM</title>
     4860
     4861        <para>
     4862          When you create a new cloud VM, a <emphasis>new</emphasis>
     4863          &oci; instance is created and associated with the cloud VM.
     4864        </para>
     4865
     4866        <para>
     4867          Perform the following steps to create a new cloud VM:
     4868        </para>
     4869
     4870        <orderedlist>
     4871
     4872          <listitem>
     4873            <para>
     4874              Click on a cloud profile in the
     4875              <emphasis role="bold">OCI</emphasis> group.
     4876            </para>
     4877
     4878            <para>
     4879              The cloud VMs for the selected cloud profile are
     4880              displayed.
     4881            </para>
     4882          </listitem>
     4883
     4884          <listitem>
     4885            <para>
     4886              Select <emphasis role="bold">Group</emphasis>,
     4887              <emphasis role="bold">New Machine</emphasis>.
     4888            </para>
     4889
     4890            <para>
     4891              The <emphasis role="bold">Create Cloud Virtual
     4892              Machine</emphasis> wizard is displayed.
     4893            </para>
     4894
     4895            <figure id="fig-cloudvm-new">
     4896              <title>Create Cloud Virtual Machine Wizard</title>
     4897        <mediaobject>
     4898          <imageobject>
     4899            <imagedata align="center" fileref="images/cloudvm-new.png"
     4900              width="12cm" />
     4901          </imageobject>
     4902        </mediaobject>
     4903            </figure>
     4904          </listitem>
     4905
     4906          <listitem>
     4907            <para>
     4908              On the initial page, configure the following settings for
     4909              the new cloud VM:
     4910            </para>
     4911
     4912            <itemizedlist>
     4913
     4914              <listitem>
     4915                <para>
     4916                  <emphasis role="bold">Location:</emphasis> The cloud
     4917                  service provider that will host the new instance.
     4918                  Select <emphasis role="bold">&oci;</emphasis>.
     4919                </para>
     4920              </listitem>
     4921
     4922              <listitem>
     4923                <para>
     4924                  <emphasis role="bold">Profile:</emphasis> The cloud
     4925                  profile used to connect to the new instance. Select
     4926                  from the available cloud profiles.
     4927                </para>
     4928              </listitem>
     4929
     4930              <listitem>
     4931                <para>
     4932                  <emphasis role="bold">Source:</emphasis> The image
     4933                  that the new instance is based on. Choose from the
     4934                  available images and boot volumes.
     4935                </para>
     4936              </listitem>
     4937
     4938            </itemizedlist>
     4939          </listitem>
     4940
     4941          <listitem>
     4942            <para>
     4943              Click <emphasis role="bold">Next</emphasis> to display the
     4944              <emphasis role="bold">Cloud Virtual Machine
     4945              Settings</emphasis> page.
     4946            </para>
     4947
     4948            <para>
     4949              You can use this page to change the default settings for
     4950              the new &oci; instance, such as the display name, shape,
     4951              and networking configuration.
     4952            </para>
     4953
     4954            <para>
     4955              To add an SSH key to the instance, click the
     4956              <emphasis role="bold">SSH Authorised Keys</emphasis> field
     4957              and paste the public key into the displayed dialog.
     4958            </para>
     4959          </listitem>
     4960
     4961          <listitem>
     4962            <para>
     4963              Click <emphasis role="bold">Finish</emphasis> to create a
     4964              new &oci; instance using the selected image or boot
     4965              volume. The new instance is started automatically.
     4966            </para>
     4967
     4968            <para>
     4969              The new cloud VM is shown in the
     4970              <emphasis role="bold">OCI</emphasis> group in &vbox-mgr;.
     4971            </para>
     4972          </listitem>
     4973
     4974        </orderedlist>
     4975
     4976      </sect3>
     4977
     4978      <sect3 id="cloud-vm-add">
     4979
     4980        <title>Adding a Cloud VM</title>
     4981
     4982        <para>
     4983          When you add a cloud VM, an <emphasis>existing</emphasis>
     4984          &oci; instance is associated with the cloud VM. You can only
     4985          add one cloud VM for each instance.
     4986        </para>
     4987
     4988        <para>
     4989          Perform the following steps to add a cloud VM:
     4990        </para>
     4991
     4992        <orderedlist>
     4993
     4994          <listitem>
     4995            <para>
     4996              Click on a cloud profile in the
     4997              <emphasis role="bold">OCI</emphasis> group.
     4998            </para>
     4999
     5000            <para>
     5001              The cloud VMs for the selected cloud profile are
     5002              displayed.
     5003            </para>
     5004          </listitem>
     5005
     5006          <listitem>
     5007            <para>
     5008              Select <emphasis role="bold">Group</emphasis>,
     5009              <emphasis role="bold">Add Machine</emphasis>.
     5010            </para>
     5011
     5012            <para>
     5013              The <emphasis role="bold">Add Cloud Virtual
     5014              Machine</emphasis> wizard is displayed.
     5015            </para>
     5016
     5017            <figure id="fig-cloudvm-add">
     5018              <title>Add Cloud Virtual Machine Wizard</title>
     5019        <mediaobject>
     5020          <imageobject>
     5021            <imagedata align="center" fileref="images/cloudvm-add.png"
     5022              width="12cm" />
     5023          </imageobject>
     5024        </mediaobject>
     5025            </figure>
     5026          </listitem>
     5027
     5028          <listitem>
     5029            <para>
     5030              Configure the following settings:
     5031            </para>
     5032
     5033            <itemizedlist>
     5034
     5035              <listitem>
     5036                <para>
     5037                  <emphasis role="bold">Source:</emphasis> The cloud
     5038                  service provider that hosts the instance used for the
     5039                  cloud VM. Select
     5040                  <emphasis role="bold">&oci;</emphasis>.
     5041                </para>
     5042              </listitem>
     5043
     5044              <listitem>
     5045                <para>
     5046                  <emphasis role="bold">Profile:</emphasis> The cloud
     5047                  profile used to connect to the running instance.
     5048                  Select from the available cloud profiles.
     5049                </para>
     5050              </listitem>
     5051
     5052              <listitem>
     5053                <para>
     5054                  <emphasis role="bold">Instances:</emphasis> The
     5055                  instance to use for the cloud VM. Choose from the
     5056                  available instances on your cloud service.
     5057                </para>
     5058              </listitem>
     5059
     5060            </itemizedlist>
     5061          </listitem>
     5062
     5063          <listitem>
     5064            <para>
     5065              Click <emphasis role="bold">Finish</emphasis> to add a
     5066              cloud VM based on the selected instance.
     5067            </para>
     5068
     5069            <para>
     5070              A cloud VM with the same name as the instance is added to
     5071              the <emphasis role="bold">OCI</emphasis> group in
     5072              &vbox-mgr;.
     5073            </para>
     5074          </listitem>
     5075
     5076          <listitem>
     5077            <para>
     5078              (Optional) To change the display name for the instance,
     5079              click <emphasis role="bold">Settings</emphasis> and edit
     5080              the <emphasis role="bold">Display Name</emphasis> field.
     5081            </para>
     5082
     5083            <para>
     5084              The cloud VM name in &vbox-mgr; is updated automatically.
     5085            </para>
     5086          </listitem>
     5087
     5088        </orderedlist>
     5089
     5090      </sect3>
     5091
     5092      <sect3 id="cloud-vm-settings">
     5093
     5094        <title>Changing Settings for a Cloud VM</title>
     5095
     5096        <para>
     5097          Select the cloud VM in &vbox-mgr; and click
     5098          <emphasis role="bold">Settings</emphasis>.
     5099        </para>
     5100
     5101        <itemizedlist>
     5102
     5103          <listitem>
     5104            <para>
     5105              For a <emphasis>new</emphasis> cloud VM, you can change
     5106              many settings for the &oci; instance, such as the display
     5107              name, shape, and disk size.
     5108            </para>
     5109          </listitem>
     5110
     5111          <listitem>
     5112            <para>
     5113              When you <emphasis>add</emphasis> a cloud VM based on an
     5114              existing &oci; instance you can only change the display
     5115              name.
     5116            </para>
     5117          </listitem>
     5118
     5119        </itemizedlist>
     5120
     5121      </sect3>
     5122
     5123      <sect3 id="cloud-vm-control">
     5124
     5125        <title>Controlling a Cloud VM</title>
     5126
     5127        <para>
     5128          You can use &vbox-mgr; to control a cloud VM as follows:
     5129        </para>
     5130
     5131        <itemizedlist>
     5132
     5133          <listitem>
     5134            <para>
     5135              <emphasis role="bold">Start.</emphasis> Use the
     5136              <emphasis role="bold">Start</emphasis> button in the
     5137              &vbox-mgr; toolbar.
     5138            </para>
     5139          </listitem>
     5140
     5141          <listitem>
     5142            <para>
     5143              <emphasis role="bold">Stop.</emphasis> Right-click on the
     5144              cloud VM name, to display the
     5145              <emphasis role="bold">Close</emphasis> menu. Options to
     5146              shut down and power off the cloud VM are available.
     5147            </para>
     5148          </listitem>
     5149
     5150          <listitem>
     5151            <para>
     5152              <emphasis role="bold">Terminate.</emphasis> Use the
     5153              <emphasis role="bold">Terminate</emphasis> button in the
     5154              &vbox-mgr; toolbar.
     5155            </para>
     5156
     5157            <caution>
     5158              <para>
     5159                This action deletes the instance from &oci;.
     5160              </para>
     5161            </caution>
     5162          </listitem>
     5163
     5164        </itemizedlist>
     5165
     5166        <para>
     5167          When you control a cloud VM in &vbox-mgr; the machine list is
     5168          updated automatically with the current instance state, such as
     5169          <emphasis role="bold">Stopped</emphasis> or
     5170          <emphasis role="bold">Running</emphasis>.
     5171        </para>
     5172
     5173        <para>
     5174          When you control an instance using the &oci; console,
     5175          &vbox-mgr; updates the status for the corresponding cloud VM
     5176          automatically.
     5177        </para>
     5178
     5179      </sect3>
     5180
     5181      <sect3 id="cloud-vm-remove">
     5182
     5183        <title>Removing a Cloud VM</title>
     5184
     5185        <para>
     5186          You can use &vbox-mgr; to remove a cloud VM as follows:
     5187        </para>
     5188
     5189        <para>
     5190          Right-click on the cloud VM name and select
     5191          <emphasis role="bold">Remove</emphasis>.
     5192        </para>
     5193
     5194        <itemizedlist>
     5195
     5196          <listitem>
     5197            <para>
     5198              Click <emphasis role="bold">Remove Only</emphasis> to
     5199              remove the cloud VM from the machine list in VirtualBox
     5200              Manager.
     5201            </para>
     5202          </listitem>
     5203
     5204          <listitem>
     5205            <para>
     5206              Click <emphasis role="bold">Delete Everything</emphasis>
     5207              to remove the cloud VM from &vbox-mgr; and also to delete
     5208              the &oci; instance and any associated boot volumes.
     5209            </para>
     5210          </listitem>
     5211
     5212        </itemizedlist>
     5213
     5214      </sect3>
     5215
     5216      <sect3 id="cloud-vm-instance-console">
     5217
     5218        <title>Creating an Instance Console Connection for a Cloud VM</title>
     5219
     5220        <para>
     5221          To create a instance console connection, the cloud VM must be
     5222          in <emphasis role="bold">Running</emphasis> state.
     5223        </para>
     5224
     5225        <orderedlist>
     5226
     5227          <listitem>
     5228            <para>
     5229              Right-click on the cloud VM name and select
     5230              <emphasis role="bold">Console</emphasis>,
     5231              <emphasis role="bold">Create Connection</emphasis>.
     5232            </para>
     5233          </listitem>
     5234
     5235          <listitem>
     5236            <para>
     5237              The <emphasis role="bold">Public Key</emphasis> dialog is
     5238              displayed. Paste the public key used for the instance
     5239              connection into the dialog and click
     5240              <emphasis role="bold">OK</emphasis>.
     5241            </para>
     5242
     5243            <para>
     5244              By default, either the first entry in your SSH keys folder
     5245              or the public key used for your previous instance console
     5246              connection is used.
     5247            </para>
     5248          </listitem>
     5249
     5250          <listitem>
     5251            <para>
     5252              Click <emphasis role="bold">Connect</emphasis> to connect
     5253              to the instance. An instance console is displayed
     5254              automatically on the host.
     5255            </para>
     5256          </listitem>
     5257
     5258          <listitem>
     5259            <para>
     5260              (Optional) Click <emphasis role="bold">Show Log</emphasis>
     5261              to display log messages for the instance console
     5262              connection.
     5263            </para>
     5264          </listitem>
     5265
     5266        </orderedlist>
     5267
     5268        <para>
     5269          See the &oci; documentation for details about how you can use
     5270          an instance console connection to troubleshoot instance
     5271          problems.
     5272        </para>
     5273
     5274      </sect3>
    35835275
    35845276    </sect2>
    … …  
    36185310          <para>
    36195311            Select a VM to export and click
    3620             <emphasis role="bold">Next</emphasis> to open the
    3621             <emphasis role="bold">Appliance Settings</emphasis> screen.
     5312            <emphasis role="bold">Next</emphasis> to display the
     5313            <emphasis role="bold">Format Settings</emphasis> page.
    36225314          </para>
    36235315        </listitem>
    … …  
    36305322
    36315323          <para>
    3632             In the <emphasis role="bold">Account</emphasis> drop-down
    3633             list, select the cloud profile for your &oci; account.
    3634           </para>
    3635 
    3636           <para>
    3637             The list after the <emphasis role="bold">Account</emphasis>
    3638             field shows the profile settings for your cloud account.
     5324            In the <emphasis role="bold">Profile</emphasis> drop-down
     5325            list, select the cloud profile used for your &oci; account.
    36395326          </para>
    36405327
    36415328          <figure id="fig-export-appliance-oci">
    3642             <title>Appliance Settings Screen, Showing Cloud Profile and Machine Creation
    3643               Settings</title>
    3644            <mediaobject>
     5329            <title>Export Virtual Appliance Wizard: Format Settings</title>
     5330          <mediaobject>
    36455331              <imageobject>
    36465332                <imagedata align="center" fileref="images/export-appliance-oci.png"
    … …  
    36525338          <para>
    36535339            In the <emphasis role="bold">Machine Creation</emphasis>
    3654             field, select an option to configure settings for a cloud
     5340            field, select an option to configure settings for the cloud
    36555341            instance created when you export to &oci;. The options
    36565342            enable you to do one of the following:
    … …  
    36855371            Click <emphasis role="bold">Next</emphasis> to make an API
    36865372            request to the &oci; service and open the
    3687             <emphasis role="bold">Virtual System Settings</emphasis>
    3688             screen.
     5373            <emphasis role="bold">Appliance Settings</emphasis> page.
    36895374          </para>
    36905375        </listitem>
    … …  
    37135398            <listitem>
    37145399              <para>
    3715                 The name for the custom image in &oci;.
     5400                The display name for the custom image in &oci;.
    37165401              </para>
    37175402            </listitem>
    … …  
    37375422
    37385423          <para>
    3739             Click <emphasis role="bold">Export</emphasis> to continue.
    3740           </para>
    3741         </listitem>
    3742 
    3743         <listitem>
    3744           <para>
    3745             Depending on the selection in the
     5424            Click <emphasis role="bold">Finish</emphasis> to continue.
     5425          </para>
     5426        </listitem>
     5427
     5428        <listitem>
     5429          <para>
     5430            (Optional) Depending on the selection in the
    37465431            <emphasis role="bold">Machine Creation</emphasis> field, the
    3747             <emphasis role="bold">Cloud Virtual Machine
    3748             Settings</emphasis> screen may be displayed before or after
    3749             export. This screen enables you to configure settings for
    3750             the cloud instance, such as Shape and Disk Size.
    3751           </para>
    3752 
    3753           <para>
    3754             Click <emphasis role="bold">Create</emphasis>. The VM is
     5432            <emphasis role="bold">Appliance Settings</emphasis> page may
     5433            be displayed before or after export. This screen enables you
     5434            to configure settings for the cloud instance, such as Shape
     5435            and Disk Size.
     5436          </para>
     5437
     5438          <para>
     5439            Click <emphasis role="bold">Finish</emphasis>. The VM is
    37555440            exported to &oci;.
    37565441          </para>
    … …  
    39735658                </para>
    39745659
    3975 <screen># dracut --logfile /var/log/Dracut.log --force --add qemu</screen>
     5660<screen># dracut –-logfile /var/log/Dracut.log --force --add qemu</screen>
    39765661              </listitem>
    39775662
    … …  
    40285713
    40295714          <para>
    4030             In the <emphasis role="bold">Account</emphasis> drop-down
     5715            In the <emphasis role="bold">Profile</emphasis> drop-down
    40315716            list, select the cloud profile for your &oci; account.
    4032           </para>
    4033 
    4034           <para>
    4035             The list after the <emphasis role="bold">Account</emphasis>
    4036             field shows the profile settings for your cloud account.
    40375717          </para>
    40385718
    … …  
    40455725            Click <emphasis role="bold">Next</emphasis> to make an API
    40465726            request to the &oci; service and display the
    4047             <emphasis role="bold">Appliance Settings</emphasis> screen.
     5727            <emphasis role="bold">Appliance Settings</emphasis> page.
    40485728          </para>
    40495729        </listitem>
    … …  
    40595739
    40605740          <figure id="fig-import-instance-oci">
    4061             <title>Import Cloud Instance Screen, Showing Profile Settings and VM Settings</title>
     5741            <title>Import Cloud Instance Wizard: Appliance Settings</title>
    40625742           <mediaobject>
    40635743              <imageobject>
    … …  
    40695749
    40705750          <para>
    4071             Click <emphasis role="bold">Import</emphasis> to import the
     5751            Click <emphasis role="bold">Finish</emphasis> to import the
    40725752            instance from &oci;.
    40735753          </para>
    … …  
    41575837    </sect2>
    41585838
    4159     <sect2 id="cloud-new-vm">
    4160 
    4161       <title>Creating New Cloud Instances from a Custom Image</title>
    4162 
    4163       <para>
    4164         You can use &product-name; to create new instances from a custom
    4165         image on your cloud service.
    4166       </para>
    4167 
    4168       <para>
    4169         <xref linkend="cloud-export-oci"/> describes how to create a
    4170         custom image when you are exporting a VM to &oci;. Using a
    4171         custom image means that you can quickly create cloud instances
    4172         without having to upload your image to the cloud service every
    4173         time.
    4174       </para>
    4175 
    4176       <para>
    4177         Perform the following steps to create a new cloud instance on
    4178         &oci;:
     5839    <sect2 id="cloud-using-cloud-networks">
     5840
     5841      <title>Using a Cloud Network</title>
     5842
     5843      <para>
     5844        A cloud network is a type of network that can be used for
     5845        connections from a local VM to a remote &oci; cloud instance.
     5846      </para>
     5847
     5848      <para>
     5849        To create and use a cloud network, do the following:
    41795850      </para>
    41805851
    … …  
    41835854        <listitem>
    41845855          <para>
    4185             Select <emphasis role="bold">File</emphasis>,
    4186             <emphasis role="bold">New Cloud VM</emphasis> to open the
    4187             <emphasis role="bold">Create Cloud Virtual
    4188             Machine</emphasis> wizard.
    4189           </para>
    4190         </listitem>
    4191 
    4192         <listitem>
    4193           <para>
    4194             From the <emphasis role="bold">Destination</emphasis>
    4195             drop-down list, select
    4196             <emphasis role="bold">&oci;</emphasis>.
    4197           </para>
    4198 
    4199           <para>
    4200             In the <emphasis role="bold">Account</emphasis> drop-down
    4201             list, select the cloud profile for your &oci; account.
    4202           </para>
    4203 
    4204           <para>
    4205             The list after the <emphasis role="bold">Account</emphasis>
    4206             field shows the profile settings for your cloud account.
    4207           </para>
    4208 
    4209           <para>
    4210             In the <emphasis role="bold">Images</emphasis> list, select
    4211             from the custom images available on &oci;.
    4212           </para>
    4213 
    4214           <figure id="fig-newcloudvm">
    4215             <title>New Cloud VM Wizard, Showing List of Custom Images</title>
    4216             <mediaobject>
    4217               <imageobject>
    4218                 <imagedata align="center" fileref="images/newcloudvm.png"
    4219                   width="12cm" />
    4220               </imageobject>
    4221             </mediaobject>
    4222           </figure>
    4223 
    4224           <para>
    4225             Click <emphasis role="bold">Next</emphasis> to make an API
    4226             request to the &oci; service and open the
    4227             <emphasis role="bold">Cloud Virtual Machine
    4228             Settings</emphasis> screen.
    4229           </para>
    4230         </listitem>
    4231 
    4232         <listitem>
    4233           <para>
    4234             (Optional) Edit settings used for the new instance on &oci;.
    4235           </para>
    4236 
    4237           <para>
    4238             For example, you can edit the Disk Size and Shape used for
    4239             the VM instance and the networking configuration.
    4240           </para>
    4241 
    4242           <para>
    4243             Click <emphasis role="bold">Create</emphasis> to create the
    4244             new cloud instance.
    4245           </para>
    4246         </listitem>
    4247 
    4248         <listitem>
    4249           <para>
    4250             Monitor the instance creation process by using the &oci;
    4251             Console.
     5856            Set up a virtual cloud network on &oci;.
     5857          </para>
     5858
     5859          <para>
     5860            The following steps create and configure a virtual cloud
     5861            network (VCN) on &oci;. The VCN is used to tunnel network
     5862            traffic across the cloud.
     5863          </para>
     5864
     5865          <orderedlist>
     5866
     5867            <listitem>
     5868              <para>
     5869                Ensure that you have a cloud profile for connecting to
     5870                &oci;. See <xref linkend="cloud-create-cloud-profile"/>.
     5871              </para>
     5872            </listitem>
     5873
     5874            <listitem>
     5875              <para>
     5876                Run the following <command>VBoxManage cloud</command>
     5877                command:
     5878              </para>
     5879
     5880<screen>VBoxManage cloud --provider="OCI" --profile="vbox-oci" network setup</screen>
     5881
     5882              <para>
     5883                where <literal>vbox-oci</literal> is the name of your
     5884                cloud profile.
     5885              </para>
     5886
     5887              <para>
     5888                Other options are available for the <command>VBoxManage
     5889                cloud network setup</command> command, to enable you to
     5890                configure details for the VCN. For example, you can
     5891                configure the operating system used for the cloud
     5892                gateway instance and the IP address range used by the
     5893                tunneling network. See
     5894                <xref linkend="vboxmanage-cloud"/>.
     5895              </para>
     5896
     5897              <para>
     5898                For best results, use an Oracle Linux 7 instance for the
     5899                cloud gateway. This is the default option.
     5900              </para>
     5901            </listitem>
     5902
     5903          </orderedlist>
     5904        </listitem>
     5905
     5906        <listitem>
     5907          <para>
     5908            Register the new cloud network with &product-name;.
     5909          </para>
     5910
     5911          <para>
     5912            Use the <emphasis role="bold">Cloud Networks</emphasis> tab
     5913            in the <emphasis role="bold">Network Manager</emphasis>
     5914            tool. See
     5915            <xref linkend="network-manager-cloud-network-tab"/>.
     5916          </para>
     5917        </listitem>
     5918
     5919        <listitem>
     5920          <para>
     5921            Add cloud network adaptors to the local VMs that will use
     5922            the cloud network. See <xref linkend="network_cloud"/>.
    42525923          </para>
    42535924        </listitem>
    42545925
    42555926      </orderedlist>
    4256 
    4257       <para>
    4258         You can also use the <command>VBoxManage cloud
    4259         instance</command> command to create and manage instances on a
    4260         cloud service. See <xref linkend="vboxmanage-cloud"/>.
    4261       </para>
    42625927
    42635928    </sect2>
    … …  
    43706035  </sect1>
    43716036
    4372   <sect1 id="globalsettings">
    4373 
    4374     <title>Global Settings</title>
     6037  <sect1 id="preferences">
     6038
     6039    <title>Preferences</title>
    43756040
    43766041    <para>
    4377       The <emphasis role="bold">Global Settings</emphasis> dialog can be
    4378       displayed using the <emphasis role="bold">File</emphasis> menu, by
    4379       clicking the <emphasis role="bold">Preferences</emphasis> item.
    4380       This dialog offers a selection of settings, most of which apply to
    4381       all virtual machines of the current user. The
    4382       <emphasis role="bold">Extensions</emphasis> option applies to the
    4383       entire system.
     6042      The Preferences window offers a selection of settings, which apply
     6043      to all virtual machines of the current user.
    43846044    </para>
     6045
     6046    <para>
     6047      To display the Preferences window, do either of the following:
     6048    </para>
     6049
     6050    <itemizedlist>
     6051
     6052      <listitem>
     6053        <para>
     6054          Select <emphasis role="bold">File</emphasis>,
     6055          <emphasis role="bold">Preferences</emphasis>.
     6056        </para>
     6057      </listitem>
     6058
     6059      <listitem>
     6060        <para>
     6061          Click <emphasis role="bold">Preferences</emphasis> on the
     6062          Welcome screen in &vbox-mgr;.
     6063        </para>
     6064      </listitem>
     6065
     6066    </itemizedlist>
    43856067
    43866068    <para>
    … …  
    43926074      <listitem>
    43936075        <para>
    4394           <emphasis role="bold">General.</emphasis> Enables the user to
     6076          <emphasis role="bold">General.</emphasis> Enables you to
    43956077          specify the default folder or directory for VM files, and the
    43966078          VRDP Authentication Library.
    … …  
    44006082      <listitem>
    44016083        <para>
    4402           <emphasis role="bold">Input.</emphasis> Enables the user to
    4403           specify the Host key. This is the key that toggles whether the
     6084          <emphasis role="bold">Input.</emphasis> Enables you to specify
     6085          keyboard shortcuts, such as the <emphasis role="bold">Host
     6086          key</emphasis>. This is the key that toggles whether the
    44046087          cursor is in the focus of the VM or the Host OS windows, see
    44056088          <xref linkend="keyb_mouse_normal"/>. The Host key is also used
    … …  
    44116094      <listitem>
    44126095        <para>
    4413           <emphasis role="bold">Update.</emphasis> Enables the user to
     6096          <emphasis role="bold">Update.</emphasis> Enables you to
    44146097          specify various settings for Automatic Updates.
    44156098        </para>
    … …  
    44186101      <listitem>
    44196102        <para>
    4420           <emphasis role="bold">Language.</emphasis> Enables the user to
    4421           specify the GUI language.
    4422         </para>
    4423       </listitem>
    4424 
    4425       <listitem>
    4426         <para>
    4427           <emphasis role="bold">Display.</emphasis> Enables the user to
     6103          <emphasis role="bold">Language.</emphasis> Enables you to
     6104          specify the language used for menus, labels, and text in
     6105          &vbox-mgr;.
     6106        </para>
     6107      </listitem>
     6108
     6109      <listitem>
     6110        <para>
     6111          <emphasis role="bold">Display.</emphasis> Enables you to
    44286112          specify the screen resolution, and its width and height. A
    44296113          default scale factor can be specified for all guest screens.
    … …  
    44336117      <listitem>
    44346118        <para>
    4435           <emphasis role="bold">Network.</emphasis> Enables the user to
    4436           configure the details of NAT networks. See
    4437           <xref linkend="network_nat_service"/>.
    4438         </para>
    4439       </listitem>
    4440 
    4441       <listitem>
    4442         <para>
    4443           <emphasis role="bold">Extensions.</emphasis> Enables the user
    4444           to list and manage the installed extension packages.
    4445         </para>
    4446       </listitem>
    4447 
    4448       <listitem>
    4449         <para>
    4450           <emphasis role="bold">Proxy.</emphasis> Enables the user to
    4451           configure a HTTP Proxy Server.
    4452         </para>
     6119          <emphasis role="bold">Proxy.</emphasis> Enables you to
     6120          configure an HTTP Proxy Server.
     6121        </para>
     6122      </listitem>
     6123
     6124      <listitem>
     6125        <para>
     6126          <emphasis role="bold">Interface.</emphasis> Enables you to
     6127          select a color theme for the &vbox-mgr; user interface.
     6128        </para>
     6129
     6130        <note>
     6131          <para>
     6132            This setting is only available on Windows host platforms.
     6133          </para>
     6134        </note>
    44536135      </listitem>
    44546136
    … …  
    44666148      you to use multiple interfaces to control the same virtual
    44676149      machines. For example, you can start a virtual machine with the
    4468       VirtualBox Manager window and then stop it from the command line.
    4469       With &product-name;'s support for the Remote Desktop Protocol
    4470       (RDP), you can even run virtual machines remotely on a headless
    4471       server and have all the graphical output redirected over the
    4472       network.
     6150      &vbox-mgr; window and then stop it from the command line. With
     6151      &product-name;'s support for the Remote Desktop Protocol (RDP),
     6152      you can even run virtual machines remotely on a headless server
     6153      and have all the graphical output redirected over the network.
    44736154    </para>
    44746155
    … …  
    44836164        <para>
    44846165          <emphasis role="bold">VirtualBox.</emphasis> This is the
    4485           VirtualBox Manager, a graphical user interface that uses the
    4486           Qt toolkit. This interface is described throughout this
    4487           manual. While this is the simplest and easiest front-end to
    4488           use, some of the more advanced &product-name; features are not
    4489           included.
     6166          &vbox-mgr;, a graphical user interface that uses the Qt
     6167          toolkit. This interface is described throughout this manual.
     6168          While this is the simplest and easiest front-end to use, some
     6169          of the more advanced &product-name; features are not included.
    44906170        </para>
    44916171      </listitem>
    … …  
    45506230    <figure id="fig-soft-keyb">
    45516231      <title>Soft Keyboard in a Guest Virtual Machine</title>
    4552     <mediaobject>
     6232     <mediaobject>
    45536233      <imageobject>
    45546234        <imagedata align="center" fileref="images/softkeybd.png"
    … …  
    46316311          <para>
    46326312            The name of the current keyboard layout is displayed in the
    4633             task bar of the soft keyboard window. This is the previous
     6313            toolbar of the soft keyboard window. This is the previous
    46346314            keyboard layout that was used.
    46356315          </para>
    … …  
    46376317          <para>
    46386318            Click the <emphasis role="bold">Layout List</emphasis> icon
    4639             in the task bar of the soft keyboard window. The
     6319            in the toolbar of the soft keyboard window. The
    46406320            <emphasis role="bold">Layout List</emphasis> window is
    46416321            displayed.
    … …  
    46796359                To change the look of the soft keyboard, click the
    46806360                <emphasis role="bold">Settings</emphasis> icon in the
    4681                 task bar. You can change colors used in the keyboard
     6361                toolbar. You can change colors used in the keyboard
    46826362                graphic, and can hide or show sections of the keyboard,
    46836363                such as the NumPad or multimedia keys.
    … …  
    47046384        <para>
    47056385          To permananently save a custom keyboard layout, you must save
    4706           it to file. Otherwise, any changes you make are discarded when
    4707           you close down the <emphasis role="bold">Soft
     6386          it to a file. Otherwise, any changes you make are discarded
     6387          when you close down the <emphasis role="bold">Soft
    47086388          Keyboard</emphasis> window.
    47096389        </para>
    … …  
    47286408          <para>
    47296409            Click the <emphasis role="bold">Layout List</emphasis> icon
    4730             in the task bar of the soft keyboard window.
     6410            in the toolbar of the soft keyboard window.
    47316411          </para>
    47326412        </listitem>
    … …  
    47776457        <listitem>
    47786458          <para>
    4779             (Optional) Save the layout to file. This means that your
     6459            (Optional) Save the layout to a file. This means that your
    47806460            custom keyboard layout will be available for future use.
    47816461          </para>
    … …  
    48036483  <sect1 id="vm-info">
    48046484
    4805     <title>Configuration Details and Runtime Information of Virtual Machines</title>
     6485    <title>Monitoring of Virtual Machines</title>
     6486
    48066487    <para>
    4807       &product-name; GUI offers several possibilities for obtaining
    4808       configuration and runtime information of virtual machines.
     6488      &vbox-mgr; includes the following tools for viewing runtime
     6489      information and changing the configuration of virtual machines.
    48096490    </para>
    48106491
    4811     <sect2 id="vm-details-tool">
    4812       <title>Virtual Machine Details Widget</title>
    4813       <para>
    4814         The VM details widget is an interactive tool through which
    4815         settings of the guest system can be viewed and modified.
    4816       </para>
    4817     </sect2>
    4818     <sect2 id="vm-activity-overview-widget">
    4819 
    4820       <title>Resource Monitor</title>
    4821 
    4822       <para>
    4823         The Resource Monitor widget shows several performance metrics
    4824         of running virtual machines. This enables users to have a quick
    4825         overview of system resources of individual virtual machines and
    4826         those of host system. The widget displays several performance
    4827         metrics of each running virtual machine. It is possible to
    4828         configure the set of metrics to be shown and select a metric
    4829         with respect to which the list of virtual machines is sorted.
    4830         It is also possible to open the virtual machine's performance
    4831         monitor (See <xref linkend="vm-session-information"/>) by activating
    4832         To Performance action which is located in the tool bar and
    4833         in the context menu.
    4834       </para>
     6492    <itemizedlist>
     6493
     6494      <listitem>
     6495        <para>
     6496          <emphasis role="bold"> VM Activity Overview.</emphasis>
     6497          Displays an overview of performance metrics for all running
     6498          VMs.
     6499        </para>
     6500
     6501        <para>
     6502          See <xref linkend="vm-activity-overview"/>.
     6503        </para>
     6504      </listitem>
     6505
     6506      <listitem>
     6507        <para>
     6508          <emphasis role="bold">Session Information Dialog.</emphasis>
     6509          Displays configuration and runtime information for the
     6510          selected guest system.
     6511        </para>
     6512
     6513        <para>
     6514          See <xref linkend="vm-activity-session-information"/>
     6515        </para>
     6516      </listitem>
     6517
     6518    </itemizedlist>
     6519
     6520    <sect2 id="vm-activity-overview">
     6521
     6522      <title>VM Activity Overview</title>
     6523
     6524      <para>
     6525        The VM Activity Overview tool displays several performance
     6526        metrics for all running virtual machines and for the host
     6527        system. This provides an overview of system resources used by
     6528        individual virtual machines and the host system.
     6529      </para>
     6530
     6531      <para>
     6532        To display the VM Activity Overview tool, do the following:
     6533      </para>
     6534
     6535      <para>
     6536        Go to the global <emphasis role="bold">Tools</emphasis> menu and
     6537        click <emphasis role="bold">Activities</emphasis>. The
     6538        <emphasis role="bold">VM Activity Overview</emphasis> window is
     6539        shown.
     6540      </para>
     6541
    48356542      <figure id="fig-vm-activity-overview-widget">
    4836         <title>Resource Monitor</title>
     6543        <title>VM Activity Overview Tool</title>
    48376544        <mediaobject>
    4838           <imageobject>
    4839             <imagedata align="center" fileref="images/resourcemonitor.png"
     6545       <imageobject>
     6546            <imagedata align="center" fileref="images/vm-activity-overview.png"
    48406547                       width="14cm" />
    48416548          </imageobject>
    … …  
    48436550      </figure>
    48446551
     6552      <para>
     6553        To show metrics for <emphasis>all</emphasis> virtual machines,
     6554        including those that are not running, right-click on the list of
     6555        virtual machines and select <emphasis role="bold">List All
     6556        Virtual Machines</emphasis>.
     6557      </para>
     6558
     6559      <para>
     6560        To configure the set of metrics to be shown, click
     6561        <emphasis role="bold">Columns</emphasis> in the toolbar. You can
     6562        then sort the list of virtual machines by a particular metric.
     6563      </para>
     6564
     6565      <para>
     6566        To see more performance information for a virtual machine,
     6567        select the VM name and click <emphasis role="bold">VM
     6568        Activity</emphasis> in the toolbar. The <emphasis role="bold">VM
     6569        Activity</emphasis> tab of the <emphasis role="bold">Session
     6570        Information</emphasis> dialog is shown, see
     6571        <xref linkend="vm-activity-session-information"/>.
     6572      </para>
     6573
    48456574    </sect2>
    48466575
    4847     <sect2 id="vm-session-information">
     6576    <sect2 id="vm-activity-session-information">
     6577
    48486578      <title>Session Information Dialog</title>
    4849       <para>
    4850         The guest VM window includes a multi tabbed dialog which conveys
    4851         important configuration and runtime information of the guest
    4852         system. The tabs of the dialog are:
     6579
     6580      <para>
     6581        The Session Information dialog includes multiple tabs which show
     6582        important configuration and runtime information for the guest
     6583        system. The tabs of the dialog are as follows:
    48536584      </para>
    48546585
    48556586      <itemizedlist>
    4856       <listitem>
    4857         <para>
    4858           <emphasis role="bold">Configuration Details</emphasis> tab
    4859           displays system configuration of the virtual machine in a
    4860           tabular format. The displayed information includes storage
    4861           configuration, audio settings, etc.
    4862         </para>
    4863       </listitem>
    4864       <listitem>
    4865         <para>
    4866           <emphasis role="bold">Runtime Information</emphasis> tab
    4867           shows the information that can change between the guest
    4868           sessions in tabular format similar to the Configuration
    4869           Details tab.
    4870         </para>
    4871       </listitem>
    4872       <listitem>
    4873         <para>
    4874           <emphasis role="bold">Performance Monitor</emphasis> tab
    4875           has several time series charts which monitors guests resource
    4876           usage including CPU, RAM, Disk I/O, and Network. Note that
    4877           RAM chart requires the guest additions to be running on the guest
    4878           system to work. The Performance Monitor is also available from
    4879           the machine menu in the manager UI.
    4880         </para>
    4881       </listitem>
     6587
     6588        <listitem>
     6589          <para>
     6590            <emphasis role="bold">Configuration Details.</emphasis>
     6591            Displays the system configuration of the virtual machine in
     6592            a tabular format. The displayed information includes details
     6593            such as storage configuration and audio settings.
     6594          </para>
     6595        </listitem>
     6596
     6597        <listitem>
     6598          <para>
     6599            <emphasis role="bold">Runtime Information.</emphasis>
     6600            Displays runtime information for the guest session in a
     6601            tabular format similar to the Configuration Details tab.
     6602          </para>
     6603        </listitem>
     6604
     6605        <listitem>
     6606          <para>
     6607            <emphasis role="bold">VM Activity.</emphasis> Includes
     6608            several time series charts which monitor guest resource
     6609            usage including CPU, RAM, Disk I/O, and Network. Note that
     6610            the RAM chart requires the Guest Additions to be running on
     6611            the guest system. The VM Activity tab can also be accessed
     6612            directly from the VM Activity Overview tool. See
     6613            <xref linkend="vm-activity-overview"/>.
     6614          </para>
     6615        </listitem>
     6616
     6617        <listitem>
     6618          <para>
     6619            <emphasis role="bold">Guest Control</emphasis>. Details of
     6620            processes used by the Guest Control File Manager. See
     6621            <xref linkend="guestadd-gc-file-manager"/>.
     6622          </para>
     6623        </listitem>
     6624
    48826625      </itemizedlist>
    4883       <figure id="fig-vm-performance-monitor">
    4884         <title>VM Performance Monitor</title>
     6626
     6627      <para>
     6628        To display the Session Information dialog, select
     6629        <emphasis role="bold">Machine</emphasis>,
     6630        <emphasis role="bold">Session Information</emphasis> in the
     6631        guest VM.
     6632      </para>
     6633
     6634      <figure id="fig-vm-session-information">
     6635        <title>Session Information Dialog, Showing VM Activity Tab</title>
    48856636        <mediaobject>
    4886           <imageobject>
    4887             <imagedata align="center" fileref="images/vmperformancemonitor.png"
    4888                        width="14cm" />
    4889           </imageobject>
     6637       <imageobject>
     6638            <imagedata align="center" fileref="images/session-information.png"
     6639                       width="12cm" />
     6640         </imageobject>
    48906641        </mediaobject>
    48916642      </figure>
    48926643
    4893 
    48946644    </sect2>
    48956645
    48966646  </sect1>
     6647
     6648  <sect1 id="log-viewer">
     6649
     6650    <title>The Log Viewer</title>
     6651
     6652    <para>
     6653      Every time you start up a VM, &product-name; creates a log file
     6654      that records system configuration and events. The
     6655      <emphasis role="bold">Log Viewer</emphasis> is a &vbox-mgr; tool
     6656      that enables you to view and analyze system logs.
     6657    </para>
     6658
     6659    <figure id="fig-log-viewer-tool">
     6660      <title>Log Viewer Tool, Showing System Events</title>
     6661     <mediaobject>
     6662        <imageobject>
     6663          <imagedata align="center" fileref="images/log-viewer.png"
     6664                   width="10cm" />
     6665        </imageobject>
     6666      </mediaobject>
     6667
     6668    </figure>
     6669
     6670    <para>
     6671      To display the Log Viewer, do either of the following:
     6672    </para>
     6673
     6674    <itemizedlist>
     6675
     6676      <listitem>
     6677        <para>
     6678          Click the VM name in the machine list and select
     6679          <emphasis role="bold">Logs</emphasis> from the machine tools
     6680          menu.
     6681        </para>
     6682      </listitem>
     6683
     6684      <listitem>
     6685        <para>
     6686          In the guest VM, select
     6687          <emphasis role="bold">Machine</emphasis>,
     6688          <emphasis role="bold">Show Log</emphasis>.
     6689        </para>
     6690      </listitem>
     6691
     6692    </itemizedlist>
     6693
     6694    <para>
     6695      Log messages for the VM are displayed in tabs in the Log Viewer
     6696      window. See <xref linkend="collect-debug-info"/> for details of
     6697      the various log files generated by &product-name;.
     6698    </para>
     6699
     6700    <para>
     6701      If you select multiple VMs in the machine list, logs are listed
     6702      for each VM.
     6703    </para>
     6704
     6705    <para>
     6706      The toolbar of the Log Viewer includes the following options:
     6707    </para>
     6708
     6709    <itemizedlist>
     6710
     6711      <listitem>
     6712        <para>
     6713          <emphasis role="bold">Save:</emphasis> Exports the contents of
     6714          the selected log file to a text file. Specify the destination
     6715          filename and location in the displayed dialog.
     6716        </para>
     6717      </listitem>
     6718
     6719      <listitem>
     6720        <para>
     6721          <emphasis role="bold">Find:</emphasis> Searches for a text
     6722          string in the log file.
     6723        </para>
     6724      </listitem>
     6725
     6726      <listitem>
     6727        <para>
     6728          <emphasis role="bold">Filter:</emphasis> Uses filter terms to
     6729          display specific types of log messages. Common log message
     6730          terms used by &product-name;, such as Audio and NAT, are
     6731          included by default. Select one or more terms from the
     6732          drop-down list. To add your own filter term, enter the text
     6733          string in the text box field.
     6734        </para>
     6735      </listitem>
     6736
     6737      <listitem>
     6738        <para>
     6739          <emphasis role="bold">Bookmark:</emphasis> Saves the location
     6740          of a log message, enabling you to find it quickly. To create a
     6741          bookmark, either click on the line number, or select some text
     6742          and then click <emphasis role="bold">Bookmark</emphasis>.
     6743        </para>
     6744      </listitem>
     6745
     6746      <listitem>
     6747        <para>
     6748          <emphasis role="bold">Options:</emphasis> Configures the text
     6749          display used in the log message window.
     6750        </para>
     6751      </listitem>
     6752
     6753      <listitem>
     6754        <para>
     6755          <emphasis role="bold">Refresh:</emphasis> Refreshes the log
     6756          file you are currently viewing. Only log messages in the
     6757          current tab are updated.
     6758        </para>
     6759      </listitem>
     6760
     6761      <listitem>
     6762        <para>
     6763          <emphasis role="bold">Reload:</emphasis> Refreshes all log
     6764          files. Log messages in every tab are updated.
     6765        </para>
     6766      </listitem>
     6767
     6768      <listitem>
     6769        <para>
     6770          <emphasis role="bold">Settings:</emphasis> Displays the
     6771          <emphasis role="bold">Settings</emphasis> window for the VM,
     6772          enabling you to make configuration changes.
     6773        </para>
     6774      </listitem>
     6775
     6776      <listitem>
     6777        <para>
     6778          <emphasis role="bold">Discard:</emphasis> For a running VM,
     6779          discards the saved state for the VM and closes it down.
     6780        </para>
     6781      </listitem>
     6782
     6783      <listitem>
     6784        <para>
     6785          <emphasis role="bold">Show/Start:</emphasis> For a running VM,
     6786          <emphasis role="bold">Show</emphasis> displays the VM window.
     6787          For a stopped VM, <emphasis role="bold">Start</emphasis>
     6788          displays options for powering up the VM.
     6789        </para>
     6790      </listitem>
     6791
     6792    </itemizedlist>
     6793
     6794  </sect1>
     6795
    48976796</chapter>
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