GeoConnect works as a middle layer, allowing Dataverse files to be visualized on the Harvard WorldMap.

Boston Area Research Initiative project to connect the Dataverse to the Worldmap.

• Add a GIS dataset to the Dataverse and visualize it on the WorldMap
• From the WorldMap, search for Dataverse datasets in a given geographic area for a specific time period

• use sudo if needed
• if on Windows, make sure python is installed.

• depends on pip
• if on windows, either install virtualenvwrapper-win-1.1.5 or cygwin.
• remember to set the (shell startup file)[http://virtualenvwrapper.readthedocs.org/en/latest/install.html#shell-startup-file]

export WORKON_HOME=$HOME/.virtualenvs
export PROJECT_HOME=$HOME/Devel
source /usr/local/bin/virtualenvwrapper.sh

or, on windows, this might be helpful.

• Use the mac client if desired or windows client

cd ~\geoconnect

This may take a minute or two. Xcode needs to be installed.

mkvirtualenv geoconnect
pip install -r requirements/local.txt

If you run into Xcode (or other errors) when running the install, google it. Sometimes the Xcode license agreement hasn't been accepted

• Edit the postactivate script for the virtualenvwrapper.

vim $VIRTUAL_ENV/bin/postactivate

On windows:

vim %VIRTUAL_ENV%\Scripts\activate.bat

'vim' may be any text editor

• add these lines to the postactivate file and save the file

export DJANGO_DEBUG=True
export DJANGO_SETTINGS_MODULE=geoconnect.settings.local

On windows:

set "DJANGO_DEBUG=True"
set "DJANGO_SETTINGS_MODULE=geoconnect.settings.local"

• Test the 'postactivate' script from the command line

deactivate
workon geoconnect
echo $DJANGO_SETTINGS_MODULE

On Windows, use:

echo %DJANGO_SETTINGS_MODULE%

You should see geoconnect.settings.local

#Create/sync the database (still in ~\geoconnect)
python manage.py migrate    # step 1 for a new database
python manage.py migrate --run-syncdb  # step 2 for a new database

#python manage.py  migrate --fake-initial # if the tables already exist

• Add initial database

python manage.py loaddata --app registered_dataverse incoming_filetypes_initial_data.json
python manage.py loaddata --app layer_classification initial_data.json

• To run on a localhost, add this data: python manage.py loaddata --app registered_dataverse registered_dv_localhost.json

• Create a superuser

python manage.py createsuperuser

python manage.py runserver 8070

1. Check if the server is up: http://127.0.0.1:8070
2. Check if the admin page is available: http://127.0.0.1:8070/geo-connect-admin/

• if (1) and (2), feel grateful to be alive

cd ~/geoconnect/ # example: cd /Users/mheppler/iqss-github/geoconnect
workon geoconnect
atom .  # to open in ATOM
python manage.py runserver 8070

Dataverse needs these settings to work on mapping.

INSERT into setting VALUES (':GeoconnectCreateEditMaps', 'true');
INSERT into setting VALUES (':GeoconnectViewMaps', 'true');

• If GEOCONNECT entry doesn't exist, use:

INSERT INTO worldmapauth_tokentype (contactemail, hostname, ipaddress, mapitlink, name, timelimitminutes, timelimitseconds, md5, created, modified)
VALUES ('support@dataverse.org', '127.0.0.1:8070', '127.0.0.1:8070', 'http://127.0.0.1:8070/shapefile/map-it', 'GEOCONNECT', 30, 1800, '38c0a931b2d582a5c43fc79405b30c22', NOW(), NOW())

• If GEOCONNECT entry already exists, use:

UPDATE worldmapauth_tokentype SET mapitlink = 'http://127.0.0.1:8070/shapefile/map-it' WHERE name = 'GEOCONNECT';