removing/changing broken links
parent
541edc9265
commit
90f1ec75f6
|
@ -130,9 +130,7 @@ that is included on OSGeoLive (:file:`/usr/local/share/data/natural_earth2/`).
|
|||
will notice that under *Native SRS* it says UNKNOWN you will need to fill in
|
||||
the next box (*declared SRS*) to make sure |GS| knows where the data is.
|
||||
|
||||
#. You can type epsg:4326 in the box, or go to `http://prj2epsg.org/search
|
||||
<http://prj2epsg.org/search>`_ and paste in the string you see if you click
|
||||
on the link next to "UNKNOWN".
|
||||
#. You can type epsg:4326 in the box
|
||||
#. Click on :guilabel:`Compute from data` and :guilabel:`Compute from native
|
||||
bounds` to fill in the Bounding Boxes.
|
||||
#. Finally hit :guilabel:`save` and you have published your first layer.
|
||||
|
|
|
@ -7,18 +7,18 @@
|
|||
Running in a Hyper-V Virtual Machine
|
||||
********************************************************************************
|
||||
|
||||
This Quick Start describes how to run OSGeoLive using Hyper-V, Microsoft's virtualisation software. For other methods, follow links from the "See Also" section below.
|
||||
Hyper-V is available on both Windows Server, and Windows 10 Professional - it is not part of Windows 10 Home.
|
||||
This Quick Start describes how to run OSGeoLive using Hyper-V, Microsoft's virtualisation software. For other methods, follow links from the "See Also" section below.
|
||||
Hyper-V is available on both Windows Server, and Windows 10 Professional - it is not part of Windows 10 Home.
|
||||
|
||||
The advantages of using a virtual machine are the same as those outlined at :doc:`virtualization_quickstart`. Unfortunately Virtual Box and Hyper-V
|
||||
cannot be run simultaneously. This leaves 2 options - disabling the Hyper-V feature, or configuring a new Hyper-V machine to run OSGeoLive.
|
||||
A free tool `hypervswitch <https://unclassified.software/en/apps/hypervswitch>`_ can be used to quickly enable and disable Hyper-V - however it still
|
||||
requires a reboot each time the setting is changed. The rest of this page documents how to configure OSGeoLive to run on Hyper-V.
|
||||
The advantages of using a virtual machine are the same as those outlined at :doc:`virtualization_quickstart`. Unfortunately Virtual Box and Hyper-V
|
||||
cannot be run simultaneously. This leaves 2 options - disabling the Hyper-V feature, or configuring a new Hyper-V machine to run OSGeoLive.
|
||||
A free tool `hypervswitch <https://unclassified.software/en/apps/hypervswitch>`_ can be used to quickly enable and disable Hyper-V - however it still
|
||||
requires a reboot each time the setting is changed. The rest of this page documents how to configure OSGeoLive to run on Hyper-V.
|
||||
|
||||
System Requirements
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
Hyper-V requirements can be found `here <https://docs.microsoft.com/en-us/virtualization/hyper-v-on-windows/reference/hyper-v-requirements>`_.
|
||||
Hyper-V requirements can be found `here <https://learn.microsoft.com/en-us/virtualization/hyper-v-on-windows/quick-start/enable-hyper-v>`_.
|
||||
This link also provides information on checking if your machine is compatible using the ``systeminfo`` command. In summary the host machine
|
||||
needs to have the following hardware requirements:
|
||||
|
||||
|
@ -32,92 +32,94 @@ Download the OSGeoLive VirtualBox virtual hard disk (vmdk) by following the link
|
|||
Once downloaded unzip the downloaded file (using `7zip <https://www.7-zip.org>`_ ).
|
||||
|
||||
The virtual machine image format for Hyper-V differs from the VirtualBox download. The file therefore has to be converted from ``vmdk`` to
|
||||
``vhdx``. There are currently two conversion options available.
|
||||
``vhdx``. There are currently two conversion options available.
|
||||
|
||||
StarWind V2V Converter
|
||||
++++++++++++++++++++++
|
||||
|
||||
Use the `StarWind V2V Converter <https://www.starwindsoftware.com/starwind-v2v-converter>`_ program. This has a simple user interface allowing you to select the
|
||||
``osgeo-live-XX.X-vm.vmdk`` file and convert to a *Microsoft VHDX* image.
|
||||
``osgeo-live-XX.X-vm.vmdk`` file and convert to a *Microsoft VHDX* image.
|
||||
|
||||
Microsoft Virtual Machine Converter 3.0
|
||||
+++++++++++++++++++++++++++++++++++++++
|
||||
|
||||
The second more complicated option is as follows.
|
||||
|
||||
#. Download the `Microsoft Virtual Machine Converter 3.0 <https://www.microsoft.com/en-us/download/details.aspx?id=42497>`_ and install.
|
||||
#. Download the `Microsoft Virtual Machine Converter 3.0
|
||||
<https://techcommunity.microsoft.com/t5/system-center-blog/microsoft-virtual-machine-converter-3-0-is-now-available-for/ba-p/349874>`_
|
||||
and install.
|
||||
#. Download the DS File Ops Kit and unzip.
|
||||
#. Open PowerShell (with administrator rights)
|
||||
#. Run the following command to get the disk descriptor from the OSGeoLive vmdk. This saves the disk description to the "descriptor1.txt" file.
|
||||
#. Run the following command to get the disk descriptor from the OSGeoLive vmdk. This saves the disk description to the "descriptor1.txt" file.
|
||||
|
||||
.. TODO link is broken #. Download the `DS File Ops Kit <http://members.ozemail.com.au/~nulifetv/freezip/freeware/dsfok.zip>`_ and unzip.
|
||||
.. TODO link is broken #. Download the `DS File Ops Kit <http://members.ozemail.com.au/~nulifetv/freezip/freeware/dsfok.zip>`_ and unzip.
|
||||
|
||||
.. code-block:: bat
|
||||
|
||||
|
||||
cd D:\osgeo-live-11.0-vm
|
||||
D:\tools\dsfo.exe .\osgeo-live-11.0-vm.vmdk 512 1024 descriptor1.txt
|
||||
|
||||
|
||||
#. Open this in a text editor (such as Notepad) and comment out the following lines using hashes (this metadata is VirtualBox specific and is not recognised by the converter):
|
||||
|
||||
.. code-block:: bat
|
||||
|
||||
.. code-block:: bat
|
||||
|
||||
#ddb.uuid.image="0247ca9d-f9aa-4910-9e8c-1c14d83a7749"
|
||||
#ddb.uuid.parent="00000000-0000-0000-0000-000000000000"
|
||||
#ddb.uuid.modification="81a1d704-3e4a-443d-a5ca-2fd085ba086a"
|
||||
#ddb.uuid.parentmodification="00000000-0000-0000-0000-000000000000"
|
||||
#ddb.comment=""
|
||||
|
||||
|
||||
#. Run the following command to insert the disk descriptor back into the ``vmdk`` file:
|
||||
|
||||
.. code-block:: bat
|
||||
|
||||
.. code-block:: bat
|
||||
|
||||
D:\tools\dsfi.exe .\osgeo-live-11.0-vm.vmdk 512 1024 descriptor1.txt
|
||||
|
||||
.. note::
|
||||
|
||||
Failing to do the above steps will result in the error *"ConvertTo-MvmcVirtualHardDisk : The entry 0247ca9d-f9aa-4910-9e8c-1c14d83a7749 is not a supported
|
||||
|
||||
Failing to do the above steps will result in the error *"ConvertTo-MvmcVirtualHardDisk : The entry 0247ca9d-f9aa-4910-9e8c-1c14d83a7749 is not a supported
|
||||
disk database entry for the descriptor."*
|
||||
|
||||
|
||||
#. Finally run the conversion process:
|
||||
|
||||
.. code-block:: bat
|
||||
|
||||
|
||||
Import-Module "C:\Program Files\Microsoft Virtual Machine Converter\MvmcCmdlet.psd1"
|
||||
cd D:\osgeo-live-11.0-vm
|
||||
ConvertTo-MvmcVirtualHardDisk -SourceLiteralPath .\osgeo-live-11.0-vm.vmdk -VhdFormat Vhdx
|
||||
ConvertTo-MvmcVirtualHardDisk -SourceLiteralPath .\osgeo-live-11.0-vm.vmdk -VhdFormat Vhdx
|
||||
|
||||
|
||||
How-To
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
This guide assumes Hyper-V is already installed and enabled - if this is not the case the more typical approach using
|
||||
Virtual Box outlined at :doc:`virtualization_quickstart` can be used.
|
||||
This guide assumes Hyper-V is already installed and enabled - if this is not the case the more typical approach using
|
||||
Virtual Box outlined at :doc:`virtualization_quickstart` can be used.
|
||||
|
||||
**Create a Virtual Machine**
|
||||
|
||||
#. Start the Hyper-V Manager application and under Actions select New > Virtual Machine, and then Next. Then enter an appropriate
|
||||
name for the virtual machine.
|
||||
#. Start the Hyper-V Manager application and under Actions select New > Virtual Machine, and then Next. Then enter an appropriate
|
||||
name for the virtual machine.
|
||||
|
||||
.. image:: /images/projects/osgeolive/osgeolive_hyperv_install1_start.png
|
||||
|
||||
#. Select "Generation 1" from the Specify Generation options.
|
||||
#. Select "Generation 1" from the Specify Generation options.
|
||||
|
||||
.. image:: /images/projects/osgeolive/osgeolive_hyperv_install2_generation.png
|
||||
|
||||
#. When assigning memory, you can select "Use Dynamic Memory for this virtual machine".
|
||||
#. If you require the virtual machine to have Internet access you will need to set this up this up on the "Configure Networking" screen.
|
||||
#. On the "Connect Virtual Hard Disk", select "Use an existing virtual hard disk" and select the ``.vhdx`` file you unzipped earlier.
|
||||
#. When assigning memory, you can select "Use Dynamic Memory for this virtual machine".
|
||||
#. If you require the virtual machine to have Internet access you will need to set this up this up on the "Configure Networking" screen.
|
||||
#. On the "Connect Virtual Hard Disk", select "Use an existing virtual hard disk" and select the ``.vhdx`` file you unzipped earlier.
|
||||
|
||||
.. image:: /images/projects/osgeolive/osgeolive_hyperv_install2_harddisk.png
|
||||
|
||||
**Running the Virtual Machine**
|
||||
|
||||
#. Select the virtual machine from the Virtual Machines list
|
||||
#. Right-click and select "Connect". You will be prompted to start the machine, and a new "Virtual Machine Connection" window will open.
|
||||
#. Right-click and select "Connect". You will be prompted to start the machine, and a new "Virtual Machine Connection" window will open.
|
||||
|
||||
See Also:
|
||||
--------------------------------------------------------------------------------
|
||||
* :doc:`virtualization_quickstart`.
|
||||
* :doc:`virtualization_quickstart`.
|
||||
* OSGeo wiki pages:
|
||||
`Other ways to create a Virtual Machine <https://wiki.osgeo.org/wiki/Live_GIS_Virtual_Machine>`_
|
||||
|
||||
|
|
Loading…
Reference in New Issue