Installation Guide for PyRe By: Teng Aladdin Young This installation guide is prepared for SMU-TCS iCity Lab using Amazon Web Services EC2 with Windows Server 2012 image. It shows a step-by-step guide for installing necessary software and packages for running PyRe from a newly launched server image.

2014

Aladdin Teng SMU-TCS iCity Lab

3/14/2014

Table of Contents Prerequisites ........................................................................................................................................... 2

Notes before proceeding ........................................................................................................................ 2

Preparing Python .................................................................................................................................... 3

Python Installation .............................................................................................................................. 3

Setting the Python Environment Variables ......................................................................................... 4

Installing the Python Libraries ................................................................................................................ 5

NumPy ................................................................................................................................................. 5

ClusterPy ............................................................................................................................................. 6

GDAL ....................................................................................................................................................... 7

Installation .......................................................................................................................................... 7

Set Environment Variables .................................................................................................................. 8

Testing the Installation ....................................................................................................................... 8

Java and Tomcat ..................................................................................................................................... 9

Java Software Development Kit (JDK)/Java Runtime Environment (JRE) ........................................... 9

Set the Environment Variable ........................................................................................................... 10

Tomcat 7 ........................................................................................................................................... 11

Prerequisites 1. Acquire a Windows machine, preferably with a server edition OS. This guide was prepared

with Amazon Web Services EC2 with Windows Server 2012.

2. Obtain the Installers folder with the following contents:

(https://www.dropbox.com/sh/gkhr9nhft7wbsch/TF452D9iP5)

Notes before proceeding The application was tested using the versions of the respective programs and libraries

included in the Installers folder. There is no guarantee they will be forward/backward

compatible with different versions of the same.

It is absolutely necessary to have 32-bit Python 2.7 and its corresponding libraries as

ClusterPy, the main clustering library is only guaranteed to run on 32-bit Python 2.7.

Tomcat 7 requires Java 7; conversely, Tomcat 6 requires Java 6. If you already have java

installed, just obtain the corresponding Tomcat zip file, and do not forget to set your

JAVA_HOME system environment variable.

Postgresql and Postgis are included in the Installers, but not necessary to run the application,

hence installation instructions for these will not be included in this manual.

Preparing Python

Python Installation 1. Run “python-2.7.6.msi” from the Installers folder. In the event of missing Installers folder,

please download from: http://www.python.org/ftp/python/2.7.6/python-2.7.6.msi

2. Proceed with the default location and settings.

Setting the Python Environment Variables 1. Press the Windows key and search for System Environment Variables, and select Edit the

system environment variables. For previous versions of Windows OS, go to Control Panel,

select System, and go to Advanced System Settings on the left pane.

2. Edit the Path System Environment Variable to include the following:

C:\Python27;C:\Python27\Lib\site-packages;C:\Python27\Scripts;

3. Open Command Prompt, either by pressing Windows+R and typing cmd or using Shift+Right

Click and selecting Open Command Window here from any directory. Enter python, and you

should see the python live interpreter. Make sure that you have the 32-bit version, which

can be seen in the prompt. Keep the prompt open.

Installing the Python Libraries

NumPy 1. Run “numpy-1.7.2-win32-superpack-python2.7” to install NumPy.

(http://sourceforge.net/projects/numpy/files/NumPy/1.7.2/numpy-1.7.2-win32-superpack-python2.7.exe/download)

2. Press Next. If you have multiple versions of Python, please select Python Version 2.7 [found

in registry].

3. Press Next, and proceed with the Installation until it finishes.

ClusterPy

The main library that contains the clustering algorithms

1. Using the command prompt, exit python with Ctrl+C and change directory (cd) into the

clusterpy-0.9.9 folder inside Installers.

2. Enter python setup.py install.

3. To test the installation, you can run python, import the libraries and call __version__ on

them. Alternatively, obtain the Test folder and run python performance_script.py.

You should obtain similar results in testOutputs folder. (http://clusterpy.googlecode.com/files/performance_script.py + http://clusterpy.googlecode.com/files/performance_shapefiles.zip )

GDAL

Installation Run the “gdal-110-1600-core.msi” installer. Follow the wizard and select Typical. (http://www.gisinternals.com/sdk/PackageList.aspx?file=release-1600-gdal-1-10-0-mapserver-6-2-1.zip)

Set Environment Variables 1. Go to System Environment Variables and add C:\Program Files (x86)\GDAL; to the Path.

2. Next, Press New... and create the GDAL_DATA variable pointing to

C:\Program Files (x86)\GDAL\gdal-data

Testing the Installation Open Command Prompt and type ogr2ogr. You should see the usage guide as shown below.

Java and Tomcat

Java Software Development Kit (JDK)/Java Runtime Environment (JRE) 1. Inside the java folder, run the JDK installer appropriate for your machine’s architecture.

* JDK is preferred over JRE if you wish to make any future changes to the application

** JRE is packaged inside JDK JRE (32-bit): http://javadl.sun.com/webapps/download/AutoDL?BundleId=83383

JRE (64-bit): http://javadl.sun.com/webapps/download/AutoDL?BundleId=83385

JDK (32-bit): http://download.oracle.com/otn-pub/java/jdk/7u51-b13/jdk-7u51-windows-i586.exe

JDK (64-bit): http://download.oracle.com/otn-pub/java/jdk/7u51-b13/jdk-7u51-windows-i586.exe

2. If you chose to install JDK, it will install JRE for you as well.

Set the Environment Variable 1. Add C:\Program Files\Java\jdk1.7.0_51\bin; to your Path System Environment Variable.

2. Create a new variable called JAVA_HOME with value: C:\Program Files\Java\jre7

Tomcat 7 1. Unzip apache-tomcat-7.0.47.zip into C:\apache-tomcat\

2. Go to the unzipped directory and into the conf folder.

Edit tomcat-users.xml, and add a user with the roles “manager-script, admin, manager-gui”.

Username and password can be any arbitrary string value.

3. Go up to the tomcat folder and into the bin folder.

Open a Command Prompt by Shift + Right Clicking any open space in the folder and select

“Open a command window here”. Run startup.bat.

4. Open a browser and go to http://localhost:8080. Click on Manager App on the right.

A prompt for username and password will appear. Enter the credentials created in Step 2.

5. Scroll down to “WAR file to deploy” and click Browse…. Find pyre.war in your directory and

click Open. Afterwards, click on Deploy.

6. Once successful, the Applications list should contain a link to the application. Click on it.

7. Congratulations! You have successfully deployed PyRe on your machine.

Please refer to the User Manual for more details on how to use the application.