Windows@home
From OpenStreetMap
This page describes some tips for getting tiles@home and OSM@home running on Microsoft Windows operating systems.
Contents |
Tiles@Home for Windows Installer
The easiest solution to get tiles@home running on a Windows PC is to download Eddi's Installer which downloads and installs all needed software and offers a GUI (Graphical User Interface) to start and stop processing, entering your username and password, and a proxy, if needed.
The installer's size is only 2 MB, but it will download about 60 MB third party software. All downloaded files are stored in a sub-folder "setuptah-lite-dl" where the installer is saved to, so you can easily burn them to a CD to install it on other machines. A shortcut will be added to your start menu, simply click it to open the GUI, enter your data and click "start tah" to get going. Minimizing the window will put it in your systray (called "Notification Area" since Windows XP, usually to the left of the clock). Clicking on the OpenStreetMap icon will bring the GUI back, allowing you to stop rendering and exiting it.
Download Tiles@Home for Windows Installer here
Please don't run the GUI more than once. Unfortunately, dual core processors aren't yet supported and running the tool twice will corrupt the other one's data, leading to wrong tiles. So please don't do that.
The required username and password are the same as on www.openstreetmap.org. If this doesn't work for you, try logging in using your e-mail address instead. If you don't yet have an account, sign up here. (If you still can't log in, and are absolutely sure you haven't mistyped your e-mail address or password, try using a 'simple' password using only letters and numbers). Please note that your password is stored in clear text when using tiles@home, so please don't use any "valuable" password.
Uninstall
The installer doesn't offer an uninstaller (yet), so if you want to uninstall tiles at home, delete the following folders: C:\Program Files\tilesAtHome\ (Note that "Program Files" may be named different depending on your system language) %APPDATA%\subversion (Note that %APPDATA% is a variable that will be filled out for you when you enter it into Explorer's address bar. Usually the real path looks like C:\Documents and Settings\[YOUR ACCOUNT NAME]\Applicationdata\Subversion)
Editing Config Files
Editing configuration files is not needed when using the GUI. Every setting needed is either already configured or available via the GUI. All tips below refer to installing tiles@home manually. If you have a problem with the GUI please e-mail eddi <addd> dpeddi <dott> com.
Included software
The following software is downloaded by the installer:
Inkscape (inkscape-0.46.win32.7z) Acriveperl (ActivePerl-5.8.8.822-MSWin32-x86-280952) Win32-GUI GD Math-Vec libxml-perl Subversion (svn-win32-1.4.6) xmlstarlet (xmlstarlet-1.0.1-win32) tilesAtHome (Oslo) NSIS Plugins (ZipDLL and FontName-0.7) 7Zip (7za457) pngcrush (pngcrush-1.5.10-win32) optipng pnqnq DejaVU fonts
Manual Installation
General
- Nowadays, there are no need to modify tilesAtHome source code to get it working under windows
- xmlstarlet is usually installed in c:\xml\xml.exe
- there is no need to use double-quotes if a filename has spaces in (I found that you do! --Swampwallaby 12:12, 28 August 2007 (BST))
- leave the Niceness parameter blank
- as far as my experience goes: None of the source code modifications below are necessary anymore (7-zip) !!
Internationalization
Users on systems with "," as decimal separator (e.g. in Germany) should uncomment the following line:
InkscapeLocale=German
Prerequisite programs
- A .zip archiver for tiles@home - 7-zip, PicoZip or Zipgenius from download.com or other sites.
- gzip for OSM@home - from here; this is not required for tiles@home!
- Perl - ActivePerl from activestate.com. There are two versions currently available :- 5.6.1 and 5.8. Either can be used, but the install packages are not compatible. 5.6.1 has more of the packages needed for t@h available in it's standard repository.
Use of version 5.8.8 avoids problems with IS-UTF-8 command ans non-existing module LWP-SIMPLE-POST : RECOMMENDED
- xmlstarlet - from here. XMLStarlet is a set of command line utilities (tools) which can be used to transform, query, validate, and edit XML documents and files using simple set of shell commands.
- Do not forget to install pngcrush.exe in c:\program files\pngcrush\ ( single file, no install)
- Inkscape - from here
- GD.pm - from [1]. If you are using version Activestate Perl, then you will need to install it as follows:
5.6.1: ppm install http://theoryx5.uwinnipeg.ca/ppmpackages/GD.ppd 5.8: ppm install http://theoryx5.uwinnipeg.ca/ppms/GD.ppd 5.10: ppm install http://cpan.uwinnipeg.ca/PPMPackages/10xx/GD.ppd
Perl modules
- Start→Run
- ppm (Programmer's Package Manager)
- install some::module
Alternatively:
- perl -MCPAN -e shell
- install some::module
ActiveState Perl Version 5.6.1
Use perl 5.8.1 or higher to avoid UTF-8 error
Invoke the Perl package manager by typing ppm via Start→Run, or from a DOS command box.
PPM - Programmer's Package Manager version 3.4. Copyright (c) 2001 ActiveState Software Inc. All Rights Reserved. Entering interactive shell. Using Term::ReadLine::Perl as readline library. Type 'help' to get started. ppm> install Math-Trig-Degree ... ppm> install Math-Trig-Units ... ppm> install Math-Complex ... ppm> install Math-Vec ... ppm> install LWP-Simple-Cookies ... ppm> install LWP-Simple-Post ... ppm> install Image-Magick ... ppm> exit
ppm install http://theoryx5.uwinnipeg.ca/ppmpackages/GD.ppd
ActiveState Perl Version 5.8.8
It comes with a new GUI Perl Package Manager, but has only a subset of the full range of Perl Modules available from the ActiveState repository. At the time of writing, GD and Image-Magick were not available from ActiveState, but there are additional repositories as described in the ActiveState Documentation containing these packages. After adding the University of Winnipeg Repository and the Bribes Repository, GD and Image-Magick should be available to install using the GUI.
Invoke the Perl package manager by typing ppm via Start→Run, or from a DOS command box.
Tag and install the following packages:
Math-Trig-Degree Math-Vec
Install GD from the DOS command level:
ppm install http://theoryx5.uwinnipeg.ca/ppms/GD.ppd
If you want to run lowzoom.pl, install Image-Magick from the DOS command level:
ppm install http://www.bribes.org/perl/ppm/Image-Magick.ppd
ActiveState Perl Version 5.10
The latest version of ActiveState Perl is version 5.10.
To install missing modules, from the DOS command level:
ppm install Math-Vec ppm install http://cpan.uwinnipeg.ca/PPMPackages/10xx/GD.ppd
Using the Perl Package Manager, install the following modules:
libxml-perl XML-Xpath Set-Object XML-Writer AppConfig (not App-Config !!)
After clicking install, do not forget to commit the changes (Cntrl-Enter).
The installed modules will be marked under area as "site".
Running Perl programs
To run a Perl program with arguments, or redirect the output somewhere, or to see the output, create a batch file
perl ProgramName.pl @pause
Change your file settings to associate .pl files with perl.exe in the Perl installation directory. Activeperl 5.8.8 does this for you.
