Virtual Tiles@Home - Ubuntu

From OpenStreetMap Wiki
Jump to: navigation, search

Contents

Virtual Tiles@Home - Ubuntu

It would be nice if more people ran Tiles@home on their PCs. But manually installing Tiles@home can be kind of complicated, especially if you are not familiar with Linux. It is possible to install it on Windows, but is said to be even more complicated. Virtual Tiles@Home (vt@h) is a new approach to this problem.

How does Virtual Tiles@home work?

Software like VirtualBox allows you to emulate (simulate) a complete PC inside your real PC. The real PC is also called host PC. You may install any OS on your virtual PC, which may be different from your host OS. Whatever operating system you may be running (Windows, Mac, Linux), you can have a virtual PC running Linux, and you can use the host PC and the virtual PC at the same time.

Virtual tiles@home uses this possibility. You don't have to create a virtual PC and install Linux on it. We are creating a virtual PC that you can download and run without Linux knowledge. You start the virtual PC, and the PC starts rendering and uploading. Inside this virtual PC, there is a completely normal Tiles@home installation.

You only need three things:

keep in mind: one can also convert the image to other formats and so use other virtualization software (e.g. qemu)

This version is based on ubuntu server (Ubuntu 10.04). Anyone interested can download the VDI and give feedback on the Talk page.

What's new

See also Talk page.

Download


Old Versions

Installation

Enable PAE/NX in VirtualBox 3.0.2

Problems with the installation

 Gave up waiting for root device. Common problems:
 - Boot args (cat /proc/cmdline)
 - check rootdelay= (did the system wait long enough?)
 - check root= (did the system wait for the right device?)
 - Missing modules (cat /proc/modules; ls /dev)
 ALERT! /dev/disk/by-uuid/87b55cc9-82be-47cc-a55f-3bccf5ec976b does not exist. Dropping to a shell!


Requirements for the 64bit version

keep in mind: one can also convert the image to other formats and so use other virtualization software (e.g. qemu)


Running two Instances on a Multicore CPU

If you have a Multicore Cpu, you may want to run more Instances simultaneously. The Problem is that the VM Image has a unique Number, so you can not use the same Image as a simple Copy. You must clone it with the vbox Tool "VBoxManage.exe" which is automatically installed together with VBox.


C:\Programme\Oracle\VirtualBox\VBoxManage.exe clonehd F:\VirtualBox VMs\OSM1\openstreetmap.vdi F:\VirtualBox VMs\OSM2\openstreetmap.vdi

Usage

Setting up

You can use the following commands (but you don't need them).

for the non usa ... be carreful. Its qwerty not azerty so for the account and password ...

Before you enter a command, you must stop the output, press CTRL-C, you will see the prompt ($).

If you want to render with your own account (from http://www.openstreetmap.org/user/new) enter 

 $ sudo osm setuser

and give your email (not your username!) and password (yes it's cleartext).

Increase Swap to 1GB with (be careful, this will decrease your HD space and may cause the program not to work properly) 

 $ sudo osm swap 1024

For other commands enter 

 $ sudo osm

See the log again: 

 $ tail -f /tmp/tiles.log

If you have a national keyboard layout you can use 

 $ sudo dpkg-reconfigure console-setup

Hints

Another console session

If you want to leave Tiles@Home running but do some other stuff, press ALT+F2, ALT+F3, ... to get another console session. Use openstreetmap as user and openstreetmap as password. There is no root login available (use sudo su to become root).

Modifying configuration file

All configuration files are stored at /var/tmp/tilesAtHome/. Just edit them if you KNOW what you are doing! You can use sudo joe filename and exit joe with CTRL-K,X.

authentication.conf

Stores your login information used for uploading the finished work units.

general.conf

URLs for contacting various servers to receive and send work.

layers.conf

How the different layers should be rendered.

tilesAtHome.conf

Common configuration file for Tiles@Home.

Modifying /etc/init.d/tiles-gen-client file

When stoping the VM /etc/init.d/tiles-gen-client stop is called to stop calculating. Actually its kind of a stop-later, which is aborted (processes are killed) after some time (default 120s). You can play with the value. 

 # timeout to wait for the client to finish on shutdown
 TIMEOUT=120

Exit virtual machine

To exit the virtual machine and continue working on your host system press the Host key which is displayed in the lower right corner of your VM window. Default values are: 

HOST-KEY and H       (default is the right hand Ctrl)
Ctrl-H               (use right hand Ctrl)


Running Headless

It is possible to run Tiles@Home without having a X-session running. 

VB <3 uses 'vboxheadless', from 3.0 on use 'VBoxHeadless'

To be able to login to the osm when it is headless you have to install SSH: 

sudo apt-get install ssh

And to figure out your current IP of the osm: 

/sbin/ifconfig

You are now ready to run it headless (well, after you have got everything running in Virtualbox first).

In a console session run 

vboxheadless -s name-of-your-vm

In my case that would be 

vboxheadless -s osm

It is also possible to detach it and run it in the background 

vboxheadless -s osm > /dev/null 2>&1 &

On a machine running a X-Session, you can also connect with rdesktop (or from a remote machine, then replace localhost with your hosts IP) 

rdesktop -a 16 -g 640x480 localhost

Source-Code

Retrieved from "http://wiki.openstreetmap.org/wiki/Virtual_Tiles@Home_-_Ubuntu"
Personal tools
Namespaces
Variants
Actions
site
Toolbox