GAEO Documentation
 
Search this site

Make Donations

Recent site activity
Tutorials‎ > ‎

Getting Started

Contents

  1. 1 Install Python
  2. 2 Download Google App Engine SDK
  3. 3 Install GAEO
    1. 3.1 Install via EasyInstall
    2. 3.2 Install via Unpacking The Package

Install Python

If you are using Windows platform, you might have to install Python first. Download & install Python from its download page.

In Unix-like system or Mac OS X, Python should have already been installed by default system installation. To check if you have Python installed, type python in your console. If you have Python, you will start an interactive Python interpreter like this:


If you don't have this interpreter, install Python from its official site.

Download Google App Engine SDK

Since GAEO is based on Google App Engine (GAE), you should install the GAE SDK first. Visit the GAE's download page and follow the guide to install the SDK for you.

Install GAEO

To install GAEO, you can download the archive or install it through easy_install command.

Install via EasyInstall

Be sure that you've installed easy_install first. If you cannot execute easy_install command, you might do not have it. Visit http://peak.telecommunity.com/DevCenter/EasyInstall to download the pacakge and install it.

While you can execute the easy_install, install GAEO by this command:

# easy_install gaeo

If easy_install complains that you don't have the permission to install, add sudo before the command to install the package as a root (only effective undef Linux or Mac OSX).

If easy_install completes the installation job withou any error message, you might successfully installed the GAEO. Try typing gaeo in the console to see if it has been installed. The normal message would be like this:

# gaeo
Usage: /usr/local/bin/gaeo

Install via Unpacking The Package

Download the package from the project home. The latest release would be a zipped file and listed on the main page. You may download a file named gaeo-version.zip file and unzip it wherever you want.

In order to use the GAEO scripts, don't forget set $GAEO_HOME/bin in your $PATH environment variable. For example, if you put GAEO in /home/foo/gaeo, set your $PATH like this (if you use bash as your shell):

export PATH=$PATH:/home/foo/gaeo/bin

After configuring the $PATH, test if you can execute gaeo.py everywhere.


NOTE that if you install GAEO by using EasyInstall, your script name will be gaeo (and gaeogen). lt is linked to $GAEO_HOME/bin/gaeo.py (and $GAEO_HOME/bin/gaeogen.py). In the following articles, we will use gaeo command in samples (if you install by unpacking the release package, use gaeo.py please).