Skip to content

Commit b9ea74b

Browse files
authored
Merge pull request #827 from geographika/vm-updates
Update virtualization quick start images
2 parents bb4441a + ca73218 commit b9ea74b

7 files changed

+10
-140
lines changed
Loading
8.66 KB
Loading
-11.8 KB
Loading
14.1 KB
Loading
Loading

doc/quickstart/virtualbox_quickstart.rst

Lines changed: 0 additions & 134 deletions
This file was deleted.

doc/quickstart/virtualization_quickstart.rst

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,7 @@ Overview
1515
This Quick Start describes one way to run OSGeoLive within a VirtualBox virtual machine (VM). For other methods, follow links from the "See Also" section below.
1616

1717
.. note::
18+
1819
To learn more about the benefits of virtualization, see `Virtualization <https://en.wikipedia.org/wiki/Virtualization>`_ in Wiki
1920

2021
Prerequisites
@@ -26,17 +27,16 @@ Prerequisites
2627

2728
``apt-get install virtualbox-ose``
2829

29-
* Download the OSGeo Virtual disk file (vmdk) from :doc:`live.osgeo.org <../download>`.
30-
31-
* Under **osgeolive-vm**, download the 7-zip file. Then unzip the downloaded file (using `7zip <https://www.7-zip.org>`_ ).
30+
* Download the OSGeo Virtual disk file (vmdk) from the links at :doc:`live.osgeo.org <../download>`. Then unzip the downloaded file (using `7-Zip <https://www.7-zip.org>`_ ).
3231

3332
**Hardware**
3433

3534
* **RAM**: Minimum 2 GB. The Lubuntu system runs well with 1 GB of RAM, and you'll need to keep at least the same amount of memory for some of your applications (such as GeoServer). So a total of 2 GB is recommended for a smooth operation.
36-
* **Spare**: Minimum 20 GB Hard Disk Space. The virtual disk file (vmdk) from :doc:`live.osgeo.org <../download>` unzips to almost 10 GB. You'll also want more space to allow some room to work on the virtual machine. So a total of 20 GB is a good recommendation.
35+
* **Spare**: Minimum 30 GB Hard Disk Space. The virtual disk file (vmdk) from :doc:`live.osgeo.org <../download>` unzips to |osgeolive-hdspace|. You'll also want more space to allow some room to work on the virtual machine. So a total of 30 GB is a good recommendation.
3736
* **CPU**: Any CPU will do, but a processor which supports "Virtualization Technology" will be faster. Check if your computer supports `Virtualization Technology <https://www.intel.com/content/www/us/en/support/articles/000005486/processors.html>`_
3837

3938
.. note::
39+
4040
Most machines produced after 2010 will meet these requirements.
4141

4242

@@ -98,26 +98,30 @@ Step 3 : Running the Virtual Machine
9898

9999
Now bootup the VM by clicking the **Start** (green arrow) button.
100100

101-
* The OSGeo-Live virtual display (i.e., the window size) may be very small, and will not be able to increase until you install Guest Additions. You should install the virtualbox guest additions, this will allow you to use full-screen mode.
101+
* The OSGeo-Live virtual display (i.e., the window size) may be very small, and will not be able to increase until you install Guest Additions.
102+
You should install the virtualbox guest additions, this will allow you to use full-screen mode and scaled mode. These can be installed by running the command below in a terminal.
103+
When prompted for a password, you should use the default ``user``.
102104

103105
``sudo apt-get install --yes virtualbox-guest-utils virtualbox-guest-x11``
104106

105107
(Alternative) If the above command does not work, use the following alternative:
106108

107109
1. From the VirtualBox Devices menu, select **Insert Guest Additions CD Image**
108110
2. Click **OK** when prompted to open the removable media in **File Manager**.
109-
3. In **File Manager**, select **Tools** → **Open Current Folder** in terminal.
111+
3. In **File Manager**, select **Tools** → **Open Terminal**.
110112
4. In the terminal type:
111113

112114
``sudo ./VBoxLinuxAdditions.run``
113115

114116
5. Press ENTER.
117+
6. When prompted for a password, you should use the default ``user``.
115118

116119

117120
Step 4 : Set OSGeoLive user
118121
--------------------------------------------------------------------------------
119122

120123
.. note::
124+
121125
Some tools configured on OSGeoLive rely of "user" to be in the "users" group so they can write into the data directory. If not set, these tools will fail when run.
122126

123127
1. Start a terminal.

0 commit comments

Comments
 (0)