SDK Installation Troubleshooting¶
Python Installation¶
Python 3.0¶
Please make sure that you use a regular Python 2.x release (v2.6 or above). Python 3.0 is currently not supported.
Execute python -V in a console to get the installed Python version.
Windows¶
Making the interpreter available¶
Note
The following is only required when installing the Windows package from Python.org. When installing the preferred ActivePython this installation step is conveniently handled within its graphical installation wizard.
After your successful Python installation, you need to add the installation folder to the so-called PATH environment variable, which contains a list of directories that are searched for executables.
Suppose you installed Python to its default location C:\Python26, open a Windows command shell (choose menu Start -> Run... and type cmd). The following command prepends the installation folder to the value of PATH, separated by a semicolon:
set PATH=C:\Python26;%PATH%
When you now execute python -V, it should print out its version number.
The modification of the PATH variable as described above is only temporary. In order not to repeat the command each time you open a new command shell, modify the PATH variable permanently: in Start -> Preferences -> System choose Environment variables under the Advanced tab. Edit the system variable Path by prepending C:\Python26;.
File association¶
Note
The following is only required when installing the Windows package from Python.org. When installing the preferred ActivePython this installation step is conveniently handled within its graphical installation wizard.
In a standard Python installation on Windows, the .py file extension gets associated with the Python interpreter. This allows you to invoke .py files directly. You can check that in the following way at a command prompt:
C:\>assoc .py
.py=Python.File
If this doesn't work, you can add a file association through Windows Explorer -> Extras -> Folder Options -> File Types.
If for any reason you cannot use a file association for .py files, you can still invoke the Python interpreter directly, passing the original command line as arguments. In this case, make sure to provide a path prefix for the script name, even for scripts in the same directory, like so (this will be fixed later):
python ./generate.py source
Windows Vista¶
To run qooxdoo's Python-based tools without problems, it is important to have Python installed as an administrator "for all" users.
Administrators installing Python "for all" users on Windows Vista either need to be logged in as user Administrator, or use the runas command, as in:
runas /user:Administrator "msiexec /i <path>\<file>.msi"
Windows 7¶
It has been reported that you need to use the PowerShell that comes with Windows 7 for the tools to work properly. The simple command shell doesn't seem to be sufficient. To launch the PowerShell, hit the WIN+R keys and enter powershell.
Mac OS X¶
Older Macs (e.g. 10.4) may need an update of the pre-installed Python. See the following comment from the Python on Mac page : "Python comes pre-installed on Mac OS X, but due to Apple's release cycle, it's often one or even two years old. The overwhelming recommendation of the "MacPython" community is to upgrade your Python by downloading and installing a newer version from the Python standard release page."
If the generator is very slow on your Mac, it may be due to Spotlight or more precisely it's indexing daemon mds. mds can end up in an infinite loop resulting in very high disk load. While this is a general Mac issue, the generator can trigger this behaviour. To end the infinite loop:
# Delete Spotlight cache
sudo rm -r /.Spotlight-V100