Windows Install

From Geoqo
(Difference between revisions)
Jump to: navigation, search
(→Install ActivePerl)
 
(21 intermediate revisions by 3 users not shown)
Line 1: Line 1:
−
To install on windows, you'll need to grab a few programs and perl modules.
+
To install on windows, you'll need to perform 2 major steps:
 +
 
 +
# install ActivePerl
 +
# run the geoqo installer script.
  
 
== Install ActivePerl ==
 
== Install ActivePerl ==
  
 
ActivePerl is the perl implementation for Windows. In order to run geoqo, you'll need an interpreter, and this is the easiest to install. Grab the latest windows version from:
 
ActivePerl is the perl implementation for Windows. In order to run geoqo, you'll need an interpreter, and this is the easiest to install. Grab the latest windows version from:
 +
 +
'''DO NOT GET THE 5.10.* RELEASE YET; please use the 5.8.8 release instead'''
  
 
* [http://www.activestate.com/store/activeperl/download/ ActiveState Perl]
 
* [http://www.activestate.com/store/activeperl/download/ ActiveState Perl]
  
−
The fields aren't required, so if you don't want to put in your information just skip them. You'll probably want the windows x86 MSI file.
+
The form to fill out on that page is '''optional''' , so can just hit "continue" if you want to skip it. Assuming you're running windows, you'll want to download the windows x86 MSI file on the next page.  Save it and run the downloaded file to install Perl.
  
−
The installation should go smoothly, the only really important thing to make sure is the box that says something like "Add to path" is CHECKED.
+
The installation should go smoothly, the only really '''important''' thing to make sure is the box that says something like "Add to path" is CHECKED.
  
−
== Get GeoQo ==
+
Being windows, you may need to reboot or log off at least before continuing.  Someone should verify this?
  
−
Once the installer finishes, download the latest version of geoqo:
+
== Get and Install GeoQO ==
 +
 
 +
Once the perl installer finishes, download the latest version of geoqo:
  
 
* [http://sourceforge.net/project/showfiles.php?group_id=177773 GeoQO Downloadable Files]
 
* [http://sourceforge.net/project/showfiles.php?group_id=177773 GeoQO Downloadable Files]
  
−
Unzip it to whatever directory you'd like (I use Desktop\geoqo). Go to Start->Run, and in the text box type 'cmd' (without quotes) and hit enter. In the prompt, the command to switch directories is 'cd', so if you saved it to the folder 'geoqo' on your desktop type 'cd Desktop\geoqo'. Once you're there, type 'perl check-prerequisites.pl'. This will tell you what modules you need to install. If you don't have any of the required modules, write them down.
+
Unzip it to whatever directory you'd like (I use
 +
Desktop\geoqo-{{VER}}). Open the resulting folder and double click on
 +
the '''INSTALL-WINDOWS.pl''' file (you may not see the .pl
 +
extension). Follow all the directions it provides you.  It'll whip
 +
through a number of other installs required in order to get geoqo up
 +
and running.
 +
 
 +
(the next time you update geoqo run the same script but it won't need to
 +
install all the pre-requisites again).
 +
 
 +
== Run GeoQO ==
 +
 
 +
GeoQO should be in your Start menu now.
 +
 
 +
== Notes about GeoQO On Windows ==
 +
 
 +
Next, make sure you read [[Extra notes about Windows]] which provides additional "gotchas" about GeoQO on windows.
 +
 
 +
== Troubleshooting ==
  
−
== Install Modules ==
+
=== You run geoqo but nothing happens ===
  
−
Next we'll need to download nmake, a windows program for building and installing the geoqo source. Get it from http://download.microsoft.com/download/vc15/patch/1.52/w95/en-us/nmake15.exe and save it t C:\Perl\bin\nmake.exe. Once you've got that, load your command prompt again (Start-Run-cmd) and type 'ppm'. It'll appear to do nothing for a while, but it will be local module database with the server. Eventually it'll show a message saying "DONE" and you can start installing the modules you need. Click View at the top, and select "All Packages." Otherwise, you wouldn't see the packages you need to install.
+
This is actually likley do to the same problem as the next one, so follow the steps there:
  
−
To install, type the package name in the search box. Note that the words are seperated by a hyphen, rather than two colons. If you need to find DBD::SQLite2, type it as DBD-SQLite2. Type that, and you'll be presented with one package. Right click on it, and click "Install DBD-SQLite2" followed by a version number. Do this for all the modules you need to install, then hit Ctrl+Enter to download and install them.
+
=== no such table: parameters ===
  
−
== Compile and Install ==
+
The INSTALL script '''should''' have set up a default geoqo database for you, but at least in 0.8 it may not be doing that properly.  The fix is easy and only needs to be done once:
  
−
Once that's all done, exit ppm and go back to your geoqo directory. Check your prerequisites again, and make sure you've got all the required ones. If you do, go ahead and type 'perl Makefile.PL'. It should say something like "Writing makefile for geoqo", then return you to a prompt. Type 'nmake' to compile the source code, then once that's done type 'nmake install'. If all goes well, you shouldn't have any errors.
+
# click on the start menu and go to "Run..."
 +
# At the window type: '''geoqo --setup-database'''
  
−
Finally, type 'geoqo --setup-database' to create a database ready to import some caches. At this point, you can follow the online help for manipulating waypoints.
+
That should be it!  If it's still not working, let me (Yamar) know.

Latest revision as of 03:59, 1 January 2008

To install on windows, you'll need to perform 2 major steps:

  1. install ActivePerl
  2. run the geoqo installer script.

Contents

Install ActivePerl

ActivePerl is the perl implementation for Windows. In order to run geoqo, you'll need an interpreter, and this is the easiest to install. Grab the latest windows version from:

DO NOT GET THE 5.10.* RELEASE YET; please use the 5.8.8 release instead

The form to fill out on that page is optional , so can just hit "continue" if you want to skip it. Assuming you're running windows, you'll want to download the windows x86 MSI file on the next page. Save it and run the downloaded file to install Perl.

The installation should go smoothly, the only really important thing to make sure is the box that says something like "Add to path" is CHECKED.

Being windows, you may need to reboot or log off at least before continuing. Someone should verify this?

Get and Install GeoQO

Once the perl installer finishes, download the latest version of geoqo:

Unzip it to whatever directory you'd like (I use Desktop\geoqo-1.11). Open the resulting folder and double click on the INSTALL-WINDOWS.pl file (you may not see the .pl extension). Follow all the directions it provides you. It'll whip through a number of other installs required in order to get geoqo up and running.

(the next time you update geoqo run the same script but it won't need to install all the pre-requisites again).

Run GeoQO

GeoQO should be in your Start menu now.

Notes about GeoQO On Windows

Next, make sure you read Extra notes about Windows which provides additional "gotchas" about GeoQO on windows.

Troubleshooting

You run geoqo but nothing happens

This is actually likley do to the same problem as the next one, so follow the steps there:

no such table: parameters

The INSTALL script should have set up a default geoqo database for you, but at least in 0.8 it may not be doing that properly. The fix is easy and only needs to be done once:

  1. click on the start menu and go to "Run..."
  2. At the window type: geoqo --setup-database

That should be it! If it's still not working, let me (Yamar) know.

Retrieved from "http://geoqo.org/wiki/index.php/Windows_Install"
Personal tools