TurboGears Additional Installation Instructions

# Having Trouble Installing TurboGears?

This page will try to answer questions about things that can go wrong and other possible installation choices.

- EasyInstall can't find one of the packages!
- Error: No local packages or download links found for TurboGears
- Conflict Warning
- Error: Couldn't find a setup script in TurboGears
- error: invalid Python installation: unable to open /usr/lib/python2.4/config/Makefile (No such file or directory)
- I'm running Mandriva and I'm getting an error about memmove missing
- I'm seeing a "File exists" error

## EasyInstall can't find one of the packages

In order to ensure that the components all work together properly, TurboGears is set up to require specific versions of the component projects and will sometimes rely on unreleased versions. Because of this, EasyInstall is not always able to find the right package in PyPI.

Please be sure to follow the download instructions for your platform. The instructions specify to use the "-f" (find-links) option for EasyInstall so that EasyInstall knows where to go to find the packages.

## No local packages or download links found for TurboGears

This error most commonly reflects that a firewall is preventing the download of the package. Here is the suggestion from Phillip Eby:

You'll need to either find a way to bypass the firewall (e.g. using http://ntlmaps.sf.net/ ), or else manually download all the .egg files listed on the download page to a temporary directory, and then run

easy_install -f dldir TurboGears

where 'dldir' is the directory you downloaded the .egg files to.

## Conflict Warning

TurboGears relies on a new Python packaging system called Python Eggs (you may also see references to setuptools, which provides the Eggs functionality). If you have an older, non-egg installation of a package used by TurboGears, easy_install will display a conflict warning.

In order to get TurboGears running, you need to have the eggs properly installed. There are two options for doing this: a non-root installation and deletion of the existing package.

A non-root installation preserves all of your existing Python setup, but is more complex. If you have concerns that your system might not like different versions of the libraries, this is the safe route to take.

To delete the existing package, you can rerun the easy_install command with the -D option. easy_install will replace the old package with the new Egg. For example, if your system came with elementtree installed, adding -D to the easy_install command will delete the old elementtree package and install the new Egg. You'll still be able to type "import elementtree" when you're done.

## Error: Couldn't find a setup script in TurboGears

Phillip Eby's explanation:

When you get "Couldn't find a setup script in TurboGears", it means that you are running in a directory that has a subdirectory called 'TurboGears'. Don't do that, because EasyInstall sees that you asked for TurboGears, and it sees there's a TurboGears directory, so it tries to install that. Unless the directory is a TurboGears *source* checkout, it's not going to work.

Change to a different directory, or get rid of the TurboGears subdirectory!

Note, by the way, that Windows and OS X have case-insensitive filesystems, so the directory could be called 'turbogears' and it would have the same problem.

If you're running in a TurboGears checkout with a setup.py present, do this instead:

sudo easy_install -f http://www.turbogears.org/download/index.html --script-dir /usr/local/bin .

Notice that there's a '.' instead of TurboGears - we're telling it to install this directory, not a subdirectory.

## I'm running Mandriva and I'm getting an error about memmove missing

Mandriva has a non-standard Python setup which causes it to be unable to install cElementTree properly. Bryan Murdock had success "moving aside /usr/include/python2.4/pyconfig.h and linking in /usr/include/multiarch-i386-linux/python2.4/pyconfig.h". This problem has been reported as bug 19376 at http://qa.mandriva.com/.

## I'm seeing a "File Exists" error

On Windows machines, there appears to be a problem when setuptools thinks it needs to overwrite cElementTree. The easiest solution to this is to install with the --always-unzip option to easy_install. You can also fix the immediate error by deleting the Documents and Settings\Your User\Application Settings\Python Eggs directory.

## error: invalid Python installation: unable to open /usr/lib/python2.4/config/Makefile (No such file or directory)

On some Linux systems, notably Debian-based systems, you'll need to have the Python2.4-dev package installed in order to be able to compile C extensions.