| ActiveTcl User Guide |

# Installing ActiveTcl

ActiveTcl binaries for Windows, Mac OS X, Linux (x86, and x86_64) are available from the ActiveState web site.

Solaris, HP-UX and AIX builds are available in ActiveTcl Business, Enterprise and OEM editions.

- System Requirements for ActiveTcl
- Installing ActiveTcl
- Uninstalling ActiveTcl

## System Requirements for ActiveTcl

### Windows

- 35 MB for the final install.
- Windows 2003 or later.

### Windows 64bit

### Mac OS X

- 50 MB for the final install.
- Mac OS X v10.7 (Lion) or later.
- Intel processor or compatible.

### Linux

- 2.4 kernel or greater (glibc 2.3).
- 50 MB for the final install.
- web browser for reading documentation.

### Linux x86_64

- 2.6 kernel or greater (glibc 2.3).
- 70 MB for the final install.
- web browser for reading documentation.

### Linux IA64

### Solaris

- Solaris 9 or greater on sparc.
- Solaris 10 kernel or greater on x86.
- 55 MB for the final install.
- web browser for reading documentation.

Note that Tar on Solaris 2.6 has a bug that prevents proper extraction of files in packages with long path names. GNU tar may therefore be required to extract the package into the filesystem correctly. A precompiled version of GNU tar for the sparc platform is available from: http://www.sunfreeware.com/.

### AIX

- AIX 6 or greater.
- 55 MB for the final install.
- web browser for reading documentation.

### HP-UX PARISC

