Windows Install

From Geoqo
(Difference between revisions)
Jump to: navigation, search
(Install Needed Perl Modules)
(Install ActivePerl)
 
(15 intermediate revisions by 2 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
== Install NMake ==
+
the '''INSTALL-WINDOWS.pl''' file (you may not see the .pl
 
+
extension). Follow all the directions it provides you.  It'll whip
Next we'll need to download nmake, a windows program for building and installing the geoqo source. Get it from:
+
through a number of other installs required in order to get geoqo up
 
+
and running.
* http://download.microsoft.com/download/vc15/patch/1.52/w95/en-us/nmake15.exe
+
 
+
And save it to:
+
 
+
  C:\Perl\bin\nmake.exe
+
 
+
== Install Needed Perl Modules ==
+
 
+
Next run the prerequisite check program in the geoqo directory:
+
 
+
  perl check-prerequistes.pl
+
 
+
Ignore the note about it has created an installation file for you.  We are going to use '''ppm''' to install as much as possible first.  Note what modules you need to install, load your command prompt again (Start-Run-cmd (if on win98, see [http://rick.guysintheknow.com/wiki/CMD_on_Win98 here])) and type:
+
 
+
  ppm
+
 
+
It'll appear to do nothing for a while, but it will be syncing your 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
+
* Select "All Packages."
+
** Otherwise, you wouldn't see the packages you need to install.
+
  
* To install a package, type the package name in the search box.
+
(the next time you update geoqo run the same script but it won't need to
** Note that the words are seperated by a hyphen, rather than two colons.
+
install all the pre-requisites again).
** If you need to find DBD::SQLite2, type it as DBD-SQLite2.  (You'll be presented with one package).
+
** Right click on it, and click "Install DBD-SQLite2 (version number)".
+
* Do this for all the modules you need to install, then once you've marked them all, hit Ctrl+Enter to download and install them.
+
  
== Compile and Install GeoQO ==
+
== Run GeoQO ==
  
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:
+
GeoQO should be in your Start menu now.
  
perl Makefile.PL
+
== Notes about GeoQO On Windows ==
  
It should say something like "Writing makefile for geoqo", then return you to a prompt. Type:
+
Next, make sure you read [[Extra notes about Windows]] which provides additional "gotchas" about GeoQO on windows.
  
nmake
+
== Troubleshooting ==
  
It will compile the source code, then once that's done type:
+
=== You run geoqo but nothing happens ===
  
nmake install
+
This is actually likley do to the same problem as the next one, so follow the steps there:
  
If all goes well, you shouldn't have any errors.
+
=== no such table: parameters ===
  
Finally, type:
+
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:
  
  geoqo --setup-database
+
# click on the start menu and go to "Run..."
 +
# At the window type: '''geoqo --setup-database'''
  
This creates the a GeoQO database ready to import some caches. At this point, you can follow the online help for importing and 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.

Personal tools