(C)2001 High Country Software Ltd.

http://www.mobilemaps.com

Information on using the Mobilemaps Spider can be found in the README file in this directory.

Installation Platforms:

A. Linux/Unix
B. Windows 2000/XP

1. Mysql

The Spatial Spider relies on a local installation of the open-source Mysql database.

Mysql can be downloaded from http://www.mysql.com

After installing the software you need to set a root password:

$ mysqladmin -u root password my_password

where "my_password" should be a password you choose for your database. You should then create a database called spider with the following command-line:

$ mysqladmin -u root -p create spider

2. Perl

Most linux/unix systems will already have the perl language installed. If this is not the case, it can be downloaded from http://www.perl.com.

Install the required Perl modules. The simplest way is to use the following script in the lbs directory, which automatically downloads and installs all the required modules from the CPAN repositories (see http://www.cpan.org for more information.) If you want to make these libraries available system wide, then install them as root.

$ perl install_perl_libs.pl

If this is the first time you have used CPAN, then entering 'No' at the initial CPAN configuration prompt can be a good idea, because the defaults are usually adequate.

If this fails to work for some reason then you must install the individual modules and bundles, (available to download on http://www.cpan.org) MIME::Base64, URI, Digest::MD5, Bundle::libnet, HTML::Parser, Bundle::LWP, Data::ShowTable, DBI, DBD::mysql, Tk Enter each name separately into the search interface on cpan.org, download each file, gzip -d file.tar.gz, tar -xvf file.tar, then follow the INSTALL instructions (typically: perl Makefile.PL; make; make test; make install)

The library DBD::mysql does not always install with the CPAN script install_perl_libs.pl, because its tests fail against a password configured MySQL database, and should be installed manually. If you have exited from the install_perl_libs.pl script, then go into your .cpan/build directory (e.g. /root/.CPAN/build/) and into the Msql-Mysql-modules-[xxxx] directory. Then run "perl Makefile.PL", follow the instructions (install MySQL DBD only, enter your real user/pass for the tests); make; make test; make install.

3. Mobilemaps Spatial Spider

(a) Setup the configuration file

$ cp spider.conf.sample spider.conf

Edit the following two lines of spider.conf to include your database username and password:

<user>root</user>
<password>my_root_database_password</password>

(b) Install the Spatial Spider

$ ./spider_install.pl <return>

(c) Run the Spatial Spider

./MMSpider.pl <return>

B. Windows 2000/XP Installation

1. Mysql

The Spatial Spider relies on a local installation of the open-source Mysql database.

Mysql can be downloaded from http://www.mysql.com

You are recommended to follow the installation instructions in the MySQL documentation on their site.

The installation will include setting mysql to run as a service with the following command line: (assumes the installation was into c:\mysql)

c:\mysql\bin\mysqld-max-nt --install

After installing the software you need to set a root password:

c:\mysql\bin\mysqladmin -u root password my_password

where "my_password" should be a password you choose for your database.

You should then create a database called spider with the following command-line:

c:\mysql\bin\mysqladmin -u root -p create spider

2. Perl

(a) The Perl programming language should be installed from the free download on http://www.activestate.com

(b) Libraries can be installed by logging onto the Internet, opening a command-prompt and entering each of the following lines. Sometimes you may have to wait a period before a response, so please be patient.

ppm install dbi <return>
ppm install dbd-mysql <return>
ppm install tk <return>

3. Mobilemaps Spatial Spider

(a) Create a directory for the Spatial Spider:

mkdir c:\program files\mm_spider <return>

(b) Copy mmspider.zip file into the spider directory. (Requires pkunzip decompression program)

copy mmspider.zip \programs files\mm_spider <return>

pkunzip mmspider.zip <return> [or use winzip to extract mmspider.zip to this directory]

(c) Setup the configuration file

copy spider.conf.sample spider.conf

Edit the following two lines of spider.conf to include your database username and password:

<user>root</user>
<password>my_root_database_password</password>

(d) Install the Spatial Spider

perl spider_install.pl <return>

(e) Run the Spatial Spider

perl mmspider.pl <return>

(e) For convenience a shortcut to this file can be created on the desktop. Start a file manager like Windows Explorer or My Computer, then right-click on the mmspider.pl file and select "Send-to", then select "Desktop as shortcut".

Now double-clicking on the "Shortcut to mmspider.pl" icon will run the spider.