Skip to content
This repository

Windows Installation Guide 

ljwolford edited this page · 26 revisions

Copyright 2011 SRI International

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Introduction

There are two recommended approaches to get a new Learning Registry node running using the latest stable code: 1) via an Amazon Machine Instance (AMI) or 2) via installing the code.

Instructions for using an existing AMI are available from http://goo.gl/fhdg3.

The installation instructions below the steps to get a new Learning Registry node running using the latest stable code. These instructions are provided for Windows and have been tested with the Windows 7 64-bit environment.

NOTE: Some code changes had to be made for Windows' machines. Once these have been fully tested and published the doc will be updated to grab the changes to ensure a successful installation.

1. Install Git

  • Install Git here
  • Click Run and follow setup instructions
    • Click Next
    • Click Next
    • If you would like to select a different folder for installation click Browse... else just click Next
    • Keep the default selected components and click Next
    • If you would like to select a different folder for the shortcuts click Browse.. else click Next
    • Select Use Git Bash Only and click Next
    • Select Checkout Windows-style, commit Unix-style line endings and click Next
    • Click Finish

Python

Python 2.7.3 32-bit

  1. Download the Windows x86 MSI Installer(2.7.3)(sig) here
  2. Click Run and follow setup instructions
    • Choose Install for all users and click Next
    • Choose your Destination Directory (default is C:\Python27) then click Next
    • Click Next when asked to Customize Python 2.7.3
    • Click Finish
  3. Once installation is complete, add Python to your system path
    • Click Start -> Right click Computer -> click Properties -> click Advanced system settings -> click Environment Variables...
    • Highlight the Path variable under System variables and click Edit...
    • Add [Directory]\Python27;[Directory]\Python27\Scripts; to the end of Variable value (ex: if Python was downloaded in your C:\ root, you would add C:\Python27;C:\Python27\Scripts;)

Python Setuptools

  1. Download the Windows executable, setuptools-0.6c11.win32-py2.7.exe, here
  2. Click Run and follow setup instructions
    • Click Next when prompted
    • Make sure Python Version 2.7 is highlighted and click Next
    • Click Next again to being the install
    • Click Finish when done

Pip

  1. Open the Windows command prompt (Start -> search for cmd)
  2. In the command prompt, enter the command easy_install pip and it will load pip on your machine, then you can proceed to install the other necessary modules:
  3. virtualenv pip install virtualenv
    • Create a virtual environment to sandbox your development environment
    • Run the command mkdir virtualenv and move into that directory cd virtualenv
    • Run the command virtualenv lr (lr will be the name of your virtual environment)
    • Navigate to the Scripts directory of lr cd lr/scripts
    • Run the command activate
    • (lr) should now appear at the beginning of your command line if successful
  4. pylons pip install pylons
  5. ijson pip install ijson
  6. flup pip install flup
  7. pyparsing pip install pyparsing
  8. iso8604plus pip install iso8601plus
  9. Go here and download, lxml-2.3.win32-py2.7.exe
  10. Click Run and follow setup instructions
    • Click Next when prompted
    • Make sure Python Version 2.7 is highlighted and click Next
    • Click Next again to begin the install
    • Click Finish

YAJL

  1. Visit our download page and download YAJL_Win7_x64_Intel.zip
  2. After you extract the files, you should see the yajl.dll and yajl_license.txt. The DLL has been tested in:

    • Windows 7 (32 and 64)
    • Windows Vista (32 and 64)
    • Windows XP (32 and 64)
    • Windows Server 2008 (32 and 64)
  3. Copy the yajl.dll file and paste it into C:\Windows\SysWOW64 (in a 64 bit system). For 32 bit systems paste it into C:\Windows\system32

    • To check if successful, open the Windows Command Prompt
    • Run the command python, then import ijson
    • If there are no errors YAJL has been successfully installed

Py2exe

  1. Go here and download the py2exe-0.6.9.win32-py2.7.exe Windows installer
  2. Click Run and follow setup instructions
    • Click Next when prompted
    • Make sure Python Version 2.7 is highlighted and click Next
    • Click Next again to begin the install
    • Click Finish when done

