Install Grok on MS Windows¶
Author: | Roger Erens |
---|
This HowTo gives instructions for installing Grok on the various flavours of MS Windows.
Please note that this HowTo is a _WORK IN PROGRESS_ during the alpha releases of Grok version 1.0 and grokproject version 1.0.
TBD denotes To Be Discussed/Determined/Developed/Described/Done
Procedure¶
You can install the software in a folder for which you have write access rights. If you want all users on your machine to be able to run Grok, make sure you have administrator rights during the installation.
Install Python. Currently, version 2.6.x and version 2.5.x are supported. Note that these links point to installers for the ordinary x86 processor architecture.
Install version 2.6 or version 2.5 of the win32all package that goes with the python version you chose above.
Install setuptools2.6 or setuptools2.5.
Open up a command window and change to the folder where you want to place the sandbox that will contain your Grok project(s). In this HowTo we will assume this folder is C:\
cd c:\
Install virtualenv by using the command:
NOTE: As of Grok 1.2, you do not need to use virtualenv. Grok is automatically isolated from the system python environment.
easy_install virtualenv
Create an isolated environment (sandbox) using the command:
virtualenv <grok_sandbox>
where you substitute <grok_sandbox> with your name of choice for the sandbox.
Activate the environment:
cd <grok_sandbox> Scripts\activate
Obtain grokproject, the tool that will download and install Grok for you. It will also create a Grok project for you to get you started:
easy_install grokproject
Set up your project.
Use the grokproject tool to set things up for you:
grokproject <project_name>
Where you substitute <project_name> with your name of choice for the project.
Answer the questions.
Starting up Grok
Start the server:
cd <project_name> bin\paster serve parts\etc\deploy.ini
Visit Grok’s applications page to see what you have achieved!