Blog, GNU/Linux, IT Security

Installing TRAC with mod_wsgi using virtualenv

This guide is for installing Trac as a user using virtualenv for a isolated Python environment so that the whole installation runs under a specific user.

First of all we need to install needed packages

apt-get install libapache2-mod-wsgi python-virtualenv python-setuptools

Once we have installed the required packages proceed to create the Python environment

mkdir /usr/local/trac
cd /usr/local/trac
virtualenv python

We now have the isolated Python environment locate under /usr/local/trac/python.

To make possible to use easy_install with repositories we need to upgrade easy_install. I use this to install Trac plugins directly from SVN.

/usr/local/trac/python/bin/easy_install -U trunk

We now can install trac 0.12 using the 0.12b1 SVN Tag (http://svn.edgewall.com/repos/trac/tags/trac-0.12b1 or Trac==0.12b1) or directly from SVN Trunk:

/usr/local/trac/python/bin/easy_install http://svn.edgewall.org/repos/trac/trunk

This will download and install the latest trunk version for Trac.

To have webaccess to the Trac projects, we need a .wsgi script, were we define where our local python environment is located:

# Not needed if mod_wsgi >= 3.0
import sys
sys.stdout = sys.stderr

# Load Trac
import trac.web.main
application = trac.web.main.dispatch_request

And finally we need to configure apache. If you want only one Trac project, you should define trac.env to the location of your trac, but if you want multiproject support, you must use trac.env_parent_dir (this is what I used)


    ServerName trac.dns.com

    DocumentRoot /usr/local/trac/htdocs
    ErrorLog /var/log/apache2/trac-error.log
    CustomLog /var/log/apache2/trac-access.log combined

    # Trac Auth
    
        AuthType Basic
        AuthName "Trac"
        AuthUserFile /usr/local/trac/.htpasswd
        Require valid-user
    < /location>

    #Trac
    #Define ProcessGroup with user and group under which it should run
    WSGIDaemonProcess trac user=trac group=trac python-path=/usr/local/trac/python/lib/python2.5/site-packages python-eggs=/usr/local/trac/python/cache
    WSGIScriptAlias / /usr/local/trac/htdocs/trac.wsgi

    
        WSGIProcessGroup trac
        WSGIApplicationGroup %{GLOBAL}
        SetEnv trac.env_parent_dir /usr/local/trac/projects
    

We need to create the user and change the permissions for /usr/local/trac for that user trac

adduser --home /usr/local/trac --shell /bin/false --no-create-home trac
chown -R trac:trac /usr/local/trac

If you get an error “ImportError: No module named simplejson” just install it using easy_install

/usr/local/trac/python/bin/easy_install simplejson
Blog, Development

Eclipse Configuration for Web Development

After trying very different IDE and many Eclipse IDE flawors, this is the best configuration I have found, and all the components are free.

First of all we need to download Eclipse Classic from the Eclipse website.

One of the first things we need to do is to change eclipse.ini, we will make it start faster and increase the memory limit

--launcher.XXMaxPermSize
256m
-vm
/usr/bin/java
-vmargs
-Xms40m
-Xmx1024m

The path to Java VM depends on your installation and system, in windows you must search for “javaw.exe”. Setting the path to Java VM makes that Eclipse stops searching for the Java VM every start, which makes the start faster.

Now we can start installing the required Plugins. In “Help->Install New Software…” we will add the following Update Sites.

  • Aptana – http://update15.aptana.org/studio/25914/

    Aptana Install

  • Mylyn – http://download.eclipse.org/tools/mylyn/update/e3.4

    Mylyn Install

  • Mylyn Extras – http://download.eclipse.org/tools/mylyn/update/extras

    Mylyn Extra Install

  • SVNKit – http://community.polarion.com/projects/subversive/download/eclipse/2.0/galileo-site/

    SVNKit Install

  • EPIC (Perl) – http://e-p-i-c.sourceforge.net/updates/testing optional, only if you need Perl

    EPIC Install

You have noticed that at each start a Window Asking for Installing Addiontal Features. Now that we can start installing this features. For me the most important are:

  • Aptana PHP

    Aptana PHP Install

  • Aptana PyDev optional, only if you need Python

    Aptana PyDev Install

  • Ajax Libraries You can select all or just the one you need

    Aptana Ajax Libraries Install

After installing all needed plugins we can start with the configuration.

  1. General\Workspace
    • Text file encoding -> UTF-8
    • New text file line delimiter -> Unix
  2. General\Editors\Text Editors
    • Displayed tab width -> 4
    • Insert spaces for tabs -> True
    • Show line number -> True
    • Show print margin -> True
    • Print margin column -> 80
  3. General\Keys
    • Show Whitespace Characters (Text Editing) -> Binding: Ctrl+Alt+Space -> When: Editing Text
  4. Aptana\Editors

    • Formattings -> Insert selected proposal with ‘Tab’ key as well as ‘Enter’ key -> True
    • Tab Insertion -> Use spaces (current width is 4)
  5. Aptana\Editors\PHP
    • Create project file in new PHP project -> False
  6. Aptana\Editors\PHP\Formatting
    • Edit… ->
      • Profile Name -> ZendStandards
      • Control Statemets ->
        • Insert new line before ‘else’ in an ‘if’ statement -> False
        • Insert new line before ‘catch’ in an ‘try’ statement -> False
        • Insert new line before ‘while’ in an ‘do’ statement -> False
        • ‘if else’ – Keep ‘then’ statement on same line -> False
      • Braces ->
        • Method declaration -> Next line
        • Blocks -> Same line
        • Blocks in case statement -> Same line
        • ‘switch’ statement -> Same line
  7. Install/Update\Automatic Updates
    • Automatically find new updates and notify me -> True
  8. Team\SVN – SVN Client
    • SVN Client -> SVN Kit
    • SVN Client -> Use SVN Merge View -> True
  9. Team\SVN\Automatic Properties
    • Add: * -> svn:keywords=Id

I use the Aptana Perspective with this views:

  • Right Top
    • Aptana Standard Views\Project
  • Right Bottom
    • General\Outline
    • Aptana Standard Views\PHP Elements Views
    • Aptana Standard Views\References
  • Bottom
    • General\Tasks
    • Aptana Standard Views\Validation
    • General\Console
    • Team\History
    • Team\SVN Properties
    • EPIC\RegExp only if you installed EPIC
  • Left
    • Tasks\Task List

I like that the Oultine is automatically expanded, so that I have an overview of the file at every moment, but Aptana does not autoexpand the Outline. I use the following workaround:

  • Create a new General Project called “_Monkey”
  • Create a folder called scripts
  • Create a javascript file called autoExpandOutline.js with the following content
    /* 
     * 
     * Menu: EHU > HandlerService (Auto expand outline)
     * Kudos: Ingo Muschenetz & Kevin Lindsey & Steve Daniels
     * License: EPL 1.0
     * Listener: getPartService().addPartListener(this);
     * DOM: http://localhost/com.aptana.ide.scripting
     * DOM: http://download.eclipse.org/technology/dash/update/org.eclipse.eclipsemonkey.lang.javascript
     * 
     * 
    */
     
    function getPartService()
    {
        var workbench = Packages.org.eclipse.ui.PlatformUI.getWorkbench();
        var result = null;
     
        if (workbench)
        {
            var window = null;
     
            runOnUIThread(function() {
                window = workbench.getActiveWorkbenchWindow();
     
                if (window != null)
                {
                    result = window.getPartService();
                    //out.println("result set to " + result);
                }
                else
                {
                    //out.println("window is not defined");
                }
            });
        }
        else
        {
            //out.println("workbench is not defined");
        }
     
        //out.println("getPartService() is returning " + result);
     
        return result;
    }
     
    function partBroughtToTop(part)
    {
      //out.println("part*()\n");
    }  
     
    function partClosed(part)
    {
      //out.println("part*()\n");
    }
     
    function partDeactivated(part)
    {
      //out.println("part*()\n");
    }  
     
    function partOpened(part)
    {
      //out.println("part*()\n");
    }
     
    function partActivated(part)
    {
      if (part.getEditorInput)
      {
        expandOutline();
      }
    }
     
    function partVisible(part)
    {
      //out.println("part*()\n");
    }
     
    function partHidden(part)
    {
      //out.println("part*()\n");
    }
     
    function expandOutline()
    {
      //out.println("expandOutline()\n");
      try
      {
        //out.println("try\n");
        var editor = editors.activeEditor.textEditor;
     
        editor.getOutlinePage().getTreeViewer().expandAll();
      }
      catch (e)
      {
        //out.println("catch\n");
      }
    }
    

Each new project that you create must use this project as reference, and now every time you open a file the Outline will be expanded automatically when you enter into the Editor

Eclipse Layout