- HP-UX 11i or greater.
- 50 MB for the final install.
- web browser for reading documentation.
- GNU tar (available from http://hpux.connect.org.uk/hppd/hpux/Gnu/tar-1.22/)

### HP-UX IA64

## Installing ActiveTcl

### Windows

ActiveTcl is distributed on Windows as an executable installer (`.exe` file).

- Download the ActiveTcl AS Package for Windows (`ActiveTcl-<version>-<platform>.exe`).
- Double-click the installer file to extract the contents and run the installation.
- Note that since Windows Vista it is strongly recommended to start the installer via a right-click and "run as Administrator" from the context menu this pops up.
- Note further that it is necessary to save the installer to the local disk before running it, contrary to any objections made by recent versions of Internet Explorer. The installer cannot be run from IE.

### Mac OS X

ActiveTcl is distributed on Mac OS X as a disk image (`.dmg` file). The disk image contains an installer package (`.pkg` bundle) that installs ActiveTcl.

- Download the ActiveTcl disk image (`ActiveTcl-<version>-<platform>.dmg`).
- If the browser does not automatically mount the disk image and open the mounted folder in Finder, double-click `ActiveTcl-<version>-<platform>.dmg` to do so.
- Double-click the ActiveTcl installer package (`ActiveTcl-<version>.pkg`) to start the installation.
- Follow the Installer prompts. The installer will ask for administrative authentication if the current user does not have administrative priviledges.
- After installation is complete, you may eject the ActiveTcl disk image and move `ActiveTcl-<version>-<platform>.dmg` to the Trash.

OS X includes a non-interactive command line interface to Apple's Installer. To install the ActiveTcl Apple installer from the command line:

        $ sudo installer -pkg /Volumes/ActiveTcl-<version>/ActiveTcl-<version>.pkg -target /

More information on the command line interface to Installer can be found in its `man` page.

ActiveTcl executables (`wish`, `tclsh` and `tkcon`) are installed in `/usr/local/bin`. If this directory is not in the user's PATH environment variable, it can be added manually to the `.profile` or `.bash_ profile` file in the user's home directory. For example:

        PATH=/usr/local/bin:$PATH
        export PATH

### Linux / Linux x86_64

The download is a tar-gzipped archive. To extract, enter the following command at the shell prompt:

`gtar zxf /path/to/ActiveTcl-download.tar.gz`

In the directory where you extracted the archive, run the `install.sh` installer script, which will automatically select between the GUI or text-based installer depending on your system configuration. After installation, make sure that the directory containing the installed executables (`ActiveTcl/bin`) is included in your PATH variable.

### Solaris

The download is a compressed tar archive. To extract, enter the following command at the shell prompt:

`compress -cd /path/to/ActiveTcl-download.tar.Z | tar xf -`

In the directory where you extracted the archive, run the `install.sh` installer script, which will automatically select between the GUI or text-based installer depending on your system configuration. After installation, make sure that the directory containing the installed executables is included in your PATH variable.

Note that GNU tar may be required to extract the package into the filesystem correctly, due to the long path names used in our archives. A precompiled version of GNU tar for the sparc platform is available from http://www.sunfreeware.com.

### AIX

The download is a tar-gzipped archive. To extract, enter the following command at the shell prompt:

`gtar zxf /path/to/ActiveTcl-download.tar.gz`

Or:

`gunzip < /path/to/ActiveTcl-download.tar.gz | tar xf -`

In the directory where you extracted the archive, run the `install.sh` installer script, which will automatically select between the GUI or text-based installer depending on your system configuration. After installation, make sure that the directory containing the installed executables (`ActiveTcl/bin`) is included in your PATH variable.

### HP-UX

The download is a tar-gzipped archive. To extract, enter the following command at the shell prompt:

`gtar zxf /path/to/ActiveTcl-download.tar.gz`

Or:

`gunzip < /path/to/ActiveTcl-download.tar.gz | tar xf -`

In the directory where you extracted the archive, run the `install.sh` installer script, which will automatically select between the GUI or text-based installer depending on your system configuration. After installation, make sure that the directory containing the installed executables (`ActiveTcl/bin`) is included in your PATH variable.

## Uninstalling ActiveTcl

### Windows

To uninstall ActiveTcl, from the Start menu, select Programs|ActiveState ActiveTcl|Uninstall ActiveTcl.

### Mac OS X

Run the `uninstall` script provided by ActiveTcl and installed under `/Library/Receipts/ActiveTcl-<version>/Contents/Resources/uninstall`. This will remove all files, symbolic links and directories created during installation, after the user has confirmed his intentions. For example:

        $ cd /Library/Receipts/ActiveTcl-<version>/Contents/Resources
        $ sudo ./uninstall
        ... List of files, links, etc. which are removed ...

Note: On Snow Leopard and higher the `uninstall` script is installed under `/Library/Frameworks/Tcl.framework/Versions/<version>/Resources/Scripts/uninstall` instead. Apple reorganized the directories for receipt storage and eliminated any space for 3rd-party files from it.

### Linux

To uninstall ActiveTcl, run the "uninstall.tcl" script that is located in the directory where you extracted the ActiveTcl archive. Note that you must use the "wish" in the distribution you wish to uninstall. For example:

`% /path/Tcl/bin/wish /path/Tcl/lib/ppm/log/ActiveTcl/uninstall_ActiveTcl.tcl`

stored, by default, in the directory `/lib/ppm/log/ActiveTcl`. You must use the wish interpreter from the distribution you wish to uninstall. Ensure that you do not run the uninstall script from a directory that will be removed during the uninstallation.

For example:

`% /path/Tcl/bin/wish /path/Tcl/lib/ppm/log/ActiveTcl/uninstall_ActiveTcl.tcl`

Note: if you are uninstalling both ActiveTcl and Tcl Dev Kit, uninstall Tcl Dev Kit before uninstalling ActiveTcl.

### Solaris

To uninstall ActiveTcl, run the "uninstall_ActiveTcl.tcl" script that is stored, by default, in the directory `/lib/ppm/log/ActiveTcl`. You must use the wish interpreter from the distribution you wish to uninstall. Ensure that you do not run the uninstall script from a directory that will be removed during the uninstallation.

For example:

`% /path/Tcl/bin/wish /path/Tcl/lib/ppm/log/ActiveTcl/uninstall_ActiveTcl.tcl`

Note: if you are uninstalling both ActiveTcl and Tcl Dev Kit, uninstall Tcl Dev Kit before uninstalling ActiveTcl.

### AIX

To uninstall ActiveTcl, run the "uninstall_ActiveTcl.tcl" script that is stored, by default, in the directory `/lib/ppm/log/ActiveTcl`. You must use the wish interpreter from the distribution you wish to uninstall. Ensure that you do not run the uninstall script from a directory that will be removed during the uninstallation.

For example:

`% /path/Tcl/bin/wish /path/Tcl/lib/ppm/log/ActiveTcl/uninstall_ActiveTcl.tcl`

Note: if you are uninstalling both ActiveTcl and Tcl Dev Kit, uninstall Tcl Dev Kit before uninstalling ActiveTcl.

### HP-UX

To uninstall ActiveTcl, run the "uninstall_ActiveTcl.tcl" script that is stored, by default, in the directory `/lib/ppm/log/ActiveTcl`. You must use the wish interpreter from the distribution you wish to uninstall. Ensure that you do not run the uninstall script from a directory that will be removed during the uninstallation.

For example:

`% /path/Tcl/bin/wish /path/Tcl/lib/ppm/log/ActiveTcl/uninstall_ActiveTcl.tcl`

Note: if you are uninstalling both ActiveTcl and Tcl Dev Kit, uninstall Tcl Dev Kit before uninstalling ActiveTcl.