Changeset 105618 in vbox
- Timestamp:
- Aug 8, 2024 8:47:54 AM (6 months ago)
- Location:
- trunk/doc/manual/en_US/dita
- Files:
-
- 2 added
- 8 edited
-
UserManual.ditamap (modified) (1 diff)
-
topics/cloud-profile-creating.dita (added)
-
topics/cloud-profile-importing.dita (added)
-
topics/cloud-using-cloud-profile-manager.dita (modified) (1 diff)
-
topics/create-virtual-hard-disk-image.dita (modified) (1 diff)
-
topics/guestadd-dnd.dita (modified) (2 diffs)
-
topics/guestadd-gc-file-manager-using.dita (modified) (2 diffs)
-
topics/guestadd-gc-file-manager.dita (modified) (1 diff)
-
topics/settings-storage.dita (modified) (2 diffs)
-
topics/virtual-media-manager.dita (modified) (1 diff)
Legend:
- Unmodified
- Added
- Removed
-
trunk/doc/manual/en_US/dita/UserManual.ditamap
r105564 r105618 96 96 <topicref href="topics/cloud-upload-public-key.dita"/> 97 97 <topicref href="topics/cloud-create-cloud-profile.dita"/> 98 <topicref href="topics/cloud-using-cloud-profile-manager.dita"/> 98 <topicref href="topics/cloud-using-cloud-profile-manager.dita"> 99 <topicref href="topics/cloud-profile-creating.dita"/> 100 <topicref href="topics/cloud-profile-importing.dita"/> 101 </topicref> 99 102 <topicref href="topics/cloud-vbox-oci-tasks.dita"/> 100 103 <topicref href="topics/cloud-vm.dita"> -
trunk/doc/manual/en_US/dita/topics/cloud-using-cloud-profile-manager.dita
r105303 r105618 5 5 6 6 <body> 7 <p>This section describes how to use the Cloud Profile Manager to create a cloud profile. </p>8 7 <p>To open the Cloud Profile Manager click <b outputclass="bold">File</b>, <b outputclass="bold">Cloud Profile 9 8 Manager</b> in <ph conkeyref="vbox-conkeyref-phrases/vbox-mgr"/>. </p> 10 <fig id="fig-cloud-profile-manager">11 <title>The Cloud Profile Manager</title>12 <xref href="images/cloud-profile-manager.png" format="png" platform="htmlhelp">13 <image href="images/cloud-profile-manager.png" width="12cm" placement="break">14 <alt>The Cloud Profile Manager</alt>15 </image>16 </xref>17 <image href="images/cloud-profile-manager.png" width="12cm" placement="break" platform="ohc">18 <alt>The Cloud Profile Manager</alt>19 </image>20 </fig>21 9 <p>You can use the Cloud Profile Manager in the following ways: </p> 22 10 <ul> 23 11 <li> 24 <p> 25 To create a new cloud profile automatically 26 </p> 12 <p>To create a new cloud profile automatically.</p> 27 13 </li> 28 14 <li> 29 <p> 30 To create a cloud profile by importing settings from your 31 <ph conkeyref="vbox-conkeyref-phrases/oci"/> configuration file. 32 </p> 15 <p>To create a cloud profile by importing settings from your <ph conkeyref="vbox-conkeyref-phrases/oci"/> 16 configuration file. </p> 33 17 </li> 34 18 </ul> 35 <p>Perform the following steps to create a new cloud profile automatically, using the Cloud Profile Manager: </p>36 <ol>37 <li>38 <p>39 Click the <b outputclass="bold">Add</b> icon and40 specify a <b outputclass="bold">Name</b> for the41 profile.42 </p>43 </li>44 <li>45 <p>46 Click <b outputclass="bold">Properties</b> and47 specify the following property values for the profile:48 </p>49 <ul>50 <li>51 <p>52 Compartment OCID53 </p>54 </li>55 <li>56 <p>57 Fingerprint of the public key58 </p>59 </li>60 <li>61 <p>62 Location of the private key on the client device63 </p>64 </li>65 <li>66 <p>67 Region OCID68 </p>69 </li>70 <li>71 <p>72 Tenancy OCID73 </p>74 </li>75 <li>76 <p>77 User OCID78 </p>79 </li>80 </ul>81 <p>82 Some of these are settings for your <ph conkeyref="vbox-conkeyref-phrases/oci"/> account, which you83 can view from the <ph conkeyref="vbox-conkeyref-phrases/oci"/> Console.84 </p>85 </li>86 <li>87 <p>(Optional) If you are using the cloud profile to connect to cloud virtual machines, select the <b88 outputclass="bold">Show VMs</b> check box. </p>89 <p>This creates a new subgroup of the <b outputclass="bold">OCI</b> group in <ph90 conkeyref="vbox-conkeyref-phrases/vbox-mgr"/>. See <xref href="cloud-vm-oci-group.dita#cloud-vm-oci-group"91 />. </p>92 </li>93 <li>94 <p>Click <b outputclass="bold">Apply</b> to save your changes. </p>95 <p>The cloud profile settings are saved to the <filepath>oci_config</filepath> file in your <ph96 conkeyref="vbox-conkeyref-phrases/product-name"/> global settings directory. </p>97 </li>98 </ol>99 <p>Perform the following steps to import an existing <ph conkeyref="vbox-conkeyref-phrases/oci"/> configuration file100 into the Cloud Profile Manager: </p>101 <ol>102 <li>103 <p>104 Ensure that a <filepath>config</filepath> file is present in105 your <ph conkeyref="vbox-conkeyref-phrases/oci"/> configuration directory. For example, this is106 <filepath>$HOME/.oci/config</filepath> on a Linux host.107 </p>108 </li>109 <li>110 <p>111 Click the <b outputclass="bold">Import</b> icon to112 open a dialog that prompts you to import cloud profiles from113 external files.114 </p>115 <note>116 <p>This action overwrites any cloud profiles that are in your <ph117 conkeyref="vbox-conkeyref-phrases/product-name"/> global settings directory. </p>118 </note>119 </li>120 <li>121 <p>Click <b outputclass="bold">Import</b>. </p>122 <p>Your cloud profile settings are saved to the <filepath>oci_config</filepath> file in your <ph123 conkeyref="vbox-conkeyref-phrases/product-name"/> global settings directory. </p>124 </li>125 <li>126 <p>Click <b outputclass="bold">Properties</b> to show the cloud profile settings. </p>127 <p>Double-click the appropriate field to change the value. </p>128 </li>129 <li>130 <p>Click <b outputclass="bold">Apply</b> to save your changes. </p>131 </li>132 </ol>133 19 </body> 134 20 -
trunk/doc/manual/en_US/dita/topics/create-virtual-hard-disk-image.dita
r105335 r105618 5 5 6 6 <body> 7 <p>Use the <b outputclass="bold">Create Virtual Hard Disk</b> wizard to create a hard disk image. </p>8 7 <ol> 9 8 <li> 10 9 <p>Display the <b outputclass="bold">Hard Disks</b> tab in Virtual Media Manager and click <b outputclass="bold" 11 10 >Create</b>. </p> 12 <p>The <b outputclass="bold">Create Virtual Hard Disk</b> wizard is shown. </p>13 <fig id="fig-virtual-hard-disk-wizard">14 <title>Create Virtual Hard Disk Wizard</title>15 <xref href="images/virtual-hard-disk-wizard.png" format="png" platform="htmlhelp">16 <image href="images/virtual-hard-disk-wizard.png" width="12cm" placement="break">17 <alt>Create Virtual Hard Disk Wizard</alt>18 </image>19 </xref>20 <image platform="ohc" href="images/virtual-hard-disk-wizard.png" width="12cm" placement="break">21 <alt>Create Virtual Hard Disk Wizard</alt>22 </image>23 </fig>24 11 </li> 25 12 <li> 26 <p>On the <b outputclass="bold">Virtual Hard Disk File Type</b> page, select a file type for the new virtual 27 hard disk image. </p> 28 <p> 29 Click <b outputclass="bold">Next</b>. 30 </p> 13 <p>Select a file type for the new virtual hard disk image. </p> 31 14 </li> 32 15 <li> 33 <p>On the <b outputclass="bold">Storage on Physical Hard Disk</b> page, select whether the size of the virtual 34 hard disk file is dynamically allocated or is of fixed size. </p> 35 <p>Click <b outputclass="bold">Next</b>. </p> 16 <p>Select dynamically allocated or fixed size storage for the virtual hard disk. </p> 36 17 </li> 37 18 <li> 38 <p> On the <b outputclass="bold">File Location and Size</b> page, configure the location of the virtual hard disk39 file and use the slider to set the size limit for the virtualhard disk. </p>19 <p>Configure the location of the virtual hard disk file and use the slider to set the size limit for the virtual 20 hard disk. </p> 40 21 <p>Click <b outputclass="bold">Finish</b> to create the virtual hard disk file. </p> 41 22 <p>The virtual hard disk image is created in the specified location and added to the <b outputclass="bold">Hard -
trunk/doc/manual/en_US/dita/topics/guestadd-dnd.dita
r99797 r105618 5 5 6 6 <body> 7 <p> 8 <ph conkeyref="vbox-conkeyref-phrases/product-name"/> enables you to drag and drop content from the host 9 to the guest, and vice versa. For this to work the latest version 10 of the Guest Additions must be installed on the guest. 11 </p> 12 <p> 13 Drag and drop transparently allows copying or opening files, 14 directories, and even certain clipboard formats from one end to 15 the other. For example, from the host to the guest or from the 16 guest to the host. You then can perform drag and drop operations 17 between the host and a VM, as it would be a native drag and drop 18 operation on the host OS. 19 </p> 20 <p> 21 At the moment drag and drop is implemented for Windows-based and 22 X-Windows-based systems, both on the host and guest side. As 23 X-Windows supports many different drag and drop protocols only the 24 most common one, XDND, is supported for now. Applications using 25 other protocols, such as Motif or OffiX, will not be recognized by 26 <ph conkeyref="vbox-conkeyref-phrases/product-name"/>. 27 </p> 28 <p> 29 In the context of using drag and drop, the origin of the data is 30 called the <i>source</i>. That is, where the actual 31 data comes from and is specified. The 32 <i>destination</i> specifies where the data from the 33 source should go to. Transferring data from the source to the 34 destination can be done in various ways, such as copying, moving, 35 or linking. 36 </p> 7 <p><ph conkeyref="vbox-conkeyref-phrases/product-name"/> enables you to drag and drop content from the host to the 8 guest, and vice versa. For this to work the latest version of the Guest Additions must be installed on the guest. </p> 9 <p>Drag and drop transparently allows copying or opening files, directories, and even certain clipboard formats from 10 one end to the other. For example, from the host to the guest or from the guest to the host. You then can perform 11 drag and drop operations between the host and a VM, as it would be a native drag and drop operation on the host 12 OS. </p> 13 <p>At the moment drag and drop is implemented for Windows-based and X-Windows-based systems, both on the host and 14 guest side. As X-Windows supports many different drag and drop protocols only the most common one, XDND, is 15 supported for now. Applications using other protocols, such as Motif or OffiX, will not be recognized by <ph 16 conkeyref="vbox-conkeyref-phrases/product-name"/>. </p> 17 <p>In the context of using drag and drop, the origin of the data is called the <i>source</i>. That is, where the 18 actual data comes from and is specified. The <i>destination</i> specifies where the data from the source should go 19 to. Transferring data from the source to the destination can be done in various ways, such as copying, moving, or 20 linking. </p> 37 21 <note> 38 <p> 39 At the moment only copying of data is supported. Moving or 40 linking is not yet implemented. 41 </p> 22 <p>At the moment only copying of data is supported. Moving or linking is not yet implemented. </p> 42 23 </note> 43 <p> 44 When transferring data from the host to the guest OS, the host in 45 this case is the source, whereas the guest OS is the destination. 46 However, when transferring data from the guest OS to the host, the 47 guest OS this time became the source and the host is the 48 destination. 49 </p> 50 <p> 51 For security reasons drag and drop can be configured at runtime on 52 a per-VM basis either using the <b outputclass="bold">Drag and 53 Drop</b> menu item in the 54 <b outputclass="bold">Devices</b> menu of the virtual 55 machine, as shown below, or the <userinput>VBoxManage</userinput> 56 command. 57 </p> 58 <fig id="fig-drag-drop-options"> 59 <title>Drag and Drop Menu Options</title> 60 <xref href="images/dnd-modes.png" format="png" platform="htmlhelp"> 61 <image href="images/dnd-modes.png" width="10cm" placement="break"> 62 <alt>Drag and Drop Menu Options</alt> 63 </image> 64 </xref> 65 <image platform="ohc" href="images/dnd-modes.png" width="10cm" placement="break"> 66 <alt>Drag and Drop Menu Options</alt> 67 </image> 68 </fig> 69 <p> 70 The following drag and drop modes are available: 71 </p> 24 <p>When transferring data from the host to the guest OS, the host in this case is the source, whereas the guest OS 25 is the destination. However, when transferring data from the guest OS to the host, the guest OS this time became 26 the source and the host is the destination. </p> 27 <p>For security reasons drag and drop can be configured at runtime on a per-VM basis either using the <b 28 outputclass="bold">Drag and Drop</b> menu item in the <b outputclass="bold">Devices</b> menu of the virtual 29 machine, as shown below, or the <userinput>VBoxManage</userinput> command. </p> 30 <p>The following drag and drop modes are available: </p> 72 31 <ul> 73 32 <li> … … 95 54 </ul> 96 55 <note> 97 <p> 98 Drag and drop support depends on the frontend being used. At the 99 moment, only the <ph conkeyref="vbox-conkeyref-phrases/vbox-mgr"/> frontend provides this 100 functionality. 101 </p> 56 <p>Drag and drop support depends on the frontend being used. At the moment, only the <ph 57 conkeyref="vbox-conkeyref-phrases/vbox-mgr"/> frontend provides this functionality. </p> 102 58 </note> 103 <p> 104 To use the <userinput>VBoxManage</userinput> command to control the 105 current drag and drop mode, see <xref href="vboxmanage.dita#vboxmanage"/>. The 106 <userinput>modifyvm</userinput> and <userinput>controlvm</userinput> 107 commands enable setting of a VM's current drag and drop mode from 108 the command line. 109 </p> 59 <p>To use the <userinput>VBoxManage</userinput> command to control the current drag and drop mode, see <xref 60 href="vboxmanage.dita#vboxmanage"/>. The <userinput>modifyvm</userinput> and <userinput>controlvm</userinput> 61 commands enable setting of a VM's current drag and drop mode from the command line. </p> 110 62 </body> 111 63 </topic> -
trunk/doc/manual/en_US/dita/topics/guestadd-gc-file-manager-using.dita
r105176 r105618 2 2 <!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd"> 3 3 <topic xml:lang="en-us" id="guestadd-gc-file-manager-using"> 4 <title> Using the Guest Control File Manager</title>4 <title>Transferring Files</title> 5 5 6 6 <body> 7 <p> 8 The following steps describe how to use the Guest Control File 9 Manager. 10 </p> 7 <p>To use the Guest Control File Manager to transfer files, follow these steps. </p> 11 8 <ol> 12 9 <li> 13 <p> 14 Open the Guest Control File Manager. Do either of the 15 following: 16 </p> 10 <p>Open the Guest Control File Manager. Do either of the following: </p> 17 11 <ul> 18 12 <li> … … 33 27 </li> 34 28 <li> 35 <p> 36 Create a guest session. 37 </p> 38 <p> 39 At the bottom of the Guest Control File Manager, enter 40 authentication credentials for a user on the guest system. 41 </p> 42 <p> 43 Click <b outputclass="bold">Create Session</b>. 44 </p> 45 <p> 46 The contents of the guest VM file system appears in the 47 right pane of the Guest Control File Manager. 48 </p> 29 <p>In the Guest Control File Manager, enter authentication credentials for a user on the guest system. </p> 30 <p>Click <b outputclass="bold">Create Session</b>. </p> 31 <p>The contents of the guest VM file system appears in the right pane of the Guest Control File Manager. </p> 49 32 </li> 50 33 <li> 51 <p> 52 Transfer files between the guest and the host system by 53 using the move and copy file transfer icons. 54 </p> 55 <p> 56 You can copy and move files from the guest to the host 57 system or from the host system to the guest. 58 </p> 34 <p>Transfer files between the guest and the host system by using the move and copy file transfer icons. </p> 35 <p>You can copy and move files from the guest to the host system or from the host system to the guest. </p> 59 36 </li> 60 37 <li> 61 <p> 62 Close the Guest Control File Manager. 63 </p> 64 <p> 65 Click <b outputclass="bold">Close</b> to end the 66 guest session. 67 </p> 38 <p>Click <b outputclass="bold">Close</b> to end the guest session and the Guest Control File Manager. </p> 68 39 </li> 69 40 </ol> -
trunk/doc/manual/en_US/dita/topics/guestadd-gc-file-manager.dita
r105134 r105618 3 3 <topic xml:lang="en-us" id="guestadd-gc-file-manager"> 4 4 <title>Guest Control File Manager</title> 5 <!-- 7.1: new icons added, new pic needed-->5 <!-- 7.1: new icons added, pic removed--> 6 6 <body> 7 <p> 8 The Guest Control File Manager is a feature of the Guest Additions 9 that enables easy copying and moving of files between a guest and 10 the host system. Other file management operations provide support 11 to create new folders and to rename or delete files. 12 </p> 13 <p> 14 This feature is useful when the VM window of a guest is not 15 visible. For example, when the guest is running in headless mode. 16 </p> 7 <p>The Guest Control File Manager is a feature of the Guest Additions that enables easy copying and moving of files 8 between a guest and the host system. Other file management operations provide support to create new folders and to 9 rename or delete files. </p> 10 <p>This feature is useful when the VM window of a guest is not visible. For example, when the guest is running in 11 headless mode. </p> 17 12 <note> 18 <p> 19 To use the Guest Control File Manager, the guest must be 20 running. For powered-off guests, it is disabled automatically. 21 </p> 13 <p>To use the Guest Control File Manager, the guest must be running. For powered-off guests, it is disabled 14 automatically. </p> 22 15 </note> 23 <fig id="fig-guest-control-fm">24 <title>Guest Control File Manager</title>25 <xref href="images/guest-fm.png" format="png" platform="htmlhelp">26 <image href="images/guest-fm.png" width="12cm" placement="break">27 <alt>Guest Control File Manager</alt>28 </image>29 </xref>30 <image platform="ohc" href="images/guest-fm.png" width="12cm" placement="break">31 <alt>Guest Control File Manager</alt>32 </image>33 </fig>34 <p>35 The Guest Control File Manager works by mounting the host file36 system. Guest users must authenticate and create a guest session37 before they can transfer files.38 </p>39 16 </body> 40 17 </topic> -
trunk/doc/manual/en_US/dita/topics/settings-storage.dita
r105289 r105618 5 5 6 6 <body> 7 <p>The <b outputclass="bold">Storage</b> category in the VM settings enables you to connect virtual hard disk ,8 CD/DVD , and floppyimages and drives to your virtual machine. </p>7 <p>The <b outputclass="bold">Storage</b> category in the VM settings enables you to connect virtual hard disk and 8 CD/DVD images and drives to your virtual machine. </p> 9 9 <p>In a real computer, so-called <i>storage controllers</i> connect physical disk drives to the rest of the 10 10 computer. Similarly, <ph conkeyref="vbox-conkeyref-phrases/product-name"/> presents virtual storage controllers to 11 a virtual machine. Under each controller, the virtual devices, such as hard disks , CD/DVD or floppy drives,12 attached tothe controller are shown. </p>11 a virtual machine. Under each controller, the virtual devices, such as hard disks and CD/DVD drives, attached to 12 the controller are shown. </p> 13 13 <note> 14 14 <p>This section gives a quick introduction to the <ph conkeyref="vbox-conkeyref-phrases/product-name"/> storage … … 16 16 <ph conkeyref="vbox-conkeyref-phrases/product-name"/>. </p> 17 17 </note> 18 <p>If you have used the <b outputclass="bold">Create Virtual Machine</b> wizard to create a machine, you will19 normally see something like the following: </p>20 <fig id="fig-storage-settings">21 <title>Storage Settings for a Virtual Machine</title>22 <xref href="images/vm-settings-harddisk.png" format="png" platform="htmlhelp">23 <image href="images/vm-settings-harddisk.png" width="10cm" placement="break">24 <alt>Storage Settings for a Virtual Machine</alt>25 </image>26 </xref>27 <image platform="ohc" href="images/vm-settings-harddisk.png" width="10cm" placement="break">28 <alt>Storage Settings for a Virtual Machine</alt>29 </image>30 </fig>31 18 <p>Depending on the guest OS type that you selected when you created the VM, a new VM includes the following storage 32 19 devices: </p> -
trunk/doc/manual/en_US/dita/topics/virtual-media-manager.dita
r105335 r105618 21 21 tool, which you access by clicking <b outputclass="bold">Media</b> on the global <b outputclass="bold">Tools</b> 22 22 menu in <ph conkeyref="vbox-conkeyref-phrases/vbox-mgr"/>. </p> 23 <fig id="fig-virtual-media-manager">24 <title>The Virtual Media Manager, Showing Hard Disk Images</title>25 <xref href="images/virtual-disk-manager.png" format="png" platform="htmlhelp">26 <image href="images/virtual-disk-manager.png" width="12cm" placement="break">27 <alt>The Virtual Media Manager, Showing Hard Disk Images</alt>28 </image>29 </xref>30 <image platform="ohc" href="images/virtual-disk-manager.png" width="12cm" placement="break">31 <alt>The Virtual Media Manager, Showing Hard Disk Images</alt>32 </image>33 </fig>34 23 <p>The known media are conveniently grouped in separate tabs for the supported formats. These formats 35 24 are: </p>
Note:
See TracChangeset
for help on using the changeset viewer.