Pywin32

  1. Go here and download the pywin32-216.win32-py2.7.exe Windows installer
  2. Click Run and follow setup instructions
    • Click Next when prompted
    • Make sure Python Version 2.7 is highlighted and click Next
    • Click Next again to begin the install
    • Click Finish when done
  3. Now that Py2exe and Pywin32 are both installed on your machine, you need to copy their files inside of your virtualenv
    • Open your Python site-packages folder in Windows Explorer and copy all of the files and folders [Directory]\Python27\Lib\site-packages
    • Paste everything into your virtualenv site-packages folder [Directory]\virtualenv\lr\Lib\site-packages

CouchDB

CouchDB 1.1.1

  1. Go here and download the setup-couchdb-1.2.0_otp_R15B.exe file
    • Click Run and follow setup instructions
    • Click Next
    • Accept the agreement and click Next
    • If you would like to select a different folder for installation click Browse... else just click Next
    • If you would like to create the program's shortcuts click Browse.. else just click Next
    • Make sure Install couchdb as a Windows service and Start the service after installation boxes are checked and click Next
    • Click Install
  2. Make sure CouchDB is running correctly by going here, you should see {"couchdb":"Welcome","version":"1.2.0"}

CouchApp

  1. Enter the command pip install couchdb (Be sure you are inside your virtualenv)
  2. Enter the command pip install couchapp (Be sure you are inside your virtualenv)

Checkout Learning Registry Source Code

  1. Open the Git Bash (Start -> search for Git Bash)
  2. Navigate to where you want your repository by using the cd [directory_name] command
  3. To gather the LR code from github, run the command git clone https://github.com/LearningRegistry/LearningRegistry
  4. Once it is done cloning, run the command, cd LearningRegistry to move into the LearningRegistry directory
  5. Run the command git tag –l to find the latest tag
  6. Checkout the latest tag by running the command, git checkout [latest tag version] (0.23.7 as of May 22nd, 2012)

Nginx

  1. Go here and download the nginx/Windows-1.2.0 zip file
    • Go into your Downloads folder and find the nginx-1.2.0.zip file
    • Right click on the nginx-1.2.0.zip file, and click Extract All...
    • Click Browse... and navigate to C:/ then click OK
    • Click Extract
  2. Stop Internet Information Services (IIS) - if you have it installed
    • Click Start then search for IIS
    • Open the IIS Manager and click Stop on the right hand side under Manage Server
  3. Copy Source Files into Nginx Configuration Directory
    • Browse to [Directory]\LearningRegistry\etc\nginx
    • Copy the folders conf.d, learningregistry_cgi, and sites-available
    • Paste them into C:\nginx-1.2.0\conf
  4. Include FastCGI_Params in Nginx Configuration File
    • Browse to C:\nginx-1.2.0\conf and open nginx.conf
    • Inside the server braces there is another set of braces for location, remove the lines root html; and index index.html index.htm;
    • Add the line include learningregistry_cgi/fastcgi_params; and save the file
  5. You may have to change the IP address Nginx is looking at for couch
    • Get your IP Address by running the ipconfig command
    • Open the learningregistry config file [Directory]\nginx-1.2.0\conf\sites-available\learningregistry
    • Change the IP address under the server directive to your IP. The line to change will be listen xxx.xxx.xx.xxx:5984;
  6. Start Nginx
    • Open the Windows command prompt and navigate to C:\nginx-1.2.0
    • Run the command start nginx

Running the LR Node

Push the CouchApps

  1. Navigate to the config folder of your LR repository cd [directory]/[LR Repository]/config
  2. Run the command python setup_node.py
  3. When prompted, enter http://localhost as your endpoint URL
  4. For the rest of the setup, just hit enter whenever prompted to input the default parameters
  5. When finished you should receive a message displaying, All CouchApps Pushed

Install the LR Node

  1. Navigate back to the main LR directory
  2. Run the command python setup.py install
  3. When finished you should receive a message displaying, Finished processing dependencies for LR==0.1dev

Start Application Server

  1. While still in the LR directory, run the command paster serve development.ini
  2. Visit here and make sure you can see the LR splash page
Something went wrong with that request. Please try again.