Komodo Installation Guide

Windows
Mac OS X
Linux

Windows

Prerequisites

Hardware Requirements

1GHz (or faster) x86 or x86_64 processor
1 GB RAM
200 MB hard disk space
340 MB of temporary hard disk space during installation

Operating System Requirements

The following platforms are officially supported. Current Critical Updates, Windows Updates, and Service Packs must be installed (see http://windowsupdate.microsoft.com).

Windows 7
Windows Vista
Windows XP
Windows Server 2003

To install on Windows XP, you may need to upgrade your version of Windows Installer.

Software Prerequisites on Windows

Upgrading from Previous Komodo Versions

Newer versions of Komodo should not be installed in the same directory as older versions. For major release upgrades (e.g. 3.5 to 4.0) the installer will automatically put Komodo in a new directory.

For minor releases (e.g. 4.1 to 4.2) and patch-level releases (4.1.1 to 4.1.2), use the auto-update system (Help|Check for Updates). The changes will be applied safely in the current install directory. If you need to update using an installer, completely uninstall the older version before installing the new one, or manually specify a different install directory during the installation process. Your Komodo preferences will be preserved as they are installed in a different directory.

Installing Komodo on Windows

Before you start:

If you intend to run the installation from a shared network drive, your system must have SYSTEM rights (or greater) to the directory from which the installation is run. Alternatively, run the installation from a local drive.

To install Komodo on Windows:

Ensure you have the prerequisite hardware and software.
Download the Komodo installer file.
Double-click the installer file and follow the instructions.

When installation is complete, you will see an ActiveState Komodo icon on your desktop.

Command Line Installation Options

Komodo can also be installed from the command line. For example:

c:\> msiexec.exe /i Komodo-<version>.msi

Komodo's installer uses Windows Installer technology, which allows you to partially control the install from the command line. For example:

Installing the MSI in Silent Mode

You can have the Komodo installer run with a reduced user interface. For example, the following will install silently and only open a dialog when the installation is complete.

c:\> msiexec.exe /i Komodo-<version>.msi /qn+

The following will install with no dialog at all.

c:\> msiexec.exe /i Komodo-<version>.msi /q

Turning on Logging

You can generate a log of the Komodo installation with the following command:

c:\> msiexec.exe /i Komodo-<version>.msi /L*v install.log

Controlling the Install Directory

Command line options can be used to configure Komodo installation properties. The following will install Komodo to "E:\myapps\Komodo", instead of the default location:

c:\> msiexec.exe /i Komodo-<version>.msi INSTALLDIR=D:\myapps\Komodo

Controlling Which Features Get Installed

Komodo 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 Komodo functionality (i.e. not the PyWin32 extensions or the documentation.

c:\> msiexec.exe /i Komodo-<version>.msi ADDLOCAL=core

The current set of Komodo features are:

core             Komodo core
env              Windows environment settings
    desktop      Desktop shortcut
    quicklaunch  Quick launch shortcut
    register     Register this as the default Komodo
docs             Documentation

The hierarchy denotes dependencies (i.e. to install quicklaunch you must install the env.

The register option puts the Komodo location in the registry so 'start komodo' works, and adds bindings for .kpz and .kpf Komodo project files.

Starting Komodo on Windows

To start Komodo on Windows, use one of the following methods:

Double-click the desktop icon.
Select Start|Programs|ActiveState Komodo|Komodo.
Add the Komodo install directory to your PATH environment variable, then from the command line prompt, enter komodo.

Uninstalling Komodo on Windows

To uninstall Komodo, select Start|Programs|ActiveState Komodo|Modify or Uninstall Komodo.

Alternatively, use the Add/Remove Programs menu (accessible from the Windows Control Panel).

Mac OS X

Prerequisites

Hardware Requirements

Intel processor
1 GB RAM
200 MB hard disk space
340 MB of temporary hard disk space during installation

Operating System Requirements

Mac OS X 10.4 (Tiger) or later

Upgrading from Previous Komodo Versions

Newer versions of Komodo should not be installed in the same directory as older versions.

For minor releases (e.g. 4.1 to 4.2) and patch-level releases (4.1.1 to 4.1.2), use the auto-update system (Help|Check for Updates). The changes will be applied safely in the current install directory. If you need to update using an installer, completely uninstall the older version or rename the .app before installing the new one. Your Komodo preferences will be preserved as they are installed in a different directory.

Installing Komodo on Mac OS X

To install Komodo:

Download the Komodo disk image (Komodo-<version>-macosx-<powerpc|x86>.dmg).
If the browser does not automatically mount the disk image and open the mounted folder in Finder, double-click the .dmg file to do so.
Open a new Finder window. Drag the Komodo icon from the mounted folder to the Applications folder.
If desired, drag the Komodo icon into the Dock.

Starting Komodo on OS X

Click the Komodo icon in the Dock or the Applications folder.

Uninstalling Komodo on OS X

Drag the Komodo icon into the Trash.

Linux

Prerequisites

Hardware Requirements

1GHz (or faster) x86 or x86_64 processor
1 GB RAM
200 MB hard disk space
340 MB of temporary hard disk space during installation

Operating System Requirements

Supported operating systems:

The following platforms are officially supported.

Red Hat Enterprise Linux 5 or later
CentOS 5.0 or later
Fedora Core 8 or later
OpenSUSE 10.2 or later
Ubuntu 7.04 or later

Other operating systems:

Komodo can also be run on the following platforms. This version of Komodo has not necessarily been tested on these platforms; platform-specific bugs may or may not be fixed.

Debian GNU/Linux 4.0 ("etch")
Mandriva
FreeBSD (with Linux binary compatibility)
Gentoo

Software Prerequisites on Linux

Installation Prerequisites:

glibc 2.4 (or higher) and libjpeg.so.62 (or higher): These libraries are included in standard Linux distributions.
libstdc++6 (or higher)
GTK+ 2.10 (or higher)

Running Komodo on 64 bit versions of Linux will require additional 32-bit libraries (e.g. libc6 and gtk), which may need to be installed with your system's package manager. For example:

Ubuntu 7.10 - 8.10: sudo apt-get install binfmt-support ia32-libs
Ubuntu 7.04: sudo apt-get install binfmt-support ia32-libs-gtk ia32-libs
Fedora Core 9: sudo yum install gtk2.i386 libXt.i386
Gentoo: emerge -av app-emulation/emul-linux-x86-gtklibs

Non-ASCII Input Requirements:

SuSE: scim, scim-bridge-gtk and scim-bridge-qt packages.
Ubuntu: scim, scim-gtk2-immodule, scim-qtimm, and scim-tables-additional packages (if not already installed).
Fedora Core / RHEL / CentOS: scim, scim-gtk and scim-qtimm packages.

Adding Perl or Python to the `PATH` Environment Variable

To add Perl or Python to the PATH environment variable, do one of the following:

Modify your PATH environment variable. For example, if you use the Bash shell, add the following line to your ~/.bashrc file:
```
export PATH=<installdir>/bin:$PATH
```
...where <installdir> points to the directory where you installed ActivePerl or ActivePython.
Create a symbolic link to the Perl or Python executable. For example, for ActivePerl, enter:
```
ln -s <installdir>/bin/perl /usr/local/bin/perl
```
For ActivePython, enter:
```
ln -s <installdir>/bin/python /usr/local/bin/python
```
...where <installdir> points to the directory where you installed ActivePerl or ActivePython.

Upgrading from Previous Komodo Versions

Newer versions of Komodo should not be installed in the same directory as older versions. For major release upgrades (e.g. 3.5 to 4.0) the installer will automatically put Komodo in a new directory.

Installing Komodo on Linux

This version of Komodo allows non-root installation on Linux. Note, however, that the user who executes the license file will be the user who is licensed to use the software.

To install Komodo on Linux:

Download the Komodo installer (.tar.gz file) into a convenient directory.

Unpack the tarball:

tar -xvzf Komodo-<version>-<platform>.tar.gz

Change to the new directory:
```
cd Komodo-<version>-<platform>
```
Run the install script ("install.sh"):
```
./install.sh
```
Answer the installer prompts:
- Specify where you want Komodo installed, or press 'Enter' to accept the default location (/home/<username>/Komodo-<IDE|Edit>-x.y).The -I option can be used to specify the install directory. For example:
```
./install.sh -I ~/opt/Komodo-IDE-4.2
```
  If multiple users are sharing the system and will be using the same installation, install Komodo in a location every user can access (e.g. /opt/Komodo-x.x/ or /usr/local/Komodo-x.x/).
  
  Note:
  - Each Komodo user requires their own license key.
  - Do not install Komodo in a path that contains spaces or non-alphanumeric characters.
  - Be sure to install Komodo into its own directory (i.e. not directly in an existing directory containing shared files and directories such as /usr/local).
Once the installer has finished, add Komodo to your PATH with one of the following:
- Add Komodo/bin to your PATH directly:
```
export PATH=<installdir>/bin:$PATH
```
- Add a symlink to Komodo/bin/komodo from another directory in your PATH:
```
ln -s <installdir>/bin/komodo /usr/local/bin/komodo
```
  Note: Creating symlinks in system directories such as /usr/bin requires root access.

After completing the installation, you can delete the temporary directory where the Komodo tarball was unpacked.

Starting Komodo on Linux

To start Komodo on Linux enter `komodo` at the command line or create a shortcut on your desktop or in your toolbar using the full path to the komodo executable.

Uninstalling Komodo on Linux

To uninstall Komodo on Linux:

Delete the directory that Komodo created during installation.
If you wish to delete your Komodo preferences, delete the ~/.komodo directory. If you do not delete this directory, subsequent installations of Komodo will use the same preferences.

Note: You cannot relocate an existing Komodo installation to a new directory by simply moving it. You must uninstall Komodo from the existing location and reinstall it in the new location.