summaryrefslogtreecommitdiffstats
path: root/en-US/Boxes.xml
diff options
context:
space:
mode:
Diffstat (limited to 'en-US/Boxes.xml')
-rw-r--r--en-US/Boxes.xml110
1 files changed, 57 insertions, 53 deletions
diff --git a/en-US/Boxes.xml b/en-US/Boxes.xml
index 03e2783..6dd5f82 100644
--- a/en-US/Boxes.xml
+++ b/en-US/Boxes.xml
@@ -142,78 +142,82 @@
To exit the settings menu, <emphasis>press the arrow pointing <guilabel>back</guilabel> or to the left on the top left hand side of the menu bar</emphasis>. This will return you to your virtual machine console.
</para>
</section>
-<!-- This is rather advanced process that is going to take some testing as it does not look Boxes supports this via the GUI
<section id="Move-VM">
<title>How do I move a Virtual Machine between computers?</title>
<para>
To Move a Virtual Machine made in Boxes takes two steps:
</para>
+<note><para>$USER is a variable or place holder for whatever your username is on your system. For example: if your username is glen, /home/$USER would mean /home/glen</para></note>
<orderedlist>
- <listitem><para>Move of the virtual hard drive that is kept in:<filename class="directory">/home/$USER/.local/share/gnome-boxes/images
- </filename></para></listitem>
- <listitem><para>Move of the XML configuration file that is kept in: <filename class="directory">/home/$USER/.config//gnome-boxes
- </filename></para></listitem>
+ <listitem>
+ <para>Move of the virtual hard drive that is kept in:<filename class="directory">/home/$USER/.local/share/gnome-boxes/images</filename>
+ </para>
+ </listitem>
+ <listitem>
+ <para>Export of the XML file via <command>VIRSH dumpxml</command>.
+ </para>
+ </listitem>
</orderedlist>
-<procedure><title>Move a VM Hard drive "image" file between Computers</title>
- <step><para>Open your home folder via files
-</para>
-</step>
-<step><para>Press CTRL+H to view hidden files
-</para></step>]
-<step><para>Open the<emphasis> .local</emphasis> folder
-</para></step>]
-<step><para>Open the <emphasis>share</emphasis> folder
-</para></step>]
-<step><para>Open the <emphasis>gnome-boxes</emphasis> folder
-</para></step>]
-<step><para>Open the <emphasis>images</emphasis> folder
-</para></step>]
-<step><para>Right Click on the file of the virtual machine and copy it to remove-able media or network share
-</para></step>
-<step><para>On the receiving computer, do the steps in reverse order, ultimately placing the hard drive file in: <filename class="directory">/home/$USER/.local/share/gnome-boxes/images
- </filename>
-</para></step>
+<procedure>
+ <title>Move a VM Hard drive "image" file between Computers</title>
+ <step><para>Open your home folder via files
+ </para>
+ </step>
+ <step><para>Press CTRL+H to view hidden files.
+ </para>
+ </step>
+ <step><para>Open the<emphasis> .local</emphasis> folder.
+ </para>
+ </step>
+ <step><para>Open the <emphasis>share</emphasis> folder.
+ </para>
+ </step>
+ <step><para>Open the <emphasis>gnome-boxes</emphasis> folder.
+ </para>
+ </step>
+ <step><para>Open the <emphasis>images</emphasis> folder.
+ </para>
+ </step>
+ <step><para>If You only have one virtual machine it will be called <emphasis>boxes-unknown</emphasis> by default. <emphasis>Right Click </emphasis>on the file of the virtual machine and copy it to the USB drive, network drive, or what ever media you will be using to copy your VM to the other computer.
+ </para>
+ </step>
+ <step><para>On the receiving computer, do the steps in reverse order, ultimately placing the hard drive file in: <filename class="directory">/home/$USER/.local/share/gnome-boxes/images</filename>.
+ </para>
+ </step>
</procedure>
-<procedure><title>Move a VM Hard drive "Config" file between Computers</title>
- <step><para>Open your home folder via files
-</para>
-</step>
-<step><para>Press CTRL+H to view hidden files
-</para></step>]
-<step><para>Open the<emphasis> .config</emphasis> folder
-</para></step>]
-<step><para>Open the <emphasis>share</emphasis> folder
-</para></step>]
-<step><para>Open the <emphasis>gnome-boxes</emphasis> folder
-</para></step>]
-<step><para>Open the <emphasis>images</emphasis> folder
-</para></step>]
-<step><para>Right Click on the file of the virtual machine and copy it to remove-able media or network share
-</para></step>
-<step><para>On the receiving computer, do the steps in reverse order, ultimately placing the hard drive file in: <filename class="directory">/home/$USER/.local/share/gnome-boxes/images
- </filename>
-</para></step>
+<procedure>
+ <title>Copy a Virtual Machine "Config" file between Computers</title>
+ <step><para>Open a terminal window.
+ </para></step>
+ <step><para>type in <command> virsh list --all </command>
+ </para></step>
+ <step><para>If you only have one Virtual machine the default will be called <emphasis> boxes-unknown</emphasis>.
+ </para></step>
+ <step><para>To export the <emphasis>boxes-unknown</emphasis> machine configuration, issue the command: <command>virsh dumpxml boxes-unknown >~/boxes-unknown.xml</command> This will place the xml config file in the root of your home folder. So it would be located at: <filename class="directory">/home/$USER/boxes-unknown.xml</filename>
+ </para></step>
+ <step><para>Now that the configuration XML file "boxes-unknown.xml" is in the root of your home directory, copy it to the USB drive, network drive, or what ever media you will be using to copy your VM to the other/receiving computer.
+ </para></step>
+ <step><para>On the receiving computer, copy the boxes-unknown.xml into the root of your home folder: <filename class="directory">/home/$USER/boxes-unknown.xml</filename>
+ </para></step>
+ <step><para>On the receiving computer, open a terminal window
+ </para></step>
+ <step><para>In the terminal window issue the command: <command>virsh create boxes-unknown.xml</command>
+ </para></step>
</procedure>
-</section> -->
+</section>
<section id="sec-tips-tricks">
<title>Boxes Tips and Tricks</title>
<itemizedlist>
<listitem>
<para>Boxes uses <application>libvertd</application> and many <application>libvertd</application> commands can be used for Boxes virtual machines.
- </para>
+ </para>
</listitem>
<listitem>
- <para>Boxes keeps the virtual machine disks or images in:<filename class="directory">/home/$USER/.local/share/gnome-boxes/images
- </filename>
+ <para>Boxes keeps the virtual machine disks or images in:<filename class="directory">/home/$USER/.local/share/gnome-boxes/images</filename>
</para>
</listitem>
- <listitem>
- <para>Boxes keeps the configuration files for virtual machines in:<filename class="directory">/home/$USER/.config/share/gnome-boxes
- </filename>
- </para>
- </listitem>
</itemizedlist>
- </section>
+</section>
<section id="sec-advanced-items">
<title>Advanced Commands in Boxes</title>
<para>