removing/changing broken links

master
cvvergara 2023-01-20 15:41:52 -06:00
parent 541edc9265
commit 90f1ec75f6
2 changed files with 37 additions and 37 deletions

View File

@ -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.

View File

@ -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>`_