Version 3 (modified by trac, 14 years ago) (diff)


Nagare installation

1. Stackless Python installation

The Nagare framework uses Stackless Python (version 2.5.2 or above).

1.1. Linux installation

First, search into your Linux distribution packages if Stackless Python 2.5.2 is available.

Else, to install Stackless Python from its sources, to the <STACKLESS_HOME> directory, do:

cd /tmp
tar jxvf stackless-252-export.tar.bz2

cd stackless-2.5.2*
./configure --prefix=<STACKLESS_HOME>
make all
make install

Note: if the <STACKLESS_HOME> is a system directory (as /opt or /usr/local), you will have to be logged as root to launch the last make install command.

1.2. Windows installation

To install Stackless Python on Windows, download the dedicated installer and launch it.

2. Nagare installation

The framework can be installed system-wide, where every users can used it or into a dedicated directory called a "virtual environment".

Creating a virtual environment is the standard and recommended way because such installation doesn't modify the configuration of the stackless Python interpreter and doesn't require the root privileges.

2.1. Virtual environment installation

To create a virtual environment into the <NAGARE_HOME> directory, download virtualenv and launch it with Stackless Python.

On Linux:

cd /tmp
tar zxvf virtualenv-1.3.1.tar.gz

<STACKLESS_HOME>/bin/python virtualenv-1.3.1/ <NAGARE_HOME>

On Windows:

Manually download and extract the file (you could need an archiver as 7-zip or winrar).

Then launch:

<STACKLESS_HOME>\Scripts\python.exe <NAGARE_HOME>

The final step is to install the framework into this newly created virtual environment.

On Linux:

<NAGARE_HOME>/bin/easy_install 'nagare[full]'

On Windows:

<NAGARE_HOME>\Scripts\easy_install.exe nagare[full]

2.2. System-wide installation

If Stackless Python is installed on a system directory, you will need to have the root privileges.

First, install easy_install by downloading and launch it with stackless Python.

Second, install the framework on Linux:

<STACKLESS_HOME>/bin/easy_install 'nagare[full]'

or, on Windows:

<STACKLESS_HOME>\Scripts\easy_install.exe nagare[full]

See the following chapter if you don't want to install the framework with all its modules.

3. Installation options

The framework installation is modular. The command easy_install nagare installs only the framework core with the minimum number of features. More features, called "extras", can be installed with the syntax easy_install 'nagare[extra1,extra2...]'.

Currently, the available extras are:

  • debug -- install the debug web page, displayed when an exception is raised
  • database -- install the Python modules needed, for an application, to access relational databases
  • doc -- install the Python modules needed to generate the framework documentation
  • test -- install the unit tests manager
  • full -- install all of the above extras (i.e easy_install 'nagare[full]' is equivalent to easy_install 'nagare[debug,database,doc,test]')

4. Developers framework installation

To work with the latest framework sources directly from its repository, first create a virtual environment into the <NAGARE_HOME> directory: download virtualenv and launch it with Stackless Python.

cd /tmp
tar zxvf virtualenv-1.3.1.tar.gz

<STACKLESS_HOME>/bin/python virtualenv-1.3.1/ <NAGARE_HOME>

Second, grab the framework sources from the repository:

svn co svn://

Third, install the framework from the sources:

cd nagare/core
<NAGARE_HOME>/bin/python develop
<NAGARE_HOME>/bin/easy_install 'nagare[full]'

You can now work with the sources of the framework in <NAGARE_HOME>nagare/core/nagare and, when you want to update the sources from the repository, do:

cd <NAGARE_HOME>/nagare
svn update

5. Testing the installation

To test the installation, launch the adminstrative interface:

<NAGARE_HOME>/bin/nagare-admin serve admin

or, in Windows:

<NAGARE_HOME>\Scripts\nagare-admin.exe serve admin

which must results in the following display:

Application 'app admin' registered as '/admin'
Application 'app admin' registered as '/'
serving on

Then you can browse at to look at the administrative interface.