|
ActivePython User Guide |
|
ActivePython 2.3 Installation Guide
Table of Contents
- Windows Installer Engine (MSI) Windows 9x and NT users
must have the Microsoft Windows Installer engine installed on their system.
(Note: Windows NT users must be logged in as an administrator
in order to install the MSI engine.) The MSI engine package can be downloaded
from:
Directory Name Do not install ActivePython to a
directory that contains spaces in the name. This causes problems on some
variants of Windows with some service pack levels. We recommend you use the
default directory suggested during the installation.
Directory Contents If you are installing ActivePython to
an existing directory, ActivePython's setup may overwrite files in that
directory. We recommend that you install ActivePython to a new or empty
directory.
Other Python 2.3 Installations On Windows,
ActivePython 2.3 cannot coexist with other Python
2.3 installations (for example, a Python 2.3
build from python.org). Uninstall any other Python 2.3
installations before installing ActivePython 2.3.
If you have problems importing certain modules after installation, please
check these things before submitting a bug report.
To install ActivePython, download the .msi installation package and run it
by double-clicking it. Follow the prompts.
It is recommended that you run the ActivePython installation file
from an account with administrative privileges. This will allow other users
to use ActivePython, and will ensure that all of ActivePython's features
function. Installing ActivePython without administrative privileges has the
following limitations:
- The Python ActiveX scripting engine feature will be unavailable.
- Windows NT/2000 users will not be able to write Services.
- Environment variables cannot be set (e.g. PATH, PATHEXT).
- File associations for Python files cannot be set.
- Any registry entries created are under
HKEY_CURRENT_USER and
not under HKEY_LOCAL_MACHINE.
You can install the ActivePython MSI from the command line. For example:
c:\> msiexec.exe /i ActivePython-<version>.msi
ActivePython's installer uses Windows Installer technology. This allows
you to partially control the install from the command line. For example:
-
You can have the ActivePython installer run with a reduced user interface.
For example, the following will install silently and only pop up a dialog when
the installation is complete.
c:\> msiexec.exe /i ActivePython-<version>.msi /qn+
The following will install with no user interface at all.
c:\> msiexec.exe /i ActivePython-<version>.msi /q
-
You can generate a log of the ActivePython installation with the following
command. The following command will generate a log of the install in
"install.log".
c:\> msiexec.exe /i ActivePython-<version>.msi /L*v install.log
-
Command line options can be used to configure ActivePython installation
properties. For example, the following will install ActivePython to
"D:\myapps\Python", instead of the default:
c:\> msiexec.exe /i ActivePython-<version>.msi INSTALLDIR=D:\myapps\Python
-
ActivePython is divided into a number of distinct features. In the
"Customize Setup" dialog you can select which features to install. You can
also do this on the command line with the ADDLOCAL property. For example, the
following command will install just the core ActivePython functionality (i.e.
not the PyWin32 extensions or the documentation.
c:\> msiexec.exe /i ActivePython-<version>.msi ADDLOCAL=core
The current set of ActivePython features are
core ActivePython core (must be installed)
pywin32 PyWin32 extensions
doc Documentation
register Register this as the default Python installation
where the hierarchy denotes dependencies, I.e. to install
pywin32 you must install the core.
-
These command line options can all be brought together. For example, the
following command will silently install just the ActivePython core and
documentation to "C:\myapps\Python" and will not register this
as the default Python installation.
c:\> msiexec /i ActivePython-<version>.msi /qn+ INSTALLDIR=C:\myapps\Python ADDLOCAL=core,documentation
The ActivePython "AS package" installer package is a generic
installer for many platforms. It allows you to install ActivePython as a
non-root (non-Administrator) user. To install: Download the package to a
temporary directory, extract the files, and run the
install.sh install script
(install.bat on Windows).
The "AS package" is a standard tarball, *.tar.gz,
for Linux and other Unix-family systems like Solaris and a zip file,
*.zip, for Windows). Note: Solaris users
must use GNU tar to unpack the tarball. The default
tar that ships with Solaris is insufficient.
To install interactively, simple run the install script without arguments.
The install script will prompt your for an installation directory. On Unix:
% tar xzf ActivePython-version.tar.gz
% cd ActivePython-version
% ./install.sh
or on Windows, unzip ActivePython-version.zip
with WinZip or
equivalent and:
C:\> cd .../ActivePython-version
C:\...\ActivePython-version> install.bat
You can add the bin directory to your PATH environment variable for
quicker access. For example, if you use the Bash shell on Unix, you could
place this in your ~/.bashrc file (assuming you installed into
/home/guido/ActivePython-2.3):
% export PATH=/home/guido/ActivePython-2.3/bin:$PATH
By default the install script will prompt you for an install directory.
You can avoid this interaction by specifying the install directory with
the -I <installdir> option. Use the -h
option for full usage information.
|
