# Installing Canopy 2 on Windows for classroom/lab use

For administrative and technical background, please see "Canopy 2 Managed Common Install".

## Prep

Uninstall any existing EPD and Canopy installations on this system, including manually deleting all System and User environment directories for each administrator and user. (If existing user preference settings are not precious, you can start cleaner by also deleting each user's configuration/preference directory.) For details about directory locations, see Uninstalling and resetting Canopy v2.

## Install

1) Open an elevated "Administrator" command prompt, as described in this Knowledge Base article: "Windows - on some systems, admin users cannot immediately install 'for all users'".

2) Create the Canopy target directory (by default, "C:\Program Files\Enthought") with appropriate permissions. Typically you would give non-admin users read/execute access only, which would be the system default.

3) Install Canopy and set up the managed common install, with the following long one-line command, adjusting file names and paths as appropriate and making other changes as described below. Note that the quotation marks around string options (paths) are required:

msiexec /qr /lv*x canopy-msi.log /i canopy-2.1.0.win-x86_64-cp27_full.msi ALLUSERS=1 SETUP_MANAGED_COMMON_INSTALL="C:\Program Files\Enthought" SETUP_LICENSE_PATH="C:\full\path\to\my-site-license-file.enlic"

3a) The default, and recommended, directory for installing for all users is C:\Program Files\Enthought. To install Canopy for all users into a different directory, specify it with option APPLICATIONFOLDER="<wherever>", and modify option SETUP_MANAGED_COMMON_INSTALL to point to the same directory. (Note that if you do this, and then later uninstall Canopy, you will need to again explicitly specify to msiexec, the same APPLICATIONFOLDER; this requirement should be removed in a future release, with a smarter uninstaller.)

3b) If you do have a license file (see Download, above), substitute its filename and current location (typically a download dir) above. If you don't, then omit the option SETUP_LICENSE_PATH="..."

Warning: Because of Windows idiosyncrasies, it's essential that you not put a closing backslash character at the end of any of the paths which you pass to msiexec.

## Directory structure

The directory structure in this example, resulting from this installation, would be:

C:\Program Files\Enthought\Canopy\       |- App # - Canopy Core (Canopy GUI application)      |- edm\envs\User # - Canopy User Python

## Usage

All users may start Canopy from the Desktop shortcut, or from the command line with:

C:\Program Files\Enthought\Canopy\App\Canopy.exe